# 支持的传感器和模块

下表按当前源码中的 `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 | 温湿度、继电器、电机和仪表 |

## 配置和验证流程

```mermaid
flowchart LR
  A[确认接口/供电/电平] --> B[选择 type]
  B --> C[配置引脚和参数]
  C --> D[保存为禁用]
  D --> E[核对接线后启用]
  E --> F[单独读写验证后接入规则]
```

1. 在“外设配置”新增模块，填写唯一 ID、类型、引脚和参数。
2. 先以 `enabled=false` 保存，确认接线后再启用。
3. 使用“读取/写入”或串口日志单独验证。
4. 最后在“外设执行”中创建触发器和动作。

## 安全提示

* 引脚以开发板原理图和 `include/core/ChipConfig.h` 为准；避开 Flash/PSRAM、USB/JTAG、BOOT 和下载串口引脚。
* ESP32 classic GPIO34-39 仅输入，ADC2 在 WiFi 工作时受限。
* I2C 多设备地址不能冲突；RS485 要确认 A/B、共地和终端电阻。
* 继电器、舵机和 4G 模块需要独立稳压，强电设备必须隔离。

详细字段和接线示例见 [外设参考](https://www.fastbee.cn/doc/device/v2/peripherals.md) 与 [示例索引](https://www.fastbee.cn/doc/device/v2/examples.md)。

## H1 源码支持与验收边界（2026-10-04）

三种器件均已接入当前开发源码；不能再按早期“只有寄存器合同、未注册或无菜单”的状态理解，也不能把源码接入当作已部署或实物通过。

* ADS1115：通用传感器类型38，driver为ADS1115，已注册驱动并接入配置、缓存和采集动作。默认每地址一个MUX，输出voltage与rawCode；新增可选同一owner扫描1～4个MUX，输出逐路电压并保留各自时间，整轮成功才发布。多路增量待集中回归、容量与实物验收，见[多路采样说明](https://www.fastbee.cn/doc/internal/device-dev-logs/ads1115-scan.html)。支持8种MUX、6档换算量程和8种速率。见[驱动边界与禁用样例](https://www.fastbee.cn/doc/internal/device-dev-logs/ads1115-driver.html)。
* MCP23017：I/O扩展器类型55，driver为MCP23017，16个逻辑通道。必须引用专用RESET，并在一致配置预览后整组启用；A7/B7显式作为输出，不能作为输入。支持普通数字输入/输出，不支持PWM或中断；见[六项默认禁用配置与步骤](https://www.fastbee.cn/doc/internal/device-dev-logs/mcp23017-disabled-example.html)。
* PCA9685：独立PWM类型57，引用专用OE和I²C主总线；先准备、确认本次重新上电并初始化，再单独启用输出。16路共享频率，通道命令受channelMask约束，提供duty/pulse/angle及enable/disable/stop；见[默认禁用配置与步骤](https://www.fastbee.cn/doc/internal/device-dev-logs/pca9685-disabled-example.html)。

可用性仍取决于配套固件的编译功能、运行开关、预算和资源准入。完整候选构建、各板型与无PSRAM设备、真实资源/内存、恢复、标定及24h/7d/V14仍须逐项取得实际证据。ADS1115的换算量程不是输入电压额定；PCA计算频率和MCP输出锁存都不是波形、负载或停机安全的实测结果。
