Esp32 Flash Encryption Guide Cn

User Manual:

Open the PDF directly: View PDF .
Page Count: 20

版本 1.0

ESP32 Flash 加密指南

关于本册

本介绍 ESP32 ﬂash 加解密的原以及如何使和关闭加密功能。

发布说明

档变通知

户可通过乐鑫官订阅技术档变的电邮件通知。

期

版本

发布说明

2017.07

V1.0

󰔓次发布。

录 
概述  1 .........................................................................................................................................
Flash 加密机制  2 ........................................................................................................................
Flash 加密初始化  3 ....................................................................................................................
使 Flash 加密  4 .......................................................................................................................
1. Flash 解密的范围!4"........................................................................................................................
2. 读加密 Flash!4"...............................................................................................................................
3. 写加密 Flash!4"...............................................................................................................................
新加密 Flash  6 ........................................................................................................................
1. OTA 升级!6"....................................................................................................................................
2. 烧写!6".....................................................................................................................................
3. 新 Flash 的限制!6".......................................................................................................................
4. 烧写的注意事项!6"...................................................................................................................
5. 重新烧写程序!6".......................................................................................................................
6. 关闭烧写!7"..............................................................................................................................
预成 Flash 加密密钥  8 ............................................................................................................
1. 预成 Flash 加密密钥!8"................................................................................................................
2. 烧写 Flash 加密密钥!8"...................................................................................................................
3. 使预成的密钥进󰀉第次烧写!9".............................................................................................
4. 使预成的密钥重烧 Flash!9"......................................................................................................
关闭 Flash 加密  10 .....................................................................................................................
Flash 加密的局限  11 ..................................................................................................................
Flash 加密󰕜级功能  12 ..............................................................................................................
1. 加密分区标志!12"............................................................................................................................
2. 启 UART 引导加载程序加解密!12"..............................................................................................
3. 设置 FLASH_CRYPT_CONFIG!13".................................................................................................

10.技术参考 14 ...............................................................................................................................

10.1. FLASH_CRYPT_CNT eFuse!14".....................................................................................................

10.2. FLASH 加密算法!14.......................................................................................................................

1. 概述"

1. 概述

ESP32 ﬂash 加密功能于加密 ESP32 SPI ﬂash 󰋿的内容。启 ﬂash 加密时，部分

ﬂash 内容可以防物读取。

Flash 加密功能与安全启动 (secure boot) 功能是分开的，户可以直接使 ﬂash 加密功

能。但是，如果要保证安全的使环境，建议将这两个功能起使。

📖 说明：

启 ﬂash 加密会限制后续对 ﬂash 内容的新。使 ﬂash 加密功能前请必阅读本档。

Espressif

!/!1 16

2017.07

2. Flash 加密机制"

2. Flash 加密机制

•Flash 的内容是使 256-bit 密钥的 AES 进󰀉加密的。Flash 加密密钥存储在芯内部

的 eFuse 中，并且（在默认情况下）软件能对其读写。

•通过 ESP32 的 ﬂash 缓存映射功能可以对 ﬂash 进󰀉透明读写，映射到地址空间的任意

ﬂash 区域在读取时都会被透明解密。

•户将明数据烧录到 ESP32 来启动加密功能，引导加载程序会在󰔓次启动时对数据

在 ﬂash 原处进󰀉加密。

•并󰒌所有的 ﬂash 数据都会被加密。被加密 ﬂash 数据包括：

-引导加载程序

- secure boot 引导加载程序摘要（如果启 secure boot）

-分区表

-所有“app”类型的分区

- OTA data 分区（OTA data 最多可以有个，当需要使 OTA 功能时会有该分区）

-分区表中所有标有“encrypt”的分区

些数据分区可能需要保持加密以于访问，或者可以使在数据加密时效的

ﬂash 新算法。于󰒌失性存储的 NVS 分区能加密。

•Flash 加密密钥存储在 ESP32 芯内部的 eFuse 密钥块 1 中。默认情况下，该密钥是

读写保护的，软件法访问或改。

•Flash 加密的算法是 AES-256，密钥会根据 ﬂash 的每 32 字节块的偏移地址进󰀉加密。

即 ﬂash 的每 32 字节块（两个连续的 16 字节 AES 块）使个唯的密钥进󰀉加密，

这个唯的密钥是由 ﬂash 加密密钥成的。

•虽然在芯上运󰀉的软件可以透明解密 ﬂash 内容，但默认情况下，如果启动 ﬂash

加密，则 UART 引导加载程序法解密（或加密）数据。

•所以，如果要使 ﬂash 加密的功能，在编写代码时必须谨慎。

Espressif

!/!2 16

2017.07

3. Flash 加密初始化"

3. Flash 加密初始化

本章介绍默认（推荐）的 ﬂash 加密初始化的过程。这个过程可以为开发或其他的定

制。详细信息请参阅章节 Flash 加密󰕜级功能。

启 ﬂash 加密的过程如下：

1. 编译引导加载程序时必须确保持 ﬂash 加密功能。在 make menuconfig 中，导航到

Security Features，将 Enable flash encryption on boot 勾选为 Yes。

2. 如果要使 Secure Boot 功能，则最好同时勾选这些选项。请先阅读 Secure Boot 的

档。

3. 构建并烧录引导程序、分区表和出 app image。这些分区最初被写 ﬂash 时未加

密。

4. 第次启动时，引导加载程序会读出 FLASH_CRYPT_CNT eFuse 的值为 0（出默认

值），然后会使硬件随机数成成 ﬂash 加密密钥。此密钥存储在 eFuse 中。此

密钥被读写保护，防软件进步访问。

5. 所有加密分区由引导加载程序直接就地加密。就地加密可能需要些时间（的分区可

能需要分钟）。

6. 烧写完成后，默认烧写 eFuse 来防加密的 ﬂash在 UART 引导加载程序运󰀉时被访

问。

7. FLASH_CRYPT_CONFIG eFuse 也烧写为最值 (0xF)，以最化 ﬂash 算法中被修改的密

钥的特数。多信息请参阅章节设置 FLASH_CRYPT_CONFIG。

8. 最后，FLASH_CRYPT_CNT eFuse 被烧写为初始值 1。正是这个 eFuse 激活透明 ﬂash

加密层，并限制后续重烧 ﬂash 的次数。有关 FLASH_CRYPT_CNT eFuse 的详细信

息，请参阅章节升级加密 Flash。

9. 引导加载程序从新加密的 ﬂash 中动重启。

⚠ 注意：

旦在第次启动时使 ﬂash 加密功能，则硬件最多允许后续 3 次通过新 ﬂash 内容。升级需

要遵循特定的程序，具体请参考章节烧写。

⚠ 注意：

第次启动加密正在运󰀉时要中断 ESP32 的电源。如果电源中断，ﬂash 内容会被破坏，需要再次使未

加密的数据进󰀉烧写。重新烧写会计烧写的限制总数。

Espressif

!/!3 16

2017.07

4. 使 Flash 加密"

4. 使 Flash 加密

ESP32 app 代码可以通过调 esp_flash_encryption_enabled 检查 ﬂash 加密是否启。

启 ﬂash 加密后，从代码访问 ﬂash 内容时需要注意以下事项。

4.1. Flash 解密的范围

每当 FLASH_CRYPT_CNT eFuse 的奇数个特被置为 1 时，通过 MMU的 ﬂash 缓存访问的所

有 ﬂash 内容都将被透明地解密。这些 ﬂash 内容包括：

- ﬂash (IROM) 中的可执󰀉 app 代码

-存储在 ﬂash (DROM) 中的所有只读数据。

-通过 esp_spi_flash_mmap 访问的数据

-由 ROM 引导加载程序读取的软件 bootloader image。

4.2. 读加密 Flash

要读取数据使 ﬂash 缓存 MMU 映射，我们建议使分区读取函数

esp_partition_read。使此函数时，只有加密分区中的数据才会被解密。其他分区将被

加密读取。这样，软件可以以相同的式访问加密和󰒌加密的 ﬂash。

通过其他 SPI  API 读取的数据会被解密：

-通过 esp_spi_flash_read 读取的数据被解密

-通过 ROM 函数 SPIRead() 读取的数据被解密（ESP-IDF app 持此函数）

-使󰒌失性存储 (NVS) API 存储的数据被加密，只能通过 SPI 的式读取明

数据。

4.3. 写加密 Flash

可能的话，建议使分区写函数 esp_partition_write。使此函数时，数据只有写加

密分区时才会被加密。数据写其他分区会被加密。这样，软件可以以相同的式访问

加密和󰒌加密的 ﬂash。

⚠ 注意：

MMU ﬂash 缓存条件地解密所有数据。在 ﬂash 中未加密存储的数据会被“透明解密”，并且在软件看来是乱

码。

Espressif

!/!4 16

2017.07

4. 使 Flash 加密"

当 write_encrypted 参数设置为 true 时，esp_spi_flash_write 函数才会加密数据，否

则，会加密数据。

ROM 函数 esp_rom_spiflash_write_encrypted 把加密数据写 ﬂash，ROM 函数

SPIWrite 把加密的数据写 ﬂash。（ESP-IDF app 持这些函数）。

未加密数据的最写为 4 字节（对󰘷式为 4 字节）。由于数据以块的形式加密，

所以加密数据的最写为 16 字节（对󰘷式为 16 字节）。

Espressif

!/!5 16

2017.07

5. 新加密 Flash"

5. 新加密 Flash

5.1. OTA 升级

加密分区的 OTA 升级将动加密，使 esp_partition_write 函数即可。

5.2. 烧写

如果使 secure boot，FLASH_CRYPT_CNT eFuse 允许通过（或其他物法）重烧

ﬂash，最多可以重烧 3次。

该过程涉及烧写明数据，然后重复烧写 FLASH_CRYPT_CNT󰐇eFuse，导致引导加载程序重

新加密此数据。

5.3. 新 Flash 的限制

加上初始的加密 ﬂash，总共可以通过进󰀉 4 次烧写。

关闭第四次加密后，FLASH_CRYPT_CNT 的最值为 0xFF，加密被永久关闭。

使 OTA 升级或预成的加密密钥可以受次数的限制。

5.4. 烧写的注意事项

•当通过重新烧写时，要重新烧写每个最初写明数据的分区（包括引导加载程

序）。可以跳过是“当前选择的”OTA app 分区（除󰒌在那󰋿找到明 app image，否

则这些分区会被重新加密。）但是，任何标有“encrypt”标志的分区将条件地被重新

加密，这意味着任何已加密的数据将被次加密并被破坏。

使 make󰐇flash 起烧写所有需要烧写的分区。

•如果启 secure boot，则法通过重新烧写，除󰒌启 secure boot的

Reflashable 选项，预成个密钥并将其烧写到 ESP32（请参阅 secure boot 

档）。在这种情况下，您可以重新烧写明 secure boot 摘要和 bootloader image 到偏

移地址 0x0。在烧写其他明数据之前，需要重新烧写该摘要。

5.5. 重新烧写程序

1. 正常构建 app。

Espressif

!/!6 16

2017.07

5. 新加密 Flash"

2. 正常使明数据烧写设备（使 make󰐇flash 或 esptool.py 命令。）烧写所有之前

加密的分区，包括引导程序（󰁡上节）。

3. 此时，设备将法启动（消息为 flash󰐇read󰐇err,󰐇1000），因为它需要个加密的引

导加载程序，但引导加载程序是明。

4. 通过运󰀉命令 espefuse.py󰐇burn_efuse󰐇FLASH_CRYPT_CNT 来烧写 FLASH_CRYPT_CNT。

espefuse.py 动将特的计数递增 1，以此来关闭加密。

5. 重置设备，设备会重新加密明分区，然后再次烧写󰐇FLASH_CRYPT_CNT 以重新启加

密。

5.6. 关闭烧写

启 ﬂash 加密（即第次启动完成）后，使 espefuse.py 写保护 FLASH_CRYPT_CNT，

以此关闭烧写。

espefuse.py󰐇--port󰐇PORT󰐇write_protect_efuse󰐇FLASH_CRYPT_CNT

这样可以防进步修改 ﬂash 加密的启和关闭。

Espressif

!/!7 16

2017.07

6. 预成 Flash 加密密钥"

6. 预成 Flash 加密密钥

可以在主机上预成个 ﬂash 加密密钥，并将其烧写到 ESP32 的 eFuse 密钥块中。这实

现在主机上预先加密数据，并烧写到 ESP32，需要明烧写新 ﬂash。

这种式有于开发，因为它消除 4 次重新烧写的限制。它还允许在启 secure boot

的情况下重新烧写，因为引导加载程序需要每次都重新烧写。

6.1. 预成 Flash 加密密钥

Flash 加密密钥是 32 个字节的随机数据。您可以使 espsecure.py 成随机密钥：

espsecure.py󰐇generate_flash_encryption_key󰐇my_flash_encryption_key.bin

（该数据的随机性取决于操作系统，也是 Python 安装的随机数据源。）

或者，如果您使 secure boot，并且有 secure boot 签名密钥，那么可以成个安全

引导私有签名密钥的确定性 SHA-256 摘要，并将其作为 ﬂash 加密密钥：

espsecure.py󰐇digest_private-key󰐇--keyfile󰐇secure_boot_signing_key.pem󰐇

my_flash_encryption_key.bin

（如果启 secure boot 的 reflashable 模式，则相同的 32 个字节会作为 secure boot 的

摘要密钥。）

从 secure boot 的数字签名 (signing) 密钥成 ﬂash 加密密钥意味着您只需要存储个密

钥件。但是，这种法适于产设备。

6.2. 烧写 Flash 加密密钥

旦成 ﬂash 加密密钥，您需要将其烧写到 ESP32 的 eFuse 密钥块。（这必须在第

次加密启动之前完成，否则 ESP32 将成个软件法访问或修改的随机密钥。）

烧写密钥到设备（只需要烧录次）：

espefuse.py󰐇--port󰐇PORT󰐇burn_key󰐇flash_encryption󰐇my_flash_encryption_key.bin

⚠ 注意：

此法仅于协助开发，适于产设备。如果是于产设备，请确保密钥是从󰕜质󰌂的随机数字源

成的，并且要在多个设备上共享 ﬂash 加密密钥。

Espressif

!/!8 16

2017.07

6. 预成 Flash 加密密钥"

6.3. 使预成的密钥进󰀉第次烧写

烧写密钥后，按照与章节 Flash 加密初始化相同的步骤在第次启动时烧写明 image。

引导程序将使预烧录的密钥启 ﬂash 加密，并加密所有分区。

6.4. 使预成的密钥重烧 Flash

Flash 加密在第次安全启动开启后，重新烧写加密 image 需要步额外的动操作。我

们需要预先加密想要在 ﬂash 中新的数据。

假设这是于烧写明数据的命令：

esptool.py󰐇--port󰐇/󰐇dev󰐇/󰐇ttyUSB0󰐇--baud󰐇115200󰐇write_flash󰐇0x10000󰐇build󰐇/󰐇my-app.bin

进制 app image build / my-app.bin 被写 0x10000 。需要使此件名和偏移地址来

加密数据，如下所示：

esfsecure.py󰐇encrypt_flash_data󰐇--keyfile󰐇my_flash_encryption_key.bin󰐇--address󰐇0x10000󰐇-o󰐇

build󰐇/󰐇my-app-encrypted.bin󰐇build󰐇/󰐇my-app.bin

此示命令将使提供的密钥加密 my-app.bin，并成个加密的件 my-app-

encrypted.bin。确保地址参数与您打算烧录 BIN 件的地址匹配。然后，使

esptool.py 烧写加密的 BIN 件：

esptool.py󰐇--port󰐇/󰐇dev󰐇/󰐇ttyUSB0󰐇--baud󰐇115200󰐇write_flash󰐇0x10000󰐇build󰐇/󰐇my-app-

encrypted.bin

需要其他操作或 eFuse 操作，因为数据在烧写时已经加密。

Espressif

!/!9 16

2017.07

7. 关闭 Flash 加密"

7. 关闭 Flash 加密

如果您启 ﬂash 加密，下次烧写明数据时将会软启动 ESP32（设备将断

重启，并打印错误 flash󰐇read󰐇err,󰐇1000）。您可以通过烧写 FLASH_CRYPT_CNT eFuse 来

关闭 ﬂash 加密。

1. 󰔓先运󰀉 make󰐇menuconfig，取消选中 Security Features 下的 Enable flash

encryption boot。

2. 退出 menuconfig 并保存新配置。

3. 再次运󰀉 make󰐇menuconfig，并仔细检查你是否真的取消这个选项！(如果启此选

项，则引导加载程序将在启动时即重新启加密。)

4. 运󰀉 make󰐇flash 构建并烧写个新的引导加载程序和 app，启 ﬂash 加密。

5. 运󰀉 espefuse.py (components/esptool_py/esptool）来禁 FLASH_CRYPT_CNT

eFuse：

6. 重启 ESP32，ﬂash 加密应该已经被关闭，引导加载程序将正常启动。

Espressif

!/!10 16

2017.07

8. Flash 加密的局限"

8. Flash 加密的局限

Flash 加密可防明被读出，从防未经授权的固件读写。解 ﬂash 加密系统的局限

性󰒌常重要：

•Flash 加密性能的强弱取决于密钥。因此，我们建议󰔓次启动时在设备上成密钥（默

认󰀉为）。如果在设备外成密钥，请确保遵循正确的过程。

•并󰒌所有数据都被加密存储。如果将数据存储在 ﬂash，请检查您使的法（库，API

等）是否持 ﬂash 加密。

•Flash 加密会阻攻击者解闪存的󰕜级布局。这是因为相邻的两个 16 字节 AES 块

使同个 AES 密钥。如果这些相邻的 16 字节块包含相同的内容（如空或填充

区域）时，这些块被加密时会产匹配的加密块对。这可能会让攻击者在加密设备之间

进󰀉󰕜级别较（即，判断两台设备是否运󰀉相同的固件版本）。

•出于同样的原因，攻击者可以随时知道对相邻的 16 字节块（32 字节对󰘷）是否包

含相同的内容。如果要存储的是感数据，请牢记这点。可以设计下 ﬂash 阻攻

击者（每 16 个字节使计数字节或其他相同的值即可）。

•Flash 加密󰆄以阻攻击者修改设备的固件。要防未经授权的固件在设备上运󰀉，

请配合使 secure boot。

Espressif

!/!11 16

2017.07

9. Flash 加密󰕜级功能"

9. Flash 加密󰕜级功能

9.1. 加密分区标志

某些分区默认加密。您也可以将任意分区标记为需要加密：

在分区表描述的 CSV 件中有标志字段。

标志字段通常空，如果在字段中写 encrypted，则分区将标记为加密，并将此处写的

数据视为加密（就像 app 分区样）：

#󰐇Name,󰐇󰐇󰐇Type,󰐇SubType,󰐇Offset,󰐇󰐇Size,󰐇Flags

nvs,󰐇󰐇󰐇󰐇󰐇󰐇data,󰐇nvs,󰐇󰐇󰐇󰐇󰐇0x9000,󰐇󰐇0x6000

phy_init,󰐇data,󰐇phy,󰐇󰐇󰐇󰐇󰐇0xf000,󰐇󰐇0x1000

factory,󰐇󰐇app,󰐇󰐇factory,󰐇0x10000,󰐇1M

secret_data,󰐇0x40,󰐇0x01,󰐇0x20000,󰐇256K,󰐇encrypted

•默认分区表都包括任何加密的数据分区。

•没有必要将 app 分区标记为加密，它们总是被视为加密的。

•如果未启 ﬂash 加密，则 encrypted 标志起作。

•如果您希望保护 phy_init 数据防物读取或修改，可以将 phy 分区标记为加密。

•nvs 分区法被标记为加密。

9.2. 启 UART 引导加载程序加解密

默认情况下，󰔓次启动时，ﬂash 加密过程会烧写 DISABLE_DL_ENCRYPT，

DISABLE_DL_DECRYPT 和 DISABLE_DL_CACHE：

•DISABLE_DL_ENCRYPT 在 UART 引导加载程序启动模式下禁 ﬂash 加密操作。

•DISABLE_DL_DECRYPT 在 UART 引导加载程序模式下关闭透明解密，即使使

FLASH_CRYPT_CNT eFuse 将其使能。

•DISABLE_DL_CACHE 在 UART 引导加载程序模式下禁整个 MMU ﬂash 缓存。

在第次启动之前，可以仅烧写某些 eFuse 特，并写保护其余的 eFuse 特（使未设

置的值 0），以保它们。如：

espefuse.py󰐇--port󰐇PORT󰐇burn_efuse󰐇DISABLE_DL_DECRYPT

espefuse.py󰐇--port󰐇PORT󰐇write_protect_efuse󰐇DISABLE_DL_ENCRYPT

Espressif

!/!12 16

2017.07

9. Flash 加密󰕜级功能"

（请注意，这 3 个 eFuse 特都通过同个写保护位关闭，因此写保护个特将起作

于这 3 个特。因此，配置特必须在写保护之前进󰀉。）

9.3. 设置 FLASH_CRYPT_CONFIG

FLASH_CRYPT_CONFIG eFuse 决定 ﬂash 加密密钥中进󰀉块偏移“调整”的特数。详细信息

请参阅章节 Flash 加密算法。

引导加载程序的󰔓次引导始终将此值设置为最值 0xF。

可以动烧写这些 eFuse，并在󰔓次启动之前进󰀉写保护，以选择同的调整值。但是

我们推荐这样做。

当 FLASH_CRYPT_CONFIG 值为零时，我们强建议要写保护。如果此 eFuse 设置为零，

ﬂash 加密密钥中的特会被调整，ﬂash 加密算法等同于 AES ECB 模式。

⚠ 注意：

•写保护这些 eFuse 特以保持他们被设置作，因为 esptool.py 持写或读取加密 ﬂash。

•DISABLE_DL_DECRYPT 未被设置（即值为 0），这会使 ﬂash 加密效，因为具有物访问权限的攻击

者可以使 UART 引导加载程序模式（使定义存根代码）读出 ﬂash 中的内容。

Espressif

!/!13 16

2017.07

10. 技术参考"

10. 技术参考

10.1. FLASH_CRYPT_CNT eFuse

FLASH_CRYPT_CNT 是个 8-bit eFuse 字段，于控制 ﬂash 加密。Flash 加密的启或关闭

取决于此 eFuse 中设置为“1”的位数，具体如下：

•当偶数个 (0, 2, 4, 6, 8) 特被置位时：关闭 Flash 加密，任何加密数据都能被解密。

如果引导加载程序的 Enable flash encryption on boot 被启，则引导加载程序会获得这

个信息，然后当它发现未被加密的数据时会重新加密 ﬂash。加密完成后，引导加载程序会

将 eFuse 中的另特置为'1'，表示有奇数个特被置为 1。

1. 在第个明启动时，特的计数为全新值 0，引导加载程序在加密后将计数改

为 1（值为 0x01）。

2. 重烧 ﬂash 后，特数动新为 2（值为 0x03）。重新加密后，引导程序将计数

改为 3（值为 0x07）。

3. 重烧 ﬂash 后，特数动新为 4（值为 0x0F）。重新加密后，引导程序将计数

改为 5（值为 0x1F）。

4. 重烧 ﬂash 后，特数动新为 6（值为 0x3F）。重新加密后，引导程序将计数

改为 7（值为 0x7F）。

•当奇数个 (1, 3, 5, 7) 特被置位时：使能透明读取加密 ﬂash。

•当 8 个特被被置位后（eFuse 值为 0xFF）：关闭透明读取加密 ﬂash，任何加密数据

永久可访问。引导加载程序通常会检测到这种情况并停。为避免这种状态被加

载未经授权的代码，必须使 secure boot 或者写保护 FLASH_CRYPT_CNT eFuse。

10.2. FLASH 加密算法

•AES-256 在 16 字节的数据块上运󰀉。Flash 加密引擎对 32 字节块（即两个连续的

AES 块）中的数据进󰀉加解密。

•AES 算法在 ﬂash 加密中被反转使，即 ﬂash 加密的“加密”操作是 AES 解密，“解密”

操作是 AES 加密。这种机制是出于性能的考虑，并会影响算法的有效性。

•Flash 加密的主密钥存储在 eFuse (BLOCK1) 中，默认情况下软件能读写。

•每个 32 字节块（两个相邻的 16 字节 AES 块）共个唯的密钥进󰀉加密。这个密

钥源 eFuse 中的主密钥，与 ﬂash 中该块的偏移进󰀉异或（“密钥调整”）。

Espressif

!/!14 16

2017.07

10. 技术参考"

•具体的调整取决于 FLASH_CRYPT_CONFIG eFuse 的配置。FLASH_CRYPT_CONFIG 是个 4-

bit eFuse，其中每个特使能特定范围的密钥特的异或：

- Bit1，密钥的 0-66 特被异或。

- Bit2，密钥的 67-131 特被异或。

- Bit3，密钥的 132-194 特被异或。

- Bit4，密钥的 195-256 特被异或。

建议将 FLASH_CRYPT_CONFIG 始终设置为默认值 0xF，以所有密钥特都能与块偏

移进󰀉异或。有关详细信息，请参阅章节设置 FLASH_CRYPT_CONFIG。

•块偏移（特 5-23）的󰕜 19 位与主加密密钥进󰀉异或。选择此范围有两个原因：ﬂash

最为 16 MB（24 位），每个块为 32 字节，所以最低有效 5 位始终为零。

•19 个块偏移特与 ﬂash 加密密钥的 256 个特之间存在特定映射，这种映射决定哪

个特与哪个块偏移进󰀉异或。有关映射的完整信息，请参阅 espsecure.py 源代码中

的_FLASH_ENCRYPTION_TWEAK_PATTERN 变󰌂。

•关于 Python 中完整的 ﬂash 加密算法，请参阅 espsecure.py 源代码中的

_flash_encryption_operation() 函数。

Espressif

!/!15 16

2017.07

免责申明和版权公告

本中的信息，包括供参考的 URL 地址，如有变，恕另󰀉通知。

档“按现状”提供，负任何担保责任，包括对适销性、适于特定途或󰒌侵

权性的任何担保，和任何提案、规格或样品在他处提到的任何担保。本档

负任何责任，包括使本档内信息产的侵犯任何专权󰀉为的责任。本

档在此未以禁反󰁻或其他式授予任何知识产权使许可，管是明示许可

还是暗示许可。

Wi-Fi 联盟成员标志归 Wi-Fi 联盟所有。蓝标志是 Bluetooth SIG 的注册商标。

中提到的所有商标名称、商标和注册商标均属其各所有者的财产，特此声

明。

乐鑫 IoT 团队

www.espressif.com



Esp32 Flash Encryption Guide Cn

Navigation menu

Versions of this User Manual:

Views

Navigation