[PATCH v2 18/35] mtd: spi-nor: Get rid of SPI_NOR_4B_OPCODES flag
Pratyush Yadav
p.yadav at ti.com
Tue Oct 19 10:26:25 PDT 2021
On 04/10/21 03:18AM, Tudor.Ambarus at microchip.com wrote:
> On 8/17/21 3:16 PM, Pratyush Yadav wrote:
> > EXTERNAL EMAIL: Do not click links or open attachments unless you know the content is safe
> >
> > On 27/07/21 07:52AM, Tudor Ambarus wrote:
> >> Get rid of flash_info flags that indicate settings which can be
> >> discovered when parsing SFDP. It will be clearer who sets what,
> >> and we'll restrict the flash settings that a developer can choose to
> >> only settings that are not SFDP discoverable.
> >>
> >> Whether a flash supports 4byte opcodes or not, is discoverable when
> >> parsing the optional 4-byte address instruction table. Flashes that
> >> do not support the 4bait SFDP table should set the SNOR_F_4B_OPCODES
> >> flag in the late_init() call. Flashes that define the 4bait SFDP table
> >> but gets it wrong, should set the flag in a post_sfdp fixup hook.
> >
> > I like the idea, not so much the execution. More on this below.
> >
> >>
> >> Signed-off-by: Tudor Ambarus <tudor.ambarus at microchip.com>
> >> ---
> >> drivers/mtd/spi-nor/core.c | 3 ---
> >> drivers/mtd/spi-nor/core.h | 32 ++++++++++++++++----------------
> >> drivers/mtd/spi-nor/gigadevice.c | 7 ++++---
> >> drivers/mtd/spi-nor/issi.c | 12 ++++++------
> >> drivers/mtd/spi-nor/macronix.c | 18 ++++++++++--------
> >> drivers/mtd/spi-nor/micron-st.c | 22 +++++++++++++---------
> >> drivers/mtd/spi-nor/spansion.c | 12 ++++++------
> >> 7 files changed, 55 insertions(+), 51 deletions(-)
> >>
> >> diff --git a/drivers/mtd/spi-nor/core.c b/drivers/mtd/spi-nor/core.c
> >> index 6a8617346764..240d5c31af88 100644
> >> --- a/drivers/mtd/spi-nor/core.c
> >> +++ b/drivers/mtd/spi-nor/core.c
> >> @@ -3204,9 +3204,6 @@ int spi_nor_scan(struct spi_nor *nor, const char *name,
> >> if (ret)
> >> return ret;
> >>
> >> - if (info->flags & SPI_NOR_4B_OPCODES)
> >> - nor->flags |= SNOR_F_4B_OPCODES;
> >> -
> >> if (info->flags & SPI_NOR_IO_MODE_EN_VOLATILE)
> >> nor->flags |= SNOR_F_IO_MODE_EN_VOLATILE;
> >>
> >> diff --git a/drivers/mtd/spi-nor/core.h b/drivers/mtd/spi-nor/core.h
> >> index 625f4eed75f1..dfdc51a26cad 100644
> >> --- a/drivers/mtd/spi-nor/core.h
> >> +++ b/drivers/mtd/spi-nor/core.h
> >> @@ -348,40 +348,36 @@ struct flash_info {
> >> * S3AN flashes have specific opcode to
> >> * read the status register.
> >> */
> >> -#define SPI_NOR_4B_OPCODES BIT(11) /*
> >> - * Use dedicated 4byte address op codes
> >> - * to support memory size above 128Mib.
> >> - */
> >> -#define NO_CHIP_ERASE BIT(12) /* Chip does not support chip erase */
> >> -#define SPI_NOR_SKIP_SFDP BIT(13) /* Skip parsing of SFDP tables */
> >> -#define USE_CLSR BIT(14) /* use CLSR command */
> >> -#define SPI_NOR_OCTAL_READ BIT(15) /* Flash supports Octal Read */
> >> -#define SPI_NOR_TB_SR_BIT6 BIT(16) /*
> >> +#define NO_CHIP_ERASE BIT(11) /* Chip does not support chip erase */
> >> +#define SPI_NOR_SKIP_SFDP BIT(12) /* Skip parsing of SFDP tables */
> >> +#define USE_CLSR BIT(13) /* use CLSR command */
> >> +#define SPI_NOR_OCTAL_READ BIT(14) /* Flash supports Octal Read */
> >> +#define SPI_NOR_TB_SR_BIT6 BIT(15) /*
> >> * Top/Bottom (TB) is bit 6 of
> >> * status register. Must be used with
> >> * SPI_NOR_HAS_TB.
> >> */
> >> -#define SPI_NOR_4BIT_BP BIT(17) /*
> >> +#define SPI_NOR_4BIT_BP BIT(16) /*
> >> * Flash SR has 4 bit fields (BP0-3)
> >> * for block protection.
> >> */
> >> -#define SPI_NOR_BP3_SR_BIT6 BIT(18) /*
> >> +#define SPI_NOR_BP3_SR_BIT6 BIT(17) /*
> >> * BP3 is bit 6 of status register.
> >> * Must be used with SPI_NOR_4BIT_BP.
> >> */
> >> -#define SPI_NOR_OCTAL_DTR_READ BIT(19) /* Flash supports octal DTR Read. */
> >> -#define SPI_NOR_OCTAL_DTR_PP BIT(20) /* Flash supports Octal DTR Page Program */
> >> -#define SPI_NOR_IO_MODE_EN_VOLATILE BIT(21) /*
> >> +#define SPI_NOR_OCTAL_DTR_READ BIT(18) /* Flash supports octal DTR Read. */
> >> +#define SPI_NOR_OCTAL_DTR_PP BIT(19) /* Flash supports Octal DTR Page Program */
> >> +#define SPI_NOR_IO_MODE_EN_VOLATILE BIT(20) /*
> >> * Flash enables the best
> >> * available I/O mode via a
> >> * volatile bit.
> >> */
> >> -#define SPI_NOR_SWP_IS_VOLATILE BIT(22) /*
> >> +#define SPI_NOR_SWP_IS_VOLATILE BIT(21) /*
> >> * Flash has volatile software write
> >> * protection bits. Usually these will
> >> * power-up in a write-protected state.
> >> */
> >> -#define SPI_NOR_PARSE_SFDP BIT(23) /*
> >> +#define SPI_NOR_PARSE_SFDP BIT(22) /*
> >> * Flash initialized based on the SFDP
> >> * tables.
> >> */
> >> @@ -569,4 +565,8 @@ static struct spi_nor __maybe_unused *mtd_to_spi_nor(struct mtd_info *mtd)
> >> return mtd->priv;
> >> }
> >>
> >> +static inline void snor_f_4b_opcodes(struct spi_nor *nor)
> >
> > Maybe snor_set_f_4b_opcodes()?
>
> snor_f comes from SPI NOR Flags I guess, so probably snor_f_set_4b_opcodes if we're
> going this path.
Makes sense to me.
>
> >
> >> +{
> >> + nor->flags |= SNOR_F_4B_OPCODES;
> >> +}
> >> #endif /* __LINUX_MTD_SPI_NOR_INTERNAL_H */
> >> diff --git a/drivers/mtd/spi-nor/gigadevice.c b/drivers/mtd/spi-nor/gigadevice.c
> >> index 447d84bb2128..ff523fe734ef 100644
> >> --- a/drivers/mtd/spi-nor/gigadevice.c
> >> +++ b/drivers/mtd/spi-nor/gigadevice.c
> >> @@ -47,9 +47,10 @@ static const struct flash_info gigadevice_parts[] = {
> >> SPI_NOR_HAS_LOCK | SPI_NOR_HAS_TB) },
> >> { "gd25q256", INFO(0xc84019, 0, 64 * 1024, 512,
> >> SECT_4K | SPI_NOR_DUAL_READ | SPI_NOR_QUAD_READ |
> >> - SPI_NOR_4B_OPCODES | SPI_NOR_HAS_LOCK |
> >> - SPI_NOR_HAS_TB | SPI_NOR_TB_SR_BIT6)
> >> - .fixups = &gd25q256_fixups },
> >> + SPI_NOR_HAS_LOCK | SPI_NOR_HAS_TB |
> >> + SPI_NOR_TB_SR_BIT6)
> >> + .fixups = &gd25q256_fixups,
> >> + .late_init = snor_f_4b_opcodes, },
> >> };
> >>
> >> const struct spi_nor_manufacturer spi_nor_gigadevice = {
> >> diff --git a/drivers/mtd/spi-nor/issi.c b/drivers/mtd/spi-nor/issi.c
> >> index 1e5bb5408b68..aeff8f60cbae 100644
> >> --- a/drivers/mtd/spi-nor/issi.c
> >> +++ b/drivers/mtd/spi-nor/issi.c
> >> @@ -45,9 +45,9 @@ static const struct flash_info issi_parts[] = {
> >> { "is25lp128", INFO(0x9d6018, 0, 64 * 1024, 256,
> >> SECT_4K | SPI_NOR_DUAL_READ) },
> >> { "is25lp256", INFO(0x9d6019, 0, 64 * 1024, 512,
> >> - SECT_4K | SPI_NOR_DUAL_READ | SPI_NOR_QUAD_READ |
> >> - SPI_NOR_4B_OPCODES)
> >> - .fixups = &is25lp256_fixups },
> >> + SECT_4K | SPI_NOR_DUAL_READ | SPI_NOR_QUAD_READ)
> >> + .fixups = &is25lp256_fixups,
> >> + .late_init = snor_f_4b_opcodes, },
> >> { "is25wp032", INFO(0x9d7016, 0, 64 * 1024, 64,
> >> SECT_4K | SPI_NOR_DUAL_READ | SPI_NOR_QUAD_READ) },
> >> { "is25wp064", INFO(0x9d7017, 0, 64 * 1024, 128,
> >> @@ -55,9 +55,9 @@ static const struct flash_info issi_parts[] = {
> >> { "is25wp128", INFO(0x9d7018, 0, 64 * 1024, 256,
> >> SECT_4K | SPI_NOR_DUAL_READ | SPI_NOR_QUAD_READ) },
> >> { "is25wp256", INFO(0x9d7019, 0, 64 * 1024, 512,
> >> - SECT_4K | SPI_NOR_DUAL_READ | SPI_NOR_QUAD_READ |
> >> - SPI_NOR_4B_OPCODES)
> >> - .fixups = &is25lp256_fixups },
> >> + SECT_4K | SPI_NOR_DUAL_READ | SPI_NOR_QUAD_READ)
> >> + .fixups = &is25lp256_fixups,
> >> + .late_init = snor_f_4b_opcodes, },
> >>
> >> /* PMC */
> >> { "pm25lv512", INFO(0, 0, 32 * 1024, 2, SECT_4K_PMC) },
> >> diff --git a/drivers/mtd/spi-nor/macronix.c b/drivers/mtd/spi-nor/macronix.c
> >> index fba85efafb47..9709eb68b613 100644
> >> --- a/drivers/mtd/spi-nor/macronix.c
> >> +++ b/drivers/mtd/spi-nor/macronix.c
> >> @@ -105,29 +105,31 @@ static const struct flash_info macronix_parts[] = {
> >> { "mx25l25635e", INFO(0xc22019, 0, 64 * 1024, 512,
> >> SPI_NOR_DUAL_READ | SPI_NOR_QUAD_READ)
> >> .fixups = &mx25l25635_fixups },
> >> - { "mx25u25635f", INFO(0xc22539, 0, 64 * 1024, 512,
> >> - SECT_4K | SPI_NOR_4B_OPCODES) },
> >> + { "mx25u25635f", INFO(0xc22539, 0, 64 * 1024, 512, SECT_4K)
> >> + .late_init = snor_f_4b_opcodes, },
> >> { "mx25u51245g", INFO(0xc2253a, 0, 64 * 1024, 1024,
> >> SECT_4K | SPI_NOR_DUAL_READ |
> >> - SPI_NOR_QUAD_READ | SPI_NOR_4B_OPCODES) },
> >> + SPI_NOR_QUAD_READ)
> >> + .late_init = snor_f_4b_opcodes, },
> >> { "mx25v8035f", INFO(0xc22314, 0, 64 * 1024, 16,
> >> SECT_4K | SPI_NOR_DUAL_READ |
> >> SPI_NOR_QUAD_READ) },
> >> { "mx25l25655e", INFO(0xc22619, 0, 64 * 1024, 512, 0) },
> >> { "mx66l51235f", INFO(0xc2201a, 0, 64 * 1024, 1024,
> >> - SPI_NOR_DUAL_READ | SPI_NOR_QUAD_READ |
> >> - SPI_NOR_4B_OPCODES) },
> >> + SPI_NOR_DUAL_READ | SPI_NOR_QUAD_READ)
> >> + .late_init = snor_f_4b_opcodes, },
> >> { "mx66u51235f", INFO(0xc2253a, 0, 64 * 1024, 1024,
> >> SECT_4K | SPI_NOR_DUAL_READ |
> >> - SPI_NOR_QUAD_READ | SPI_NOR_4B_OPCODES) },
> >> + SPI_NOR_QUAD_READ)
> >> + .late_init = snor_f_4b_opcodes, },
> >> { "mx66l1g45g", INFO(0xc2201b, 0, 64 * 1024, 2048,
> >> SECT_4K | SPI_NOR_DUAL_READ |
> >> SPI_NOR_QUAD_READ) },
> >> { "mx66l1g55g", INFO(0xc2261b, 0, 64 * 1024, 2048,
> >> SPI_NOR_QUAD_READ) },
> >> { "mx66u2g45g", INFO(0xc2253c, 0, 64 * 1024, 4096,
> >> - SECT_4K | SPI_NOR_DUAL_READ |
> >> - SPI_NOR_QUAD_READ | SPI_NOR_4B_OPCODES) },
> >> + SECT_4K | SPI_NOR_DUAL_READ | SPI_NOR_QUAD_READ)
> >> + .late_init = snor_f_4b_opcodes, },
> >> };
> >>
> >> static void macronix_default_init(struct spi_nor *nor)
> >> diff --git a/drivers/mtd/spi-nor/micron-st.c b/drivers/mtd/spi-nor/micron-st.c
> >> index c224e59820a1..72cc4673bf88 100644
> >> --- a/drivers/mtd/spi-nor/micron-st.c
> >> +++ b/drivers/mtd/spi-nor/micron-st.c
> >> @@ -121,13 +121,13 @@ static struct spi_nor_fixups mt35xu512aba_fixups = {
> >> static const struct flash_info micron_parts[] = {
> >> { "mt35xu512aba", INFO(0x2c5b1a, 0, 128 * 1024, 512,
> >> SECT_4K | USE_FSR | SPI_NOR_OCTAL_READ |
> >> - SPI_NOR_4B_OPCODES | SPI_NOR_OCTAL_DTR_READ |
> >> - SPI_NOR_OCTAL_DTR_PP |
> >> + SPI_NOR_OCTAL_DTR_READ | SPI_NOR_OCTAL_DTR_PP |
> >> SPI_NOR_IO_MODE_EN_VOLATILE)
> >> - .fixups = &mt35xu512aba_fixups},
> >> + .fixups = &mt35xu512aba_fixups,
> >> + .late_init = snor_f_4b_opcodes, },
> >
> > This flash populated the 4BAIT table, so you can simply drop the flag.
>
> I'll do this in a dedicated patch, I'll need your tested-by tag.
Okay, let's keep that for a separate series. I will do a conversion
series for the flashes I have on hand once this series is merged.
>
> > No need for the late_init().
> >
> > This makes me think that many other flashes might also have the 4BAIT
> > table but the developers chose to add this flag here since at that time
> > the norm was to populate all flash capabilities. I think we could be
> > able to drop many more .late_init like this. But unfortunately someone
> > needs to do the hard work of checking each flash, and most flash
> > datasheets don't even list the SFDP contents.
> >
> > So while I think in the ideal world we would go check each flash, I
> > think this is an acceptable compromise. Let's not let perfection be the
> > enemy of good.
>
> The patch doesn't change how the code works now. If some flashes can drop
> some flags, we can drop them in dedicated patches.
Yes, agreed.
>
> >
> > While we are on this topic, I find this a bit "ugly". Having to set
> > late_init() for setting these flags for each flash is not exactly very
> > clean or readable. I don't know how the future will look like, but if
> > each flash/family needs its own late_init() to set some flags, it won't
> > be very readable. We seem to be trading one type of complexity for
> > another. I dunno which is the lesser evil though...
>
> Your point is valid. This patch removes SPI_NOR_4B_OPCODES and sets
> SNOR_F_4B_OPCODES in a late_init() hook, forcing the reader to go through
> the late_init() function to see what's there. As you saw, late_init() can be
> used for tweaking flash's parameters, settings and methods, not just NOR flags,
> so I would expect that this hook to be present among flashes that don't define
> the SFDP tables or for flashes that have parameters that are not SFDP discoverable,
> the hook will be there anyway.
>
> This patch opens the door on how we could handle the flash_info flags. All flash_info
> flags that can be determined when parsing SFDP can be removed and use for flashes that
> skip SFDP, SNOR_F equivalents in late_init() methods. spi_nor_info_init_params()
> should NOT be called for SFDP capable flashes anyway, because in case of SFDP flashes,
> all the settings done in spi_nor_info_init_params() are overwritten when parsing SFDP.
> 1/ flashes with SFDP will set the flags as:
> SPI_NOR_PARSE_SFDP | non-sfdp-discoverable-flags
> 2/ flashes without SFDP:
> SPI_NOR_SKIP_SFDP | non-sfdp-discoverable-flags
> and a late_init() for SNOR_F equivalents of flash_info flags from
> spi_nor_info_init_params()
> 3/ flashes that collide, one with SFDP and the other without:
> SPI_NOR_PARSE_SFDP | non-sfdp-discoverable-flags
> and a late_init() for SNOR_F equivalents of flash_info flags from
> spi_nor_info_init_params(), that will be used for the flash without SFDP.
> 4/ individual flash, no collisions, a flavor supports SFDP, the other not:
> SPI_NOR_PARSE_SFDP | non-sfdp-discoverable-flags
> and a late_init() for SNOR_F equivalents of flash_info flags from
> spi_nor_info_init_params(), that will be used for the flash without SFDP.
To me it looks like you can separate these flags into three classes:
1. Whether to parse SFDP or not.
2. Flags that can't be discovered via SFDP.
3. Flags that can be discovered by SFDP ideally but can't be
discovered for this particular flash because either SFDP is missing
or the table for this flag is missing.
With your series, flags from 1 and 2 are populated via .flags in
flash_info and the ones from 3 are populated via late_init().
Why can't we have 3 different fields for these 3 different flags? In
flash_info, we can set .parse_sfdp to true/false to indicate SFDP
support. We can set .nonsfdp_flags = X | Y | Z for non-sfdp-discoverable
flags. And we can set .fixup_flags = A | B | C (can probably pick a
better name) for the flags that your series sets through late_init().
This way, you have a clear separation between the three and they are all
clearly visible in the flash entry itself.
The only case where this might run into trouble is when a SFDP flash has
a collision with a non-SFDP flash and they both need different
fixup_flags. But I supposed that is a problem even if you use
late_init() so it certainly doesn't make anything worse.
I have not given this extensive thought, but it seems to make sense to
me, and I feel that it would make the flow easier to follow. Thoughts?
Am I missing something?
>
> Let me know what you think or if I missed something.
>
> Cheers,
> ta
>
> >
> >> { "mt35xu02g", INFO(0x2c5b1c, 0, 128 * 1024, 2048,
> >> - SECT_4K | USE_FSR | SPI_NOR_OCTAL_READ |
> >> - SPI_NOR_4B_OPCODES) },
> >> + SECT_4K | USE_FSR | SPI_NOR_OCTAL_READ)
> >> + .late_init = snor_f_4b_opcodes, },
> >> };
> >>
> >> static const struct flash_info st_parts[] = {
> >> @@ -149,25 +149,29 @@ static const struct flash_info st_parts[] = {
> >> SECT_4K | USE_FSR | SPI_NOR_QUAD_READ) },
> >> { "mt25ql256a", INFO6(0x20ba19, 0x104400, 64 * 1024, 512,
> >> SECT_4K | USE_FSR | SPI_NOR_DUAL_READ |
> >> - SPI_NOR_QUAD_READ | SPI_NOR_4B_OPCODES) },
> >> + SPI_NOR_QUAD_READ)
> >> + .late_init = snor_f_4b_opcodes, },
> >> { "n25q256a", INFO(0x20ba19, 0, 64 * 1024, 512, SECT_4K |
> >> USE_FSR | SPI_NOR_DUAL_READ |
> >> SPI_NOR_QUAD_READ) },
> >> { "mt25qu256a", INFO6(0x20bb19, 0x104400, 64 * 1024, 512,
> >> SECT_4K | USE_FSR | SPI_NOR_DUAL_READ |
> >> - SPI_NOR_QUAD_READ | SPI_NOR_4B_OPCODES) },
> >> + SPI_NOR_QUAD_READ)
> >> + .late_init = snor_f_4b_opcodes, },
> >> { "n25q256ax1", INFO(0x20bb19, 0, 64 * 1024, 512,
> >> SECT_4K | USE_FSR | SPI_NOR_QUAD_READ) },
> >> { "mt25ql512a", INFO6(0x20ba20, 0x104400, 64 * 1024, 1024,
> >> SECT_4K | USE_FSR | SPI_NOR_DUAL_READ |
> >> - SPI_NOR_QUAD_READ | SPI_NOR_4B_OPCODES) },
> >> + SPI_NOR_QUAD_READ)
> >> + .late_init = snor_f_4b_opcodes, },
> >> { "n25q512ax3", INFO(0x20ba20, 0, 64 * 1024, 1024,
> >> SECT_4K | USE_FSR | SPI_NOR_QUAD_READ |
> >> SPI_NOR_HAS_LOCK | SPI_NOR_HAS_TB |
> >> SPI_NOR_4BIT_BP | SPI_NOR_BP3_SR_BIT6) },
> >> { "mt25qu512a", INFO6(0x20bb20, 0x104400, 64 * 1024, 1024,
> >> SECT_4K | USE_FSR | SPI_NOR_DUAL_READ |
> >> - SPI_NOR_QUAD_READ | SPI_NOR_4B_OPCODES) },
> >> + SPI_NOR_QUAD_READ)
> >> + .late_init = snor_f_4b_opcodes, },
> >> { "n25q512a", INFO(0x20bb20, 0, 64 * 1024, 1024,
> >> SECT_4K | USE_FSR | SPI_NOR_QUAD_READ |
> >> SPI_NOR_HAS_LOCK | SPI_NOR_HAS_TB |
> >> diff --git a/drivers/mtd/spi-nor/spansion.c b/drivers/mtd/spi-nor/spansion.c
> >> index aad7170768b4..af10833f56d8 100644
> >> --- a/drivers/mtd/spi-nor/spansion.c
> >> +++ b/drivers/mtd/spi-nor/spansion.c
> >> @@ -259,14 +259,14 @@ static const struct flash_info spansion_parts[] = {
> >> { "s25fl208k", INFO(0x014014, 0, 64 * 1024, 16,
> >> SECT_4K | SPI_NOR_DUAL_READ) },
> >> { "s25fl064l", INFO(0x016017, 0, 64 * 1024, 128,
> >> - SECT_4K | SPI_NOR_DUAL_READ | SPI_NOR_QUAD_READ |
> >> - SPI_NOR_4B_OPCODES) },
> >> + SECT_4K | SPI_NOR_DUAL_READ | SPI_NOR_QUAD_READ)
> >> + .late_init = snor_f_4b_opcodes, },
> >> { "s25fl128l", INFO(0x016018, 0, 64 * 1024, 256,
> >> - SECT_4K | SPI_NOR_DUAL_READ | SPI_NOR_QUAD_READ |
> >> - SPI_NOR_4B_OPCODES) },
> >> + SECT_4K | SPI_NOR_DUAL_READ | SPI_NOR_QUAD_READ)
> >> + .late_init = snor_f_4b_opcodes, },
> >> { "s25fl256l", INFO(0x016019, 0, 64 * 1024, 512,
> >> - SECT_4K | SPI_NOR_DUAL_READ | SPI_NOR_QUAD_READ |
> >> - SPI_NOR_4B_OPCODES) },
> >> + SECT_4K | SPI_NOR_DUAL_READ | SPI_NOR_QUAD_READ)
> >> + .late_init = snor_f_4b_opcodes, },
> >> { "cy15x104q", INFO6(0x042cc2, 0x7f7f7f, 512 * 1024, 1,
> >> SPI_NOR_NO_ERASE) },
> >> { "s28hs512t", INFO(0x345b1a, 0, 256 * 1024, 256,
> >> --
> >> 2.25.1
> >>
> >
> > --
> > Regards,
> > Pratyush Yadav
> > Texas Instruments Inc.
> >
>
--
Regards,
Pratyush Yadav
Texas Instruments Inc.
More information about the linux-mtd
mailing list