修订历史
日期 |
版本 |
发布说明 |
|---|---|---|
2026-10-21 |
v3.1 |
|
2025-10-11 |
v3.0 |
更新勘误标题的大小写格式和勘误编号 |
2025-01-03 |
v2.9 |
|
2024-07-29 |
v2.8 |
|
2023-09-19 |
v2.7 |
|
2023-02-02 |
v2.6 |
|
2022-11-23 |
v2.5 |
|
2022-10-13 |
v2.4 |
|
2020-09-25 |
v2.3 |
|
2020-06-08 |
v2.2 |
|
2020-05-14 |
v2.1 |
日期 |
版本 |
发布说明 |
|---|---|---|
2020-05-08 |
v2.0 |
|
2020-03-16 |
v1.9 |
|
2018-12 |
v1.8 |
|
2018-05 |
v1.7 |
|
2018-05 |
v1.6 |
|
2018-02 |
v1.5 |
|
2018-02 |
v1.4 |
|
2017-06 |
v1.3 |
日期 |
版本 |
发布说明 |
|---|---|---|
2017-04 |
v1.2 |
|
2016-12 |
v1.1 |
|
2016-11 |
v1.0 |
|
[TWAI-880] 发送数据帧时发生总线错误可能导致下一次接收到的数据字节无效
描述
当 TWAI 控制器发送数据帧时,如果在数据段或 CRC 字段发生总线错误,下一次接收到的数据可能发生字节移位。该帧的标识符和数据长度仍可能正确,且控制器不会对该接收帧报告错误。因此,下一次接收的数据帧应视为无效。
控制器在发送和接收时共用一个字节计数器来监测总线活动。发送期间如果在数据段发生总线错误,且该帧在 CRC 字段之前结束(计数器通常在 CRC 字段被清零),计数器会停留在错误状态,从而使下一次接收帧的数据字节发生移位。
变通方法
置位 INTERRUPT_BUS_ERR_INT_ENA。接收到总线错误中断时,读取 ERROR_CODE_CAPTURE_REG,以检测发送期间数据段或 CRC 字段中的总线错误。如果符合该条件,复位 TWAI 控制器(需要保存并恢复当前寄存器的数值)。
解决方案
暂无 修复计划。
[ULP-3.19] Deep-sleep 模式下如果 RTC_PERIH 电源域上电的话,则无法使用 ULP 协处理器或触摸传感器
描述
ULP 协处理器和触摸传感器的主要工作时钟是 FAST_CLK。在 Deep-sleep 模式下,如果 RTC_PERIH 电源域 (RTC Peripherals) 保持供电,则 ULP 协处理器和触摸传感器会比时钟管理模块更早接收到启动信号。这导致它们在工作时钟切换到 FAST_CLK 之前,会先在 SLOW_CLK 时钟下运行一段时间,从而造成工作时钟的不准确。因此,在 Deep-sleep 模式下,如果 RTC_PERIH 保持供电,则 ULP 协处理器和触摸传感器无法使用。
变通方法
如果用户要使用 ULP 协处理器和触摸传感器功能,那么在 Deep-sleep 模式下,RTC_PERIPH 必须保持掉电。请注意,此时 EXT0 唤醒不可用,因为 EXT0 唤醒功能只能在 RTC_PERIPH 上电的情况下工作。
因此,用户需要在使用 EXT0 唤醒功能和 ULP 协处理器/触摸传感器功能之间取舍:
如果要用 EXT0 唤醒功能,则 RTC_PERIPH 电源域必须保持供电,此时 ULP 协处理器和触摸传感器功能不可用。
如果要用 ULP 协处理器和触摸传感器功能,则 RTC_PERIPH 必须保持掉电,此时 EXT0 唤醒功能不可用。
解决方案
暂无 修复计划。
[CLK-3.22] 以太网与 Wi-Fi 共用时,ESP32 不能用作 PHY 时钟源
描述
RMII 工作模式下的以太网 MAC 和 PHY 需要一个公共的 50 MHz 同步时钟(即 RMII 时钟)。如果同时使用以太网与 Wi-Fi,则 RMII 时钟不能由内部的 ESP32 APLL 产生,因为会导致时钟不稳定。
变通方法
如果要使用内部 APLL 生成同步时钟,则需要关闭 Wi-Fi。
如果要同时使用以太网和 Wi-Fi,则必须使用外部 PHY 或外部时钟源提供同步时钟。
解决方案
暂无 修复计划。
[RTC-126] 从 Light-sleep 模式唤醒后 RTC 电源域寄存器读取错误
描述
如果在 Light-sleep 模式下关闭 RTC 外设的电源,从 Light-sleep 模式唤醒后,ESP32 的 CPU 读取 RTC 电源域的寄存器时会有一定概率出错。
变通方法
建议用户避免在 Light-sleep 模式下关闭 RTC 外设的电源,此时不会影响功耗。
解决方案
暂无 修复计划。
[CPU-3.21] CPU 访问五个特定地址被中断后,后续 CPU 访问会被拖住
描述
当某个 CPU 使用 0x3FF40000 (UART0)、0x3FF50000 (UART1)、0x3FF6E000 (UART2)、0x3FF4F004 (I2S0)、0x3FF6D004 (I2S1) 这五个特定地址读取 FIFO 数据时,如果此时 CPU 发生中断,则读请求会被打断。 这会导致总线桥一直处于等待读请求结束的状态。接着任意 CPU 访问 APB 外设寄存器(0x3FF40000 ~ 0x3FF7FFFF 或 0x60000000 ~ 0x6003FFFF)请求就会被拒绝, 导致后续 CPU 访问被拖住。
写入这五个地址不会有问题。
变通方法
读这五个特定地址之前禁用 CPU 中断,访问完成后开启 CPU 中断。
解决方案
暂无 修复计划。
[GPIO-3.14] 同一组 GPIO 管脚内,边沿中断不能和其他中断一起使用
描述
在中断配置寄存器上,GPIO0 ~ GPIO31 共用一组寄存器,GPIO32 ~ GPIO39 共用一组寄存器,RTC GPIO0 ~ RTC GPIO17 共用另一组寄存器。在同一组内,如果某一管脚被配置为边沿中断,那么其他中断(包括边沿中断和电平中断)将不可用。
电平中断没有此限制,即一组内如果没有沿中断,则可以有多组电平中断。
原因
GPIO 的以下三组 STATUS/W1TS/W1TC 寄存器操作的同时,可能造成同一组内边沿中断无法正常触发。具体为:
以下寄存器的操作可能造成 GPIO_STATUS_REG 的边沿中断无法正常触发:
GPIO_STATUS_W1TS_REG
GPIO_STATUS_W1TC_REG
GPIO_STATUS_REG
以下寄存器的操作可能造成 GPIO_STATUS1_REG 的边沿中断无法正常触发:
GPIO_STATUS1_W1TS_REG
GPIO_STATUS1_W1TC_REG
GPIO_STATUS1_REG
以下寄存器的操作可能造成 RTCIO_RTC_GPIO_STATUS_REG 的边沿中断无法正常触发:
RTCIO_RTC_GPIO_STATUS_W1TS_REG
RTCIO_RTC_GPIO_STATUS_W1TC_REG
RTCIO_RTC_GPIO_STATUS_REG
变通方法
使用电平中断模拟边沿中断,具体如下:
要实现 GPIO 的上升沿中断,按照下面的步骤进行配置:
配置 GPIO 的中断类型为高;
CPU 的中断服务响应后,把 GPIO 的中断类型改为低。此时会发生第二次中断,需要 CPU 忽略这次中断服务程序。
要实现 GPIO 的下降沿中断,按照下面的步骤进行配置:
配置 GPIO 的中断类型为低;
CPU 的中断服务响应后,把 GPIO 的中断类型改为高。此时会发生第二次中断,需要 CPU 忽略这次中断服务程序。
解决方案
暂无 修复计划。
[UART-3.17] UART fifo_cnt 不能正确表示 FIFO 中有效数据长度
描述
使用 DPORT 读 UART FIFO 时,如果软件的读 FIFO 操作被中断打断,那么 fifo_cnt 会被错误地减 1。
变通方法
使用 DPORT 读取 FIFO 时,需结合读/写 FIFO 偏移地址计算 FIFO 中有效数据长度。例如:
if (wr_addr > rd_addr) {
len = wr_addr - rd_addr;
} else if (wr_addr < rd_addr){
len = (wr_addr + 128) - rd_addr;
} else {
len = fifo_cnt > 0 ? 128 : 0;
}
其中 wr_addr 表示写 FIFO 偏移地址,rd_addr 表示读 FIFO 偏移地址,fifo_cnt 表示芯片记录的 FIFO 中有效字节数,len 表示重新计算后正确的有效字节数。
解决方案
暂无 修复计划。
[GPIO-3.11] 当一些 RTC 外设的电源打开时,GPIO36 和 GPIO39 的数字输入会被拉低约 80 ns
描述
打开以下 RTC 外设的电源会发生此问题:
SAR ADC1 传感器
SAR ADC2 传感器
AMP 传感器
变通方法
当用户决定把用于控制以上传感器的电源域打开时,应当忽略来自 GPIO36 和 GPIO39 的输入。
解决方案
暂无 修复计划。
[CPU-3.3] CPU 访问外设时,如果连续不间断地写同一个地址,会出现数据丢失的现象
描述
一些 ESP32 外设映射到两条内部存储器总线(AHB 和 DPORT)。当通过 DPORT 写入时,对相同地址的连续写入可能会出现数据丢失的现象。
变通方法
当连续写同一个地址(即类似 FIFO 的地址)时,使用 AHB 地址而不是 DPORT 地址。(对于其他类型的寄存器写入,使用 DPORT 地址可能写性能更好。)
寄存器名称 |
DPORT 地址 |
AHB(安全)地址 |
|---|---|---|
UART_FIFO_REG |
0x3FF40000 |
0x60000000 |
UART1_FIFO_REG |
0x3FF50000 |
0x60010000 |
UART2_FIFO_REG |
0x3FF6E000 |
0x6002E000 |
I2S0_FIFO_RD_REG |
0x3FF4F004 |
0x6000F004 |
I2S1_FIFO_RD_REG |
0x3FF6D004 |
0x6002D004 |
GPIO_OUT_REG |
0x3FF44004 |
0x60004004 |
GPIO_OUT_W1TS_REG |
0x3FF44008 |
0x60004008 |
GPIO_OUT_W1TC_REG |
0x3FF4400C |
0x6000400C |
GPIO_OUT1_REG |
0x3FF44010 |
0x60004010 |
GPIO_OUT1_W1TS_REG |
0x3FF44014 |
0x60004014 |
GPIO_OUT1_W1TC_REG |
0x3FF44018 |
0x60004018 |
GPIO_ENABLE_REG |
0x3FF44020 |
0x60004020 |
GPIO_ENABLE_W1TS_REG |
0x3FF44024 |
0x60004024 |
GPIO_ENABLE_W1TC_REG |
0x3FF44028 |
0x60004028 |
GPIO_ENABLE1_REG |
0x3FF4402C |
0x6000402C |
GPIO_ENABLE1_W1TS_REG |
0x3FF44030 |
0x60004030 |
GPIO_ENABLE1_W1TC_REG |
0x3FF44034 |
0x60004034 |
解决方案
已在芯片版本 v1.0 中修复。
Note
软件不可以使用 AHB 地址读 FIFO。
[TWAI-3.13.11] 若 RX FIFO 溢出超 64 个报文(含 64),RX FIFO 将不可恢复
描述
如果 RX FIFO 溢出多个报文,且 RX 报文计数器达到 64,RX FIFO 将不可恢复。从 RX FIFO 读取的任何报文均无效,且无法从 RX FIFO 中释放任何报文。
变通方法
TWAI 控制器必须通过软件复位才能恢复 RX FIFO。
解决方案
此问题在 ESP-IDF v4.3 及以后版本中已自动绕过。
[CPU-3.16] CPU 访问 0x3FF0_0000 ~ 0x3FF1_EFFF 与 0x3FF4_0000 ~ 0x3FF7_FFFF 两段地址空间存在限制
描述
落在这两段地址空间的 CPU 读操作具有推测性,推测性读操作会导致程序描述的行为与硬件的真实行为不一致。
如果两个 CPU 同时连续访问 0x3FF0_0000 ~ 0x3FF1_EFFF 地址空间的内容,其中的一些访问可能丢失。
CPU 通过 0x3FF4_0000 ~ 0x3FF7_0000 地址空间读 FIFO 时,FIFO 的读指针会被延时更新。CPU 频率升高后,CPU 发起的两次连续读 FIFO 时间间隔缩短。当新的读 FIFO 请求到来时,FIFO 读指针还没有更新,这会导致 CPU 读到前一次读 FIFO 的值。
变通方法
落在这两段地址空间的 CPU 访问均需要在对应的操作前加入 “MEMW” 指令。即在 C/C++ 中,软件访问这两段地址内的寄存器时需要加上 “volatile” 属性。
当 CPU 频率为 160 MHz 时,在两次连续读 FIFO 之间添加 6 个 “nop” 指令。CPU 频率为 240 MHz 时,在两次连续读 FIFO 之间添加 7 个 “nop” 指令。
解决方案
暂无 修复计划。
[CPU-3.18] CPU 访问不同版本芯片的外设寄存器存在限制
描述
由于 [CPU-3.3] CPU 访问外设时,如果连续不间断地写同一个地址,会出现数据丢失的现象、[CPU-3.10] 双核 CPU 在读不同地址空间时可能会发生错误 和 [CPU-3.16] CPU 访问 0x3FF0_0000 ~ 0x3FF1_EFFF 与 0x3FF4_0000 ~ 0x3FF7_FFFF 两段地址空间存在限制 章节描述的原因,在不同芯片版本中,CPU 使用 0x3FF0_0000 ~ 0x3FF1_EFFF、0x3FF4_0000 ~ 0x3FF7_FFFF 和 0x6000_0000 ~ 0x6003_FFFF 地址访问外设寄存器时需注意:
地址空间(总线) |
寄存器类型 |
操作 |
芯片版本 |
||||
|---|---|---|---|---|---|---|---|
v0.0 |
v1.0 |
v1.1 |
v3.0 |
v3.1 |
|||
0x3FF0_0000 ~ 0x3FF1_EFFF 和 0x3FF4_0000 ~ 0x3FF7_FFFF (DPORT) |
Non- FIFO |
写 |
Yes |
Yes |
|||
读 |
Yes |
||||||
FIFO |
写 |
Yes |
|||||
读 |
Yes |
Yes |
|||||
0x6000_0000 ~ 0x6003_FFFF (AHB) |
Non- FIFO |
写 |
Yes |
||||
读 |
Yes |
||||||
FIFO |
写 |
Yes |
|||||
读 |
No (无此功能,无法预知结果) |
||||||
Note
Yes: 操作正确执行
No: 操作失败
[RES-3.8] 由于 flash 启动的速度慢于芯⽚读取 flash 的速度,芯片上电或 Deep-sleep 醒来后,会随机发生一次看门狗复位
描述
如果 ESP32 在 flash 可读之前就进行读取,则无效数据会使启动失败,这时会发生看门狗复位。如果 ESP32 VDD_SDIO 用作 flash 电源,则芯片上电和 Deep-sleep 醒来时都可能发生看门狗复位。
变通方法
更换更快的 flash,要求 flash 上电到可读的时间小于 800 μs。这种方法可以绕过芯片上电和 Deep-sleep 醒来时的看门狗复位。
Deep-sleep 醒来后的看门狗复位问题在 ESP-IDF v2.0 及更高版本中自动绕过(延迟时间可以根据需要配置)。具体方式是从 Deep-sleep 醒来后首先读取 RTC fast memory 中的指令,等待一段时间,然后再读取 flash。
解决方案
已在芯片版本 v3.0 中修复。
[WDT-3.15] ESP32 芯片特定条件下会出现 live lock 导致中断看门狗错误
描述
使用芯片版本 v3.0,当程序同时满足下列条件时,会出现 live lock(活锁)现象,导致 CPU 一直处于访存状态,不能继续执行指令。
双核系统;
四条访问外存的指令/数据总线 (IBUS/DBUS) 中,有 3 条总线同时发起对同一个 cache 组的访问请求,并且三个 cache 请求均缺失。
变通方法
发生 live lock 时,软件主动或被动识别并解锁 cache line 竞争,之后两个核按队列节拍分时完成各自的 cache 操作,解锁 live lock。详细过程如下:
当两个核执行的指令均不在代码临界区中时出现 live lock,系统各类型中断会主动解除 cache line 竞争,解锁 live lock;
当两个核执行的指令位于代码临界区中时出现 live lock,在临界区中,系统会屏蔽 3 级及以下中断。因此软件预先为两个核各设置一个高优先级(4 级或 5 级)中断,将它们绑定到同一个定时器,并选择合适的定时器超时门限。由于 live lock 产生的定时器超时中断会迫使两个核均进入高优先级中断处理程序,从而释放两个核的 IBUS 以达到解锁 live lock 目的。解锁过程通过 3 个阶段完成:
第 1 阶段两个核均进行等待以清空 CPU write buffer;
第 2 阶段一个核 (Core 0) 等待,另一个核 (Core 1) 执行;
第 3 阶段 Core 1 等待,Core 0 执行。
解决方案
暂无 修复计划。
[CPU-3.10] 双核 CPU 在读不同地址空间时可能会发生错误
描述
双核情况下,一个 CPU 的总线在读 A (0x3FF0_0000 ~ 0x3FF1_EFFF) 地址空间,而另一个 CPU 的总线在读 B (0x3FF4_0000 ~ 0x3FF7_FFFF) 地址空间,读 B 地址空间的 CPU 可能会发生错误。
变通方法
以下两种方法都可以使用:
一个 CPU 在读 A 地址空间时,通过加锁和中断的方式来避免另一个 CPU 发起对 B 地址空间的读操作。
一个 CPU 在读 A 地址空间之前,加一个此 CPU 读 B 地址空间(非 FIFO 地址空间,如 0x3FF40078)操作,并且要保证读 B 地址空间操作和读 A 地址空间操作是原子的。
解决方案
已在芯片版本 v3.0 中修复。
[CPU-3.9] CPU 在访问外部 SRAM 时会小概率发生读写错误
描述
CPU 在执行下面汇编指令访问外部 SRAM 时会小概率发生错误:
store.x at0, as0, n
load.y at1, as1, m
其中 store.x 表示 x 位写操作,load.y 表示 y 位读操作,且 as0+n 和 as1+m 访问的外部 SRAM 的地址相同。
指令可以是连续的,也可以包含在同一个流水线中(少于 4 个中间指令,并且没有流水线刷新)。
x >= y 时,写数据会丢失。(注意:当 load 和 store 都是 32-bit 值时,写数据只有在第一个和第二个指令之间发生中断时才发生。)
x < y 时,写数据会丢失,且读数据错误。
变通方法
当外部 SRAM 在 ESP-IDF v3.0 及更高版本中启用时,此问题自动绕过。
x >= y 时,在
store.x和load.y之间插入 4 个 nop 指令。x < y 时,在
store.x和load.y之间插入 memw 指令。
解决方案
已在芯片版本 v3.0 中修复。
[TWAI-3.13.10] |e| > SJW (N) 的负相位误差,将使之后发送的位数据左移
描述
当 TWAI 控制器遇到具有负相位误差的隐性至显性沿(即较早采样)时,将按照 CAN2.0B 协议要求利用再同步来校正相位误差。但是,如果 TWAI 控制器作为发送器并且遇到 e < 0 及 |e| > SJW 的负相位误差,则在相位误差之后发送的位信息将左移一位,导致后续发送的帧内容(即,DLC,数据字节,CRC 序列)被破坏。
变通方法
无
解决方案
暂无 修复计划。
[LEDC-3.12] LEDC 递减渐变,duty 值溢出错误
描述
在配置 LEDC 为递减渐变且 LEDC_DUTY_SCALE_HSCHn 为 1 的情况下,当 duty 值为 2LEDC_HSTIMERx_DUTY_RES 时,下一次 duty 变化应该为 2LEDC_HSTIMERx_DUTY_RES – 1,但是实际上 duty 值等于 2LEDC_HSTIMERx_DUTY_RES+1,即出现 duty 值溢出的错误。(HSCHn 代表高速通道,n 为 0-7;HSTIMERx 代表高速定时器,x 为 0-3。)
对于低速通道,存在同样的问题。
变通方法
使用 LEDC 的过程中,应避免以下三个条件同时成立:
LEDC 启动递减渐变功能;
LEDC 渐变过程中 scale 寄存器设置为 1;
LEDC 递减渐变开始时刻或者过程中的某一时刻,duty 值为 2LEDC_HSTIMERx_DUTY_RES 或 2LEDC_LSTIMERx_DUTY_RES。
解决方案
此问题在 ESP-IDF commit ID 为 b2e264e 及以后版本的 LEDC 驱动中已自动绕过,并于 ESP-IDF v3.1 中发布。
[RES-3.1] 芯片上电或 Deep-sleep 醒来后,会随机发生一次看门狗复位
描述
芯片上电或 Deep-sleep 醒来后,会随机发生一次看门狗复位。
变通方法
Deep-sleep 醒来后,CPU 可以立即执行 RTC fast memory 中的一段程序。RTC fast memory 中的这段程序通过清除 cache MMU 的非法访问标志从而绕过 Deep-sleep 醒来后的看门狗复位,具体为:
将 DPORT_PRO_CACHE_CTRL1_REG 寄存器的 PRO_CACHE_MMU_IA_CLR 比特置 1。
将该比特清零。
芯片上电的看门狗复位无法使用软件绕过,但复位后 ESP32 正常启动。
解决方案
已在芯片版本 v1.0 中修复。
[CPU-3.2] CPU 使用 cache 访问外部 SRAM 时,特定条件下会发生读写错误
描述
CPU 使用 cache 访问外部 SRAM 时,特定条件下会发生读写错误。
变通方法
对于芯片版本 v0.0,CPU 使用 cache 访问外部 SRAM 时,只能够进行单向操作,即只能够单纯地进行写 SRAM 操作,或者单纯地进行读 SRAM 操作,不能交替操作。
使用 MEMW 指令:在读操作之后,加上 __asm__(“MEMW”) 指令,然后在 CPU 流水线被清空前再发起写操作。
解决方案
已在芯片版本 v1.0 中修复。