支持的传感器和模块
下表按当前源码中的 PeripheralType、驱动注册和 Web 配置整理。发布环境共享统一功能基线，是否能实际使用还要看 compiled、userEnabled、active 三个状态及硬件接线。
常用模块
| 模块 | 接口/类型 | 状态 |
|---|---|---|
| LED、继电器、蜂鸣器 | GPIO 输出 12 | 基础能力 |
| 按键、门磁、PIR、震动、雷达 | GPIO 输入 11/13/14、雷达 49 | 基础能力 |
| 光敏、土壤、烟雾、电压、电流 | ADC 15 | 基础能力，需校准 |
| PWM 调光/调速 | PWM 17 | 基础能力 |
| DHT11/DHT22、HC-SR04 | 通用传感器 38 | 需在参数中选择类别 |
| DS18B20 | OneWire 44 | 需要数据线上拉 |
| AHT20、SHT31、BH1750 | I2C 38 | 需要启用 I2C 传感器功能 |
| BMP280、MPU6050 | I2C 38 | 需要启用 i2cSensors |
| OLED/SH1106 | LCD 36 | 需要启用 lcd |
| LCD1602/PCF8574 | LCD1602 52 | 需要启用 lcd1602 |
| TM1637 | 七段数码管 47 | 需要启用 sevenSegment |
| WS2812B/NeoPixel | 45 | 需要启用 neopixel |
| 舵机、步进电机 | 41、42 | 外部供电和限位必需 |
| 旋转编码器 | 43 | GPIO 输入 |
| RFID MFRC522 | SPI 类型 54 | 需要启用 rfid |
| 红外接收 | 53 | esp32s3-F8R8 编译裁剪，其他支持环境仍须启用 irRemote |
| 433MHz RF | 48 | 需要启用 rfLearn 才能学习 |
| DS1302 RTC | 50 | 三线接口，按需启用 |
| RS485 Modbus 从站 | Modbus 51 | 设备端作为主站 |
| 设备事件 | 虚拟类型 60 | 不占用 GPIO |
芯片和构建限制
| 能力 | 限制 |
|---|---|
| 4MB 环境 | 无 OTA；重型功能可能因 DRAM 预算显示 no-memory |
esp32s3-F8R8 | 默认关闭红外和 433MHz RF 学习，避免 RMT/库冲突 |
esp32-F8R8、esp32s3-F16R8 | 具备更多资源，可在构建和运行时开启红外/RF |
| W5500 以太网 | 需 ethernet 编译开关、SPI 模块和引脚配置 |
| EC801E-CN 4G | 需 cellular 编译开关、SIM、天线和稳定供电 |
| BLE | 代码开关存在，但当前不作为发布配网能力 |
不要按历史档位选择模块；请查看 Web“功能配置”和 /api/features/status。
通用接入模块
以下模块没有专用驱动，可按信号类型接入：
| 输出类型 | 推荐配置 | 示例 |
|---|---|---|
| 数字高/低电平 | GPIO 输入/输出 | 光电、倾斜、干簧管、火焰数字输出 |
| 模拟电压 | ADC | 光敏、雨滴、声音、烟雾、压力变送器 |
| 脉冲/计数 | GPIO 输入或编码器 | 流量、转速、编码器 |
| 串口文本/帧 | UART | GPS、串口传感器、自定义模块 |
| RS485 | Modbus RTU | 温湿度、继电器、电机和仪表 |
配置和验证流程
- 在“外设配置”新增模块，填写唯一 ID、类型、引脚和参数。
- 先以
enabled=false保存，确认接线后再启用。 - 使用“读取/写入”或串口日志单独验证。
- 最后在“外设执行”中创建触发器和动作。
安全提示
- 引脚以开发板原理图和
include/core/ChipConfig.h为准；避开 Flash/PSRAM、USB/JTAG、BOOT 和下载串口引脚。 - ESP32 classic GPIO34-39 仅输入，ADC2 在 WiFi 工作时受限。
- I2C 多设备地址不能冲突；RS485 要确认 A/B、共地和终端电阻。
- 继电器、舵机和 4G 模块需要独立稳压，强电设备必须隔离。
H1 源码支持与验收边界（2026-10-04）
三种器件均已接入当前开发源码；不能再按早期“只有寄存器合同、未注册或无菜单”的状态理解，也不能把源码接入当作已部署或实物通过。
- ADS1115：通用传感器类型38，driver为ADS1115，已注册驱动并接入配置、缓存和采集动作。默认每地址一个MUX，输出voltage与rawCode；新增可选同一owner扫描1～4个MUX，输出逐路电压并保留各自时间，整轮成功才发布。多路增量待集中回归、容量与实物验收，见多路采样说明。支持8种MUX、6档换算量程和8种速率。见驱动边界与禁用样例。
- MCP23017：I/O扩展器类型55，driver为MCP23017，16个逻辑通道。必须引用专用RESET，并在一致配置预览后整组启用；A7/B7显式作为输出，不能作为输入。支持普通数字输入/输出，不支持PWM或中断；见六项默认禁用配置与步骤。
- PCA9685：独立PWM类型57，引用专用OE和I²C主总线；先准备、确认本次重新上电并初始化，再单独启用输出。16路共享频率，通道命令受channelMask约束，提供duty/pulse/angle及enable/disable/stop；见默认禁用配置与步骤。
可用性仍取决于配套固件的编译功能、运行开关、预算和资源准入。完整候选构建、各板型与无PSRAM设备、真实资源/内存、恢复、标定及24h/7d/V14仍须逐项取得实际证据。ADS1115的换算量程不是输入电压额定；PCA计算频率和MCP输出锁存都不是波形、负载或停机安全的实测结果。