自v2.0以来的变化。

突破变化

版本v2.1旨在大大兼容为ESP-IDF v2.0编写的应用程序。但是，引入以下突破性变化：

• esp_bt_controller_init函数收到一个新的esp_bt_controller_config_t *参数。
• 如果应用程序采用双核支持构建，则使用正常寄存器访问宏访问DPORT寄存器将导致编译时错误（如果在编译时无法对寄存器地址进行评估，则会导致运行时错误）。必须更新应用程序以使用具有DPORT_前缀的注册访问宏。
• nvs_flash_init 函数现在可以返回错误代码，必须由应用程序检查（见NVS示例）。
• 通话后esp_ble_gatts_create_attr_tab，应用程序只能期望ESP_GATTS_CREAT_ATTR_TAB_EVT在GATTS回调中收到。ESP_GATTS_CREATE_EVT，ESP_GATTS_ADD_xxx_EVT现在不会收到。
  有关详细用法，请参阅gatt_server_service_table示例。

构建系统和工具

• 修复组件src subdirs在父源代码之前需要列出的错误
• 添加更清洁的方式来有条件地编译文件
• 显着减少Windows上的启动时间
• esptool：更新到v2.0最终版本
• gen_esp32part：修复应用程序偏移量错误，Python 3支持
• 新的'make monitor'idf_monitor工具，以便更好地监控输出。

引导程序

• 修复安全启动启用 - 可以验证引导加载程序映像
• 启用OTA中加密闪存的检查（＃453）
• 在Bootloader中启用SPI闪存Quad I / O：引导加载程序检查闪存ID，启用基于闪存类型的四进制I / O模式。

FreeRTOS的

Bug修复

• 以SMP模式修复以下API：
  • uxTaskGetSystemState
  • vTaskSuspend（）/ vTaskResume（）
• 始终禁用关键区域中的中断
• 当任务被删除时释放协处理器寄存器
• 从队列/任务API延迟上下文切换，直到退出临界区
• 修复CPU1的ISR堆栈空间的位置
• 修复跨核心事件组同步

其他变化

• 当应用程序以单核心模式运行时，断言在CPU1上启动新任务
• 使内部堆栈大小变量在32位而不是16位
• 将定时器任务堆栈大小增加到2048字节
• 添加最大任务长度名称配置
• 公开任务堆栈溢出观察点选项
• 使用先前为ROM例程/堆栈保留的更多区域作为堆，释放大约28K的RAM。
• 添加一个选项来配置IPC任务堆栈大小

SoC功能

• 介绍soc组件，添加rtc_clk和rtc_pm库的源文件
• 添加对32k XTAL作为RTC时钟源的支持
• 使用内部RTC时钟提高计时精度
• 改善XTAL频率检测，增加了在菜单中选择XTAL频率的支持
• 菜单中的默认CPU频率设置为160 MHz（以前为240 MHz）
• 在ESP32中添加DPORT访问错误的解决方法。访问DPORT寄存器时，应用程序必须使用具有DPORT_前缀的寄存器操作宏。
• 允许REG_SET_FIELD宏用于位字段
• 将soc / io_mux_reg.h更新为最新版本（＃349）

无线上网

新功能

• 添加smartconfig示例
• 支持静态WiFi TX缓冲区，通过menuconfig配置缓冲区的数量
• 支持主动/被动扫描配置停留时间（wifi_scan_config_t结构的新成员）
• 使用新的esp_wifi_ {get，set} _promiscuous_filter API支持混杂模式下的数据包过滤
• WPA2 Enterprise的wifi_auth_mode_t枚举的新成员
• 在wifi_sta_config_t中新建通道号设置，以快速连接到AP

Bug修复

• 在某些情况下，修复了WiFi兼容性问题，导致无法连接到某些AP，如TP-LINK 742N
• 修复导致OTA升级失败的错误
• 提高WPS连接成功率
• 修复ESP32未收到MIMO数据包的错误，并以混杂模式丢失了一些AMPDU加密数据包
• 修复长距离模式不工作的错误
• 修复了几个WiFi崩溃错误

其他变化

• 添加WiFi驱动程序的文档
• 将扫描的AP的SSID数组长度更改为33字节
• 在初始化WiFi之前，更新所有要调用nvs_flash_init的示例

BLE

• Gatt服务器通过属性表优化创建GATT服务

  • 删除每个服务的特征号码限制
  • 在创建或删除服务时修复内存泄漏
  • 在设置属性值时修复错误

• Gatt服务器通过堆栈优化自动响应

  • 添加prepare_write_request数据包的过程
  • 在处理读取blob请求，写入请求和读取请求的数据包时修复错误

• Gatt服务器一般优化

  • 添加GATT服务器的事件打开，取消打开和关闭

• Gatt客户端优化

  • 自动注册远程设备的GATT服务更改ccc描述符
  • 添加API来准备写描述符
  • 添加API以刷新服务发现结果的缓存，以启动新的服务发现过程

• GAP中心角色扫描模式优化

  • 修复在永久扫描模式下扫描的错误只有5分钟
  • 在扫描结果中添加广告数据长度和扫描响应长度

• GAP外设角色广告模式优化

  • 添加广告停止和扫描停止完成的事件
  • 修复有时广告被意外停止的错误

• 连接建立和断开API优化

  • 为GATT服务器和GATT客户端添加公共间隙断开API
  • 为GATT客户端添加连接事件和断开事件，以检测GATT服务器或GATT客户端回调函数中的连接状态

• GAP一般优化

  • 添加LE数据包长度设置完成事件
  • 添加连接参数更新请求完成事件
  • 修复主机无法获取远程设备功能的错误

• 新的SMP API

  • 添加不同配对方法的支持，包括MITM，安全连接等
  • 添加API以配置安全参数
  • 添加SMP安全性示例
  • 在安全模式下修复重新连接问题

• L2CAP和HCI优化

  • 修复了HCI包碎片错误
  • 增加了HCI UART的支持

• 内存优化

  • BT和BLE可以单独启用
  • 支持禁用GATT服务器，GATT客户端，SMP等，在menuconfig

• 从Bluedroid 7.1.1合并错误修复

• 智能手机兼容性优化

• BLE示例代码优化

• 加强堆栈中的错误检查和处理

• 提高数据包接收性能

• 在初始化BT之前，请更新所有调用nvs_flash_init的示例

经典BT

• 新的主机API

  • 添加API设置设备名称
  • 添加API以设置可发现性和可连接性模式

• 新档案

  • 添加A2DP接收器配置文件
  • 添加AVRCP控制器配置文件

• 控制器错误修复

  • 修复嗅觉模式中不一致状态处理的错误
  • 在使用HCI控制器来主机数据流控制时修复错误
  • 修正无效处理HCI命令的错误“HCI_Host_Number_of_Completed_Packets”
  • 修正了经典BT的ACL-U数据传输中的断言错误
  • 修复控制器RX / TX错误（在缓存中使用rand / srand，任务块，异常等）
  • 修复PHY初始化错误

• 蓝牙任务优先级优先

• Osi_alarm模块优化为线程安全

驱动程序

新功能

• 电机控制PWM（MCPWM）驱动程序和示例
• SPI从驱动程序和示例
• 在I2S驱动程序中支持PDM和内置DAC
• 支持LEDC驱动程序中的低速通道
• 添加ADC1示例
• 添加使用电容式触摸传感器的示例

Bug修复

• 对所有配置调用“const”进行参数（＃519）
• I2C驱动程序
  • 修复驱动程序在“RELEASE”配置中不工作（＃304）
  • 修复从属模式读取大小错误
  • 修复I2C主机初始化（＃393）上的尖峰
• I2S驱动程序：
  • 在i2s_set_clk函数中更改通道号时修正错误
  • 修复支持24位和32位样本
  • 同时修复TX / RX
• RMT驱动程序
  • 在RMT中添加config和tx数据的const限定符（＃495）
  • 修复rmt_set_tx_thr_intr_en（）：仅在启用路径中检查evt_thresh（＃492）
  • 解决一些关于中断的问题
• SPI主驱动程序：
  • 在示例中使用支持DMA的内存进行显示初始化（＃551）
  • 修复更高速SPI主总线所需的时序调整（＃363）
  • 为DMA问题添加解决方法
• 当不使用CD信号时，处理SD卡删除
• 在MMC_GO_IDLE_STATE命令之前，将初始化序列发送到SD卡
• 修复不可能检查uart_set_line_inverse（＃489）
• 当停止位设置为2位模式时，修复UART数据错误
• 优化触摸板读取功能，以减少旋转锁定所花费的时间

以太网络

• 添加LAN8720 phy支持，将PHY移动到组件（＃383）
• 允许单独的以太网和WiFi配置

ULP和深度睡眠

• 支持使用binutils汇编器生成ULP协处理器程序
• 添加ULP脉冲计数示例
• 添加ULP ADC示例
• 使用触摸传感器增加对深度睡眠唤醒的支持
• 而深睡眠的例子说明了各种唤醒模式

存储

新功能

• 在VFS中添加对嵌套安装点的支持
• 添加wear_levelling组件，它提供了一个类似于spi_flash接口的接口。在内部，它将数据存储在分区内，以减少任何给定扇区的最坏情况下的擦除周期数。
• 启用对多个FATFS驱动器的支持

Bug修复

• nvs：在写入前检查值大小，文档限制
• nvs：在页面级删除搜索缓存（＃365）
• nvs：改进初始化过程中的错误处理
• 修正PATH_MAX和ARG_MAX的不一致定义（＃289）
• fat / sdmmc：卸载FATFS对象错误

SPI闪存库

• 修复闪存中的大写，未对齐写和写
• 修正s_flash_op_complete访问中的竞争条件
• 将ROM SPI闪存驱动程序的某些部分移动到ESP-IDF中以修复Wait_SPI_Idle（）函数中的错误
• SPI闪存操作锁定更短的时间
• 在esp_partition API中修复分区迭代顺序
• 为Flash MMU重新配置时，添加解决方案以解决高级缓存读取问题

第三方图书馆

• 添加libsodium加密库组件（v1.0.12）
• 添加Amazon IoT SDK组件，再加上他们的Linux示例派生的两个示例。
• nghttp模块：更新到v1.22，使用子模块而不是树内源

LwIP的

• 修复DHCP服务器崩溃问题
• 将TCP TX窗口从2修改为4以保持RX / TX窗口的大小相同
• 通过串行驱动程序启用实验/不支持的PPP（＃272）
• 给AP和STA netifs不同的名称，以方便调试（＃456）
• 用互斥体实现LwIP关键会话
• 将最大打开的插槽数增加到32个

的mDNS

• 使用AFL Fuzzer进行分析器稳定性测试
• 添加简单的DNS-SD元查询支持（＃340）
• 修复MDNS的一系列安全问题（通过BBP报告）：
  • STACK-SMASH：sprintf不受限制，可以根据需要执行多次，允许将任意长数据写入堆栈。
  • PACKET-OF-DEATH：比较允许相等，从而跳回它自我无限递归 - >保证崩溃。
  • TXT-SMASH：循环没有检查到达 - > txt最大大小（1024），导致堆栈溢出。

mbedTLS

• 使用非阻塞插座修复EWOULDBLOCK / EAGAIN的检测（＃425，＃511）
• 当乘法运算符太大时，使用两个MPI乘法。通过硬件加密操作允许RSA4096。

调试功能

• 添加允许在主机和JTAG之间发送任意数据的apptrace模块
• 通过JTAG初始化执行printf样日志记录到主机
• 在任何WDT复位后，从traceport添加转储调试信息
• 增加无效访问中断时缓存无效访问检测和触发紧急处理程序
• 做核心转储到闪存时的额外的健康检查
• RWDT用于重启系统，以防紧急处理程序崩溃
• 提高核心转储脚本的鲁棒性

单元测试

• 修复单元测试应用程序中不正确的CR + LF序列
• 在所有组件目录中查找TEST_COMPONENTS（＃354）
• 修复单元测试应用程序以与测试文件中相同的顺序打印测试

文档

• 入门指南现在是ESP-IDF文档的一部分
• 自动生成API参考列表/ Doxygen指令
• 修改Windows安装程序安装脚本以修复各种问题，使用最新的工具链。
• 添加Espressif提供的dev板和模块的说明

杂

• 添加API以获取芯片信息
• 支持从EFUSE或特定于应用程序的存储加载自定义MAC地址
• 在ESP-IDF中支持集成闪存的ESP32-D2WD。
• 修复HTTP [S]请求示例（＃500）的问题
• 在示例中标准化文件，符号等的命名
• 修正发布版本中由ESP_ERROR_CHECK（变量）生成的警告（＃497）

获取v2.1

由于我们使用git子模块，附加到此版本的源文件将无法正常工作。改为使用以下方法之一：

使用git

要获取此版本，请使用以下命令：

git clone https://github.com/espressif/esp-idf.git esp-idf-v2.1
cd esp-idf-v2.1/
git checkout v2.1
git submodule update --init --recursive

这是获取ESP-IDF的v2.1的推荐方法。

下载包含子模块的存档

此版本附有esp-idf-v2.1.zip档案。它包括.git目录和所有子模块，所以可以开箱即用。此存档是为具有连接问题的用户提供的，从而阻止它们从Github克隆。