esp-idf/components/esp_rom/include/esp32/rom
Michael (XIAO Xufeng) 9582cbe5b8 bootloader: fix the WRSR format for ISSI flash chips
1. The 2nd bootloader always call `rom_spiflash_unlock()`, but never help to clear the WEL bit when exit. This may cause system unstability.

   This commit helps to clear WEL when flash configuration is done.

   **RISK:** When the app starts, it didn't have to clear the WEL before it actually write/erase. But now the very first write/erase operation should be done after a WEL clear. Though the risk is little (all the following write/erase also need to clear the WEL), we still have to test this carefully, especially for those functions used by the OTA.

2. The `rom_spiflash_unlock()` function in the patch of ESP32 may (1) trigger the QPI, (2) clear the QE or (3) fail to unlock the ISSI chips.

   Status register bitmap of ISSI chip and GD chip:

| SR | ISSI | GD25LQ32C |
| -- | ---- | --------- |
| 0  | WIP  | WIP       |
| 1  | WEL  | WEL       |
| 2  | BP0  | BP0       |
| 3  | BP1  | BP1       |
| 4  | BP2  | BP2       |
| 5  | BP3  | BP3       |
| 6  | QE   | BP4       |
| 7  | SRWD | SRP0      |
| 8  |      | SRP1      |
| 9  |      | QE        |
| 10 |      | SUS2      |
| 11 |      | LB1       |
| 12 |      | LB2       |
| 13 |      | LB3       |
| 14 |      | CMP       |
| 15 |      | SUS1      |

   QE bit of other chips are at the bit 9 of the status register (i.e. bit 1 of SR2), which should be read by RDSR2 command.

   However, the RDSR2 (35H, Read Status 2) command for chip of other vendors happens to be the QIOEN (Enter QPI mode) command of ISSI chips. When the `rom_spiflash_unlock()` function trys to read SR2, it may trigger the QPI of ISSI chips.

   Moreover, when `rom_spiflash_unlock()` try to clear the BP4 bit in the status register, QE (bit 6) of ISSI chip may be cleared by accident. Or if the ISSI chip doesn't accept WRSR command with argument of two bytes (since it only have status register of one byte), it may fail to clear the other protect bits (BP0~BP3) as expected.

   This commit makes the `rom_spiflash_unlock()` check whether the vendor is issi. if so, `rom_spiflash_unlock()` only send RDSR to read the status register, send WRSR with only 1 byte argument, and also avoid clearing the QE bit (bit 6).

3. `rom_spiflash_unlock()` always send WRSR command to clear protection bits even when there is no protection bit active. And the execution of clearing status registers, which takes about 700us, will also happen even when there's no bits cleared.

   This commit skips the clearing of status register if there is no protection bits active.

Also move the execute_flash_command to be a bootloader API; move
implementation of spi_flash_wrap_set to the bootloader
2022-06-09 12:41:56 +08:00
..
aes.h move hwcrypto from esp32 to mbedtls 2019-03-26 16:24:22 +08:00
bigint.h separate rom from esp32 component to esp_rom 2019-03-21 18:51:45 +08:00
cache.h separate rom from esp32 component to esp_rom 2019-03-21 18:51:45 +08:00
crc.h sdspi: support crc16_be for esp32s2 2020-02-12 15:15:46 +08:00
efuse.h separate rom from esp32 component to esp_rom 2019-03-21 18:51:45 +08:00
ets_sys.h esp_rom: Fail immediately if the wrong SoC's header file is included 2019-08-12 16:57:40 +10:00
gpio.h fix broken CONFIG_LEGACY_INCLUDE_COMMON_HEADERS 2020-04-20 14:01:09 +08:00
libc_stubs.h separate rom from esp32 component to esp_rom 2019-03-21 18:51:45 +08:00
lldesc.h separate rom from esp32 component to esp_rom 2019-03-21 18:51:45 +08:00
md5_hash.h separate rom from esp32 component to esp_rom 2019-03-21 18:51:45 +08:00
miniz.h rom: Add warnings for miniz functions that won't work due to missing malloc 2019-09-06 11:01:34 +10:00
rtc.h build and link hello-world for esp32s2beta 2019-06-11 13:07:37 +08:00
secure_boot.h Secure Boot: Fixes the cpp macro in esp32 secure boot rom functions. 2020-09-23 03:01:51 +05:30
sha.h esp32: Rewrite esp_sha function 2019-05-13 12:32:45 +08:00
spi_flash.h bootloader: fix the WRSR format for ISSI flash chips 2022-06-09 12:41:56 +08:00
tbconsole.h tools: Mass fixing of empty prototypes (for -Wstrict-prototypes) 2019-08-01 16:28:56 +07:00
tjpgd.h separate rom from esp32 component to esp_rom 2019-03-21 18:51:45 +08:00
uart.h all: Using xxx_periph.h 2019-06-03 14:15:08 +08:00