mtd/spi-nor/core.h

1 /* SPDX-License-Identifier: GPL-2.0 */
18 #define SPI_NOR_DEFAULT_N_BANKS 1
44 		   SPI_MEM_OP_DATA_IN(1, buf, 0))
56 		   SPI_MEM_OP_DATA_OUT(1, buf, 0))
62 		   SPI_MEM_OP_DATA_OUT(1, buf, 0))
68 		   SPI_MEM_OP_DATA_IN(1, buf, 0))
80 		   SPI_MEM_OP_DATA_OUT(1, buf, 0))
103 		   SPI_MEM_OP_DUMMY(1, 0),				\
127 	SNOR_F_NO_OP_CHIP_ERASE	= BIT(1),
203  * struct spi_nor_erase_type - Structure to describe a SPI NOR erase type
224  * struct spi_nor_erase_command - Used for non-uniform erases
227  * are run-length encoded.
242  * struct spi_nor_erase_region - Structure to describe a SPI NOR erase region
261  * struct spi_nor_erase_map - Structure to describe the SPI NOR erase map
265  * @uniform_region:	a pre-allocated erase region for SPI NOR with a uniform
281  * struct spi_nor_locking_ops - SPI NOR locking methods
293  * struct spi_nor_otp_organization - Structure to describe the SPI NOR OTP regions
294  * @len:	size of one OTP region in bytes.
295  * @base:	start address of the OTP area.
296  * @offset:	offset between consecutive OTP regions if there are more
298  * @n_regions:	number of individual OTP regions.
308  * struct spi_nor_otp_ops - SPI NOR OTP methods
309  * @read:	read from the SPI NOR OTP area.
310  * @write:	write to the SPI NOR OTP area.
311  * @lock:	lock an OTP region.
312  * @erase:	erase an OTP region.
313  * @is_locked:	check if an OTP region of the SPI NOR is locked.
325  * struct spi_nor_otp - SPI NOR OTP grouping structure
326  * @org:	OTP region organization
327  * @ops:	OTP access ops
335  * struct spi_nor_flash_parameter - SPI NOR flash parameters and settings.
342  * @writesize		Minimal writable flash unit size. Defaults to 1. Set to
343  *			ECC unit size for ECC-ed flashes.
366  * @otp:		SPI NOR OTP info.
395 	struct spi_nor_otp		otp;  member
407  * struct spi_nor_fixups - SPI NOR fixup hooks
434  * struct spi_nor_id - SPI NOR flash ID.
447  * struct flash_info - SPI NOR flash_info entry.
454  *                  I.e. non-legacy flash entries in flash_info will have
459  * @n_banks:        (optional) the number of banks. Defaults to 1.
470  *   SPI_NOR_4BIT_BP:         flash SR has 4 bit fields (BP0-3) for block
475  *                            Usually these will power-up in a write-protected
506  * @otp_org:        flash's OTP organization.
520 #define SPI_NOR_HAS_TB			BIT(1)
531 #define SECT_4K				BIT(1)
540 #define SPI_NOR_IO_MODE_EN_VOLATILE	BIT(1)
544 	const struct spi_nor_otp_organization *otp;  member
563  * struct spi_nor_manufacturer - SPI NOR manufacturer object
577  * struct sfdp - SFDP data
687  * spi_nor_needs_sfdp() - returns true if SFDP parsing is used for this flash.
696 	 * non-legacy flash entries in flash_info will have a size of zero iff  in spi_nor_needs_sfdp()
699 	return !nor->info->size;  in spi_nor_needs_sfdp()