尧图网站建设 
arduino-esp32 官方库全景解析从 WiFi 网络栈到 OTA 升级的内置库选型与实践【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32本文以 arduino-esp32 仓库中的 libraries/README.md 为蓝本系统梳理该 ESP32 Arduino 核心所内置的全部官方库涵盖 WiFi/以太网通信、Web 服务、OTA 固件升级、文件系统、蓝牙与外设驱动等类别并结合同仓库的library.properties、头文件 API 与示例工程说明每个库的用途、关键接口与适用芯片限制帮助你在开发时快速选对库、写对代码。一、库的组织方式与版本约定arduino-esp32 把「Arduino 兼容性库」和「硬件对象封装库」统一放在 libraries/ 目录下每个库一个独立文件夹遵循 Arduino 标准库结构src/— 库的源码.h/.cpp/.c例如 libraries/WiFi/src/ 下包含WiFiGeneric.cpp、WiFiSTA.cpp、WiFiAP.cpp、WiFiMulti.cpp、WiFiScan.cpp等按功能拆分的模块examples/— 随库分发的示例工程.inoArduino IDE 安装该核心后即可在示例菜单中看到library.properties— 库的元数据名称、版本、作者、支持架构。从各库的library.properties可以看到全部内置库与核心保持同一版本号当前仓库内为 3.3.11且architectures基本都声明为esp32。例如 libraries/Preferences/library.properties 中namePreferences version3.3.11 authorHristo Gochkov architecturesesp32这种库随核心一起版本化的做法意味着库 API 的变更跟随核心大版本演进你不需要单独在库管理器里搜索ESP32 版的第三方同名库——内置库就是官方维护的 ESP32 兼容实现。另外README 中说明ESP32 还包含一批无需驱动即可使用的附加示例集中放在 libraries/ESP32/examples/ 中。文档列举了 AnalogOut、Camera、ChipID、DeepSleep、ESPNow、FreeRTOS、GPIO、HallSensor、I2S、MacAddress、ResetReason、RMT、Time、Timer、Touch 等主题从源码目录看当前仓库中该目录还包含了AnalogRead、AnalogReadContinuous、HWCDC_Events、TWAI、Serial等更多示例如 libraries/ESP32/examples/AnalogOut/ 下有LEDCFade、SigmaDelta等子工程可作为使用硬件外设时的第一手参考。二、网络与 Web 服务类库WiFiArduino 兼容的 Wi-Fi 驱动libraries/WiFi/ 是最基础的联网库提供 Arduino 风格的WiFi对象STA/AP 模式、扫描、企业级认证等。源码模块划分清晰文件职责WiFiGeneric.cpp通用接口localIP、RSSI、状态等WiFiSTA.cppSTA 站模式连接与重连WiFiAP.cppAP 热点模式WiFiMulti.cpp多 AP 依次尝试连接WiFiScan.cpp网络扫描含异步扫描libraries/WiFi/examples/ 提供 24 个示例从WiFiClientBasic、WiFiScan到WiFiSmartConfig、WiFiClientEnterprise企业级 802.1X 认证、WiFiScanDualAntenna双天线扫描适用于带外部 PA/LNA 的芯片等覆盖了绝大多数常见接入场景。ESPmDNS 与 DNSServer服务发现与 DNS 守护ESPmDNSlibraries/ESPmDNS/实现 mDNS 服务广播让设备以http://mydevice.local/这类主机名形式在局域网中被发现免去手动查 IP。示例 libraries/ESPmDNS/examples/mDNS_Web_Server/ 演示了 mDNS WebServer 的组合。DNSServerlibraries/DNSServer/一个基本的 UDP DNS 守护典型用途是门户页captive portal——接管 DNS 请求把浏览器重定向到本地页面。从 DNSServer.h 的 API 看核心方法为start()建立监听 socket默认端口 53也可用start(port, domainName, resolvedIP)指定与stop()并内置了门户页演示示例 libraries/DNSServer/examples/CaptivePortal/。WebServer 与 HTTPClient服务端与客户端的简单可靠方案WebServerlibraries/WebServer/一个简单 HTTP 守护。从 WebServer.h 的注释可以看到其设计约束同一时刻只支持一个客户端连接支持 GET/POST。API 上通过begin(port)启动、handleClient()轮询处理请求因此必须在loop()中反复调用路由用on(uri, fn)/on(uri, method, fn, uploadFn)注册还可以addHandler()挂载自定义RequestHandler、onFileUpload()处理文件上传、requestAuthentication()开启基本认证。示例多达 19 个包括FSBrowser、HttpBasicAuth、Middleware、UploadHugeFile等libraries/WebServer/examples/。HTTPClientlibraries/HTTPClient/简单的 HTTP 客户端明确兼容NetworkClientSecure即可同时用于普通 WiFi 与 TLS 加密连接是发 GET/POST 请求、上传下载的常用选择。其余网络库库说明源自 README结合仓库结构Ethernetlibraries/Ethernet/以太网联网配合 SPI 接口的网口芯片使用Networklibraries/Network/网络抽象层NetworkClient/NetworkServer/NetworkUdp是上层库如 ArduinoOTA与底层 WiFi/Ethernet 解耦的基础NetworkClientSecurelibraries/NetworkClientSecure/基于内嵌加密的 Arduino 兼容 Wi-Fi 安全客户端对象提供 TLS/WSS 能力PPPlibraries/PPP/点对点拨号链路支持AsyncUDPlibraries/AsyncUDP/异步、任务驱动的 UDP 数据报客户端/服务端作者 Me-No-Dev适合高频数据报场景三、OTA 固件升级链路Update ArduinoOTA HTTPUpdateREADME 把升级能力拆成了三个协作的库这条链路是整个内置库体系中最值得深挖的部分。Update直接操作 OTA 分区的底层库libraries/Update/ 直接基于 ESP32 的 OTA 功能执行擦除→写入→校验→激活。从 Update.h 可以看到两个关键设计升级目标常量U_*决定了数据写到哪里#define U_FLASH 0 /// Update target: Flash (OTA) #define U_SPIFFS 101 /// Update target: SPIFFS filesystem #define U_FATFS 102 /// Update target: FAT filesystem #define U_LITTLEFS 103 /// Update target: LittleFS filesystem细粒度错误码UPDATE_ERROR_*宏便于在回调中精确定位失败原因例如#define UPDATE_ERROR_WRITE (1) /// Write operation failed #define UPDATE_ERROR_ERASE (2) /// Erase operation failed #define UPDATE_ERROR_SPACE (4) /// Not enough space for update #define UPDATE_ERROR_MD5 (7) /// MD5 checksum mismatch #define UPDATE_ERROR_MAGIC_BYTE (8) /// Magic byte/header mismatch #define UPDATE_ERROR_ACTIVATE (9) /// Activation failed #define UPDATE_ERROR_SIGN (14) /// Signature verification failed此外头文件还定义了 AES 解密相关常量ENCRYPTED_KEY_SIZE、U_AES_DECRYPT_ON等对应仓库内Updater.cpp、Updater_Signing.cpp提供的加密/签名镜像升级能力——libraries/Update/examples/ 中的HTTP_Client_AES_OTA_Update、Signed_OTA_Update等示例正是这套能力的用法演示另有HTTPS_OTA_Update、AWS_S3_OTA_Update、OTAWebUpdater等 7 个示例覆盖不同取流方式。ArduinoOTA守护进程式的升级服务libraries/ArduinoOTA/ 是一个Over The Air 固件更新守护README 特别指出配合espota.py工具即可从电脑把固件推送到设备上无需接线。核心用法可参考官方示例 libraries/ArduinoOTA/examples/BasicOTA/BasicOTA.ino#include WiFi.h #include ESPmDNS.h #include NetworkUdp.h #include ArduinoOTA.h void setup() { WiFi.mode(WIFI_STA); WiFi.begin(ssid, password); while (WiFi.waitForConnectResult() ! WL_CONNECTED) { /* 重连/重启 */ } // 端口默认 3232 - ArduinoOTA.setPort(3232); // 主机名默认 esp3232-[MAC] - ArduinoOTA.setHostname(myesp32); // 明文密码内部以 PBKDF2-HMAC-SHA256、10000 次迭代做哈希 // - ArduinoOTA.setPassword(admin); // 或使用预哈希值SHA256(admin) // - ArduinoOTA.setPasswordHash(8c6976...); ArduinoOTA .onStart([]() { // ArduinoOTA.getCommand() 为 U_FLASH 时升级 sketch否则升级文件系统 }) .onEnd([]() { Serial.println(\nEnd); }) .onProgress([](unsigned int progress, unsigned int total) { /* 打印进度 */ }) .onError([](ota_error_t error) { /* 区分认证/开始/连接/接收/结束错误 */ }); ArduinoOTA.begin(); } void loop() { ArduinoOTA.handle(); // 必须循环调用以处理 UDP 升级数据 }示例注释里给出了两个实用细节认证采用 PBKDF2-HMAC-SHA25610000 次迭代getCommand()返回U_FLASH表示升级的是 sketch 本身返回U_SPIFFS表示升级文件系统此时应在 onStart 中先SPIFFS.end()卸载。推送侧则使用仓库自带的 tools/espota.pyTransmit image over the air to the ESP32 module with OTA support它扫描局域网中的 OTA 设备、按设备名/主机名匹配后上传 .bin。该库还提供SignedOTA示例演示带签名校验的升级。HTTPUpdate / HTTPUpdateServerHTTP 生态的补充HTTPUpdatelibraries/HTTPUpdate/从 HTTP(S) 地址下载固件镜像复用Update应用——适合把新固件放在自己的 Web 服务或对象存储上拉取升级HTTPUpdateServerlibraries/HTTPUpdateServer/反向操作在设备本地起一个上传页面用浏览器把固件上传给设备再升级——两者互补分别对应拉和推两种 HTTP 升级模式。四、存储类库FS 框架与多种文件系统FS文件系统虚拟化框架libraries/FS/ 是 README 中定义的Filesystem virtualization framework。它的价值在于把 SPIFFS、LittleFS、FFat 等具体实现抽象成统一的FS接口File/FS类型让上层代码如 WebServer 的serveStatic、SPIFFS 浏览器示例无需关心底层到底是哪种文件系统切换存储格式时改动最小。各文件系统一览库说明备注SPIFFSlibraries/SPIFFS/SPI Flash 文件系统README 提示需用 spiffs-plugin 把数据上传到设备示例 libraries/SPIFFS/examples/ 含SPIFFS_Test、SPIFFS_timeLittleFSlibraries/LittleFS/LittleFS 文件系统日志结构断电一致性更好常用于替代 SPIFFS 的持久化场景FFatlibraries/FFat/SPI Flash 上的 FAT 索引文件系统需要分区表中配置 FAT 分区SDlibraries/SD/通过 SPI 访问的 SD 卡文件系统Arduino 经典SD兼容 APISD_MMClibraries/SD_MMC/通过 4 线 MMC 总线访问 SD 卡相比 SPI 速率更高用于 S3 等带专用 MMC 总线的芯片EEPROM 与 Preferences键值持久化EEPROMlibraries/EEPROM/Arduino 兼容的 EEPROM 模拟底层落在 flash源码见 libraries/EEPROM/src/EEPROM.cpp。适合从 AVR 项目迁移、习惯按字节地址读写的代码。Preferenceslibraries/Preferences/README 定义其为基于 ESP32 NVS 的 Flash 键值存储。从 Preferences.h 看API 设计非常完整bool begin(const char *name, bool readOnly false, const char *partition_label NULL); size_t putUInt(const char *key, uint32_t value); uint32_t getUInt(const char *key, uint32_t defaultValue 0); // 另有 putChar/putShort/putInt/putLong64/putFloat/putString/putBytes... bool isKey(const char *key); PreferenceType getType(const char *key); // 类型安全PT_U8/PT_I16/PT_STR/PT_BLOB... bool clear(); bool remove(const char *key);官方示例 libraries/Preferences/examples/StartCounter/StartCounter.ino 演示了开机计数的完整模式Preferences preferences; // 命名空间限 15 字符防止不同模块 key 冲突false 读写模式 preferences.begin(my-app, false); unsigned int counter preferences.getUInt(counter, 0); // key 同样限 15 字符 counter; preferences.putUInt(counter, counter); preferences.end();注意两个由示例注释明确的约束命名空间名与 key 名均限制在 15 字符NVS 的字段长度上限每个模块应使用独立命名空间避免键名冲突。另有Prefs2Struct示例演示结构体批量存取。五、蓝牙类库BLE、BluetoothSerial 与 SimpleBLE三者定位差异很大选型时要特别注意芯片能力BLElibraries/BLE/README 描述为Bluetooth Low Energy v4.2 客户端/服务端框架是功能最全的 BLE 库。library.properties 中列出的头文件包括BLEDevice.h、BLEUtils.h、BLEScan.h、BLEAdvertisedDevice.hsrc/下按角色拆分为 Central/Peripheral/Server/Client/Scanner/Adaptor 等 30 对源文件examples/提供 22 个示例扫描、广播、特征值读写、HID 等。BluetoothSeriallibraries/BluetoothSerial/蓝牙经典SPP串口重定向服务器。README 中明确警告它依赖 Bluetooth Classic仅原版 ESP32 可用——ESP32-S2、ESP32-C3、ESP32-S3 均不支持BluetoothSerial isnot availablefor ESP32-S2, ESP32-C3, ESP32-S3。这是移植代码到 S3 等平台时最容易踩的坑。SimpleBLElibraries/SimpleBLE/极简 BLE 广播器从 SimpleBLE.h 看核心就是begin()/send()/stop()几个方法用于只需向外广播数据的轻量场景不承载完整 GATT 交互。六、硬件外设与工具类库SPIlibraries/SPI/Arduino 兼容的 SPI 驱动README 特别注明master only仅主机模式。源码 libraries/SPI/src/SPI.cpp 与 HAL 层 cores/esp32/esp32-hal-spi.c 对应。Wirelibraries/Wire/Arduino 兼容 I2C 驱动对应 HAL 实现 cores/esp32/esp32-hal-i2c.c。Tickerlibraries/Ticker/按固定间隔回调函数的计时器源码见 libraries/Ticker/src/Ticker.cpp适合比delay更适合的周期性任务。Consolelibraries/Console/、Hashlibraries/Hash/等前者提供可重定向的多路控制台输出后者提供 MD5/SHA 校验和计算。ESP_I2Slibraries/ESP_I2S/、ESP_Videolibraries/ESP_Video/针对 I2S 音频与视频接口的硬件封装。七、平台与云生态类库除传统外设/网络库外libraries/目录当前还包含一批面向 Espressif 平台生态的库部分在 README 中列名略有出入以仓库实际目录为准ESP RainMakerlibraries/RainMaker/README 称之为Espressif 的端到端平台让 Makers 更快实现 IoT 想法实现设备端接入 RainMaker 云的控制/配网逻辑Matterlibraries/Matter/、OpenThreadlibraries/OpenThread/、Zigbeelibraries/Zigbee/分别对应 Matter 智能家居标准、Thread 低功耗 Mesh 组网与 Zigbee 协议examples/中各有 30 个成套示例如 libraries/Zigbee/examples/ 含 31 个场景工程ESP_NOWlibraries/ESP_NOW/点对点直连通信README 在ESP32 附加示例条目下提到 ESPNow 主题ESP_SRlibraries/ESP_SR/README 明确其用途是帮助开发者基于ESP32-S3 或 ESP32-P4芯片构建 AI 语音方案语音唤醒、离线识别等芯片可用性在此受限Insightslibraries/Insights/远程日志与遥测采集配合 Insights 平台使用WiFiProvlibraries/WiFiProv/、ESP_HostedOTAlibraries/ESP_HostedOTA/配网与 Hosted 设备的 OTA 支持。八、选型速查与适用性提醒基于 README 与仓库实际代码几条关键结论芯片适用性以库文档为准BluetoothSerial 仅原版 ESP32ESP_SR 限 S3/P4SD_MMC 依赖 4 线 MMC 总线。选型前先核对目标芯片。网络栈分层清晰底层WiFi/Ethernet→ 抽象层Network/NetworkClientSecure→ 应用层WebServer/HTTPClient/AsyncUDP/ESPmDNS。跨传输介质WiFi 或以太网的代码优先基于Network抽象编写。升级链路按推/拉选择命令行推送用ArduinoOTA tools/espota.pyWeb 上传用HTTPUpdateServer服务器拉取用HTTPUpdate一切最终落到Update库的U_FLASH/U_LITTLEFS等目标与UPDATE_ERROR_*错误码体系上。持久化优先 PreferencesNVS 键值接口比模拟 EEPROM 更适合结构化配置注意命名空间与 key 的 15 字符上限StartCounter 示例注释。库版本随核心统一内置库版本与核心版本一致当前 3.3.11升级核心时库一并更新API 兼容性以当前仓库的library.properties与头文件注释为准。所有库的完整清单及其一句话定位可随时回查 libraries/README.md某个库的具体用法则以该库examples/下的.ino示例与src/头文件注释为最终依据。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 arduino-esp32 官方库全景解析：从 WiFi 网络栈到 OTA 升级的内置库选型与实践
arduino-esp32 官方库全景解析从 WiFi 网络栈到 OTA 升级的内置库选型与实践【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32本文以 arduino-esp32 仓库中的 libraries/README.md 为蓝本系统梳理该 ESP32 Arduino 核心所内置的全部官方库涵盖 WiFi/以太网通信、Web 服务、OTA 固件升级、文件系统、蓝牙与外设驱动等类别并结合同仓库的library.properties、头文件 API 与示例工程说明每个库的用途、关键接口与适用芯片限制帮助你在开发时快速选对库、写对代码。一、库的组织方式与版本约定arduino-esp32 把「Arduino 兼容性库」和「硬件对象封装库」统一放在 libraries/ 目录下每个库一个独立文件夹遵循 Arduino 标准库结构src/— 库的源码.h/.cpp/.c例如 libraries/WiFi/src/ 下包含WiFiGeneric.cpp、WiFiSTA.cpp、WiFiAP.cpp、WiFiMulti.cpp、WiFiScan.cpp等按功能拆分的模块examples/— 随库分发的示例工程.inoArduino IDE 安装该核心后即可在示例菜单中看到library.properties— 库的元数据名称、版本、作者、支持架构。从各库的library.properties可以看到全部内置库与核心保持同一版本号当前仓库内为 3.3.11且architectures基本都声明为esp32。例如 libraries/Preferences/library.properties 中namePreferences version3.3.11 authorHristo Gochkov architecturesesp32这种库随核心一起版本化的做法意味着库 API 的变更跟随核心大版本演进你不需要单独在库管理器里搜索ESP32 版的第三方同名库——内置库就是官方维护的 ESP32 兼容实现。另外README 中说明ESP32 还包含一批无需驱动即可使用的附加示例集中放在 libraries/ESP32/examples/ 中。文档列举了 AnalogOut、Camera、ChipID、DeepSleep、ESPNow、FreeRTOS、GPIO、HallSensor、I2S、MacAddress、ResetReason、RMT、Time、Timer、Touch 等主题从源码目录看当前仓库中该目录还包含了AnalogRead、AnalogReadContinuous、HWCDC_Events、TWAI、Serial等更多示例如 libraries/ESP32/examples/AnalogOut/ 下有LEDCFade、SigmaDelta等子工程可作为使用硬件外设时的第一手参考。二、网络与 Web 服务类库WiFiArduino 兼容的 Wi-Fi 驱动libraries/WiFi/ 是最基础的联网库提供 Arduino 风格的WiFi对象STA/AP 模式、扫描、企业级认证等。源码模块划分清晰文件职责WiFiGeneric.cpp通用接口localIP、RSSI、状态等WiFiSTA.cppSTA 站模式连接与重连WiFiAP.cppAP 热点模式WiFiMulti.cpp多 AP 依次尝试连接WiFiScan.cpp网络扫描含异步扫描libraries/WiFi/examples/ 提供 24 个示例从WiFiClientBasic、WiFiScan到WiFiSmartConfig、WiFiClientEnterprise企业级 802.1X 认证、WiFiScanDualAntenna双天线扫描适用于带外部 PA/LNA 的芯片等覆盖了绝大多数常见接入场景。ESPmDNS 与 DNSServer服务发现与 DNS 守护ESPmDNSlibraries/ESPmDNS/实现 mDNS 服务广播让设备以http://mydevice.local/这类主机名形式在局域网中被发现免去手动查 IP。示例 libraries/ESPmDNS/examples/mDNS_Web_Server/ 演示了 mDNS WebServer 的组合。DNSServerlibraries/DNSServer/一个基本的 UDP DNS 守护典型用途是门户页captive portal——接管 DNS 请求把浏览器重定向到本地页面。从 DNSServer.h 的 API 看核心方法为start()建立监听 socket默认端口 53也可用start(port, domainName, resolvedIP)指定与stop()并内置了门户页演示示例 libraries/DNSServer/examples/CaptivePortal/。WebServer 与 HTTPClient服务端与客户端的简单可靠方案WebServerlibraries/WebServer/一个简单 HTTP 守护。从 WebServer.h 的注释可以看到其设计约束同一时刻只支持一个客户端连接支持 GET/POST。API 上通过begin(port)启动、handleClient()轮询处理请求因此必须在loop()中反复调用路由用on(uri, fn)/on(uri, method, fn, uploadFn)注册还可以addHandler()挂载自定义RequestHandler、onFileUpload()处理文件上传、requestAuthentication()开启基本认证。示例多达 19 个包括FSBrowser、HttpBasicAuth、Middleware、UploadHugeFile等libraries/WebServer/examples/。HTTPClientlibraries/HTTPClient/简单的 HTTP 客户端明确兼容NetworkClientSecure即可同时用于普通 WiFi 与 TLS 加密连接是发 GET/POST 请求、上传下载的常用选择。其余网络库库说明源自 README结合仓库结构Ethernetlibraries/Ethernet/以太网联网配合 SPI 接口的网口芯片使用Networklibraries/Network/网络抽象层NetworkClient/NetworkServer/NetworkUdp是上层库如 ArduinoOTA与底层 WiFi/Ethernet 解耦的基础NetworkClientSecurelibraries/NetworkClientSecure/基于内嵌加密的 Arduino 兼容 Wi-Fi 安全客户端对象提供 TLS/WSS 能力PPPlibraries/PPP/点对点拨号链路支持AsyncUDPlibraries/AsyncUDP/异步、任务驱动的 UDP 数据报客户端/服务端作者 Me-No-Dev适合高频数据报场景三、OTA 固件升级链路Update ArduinoOTA HTTPUpdateREADME 把升级能力拆成了三个协作的库这条链路是整个内置库体系中最值得深挖的部分。Update直接操作 OTA 分区的底层库libraries/Update/ 直接基于 ESP32 的 OTA 功能执行擦除→写入→校验→激活。从 Update.h 可以看到两个关键设计升级目标常量U_*决定了数据写到哪里#define U_FLASH 0 /// Update target: Flash (OTA) #define U_SPIFFS 101 /// Update target: SPIFFS filesystem #define U_FATFS 102 /// Update target: FAT filesystem #define U_LITTLEFS 103 /// Update target: LittleFS filesystem细粒度错误码UPDATE_ERROR_*宏便于在回调中精确定位失败原因例如#define UPDATE_ERROR_WRITE (1) /// Write operation failed #define UPDATE_ERROR_ERASE (2) /// Erase operation failed #define UPDATE_ERROR_SPACE (4) /// Not enough space for update #define UPDATE_ERROR_MD5 (7) /// MD5 checksum mismatch #define UPDATE_ERROR_MAGIC_BYTE (8) /// Magic byte/header mismatch #define UPDATE_ERROR_ACTIVATE (9) /// Activation failed #define UPDATE_ERROR_SIGN (14) /// Signature verification failed此外头文件还定义了 AES 解密相关常量ENCRYPTED_KEY_SIZE、U_AES_DECRYPT_ON等对应仓库内Updater.cpp、Updater_Signing.cpp提供的加密/签名镜像升级能力——libraries/Update/examples/ 中的HTTP_Client_AES_OTA_Update、Signed_OTA_Update等示例正是这套能力的用法演示另有HTTPS_OTA_Update、AWS_S3_OTA_Update、OTAWebUpdater等 7 个示例覆盖不同取流方式。ArduinoOTA守护进程式的升级服务libraries/ArduinoOTA/ 是一个Over The Air 固件更新守护README 特别指出配合espota.py工具即可从电脑把固件推送到设备上无需接线。核心用法可参考官方示例 libraries/ArduinoOTA/examples/BasicOTA/BasicOTA.ino#include WiFi.h #include ESPmDNS.h #include NetworkUdp.h #include ArduinoOTA.h void setup() { WiFi.mode(WIFI_STA); WiFi.begin(ssid, password); while (WiFi.waitForConnectResult() ! WL_CONNECTED) { /* 重连/重启 */ } // 端口默认 3232 - ArduinoOTA.setPort(3232); // 主机名默认 esp3232-[MAC] - ArduinoOTA.setHostname(myesp32); // 明文密码内部以 PBKDF2-HMAC-SHA256、10000 次迭代做哈希 // - ArduinoOTA.setPassword(admin); // 或使用预哈希值SHA256(admin) // - ArduinoOTA.setPasswordHash(8c6976...); ArduinoOTA .onStart([]() { // ArduinoOTA.getCommand() 为 U_FLASH 时升级 sketch否则升级文件系统 }) .onEnd([]() { Serial.println(\nEnd); }) .onProgress([](unsigned int progress, unsigned int total) { /* 打印进度 */ }) .onError([](ota_error_t error) { /* 区分认证/开始/连接/接收/结束错误 */ }); ArduinoOTA.begin(); } void loop() { ArduinoOTA.handle(); // 必须循环调用以处理 UDP 升级数据 }示例注释里给出了两个实用细节认证采用 PBKDF2-HMAC-SHA25610000 次迭代getCommand()返回U_FLASH表示升级的是 sketch 本身返回U_SPIFFS表示升级文件系统此时应在 onStart 中先SPIFFS.end()卸载。推送侧则使用仓库自带的 tools/espota.pyTransmit image over the air to the ESP32 module with OTA support它扫描局域网中的 OTA 设备、按设备名/主机名匹配后上传 .bin。该库还提供SignedOTA示例演示带签名校验的升级。HTTPUpdate / HTTPUpdateServerHTTP 生态的补充HTTPUpdatelibraries/HTTPUpdate/从 HTTP(S) 地址下载固件镜像复用Update应用——适合把新固件放在自己的 Web 服务或对象存储上拉取升级HTTPUpdateServerlibraries/HTTPUpdateServer/反向操作在设备本地起一个上传页面用浏览器把固件上传给设备再升级——两者互补分别对应拉和推两种 HTTP 升级模式。四、存储类库FS 框架与多种文件系统FS文件系统虚拟化框架libraries/FS/ 是 README 中定义的Filesystem virtualization framework。它的价值在于把 SPIFFS、LittleFS、FFat 等具体实现抽象成统一的FS接口File/FS类型让上层代码如 WebServer 的serveStatic、SPIFFS 浏览器示例无需关心底层到底是哪种文件系统切换存储格式时改动最小。各文件系统一览库说明备注SPIFFSlibraries/SPIFFS/SPI Flash 文件系统README 提示需用 spiffs-plugin 把数据上传到设备示例 libraries/SPIFFS/examples/ 含SPIFFS_Test、SPIFFS_timeLittleFSlibraries/LittleFS/LittleFS 文件系统日志结构断电一致性更好常用于替代 SPIFFS 的持久化场景FFatlibraries/FFat/SPI Flash 上的 FAT 索引文件系统需要分区表中配置 FAT 分区SDlibraries/SD/通过 SPI 访问的 SD 卡文件系统Arduino 经典SD兼容 APISD_MMClibraries/SD_MMC/通过 4 线 MMC 总线访问 SD 卡相比 SPI 速率更高用于 S3 等带专用 MMC 总线的芯片EEPROM 与 Preferences键值持久化EEPROMlibraries/EEPROM/Arduino 兼容的 EEPROM 模拟底层落在 flash源码见 libraries/EEPROM/src/EEPROM.cpp。适合从 AVR 项目迁移、习惯按字节地址读写的代码。Preferenceslibraries/Preferences/README 定义其为基于 ESP32 NVS 的 Flash 键值存储。从 Preferences.h 看API 设计非常完整bool begin(const char *name, bool readOnly false, const char *partition_label NULL); size_t putUInt(const char *key, uint32_t value); uint32_t getUInt(const char *key, uint32_t defaultValue 0); // 另有 putChar/putShort/putInt/putLong64/putFloat/putString/putBytes... bool isKey(const char *key); PreferenceType getType(const char *key); // 类型安全PT_U8/PT_I16/PT_STR/PT_BLOB... bool clear(); bool remove(const char *key);官方示例 libraries/Preferences/examples/StartCounter/StartCounter.ino 演示了开机计数的完整模式Preferences preferences; // 命名空间限 15 字符防止不同模块 key 冲突false 读写模式 preferences.begin(my-app, false); unsigned int counter preferences.getUInt(counter, 0); // key 同样限 15 字符 counter; preferences.putUInt(counter, counter); preferences.end();注意两个由示例注释明确的约束命名空间名与 key 名均限制在 15 字符NVS 的字段长度上限每个模块应使用独立命名空间避免键名冲突。另有Prefs2Struct示例演示结构体批量存取。五、蓝牙类库BLE、BluetoothSerial 与 SimpleBLE三者定位差异很大选型时要特别注意芯片能力BLElibraries/BLE/README 描述为Bluetooth Low Energy v4.2 客户端/服务端框架是功能最全的 BLE 库。library.properties 中列出的头文件包括BLEDevice.h、BLEUtils.h、BLEScan.h、BLEAdvertisedDevice.hsrc/下按角色拆分为 Central/Peripheral/Server/Client/Scanner/Adaptor 等 30 对源文件examples/提供 22 个示例扫描、广播、特征值读写、HID 等。BluetoothSeriallibraries/BluetoothSerial/蓝牙经典SPP串口重定向服务器。README 中明确警告它依赖 Bluetooth Classic仅原版 ESP32 可用——ESP32-S2、ESP32-C3、ESP32-S3 均不支持BluetoothSerial isnot availablefor ESP32-S2, ESP32-C3, ESP32-S3。这是移植代码到 S3 等平台时最容易踩的坑。SimpleBLElibraries/SimpleBLE/极简 BLE 广播器从 SimpleBLE.h 看核心就是begin()/send()/stop()几个方法用于只需向外广播数据的轻量场景不承载完整 GATT 交互。六、硬件外设与工具类库SPIlibraries/SPI/Arduino 兼容的 SPI 驱动README 特别注明master only仅主机模式。源码 libraries/SPI/src/SPI.cpp 与 HAL 层 cores/esp32/esp32-hal-spi.c 对应。Wirelibraries/Wire/Arduino 兼容 I2C 驱动对应 HAL 实现 cores/esp32/esp32-hal-i2c.c。Tickerlibraries/Ticker/按固定间隔回调函数的计时器源码见 libraries/Ticker/src/Ticker.cpp适合比delay更适合的周期性任务。Consolelibraries/Console/、Hashlibraries/Hash/等前者提供可重定向的多路控制台输出后者提供 MD5/SHA 校验和计算。ESP_I2Slibraries/ESP_I2S/、ESP_Videolibraries/ESP_Video/针对 I2S 音频与视频接口的硬件封装。七、平台与云生态类库除传统外设/网络库外libraries/目录当前还包含一批面向 Espressif 平台生态的库部分在 README 中列名略有出入以仓库实际目录为准ESP RainMakerlibraries/RainMaker/README 称之为Espressif 的端到端平台让 Makers 更快实现 IoT 想法实现设备端接入 RainMaker 云的控制/配网逻辑Matterlibraries/Matter/、OpenThreadlibraries/OpenThread/、Zigbeelibraries/Zigbee/分别对应 Matter 智能家居标准、Thread 低功耗 Mesh 组网与 Zigbee 协议examples/中各有 30 个成套示例如 libraries/Zigbee/examples/ 含 31 个场景工程ESP_NOWlibraries/ESP_NOW/点对点直连通信README 在ESP32 附加示例条目下提到 ESPNow 主题ESP_SRlibraries/ESP_SR/README 明确其用途是帮助开发者基于ESP32-S3 或 ESP32-P4芯片构建 AI 语音方案语音唤醒、离线识别等芯片可用性在此受限Insightslibraries/Insights/远程日志与遥测采集配合 Insights 平台使用WiFiProvlibraries/WiFiProv/、ESP_HostedOTAlibraries/ESP_HostedOTA/配网与 Hosted 设备的 OTA 支持。八、选型速查与适用性提醒基于 README 与仓库实际代码几条关键结论芯片适用性以库文档为准BluetoothSerial 仅原版 ESP32ESP_SR 限 S3/P4SD_MMC 依赖 4 线 MMC 总线。选型前先核对目标芯片。网络栈分层清晰底层WiFi/Ethernet→ 抽象层Network/NetworkClientSecure→ 应用层WebServer/HTTPClient/AsyncUDP/ESPmDNS。跨传输介质WiFi 或以太网的代码优先基于Network抽象编写。升级链路按推/拉选择命令行推送用ArduinoOTA tools/espota.pyWeb 上传用HTTPUpdateServer服务器拉取用HTTPUpdate一切最终落到Update库的U_FLASH/U_LITTLEFS等目标与UPDATE_ERROR_*错误码体系上。持久化优先 PreferencesNVS 键值接口比模拟 EEPROM 更适合结构化配置注意命名空间与 key 的 15 字符上限StartCounter 示例注释。库版本随核心统一内置库版本与核心版本一致当前 3.3.11升级核心时库一并更新API 兼容性以当前仓库的library.properties与头文件注释为准。所有库的完整清单及其一句话定位可随时回查 libraries/README.md某个库的具体用法则以该库examples/下的.ino示例与src/头文件注释为最终依据。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考