硬件选型
先确认开发板的芯片、Flash、PSRAM、引脚和计划负载，再选择匹配的 FastBee 环境。统一固件按运行时开关和内存预算接纳功能；外设、规则和通信组合仍有容量与峰值限制。
开发板与环境
| 芯片/模组 | 推荐环境 | 适合场景 |
|---|---|---|
| ESP32 classic，4MB 无 PSRAM | esp32-F4R0 | GPIO、基础传感器、WiFi/MQTT |
| ESP32 classic，8MB 无 PSRAM | esp32-F8R0 | OTA、WROOM 节点 |
| ESP32 classic，8MB + 8MB PSRAM | esp32-F8R8 | WROVER 网关、缓存 |
| ESP32-C3，4MB 无 PSRAM | esp32c3-F4R0 | 低成本、低功耗 WiFi 节点 |
| ESP32-C6，4MB 无 PSRAM | esp32c6-F4R0 | WiFi 6 节点 |
| ESP32-C6，8MB 无 PSRAM | esp32c6-F8R0 | WiFi 6 OTA 节点 |
| ESP32-S3，8MB 无 PSRAM | esp32s3-F8R0 | 无 PSRAM 的 OTA 节点 |
| ESP32-S3，8MB + 8MB PSRAM | esp32s3-F8R8 | OTA、显示、规则和较多外设 |
| ESP32-S3，16MB + 8MB PSRAM | esp32s3-F16R8 | 大容量网关、4G/以太网和重型页面 |
以上 9 个环境均为正式发布环境。环境名中的 F 表示 Flash，R 表示 PSRAM；F4R0 不改成 N4R0，标准清单不再使用 F8R4。Flash 容量决定分区和 OTA；PSRAM 影响 MQTTS、设备控制面板和多外设并发时的可用余量。
常用模块
| 模块 | 接口 | 对应外设类型 |
|---|---|---|
| LED/继电器/蜂鸣器 | GPIO 输出 | 12 |
| 按键/门磁/PIR | GPIO 输入 | 11/13/14 |
| 光敏/土壤/电压/电流 | ADC | 15 |
| DHT11/DHT22、超声波 | GPIO | 38 |
| DS18B20 | OneWire | 44 |
| SHT31/AHT20/BH1750/BMP280/MPU6050 | I2C | 38 + sensorCategory |
| OLED/SH1106、LCD1602 | I2C | 36/52 |
| TM1637 | 两线 GPIO | 47 |
| WS2812B | 单线 GPIO | 45 |
| RFID MFRC522 | SPI | 54，并启用 rfid |
| RS485 从站 | UART + 收发器 | 51 / Modbus 页面 |
| 舵机/步进电机 | PWM/GPIO | 41/42 |
完整类型和参数见 外设参考。
选型建议
- 只做 GPIO/少量传感器时，4MB 环境成本最低；不支持 OTA。
- 需要 OTA、MQTTS、规则脚本、OLED 或多路外设时，优先选择
esp32s3-F8R8。 - 需要更大的配置/日志空间、4G/以太网或设备控制页面时，选择
esp32s3-F16R8。 - 使用 W5500、EC801E-CN 或 RS485 时，先确认 3.3V 供电、电平转换、UART/SPI 引脚和散热。
引脚和供电安全
- 避开 Flash/PSRAM、USB/JTAG、BOOT 和串口下载占用的引脚；不同板卡保留引脚不同，以原理图为准。
- ESP32 classic 的 GPIO34-39 仅输入；ADC2 在 WiFi 工作时受限，模拟采集优先使用 ADC1。
- I2C 总线需要 SDA/SCL 上拉，多个设备地址不能冲突。
- 继电器、舵机和 4G 模块可能产生较大电流，使用独立稳压和共地；强电负载必须做好隔离和防触电措施。
- 先在 Web 中保存外设为禁用，核对接线后逐个启用，单独读取/写入验证，再接入自动化规则。
采购与验证
- 查看板卡丝印或规格页，确认 Flash/PSRAM。
- 对照 硬件与环境矩阵 选择环境。
- 烧录后从
/api/system/info核对芯片和内存，从/api/features/status核对功能状态。 - 逐个接入外设，避免一次连接多个未知模块导致排错困难。