GPIO 限制

• 下载引脚（Strapping pins）影响启动行为 — GPIO0、GPIO2、GPIO12、GPIO15 影响启动模式
• GPIO6–GPIO11 连接至 Flash — 请勿使用，否则会立即崩溃
• GPIO34–GPIO39 仅支持输入 — 不支持输出，也不支持上拉/下拉
• ADC2 在 WiFi 启用时不可用 — WiFi 启用时请使用 ADC1（对应 GPIO32–GPIO39）

深度睡眠（Deep Sleep）

• 仅 RTC GPIO 支持唤醒 — GPIO0、GPIO2、GPIO4、GPIO12–GPIO15、GPIO25–GPIO27、GPIO32–GPIO39
• 使用 RTC_DATA_ATTR 修饰持久化变量 — 普通 RAM 在深度睡眠中内容会丢失
• esp_sleep_enable_ext0_wakeup() 用于单引脚唤醒 — 多引脚唤醒请使用 ext1 方式
• 唤醒后 WiFi 重连需耗时 1–3 秒 — 请在设计中预留该延迟

WiFi 注意事项

• 调用 WiFi.begin() 前必须先调用 WiFi.mode() — 工作模式会影响后续行为
• WiFi.setAutoReconnect(true) 并非总能生效 — 建议在主循环中自行实现重连逻辑
• 采用事件驱动方式（WiFi.onEvent()）更可靠 — 避免轮询 WiFi.status()
• 静态 IP 分配比 DHCP 更快 — 可节省约 2–5 秒连接时间

FreeRTOS

• 默认任务栈过小，无法满足 printf/WiFi 等操作 — 复杂任务建议使用 ≥4096 字节的栈空间
• 任务看门狗默认超时为 5 秒 — 需定期调用 vTaskDelay() 或显式喂狗
• 使用 xTaskCreatePinnedToCore() 绑定任务至指定核心 — WiFi 运行于 core 0，建议将用户代码运行于 core 1
• delay() 会主动让出调度权 — 在 FreeRTOS 任务中应使用 vTaskDelay(pdMS_TO_TICKS(ms))

内存管理

• 堆内存随时间推移逐渐碎片化 — 建议预先分配缓冲区，避免频繁 malloc/free
• 使用 ESP.getFreeHeap() 监控可用堆空间 — 长期运行的应用建议周期性记录日志
• 部分开发板支持 PSRAM — 可通过 heap_caps_malloc(size, MALLOC_CAP_SPIRAM) 显式分配
• 字符串拼接易导致堆碎片 — 推荐使用 String::reserve() 或直接操作 char 数组

外设使用

• 无原生 analogWrite() 支持 — 请使用 LEDC：调用 ledcSetup()、ledcAttachPin() 和 ledcWrite()
• I²C 通常需外接上拉电阻 — 内置上拉电阻在高速通信时驱动能力不足
• SPI 的片选（CS）引脚需手动管理 — SPI.begin() 不会自动配置 CS 引脚
• UART0 对应 Serial/USB 接口 — 外接设备请使用 UART1 或 UART2

OTA 更新

• OTA 需要两个 OTA 分区 — 默认分区方案可能仅含一个 OTA 分区
• 更新前请检查 ESP.getFreeSketchSpace() — 若剩余空间不足，OTA 将静默失败
• ArduinoOTA 更新过程会阻塞 — 应在主循环中处理，切勿置于时间敏感代码路径中

电源管理

• 掉电检测器（Brown-out detector）在电压约降至 2.4 V 时触发复位 — 若使用电池供电，可考虑调用 esp_brownout_disable() 关闭该功能
• WiFi 发射（TX）峰值电流达 300 mA — 电源需具备应对瞬时电流尖峰的能力
• 深度睡眠功耗约 10 µA — 但若启用了 RTC 外设，实际功耗将更高