Nordic qspi-nor flash incorrect/missing documentation

[Kaikon]

According to https://docs.zephyrproject.org/latest/build/dts/api/bindings/mtd/nordic,qspi-nor.html the available quad-enable-requirements are 'NONE', 'S2B1v1', 'S1B6', 'S2B7', 'S2B1v4', 'S2B1v5', 'S2B1v6'.
1) What is the difference between 'S2B1v1', 'S2B1v4', 'S2B1v5' and 'S2B1v6'? Where can I find documentation about it?
2) When looking at code ( https://github.com/zephyrproject-rtos/zephyr/blob/main/drivers/flash/nrf_qspi_nor.c line 179), 'S2B7' is not supported, i.e. documentation is incorrect: "Driver only supports NONE, S1B6, S2B1v1, S2B1v4, S2B1v5 or S2B1v6 for quad-enable-requirements"

[dejans]

Hi,

1) What is the difference between 'S2B1v1', 'S2B1v4', 'S2B1v5' and 'S2B1v6'? Where can I find documentation about it?

I will get back to you regarding this question.

2) When looking at code ( https://github.com/zephyrproject-rtos/zephyr/blob/main/drivers/flash/nrf_qspi_nor.c line 179), 'S2B7' is not supported, i.e. documentation is incorrect: "Driver only supports NONE, S1B6, S2B1v1, S2B1v4, S2B1v5 or S2B1v6 for quad-enable-requirements"

I think that documentation probably specifies what is showed in jesd216.h. I have asked internally about the correctness of our documentation in this case.

Best regards,
Dejan

[Kaikon]

Is there any update on this?

[dejans]

Hi,

Unfortunately not. I am still waiting for this to be checked. I have asked again internally.

Thank you for your patience.

Best regards,
Dejan

[dejans]

Hi,

dejans said:

1) What is the difference between 'S2B1v1', 'S2B1v4', 'S2B1v5' and 'S2B1v6'? Where can I find documentation about it?

The detailed description of the modes is in COMMON FLASH INTERFACE (CFI): | JEDEC referred in the “Description” part of the documentation. These options need to be selected with accordance to what a specific connected flash chip requires.

dejans said:

2) When looking at code ( https://github.com/zephyrproject-rtos/zephyr/blob/main/drivers/flash/nrf_qspi_nor.c line 179), 'S2B7' is not supported, i.e. documentation is incorrect: "Driver only supports NONE, S1B6, S2B1v1, S2B1v4, S2B1v5 or S2B1v6 for quad-enable-requirements"

S2B7 is not supported in the driver and the documentation is not correct. I have notified relevant people about this internally.

Best regards,
Dejan