[PATCH v3 2/9] mtd: spi-nor: Introduce the concept of bank

[Tudor Ambarus]

Hi, Miquel,

On 12/15/22 08:12, Miquel Raynal wrote:
> SPI-NOR chips are made of pages, which gathered in small groups make

nit: s/SPI-NOR/ SPI NOR

> (erase) sectors. Sectors, gathered together, make banks inside the
> chip. So far there was only one bank per device supported, but we are
> about to introduce support for new chips featuring several banks (up to
> 4 so far) where different operations may happen in parallel.
> 
> Let's allow describing these additional bank parameters.
> 
> Signed-off-by: Miquel Raynal <miquel.raynal at bootlin.com>
> Reviewed-by: Pratyush Yadav <pratyush at kernel.org>
> ---
>   drivers/mtd/spi-nor/core.c |  3 ++-
>   drivers/mtd/spi-nor/core.h | 16 +++++++++++-----
>   2 files changed, 13 insertions(+), 6 deletions(-)
> 
> diff --git a/drivers/mtd/spi-nor/core.c b/drivers/mtd/spi-nor/core.c
> index f2c64006f8d7..38a57aac6754 100644
> --- a/drivers/mtd/spi-nor/core.c
> +++ b/drivers/mtd/spi-nor/core.c
> @@ -2539,7 +2539,8 @@ static void spi_nor_init_default_params(struct spi_nor *nor)
>   
>   	/* Set SPI NOR sizes. */
>   	params->writesize = 1;
> -	params->size = (u64)info->sector_size * info->n_sectors;
> +	params->bank_size = (u64)info->sector_size * info->n_sectors;
> +	params->size = params->bank_size * info->n_banks;

Is the datasheet for these chips public? I see JESD216 says nothing
about flash banks.

I'm wondering whether we should keep the n_sectors as the total number 
of sectors per flash or not. Does this flash type support Software Block
Protection? How do they count the sectors on Block Protection, per flash
or per bank?

>   	params->page_size = info->page_size;
>   
>   	if (!(info->flags & SPI_NOR_NO_FR)) {
> diff --git a/drivers/mtd/spi-nor/core.h b/drivers/mtd/spi-nor/core.h
> index dc74c7be3e28..8a067d56c995 100644
> --- a/drivers/mtd/spi-nor/core.h
> +++ b/drivers/mtd/spi-nor/core.h
> @@ -336,7 +336,8 @@ struct spi_nor_otp {
>    * by the spi_nor_fixups hooks, or dynamically when parsing the JESD216
>    * Serial Flash Discoverable Parameters (SFDP) tables.
>    *
> - * @size:		the flash memory density in bytes.
> + * @bank_size:		the flash memory bank density in bytes.
> + * @size:		the total flash memory density in bytes.
>    * @writesize		Minimal writable flash unit size. Defaults to 1. Set to
>    *			ECC unit size for ECC-ed flashes.
>    * @page_size:		the page size of the SPI NOR flash memory.
> @@ -374,6 +375,7 @@ struct spi_nor_otp {
>    * @locking_ops:	SPI NOR locking methods.
>    */
>   struct spi_nor_flash_parameter {
> +	u64				bank_size;
>   	u64				size;
>   	u32				writesize;
>   	u32				page_size;
> @@ -434,7 +436,8 @@ struct spi_nor_fixups {
>    * @id_len:         the number of bytes of ID.
>    * @sector_size:    the size listed here is what works with SPINOR_OP_SE, which
>    *                  isn't necessarily called a "sector" by the vendor.
> - * @n_sectors:      the number of sectors.
> + * @n_sectors:      the number of sectors per bank.
> + * @n_banks:        the number of banks.
>    * @page_size:      the flash's page size.
>    * @addr_nbytes:    number of address bytes to send.
>    *
> @@ -493,6 +496,7 @@ struct flash_info {
>   	u8 id_len;
>   	unsigned sector_size;
>   	u16 n_sectors;
> +	u16 n_banks;
>   	u16 page_size;

We can try u8 nbanks for now. And we would define it here, to avoid
struct padding.
>   	u8 addr_nbytes;
>   
> @@ -538,23 +542,25 @@ struct flash_info {
>   	.id = { SPI_NOR_ID_3ITEMS(_jedec_id), SPI_NOR_ID_3ITEMS(_ext_id) }, \
>   	.id_len = 6
>   
> -#define SPI_NOR_GEOMETRY(_sector_size, _n_sectors)			\
> +#define SPI_NOR_GEOMETRY(_sector_size, _n_sectors, _n_banks)		\
>   	.sector_size = (_sector_size),					\
>   	.n_sectors = (_n_sectors),					\
> +	.n_banks = (_n_banks),						\
>   	.page_size = 256
>   
>   /* Used when the "_ext_id" is two bytes at most */
>   #define INFO(_jedec_id, _ext_id, _sector_size, _n_sectors)		\
>   	SPI_NOR_ID((_jedec_id), (_ext_id)),				\
> -	SPI_NOR_GEOMETRY((_sector_size), (_n_sectors)),
> +	SPI_NOR_GEOMETRY((_sector_size), (_n_sectors), 1),
>   
>   #define INFO6(_jedec_id, _ext_id, _sector_size, _n_sectors)		\
>   	SPI_NOR_ID6((_jedec_id), (_ext_id)),				\
> -	SPI_NOR_GEOMETRY((_sector_size), (_n_sectors)),
> +	SPI_NOR_GEOMETRY((_sector_size), (_n_sectors), 1),
>   
>   #define CAT25_INFO(_sector_size, _n_sectors, _page_size, _addr_nbytes)	\
>   		.sector_size = (_sector_size),				\
>   		.n_sectors = (_n_sectors),				\
> +		.n_banks = 1,						\
>   		.page_size = (_page_size),				\
>   		.addr_nbytes = (_addr_nbytes),				\
>   		.flags = SPI_NOR_NO_ERASE | SPI_NOR_NO_FR,		\

you need to update S3AN_INFO as well.

Cheers,
ta