传感器基础

作者：朱天华　|　最后修改：2026-07-15

概述

传感器在物联网中的作用

传感器是物联网系统的"感官器官"，承担着物理世界与数字世界之间的信息桥梁角色。在典型的物联网架构中，传感器位于感知层，负责将温度、湿度、压力、光照、气体浓度、加速度等物理量转换为电信号或数字信号，供微控制器采集、处理和上传。没有传感器，物联网就失去了数据来源，所有上层的数据分析、云端计算和智能决策都无从谈起。

在工业物联网、智慧农业、智能家居、智慧城市等场景中，传感器决定了系统的感知精度、响应速度和覆盖维度。一个完整的物联网项目通常需要搭配多种类型的传感器，以实现对环境的全方位监测。

LuatOS对传感器的支持能力概述

LuatOS是合宙推出的轻量级物联网操作系统，内置了丰富的外设驱动库，能够支持各类传感器与外设器件的快速接入。其LuatOS核心库、LuatOS通用扩展库和LuatOS传感器扩展库构成了完整的传感器开发框架：

LuatOS核心库（和传感器相关）：

库名	功能说明	典型应用
i2c	I2C总线通信，支持硬件I2C和软件I2C	温湿度、气压、光照等数字传感器
spi	SPI总线通信，支持主模式和软硬件SPI	高速传感器、Flash、显示屏
adc	模数转换，支持电压采集和CPU温度	光敏电阻、电池电压
gpio	GPIO控制，支持中断和消抖	霍尔开关、按键、LED控制
uart	串口通信	PM2.5传感器、GPS模块
onewire	单总线协议	DS18B20温度传感器
pwm	脉宽调制输出	蜂鸣器、电机调速、LED调光

LuatOS扩展库（和传感器相关）

库名	功能说明
exs_tm1638	TM1638数码管+按键驱动
exs_xxx	上百种传感器扩展库正在开发中......

传感器与器件分类总览

本文将常见的传感器与外设器件分为9篇共56个类别，涵盖从环境监测到人机交互的各个领域。下表列出了全部类别及其所属大类：

序号	所属篇目	类别名称
1	第一篇：环境监测传感器	温湿度传感器
2	第一篇：环境监测传感器	温度传感器
3	第一篇：环境监测传感器	气压传感器
4	第一篇：环境监测传感器	气压温湿度传感器
5	第一篇：环境监测传感器	光照传感器
6	第一篇：环境监测传感器	色彩色温光亮度传感器
7	第一篇：环境监测传感器	光敏电阻
8	第一篇：环境监测传感器	空气质量传感器
9	第一篇：环境监测传感器	VOC传感器
10	第一篇：环境监测传感器	甲醛传感器
11	第一篇：环境监测传感器	颗粒物传感器
12	第一篇：环境监测传感器	CO2传感器
13	第一篇：环境监测传感器	有毒气体传感器
14	第一篇：环境监测传感器	土壤传感器
15	第一篇：环境监测传感器	水质传感器
16	第一篇：环境监测传感器	红外测温传感器
17	第一篇：环境监测传感器	暴风雨闪电传感器
18	第一篇：环境监测传感器	雨量传感器
19	第二篇：运动与姿态传感器	加速度传感器
20	第二篇：运动与姿态传感器	六轴传感器
21	第二篇：运动与姿态传感器	九轴传感器
22	第二篇：运动与姿态传感器	磁力计
23	第二篇：运动与姿态传感器	陀螺仪传感器
24	第二篇：运动与姿态传感器	距离传感器
25	第二篇：运动与姿态传感器	霍尔传感器
26	第二篇：运动与姿态传感器	雷达传感器
27	第二篇：运动与姿态传感器	旋转编码器
28	第二篇：运动与姿态传感器	水流量传感器
29	第三篇：生物医学传感器	心率血氧传感器
30	第四篇：工业与测量传感器	称重传感器
31	第四篇：工业与测量传感器	功率传感器
32	第四篇：工业与测量传感器	电能计量芯片
33	第四篇：工业与测量传感器	ADC传感器
34	第四篇：工业与测量传感器	热电偶传感器
35	第四篇：工业与测量传感器	颜色传感器
36	第五篇：执行器与驱动模块	继电器
37	第五篇：执行器与驱动模块	电机驱动
38	第五篇：执行器与驱动模块	LED驱动
39	第五篇：执行器与驱动模块	数码管驱动
40	第五篇：执行器与驱动模块	音频功放
41	第五篇：执行器与驱动模块	I2S音频功放
42	第六篇：接口扩展芯片	GPIO扩展
43	第六篇：接口扩展芯片	串口扩展
44	第六篇：接口扩展芯片	移位寄存器
45	第六篇：接口扩展芯片	DAC模块
46	第六篇：接口扩展芯片	CAN控制器
47	第六篇：接口扩展芯片	RTC模块
48	第六篇：接口扩展芯片	Flash存储芯片
49	第七篇：电源管理芯片	电池充电芯片
50	第七篇：电源管理芯片	锂电高精度电量计
51	第八篇：通信模块	无线模块
52	第八篇：通信模块	RFID模块
53	第八篇：通信模块	红外遥控接收器
54	第八篇：通信模块	红外遥控
55	第九篇：行业通信协议	电力通信协议（DL/T 645-2007）
56	第九篇：行业通信协议	环保行业国标通信协议（HJ 212-2017）

第一篇：环境监测传感器

环境监测传感器是物联网应用中最基础也最常用的传感器类别，涵盖温湿度、气压、光照、空气质量等环境参数的检测。这些传感器广泛用于智能家居、智慧农业、工业环境监控、气象站等场景。

类别1：温湿度传感器

要点1：什么是温湿度传感器

温湿度传感器是一种能够同时测量环境温度和相对湿度的复合型传感器。其内部通常集成了温度感测元件（如NTC热敏电阻、带隙温度传感器或PN结温度传感器）和湿度感测元件（如电容式湿度传感元件或电阻式湿度传感元件），并通过ADC转换为数字信号输出。

基本参数：

温度测量范围：通常为-40°C至+85°C或+125°C
湿度测量范围：0%\~100%RH
温度精度：±0.1°C至±2°C（视型号而定）
湿度精度：±1.5%RH至±5%RH（视型号而定）
输出类型：数字信号（I2C/SPI/单总线）

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
AHT10	奥松电子(ASAIR)	I2C (0x38)	±2%RH, ±0.3°C, 1.8-3.6V	高性价比，SMD封装，低功耗
AM2320	奥松电子(ASAIR)	I2C(0x5C)/单总线	±3%RH, ±0.5°C, 3.1-5.5V	双通信模式，兼容DHT11单总线
CHT8305C	芯来科技(Sensylink)	I2C	±3%RH, ±0.5°C, 2.5-5.5V	支持AD0地址引脚，ALERT输出
SHT20	盛思锐(Sensirion)	I2C (0x40)	±3%RH, ±0.3°C, 2.1-3.6V	行业标准DFN封装，CMOSens技术
SHT30	盛思锐(Sensirion)	I2C (0x44/0x45)	±2%RH, ±0.2°C, 2.15-5.5V	SHT20升级版，双地址，高精度
DHT11	奥松电子(ASAIR)	单总线	±5%RH, ±2°C, 3.3-5.5V	成本极低，入门级，精度有限
DHT12	奥松电子(ASAIR)	I2C(0x5C)/单总线	±5%RH, ±0.5°C, 2.7-5.5V	DHT11升级版，增加I2C接口
DPS368	英飞凌(Infineon)	I2C/SPI	±0.5°C, 300-1200hPa, 1.7-3.6V	防水IPX8，压力+温度复合
SI7021	芯科(Silicon Labs)	I2C (0x40)	±3%RH, ±0.4°C, 1.9-3.6V	CMOS工艺，低功耗，已EOL
HDC1080	德州仪器(TI)	I2C (0x40)	±2%RH, ±0.2°C, 2.7-5.5V	超低功耗(1.3μA)，14位分辨率
HDC2080	德州仪器(TI)	I2C	±2%RH, ±0.2°C, 1.62-3.6V	HDC1080升级版，含中断/DRDY引脚
ATH10	奥松电子(ASAIR)	I2C	±2%RH, ±0.3°C	AHT10系列变体
SHT45	盛思锐(Sensirion)	I2C (0x44)	±1%RH, ±0.1°C, 1.08-3.6V	SHT4x系列旗舰，超高精度

型号对比分析：

- 高精度首选：SHT45（±1%RH/±0.1°C）和SHT30（±2%RH/±0.2°C）性能最为出色

- 高性价比首选：AHT10和DHT11成本低廉，适合大批量部署

- 低功耗首选：HDC1080（1.3μA@1sps）和SHT45（0.4μA@1Hz）适合电池供电

- 入门学习首选：DHT11协议简单，但精度较低，适合教学演示

- 防水场景：DPS368具备IPX8防水等级，适合恶劣环境

要点3：应用场景

1. 智能家居环境监控：监测室内温湿度，联动空调、加湿器等设备自动调节

2. 智慧农业大棚：实时监测温室环境，控制通风、灌溉和遮阳系统

3. 冷链物流仓储：监控冷链运输和仓库温湿度，确保食品和药品安全

4. 气象站与数据记录仪：采集环境气象数据，用于天气预报和气候研究

5. 工业车间环境监控：监测厂房环境，保障生产工艺和工人安全

6. 暖通空调(HVAC)系统：根据温湿度数据自动调节空调运行策略

要点4：硬件接口设计

温湿度传感器主要使用I2C接口和单总线接口两种通信方式。

I2C接口接线图（以SHT30为例）：

合宙AirXXXX模组            SHT30传感器
  ┌──────────┐            ┌──────────┐
  │      3.3V│────────────│VDD       │
  │       GND│────────────│GND       │
  │   I2C_SCL│────┬───────│SCL       │
  │   I2C_SDA│────┼──┬────│SDA       │
  └──────────┘    │  │    └──────────┘
                 4.7kΩ 4.7kΩ  (上拉电阻至3.3V)

单总线接口接线图（以DHT11为例）：

合宙AirXXXX模组            DHT11传感器
  ┌──────────┐            ┌──────────┐
  │      3.3V│────────────│VDD       │
  │       GND│────────────│GND       │
  │    GPIO_X│────┬───────│DATA      │
  │          │    │       │NC        │
  └──────────┘   4.7kΩ    └──────────┘
                 (上拉至3.3V)

注意事项：

I2C总线SCL和SDA线必须各接一个4.7kΩ上拉电阻至VDD
电源引脚附近放置100nF去耦电容，尽量靠近传感器
DHT11等单总线传感器数据线需接4.7kΩ上拉电阻，线长超过5m时需减小阻值
3.3V供电时连接线尽量短，避免压降导致供电不足
传感器应避免直接暴露在挥发性溶剂、腐蚀性气体环境中

要点5：工作原理

温湿度传感器的核心是两种不同的物理感测机制：

湿度感测原理（电容式）：

大多数现代数字温湿度传感器采用电容式湿度感测元件。其结构为在两个电极之间填充高分子聚合物介质薄膜（如聚酰亚胺）。当环境湿度变化时，聚合物薄膜吸湿或放湿，导致其介电常数发生变化，进而引起电容值改变。典型变化范围为几pF到几十pF。内部ADC将电容变化量转换为数字信号输出。

温度感测原理（带隙式）：

温度测量通常采用带隙温度传感器（Band-gap Temperature Sensor）。利用硅PN结的正向压降与温度的线性关系（约-2mV/°C），通过测量两个不同电流密度下PN结的压降差来获取温度值。这种方法精度高、成本低、一致性好。

信号转换链路：

物理量（温度/湿度）-> 传感元件（电容/PN结）-> 模拟电压/电容变化 -> ADC采样 -> 数字校准与线性化 -> I2C/单总线数字输出

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别2：温度传感器

要点1：什么是温度传感器

温度传感器是一种专门用于测量环境温度或物体温度的传感器器件。与温湿度复合传感器不同，纯温度传感器专注于温度测量，通常具有更宽的测量范围、更高的精度和更低的成本。常见的温度传感器类型包括数字温度传感器（I2C/1-Wire接口）、热电偶、RTD（电阻温度检测器）和NTC热敏电阻等。

基本参数：

测量范围：-55°C至+150°C（部分型号可达+125°C或更高）
精度：±0.1°C至±3°C（视型号而定）
分辨率：9位至13位可编程
输出类型：数字信号（I2C/SPI/1-Wire）

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
LM75	NXP/Maxim/TI	I2C (0x48-0x4F)	±2°C, -55\~+125°C, 9位	工业标准，8个I2C地址，恒温器功能
DS18B20	亚德诺/Maxim(ADI)	1-Wire	±0.5°C, -55\~+125°C, 9-12位	唯一64位ID，多点总线，寄生供电
KTH1601SLST3	昆泰芯(CONNTEK)	GPIO(数字输出)	全极霍尔开关, 1.6-5.5V, 1.6μA	低功耗霍尔开关传感器，含温度补偿
LM92	德州仪器(TI)	I2C/SMBus	±0.33°C, -55\~+150°C, 12位	高精度，窗口比较器，ALERT输出
LM75B	NXP	I2C/SMBus	±2°C, -55\~+125°C, 9位	LM75改进版，UL认证，3.0-5.5V

型号对比分析：

- 高精度首选：LM92（±0.33°C，12位分辨率）适合精密温度监控

- 多点测温首选：DS18B20支持1-Wire总线多点挂接，每个器件有唯一64位序列号

- 工业标准首选：LM75/LM75B兼容性极好，最多8个器件共享一条I2C总线

- 防水场景首选：DS18B20有防水封装版本（不锈钢探头），适合液温测量

- 低功耗场景：KTH1601SLST3功耗仅1.6μA@1.8V，内置温度补偿电路

要点3：应用场景

1. 工业设备温度监控：监测电机、变压器、功率器件等关键设备的温度

2. 机房/数据中心温控：多点监测服务器机柜进/出风温度

3. HVAC暖通空调：室内外温度检测，控制空调和供暖系统

4. 冷链温度记录：食品、疫苗运输全程温度追踪

5. 液温测量：水箱、管道、反应釜内液体温度监测（DS18B20防水探头）

6. 电子设备过热保护：PCB板级温度检测，触发散热或断电保护

要点4：硬件接口设计

温度传感器主要使用I2C接口和1-Wire接口。

I2C接口接线图（以LM75为例）：

    AirXXX组               LM75传感器
  ┌──────────┐            ┌──────────┐
  │      3.3V│────────────│VDD       │
  │       GND│────────────│GND       │
  │   I2C_SCL│────┬───────│SCL       │
  │   I2C_SDA│────┼──┬────│SDA       │
  │          │    │  │    │A0/A1/A2  │──GND(设置地址)
  │          │    │  │    │OS        │(开漏输出,可选)
  └──────────┘   4.7kΩ 4.7kΩ

1-Wire接口接线图（以DS18B20为例）：

AirXXXX模组              DS18B20传感器
  ┌──────────┐            ┌──────────┐
  │      3.3V│────┬───────│VDD       │
  │       GND│────│───────│GND       │
  │    GPIO_X│────┼───────│DQ        │
  │          │    │       └──────────┘
  │          │   4.7kΩ
  │          │    │(上拉至3.3V)
  └──────────┘    │
                 VDD

注意事项：

LM75的A0/A1/A2地址引脚必须明确连接VDD或GND，不可悬空
DS18B20的DQ数据线必须接4.7kΩ上拉电阻
DS18B20支持寄生供电模式（VDD接GND），但需强上拉电路
多个DS18B20可挂接同一条1-Wire总线，通过64位ROM ID区分
LM75B工作电压为3.0-5.5V，需确认与模组电平兼容

要点5：工作原理

LM75/LM75B工作原理（带隙温度传感器）：

LM75内部使用带隙温度传感器作为感温元件。其原理是利用硅PN结在两个不同电流密度下工作时，正向压降的差值与绝对温度成正比（PTAT，Proportional To Absolute Temperature）。内部Σ-Δ ADC将模拟温度信号转换为9位数字值。芯片还内置了可编程的过温关断阈值（T_OS）和滞回温度（T_HYST）寄存器，当温度超过设定值时OS引脚输出告警信号。

DS18B20工作原理：

DS18B20采用带隙温度感测原理，温度感测元件测量温度后，通过内部的斜率累加器进行温度到数字的转换。用户可选择9位（0.5°C）至12位（0.0625°C）分辨率。转换结果存储在Scratchpad存储器中，通过1-Wire协议读取。每个DS18B20出厂时烧录了唯一的64位ROM序列码，支持多点组网。器件还内置EEPROM用于存储温度报警上下限。

信号转换链路：

环境温度 -> 带隙感温元件（PTAT电压） -> Σ-Δ ADC -> 数字校准 -> I2C/1-Wire输出 -> 主控设备（例如合宙AirXXXX模组）读取

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别3：气压传感器

要点1：什么是气压传感器

气压传感器（又称大气压力传感器）是一种用于测量环境大气压力的传感器器件。它通过内部的MEMS压力敏感元件将气压变化转换为电信号，再经ADC转换为数字值输出。气压传感器广泛应用于海拔测量、天气预报、室内导航（楼层判定）等场景。

基本参数：

测量范围：通常为300\~1200 hPa
精度：±0.06 hPa至±2.5 hPa（视型号而定）
分辨率：0.002 hPa至0.16 hPa
温度测量：大多数气压传感器同时提供温度输出（用于补偿）
输出类型：数字信号（I2C/SPI）

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
BMP180	博世(Bosch)	I2C	±1hPa, 300-1100hPa, 1.8-3.6V	BMP085升级版，体积小
BMP280	博世(Bosch)	I2C/SPI	±1hPa, 300-1100hPa, 1.71-3.6V	BMP180换代，体积缩小63%
BME680	博世(Bosch)	I2C/SPI	±0.6hPa, 300-1100hPa, 1.71-3.6V	4合1：气压+温度+湿度+气体
SPL06	歌尔微电子(Goertek)	I2C/SPI	±1hPa, 300-1100hPa, 1.7-3.6V	国产高精度，内置FIFO
BMP085	博世(Bosch)	I2C	±1hPa, 300-1100hPa, 1.8-3.6V	早期型号，体积较大
NS2520	纳芯微(NOVOSENSE)	I2C	300-1200hPa, 1.8-3.6V	国产替代方案，数字输出
MS5611	TE Connectivity(MEAS)	I2C/SPI	±1.5hPa, 10-1200mbar, 1.8-3.6V	高分辨率(10cm)，24位ADC

型号对比分析：

- 高分辨率首选：MS5611分辨率可达10cm高度变化，适合高度计和variometer

- 高性价比首选：BMP280是目前最主流的气压传感器，体积小、功耗低

- 多功能首选：BME680集成了气压、温度、湿度和气体检测四合一

- 国产替代：SPL06和NS2520为国产方案，供应链更稳定

- 已停产型号：BMP085和BMP180为早期型号，建议新设计使用BMP280

要点3：应用场景

1. 海拔高度测量：通过气压计算海拔，辅助GPS三维定位

2. 室内楼层判定：利用气压差检测楼层变化，用于室内导航

3. 天气预报：监测气压变化趋势，预测天气变化

4. 无人机高度控制：提供气压高度数据，辅助无人机悬停和定高

5. 运动健康监测：登山、骑行时记录海拔变化和爬升高度

6. 无人机/航模高度计：实时高度测量与垂直速度指示

要点4：硬件接口设计

气压传感器主要使用I2C接口和SPI接口。

I2C接口接线图（以BMP280为例）：

AirXXXX模组              BMP280传感器
  ┌──────────┐            ┌──────────┐
  │      3.3V│────────────│VDD       │
  │      3.3V│────────────│VDDIO     │
  │       GND│────────────│GND       │
  │   I2C_SCL│────┬───────│SCL       │
  │   I2C_SDA│────┼──┬────│SDA       │
  │       GND│────│──│────│CSB(选I2C)│
  │       GND│────│──│────│SDO(选地址)│
  └──────────┘   4.7kΩ 4.7kΩ

注意事项：

I2C模式：CSB引脚接VDDIO选择I2C模式；SDO引脚接GND选地址0x76，接VDDIO选地址0x77
VDD和VDDIO应各接100nF去耦电容
气压传感器应避免气流直接冲击测量孔
传感器上方应留有通气孔，不可完全密封

要点5：工作原理

压阻式气压传感原理（BMP280/BMP180）：

BMP280采用博世专利的APSM（Advanced Porous Silicon Membrane，先进多孔硅膜）MEMS制造工艺。传感器核心是一个微加工的硅膜片，膜片上集成了压阻式应力敏感元件。当外界气压变化时，膜片产生微小变形，导致压敏电阻的阻值发生变化。通过惠斯通电桥电路将阻值变化转换为电压信号，再由内部ADC转换为数字值。

电容式气压传感原理（SPL06/DPS368）：

电容式气压传感器利用两个电极之间的微间隙电容随气压变化而改变的原理。当气压使膜片弯曲时，电极间距变化导致电容值改变。电容式方案在温度变化下具有更好的稳定性。

信号转换链路：

大气压力 -> MEMS膜片变形 -> 压阻/电容变化 -> 惠斯通电桥/RC振荡 -> ADC采样 -> 温度补偿校准 -> I2C/SPI数字输出

每个传感器出厂时都经过校准，校准系数存储在内部EEPROM/OTP中。用户读取原始数据后需使用这些校准系数进行补偿计算，才能得到精确的气压值。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别4：气压温湿度传感器

要点1：什么是气压温湿度传感器

气压温湿度传感器是一种集成了气压、温度和湿度三种环境参数测量功能于一体的复合传感器。与单纯的气压传感器（如BMP280）不同，它额外集成了湿度感测元件，能够提供更全面的环境信息。这类传感器减少了PCB上器件数量，简化了设计，非常适合需要全面环境监测的应用。

基本参数：

气压范围：300\~1100 hPa
温度范围：-40\~+85°C
湿度范围：0\~100%RH
湿度精度：±3%RH
气压精度：±0.12 hPa（相对精度）
输出类型：数字信号（I2C/SPI）

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
BME280	博世(Bosch)	I2C/SPI	±3%RH, ±1°C, ±0.12hPa	三合一标杆产品，寄存器兼容BMP280

BME280是目前市场上最成熟的气压温湿度三合一传感器。其湿度传感器可独立启用/关闭，与BMP280寄存器级兼容。在1Hz采样率下，三参数同时测量功耗仅3.6μA，非常适合电池供电设备。

BME280与BMP280对比：

参数	BME280	BMP280
湿度测量	支持	不支持
封装尺寸	2.5×2.5×0.93mm	2.0×2.5×0.95mm
功耗(1Hz全开)	3.6μA	2.7μA
寄存器兼容	是	是
价格	较高	较低

要点3：应用场景

1. 智能家居环境站：一台设备提供完整的室内环境数据（温湿度+气压）

2. 便携式气象仪：户外气象数据采集，配合GPS实现移动气象监测

3. 室内导航：利用气压数据进行楼层判定，配合温湿度补偿提高精度

4. HVAC系统：暖通空调系统的全面环境参数监测与控制

5. 无人机气象载荷：轻量化设计适合无人机搭载，采集大气数据

6. IoT环境节点：电池供电的物联网环境监测节点，超低功耗长时间运行

要点4：硬件接口设计

BME280支持I2C和SPI两种接口。

I2C接口接线图：

AirXXXX模组              BME280传感器
  ┌──────────┐            ┌──────────┐
  │      3.3V│────────────│VDD       │
  │      3.3V│────────────│VDDIO     │
  │       GND│────────────│GND       │
  │   I2C_SCL│────┬───────│SCK       │
  │   I2C_SDA│────┼──┬────│SDI       │
  │       GND│────│──│────│CSB(I2C)  │
  │       GND│────│──│────│SDO(地址) │
  └──────────┘   4.7kΩ 4.7kΩ

注意事项：

CSB接VDDIO选择I2C模式，接GND（或作片选）选择SPI模式
SDO引脚接GND时I2C地址为0x76，接VDDIO时为0x77
VDD和VDDIO应各接100nF去耦电容
BME280传感器开孔应朝向环境，不可被外壳遮挡
湿度传感器需要气流接触，外壳需留透气孔

要点5：工作原理

BME280在单个3.0×3.0×0.93mm的金属盖LGA封装内集成了三个独立的感测元件：

气压感测： 采用与BMP280相同的压阻式MEMS技术，多孔硅膜片感受气压变化。

湿度感测： 采用电容式聚合物湿度感测元件。湿度变化引起聚合物介电常数变化，进而改变电容值。响应时间约1秒（τ63%），精度±3%RH。

温度感测： 内置带隙温度传感器，主要用于气压和湿度测量的温度补偿，也可用于环境温度估算。

三个传感器可独立启用/禁用，支持sleep、forced和normal三种工作模式。在forced模式下，主机触发单次测量后传感器自动返回sleep模式；normal模式下传感器在测量周期和standby周期之间自动切换。

信号转换链路：

三路物理量（气压/温度/湿度）-> 各自感测元件 -> 内部ADC -> 校准系数补偿 -> I2C/SPI输出 -> 主控设备（例如合宙AirXXXX模组）读取计算

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别5：光照传感器

要点1：什么是光照传感器

光照传感器（又称环境光传感器，Ambient Light Sensor, ALS）是一种用于测量环境光照强度的传感器。其光谱响应曲线设计为接近人眼视觉函数（明视觉函数V(λ)），能够准确感知人眼所感受的光照强度，输出以勒克斯（lux）为单位的测量值。光照传感器通常内置红外阻隔滤光片，确保测量结果不受红外光干扰。

基本参数：

测量范围：0.01 lux至83000 lux（或更高）
分辨率：0.0042 lux至1 lux
光谱响应：接近人眼视觉函数（约380-780nm可见光）
输出类型：数字信号（I2C）

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
BH1750	罗姆(ROHM)	I2C (0x23/0x5C)	1-65535lux, ±20%, 2.4-3.6V	16位直接输出lux值，无需计算
TSL2561	艾迈斯(ams OSRAM)	I2C (0x29/0x39/0x49)	0.1-40000lux, 2.7-3.6V	双二极管（全光谱+红外），已停产
VEML6030	威世(Vishay)	I2C (0x10/0x48)	0-140000lux, 0.0042lux/步, 2.5-3.6V	高精度16位，100/120Hz闪烁抑制
OPT3001	德州仪器(TI)	I2C (0x44-0x47)	0.01-83000lux, ±10%, 1.6-3.6V	自动量程，23位动态范围，红外阻隔

型号对比分析：

- 最简单易用：BH1750直接输出lux值，无需复杂计算，是入门首选

- 最高精度：OPT3001自动增益量程，23位动态范围，精度±10%

- 最宽量程：VEML6030可达140000lux，适合户外强光环境

- 暗光性能：VEML6030分辨率0.0042lux，适合深色玻璃下安装

- 已停产：TSL2561已停产，建议用VEML6030或OPT3001替代

要点3：应用场景

1. 手机/平板背光调节：根据环境光自动调节屏幕亮度，提升用户体验和续航

2. 智能照明系统：室内照明根据自然光强度自动开关和调光

3. 农业光照监测：监测温室或大棚光照强度，控制补光灯

4. 安防监控：低光环境下触发红外补光或报警

5. 汽车仪表盘调光：根据车内外光线强度自动调节仪表亮度

6. 智能窗帘/遮阳：根据光照强度自动控制窗帘开合

要点4：硬件接口设计

光照传感器统一使用I2C接口。

I2C接口接线图（以BH1750为例）：

AirXXXX模组              BH1750模块(GY-302)
  ┌──────────┐            ┌──────────┐
  │      3.3V│────────────│VCC       │
  │       GND│────────────│GND       │
  │   I2C_SCL│────┬───────│SCL       │
  │   I2C_SDA│────┼──┬────│SDA       │
  │       GND│────│──│────│ADDR(选址)│
  └──────────┘   4.7kΩ 4.7kΩ

注意事项：

BH1750的ADDR引脚接地时I2C地址为0x23，接VCC时为0x5C
GY-302模块已集成4.7kΩ上拉电阻和3.3V稳压，可直接连接
传感器应安装在能接收环境光的位置，避免被遮挡
深色玻璃下安装时需选择高灵敏度型号（如VEML6030/OPT3001）
I2C总线频率最高400kHz

要点5：工作原理

BH1750工作原理：

BH1750内部集成了光电二极管阵列和16位ADC。光电二极管将入射光转换为光电流，电流经过积分式ADC转换为数字值。其光谱响应峰值在560nm（绿光），与人眼明视觉函数高度匹配。芯片内置50Hz/60Hz光噪声抑制电路，可直接输出lux值，无需外部计算。

OPT3001工作原理：

OPT3001采用精密光学滤波器实现人眼匹配响应，阻隔99%以上的红外光。内部使用自适应增益架构，自动选择12种满量程范围（23位有效动态范围），无需手动设置增益。测量结果通过I2C输出，支持中断功能。

VEML6030工作原理：

VEML6030集成了高灵敏度光电二极管、低噪声放大器和16位ADC。支持可编程增益和积分时间设置，适应不同光照条件。内置100Hz/120Hz闪烁噪声抑制，有效消除荧光灯频闪干扰。

信号转换链路：

入射光 -> 光电二极管（光电流） -> 放大器 -> 积分ADC -> 数字值 -> lux换算 -> I2C输出

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别6：色彩色温光亮度传感器

要点1：什么是色彩色温光亮度传感器

色彩色温光亮度传感器是一种能够同时测量光线的红(R)、绿(G)、蓝(B)分量、环境光亮度以及色温的多通道光学传感器。通过分析RGB三通道和红外(IR)/透明(C)通道的数据，可以计算出环境光的色温（Color Temperature，单位K）和照度（lux），实现比单纯光照传感器更丰富的光学信息采集。

基本参数：

测量通道：R/G/B/C/IR（5通道）
分辨率：16位/通道
色温范围：约1500K-10000K+
光亮度范围：0-140000 lux
输出类型：数字信号（I2C）

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
VEML3328	威世(Vishay)	I2C (0x10)	R/G/B/C/IR 5通道, 16位, 2.6-3.6V	OPLGA4超小封装(2.0×1.25mm)，Filtron技术

VEML3328是目前该类别中的代表性产品。它集成了红、绿、蓝、透明和红外5个通道的光电二极管，每通道16位分辨率，峰值灵敏度分别为：R(610nm)、G(560nm)、B(470nm)、C(590nm)、IR(825nm)。器件采用Vishay专利的FiltronTM技术，实现精确的通道选择性。支持可编程增益和积分时间，关断功耗仅80nA。

要点3：应用场景

1. 显示器自动白平衡：根据环境光色温自动调整LCD/OLED屏幕白平衡

2. 智能照明色温调节：LED灯具根据环境光色温自动调节输出色温

3. 相机白平衡辅助：为数码相机提供环境色温参考数据

4. 室内外环境区分：通过色温差异区分室内（暖光）和室外（日光）环境

5. 智能植物照明：监测植物生长光照的光谱成分，优化LED补光方案

6. IoT智能照明控制：LED颜色输出主动监控与反馈控制

要点4：硬件接口设计

VEML3328使用I2C接口通信。

I2C接口接线图：

AirXXXX模组              VEML3328传感器
  ┌──────────┐            ┌──────────┐
  │      3.3V│────────────│VDD       │
  │       GND│────────────│GND       │
  │   I2C_SCL│────┬───────│SCL       │
  │   I2C_SDA│────┼──┬────│SDA       │
  └──────────┘   2.2kΩ 2.2kΩ
                   (或4.7kΩ)

注意事项：

I2C上拉电阻建议2.2kΩ-4.7kΩ
VEML3328工作电压2.6-3.6V，典型3.0V
传感器感光面应朝向待测光源，避免遮挡
I2C地址固定为0x10
传感器封装极小(2.0×1.25×1.0mm)，焊接需注意工艺
100nF去耦电容应尽量靠近VDD引脚

要点5：工作原理

VEML3328在单个CMOS芯片上集成了5个不同光谱响应的光电二极管阵列，分别对应红(R, 610nm)、绿(G, 560nm)、蓝(B, 470nm)、透明(C, 全可见光)和红外(IR, 825nm)通道。

色温计算原理：

色温（Correlated Color Temperature, CCT）通过RGB或C/IR通道的比值计算。典型算法为：先通过C通道获取总光照度，再通过R/B通道比值估算色温。色温越高（偏蓝白光），B通道相对值越大；色温越低（偏黄红光），R通道相对值越大。

亮度计算原理：

透明通道(C)的光谱响应接近人眼视觉函数，可以直接用于计算环境光照度(lux)。也可通过R+G+B通道加权计算。

信号转换链路：

入射光 -> 5通道光电二极管阵列 -> 各通道放大器 -> 16位ADC -> 数字值 -> I2C输出 -> 主控设备（例如合宙AirXXXX模组）计算色温/亮度

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别7：光敏电阻

要点1：什么是光敏电阻

光敏电阻（Light Dependent Resistor, LDR）又称光导体，是一种利用半导体光电效应制成的光敏元件。其阻值随入射光强度变化而变化--光照越强，阻值越小；光照越弱，阻值越大。光敏电阻通常由硫化镉（CdS）材料制成，其光谱响应范围（约400-700nm）与人眼视觉范围接近，适合用于简单的光照检测场景。

基本参数：

亮电阻（10lux）：5kΩ-20kΩ（视型号而定）
暗电阻：≥0.5MΩ-1MΩ
光谱峰值：540nm（绿光）
最大工作电压：150V DC
最大功耗：20-50mW
响应时间：20-30ms
工作温度：-30°C至+70°C

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
GL5516	森霸光电(SENBA)等	模拟(ADC)	亮电阻5-10kΩ, 暗电阻0.5MΩ, γ=0.5	灵敏度较高，响应快
GL5528	森霸光电(SENBA)等	模拟(ADC)	亮电阻10-20kΩ, 暗电阻1MΩ, γ=0.6	最常见型号，通用性强

型号对比分析：

GL5516：亮电阻较小(5-10kΩ)，适合需要较高灵敏度的场景，响应时间30ms
GL5528：亮电阻适中(10-20kΩ)，应用最广泛，分压电阻通常选10kΩ，响应时间30ms
两者均为CdS硫化镉材料，光谱峰值540nm，工作温度-30\~+70°C
均为模拟输出，需配合ADC读取，成本极低

要点3：应用场景

1. 路灯自动控制：检测环境光照自动开关路灯

2. 夜灯/小夜灯：天黑自动点亮，天亮自动熄灭

3. 智能窗帘控制：根据光照强度自动开合窗帘

4. 相机自动测光：简单的光照强度参考

5. 光控报警器：光线被遮挡时触发报警

6. 电子玩具光控开关：低成本光控功能实现

要点4：硬件接口设计

光敏电阻使用ADC（模数转换）接口，通过分压电路将阻值变化转换为电压变化。

分压电路接线图：

AirXXXX模组              GL5528光敏电阻
  ┌──────────┐            ┌──────────┐
  │      3.3V│────┬───────│  GL5528  │
  │          │    │       │ (光敏电阻)│
  │   ADC_CHX│────┼───────│          │
  │          │    │       └──────────┘
  │       GND│────┼──┐
  │          │   10kΩ│
  │          │    │  │
  │          │    └──┘ (固定分压电阻)
  └──────────┘

注意事项：

分压电阻阻值应与光敏电阻在目标光照下的阻值接近，通常选10kΩ
GL5528亮电阻约10-20kΩ，暗电阻约1MΩ
光敏电阻无极性，两引脚可互换
ADC输入阻抗较高，分压电路不会影响光敏电阻工作
避免长时间暴露在强紫外线或高温环境中，以免加速老化

要点5：工作原理

光敏电阻工作原理（光电导效应）：

光敏电阻由硫化镉（CdS）半导体材料制成。在黑暗环境中，CdS材料中的载流子浓度很低，电阻值很大（可达兆欧级）。当有光照时，光子能量激发价带中的电子跃迁到导带，产生自由电子-空穴对，使载流子浓度增加，电阻值显著下降。光照越强，产生的载流子越多，电阻越小。

信号转换链路：

入射光 -> CdS半导体材料（光电导效应） -> 阻值变化 -> 分压电路（电压变化） -> ADC采样 -> 数字值 -> 主控设备（例如合宙AirXXXX模组）判断光照等级

光敏电阻的阻值与光照强度呈非线性关系，通常用γ值（对数斜率）来描述其灵敏度特性：γ = lg(R10/R100) / lg(100/10)，其中R10和R100分别为10lux和100lux下的阻值。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别8：空气质量传感器

要点1：什么是空气质量传感器

空气质量传感器是一种用于检测空气中颗粒物（如PM1.0、PM2.5、PM10）浓度的传感器器件。本类别主要指基于激光散射原理的粉尘颗粒物传感器，能够定量测量空气中不同粒径颗粒物的质量浓度，是空气质量和环境污染监测的核心器件。

基本参数：

检测粒径范围：0.3\~10μm
有效量程：0\~1000 μg/m³
检测精度：±15μg/m³（0-100μg/m³范围）
响应时间：T90 \< 30s
输出类型：UART数字信号 / PWM

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
ZH07	炜盛科技(Winsen)	UART_TTL/PWM	0.3-10μm, 0-1000μg/m³, 5V供电	激光散射，小型化，支持PM1.0/2.5/10
GXHD40AD	国内厂商	UART/模拟	甲醛/空气质量检测	电化学/半导体原理，HCHO检测

型号对比分析：

- ZH07：炜盛科技出品的通用型激光粉尘传感器，检测范围0.3-10μm，支持PM1.0/PM2.5/PM10三档输出，同时提供UART和PWM两种输出方式。工作电压4.8-5.5V，工作电流\<120mA，外形尺寸仅48×40×12.5mm，适合集成到各类空气检测设备中。上电稳定时间30秒，MTTF>10000小时

- GXHD40AD：面向甲醛等有害气体的空气质量检测器件，支持多种输出模式

要点3：应用场景

1. 空气净化器：实时监测PM2.5浓度，自动调节净化器风量

2. 新风系统：根据室内外空气质量自动控制换气策略

3. 便携式空气质量检测仪：手持式PM2.5检测设备

4. 室内空气质量监测仪：办公室、学校、医院等场所空气质量监测

5. 空调系统：空调设备集成空气质量检测功能

6. 智慧城市环境监测站：城市网格化空气质量监测节点

要点4：硬件接口设计

空气质量传感器主要使用UART串口接口。

UART接口接线图（以ZH07为例）：

AirXXXX模组              ZH07传感器
  ┌──────────┐            ┌──────────┐
  │      5V  │────────────│VDD (PIN1)│  注意:ZH07需要5V供电
  │       GND│────────────│GND (PIN2)│
  │  UART_TX │────────────│RXD (PIN4)│  模组TX -> 传感器RX
  │  UART_RX │────────────│TXD (PIN5)│  模组RX <- 传感器TX
  │          │            │SET (PIN3)│──悬空(正常工作)
  │          │            │PWM (PIN7)│──可选PWM输出
  └──────────┘            └──────────┘

注意事项：

ZH07工作电压为4.8-5.5V，需要5V电源供电，不能直接用3.3V
UART通信电平为3.3V TTL，与AirXXXX模组直接兼容
串口参数：波特率9600，8数据位，1停止位，无校验
传感器上电后需要30秒稳定时间，期间数据可能不准确
传感器进气口应保持通畅，避免强气流直吹
安装时避免震动和灰尘堵塞气道

要点5：工作原理

激光散射原理（ZH07）：

ZH07采用激光散射法测量颗粒物浓度。其工作过程为：内部激光二极管发出一束聚焦光照射通过气室的空气样本，空气中的颗粒物在激光束中产生光散射现象。散射光强度与颗粒物的大小和数量相关。光电探测器在特定角度（通常为90°）接收散射光信号，将其转换为电脉冲。内部主控设备（例如合宙AirXXXX模组）对脉冲信号进行计数和分析，通过米氏散射理论算法计算出不同粒径范围（PM1.0/PM2.5/PM10）的颗粒物质量浓度。

信号转换链路：

空气样本 -> 激光照射 -> 颗粒物散射光 -> 光电探测器（光电流） -> 信号放大 -> 脉冲计数 -> 米氏散射算法计算 -> UART/PWM输出浓度值

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别9：VOC传感器

要点1：什么是VOC传感器

VOC（Volatile Organic Compounds，挥发性有机化合物）传感器是一种用于检测空气中挥发性有机化合物浓度的气体传感器。VOC包括甲醛、苯、甲苯、乙醇、丙酮等多种有机气体，这些气体在室内环境中来源广泛（建材、家具、装修材料、清洁用品等），长期暴露会对人体健康造成危害。

VOC传感器通常输出数字信号（I2C/UART接口），可直接输出浓度值（单位通常为ppb或μg/m³）。测量范围一般为0-60000ppb，分辨率可达1ppb。

要点2：常见型号与特点

型号	生产厂商	通信接口	测量范围	工作电压	特点
MC1081L	攀藤科技（PANTERRA）	UART	0-60000ppb	3.3V	MEMS工艺，响应快（\<10s），寿命>10年，低功耗

MC1081L 采用MEMS微机电系统工艺制造的金属氧化物半导体（MOS）气体传感器，具有高灵敏度、快速响应和长寿命特点。输出数据包含VOC浓度、温度、湿度等信息。

要点3：应用场景

- 室内空气质量监测：家庭、办公室、学校等室内VOC浓度监测

- 新风系统控制：根据VOC浓度自动调节新风量

- 空气净化器：联动空气净化器启停

- 环境监测站：城市环境空气质量监测节点

- 工业安全：化工厂、印刷厂等工业环境VOC泄漏监测

- 智慧建筑：楼宇自动化系统中的空气质量管理

要点4：硬件接口设计

MC1081L通常使用UART接口通信：

合宙模组                 VOC传感器
+-------+              +--------+
|  3.3V |-------------| VCC    |
|  GND  |-------------| GND    |
|  TX   |-------------| RX     |
|  RX   |-------------| TX     |
+-------+              +--------+

注意事项：

传感器需要预热，首次上电后建议等待1-3分钟再读取数据
传感器工作时有一定发热，避免紧贴温度敏感元件
UART通信波特率通常为9600或115200（具体参考传感器规格书）
建议在VCC和GND之间并联100nF去耦电容

要点5：工作原理

MC1081L采用MEMS MOS（金属氧化物半导体）气体传感技术：

1. 敏感材料：传感器内部有一层金属氧化物半导体材料（如SnO₂），加热到工作温度（通常200-400°C）

2. 气体吸附：当VOC气体分子接触敏感材料表面时，会发生化学吸附反应

3. 阻值变化：吸附反应导致半导体材料的电阻值发生变化，VOC浓度越高，阻值变化越大

4. 信号转换：内部ADC将阻值变化转换为数字信号，经过温度补偿和校准算法后输出VOC浓度值

5. 数据输出：通过UART/I2C接口输出包含VOC浓度、温度、湿度等信息的数字数据帧

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别10：甲醛传感器

要点1：什么是甲醛传感器

甲醛传感器是一种用于检测空气中甲醛（CH₂O / HCHO）浓度的气体传感器。甲醛是一种无色但有强烈刺激性气味的有毒气体，被世界卫生组织列为一类致癌物，广泛存在于新装修房屋的板材、家具、涂料及纺织品中。

甲醛传感器的主要功能是将空气中甲醛浓度转化为可量化的电信号或数字数据输出，核心测量参数包括：

- 测量范围：典型量程 0～5 ppm（毫克每立方米级别）

- 分辨率：≤0.01 ppm

- 输出类型：UART 数字输出、模拟电压（DAC）、PWM 波形

- 响应时间：≤60 秒

- 工作寿命：约 5 年（洁净空气环境）

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
ZE08G-CH₂O	汉威科技（Winsen）	UART（3V TTL）/ DAC / PWM	量程 0～5ppm，分辨率 0.01ppm，工作电压 3.7～5.5V，寿命 5 年	电化学原理，高灵敏度，内置温度补偿，抗干扰能力强
ZE08-CH₂O	汉威科技（Winsen）	UART / DAC / PWM	量程 0～5ppm，分辨率 0.01ppm，预热 ≤3 分钟	通用型模组，成熟电化学技术，线性输出
ZE08B-CH₂O	汉威科技（Winsen）	UART / DAC	量程 0～1.6ppm，分辨率 0.01ppm	适合室内低浓度检测，抗湿度干扰能力更强

要点3：应用场景

1. 室内空气质量监测：新装修房屋、办公室、学校的甲醛浓度实时监测

2. 空气净化器联动：根据甲醛浓度自动控制空气净化器启停

3. 新风换气系统：联动新风系统调节换气量

4. 便携式甲醛检测仪：手持式个人健康防护设备

5. 智能家居：集成到全屋空气环境管理平台

6. 车载空气质量监测：车内甲醛及 VOC 检测

要点4：硬件接口设计

甲醛传感器 ZE08G-CH₂O 主要使用 UART 通信接口输出数字浓度数据，也可使用 DAC 模拟电压输出。

通信接口：UART（3V TTL 电平，波特率 9600）

  AirXXXX模组                ZE08G-CH2O
  +----------+             +-----------+
  |          |             |           |
  |  3.3V <--|------------>| VCC       |
  |  GND ----|------------>| GND       |
  |  RX  <---|<------------| TXD       |
  |  TX  --->|------------>| RXD       |
  |          |             |           |
  +----------+             +-----------+

注意事项：

ZE08G-CH₂O 工作电压为 3.7～5.5V
UART 电平为 3V TTL
传感器预热时间约 3 分钟，预热期间数据不稳定，软件需做预热等待处理
传感器应避免接触有机溶剂、涂料等高浓度气体，以免损坏敏感元件
建议在传感器电源端加 100nF 去耦电容

要点5：工作原理

ZE08G-CH₂O 采用电化学检测原理。传感器内部包含一个由工作电极、对电极和参比电极组成的三电极电化学电池。当空气中甲醛分子通过透气膜扩散进入传感器内部时，在工作电极表面发生电化学氧化反应：

$CH_2O + H_2O \rightarrow CO_2 + 4H^+ + 4e^-$

氧化反应产生的电子在外电路中形成与甲醛浓度成正比的微弱电流信号。该电流经内部低噪声放大器放大、模数转换后，由主控设备（例如合宙AirXXXX模组）进行温度补偿和线性化处理，最终通过 UART 接口输出浓度值（单位 ppm）。

电化学传感器的优势在于：高选择性（对甲醛有较好的选择性响应）、低功耗、线性输出好、分辨率高。传感器内部集成了温度传感器，用于实时温度补偿，保证在不同环境温度下测量精度。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别11：颗粒物传感器

要点1：什么是颗粒物传感器

颗粒物传感器是一种用于检测空气中悬浮颗粒物浓度的传感器。此处介绍的 ADPD188BI 是一款基于光学双波长技术的烟雾检测集成光学模块，通过蓝光 LED 和红外 LED 双光源照射，利用光散射原理检测颗粒物的浓度和类型，能够区分不同粒径和材质的烟雾颗粒。

核心测量参数包括：

- 检测对象：烟雾颗粒（纸张燃烧、木材燃烧、阴燃烟雾、烹饪油烟、灰尘等）

- ADC 精度：14 位，配合 20 位突发累加器，单次数据读取最高可达 27 位

- 输出类型：I2C / SPI 数字接口

- LED 驱动：3 路独立 370mA LED 驱动器

- 模块尺寸：3.8mm × 5.0mm × 0.9mm

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
ADPD188BI	Analog Devices（ADI）	I2C（地址 0x64）/ SPI	1 蓝光 LED + 1 红外 LED + 2 光电二极管，14 位 ADC，1.8V 接口	双波长技术区分烟雾类型，高 SNR，低功耗，通过 UL217 和 CCCF 认证
ADPD105/107	Analog Devices（ADI）	I2C / SPI	3 个 LED 驱动，20 位累加器	通用光度测量前端，适合自定义光学检测方案
PMS5003	攀藤（Plantower）	UART	PM1.0/2.5/10，量程 0～1000μg/m³	激光散射原理，通用颗粒物检测，成本低

要点3：应用场景

1. 智能烟雾报警器：住宅、商业建筑的高精度烟雾探测，减少误报

2. 工业消防安全：工厂、仓库的早期烟雾预警

3. 空气净化器：检测空气中的颗粒物浓度，联动净化

4. 环境空气质量监测站：区分灰尘、水汽和真实烟雾

5. 物联网消防终端：NB-IoT / LoRa 无线烟感报警节点

要点4：硬件接口设计

ADPD188BI 支持 I2C 和 SPI 两种通信接口（同一时间只能使用其一）。使用 I2C 接口时，须将 CS 引脚拉高禁用 SPI；使用 SPI 时，须将 SDA、SCL 拉至 1.8V 禁用 I2C。

通信接口：I2C（1.8V 电平，地址 0x64）

  AirXXXX模组         ADPD188BI
  +----------+             +-----------+
  |          |             |           |
  | 1.8V LDO |<-- 电平转换--| VDD1/VDD2 |
  |  SCL  ---|--- 4.7kohm --| SCL       |
  |  SDA  ---|--- 4.7kohm --| SDA       |
  |  GPIO -->|------------>| CS (拉高)  |
  |  GND ----|------------>| GND       |
  |          |             |           |
  +----------+             +-----------+
  注意：ADPD188BI 为 1.8V 接口，需电平转换！

注意事项：

- ADPD188BI 的数字接口为 1.8V 电平，合宙模组 GPIO 如果为 3.3V，必须使用电平转换器（如 TXS0108E、PCA9306）

I2C 总线需接 4.7kΩ 上拉电阻至 1.8V
使用 I2C 时 CS 引脚必须拉高至 1.8V 以禁用 SPI
VDD1、VDD2 供电端应就近放置 100nF 陶瓷去耦电容
VREF 引脚需就近放置 1.0μF 陶瓷电容
VLEDx 供电需独立的稳压电路
AGND、DGND、LGND 应连接到同一接地层

要点5：工作原理

ADPD188BI 基于光学双波长散射原理工作。模块内部集成了一个蓝色 LED（典型波长 470nm）和一个红外 LED（典型波长 850nm），以及两个光电二极管探测器。

工作流程如下：

1. LED 脉冲发射：主控设备（例如合宙AirXXXX模组）通过 I2C 配置寄存器后，LED 驱动器以脉冲方式交替点亮蓝色 LED 和红外 LED，每次脉冲持续微秒级

2. 光散射检测：LED 发出的光进入烟雾检测腔，当腔内存在烟雾颗粒时，光被颗粒散射，部分散射光被光电二极管接收

3. 信号调理：光电二极管产生的微弱电流经跨阻放大器（TIA）转换为电压，再经带通滤波器（BPF）和积分器处理

4. 模数转换：14 位 ADC 对信号进行数字化采样，20 位突发累加器在多个采样周期内累加，提高信噪比

5. 双波长比值分析：蓝光和红外光对同一颗粒产生的散射信号比值不同，通过比值分析可区分烟雾类型（如阴燃烟雾 vs 烹饪油烟 vs 灰尘）

6. 环境光抑制：模拟前端具有同步检测功能，能有效抑制环境光干扰

ADPD188BI 有三种工作模式：待机模式（省电，寄存器值保留）、编程模式（配置寄存器）、正常采样模式（LED 脉冲发射并采集数据）。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别12：CO2传感器

要点1：什么是CO2传感器

CO₂传感器是一种用于检测空气中或水中二氧化碳（CO₂）浓度的气体传感器。CO₂是无色无味气体，正常大气中浓度约 400ppm，当室内浓度超过 1000ppm 时人会感到不适，超过 5000ppm 时可能危害健康。在农业温室、养殖、工业安全等场景中，CO₂浓度监测至关重要。

核心测量参数包括：

- 测量范围：0～5000ppm（典型），部分型号可达 0～10000ppm 或更高

- 精度：±50ppm ±5%读数（典型）

- 输出类型：UART、RS485（Modbus-RTU）、I2C、4-20mA、PWM

- 响应时间：T90 \< 30 秒

- 工作原理：NDIR（非色散红外）吸收法

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
FCCO5000	—	UART / RS485	量程 0～5000ppm，NDIR 原理，精度 ±50ppm	NDIR 双波长光路，温度补偿，无氧气依赖性，寿命长
KWS-5000	Kacise（科赛）	RS485 / I2C / 4-20mA / PWM	量程 0～2000/5000/10000ppm，IP68 防护	水中溶解 CO₂ 检测，NDIR 原理，防水透气结构
S8	Senseair（旭化成旗下）	UART	量程 0～5000ppm，精度 ±40ppm，功耗 \<40mW	超小尺寸，低功耗，适合电池供电
MH-Z19B	汉威科技（Winsen）	UART / PWM	量程 0～5000ppm，精度 ±50ppm	NDIR 原理，内置温度补偿，广泛用于室内空气监测

要点3：应用场景

1. 室内空气质量监测：办公室、教室、商场、住宅的 CO₂ 浓度监控与通风联动

2. 农业温室：监测温室 CO₂ 浓度，联动气肥补给系统提升作物产量

3. 水产养殖：监测水体溶解 CO₂ 浓度，保障水生生物生长环境

4. 工业安全：煤矿、隧道、发酵车间的 CO₂ 浓度安全预警

5. 汽车座舱空气管理：根据车内 CO₂ 浓度自动调节空调换气量

6. 冷链仓储：果蔬保鲜库的呼吸作用 CO₂ 监测

要点4：硬件接口设计

CO₂ 传感器通常使用 UART 通信接口（如 FCCO5000、MH-Z19B 等），部分工业型使用 RS485 Modbus-RTU 协议。

通信接口：UART（3.3V/5V TTL 电平，波特率 9600）

   AirXXXX模组         FCCO5000 / MH-Z19B
  +----------+             +-----------+
  |          |             |           |
  |  5V  ----|------------>| VCC       |
  |  GND ----|------------>| GND       |
  |  RX  <---|<------------| TXD       |
  |  TX  --->|------------>| RXD       |
  |          |             |           |
  +----------+             +-----------+

注意事项：

NDIR CO₂ 传感器工作电流较大（峰值可达 150mA），需确保供电能力充足
传感器需要预热稳定时间（约 30 秒至 3 分钟），预热期间数据不准确
UART 电平多数为 3.3V/5V TTL，与合宙模组 GPIO 电平兼容
传感器应避免直接阳光照射和强气流干扰
建议在电源端加 10μF + 100nF 滤波电容

要点5：工作原理

NDIR（Non-Dispersive Infrared，非色散红外）是 CO₂ 传感器最常用的检测原理，基于气体对特定红外波长的选择性吸收特性。

CO₂ 气体在 4.26μm 波长处有强烈的红外吸收峰。NDIR 传感器的工作流程如下：

1. 红外光源发射：红外 LED 或微型灯泡发出宽带红外光，经抛物面反射镜形成平行光束

2. 气室扩散：被测气体通过透气膜扩散进入气室，红外光穿过气室中的气体

3. 选择性吸收：CO₂ 分子吸收 4.26μm 波长的红外光，吸收程度遵循朗伯-比尔定律：$I = I_0 \cdot e^{-\alpha \cdot c \cdot L}$，其中 $I_0$ 为入射光强，$\alpha$ 为吸收系数，$c$ 为气体浓度，$L$ 为光程

4. 双通道检测：红外光经窄带滤光片后分别到达测量通道（4.26μm，CO₂ 吸收波长）和参考通道（3.9μm，无吸收波长），双通道比值可消除光源老化、温度漂移等影响

5. 信号处理：热电堆或光声探测器将红外光强转换为电信号，经放大、ADC 采样后由主控设备（例如合宙AirXXXX模组）进行温度补偿和浓度计算

NDIR 原理的优势：高精度、高选择性、无氧气依赖性、无催化中毒问题、寿命长（>10 年）。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别13：有毒气体传感器

要点1：什么是有毒气体传感器

有毒气体传感器是一类用于检测空气中各种有害气体浓度的传感器，涵盖可燃气体、一氧化碳、酒精、液化气、天然气等。MQ 系列半导体气体传感器是市面上最常见的低成本气体传感器，采用二氧化锡（SnO₂）半导体气敏材料，当接触目标气体时电导率发生变化，从而实现气体浓度检测。

核心测量参数包括：

- 检测气体：可燃气体（LPG、甲烷、丙烷）、一氧化碳、酒精、VOC 等

- 测量范围：ppm 级别（如 CO：10～500ppm，LPG：300～10000ppm）

- 输出类型：模拟电压（AO）+ 数字阈值输出（DO）

- 工作电压：5V（加热电压）

- 加热功耗：约 150mA × 5V = 750mW

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
MQ-2	汉威科技（Winsen）	ADC（模拟电压）/ GPIO（数字阈值）	检测：烟雾、液化气、丙烷、氢气；量程：300～5000ppm（丙烷）	通用可燃气体检测，灵敏度高，成本低
MQ-3	汉威科技（Winsen）	ADC / GPIO	检测：酒精蒸汽；量程：0.05～10mg/L	酒精检测专用，适合呼气式酒精检测仪
MQ-5	汉威科技（Winsen）	ADC / GPIO	检测：液化气、天然气、城市煤气；量程：200～10000ppm	多种燃气检测，灵敏度可调
MQ-6	汉威科技（Winsen）	ADC / GPIO	检测：液化气、丙烷、丁烷；量程：300～10000ppm	对 LPG 灵敏度高，寿命 10 年
MQ-7	汉威科技（Winsen）	ADC / GPIO	检测：一氧化碳；量程：10～500ppm	CO 专用检测，需高低压交替加热
MQ-135	汉威科技（Winsen）	ADC / GPIO	检测：NH₃、NOx、苯、VOC、烟雾；量程：10～1000ppm	空气质量综合检测，净化器联动

要点3：应用场景

1. 家用燃气泄漏报警器：检测液化气、天然气泄漏，触发声光报警

2. 一氧化碳报警器：家庭、车库的 CO 中毒预防

3. 酒精检测仪：交通执法、工厂安全酒精筛查

4. 空气质量监测仪：室内 VOC 和有害气体综合监测

5. 工业安全监测：化工、矿井等场所的有害气体泄漏预警

6. 空气净化器联动：根据空气质量自动控制净化器

要点4：硬件接口设计

MQ 系列传感器使用 ADC 模拟电压输出和 GPIO 数字阈值输出两种接口。

通信接口：ADC（模拟输出 AO）+ GPIO（数字阈值输出 DO）

AirXXXX模组         MQ 系列传感器模块
  +----------+             +-----------+
  |          |             |           |
  |  5V  ----|------------>| VCC       |
  |  GND ----|------------>| GND       |
  |  ADC0<---|<------------| AO (模拟) |
  |  GPIO<---|<------------| DO (数字) |
  |          |             |           |
  +----------+             +-----------+
  模块上的电位器可调节 DO 阈值

注意事项：

- MQ 传感器需要 5V 加热供电，加热电流约 150mA，合宙模组 3.3V 供电无法直接驱动，需外部 5V 电源

- 传感器需要预热（不少于 24～48 小时首次使用，日常使用预热数分钟）才能稳定工作

- 模拟输出 AO 电压范围 0～5V，超过合宙模组 ADC 的 3.3V 量程，需使用电阻分压（如 2:1 分压）将 5V 降至 3.3V 以内

使用 adc.setRange(adc.ADC_RANGE_MAX) 设置 ADC 量程为 0～3.3V
数字输出 DO 可直接连接 GPIO，模块上电位器可调节阈值
传感器工作时表面温度较高，应远离易燃物

要点5：工作原理

MQ 系列传感器基于金属氧化物半导体（MOS）气敏原理工作。

敏感材料为二氧化锡（SnO₂），在清洁空气中其电导率较低。传感器内部有一个加热电阻（约 26Ω），将 SnO₂ 敏感层加热至约 300°C 的工作温度。当目标气体接触加热后的 SnO₂ 表面时，发生以下过程：

1. 氧吸附：在加热温度下，空气中的氧分子吸附在 SnO₂ 表面，捕获导带电子形成 O⁻、O²⁻ 等吸附氧种，使敏感层电阻升高

2. 气体反应：当还原性气体（如 CO、H₂、酒精蒸汽等）接触表面时，与吸附氧发生氧化反应，释放被捕获的电子回导带

3. 电导率变化：电子回归导带导致 SnO₂ 电导率增大（电阻降低），变化量与气体浓度呈对数关系

4. 信号输出：通过分压电路将电阻变化转换为电压信号输出

MQ-7（一氧化碳）采用交替加热方式：5.0V 高温加热（60 秒）用于清除其他气体干扰，1.4V 低温加热（90 秒）用于 CO 检测，循环工作以提高选择性。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别14：土壤传感器

要点1：什么是土壤传感器

土壤传感器是一类用于检测土壤物理和化学参数的传感器，可测量土壤温度、湿度（含水量）、电导率（EC）、pH 值以及氮磷钾（NPK）养分含量等指标。现代多参数土壤传感器通常集成多种检测功能于一体，通过 RS485 Modbus-RTU 协议统一输出数据。

核心测量参数包括：

- 土壤温度：-40～80°C，精度 ±0.5°C

- 土壤湿度：0～100%RH（体积含水率），精度 ±3%

- 电导率（EC）：0～20000μS/cm，精度 ±3%

- pH 值：3～9 pH，精度 ±0.3pH

- 氮磷钾（NPK）：0～1999 mg/kg，精度 ±2%FS

- 输出类型：RS485（Modbus-RTU）、4-20mA、0-5V 模拟量

- 防护等级：IP68（可长期埋设于土壤中）

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
RS485 土壤四合一（SEN0604）	DFRobot	RS485（Modbus-RTU）	温度/湿度/EC/pH，DC5-30V，IP68	4 合 1 集成，316 不锈钢探针，自动温度补偿
USR-SSO10	有人物联网（PUSR）	RS485（Modbus-RTU）	温度/湿度/EC/pH/NPK，DC12-24V，IP68	5 合 1 多参数，环氧树脂真空封装，5m 线缆
TTE-SOIL	Trathielec	RS485 / 4-20mA / 0-5V	温度/湿度/EC/pH/NPK，DC4.5-30V，IP68	多输出可选，长期稳定性好
电容式土壤湿度传感器	通用	ADC（模拟电压）	湿度 0～100%，DC3.3-5V	FDR 原理，低成本，无电解腐蚀，适合简单湿度检测

要点3：应用场景

1. 智慧农业灌溉：根据土壤湿度自动控制灌溉系统，实现精准节水灌溉

2. 温室大棚管理：监测土壤温湿度和 EC/pH，优化作物生长环境

3. 水肥一体化：联动 NPK 传感器和施肥系统，实现精准施肥

4. 园艺花卉：盆栽植物土壤环境监测与自动浇水

5. 草坪牧场：大面积草地土壤墒情监测

6. 科研实验：土壤学、农学研究的数据采集

要点4：硬件接口设计

多参数土壤传感器主要使用 RS485（Modbus-RTU） 通信接口，需要通过 TTL 转 RS485 模块连接合宙模组的 UART。

通信接口：RS485（经 TTL 转 485 芯片连接 UART）

AirXXXX模组           TTL转RS485模块       土壤传感器
  +----------+        +----------+        +-----------+
  |          |        |          |        |           |
  |  TX  --->|------->| DI       |  A+ <--| Yellow    |
  |  RX  <---|<-------| RO       |  B- <--| Blue      |
  |  GPIO--->|------->| DE/RE    |        |           |
  |   3.3V---|--------| VCC      |  VCC<--| Brown/Red |
  |   GND ---|--------| GND      |  GND<--| Black     |
  |          |        |          |        |           |
  +----------+        +----------+        +-----------+
  DE/RE 共接，GPIO 控制收发方向

注意事项：

RS485 传感器供电通常为 DC5-30V，合宙模组 3.3V 无法直接供电，需外部电源
RS485 A/B 线不可接反，A 接 A（黄线），B 接 B（蓝线）
TTL 转 RS485 模块的 DE/RE 引脚需共接，由 GPIO 控制收发方向（发送时拉高，接收时拉低）
RS485 总线两端应加 120Ω 终端电阻
传感器探针插入土壤时避免接触石块等硬物，以免损坏探针
电容式土壤湿度传感器（模拟输出型）可直接接 ADC，无需 RS485

要点5：工作原理

多参数土壤传感器内部集成了多种检测原理：

1. 土壤温度：采用热敏电阻或 PT100 铂电阻测温。不锈钢探针内部封装温度传感器，通过金属探针的热传导感知土壤温度，经 ADC 采样后输出数字值

2. 土壤湿度：采用 FDR（频域反射法，Frequency Domain Reflectometry） 原理。探针作为电容的两个电极，土壤作为电介质。土壤含水量变化导致介电常数变化（水的介电常数约 80，干燥土壤约 3-5），从而改变探针等效电容。高频信号通过该电容时，振荡频率随含水率变化，通过测量频率变化计算体积含水率

3. 电导率（EC）：采用交流电桥法。两电极间施加交流电压，测量电流计算电阻，进而换算电导率。使用交流信号可避免极化效应。传感器内置温度补偿算法，将 EC 值校正至 25°C 标准温度

4. pH 值：采用玻璃电极法。pH 电极由测量电极（玻璃膜）和参比电极（Ag/AgCl）组成。玻璃膜两侧的氢离子浓度差产生能斯特电压：$E = E_0 - \frac{2.303RT}{F} \cdot pH$，经高阻抗放大器处理后输出

5. 氮磷钾（NPK）：采用离子选择性电极法。通过特定离子选择性膜分别对 NH₄⁺（氮）、H₂PO₄⁻（磷）、K⁺（钾）离子产生响应电位，经多路切换和信号处理后输出各养分浓度。注意 NPK 测量为快速估算，精度有限

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别15：水质传感器

要点1：什么是水质传感器

水质传感器是一类用于检测水体物理和化学参数的传感器，可测量水的 pH 值、溶解性总固体（TDS）、溶解氧（DO）、浊度等关键指标。这些参数直接反映水质状况，对于饮用水安全、水产养殖、环境监测和工业水处理至关重要。

核心测量参数包括：

- pH 值：0～14 pH，精度 ±0.1pH

- TDS（溶解性总固体）：0～1000ppm，精度 ±2%FS

- DO（溶解氧）：0～20mg/L，精度 ±0.5mg/L

- 浊度：0～1000NTU，精度 ±5%

- 输出类型：模拟电压（0～5V / 0～3.3V）、RS485

- 电极类型：玻璃复合电极（pH）、铂电极（TDS/EC）、Clark 电极（DO）

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
E-201-C（pH）	通用（配信号转换板）	ADC（模拟电压 0～5V）	量程 0～14pH，精度 ±0.1pH，BNC 接口	玻璃复合电极，成本低，需定期校准，配合信号板输出模拟电压
TDS Sensor V1.0	DFRobot	ADC（模拟电压 0～3.3V）	量程 0～1000ppm，精度 ±2%FS，DC3.3-5V	铂电极，温度补偿，兼容 Arduino，即插即用
DO 溶解氧传感器	通用（配信号转换板）	ADC（模拟电压）	量程 0～20mg/L，精度 ±0.5mg/L	Clark 原理原电池法，需定期更换电解液和膜片
浊度传感器（TSW-30）	通用	ADC（模拟电压 0～4.5V）	量程 0～1000NTU，工作温度 0～50°C	光散射原理，90°散射光检测，防水探头

要点3：应用场景

1. 水产养殖：监测 pH、DO、温度，保障鱼虾生长环境，缺氧预警

2. 饮用水安全：自来水、净水器的 pH 和 TDS 在线监测

3. 游泳池水质：pH 和余氯/浊度监测，自动投药

4. 环境水质监测：河流、湖泊、水库的水质在线监测站

5. 实验室分析：化学实验和科研中的精确水质测量

6. 工业水处理：污水处理过程中的 pH/ORP 联动控制

要点4：硬件接口设计

水质传感器主要使用 ADC 模拟电压输出，部分集成型传感器使用 RS485。模拟输出型传感器通过信号转换板将电极信号转换为 0～5V 或 0～3.3V 模拟电压。

通信接口：ADC（模拟电压输出）

  AirXXXX模组           pH信号转换板         E-201-C pH电极
  +----------+          +----------+        +-----------+
  |          |          |          |        |           |
  |  5V  ----|--------->| VCC      |  BNC<--| 玻璃电极  |
  |  GND ----|--------->| GND      |  BNC<--| 参比电极  |
  |  ADC0<---|<---------| PO (OUT) |        |           |
  |          |          |          |        |           |
  +----------+          +----------+        +-----------+

  TDS Sensor V1.0:
  AirXXXX模组 ADC1 <--> TDS AO (模拟输出 0~3.3V)
  AirXXXX模组 3.3V  <--> TDS VCC
  AirXXXX模组 GND   <--> TDS GND

注意事项：

- pH 信号转换板输出 0～5V 模拟电压，超过合宙模组 ADC 的 3.3V 量程，需电阻分压（2:1）

TDS Sensor V1.0 输出 0～3.3V，可直接接入合宙模组 ADC
pH 电极使用 BNC 接口，信号为高阻抗（>250MΩ），不可长距离传输，信号板应尽量靠近电极
pH 电极需定期用标准缓冲液（pH 4.0/7.0/10.0）校准
pH 电极不使用时应保存在 3mol/L KCl 溶液中，不可干放
水质传感器探头需定期清洁，避免生物附着影响测量
ADC 接线需注意模拟地与数字地分离，减少干扰

要点5：工作原理

各类水质传感器的工作原理各不相同：

1. pH 传感器（E-201-C）——玻璃电极法：

pH 复合电极由测量电极（玻璃膜球泡）和参比电极（Ag/AgCl）组成。玻璃膜两侧接触不同氢离子浓度的溶液时，产生能斯特电位差：

$E = E_0 - \frac{2.303 \cdot R \cdot T}{F} \cdot pH$

其中 $R$ 为气体常数，$T$ 为绝对温度，$F$ 为法拉第常数。该电压约 59.16mV/pH（25°C），经高阻抗放大器（输入阻抗 >10¹²Ω）放大后输出模拟电压。信号转换板将 pH 0～14 映射为 0～5V 电压（pH 7 对应约 2.5V）。

2. TDS 传感器——电导率法：

TDS（Total Dissolved Solids）通过测量水的电导率间接计算。两铂电极间施加交流电压，测量电流计算电导率（EC），再乘以转换系数（0.5～0.7）得到 TDS 值（ppm）。使用交流信号避免电极极化。TDS Sensor V1.0 内置温度补偿，根据水温自动修正电导率。

3. DO 溶解氧传感器——Clark 原电池法：

Clark 电极由阴极（铂/金）和阳极（银/铅）组成，覆盖透氧半透膜。水中溶解氧通过膜扩散到阴极表面，在固定极化电压下被还原：$\frac{1}{2}O_2 + H_2O + 2e^- \rightarrow 2OH^-$。产生的扩散电流与溶解氧浓度成正比。

4. 浊度传感器——光散射法：

发光二极管发出特定波长光束穿过水样，水中悬浮颗粒使光散射。90°方向的散射光强度与浊度成正比（符合 ISO 7027 标准）。光电二极管接收散射光信号并转换为电压输出。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别16：红外测温传感器

要点1：什么是红外测温传感器

红外测温传感器是一种基于红外热辐射原理进行非接触式温度测量的传感器。通过接收目标物体发射的红外辐射能量，经内部热电堆探测器和信号处理电路，计算出物体表面温度，无需物理接触即可实现快速、精确的温度测量。

核心测量参数包括：

- 测温范围：-70°C～+380°C（目标温度），-40°C～+125°C（环境温度）

- 测量精度：±0.5°C（0°C～+50°C 范围内）

- 分辨率：0.02°C

- 输出类型：SMBus/I2C 数字接口、PWM 输出

- 响应时间：取决于目标热变化率，典型 \< 1 秒

- 视场角（FOV）：35°（标准型号）

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
MLX90614ESF-ACC	Melexis（迈来芯）	SMBus/I2C（地址 0x5A）/ PWM	目标温度 -70～+380°C，精度 ±0.5°C，5V 供电，FOV 35°	出厂校准，17 位 ADC，医疗级精度版本可选，TO-39 封装
MLX90614ESF-BCC	Melexis（迈来芯）	SMBus/I2C / PWM	目标温度 -70～+380°C，精度 ±0.5°C，3V 供电，FOV 35°	3V 低电压版本，电池供电适用
MLX90615	Melexis（迈来芯）	SMBus/I2C / PWM	目标温度 -40～+115°C，精度 ±0.2°C，FOV 80°	更小尺寸，更宽视场角，适合近距离测温
MLX90640	Melexis（迈来芯）	I2C	32×24 热成像阵列，-40～+300°C	红外热成像阵列，非单点测温

要点3：应用场景

1. 人体体温筛查：公共场所（医院、学校、机场）非接触式体温检测

2. 工业设备温度监控：电机轴承、电气连接点、管道温度的在线监测

3. 智能家居：空调系统热舒适度感知、微波炉/烤箱食物温度检测

4. 汽车电子：车内空调分区温控、挡风玻璃除雾检测

5. 3D 打印：打印头和热床温度非接触监控

6. 动物体温监测：畜牧养殖中牲畜体温异常预警

要点4：硬件接口设计

MLX90614 使用 SMBus/I2C 通信接口（兼容标准 I2C 协议），也可配置为 PWM 输出模式。默认上电模式为 SMBus。

通信接口：I2C（SCL + SDA），默认地址 0x5A

AirXXXX模组         MLX90614
  +----------+             +-----------+
  |          |             |   TO-39   |
  |  3.3V ---|--- 4.7kΩ ---| VDD (3)   |
  |  SCL  ---|--- 4.7kΩ ---| SCL (1)   |
  |  SDA  ---|-------------| SDA (2)   |
  |  GND ----|-------------| VSS (4)   |
  |          |             |           |
  +----------+             +-----------+
  SCL/SDA 均需 4.7kΩ  上拉至 VDD

注意事项：

- MLX90614 的 SCL 和 SDA 均为开漏输出，必须接 4.7kΩ 上拉电阻至 VDD

3V 版本（Bxx）可直接接 3.3V，5V 版本（Axx）需 5V 供电，通信电平需电平转换
I2C 地址默认为 0x5A（7 位地址），可通过 EEPROM 修改
SMBus 协议与标准 I2C 略有差异：不支持重复起始条件（Repeated START），每次读写以独立 START-STOP 封装
VDD 端建议并联 100nF 陶瓷电容和 10μF 钽电容滤波
TO-39 金属壳的透镜方向为测量方向，需对准被测目标
被测目标应充满视场角范围，避免背景物体干扰

要点5：工作原理

MLX90614 基于红外热辐射和塞贝克效应（Seebeck Effect）工作。

1. 红外辐射接收：任何温度高于绝对零度（-273.15°C）的物体都会发射红外辐射。根据斯特藩-玻尔兹曼定律，辐射功率与物体绝对温度的四次方成正比：$P = \varepsilon \cdot \sigma \cdot T^4$。MLX90614 内部的红外滤光片（长波通滤光片，截止波长 5.5μm）仅允许 5.5～14μm 波段的红外辐射通过，对应常温物体的主要热辐射区间

2. 热电堆探测：入射红外辐射被热电堆（Thermopile）探测器接收。热电堆由多个热电偶串联组成，基于塞贝克效应：当热电偶的热端（吸收红外辐射升温）和冷端（与环境温度一致）存在温差时，产生微弱的毫伏级电压信号：$V = N \cdot \alpha \cdot \Delta T$，其中 $N$ 为热电偶对数，$\alpha$ 为塞贝克系数

3. 信号调理：热电堆输出的微弱信号（数十至数百微伏）经低噪声斩波放大器放大，消除 1/f 噪声和直流偏移。17 位 Σ-Δ 型 ADC 进行高分辨率数字化采样

4. 温度计算：MLX90614 内置的 DSP 单元（MLX90302 ASIC）同时采集热电堆信号（代表目标温度）和内部温度传感器信号（代表环境/冷端温度），利用存储在 EEPROM 中的出厂校准系数，进行环境温度补偿和线性化计算，最终输出校准后的目标温度和环境温度

5. 发射率补偿：默认发射率 ε=1.0（黑体），可通过修改 EEPROM 中的发射率寄存器（地址 0x04）适配不同表面（如金属表面 ε=0.1～0.3）

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别17：暴风雨闪电传感器

要点1：什么是暴风雨闪电传感器

暴风雨闪电传感器是一种用于检测雷电活动中闪电电磁脉冲（EMP）的专用传感器。闪电发生时会辐射出覆盖宽频段的电磁波，其中 300～500kHz 频段的信号特征最为明显。闪电传感器通过接收和分析这一频段的电磁信号，能够检测 1～40km 范围内的闪电活动，并估算闪电距离。

核心测量参数包括：

- 检测距离：1～40km，分多档输出

- 检测频段：300～500kHz（中心频率约 500kHz）

- 距离估算精度：±4km（典型）

- 输出类型：I2C / SPI 数字接口 + IRQ 中断引脚

- 工作电压：2.4～5.5V

- 功耗：60μA（监听模式）～350μA（信号验证模式）

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
AS3935	ams OSRAM（原 austriamicrosystems）	I2C（3 个可选地址）/ SPI	检测距离 1～40km，工作电压 2.4～5.5V，QFN-16 封装	内置 RF 前端 + DSP，区分自然闪电与人工干扰，天线调谐功能，低功耗
AS3935 模块版	多家第三方（如 DFRobot、Adafruit）	I2C（固定地址）	预装 LC 天线，3.3V/5V 兼容	即插即用，适合原型开发和学习
MOD-1016	olimex	I2C	基于 AS3935，预装天线	breakout 板，兼容 Arduino/树莓派

要点3：应用场景

1. 气象站边缘节点：个人/社区气象站的雷电活动监测

2. 农业物联网防雷预警：户外农业设备的雷暴预警，保护设备安全

3. 户外活动安全：高尔夫球场、体育场、露营地的雷暴预警

4. 无人机平台：无人机飞行中实时大气电活动感知，辅助避雷决策

5. 工业设备雷击风险监测：户外 LED 显示屏、通信基站的雷电防护联动

6. 智能家居：雷暴来临前自动关闭窗户、收起遮阳棚等联动控制

要点4：硬件接口设计

AS3935 支持 I2C 和 SPI 两种通信接口，同时提供 IRQ 中断引脚用于事件通知。I2C 模式下可选择 3 个不同的从机地址。

通信接口：I2C + GPIO（IRQ 中断）

   AirXXXX模组              AS3935 模块
  +----------+             +-----------+
  |          |             |           |
  |  3.3V ---|------------>| VDD       |
  |  GND ----|------------>| GND       |
  |  SCL  ---|--- 4.7kohm -| SCL       |
  |  SDA  ---|--- 4.7kohm -| SDA       |
  |  IRQ <---|<------------| IRQ       |
  |          |             | ANT(天线) |
  +----------+             +-----------+
  IRQ 需配置为下降沿中断触发

注意事项：

AS3935 工作电压 2.4～5.5V，3.3V 供电模块可直接与合宙模组连接
I2C 总线需接 4.7kΩ 上拉电阻至 VDD

- IRQ 引脚为开漏输出，需外接上拉电阻，配置为下降沿触发的外部中断

天线设计是关键：AS3935 需要外部 LC 谐振天线（典型值：150μH 电感 + 150pF 电容，并联 150kΩ 阻尼电阻），中心频率调谐至约 500kHz
天线区域 PCB 下方禁止铺铜，远离高速数字信号线和开关电源
模块版已预装天线，可直接使用
传感器应远离无线路由器、手机、电脑开关电源等强射频干扰源（至少 1 米以上）
VDD 端需放置 100nF 陶瓷去耦电容

要点5：工作原理

AS3935 是一颗专用的闪电检测 IC，其工作原理可分为三层：

1. 天线与调谐（第一层）：外部 LC 谐振回路作为接收天线，中心频率调谐至约 500kHz，这是云对地闪电回击（最强烈、最易检测的部分）辐射能量的主要频段。AS3935 内部有可编程调谐电容（0～15 步进），用于补偿 PCB 寄生电容，出厂默认 0x08。可通过内部校准程序自动调谐天线

2. 信号处理与识别（第二层）：天线接收的电磁信号进入模拟前端（AFE），经低噪声放大器（LNA）放大、带通滤波器（BPF，中心频率 500kHz，带宽约 33kHz）滤波后，由 ADC 数字化。内置 DSP 算法分析信号的强度、波形特征和持续时间：

闪电电磁脉冲持续时间极短（微秒级），峰值功率高
人工干扰源（开关电源、电机）噪声相对连续，频谱特征不同
算法通过阈值和模式匹配区分"疑似闪电事件"和"噪声事件"

3. 距离估算（第三层）：AS3935 通过统计一段时间内检测到的闪电事件能量分布，结合内部模型估算距离。输出分档距离：1km、5km、6km、8km、10km、12km、14km、17km、20km、24km、27km、31km、34km、37km、40km

AS3935 有三种工作模式：

- 省电模式：全电路断电，功耗 1μA

- 监听模式：AFE 和监听电路工作，功耗 60μA

- 信号验证模式：信号超过监听阈值后进入，全速分析，功耗 350μA

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别18：雨量传感器

要点1：什么是雨量传感器

雨量传感器是一种用于测量降水量的气象传感器，能够实时检测降雨的有无、降雨强度和累计降雨量。按照测量原理不同，常见的雨量传感器分为翻斗式、光电式和压电式三种类型。输出信号通常为脉冲信号（每翻斗一次输出一个脉冲）或数字信号（RS485/UART接口直接输出雨量数据）。测量精度通常为0.1mm\~0.2mm。

要点2：常见型号与特点

型号	生产厂商	通信接口	测量精度	测量范围	特点
翻斗式雨量计（通用）	多家国产（如上海气象仪器厂）	脉冲输出	0.2mm	0-4mm/min	机械结构，可靠性高，国家标准气象站使用
光电式雨量传感器（通用）	多家国产	脉冲/数字	0.1mm	0-10mm/min	无机械部件，响应快，维护少
压电式雨量传感器（通用）	多家国产（如威海精讯）	RS485/UART	0.1mm	0-30mm/min	压电陶瓷检测，体积小，实时监测
PR-3000-RS	威海精讯畅通	RS485	0.1mm	0-30mm/min	超声波+压电，免维护，支持MODBUS-RTU

翻斗式雨量计：最传统的雨量测量方式，雨水收集后流入翻斗，每积满一定量（通常0.2mm）翻斗翻转一次，触发脉冲输出。结构简单可靠，但存在机械磨损。

光电式雨量传感器：利用光电原理检测雨滴，当雨滴通过检测区域时遮挡光路，产生脉冲信号。响应速度快，但精度受雨滴大小影响。

压电式雨量传感器：利用压电陶瓷材料检测雨滴冲击力，将机械冲击转换为电信号。体积小、无运动部件、免维护，适合长期无人值守场景。

要点3：应用场景

- 气象观测站：降水量数据采集，天气预报

- 农业灌溉：根据降雨量自动调整灌溉策略

- 防汛预警：山区、河道、城市内涝监测

- 智慧城市：城市排水系统联动控制

- 地质灾害监测：滑坡、泥石流预警系统

- 智慧农业：大棚环境监测，雨水收集利用

要点4：硬件接口设计

翻斗式/光电式（脉冲输出）接线：

合宙模组                 雨量传感器
+-------+              +--------+
|  3.3V |-------------| VCC    |
|  GND  |-------------| GND    |
|  GPIO |-------------| PULSE  |
+-------+              +--------+

压电式（RS485输出）接线：

合宙模组                 RS485模块    雨量传感器
+-------+              +--------+   +--------+
|  3.3V |-------------| VCC    |   |        |
|  GND  |-------------| GND    |   |        |
|  TX   |-------------| DI     |   |        |
|  RX   |-------------| RO     |   |        |
|  GPIO |-------------| DE/RE  |   |        |
+-------+             | A  B   |---| A   B  |
                      +--------+   +--------+

注意事项：

脉冲输出型传感器需要使用GPIO中断方式检测脉冲，推荐使用gpio.count()计数
RS485型传感器需要外接RS485收发芯片（如MAX485），通过UART通信
翻斗式传感器的脉冲宽度约为20-50ms，需设置合适的防抖时间
传感器安装需水平，避免倾斜影响测量精度

要点5：工作原理

翻斗式雨量计原理：

1. 雨水收集：顶部漏斗收集雨水，将雨水引导至翻斗

2. 翻斗翻转：当翻斗内积水量达到设定值（如0.2mm降雨量），翻斗因重心偏移而翻转

3. 脉冲产生：翻斗翻转时，磁铁经过干簧管（或霍尔传感器），产生一个脉冲信号

4. 计数统计：主控通过GPIO中断统计脉冲数量，乘以分辨率（0.2mm/脉冲）即可得到累计降雨量

压电式雨量传感器原理：

1. 雨滴冲击：雨滴落在压电陶瓷传感面上，产生机械冲击力

2. 压电效应：压电材料将机械力转换为电荷信号

3. 信号处理：内部信号处理电路将电荷信号放大、滤波、整形

4. 雨量计算：通过冲击力大小和频率计算降雨强度和累计雨量

5. 数据输出：通过RS485/UART接口输出数字雨量数据

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

第二篇：运动与姿态传感器

类别19：加速度传感器

要点1：什么是加速度传感器

加速度传感器（Accelerometer）是一种能够测量物体线加速度的电子器件，其核心原理是检测物体在空间中三个正交轴（X、Y、Z）方向上的加速度变化。加速度包括静态加速度（如重力加速度）和动态加速度（如运动、振动、冲击产生的加速度），单位通常为 g（1g ≈ 9.8 m/s²）。

加速度传感器的主要功能包括：

测量物体在三维空间中的线性加速度
通过重力分量计算倾斜角度（俯仰角、横滚角）
检测自由落体、冲击、振动等运动事件
配合陀螺仪进行姿态解算与运动追踪
步数计数、运动激活唤醒等人机交互功能

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
LIS2DH12	STMicroelectronics（意法半导体）	I2C / SPI	±2g/±4g/±8g/±16g，12位分辨率，ODR 1Hz\~5.3kHz，功耗2µA	超低功耗"femto"系列，内置FIFO、温度传感器、自由落体检测、6D/4D方向检测
SC7A20	Silan（士兰微电子）	I2C / SPI	±2g/±4g/±8g/±16g，12位分辨率，ODR 1Hz\~400Hz，功耗2µA	国产高性价比，内置倾斜校准、FIFO、自测试功能，LGA-12 2×2mm封装
KXTJ3-1057	Rohm / Kionix	I2C	±2g/±4g/±8g/±16g，8/12/14位分辨率，噪声150µg/√Hz	小封装（2×2×0.9mm），低噪声，支持唤醒功能，高分辨率
ADXL345	Analog Devices（亚德诺半导体）	I2C / SPI	±2g/±4g/±8g/±16g，13位分辨率，4mg/LSB，功耗23µA	高分辨率，32级FIFO，单击/双击检测，活动/静止监测，10000g抗冲击
ADXL346	Analog Devices	I2C / SPI	±2g/±4g/±8g/±16g，13位分辨率，1.7\~2.75V	超低电压版ADXL345，支持4/6方向位置检测，适合低电压移动设备
SCMA800	Silan（士兰微电子）	I2C / SPI	±2g/±4g/±8g/±16g，12位分辨率	国产加速度传感器，兼容主流寄存器协议，适用于消费电子及工业应用
SCA800	Murata（村田制作所）	SPI	±2g，单轴，3.3V，-40\~+125°C	车规级AEC-Q100认证，3D MEMS技术，高稳定性，用于汽车安全系统

要点3：应用场景

1. 手机与平板：屏幕自动旋转、运动计步、手势识别

2. 可穿戴设备：手环步数统计、睡眠监测、跌倒检测

3. 无人机与机器人：姿态稳定控制、加速度反馈

4. 汽车电子：电子驻车制动（EPB）、坡道起步辅助、翻滚检测

5. 工业监测：设备振动分析、倾斜报警、结构健康监测

6. 游戏与VR：体感操作、运动追踪

要点4：硬件接口设计

通信接口：大多数加速度传感器支持 I2C 或 SPI 数字接口。I2C 适合短距离、少引脚的场合；SPI 适合高速数据采集。

ASCII 接线图（以 LIS2DH12 为例，I2C 模式）：

  AirXXXX模组                LIS2DH12
  ┌──────────┐             ┌──────────┐
  │      3V3 ├─────────────┤ VDD      │
  │      GND ├─────────────┤ GND      │
  │  I2C_SCL ├─────────────┤ SCL      │
  │  I2C_SDA ├─────────────┤ SDA      │
  │     GPIO ├─────────────┤ INT1     │
  └──────────┘             └──────────┘
       Note: SDA/SCL 需接 4.7kΩ 上拉电阻至 3.3V

注意事项：

I2C 总线需接 4.7kΩ 上拉电阻
电源引脚旁应放置 100nF 去耦电容
SDO/SA0 引脚电平决定 I2C 从机地址低位
对于 SPI 模式，CS 引脚需由 GPIO 控制
传感器应尽量靠近主控设备（例如合宙AirXXXX模组）安装，减少走线噪声

要点5：工作原理

加速度传感器主要基于 MEMS（微机电系统）技术工作。其核心结构包含一个悬浮在硅晶片上的质量块，通过弹性微梁与固定框架连接。当外部加速度作用时，质量块因惯性产生位移，导致差分电容极板间距发生变化。这一电容变化被专用 ASIC 电路检测并转换为电压信号，经 ADC 数字化后输出。

以 LIS2DH12 为例，其内部包含三组正交的差分电容传感单元，分别检测 X、Y、Z 三个方向的加速度。信号链路为：MEMS传感单元 -> 电荷放大器 -> 低通滤波器 -> 多路复用器 -> 12位ADC -> 数字滤波器 -> FIFO/寄存器 -> I2C/SPI接口。

静态加速度（重力）可用于计算倾斜角度：当设备静止时，Z轴感受到约1g的重力加速度，通过各轴分量的比值可计算俯仰角（Pitch）和横滚角（Roll）。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别20：六轴传感器

要点1：什么是六轴传感器

六轴传感器（6-Axis IMU）是一种将三轴加速度计和三轴陀螺仪集成在同一芯片内的惯性测量单元（IMU）。它能够同时测量物体在三维空间中的线加速度（3轴）和角速度（3轴），共六个自由度的运动数据。通过传感器融合算法（如互补滤波、卡尔曼滤波），六轴传感器可实现对物体姿态（俯仰角、横滚角）的实时估算。

六轴传感器的主要功能包括：

同步采集三轴加速度和三轴角速度数据
提供运动姿态估算的原始数据
内置数字运动处理器（DMP）可实现硬件级姿态融合
检测手势、敲击、摇晃等运动事件
支持外部传感器扩展（如磁力计）构成九轴系统

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
MPU6050	TDK / InvenSense	I2C	陀螺仪±250/±500/±1000/±2000 dps，加速度计±2/±4/±8/±16g，16位ADC，5.4mA	经典六轴IMU，内置DMP，辅助I2C总线可扩展磁力计，4×4×0.9mm QFN封装
MPU6500	TDK / InvenSense	I2C / SPI	陀螺仪±250/±500/±1000/±2000 dps，加速度计±2/±4/±8/±16g，3.9mA	MPU6050升级版，支持SPI接口，更小封装（3×3×0.9mm），更低功耗
ICM20608G	TDK / InvenSense	I2C / SPI	陀螺仪±250/±500/±1000/±2000 dps，加速度计±2/±4/±8/±16g，低功耗6µA	MPU系列替代品，更低噪声，支持I2C和SPI双接口，内置FIFO
ICM20608D	TDK / InvenSense	I2C / SPI	陀螺仪±250/±500/±1000/±2000 dps，加速度计±2/±4/±8/±16g	ICM20608G的变体版本，封装和部分电气参数略有差异

要点3：应用场景

1. 无人机飞控：姿态稳定、自动悬停、飞行控制

2. 机器人平衡：两轮平衡车、人形机器人姿态控制

3. 可穿戴设备：运动追踪、手势识别、步数计数

4. VR/AR设备：头部追踪、手柄姿态检测

5. 相机防抖：光学防抖（OIS）和电子防抖（EIS）

6. 工业自动化：机器人关节角度测量、设备振动监测

要点4：硬件接口设计

通信接口：MPU6050 仅支持 I2C；MPU6500、ICM20608G/D 同时支持 I2C 和 SPI。

ASCII 接线图（以 MPU6050 为例，I2C 模式）：

   AirXXXX模组                MPU6050
  ┌──────────┐             ┌──────────┐
  │      3V3 ├─────────────┤ VCC      │
  │      GND ├─────────────┤ GND      │
  │  I2C_SCL ├─────────────┤ SCL      │
  │  I2C_SDA ├─────────────┤ SDA      │
  │     GPIO ├─────────────┤ INT      │
  │          │             │ AD0->GND │
  └──────────┘             └──────────┘
       Note: SDA/SCL 需接 4.7kΩ 上拉电阻至 VDD
             AD0 接 GND 时 I2C 地址为 0x68

注意事项：

MPU6050 工作电压为 3.3V，VDD 范围 2.375\~3.46V
AD0 引脚决定 I2C 地址：接地=0x68，接 VDD=0x69
INT 引脚可配置为数据就绪中断或运动检测中断
I2C 速率建议使用 400kHz 快速模式
传感器安装方向应与设备坐标系统对齐

要点5：工作原理

六轴传感器内部集成了两个独立的 MEMS 传感单元：

加速度计部分：采用电容式 MEMS 结构，通过检测质量块在加速度作用下的位移引起的电容变化来测量线加速度。三个正交的差分电容单元分别检测 X、Y、Z 方向的加速度。

陀螺仪部分：基于科里奥利效应（Coriolis Effect）工作。内部包含一个持续振动的质量块，当传感器旋转时，科里奥利力使振动质量块在垂直方向产生位移，该位移通过电容检测转换为角速度信号。三组正交的振动单元分别检测三个轴的角速度。

两路信号经各自的 ADC 数字化后，可通过内置的 DMP（Digital Motion Processor）进行传感器融合。DMP 使用预置的 MotionFusion 算法，将加速度计和陀螺仪数据融合，直接输出姿态四元数或欧拉角，减轻主主控设备（例如合宙AirXXXX模组）的计算负担。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别21：九轴传感器

要点1：什么是九轴传感器

九轴传感器（9-Axis IMU）是在六轴传感器（三轴加速度计 + 三轴陀螺仪）的基础上，额外集成三轴磁力计而构成的完整惯性测量单元。九个自由度的数据包括：三轴线加速度、三轴角速度和三轴磁场强度。通过九轴传感器融合算法，可实现对物体完整姿态的估算，包括俯仰角（Pitch）、横滚角（Roll）和偏航角（Yaw/航向角），提供绝对方向参考。

九轴传感器的主要功能包括：

同步采集加速度、角速度和磁场数据
提供绝对航向角参考（通过地磁场）
内置DMP可实现九轴传感器融合，直接输出四元数
支持运动追踪、导航定位、姿态解算

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
MPU9250	TDK / InvenSense	I2C / SPI	陀螺仪±250/±500/±1000/±2000 dps，加速度计±2/±4/±8/±16g，磁力计±4800µT，16位ADC，3.5mA	集成MPU6500+AK8963，3×3×1mm SiP封装，内置DMP九轴融合，辅助I2C总线，推荐替代品ICM-20948

要点3：应用场景

1. 无人机导航：完整姿态解算、航向锁定、GPS辅助导航

2. 机器人定位：SLAM辅助、航位推算、方向控制

3. AR/VR头显：头部六自由度追踪、空间定位

4. 电子罗盘：手机/手表方向导航、地图自动旋转

5. 运动分析：体育动作捕捉、高尔夫挥杆分析

6. 自动驾驶辅助：车辆姿态监控、惯导系统备份

要点4：硬件接口设计

通信接口：MPU9250 同时支持 I2C 和 SPI。主接口用于与主控设备（例如合宙AirXXXX模组）通信；辅助 I2C 总线用于内部磁力计（AK8963）通信。

ASCII 接线图（以 MPU9250 为例，I2C 模式）：

   AirXXXX模组                MPU9250
  ┌──────────┐             ┌──────────┐
  │      3V3 ├─────────────┤ VDD      │
  │      3V3 ├─────────────┤ VDDIO    │
  │      GND ├─────────────┤ GND      │
  │  I2C_SCL ├─────────────┤ SCL      │
  │  I2C_SDA ├─────────────┤ SDA      │
  │     GPIO ├─────────────┤ INT      │
  │      N/C │             │ AD0->GND │
  │      N/C │             │ NCS->VDD │
  └──────────┘             └──────────┘
       Note: SDA/SCL 需接 4.7kΩ 上拉电阻至 VDD
             AD0 接 GND 时 I2C 地址为 0x68
             NCS 接 VDD 选择 I2C 模式

注意事项：

MPU9250 VDD 范围 2.4\~3.6V，VDDIO 范围 1.71\~3.6V
使用 I2C 模式时，NCS 引脚必须接 VDD
磁力计 AK8963 通过内部辅助 I2C 总线访问，地址为 0x0C
磁力计需要校准（硬铁/软铁补偿）以获得准确航向
应远离电机、电池等磁场干扰源安装

要点5：工作原理

MPU9250 采用 System in Package（SiP）封装技术，将两颗芯片集成在同一封装内：

MPU6500 部分（六轴）：包含三轴加速度计和三轴陀螺仪。加速度计基于电容式 MEMS 原理检测线加速度；陀螺仪基于科里奥利效应检测角速度。

AK8963 部分（三轴磁力计）：采用霍尔效应原理检测三轴磁场强度。内部包含三个正交的霍尔传感器，测量地磁场在 X、Y、Z 方向的分量。AK8963 通过 MPU9250 的辅助 I2C 总线与主控通信，数据可被 DMP 直接读取进行九轴融合。

九轴融合算法的核心思想是：加速度计提供重力方向参考（修正俯仰角和横滚角的漂移），磁力计提供地磁北方向参考（修正偏航角的漂移），陀螺仪提供短期高精度的角速度积分。三者互补，通过卡尔曼滤波或互补滤波算法融合，输出稳定的姿态四元数。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别22：磁力计

要点1：什么是磁力计

磁力计（Magnetometer）是一种用于测量磁场强度的传感器，在电子应用中通常指三轴磁力计，能够同时测量 X、Y、Z 三个方向的地磁场分量。通过地磁场的方向和大小，磁力计可实现电子罗盘功能，计算设备相对于地磁北的航向角。

磁力计的主要功能包括：

测量三维空间中的磁场强度和方向
实现电子罗盘功能，提供绝对航向角
检测磁场异常（金属物体检测、磁干扰监测）
配合加速度计进行倾斜补偿的航向计算
辅助九轴传感器融合，修正陀螺仪偏航漂移

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
AK8963	AKM（旭化成微电子）	I2C	量程±4800µT，13位/16位分辨率，ODR 8/100Hz，0.6µT/LSB	集成于MPU9250内部，支持单次/连续测量模式，内置温度补偿
QMC5883L	QST（矽睿/量子隧道科技）	I2C	量程±8 Gauss，16位ADC，ODR 10/50/100/200Hz，2mGauss分辨率	HMC5883L替代品，内置温度补偿，过采样最高512倍，地址0x0D，无需外接RC滤波
HMC5883L	Honeywell（霍尼韦尔）	I2C	量程±8 Gauss，12位ADC，ODR 0.75\~160Hz，2mGauss分辨率	经典AMR磁阻传感器，1\~2度罗盘精度，内置自检，地址0x3C/0x3D，已停产

要点3：应用场景

1. 电子罗盘：手机导航、户外指南针、地图方向自动旋转

2. 无人机航向控制：提供绝对方向参考，辅助GPS导航

3. 机器人导航：SLAM方向参考、路径规划

4. 金属检测：地下管线探测、安检设备

5. 停车场车位检测：通过地磁场变化检测车辆停放

6. AR/VR：空间方向定位、虚拟场景对齐

要点4：硬件接口设计

通信接口：三款磁力计均使用 I2C 接口。

ASCII 接线图（以 QMC5883L 为例）：

AirXXXX模组/AirXXXX模组P          QMC5883L
  ┌──────────┐             ┌──────────┐
  │      3V3 ├─────────────┤ VDD      │
  │      GND ├─────────────┤ GND      │
  │  I2C_SCL ├─────────────┤ SCL      │
  │  I2C_SDA ├─────────────┤ SDA      │
  │      GND ├─────────────┤ SDO      │
  └──────────┘             └──────────┘
       Note: SDA/SCL 需接 4.7kΩ 上拉电阻至 VDD
             SDO 接 GND 时 I2C 地址为 0x0D

注意事项：

磁力计应远离电机、扬声器、电池等磁性干扰源
使用前必须进行硬铁校准和软铁校准
I2C 地址因型号不同：AK8963=0x0C，QMC5883L=0x0D，HMC5883L=0x1E(写)/0x3D(读)
QMC5883L 寄存器与 HMC5883L 不兼容，不能直接替换驱动代码
安装方向应与设备坐标系一致

要点5：工作原理

磁力计主要有两种技术路线：

AMR（各向异性磁阻）技术（HMC5883L、QMC5883L）：利用坡莫合金薄膜的电阻随磁场方向变化的特性。当外部磁场作用于AMR元件时，磁阻材料的磁化方向发生偏转，导致电阻值变化。三个正交的AMR电桥分别检测三个轴向的磁场分量。AMR技术具有高灵敏度、低功耗和小尺寸的优点。

霍尔效应技术（AK8963）：基于霍尔效应原理，当电流流过半导体材料并在垂直方向施加磁场时，会在材料的横向产生霍尔电压。三个正交的霍尔元件分别检测三个方向的磁场。霍尔传感器结构简单、线性度好，但灵敏度相对较低。

航向角计算公式：Heading = atan2(My, Mx) * 180 / pi（需考虑磁偏角修正）。当设备倾斜时，需利用加速度计提供的俯仰角和横滚角进行倾斜补偿。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别23：陀螺仪传感器

要点1：什么是陀螺仪传感器

陀螺仪传感器（Gyroscope）是一种用于测量物体角速度（旋转速度）的器件。与加速度计测量线速度变化不同，陀螺仪专门检测物体绕三个正交轴（X、Y、Z）的旋转运动，输出单位通常为度/秒（dps，degrees per second）。通过对角速度进行时间积分，可获得物体的旋转角度。

陀螺仪传感器的主要功能包括：

测量三轴角速度（旋转速率）
通过积分计算旋转角度变化
提供短期高精度的姿态变化数据
检测旋转手势和运动方向
配合加速度计进行完整的姿态解算

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
L3G4200D	STMicroelectronics（意法半导体）	I2C / SPI	±250/±500/±2000 dps，16位分辨率，ODR 100\~800Hz，6.1mA	三轴数字陀螺仪，内置FIFO、温度传感器、高通/低通滤波器，LGA-16 4×4×1.1mm封装，替代品I3G4250D

要点3：应用场景

1. 无人机飞控：角速度反馈、姿态稳定控制

2. 机器人平衡：两轮平衡车姿态检测、关节运动测量

3. 游戏与VR：体感控制器旋转检测、头部追踪

4. 汽车电子：车身稳定系统（ESP）、翻滚检测

5. 运动分析：体育动作旋转测量、运动轨迹记录

6. 导航系统：GPS/INS组合导航、航位推算

要点4：硬件接口设计

通信接口：L3G4200D 支持 I2C 和 SPI 双接口。CS 引脚电平决定通信模式（高=I2C，低=SPI）。

ASCII 接线图（以 L3G4200D 为例，I2C 模式）：

   AirXXXX模组               L3G4200D
  ┌──────────┐             ┌──────────┐
  │      3V3 ├─────────────┤ VDD      │
  │      3V3 ├─────────────┤ VDDIO    │
  │      GND ├─────────────┤ GND      │
  │  I2C_SCL ├─────────────┤ SCL      │
  │  I2C_SDA ├─────────────┤ SDA      │
  │      3V3 ├─────────────┤ CS       │
  │     GPIO ├─────────────┤ INT1     │
  │     GPIO ├─────────────┤ INT2     │
  │      GND ├─────────────┤ SDO      │
  └──────────┘             └──────────┘
       Note: CS 接 VDD 选择 I2C 模式
             SDA/SCL 需接 4.7kΩ 上拉电阻
             SDO 接 GND 时 I2C 地址为 0x68

注意事项：

CS 引脚必须接 VDD 才能使用 I2C 模式
VDD 范围 2.4\~3.6V，VDDIO 支持 1.8V 兼容
上电后需要配置 CTRL_REG1 启动采样，否则数据无效
陀螺仪存在零偏漂移，使用前应进行零偏校准
量程选择影响灵敏度：±250dps=8.75mdps/LSB，±2000dps=70mdps/LSB

要点5：工作原理

L3G4200D 采用 MEMS（微机电系统）技术，基于科里奥利效应（Coriolis Effect）工作。其核心结构包含一个由压电驱动器激励持续振动的质量块。当传感器绕某轴旋转时，科里奥利力使振动质量块在垂直于振动方向和旋转轴的方向上产生位移。

科里奥利力公式：F = 2m * v * omega（m为质量，v为振动速度，omega为角速度）

该位移通过差分电容检测电路转换为电信号。三组正交的振动-检测单元分别测量 X、Y、Z 三个轴的角速度。信号链路为：MEMS振动单元 -> 科里奥利力检测电容 -> 电荷放大器 -> 解调器 -> 低通滤波器 -> 16位ADC -> FIFO/寄存器 -> I2C/SPI接口。

陀螺仪的零偏漂移（Zero-Rate Level）是其主要误差来源，需通过软件校准或与加速度计融合来补偿。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别24：距离传感器

要点1：什么是距离传感器

距离传感器（Distance Sensor）是一种用于测量传感器到目标物体之间距离的器件。在运动与姿态传感器领域，距离传感器主要采用飞行时间（ToF，Time of Flight）技术，通过发射光信号（通常是红外光或激光）并测量光信号从发射到返回的时间，精确计算传感器与目标之间的绝对距离。ToF技术不受物体表面颜色和反射率影响，测量精度高。

距离传感器的主要功能包括：

非接触式精确测距
物体接近/远离检测
手势识别（通过距离变化模式）
避障与防撞
物体存在检测

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
GY-53L1	基于ST VL53L1X芯片	UART / I2C / PWM	测距范围5cm\~4m，响应时间22ms（最高），工作电压3\~5V	模块集成STM32 主控设备（例如合宙AirXXXX模组），直接输出距离值，支持连续/询问输出模式，可设置警戒距离开关量输出
VL6180	STMicroelectronics（意法半导体）	I2C	测距范围0\~62cm，850nm VCSEL，4.8×2.8×1.0mm，地址0x29	FlightSense ToF技术，内置VCSEL+光电探测器，不受反射率影响，支持环境光抑制和串扰补偿

要点3：应用场景

1. 智能手机：自动对焦辅助、接听电话时自动息屏

2. 机器人避障：扫地机器人、AGV小车障碍物检测

3. 手势识别：挥手操作、近距离手势交互

4. 液位检测：水箱液位、垃圾桶满度监测

5. 智能照明：人体接近自动开灯、距离感应调光

6. 工业自动化：产品计数、定位检测、尺寸测量

要点4：硬件接口设计

通信接口：GY-53L1 支持 UART、I2C 和 PWM 三种输出模式（通过 PS 引脚选择）；VL6180 使用 I2C 接口。

ASCII 接线图（以 GY-53L1 为例，UART 模式）：

    AirXXXX模组               GY-53L1
  ┌──────────┐             ┌──────────┐
  │      3V3 ├─────────────┤ VCC      │
  │      GND ├─────────────┤ GND      │
  │  UART_RX ├─────────────┤ TX       │
  │  UART_TX ├─────────────┤ RX       │
  │          │             │ PS->悬空  │
  └──────────┘             └──────────┘
       Note: PS 悬空(高电平)为UART模式, 接GND为I2C模式
             默认波特率 9600 bps

ASCII 接线图（以 VL6180 为例，I2C 模式）：

    AirXXXX模组               VL6180
  ┌──────────┐             ┌──────────┐
  │      3V3 ├─────────────┤ VDD      │
  │      GND ├─────────────┤ GND      │
  │  I2C_SCL ├─────────────┤ SCL      │
  │  I2C_SDA ├─────────────┤ SDA      │
  │     GPIO ├─────────────┤ GPIO1    │
  └──────────┘             └──────────┘
       Note: SDA/SCL 需接 4.7kΩ 上拉电阻
             I2C 地址: 0x29 (7位)
             工作电压: 2.6~3.0V

注意事项：

GY-53L1 工作电压 3\~5V，模块自带稳压，可直接接 3.3V
VL6180 工作电压 2.6\~3.0V，注意不要接 5V
传感器前方需保持视场无遮挡
强阳光直射可能影响测量精度
GY-53L1 的 UART 模式输出为数据帧格式（帧头0x5A 0x5A）

要点5：工作原理

VL6180 的 ToF（飞行时间）原理：

传感器内部集成了红外 VCSEL（垂直腔面发射激光器）和光电探测器。测量过程为：

VCSEL 发射一束 850nm 红外脉冲光
光信号到达目标物体后反射回来
光电探测器接收反射光信号
专用 ASIC 精确测量光从发射到接收的时间差
距离 D = c * dt / 2（c为光速，dt为时间差）

由于直接测量时间差而非光强度，ToF技术不受目标物体颜色、表面反射率的影响。VL6180 还内置环境光抑制电路和盖片串扰补偿算法，确保在复杂光照条件下的测量精度。

GY-53L1 的工作原理：

基于 ST VL53L1X ToF 芯片，模块上额外的 STM32 主控设备（例如合宙AirXXXX模组）负责处理 ToF 芯片的原始数据，直接计算并输出距离值（单位mm），用户无需处理复杂的 ToF 算法。支持 UART 串口直接输出距离数据帧，也可通过 PWM 脉宽表示距离值。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别25：霍尔传感器

要点1：什么是霍尔传感器

霍尔传感器（Hall Effect Sensor）是基于霍尔效应原理工作的磁场检测器件。当电流流过半导体材料并在垂直方向施加磁场时，会在材料的横向产生与磁场强度成正比的电压（霍尔电压）。霍尔传感器可检测磁场的存在、强度和方向，广泛用于位置检测、转速测量和电流传感等应用。

霍尔传感器的主要功能包括：

检测磁场的存在和强度
非接触式位置检测（接近开关）
转速和转数测量
电流检测（通过导线周围的磁场）
角度位置检测（BLDC电机换相）

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
A3144	Allegro MicroSystems	GPIO（数字输出）	工作电压4.5\~24V，工作电流25mA，检测距离2\~4mm，双极锁存型	经典双极锁存霍尔开关，TO-92封装，广泛用于BLDC电机换相和位置检测
A44E	Allegro MicroSystems	GPIO（数字输出）	工作电压4.5\~24V，双极锁存型	A3144兼容替代品，性能类似，用于电机编码和位置传感
SS49E	Honeywell（霍尼韦尔）	ADC（模拟输出）	工作电压4.5\~6.5V（推荐5V），量程±1000 Gauss，灵敏度1.4mV/G，工作电流10mA	线性霍尔传感器，输出模拟电压与磁场强度成正比，TO-92封装，适用于电流检测和位置测量
OH137	华夏半导体等	GPIO（数字输出）	工作电压4.5\~24V，双极锁存型，检测距离2\~4mm	A3144兼容型号，性价比高，常用于无刷电机霍尔编码器

要点3：应用场景

1. 无刷直流电机（BLDC）：转子位置检测、换相控制

2. 转速测量：电机RPM监测、风扇转速检测

3. 接近开关：门窗开闭检测、限位开关

4. 电流传感：非接触式电流测量

5. 汽车电子：车速传感器、油门位置检测

6. 智能水气表：流量计脉冲计数

要点4：硬件接口设计

通信接口：数字型霍尔传感器（A3144、A44E、OH137）输出数字高低电平，通过 GPIO 读取；线性型霍尔传感器（SS49E）输出模拟电压，通过 ADC 读取。

ASCII 接线图（以 A3144 为例）：

   AirXXXX模组             A3144 (TO-92)
  ┌──────────┐             ┌──────────┐
  │      5V  ├─────────────┤ VCC(1)   │
  │      GND ├─────────────┤ GND(2)   │
  │     GPIO ├─────────────┤ OUT(3)   │
  │      5V  ├──[ 10kΩ ]── ┤ OUT(3)   │
  └──────────┘             └──────────┘
       Note: OUT 引脚为开漏输出, 需外接 10kΩ 上拉电阻
             工作电压需 4.5V 以上, 可用模组 5V 输出
             GPIO 需配置为输入模式

ASCII 接线图（以 SS49E 为例）：

   AirXXXX模组             SS49E (TO-92)
  ┌──────────┐             ┌──────────┐
  │      5V  ├─────────────┤ VDD(1)   │
  │      GND ├─────────────┤ GND(2)   │
  │     ADC  ├─────────────┤ OUT(3)   │
  └──────────┘             └──────────┘
       Note: 工作电压 4.5~6.5V, 推荐 5V
             ADC 读取模拟电压
             无磁场时输出约 VDD/2

注意事项：

A3144 等数字型霍尔传感器工作电压需 4.5V 以上，不能直接用 3.3V 供电
输出引脚为开漏结构，必须接上拉电阻
如主控设备（例如合宙AirXXXX模组） GPIO 不耐 5V，需使用电平转换或分压电路
SS49E 模拟输出范围随供电电压变化，ADC 量程需匹配
霍尔传感器应靠近磁铁安装，检测距离一般 2\~5mm
双极锁存型需要 N 极和 S 极交替触发才能正常工作

要点5：工作原理

霍尔效应由美国物理学家 Edwin Hall 于 1879 年发现。其原理为：当电流 I 流过一片半导体材料（霍尔元件），并在垂直于电流方向施加磁场 B 时，载流子（电子或空穴）在洛伦兹力的作用下向一侧偏转，在材料横向产生一个垂直于电流和磁场方向的电场，该电场产生的电压即为霍尔电压 V_H。

霍尔电压公式：V_H = (I * B) / (n * q * d)

其中 I 为电流，B 为磁感应强度，n 为载流子浓度，q 为电荷量，d 为材料厚度。

数字型霍尔传感器（A3144）：在霍尔元件后接施密特触发器，当磁场强度超过工作点阈值时输出低电平，当磁场降至释放点以下时输出高电平。双极锁存型需要反向磁场（N极到S极切换）才能改变输出状态。

线性型霍尔传感器（SS49E）：直接输出与磁场强度成正比的模拟电压。无磁场时输出 VDD/2，磁场为 N 极时电压升高，S 极时电压降低。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别26：雷达传感器

要点1：什么是雷达传感器

雷达传感器（Radar Sensor）是一种利用电磁波探测目标物体的传感器。它通过发射无线电波并接收目标反射的回波信号，检测物体的存在、位置、运动状态甚至呼吸心跳等微动信息。在物联网和智能家居领域，微波雷达传感器因其不受温度、湿度、灰尘和光照影响，且能穿透非金属材料的特点，正逐步替代传统PIR红外传感器。

雷达传感器的主要功能包括：

人体存在检测（包括静止人体）
运动检测与运动方向识别
距离测量与定位
呼吸、心跳等微动信号检测
速度测量（基于多普勒效应）

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
HLK-LD1115H	Hi-Link（海凌科）	UART（TTL）	24GHz，5V供电，静态存在检测>4m，运动检测>16m，25×25×11mm	24GHz毫米波雷达，支持微动检测，低功耗68µA，TTL串口输出
HLK-LD2410	Hi-Link（海凌科）	UART / GPIO	24GHz FMCW，5V供电，检测距离5\~6m，波特率256000bps	支持静止和移动人体检测，多距离门能量输出，蓝牙APP调试，±0.15m距离分辨率
RCWL-0516	通用方案	GPIO（数字输出）	3.18GHz微波，4\~28V供电（推荐5V），探测距离约7m，29×13×7mm	多普勒微波雷达，TTL电平输出，可穿透非金属，无需光学窗口，2\~3s触发保持

要点3：应用场景

1. 智能照明：人体存在检测自动开关灯、走廊感应照明

2. 安防监控：入侵报警、闯入检测

3. 智能家居：空调/新风自动控制、卫生间有人检测

4. 智能卫生间：隔间占用状态检测

5. 酒店/办公楼：会议室占用管理、节能控制

6. 智慧养老：跌倒检测、睡眠监测、呼吸心跳感知

要点4：硬件接口设计

通信接口：HLK-LD1115H 和 HLK-LD2410 使用 UART 串口通信；RCWL-0516 使用 GPIO 数字输出。

ASCII 接线图（以 HLK-LD2410 为例，UART 模式）：

   AirXXXX模组              HLK-LD2410
  ┌──────────┐             ┌──────────┐
  │      5V  ├─────────────┤ VCC      │
  │      GND ├─────────────┤ GND      │
  │  UART_RX ├─────────────┤ TX       │
  │  UART_TX ├─────────────┤ RX       │
  └──────────┘             └──────────┘
       Note: 波特率 256000 bps (默认)
             供电 5V, 电流约 60mA

ASCII 接线图（以 RCWL-0516 为例）：

   AirXXXX模组              RCWL-0516
  ┌──────────┐             ┌──────────┐
  │      5V  ├─────────────┤ VIN      │
  │      GND ├─────────────┤ GND      │
  │     GPIO ├─────────────┤ OUT      │
  │          │             │ CDS->悬空 │
  └──────────┘             └──────────┘
       Note: 供电 4~28V, 推荐 5V
             OUT 为数字输出 (高电平=检测到运动)
             CDS 悬空或接 100kΩ 到 GND (禁用光控)

注意事项：

RCWL-0516 严禁用 3.3V 供电，需 4V 以上
RCWL-0516 的 CDS 引脚悬空可能导致误触发，建议接 100kΩ 到 GND
HLK-LD2410 的 UART 波特率较高（256000bps），需确认主控设备（例如合宙AirXXXX模组）支持
雷达模块底部天线区域严禁覆盖金属屏蔽
安装时应避免对准风扇、窗帘等运动物体

要点5：工作原理

多普勒雷达原理（RCWL-0516）：

RCWL-0516 工作在 3.18GHz ISM 频段。内部振荡器通过 PCB 微带天线发射连续微波信号。当微波遇到运动物体时，反射波的频率会因多普勒效应发生偏移。频偏公式：fd = 2v * f / c（v为物体径向速度，f为发射频率，c为光速）。混频器将发射信号与接收信号混合，提取多普勒频偏信号，经带通滤波和施密特触发器转换为数字输出。

FMCW 调频连续波原理（HLK-LD2410）：

HLK-LD2410 采用 24GHz FMCW（Frequency Modulated Continuous Wave）技术。发射信号的频率随时间线性变化（chirp信号），当回波返回时，发射频率已发生变化，发射信号与接收信号之间的频率差与目标距离成正比。公式：R = c * df / (2 * S)（df为频率差，S为调频斜率）。FMCW技术不仅能检测运动目标，还能通过分析呼吸引起的微小距离变化检测静止人体的存在。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别27：旋转编码器

要点1：什么是旋转编码器

旋转编码器（Rotary Encoder）是一种将机械旋转运动转换为数字电信号的器件。它通过检测轴的旋转角度和方向，输出对应的脉冲信号，使微控制器能够识别旋转的方向、速度和位置。与电位器不同，旋转编码器是增量式数字器件，可360度无限旋转，且不受旋转圈数限制。

旋转编码器的主要功能包括：

检测旋转方向（顺时针/逆时针）
计数旋转步数（脉冲数）
测量旋转速度
部分型号集成按压开关功能
提供触觉反馈（定位感）

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
EC11	ALPS Alpine（阿尔卑斯阿尔派）	GPIO（A/B相+按键）	额定10mA/5V DC，定位数15\~30，脉冲数15\~18，工作温度-40\~+85°C，寿命15000圈	11mm金属轴编码器，A/B双相输出，可选按压开关，定位扭矩10±7mN·m，广泛用于音量控制和菜单导航

要点3：应用场景

1. 音量控制：音响、耳机放大器、车载音响音量旋钮

2. 菜单导航：嵌入式设备LCD菜单选择、参数调节

3. 工业面板：数控机床进给率调节、设备参数设置

4. 智能家居：智能灯调光旋钮、温控器温度调节

5. 汽车电子：导航/音响系统旋钮、空调控制

6. 仪器仪表：示波器、信号发生器参数调节

要点4：硬件接口设计

通信接口：EC11 使用 GPIO 接口，输出 A 相、B 相两路正交脉冲信号，部分型号还有按压开关输出。

ASCII 接线图（以 EC11 为例）：

   AirXXXX模组                 EC11
  ┌──────────┐             ┌──────────┐
  │      3V3 ├─────────────┤ A(或C1)   │
  │      3V3 ├─────────────┤ B(或C2)   │
  │      GND ├─────────────┤ C(公共端) │
  │     GPIO ├─────────────┤ A         │
  │     GPIO ├─────────────┤ B         │
  │     GPIO ├─────────────┤ SW(按键)  │
  │      3V3 ├─────────────┤ SW(另一端)│
  └──────────┘             └──────────┘
       Note: A/B 相需接 10kΩ 上拉电阻至 3.3V
             C 为公共端接 GND
             SW 为按压开关, 另一端接 3.3V
             建议启用 GPIO 消抖 (编码器触点抖动约 3ms)

注意事项：

EC11 输出为机械触点信号，存在抖动（约2\~3ms），需软件消抖或硬件RC滤波
A/B 相需接 10kΩ 上拉电阻
额定电流仅 10mA，不可用于功率切换
操作寿命约 15000 圈，不适合高速旋转应用
安装孔间距标准为 19mm

要点5：工作原理

EC11 是一种增量式光电/机械旋转编码器，内部采用金属电刷在导电码盘上滑动的结构。码盘上均匀分布着导电区和不导电区，当轴旋转时，两组电刷（A相和B相）交替接触导电区，产生两路相位差90度的方波信号。

正交解码原理：

A 相和 B 相输出相位差 90 度的方波
顺时针旋转时，A 相超前 B 相 90 度
逆时针旋转时，B 相超前 A 相 90 度
通过检测 A/B 相的状态变化顺序，可确定旋转方向
每个完整脉冲周期对应一个定位步（detent）

四倍频解码：通过检测 A 相和 B 相的所有跳变沿（上升沿和下降沿），可将分辨率提高到原始脉冲数的 4 倍。

按压开关部分独立于编码器，是一个简单的通断开关，按下时导通，松开时断开。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别28：水流量传感器

要点1：什么是水流量传感器

水流量传感器（Water Flow Sensor）是一种用于测量管道中液体流量的器件。它通常通过检测水流推动内部叶轮转动的速度来计算流量。叶轮上安装有磁铁，旋转时触发霍尔传感器产生脉冲信号，脉冲频率与流量成正比，通过计数脉冲即可计算流过液体的体积和流速。

水流量传感器的主要功能包括：

测量液体瞬时流量（L/min）
累计流过液体的总量（L）
检测水流有无（通断检测）
监测流量异常（堵塞、泄漏）
配合阀门实现流量控制

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
YF-S201	通用方案	GPIO（脉冲输出）	流量范围1\~30 L/min，工作电压5\~24V，接口G1/2（4分），脉冲当量7.5*F=Q(L/min)，工作温度≤80°C	最常见水流量传感器，霍尔效应脉冲输出，红色(+)黑色(GND)黄色(信号)三线制
YF-S401	通用方案	GPIO（脉冲输出）	流量范围0.3\~6 L/min，工作电压5\~24V，接口1/8英寸（6mm软管），工作温度≤80°C	小流量精密测量，适合净水器、咖啡机，三线制脉冲输出
FS300A	通用方案	GPIO（脉冲输出）	流量范围1\~60 L/min，工作电压5\~24V，接口G3/4（6分），精度±3%，工作电流15mA	大流量测量，适合工业水处理、农业灌溉，三线制脉冲输出

要点3：应用场景

1. 智能售水机：流量计量、计费控制

2. 咖啡机/饮水机：水量控制、缺水检测

3. 农业灌溉：用水量统计、精准灌溉

4. 工业水处理：流量监控、药剂配比

5. 智能家居：用水量监测、漏水报警

6. 激光冷却：冷却水流量监测、断水保护

要点4：硬件接口设计

通信接口：水流量传感器输出脉冲信号，通过 GPIO 中断计数。

ASCII 接线图（以 YF-S201 为例）：

   AirXXXX模组                YF-S201
  ┌──────────┐             ┌──────────┐
  │      5V  ├─────────────┤ 红线(+)   │
  │      GND ├─────────────┤ 黑线(GND) │
  │     GPIO ├─────────────┤ 黄线(信号)│
  │      5V  ├──[ 10kΩ ]──-┤ 黄线(信号)│
  └──────────┘             └──────────┘
       Note: 信号线为开漏输出, 需外接 10kΩ 上拉电阻
             工作电压 5~24V, 推荐 5V
             如 主控设备（例如合宙AirXXXX模组） GPIO 不耐 5V, 需电平转换

注意事项：

传感器工作电压需 5V 以上，3.3V 可能无法正常工作
信号线为开漏输出，必须接上拉电阻
5V 信号连接 3.3V GPIO 时需使用分压电路或电平转换
安装时注意水流方向（传感器标注箭头方向）
传感器前应安装过滤网，防止杂质卡住叶轮
脉冲当量因型号不同：YF-S201 约 7.5 Hz/(L/min)

要点5：工作原理

水流量传感器采用叶轮式流量计原理工作：

水流进入传感器腔体，冲击叶轮使其旋转
叶轮转速与水流速度成正比
叶轮上镶嵌有磁铁，旋转时磁铁交替经过霍尔传感器
霍尔传感器检测到磁场变化，输出脉冲信号
脉冲频率与流量成正比：Q = F / K（Q为流量L/min，F为脉冲频率Hz，K为传感器系数）

以 YF-S201 为例，传感器系数 K ≈ 7.5，即每升水产生约 450 个脉冲。通过在固定时间内计数脉冲数，可计算瞬时流量；通过累计总脉冲数，可计算总水量。

霍尔传感器与水流隔离安装，确保电气部分不受水浸影响，保证使用安全。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

第三篇：生物医学传感器

类别29：心率血氧传感器

要点1：什么是心率血氧传感器

心率血氧传感器是一种利用光电容积脉搏波描记法（PPG，Photoplethysmography）技术，非侵入式测量人体心率和外周血氧饱和度（SpO2）的生物医学传感器。它通过向皮肤照射特定波长的光（红光和红外光），检测血液对光的吸收变化，从而计算出心率（HR，单位：次/分钟）和血氧饱和度（SpO2，单位：%）。

心率血氧传感器的主要功能包括：

实时测量心率（Heart Rate, HR）
测量外周血氧饱和度（SpO2）
检测脉搏波形（PPG信号）
内置温度传感器用于温度补偿
支持低功耗模式，适合可穿戴设备
FIFO 缓冲区存储采样数据

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
MAX30102	Maxim Integrated（现为 Analog Devices）	I2C	18位ADC，红光+红外LED，VDD=1.8V/VLED=3.3V，功耗\<1mW，关断电流0.7µA，5.6×3.3×1.55mm	集成LED+光电探测器+光学元件+低噪声电子学的完整模块，内置环境光抑制，FIFO 32\~256样本，I2C地址0x57(写)/0xAE(写)/0xAF(读)

要点3：应用场景

1. 智能手环/手表：实时心率监测、运动心率追踪

2. 健康监测设备：血氧饱和度检测、睡眠呼吸暂停筛查

3. 医疗辅助设备：居家血氧监测、远程健康管理

4. 健身器材：跑步机/动感单车心率显示

5. 可穿戴医疗：老年人心率异常报警、运动员训练监测

6. 移动设备：智能手机后置心率检测

要点4：硬件接口设计

通信接口：MAX30102 使用标准 I2C 接口通信。

ASCII 接线图（以 MAX30102 为例）：

   AirXXXX模组              MAX30102模块
  ┌──────────┐             ┌──────────┐
  │      3V3 ├─────────────┤ VIN      │
  │      GND ├─────────────┤ GND      │
  │  I2C_SCL ├─────────────┤ SCL      │
  │  I2C_SDA ├─────────────┤ SDA      │
  │     GPIO ├─────────────┤ INT      │
  └──────────┘             └──────────┘
       Note: SDA/SCL 需接 4.7kΩ 上拉电阻至 VDD
             I2C 写地址: 0xAE, 读地址: 0xAF (8位)
             7位地址: 0x57
             INT 为开漏输出, 可接 GPIO
             模块通常自带稳压和电平转换

注意事项：

MAX30102 IC 供电为 1.8V，LED 供电为 3.3V，模块通常已集成稳压
I2C 地址为 0x57（7位），写操作用 0xAE，读操作用 0xAF
INT 引脚为开漏输出，用于数据就绪中断通知
传感器应紧贴皮肤（指尖或手腕），避免环境光干扰
测量时保持静止，运动会产生运动伪影
传感器窗口应保持清洁，避免汗液/油脂影响光学测量

要点5：工作原理

MAX30102 基于光电容积脉搏波描记法（PPG）原理工作：

光学测量原理：

传感器内部的红光LED（约660nm）和红外LED（约880nm）交替点亮
光线穿透皮肤照射到皮下血管
血液中的血红蛋白对不同波长光的吸收率不同：
- 氧合血红蛋白（HbO2）吸收更多红外光，反射更多红光
- 脱氧血红蛋白（Hb）吸收更多红光，反射更多红外光
光电探测器接收反射/透射光，转换为电流信号
经18位ADC数字化后存储在FIFO中

心率计算：

心脏每次跳动时，血管中血液体积脉冲式增加，导致光吸收量周期性变化。通过检测PPG信号的周期性峰值的间隔时间，可计算心率：HR = 60 / T（T为相邻脉搏峰值间隔时间，单位秒）。

血氧饱和度计算：

通过计算红光和红外光信号的交流分量（AC）与直流分量（DC）之比：R = (AC_red / DC_red) / (AC_IR / DC_IR)，然后通过经验校准曲线将 R 值映射为 SpO2 百分比：SpO2 = 110 - 25 * R（近似公式，实际需校准）。

MAX30102 内置环境光消除电路，可自动扣除环境光对测量的干扰，提高信噪比。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

第四篇：工业与测量传感器

类别30：称重传感器

要点1：什么是称重传感器

称重传感器（Load Cell）是一种将力学量（重量/力）转换为电信号输出的测量器件。其核心是电阻应变片构成的惠斯通电桥，当外力作用使弹性体产生微小形变时，应变片阻值发生变化，电桥失去平衡输出差分电压信号。由于传感器输出的模拟信号通常只有毫伏级，需要配合专用ADC芯片（如HX711）进行信号放大和数字化处理，才能被主控设备（例如合宙AirXXXX模组）读取。称重传感器的主要功能包括：精确测量物体重量、实时监测载荷变化、实现定量控制和超载报警等。

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
HX711	Avia Semiconductor（上海合芯/中芯国际旗下）	2线串行（SCK+DOUT）	24位Σ-Δ ADC；PGA增益128x/64x；数据速率10/80SPS；供电2.6-5.5V	专为称重设计，集成PGA和基准源，外围极简，成本极低，双通道输入（A通道128x/64x，B通道32x）

要点3：应用场景

电子秤（厨房秤、体重秤、宠物秤等消费类产品）
工业配料与称重系统（自动配料、定量包装）
智能仓储与物流（料仓余量监测、快递称重）
智慧农业（饲料余量监测、自动补货提醒）
医疗设备（输液袋重量监测、病床称重）
物联网智能垃圾箱（满溢检测）

要点4：硬件接口设计

HX711采用2线串行接口（非标准I2C/SPI），通过SCK时钟和DOUT数据线与主控设备（例如合宙AirXXXX模组）通信。

  合宙模组                   HX711
(AirXXXX模组)              (称重ADC)
  ┌──────────┐           ┌──────────┐
  │   GPIO X │───────────│SCK       │
  │   GPIO Y │───────────│DOUT      │
  │     3.3V │───────────│VCC       │
  │      GND │───────────│GND       │
  │          │           │ E+ E-    │
  │          │           │ A+ A-    │──> 接称重传感器电桥
  └──────────┘           └──────────┘

注意事项：

HX711供电电压必须与主控设备（例如合宙AirXXXX模组） IO电压匹配，AirXXXX模组为3.3V供电
称重传感器的激励电压建议使用HX711的E+/E-输出（比例式测量），避免电源波动影响精度
传感器连接线建议使用屏蔽双绞线，远离电机等干扰源
DOUT引脚需上拉电阻（约10kΩ），SCK为推挽输出
安装需保证垂直受力，避免侧向力导致测量偏差

要点5：工作原理

HX711内部采用Σ-Δ（Sigma-Delta）调制架构实现24位高精度模数转换。称重传感器内部的4个应变片组成惠斯通电桥，无载荷时电桥平衡输出为0；施加重量后弹性体形变导致应变片阻值变化，电桥输出与重量成正比的差分电压（满量程约5mV@5V供电）。该微弱信号进入HX711后被内部PGA放大128倍（约640mV），再经Σ-Δ调制器数字化为24位补码数据。主控设备（例如合宙AirXXXX模组）通过控制SCK脉冲数量来选择通道和增益：25个脉冲选择通道A增益128x，26个脉冲选择通道B增益32x，27个脉冲回到通道A增益128x。当SCK保持高电平超过60μs时，芯片进入低功耗待机模式（\<1μA）。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别31：功率传感器

要点1：什么是功率传感器

功率传感器是一种用于实时测量电路中电流、电压和功率的集成化器件。与传统分立采样方案不同，功率传感器芯片内部集成了高精度ADC、可编程校准和功率计算单元，能够直接通过数字接口输出电流值（安培）、电压值（伏特）和功率值（瓦特），无需主控设备（例如合宙AirXXXX模组）进行复杂的模拟信号处理和数学运算。其主要功能包括：双向电流检测、高侧/低侧电流监测、功率/电能计量、过流过压报警等。

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
INA226	Texas Instruments（德州仪器）	I2C/SMBus（16个可编程地址）	16位ADC；总线电压0-36V；分流电压±81.92mV；增益误差0.1%；失调10μV；CMRR 126dB；供电2.7-5.5V	高精度双向电流/电压/功率监测，支持高侧和低侧检测，内置乘法器直接输出功率值，可配置告警功能，工作温度-40°C至125°C

要点3：应用场景

服务器与数据中心功耗监测
电池充电器与电池管理系统（充放电电流监测）
智能电源管理与负载监控
电信设备功耗统计
工业自动化设备电流监测
测试仪器与计量设备

要点4：硬件接口设计

INA226采用标准I2C接口通信，外围仅需一个分流采样电阻。

合宙模组                    INA226
(AirXXXX模组)              (功率监控)
  ┌──────────┐            ┌──────────┐
  │      3.3V│────────────│VS        │
  │       GND│────────────│GND       │
  │   I2C_SCL│────┬───────│SCL       │
  │   I2C_SDA│────┼──┬────│SDA       │
  │          │    │  │    │ VBUS     │──> 接被测总线电压(0-36V)
  │          │    │  │    │ IN+ IN-  │──> 接分流电阻两端
  │          │    │  │    │ A0 A1    │──> 地址选择(接GND/VDD/SCL/SDA)
  │          │    │  │    │ Alert    │──> 过流/过压告警输出(可选)
  └──────────┘    │  │    └──────────┘
                 4.7kΩ 4.7kΩ  (上拉电阻至3.3V)

  被测电路:  Vbus ──[负载]── IN+ ──[Rshunt] ── IN- ── GND

注意事项：

分流电阻（Rshunt）选型需根据最大电流计算：Imax × Rshunt ≤ 81.92mV
I2C上拉电阻推荐4.7kΩ（400kHz模式），总线电容较大时减小至2.2kΩ
INA226供电与I2C电平需与主控设备（例如合宙AirXXXX模组）匹配（3.3V）
高侧检测时共模电压可达36V，INA226独立于供电电压工作
Alert引脚为开漏输出，需上拉电阻

要点5：工作原理

INA226内部集成了一个16位Δ-Σ ADC和数字处理引擎。其测量原理基于欧姆定律和功率公式：通过外部分流电阻测量压降（Vshunt），结合总线电压（Vbus），由内部乘法器计算电流和功率。核心寄存器包括：分流电压寄存器（LSB=2.5μV）、总线电压寄存器（LSB=1.25mV）、电流寄存器和功率寄存器。用户通过校准寄存器（CAL）设置电流LSB：CAL = 0.00512 / (Current_LSB × Rshunt)，芯片内部自动完成电流=Vshunt/Rshunt、功率=电流×电压的计算。ADC采样率固定为500kHz，通过配置转换时间（140μs\~8.244ms）和平均次数（1\~1024）在精度与速度之间权衡。CMRR高达126dB，确保在36V高共模电压下仍能精确测量微伏级差分信号。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别32：电能计量芯片

要点1：什么是电能计量芯片

电能计量芯片是专门用于测量交流/直流电路中电压、电流、有功功率、无功功率、功率因数、电能等参数的专用集成电路。其内部集成了高精度Σ-Δ ADC阵列、数字信号处理单元和电能累加引擎，能够直接输出工程量级别的电参数数据，无需主控设备（例如合宙AirXXXX模组）进行复杂的采样和运算。现代电能计量芯片普遍支持"免校准"技术（出厂增益误差\<1%），配合1%精度外围电阻即可达到2%整机精度，极大简化了生产流程。主要功能包括：电压/电流有效值测量、有功/无功功率计算、电能脉冲累加、过流/过压保护、漏电监测和负载类型波形分析等。

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
BL0910	上海贝岭（Belling）	UART/SPI	11路Σ-Δ ADC；1U10I模式10路电能计量；动态范围5000:1；内置温度传感器；LQFP48封装	多路免校准计量，支持10路电流通道，漏电监控1mA分辨率，适合多路充电桩/智能插排
BL0939	上海贝岭（Belling）	UART/SPI（4800bps/900kHz）	3路Σ-Δ ADC；2路电流+1路电压；电流范围10mA\~35A@1mΩ；SSOP20/SOP16封装	双路免校准计量，双路漏电/过流监控，支持多片级联，适合双口智能插座
BL0942	上海贝岭（Belling）	UART/SPI（4800-38400bps/900kHz）	2路Σ-Δ ADC；1路电流+1路电压；电流范围10mA\~30A@1mΩ；SSOP10L/TSSOP14封装	单路免校准计量，外围极简，过流保护可配置，适合智能插座/家电
HLW8110	深圳合力为（Hiliwi）	UART	3路Σ-Δ ADC；1路电流+1路电压；动态范围3000:1；精度0.1%；SOP8封装	单路计量，超小封装，免校准，内置温度传感器，过零/过流检测，成本极低
HLW8112	深圳合力为（Hiliwi）	UART/SPI	3路Σ-Δ ADC；2路电流+1路电压；动态范围5000:1；精度0.1%；SSOP16封装	双路计量，支持漏电检测/窃电检测，双路中断输出，适合多路智能插座

要点3：应用场景

智能插座与智能排插（单路/多路用电计量）
电动自行车充电桩（多路充电计量与计费）
智能家电能耗监测（空调、冰箱、洗衣机等）
工业用电监测与能耗管理
光伏逆变与储能电池检测
智能路灯与交通用电管理

要点4：硬件接口设计

以BL0942为例（UART模式，最简方案）：

┌──────────────┐                       ┌──────────┐
│  合宙模组    │                       │  BL0942  │
│(AirXXXX模组) │                       │ (电能计量)│
│              │                       │          │
│  UART TX ────┼──[1kΩ]────────────────│RX/SDI    │
│  UART RX ────┼──[1kΩ]────────────────│TX/SDO    │
│  3.3V   ─────┼───────────────────────│VDD       │
│  GND    ─────┼───────────────────────│GND       │
│  GPIO   ─────┼───────────────────────│SEL       │──> 接GND选UART模式
│              │                       │ IP  IN   │──> 接电流采样电阻(1mΩ)两端
│              │                       │ VP       │──> 接电压分压网络
│              │                       │ CF1      │──> 电能脉冲/过流告警(可选)
└──────────────┘                       └──────────┘

  电压采样:  火线 ──[390kΩ×5]──┬──[0.51kΩ]── GND
                              └──> VP引脚
  电流采样:  火线 ──[1mΩ锰铜电阻]── 负载
                    └─IP  IN─┘

注意事项：

电流采样推荐使用1mΩ精度1%的锰铜/合金电阻，采用开尔文连接
电压分压电阻需选用1%精度、低温漂（\<50ppm/°C）的金属膜电阻
采样电阻需紧贴芯片安装，PCB布线避免与强电回路并行
UART通信线长度控制在10cm以内，TX/RX需外接上拉电阻
BL0942供电3.3V，与合宙模组直接兼容
涉及强电，需注意隔离和安全间距

要点5：工作原理

电能计量芯片的核心架构为"AFE + Σ-Δ ADC + DSP"流水线。以BL0942为例：电压信号经分压电阻网络降压后送入VP引脚（mV级），电流信号经锰铜采样电阻转换为差分电压送入IP/IN引脚（mV级）。两路模拟信号分别经内部PGA放大后，由24位Σ-Δ ADC进行高速数字化采样。数字信号处理单元执行以下运算：电压/电流有效值（RMS）计算（对采样值平方、积分、开方）；瞬时有功功率（电压瞬时值×电流瞬时值）；有功功率（对瞬时功率低通滤波提取直流分量）；电能累加（对有功功率时间积分，产生电能脉冲）；过零检测（检测电压波形过零点，用于频率测量和相位校正）；防潜动（功率低于阈值时停止电能累加，防止噪声计入）。出厂时芯片增益已激光修调至\<1%，内置1.218V带隙基准源和4MHz RC振荡器，无需外部晶振和基准。UART通信采用简单帧格式，主控设备（例如合宙AirXXXX模组）可直接读取电压、电流、功率、电能等寄存器值。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别33：ADC传感器

要点1：什么是ADC传感器

ADC传感器是指通过模数转换器（ADC）将模拟传感器信号转换为数字量的器件或模块。广义上包括独立外置ADC芯片和集成了ADC功能的专用测量芯片。外置ADC芯片能够提供比主控设备（例如合宙AirXXXX模组）内置ADC更高的分辨率、精度和灵活性，适用于微弱信号采集、多通道测量和精密仪器等场景。其主要功能包括：多通道模拟信号采集、可编程增益放大、差分/单端输入选择、数字滤波和数据速率配置等。在工业测量、称重、温度检测、气体分析等领域，高精度ADC是实现可靠测量的核心器件。

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
ADS1115	Texas Instruments（德州仪器）	I2C（4个可选地址）	16位Δ-Σ ADC；4路单端/2路差分；PGA增益±256mV\~±6.144V；数据速率8-860SPS；供电2.0-5.5V；功耗150μA	内置基准源和振荡器，集成可编程比较器，超小封装(X2QFN/SOT)，4个I2C地址支持多芯片挂载
CS1237	芯海科技（Chipsea）	2线SPI（SCLK+DOUT/DRDY）	24位Σ-Δ ADC；1路差分输入；PGA增益1/2/64/128；数据速率10/40/640/1280Hz；ENOB 20位@PGA=128；供电3.3/5V	内置温度传感器和振荡器，极低噪声(30nV@PGA=128)，SOP8封装，适合精密称重和工业测量
SC12A	厦门晶尊微（ICman）	I2C/BCD码输出	12通道电容式触摸；自校正功能；工作电压2.5-6V；SOP24封装	12路独立触摸按键，自动校准无需主控设备（例如合宙AirXXXX模组）干预，所有按键共用一个灵敏度电容，感应线长度不同不影响灵敏度

要点3：应用场景

ADS1115：便携式仪器、电池电压/电流监测、温度测量系统、工厂自动化与过程控制
CS1237：电子衡器（高精度电子秤）、精密测量与控制系统、液体/气体化学分析、智能变送器
SC12A：替代机械开关、家电触控面板（电视/显示器键盘）、门禁按键、灯控开关、密封键盘面板

要点4：硬件接口设计

以ADS1115为例（I2C接口）：

┌──────────────┐                    ┌──────────┐
│  合宙模组    │                    │ ADS1115  │
│(AirXXXX模组) │                    │(16位ADC) │
│              │                    │          │
│I2C SCL ──────┼──[4.7kΩ]─3.3V──────┤SCL       │
│I2C SDA ──────┼──[4.7kΩ]─3.3V──────┤SDA       │
│3.3V    ──────┼────────────────────┤VDD       │
│GND     ──────┼────────────────────┤GND       │
└──────────────┘                    │ ADDR     │──> 接GND(地址0x48)
                                    │ AIN0~AIN3│──> 接模拟传感器信号
                                    │ ALERT    │──> 比较器告警输出(可选)
                                    └──────────┘

注意事项：

ADS1115供电电压决定I2C电平和模拟输入范围，3.3V供电与AirXXXX模组直接兼容
I2C上拉电阻4.7kΩ（400kHz），模拟输入不可超过VDD+0.3V
PGA增益设置需匹配信号幅度：±6.144V（最大量程）到±256mV（最高灵敏度）
CS1237采用2线SPI接口，SCLK最高1.1MHz，需用GPIO模拟时序
SC12A的CDC引脚接灵敏度电容（15-100pF），值越小灵敏度越高

要点5：工作原理

ADS1115：采用Δ-Σ调制架构，内部包含可编程增益放大器（PGA）、Δ-Σ调制器和数字滤波器。输入信号经MUX多路复用器选择后进入PGA放大，再由Δ-Σ调制器进行过采样和噪声整形，最后经数字抽取滤波器输出16位数据。PGA提供8档增益（±6.144V至±256mV），数据速率可编程（8-860SPS）。内置低漂移电压基准和振荡器，无需外部元件。数字比较器可设置上下限阈值，当转换结果超出范围时通过ALERT引脚输出告警。

CS1237：采用二阶Σ-Δ调制器，通过低噪声仪用放大器结构实现PGA放大（1/2/64/128倍）。在PGA=128时有效分辨率达20位（5V供电），噪声仅30nV。数据以24位补码格式输出，MSB先出。通过SCLK脉冲数控制功能模式：前24个SCLK读取ADC数据，第25-26个SCLK读取寄存器写状态，第27个SCLK将DRDY拉高。内置温度传感器和Power-down模式，静态电流仅100nA。

SC12A：基于电荷转移型容性感应架构。每个通道以约12.5ms间隔采样一次，通过检测感应盘电容变化判断触摸。内置自校正引擎可自动跟踪环境温湿度漂移，触摸反应时间约68ms。支持I2C串行接口和BCD码并行输出两种模式，按键输出经过完全消抖处理。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别34：热电偶传感器

要点1：什么是热电偶传感器

热电偶传感器是利用塞贝克效应（Seebeck Effect）进行温度测量的器件：由两种不同金属导体组成闭合回路，当两端温度不同时回路中产生热电势，该电势与温差成正比。热电偶可测量-210°C至+1800°C的超宽温度范围，是工业高温测量的首选方案。由于热电偶输出信号极其微弱（数十微伏/°C），且电压-温度关系非线性，需要专用调理芯片进行信号放大、冷端补偿和线性化处理。专用热电偶/RTD转换芯片（如MAX31856/MAX31865）将上述全部功能集成于单芯片内，直接通过SPI接口输出数字温度值，极大简化了系统设计。

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
MAX31856	Analog Devices（ADI/原Maxim Integrated）	SPI（最高5MHz）	19位分辨率(0.0078125°C)；支持K/J/N/R/S/T/E/B型8种热电偶；测量范围-210°C\~+1800°C；精度±0.15%；冷端补偿精度±0.7°C；TSSOP-14封装	集成冷端补偿和自动线性化校正（内置NIST查找表），50/60Hz噪声滤波，开路检测，±45V输入保护
MAX31865	Analog Devices（ADI/原Maxim Integrated）	SPI（模式1和3）	15位ADC分辨率(0.03125°C)；支持PT100/PT1000铂电阻RTD；兼容2/3/4线连接；总精度0.5°C；转换时间21ms；TQFN/SSOP-20封装	RTD至数字转换器，外部参考电阻设定灵敏度，±45V输入保护，开路/短路故障检测，可编程激励电流(500μA/1mA)

要点3：应用场景

工业烤箱、热处理炉和高温环境试验箱温度控制
3D打印机挤出头和热床温度测量
实验室精密测温与科学实验设备
电力设备与变压器温度监测
医疗灭菌设备温度监控
汽车排气温度和发动机温度检测

要点4：硬件接口设计

以MAX31856为例（SPI接口）：

合宙模组              MAX31856
(AirXXXX模组)            (热电偶转换器)
                         ┌──────────┐
  SPI SCK  ──────────────│SCK        │
  SPI MISO ──────────────│SDO        │
  SPI MOSI ──────────────│SDI        │
  GPIO CS  ──────────────│CS         │
  3.3V    ──────────────│DVDD AVDD  │
  GND     ──────────────│GND        │
                         │ T+  T-    │──> 接热电偶正负极
                         │ BIAS      │──> 接T-（偏置信号）
                         │ DRDY      │──> 数据就绪(可选)
                         │ FAULT     │──> 故障告警(可选)
                         └──────────┘

注意事项：

MAX31856供电3.3V，与合宙模组直接兼容；SPI的CPHA必须为1（SPI模式1或3）
热电偶连接线应使用对应分度号的补偿导线（如K型用K型线）
T+/T-输入有±45V过压保护，但仍需避免高压意外接入
MAX31865的参考电阻RREF必须选用0.1%精度、低温漂（\<10ppm/°C）的精密电阻
PT100推荐RREF=430Ω，PT1000推荐RREF=4.3kΩ
4线制RTD连接可完全消除引线电阻影响，精度最高
SPI时钟推荐1-2MHz，CS必须独立控制

要点5：工作原理

MAX31856：热电偶由两种不同金属（如K型的镍铬-镍硅）组成，热端（测量端）与冷端（接线端）温差产生塞贝克电势（K型约41μV/°C）。MAX31856内部信号链为：热电偶差分信号->低噪声PGA放大->19位Δ-Σ ADC数字化->数字滤波（50/60Hz陷波）->硬件线性化引擎（查表+插值）->输出摄氏温度值。芯片内置温度传感器实时测量冷端温度并进行补偿（CJC），补偿精度±0.7°C。内部固化了NIST标准热电偶分度表（ITS-90）的分段线性化参数，通过专用硬件逻辑实时执行，线性化误差典型值\<±0.1°C。开路检测通过向热电偶回路注入微弱电流并监测电压响应实现。转换周期最大110ms，采样率约9SPS。

MAX31865：基于比例测量原理。内部提供可编程激励电流（500μA或1mA）流过RTD和参考电阻RREF串联电路，ADC测量RTD两端电压与RREF两端电压的比值：R_RTD = (ADC_Code × R_REF) / 2^15。由于采用比例测量，激励电流的精度和稳定性不影响结果，参考电阻的精度直接决定测量精度。15位ADC提供0.03125°C的标称分辨率。支持2线、3线和4线连接方式：4线制通过独立的FORCE和SENSE引脚完全消除引线电阻误差；3线制利用第三根线补偿引线电阻；2线制最简单但引线电阻直接引入误差。故障检测包括RTD开路、短路到异常电压和RTD元件短路。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别35：颜色传感器

要点1：什么是颜色传感器

颜色传感器是一种能够检测入射光中红（R）、绿（G）、蓝（B）分量及总光强（Clear）的集成化光电检测器件。其内部集成了多个光电二极管阵列（分别覆盖不同光谱响应），配合可编程增益放大器（PGA）、16位ADC和I2C接口，可直接输出数字化的RGB及Clear通道数据。高端颜色传感器（如TCS3472）在芯片上集成了红外阻隔滤光片（IR-blocking filter），有效消除红外光成分对色彩测量的干扰，确保颜色识别的准确性。其主要功能包括：RGB色彩测量、环境光亮度检测、色温计算、显示亮度自动调节和色彩匹配等。

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
TCS3472	ams OSRAM（艾迈斯欧司朗）	I2C（400kHz，固定地址0x29）	16位ADC；4通道(RGBC)；动态范围3.8M:1；集成IR阻隔滤光片；可编程增益(1x/4x/16x/60x)；积分时间2.4-614.4ms；供电2.7-3.6V；功耗65μA	芯片级集成IR滤光片，高灵敏度宽动态范围，支持等待状态低功耗模式，FN-6封装(2.0×2.4mm)，ID寄存器0x44可校验

要点3：应用场景

RGB LED背光控制与色温调节
显示器/手机/平板环境光自适应亮度控制
工业过程控制（颜色匹配、色差检测）
医疗诊断设备（血液/尿液比色分析）
智能照明系统（日光跟踪、自动调色）
物体颜色识别与分类（分拣机器人）

要点4：硬件接口设计

┌──────────────┐                       ┌──────────┐
│  合宙模组     │                       │ TCS3472  │
│(AirXXXX模组) │                       │(颜色传感器)│
│              │                       │          │
│  I2C SCL ────┼──┬────────────────────│SCL       │
│              │  └─[4.7kΩ]─3.3V       │          │
│  I2C SDA ────┼──┬────────────────────│SDA       │
│              │  └─[4.7kΩ]─3.3V       │          │
│  3.3V   ─────┼───────────────────────│VDD       │
│  GND    ─────┼───────────────────────│GND       │
│              │                       │ INT      │──> 中断输出(可选，低有效)
│              │                       │ LED      │──> 外部LED驱动使能(可选)
└──────────────┘                       └──────────┘
                                       顶部感光区朝向被测光源

注意事项：

TCS3472固定I2C地址0x29，不支持地址修改，同总线只能挂载1个
供电3.3V与合宙模组直接兼容，需0.1μF+1μF去耦电容
I2C上拉电阻4.7kΩ（400kHz模式）
传感器顶部需预留透光窗口或导光柱，避免遮挡
INT引脚为开漏输出，需上拉电阻；用于阈值中断触发
PCB布线避免SCL/SDA靠近高频信号，传感器远离热源

要点5：工作原理

TCS3472内部集成了4个独立的光电二极管阵列，分别覆盖红光（R）、绿光（G）、蓝光（B）和全光谱（Clear）响应区域。每个通道配备了独立的16位Δ-Σ ADC进行同步转换。关键特性是芯片级集成的红外阻隔滤光片（IR-blocking filter），直接定位在颜色感光光电二极管上方，有效衰减入射光中>700nm的近红外成分，使RGB色彩还原更准确。

工作流程为：上电->等待300ms初始化->配置ENABLE寄存器（PON=1, AEN=1）->设置积分时间和增益->ADC同步积分4通道->数据存入RGBC寄存器->主控设备（例如合宙AirXXXX模组）通过I2C读取。积分时间决定每个通道的曝光时长，较短积分时间适合强光环境（避免饱和），较长积分时间提升弱光信噪比。可编程增益（1x/4x/16x/60x）进一步扩展动态范围至3.8M:1。等待状态（WEN）允许在两次测量间进入低功耗模式，降低平均功耗。ID寄存器（地址0x12）固定返回0x44，可用于器件识别和总线诊断。

色温计算公式：CCT ≈ -4490×(R/B)^3 + 2927×(R/B)^2 - 729×(R/B) + 1382（近似公式，适用于3000K-10000K范围）

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

第五篇：执行器与驱动模块

类别36：继电器

要点1：什么是继电器

继电器（Relay）是一种利用电磁原理实现电路通断控制的电气开关器件。当控制线圈通电时产生磁场，吸合衔铁带动触点动作，从而实现小电流（控制端）控制大电流（负载端）的电气隔离开关功能。电磁继电器是最经典的电气控制元件，具有负载能力强、导通电阻极低、隔离电压高、抗干扰性强等优点。在物联网和工业控制领域，继电器广泛用于主控设备（例如合宙AirXXXX模组）（3.3V/5V低压控制）到强电负载（220V/10A等）的功率切换。主要功能包括：大功率负载开关、电气隔离、多路切换、延时控制和安全保护等。

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
SRD-05VDC-SL-C	松川/宏发/汇港等多家厂商	GPIO电平控制（线圈驱动）	线圈电压5VDC；触点容量10A/250VAC或10A/30VDC；线圈功耗约0.36W；吸合时间\<10ms；绝缘耐压1500VAC	最常用的5V小型电磁继电器，体积小(15×19×15mm)，1路常开+常闭触点，可靠性高，成本低
SRD-12VDC-SL-C	同上	GPIO电平控制	线圈电压12VDC；触点容量同上；线圈功耗约0.36W	12V版本，适合车载和工业12V供电场景
JQC-3FF-5V	多家国产厂商	GPIO电平控制	线圈电压5VDC；触点容量10A/250VAC；功耗0.45W	国产通用型，引脚兼容SRD系列
G3MB-202P	欧姆龙（OMRON）	GPIO电平控制	线圈电压5VDC；负载电流2A/240VAC；固态继电器	固态继电器(SSR)，无机械触点，寿命长，无火花，适合频繁切换

要点3：应用场景

智能家居电器控制（灯光、风扇、窗帘、热水器远程开关）
工业自动化设备启停控制
智能插座与电源控制
安防报警系统（警铃、门锁触发）
农业灌溉与水泵控制
充电桩通断控制与安全保护

要点4：硬件接口设计

继电器线圈需要较大驱动电流（约70-100mA@5V），主控设备（例如合宙AirXXXX模组） GPIO无法直接驱动，需通过三极管或专用驱动芯片控制。

     合宙模组             驱动电路                 继电器
  (AirXXXX模组)
  ┌────────────┐         ┌──[1kΩ]──┐              ┌──[ ]──┐ +5V
  │            │         │         │              │  5V   │
  │   GPIO X ──┼─────────┤   NPN   │              │ 线圈  │
  │            │         │  三极管  │              │       │
  │            │         │  S8050  │──────────────┤       │
  │            │         │         │              │       │
  │   GND    ──┼─────────┤ Emitter │              └──┬────┘
  └────────────┘         └────┬────┘                   │
                              │                 ┌────┴─────┐
                              GND               │续流二极管│ 1N4007
                                                │  (反向)  │
                                                └────┬─────┘
                                                     │
                                                    GND

  继电器触点:  COM ──> 负载
               NO  ──> 常开输出（上电闭合）
               NC  ──> 常闭输出（上电断开）

注意事项：

继电器线圈必须并联续流二极管（1N4007或1N4148），防止线圈断电时反向电动势击穿三极管
驱动三极管推荐S8050（NPN）或SI2302（MOSFET），基极串联1kΩ电阻
继电器供电（5V/12V）与主控设备（例如合宙AirXXXX模组）供电（3.3V）需独立，共地
涉及220V强电时需保证爬电距离和安全间距，建议使用光耦隔离
触点两端可并联RC吸收网络（0.1μF+100Ω）减少电弧
推荐使用成品继电器模块（内置驱动电路和光耦），简化设计

要点5：工作原理

电磁继电器的工作原理基于电磁感应。当线圈两端施加额定电压（如5VDC）时，电流流过线圈产生磁场，磁通通过铁芯、衔铁和气隙形成闭合磁路。磁场产生的电磁力克服复位弹簧的弹力，将衔铁吸合，衔铁带动动触点从常闭（NC）触点切换到常开（NO）触点，实现电路状态切换。线圈断电后磁场消失，复位弹簧将衔铁弹回，触点恢复原状态。

关键参数：吸合电压通常为额定电压的70-80%；释放电压通常为额定电压的10-20%；吸合时间典型值5-10ms；触点接触电阻\<50mΩ（远低于固态开关）；机械寿命通常>10^7次；电气寿命通常>10^5次（满负载）。线圈断电瞬间，电感储能产生反向高压尖峰（可达数百伏），必须通过续流二极管泄放，否则将损坏驱动器件。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别37：电机驱动

要点1：什么是电机驱动

电机驱动芯片（Motor Driver IC）是一种用于控制电动机运行的功率集成电路。其主要功能是将微控制器（主控设备（例如合宙AirXXXX模组））输出的低压逻辑控制信号转换为能够驱动电机运转的高电压、大电流功率信号。电机驱动芯片内部通常集成H桥（H-Bridge）电路，通过控制功率MOSFET的导通与关断，实现电机的正转、反转、制动和停止控制，同时支持通过PWM信号调节电机转速。

电机驱动芯片还集成多种保护功能，包括过流保护（OCP）、过热保护（TSD）、欠压锁定（UVLO）和短路保护等，确保电机和电路在异常工况下的安全运行。在物联网、智能家居、工业自动化等领域，电机驱动芯片是电磁锁、阀门控制、风扇驱动、机器人运动控制等应用的核心器件。

要点2：常见型号与特点

型号	厂商	通信接口	关键参数	特点
BL2529	上海贝岭(Belling)	GPIO（INA/INB）	工作电压3.0\~25V，持续电流1.5A，峰值3.5A，RDS(ON)约350mΩ，SOP-8	低压H桥驱动，低待机电流，内置过流过温保护，适用于玩具和低压电池供电设备
RZ7899MS	美森科(MSKSEMI)	GPIO（FIN/BIN）	工作电压3.0\~30V，持续电流3A，峰值6A，RDS(ON)约80mΩ，待机电流\<1µA，SOP-8	超低导通电阻，大电流驱动能力，内置续流二极管，适用于电子锁和自动阀门
AT8236	中科微电子(ZKMICRO)	GPIO（IN1/IN2）+ VREF	工作电压5.5\~36V（最大40V），持续电流4A，峰值6A，RDS(ON)约200mΩ，ESOP-8	宽电压范围，集成同步整流，PWM电流调节，低功耗休眠模式，适用于家电和工业控制
RDC506018A	阿尔卑斯阿尔派(ALPS Alpine)	模拟分压输出	额定电压5V DC，总电阻值10kΩ，旋转角度0°\~320°，线性精度±2%，工作温度-40°C\~+120°C，SMD-4P	旋转式电阻位置传感器，用于电机位置反馈，长寿命100万次，高线性度

> 说明：RDC506018A 严格来说是旋转位置传感器而非电机驱动器，但在电机控制系统中常与驱动芯片配合使用，提供精确的转角位置反馈信号，构成闭环控制。

要点3：应用场景

- 智能电子锁：驱动电磁锁体开/关动作，RZ7899MS凭借低导通电阻和大电流能力广泛应用

- 智能水阀/燃气阀：自动阀门电机驱动，需要正反转控制和低功耗待机

- 智能家居窗帘/晾衣架：直流电机驱动，通过PWM实现调速控制

- 扫地机器人/玩具车：驱动轮子电机，BL2529适用于低压电池供电场景

- 工业打印机/办公设备：AT8236适用于24V供电的工业级电机驱动

- 电机位置反馈系统：RDC506018A安装在电机轴上，提供角度位置反馈信号

要点4：硬件接口设计

通信接口说明：电机驱动芯片通常使用GPIO逻辑电平控制，不需要I2C/SPI等复杂通信协议。主控设备（例如合宙AirXXXX模组）通过2个GPIO引脚控制电机的方向（正转/反转/停止/制动），通过PWM信号控制转速。RDC506018A则通过ADC读取分压值获取角度信息。

ASCII接线图（以RZ7899MS为例）：

合宙模组(AirXXXX模组)              RZ7899MS           电机
  ┌──────────┐                ┌──────────┐      ┌──────┐
  │          │                │          │      │      │
  │  GPIO12  │────────────────│ FIN(1)   │      │  M+  │
  │  GPIO13  │────────────────│ BIN(2)   │      │      │
  │          │                │          │──────│      │
  │  GND     │────────────────│ GND(5)   │      │  M-  │
  │          │                │ OUT(5,6) │──────│      │
  │          │                │ OUT(7,8) │      │      │
  └──────────┘                └──────────┘      └──────┘
                                    │
                               VM(3)│─── 电机电源(6~24V)
                                    │
                              ┌─────┴─────┐
                              │  100µF    │
                              │  电解电容  │
                              └─────┬─────┘
                                    │
                                   GND

ASCII接线图（以RDC506018A为例）：

合宙模组(AirXXXX模组)           RDC506018A
  ┌──────────┐              ┌──────────┐
  │          │              │          │
  │ VDD(3.3V)│──────┬───────│ VCC(1)   │
  │          │      │       │          │
  │          │    10kΩ      │  GND(2)  │─── GND
  │          │      │       │          │
  │  ADC0    │──────┴───────│ OUT(3)   │
  │          │              │          │
  │  GND     │──────────────│ GND(4)   │
  └──────────┘              └──────────┘

注意事项：

电机电源（VM）应与逻辑电源分开供电，避免电机噪声干扰主控设备（例如合宙AirXXXX模组）
VM引脚必须就近并联100µF电解电容和0.1µF陶瓷电容，抑制电机启停时的电源尖峰
电机两端并联0.1µF电容，减少换向火花干扰
电机驱动芯片的GND应与主控设备（例如合宙AirXXXX模组）共地，但建议在GND走线上采用单点接地方式
RDC506018A的输出为模拟分压信号，需通过ADC采集，建议使用12位以上ADC
AT8236的VREF引脚可用于实时电流限制调节，可接主控设备（例如合宙AirXXXX模组）的DAC或PWM经过RC滤波后的模拟电压

要点5：工作原理

电机驱动芯片的核心是H桥电路。H桥由四个功率MOSFET组成（两个高侧、两个低侧），排列成H形结构，电机位于H的横杠位置。

- 正转：左上管和右下管导通，电流从左流向右经过电机

- 反转：右上管和左下管导通，电流从右流向左经过电机

- 制动：两个下管同时导通，电机两端短路，电机惯性转动产生的反电动势形成制动电流

- 停止：所有管关断，电机两端高阻态，电机自由滑行

高侧MOSFET的驱动需要高于源极的栅极电压，通常通过内部电荷泵（Charge Pump）电路实现。PWM信号通过交替控制H桥的导通与关断，改变电机两端的平均电压，从而实现调速。

RZ7899MS内置续流二极管，在电机换向时释放感性负载的反向冲击电流。AT8236集成同步整流功能，在PWM关断期间利用低侧MOSFET的导通替代续流二极管，显著降低功耗。

RDC506018A采用电阻式角度检测原理：内部电阻体（10kΩ）随旋转轴转动而改变有效阻值，输出引脚的电压随之线性变化，ADC采集该电压即可计算出旋转角度（0°\~320°范围内线性精度±2%）。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别38：LED驱动

要点1：什么是LED驱动

LED驱动芯片（LED Driver IC）是专门用于控制LED发光二极管显示的集成电路。其主要功能包括：为LED提供恒定电流或恒定电压驱动、实现多路LED的独立亮度控制（PWM灰度调节）、支持级联扩展以控制大量LED、集成键盘扫描功能实现人机交互等。

LED驱动芯片广泛应用于数码管显示、LED点阵屏、LED装饰灯带、智能照明、家电显示面板等场景。根据通信接口的不同，可分为两类线串行接口（如TM1640/TM1650/TM1637）、三线串行接口（如TM1638）、单线级联接口（如WS2812/TM1829）和双线时钟+数据接口（如WS2801）等类型。

要点2：常见型号与特点

型号	厂商	通信接口	关键参数	特点
TM1640	天微电子(Titan Micro)	两线串行（CLK, DIN）	工作电压2.8\~5.5V，8段×16位，段电流25mA，位电流80mA，8级辉度可调，SOP-28	大容量数码管驱动，支持16位共阴数码管，内置RC振荡，辉度调节
TM1650	天微电子(Titan Micro)	两线串行（SCL, SDA）	工作电压2.8\~5.5V，8段×4位，段电流>25mA，位电流>150mA，8级亮度，键盘扫描7×4bit，SOP-16	集成键盘扫描，适合家电显示+按键面板，24小时连续工作
TM1829	天微电子(Titan Micro)	单线级联（DIN, DO）	工作电压6\~24V（内置5V稳压），3通道恒流输出，恒流10\~41mA（32级可调），256级PWM辉度，SOP-8	RGB LED恒流驱动，支持级联1024点，7kHz扫描频率，适合点光源和灯条
WS2801	晶丰明谱(WorldSemi)	双线（DATA, CLOCK）	工作电压3.3\~5.5V，3通道恒流输出，恒流5\~30mA，256级PWM，最高时钟25MHz，SOP-14	外置恒流驱动IC，高速时钟同步，PWM刷新率2.5kHz，支持级联
WS2812	晶丰明谱(WorldSemi)	单线归零码（DIN）	工作电压3.7\~5.3V，集成RGB LED+驱动IC，每通道约18.5mA，256级灰度，数据速率800Kbps，5050封装	集成化像素点，内置信号整形电路，单线级联，1670万色，外围无需器件
TM1638	天微电子(Titan Micro)	三线串行（CLK, STB, DIO）	工作电压4.5\~5.5V，10段×8位，段电流20mA，位电流80mA，8级辉度，键盘扫描8×3bit，SOP-28	数码管+LED+按键三合一驱动，适合冰箱/空调等家电面板

要点3：应用场景

- 家电显示面板：微波炉、电磁炉、热水器、空调等家电的数码管显示和按键控制（TM1640/TM1650/TM1638）

- LED装饰灯带：点光源、护栏管、软灯条等RGB LED装饰照明（TM1829/WS2812/WS2801）

- 电子秤/血压计：高精度数码管显示驱动（TM1640）

- 智能音箱/机顶盒：4位数码管时间显示+按键面板（TM1650）

- LED视频屏：室内外LED信息显示和视频屏级联驱动（WS2801/TM1829）

- 消费电子指示灯：电竞设备、智能设备的RGB氛围灯效控制（WS2812）

要点4：硬件接口设计

通信接口说明：

TM1640/TM1650/TM1637：采用类似I2C的两线串行接口（CLK+DIO/SDA），但协议非标准I2C
TM1638：采用三线串行接口（CLK+STB+DIO），STB为片选信号
WS2801：采用双线同步接口（DATA+CLOCK），需要两根信号线
WS2812：采用单线归零码（NZR）协议，仅需一根数据线
TM1829：采用单线级联接口（DIN→DO），数据信号逐级转发

ASCII接线图（以TM1638为例）：

合宙模组(AirXXXX模组)              TM1638模块
  ┌──────────┐                ┌──────────────┐
  │          │                │              │
  │  GPIO16  │────────────────│ CLK          │
  │  GPIO17  │────────────────│ DIO     ┌───┐│
  │  GPIO18  │────────────────│ STB     │8× ││  8位数码管
  │          │                │         │LED││  + 8个LED
  │  VDD(5V) │────────────────│ VCC     └───┘│
  │  GND     │────────────────│ GND     ┌───┐│
  │          │                │         │8× ││  8个按键
  └──────────┘                └────────-└KEY┘┘

ASCII接线图（以WS2812为例）：

合宙模组(AirXXXX模组)           WS2812 LED灯带
  ┌──────────┐               ┌──────┐   ┌──────┐   ┌──────┐
  │          │               │      │   │      │   │      │
  │  GPIO4   │───────────────│ DIN  │   │ DIN  │   │ DIN  │
  │          │               │      │───│ DOUT │───│ DOUT │
  │  VDD(5V) │───────────────│ VDD  │   │ VDD  │   │ VDD  │
  │  GND     │───────────────│ GND  │   │ GND  │   │ GND  │
  │          │               └──────┘   └──────┘   └──────┘
  └──────────┘                LED1        LED2       LED3

注意事项：

TM系列芯片的VDD和VSS之间必须接100µF电解电容+0.1µF陶瓷电容，且尽量靠近芯片引脚（PCB走线\<3cm）
WS2812灯带供电电流较大（每颗LED全白约60mA），100颗LED可达6A，需独立电源供电
WS2812数据线建议串联300\~500Ω电阻，抑制信号反射
3.3V 主控设备（例如合宙AirXXXX模组）驱动5V WS2812时，建议加电平转换电路（如74HCT125），否则可能通信不稳定
TM1638的DIO口在读键时需外接10kΩ上拉电阻
通信线在强干扰环境下（如电磁炉附近）建议串接100\~200Ω电阻

要点5：工作原理

TM1640/TM1650/TM1637/TM1638系列芯片内部集成显示寄存器（Display RAM）、段驱动电路、位驱动电路和键盘扫描电路。主控设备（例如合宙AirXXXX模组）通过串行接口将显示数据写入显示寄存器，芯片内部的RC振荡器自动完成动态扫描，在段引脚和位引脚之间按时序交替导通，实现LED数码管的动态显示。辉度调节通过控制每个位输出周期的占空比实现（8级可调）。

WS2801采用标准的时钟同步数据传输方式。主控设备（例如合宙AirXXXX模组）在时钟上升沿将数据移入芯片内部的移位寄存器，24位数据（R/G/B各8位）对应一个像素点。当数据传输完成后，芯片内部的PWM控制器根据灰度值控制每通道LED的导通时间，实现256级灰度调节。数据可级联传输，芯片将输入的数据和时钟整形后通过输出引脚转发给下一级。

WS2812将LED驱动IC与RGB LED芯片集成在同一封装中，构成一个完整的像素点。采用单线归零码（NRZ）通信协议：每个数据位由高电平和低电平组成，高电平持续时间决定该位是0还是1（0码高电平约0.35µs，1码高电平约0.7µs）。每个像素点接收24位数据（按GRB顺序），截取自己的24位后，将剩余数据整形转发给下一级。当数据线保持低电平超过50µs时，触发锁存更新，所有像素点同时刷新显示。

TM1829的工作原理与WS2812类似，但增加了恒流驱动功能。内部集成恒流源电路，通过外部SET引脚可选择高速/低速模式，恒流值可在10\~41mA范围内32级调节，PWM灰度256级可调，扫描频率7kHz。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别39：数码管驱动

要点1：什么是数码管驱动

数码管驱动芯片是专门用于驱动LED数码管（七段/八段显示器）的集成电路。与通用LED驱动芯片相比，数码管驱动芯片更专注于多位数码管的动态扫描显示，通常集成段驱动输出、位驱动输出、显示寄存器和亮度调节电路，部分型号还集成键盘扫描功能。

数码管驱动芯片通过内部振荡器自动完成动态扫描，主控设备（例如合宙AirXXXX模组）只需将显示数据写入芯片的显示寄存器，芯片即可自动维持数码管显示，无需主控设备（例如合宙AirXXXX模组）持续刷新。这大幅降低了主控设备（例如合宙AirXXXX模组）的CPU占用率，特别适合资源受限的嵌入式系统。

要点2：常见型号与特点

型号	厂商	通信接口	关键参数	特点
TM1637	天微电子(Titan Micro)	两线串行（CLK, DIO）	工作电压2.8\~5.5V，8段×6位，段电流>20mA，位电流>80mA，8级亮度可调，键盘扫描8×2bit，DIP20/SOP20	4位数码管模块常用芯片，内置抗干扰按键识别电路，协议非标准I2C（LSB优先）
AIP650E	中微爱芯(Wuxi I-core)	两线串行（SCL, SDA）	工作电压3\~5.5V，8段×4位，段电流≥25mA，位电流≥150mA，8级亮度，键盘扫描7×4bit（支持组合按键），SOP-16	TM1650兼容替代，支持组合按键功能，抗干扰能力强，24小时连续工作

要点3：应用场景

- 电磁炉/微波炉显示面板：TM1637常用于厨房家电的数码管显示和按键控制，内置抗干扰电路

- 智能温控器：4位数码管显示温度值，配合按键设置目标温度

- 电子秤/计量设备：高亮度数码管显示重量或计量数据

- 智能门锁面板：AIP650E驱动数码管显示密码输入提示和状态信息

- 工业仪表：显示压力、流量、电压等测量值，支持按键校准

- 充电桩/电源管理：显示电压、电流、功率等参数

要点4：硬件接口设计

通信接口说明：TM1637和AIP650E均采用两线串行接口（CLK+DIO/SDA），但通信协议与标准I2C有所不同。TM1637的数据传输为LSB优先（低位先传），而标准I2C为MSB优先。两者都没有从机地址，通过命令字节区分操作类型。DIO/SDA为开漏输出，需外接上拉电阻。

ASCII接线图（以TM1637为例）：

合宙模组(AirXXXX模组)              TM1637数码管模块
  ┌──────────┐                ┌───────────────┐
  │          │                │               │
  │  GPIO14  │────────────────│ CLK           │
  │  GPIO15  │────────────────│ DIO      ┌───┐│
  │          │                │          │4× ││  4位数码管
  │ VDD(3.3V)│──────────────-─│ VCC      │数显││
  │  GND     │────────────────│ GND      └───┘│
  │          │                │          ┌───┐│
  └──────────┘                │          │KEY││  可选按键
                              └──────────└───┘┘

  注意：CLK和DIO需各接4.7kΩ上拉电阻到VCC

ASCII接线图（以AIP650E为例）：

合宙模组(AirXXXX模组P)             AIP650E
  ┌──────────┐                ┌──────────┐
  │          │                │          │
  │  GPIO20  │────────────────│ SCL      │
  │  GPIO21  │────────────────│ SDA  ┌───┤
  │          │                │      │4× │  4位数码管
  │ VDD(3.3V)│────────────────│ VDD  │数显│
  │  GND     │────────────────│ GND  └───┤
  │          │                │      ┌───┤
  └──────────┘                │      │7×4│  按键矩阵
                              └────-─└───┘
  注意：SCL/SDA需各接10kΩ上拉电阻到VDD
  VDD端建议加0.1µF(104)电容，尽量靠近芯片

注意事项：

TM1637的CLK和DIO引脚需要外接4.7kΩ\~10kΩ上拉电阻
TM1637通信协议非标准I2C，数据位为LSB优先，不能直接使用硬件I2C驱动
AIP650E的VDD端建议并联0.1µF（104）电容，且电容距离芯片VDD引脚小于2cm
TM1637不支持组合按键，AIP650E支持4个组合按键
在强干扰环境（如电磁炉旁）下，建议降低通信频率，通信线串接100\~200Ω电阻
数码管驱动电流较大时，注意芯片散热，必要时在PCB上增加散热铜箔

要点5：工作原理

TM1637内部集成了显示寄存器（6字节，地址C0H\~C5H）、段驱动输出（SEG1\~SEG8，N管开漏）、位驱动输出（GRID1\~GRID6，P管开漏）和键盘扫描电路（8×2bit）。芯片内部RC振荡器自动执行动态扫描：依次选通每一位（GRID引脚输出有效），同时在段引脚上输出对应的段码数据，通过快速循环刷新（典型频率约200Hz）实现多位数码管的稳定显示。人眼因视觉暂留效应感知到所有位同时显示。

亮度调节通过控制位输出周期的占空比实现：8级可调占空比从1/16到14/16。数据通信时，主控设备（例如合宙AirXXXX模组）在CLK上升沿将数据写入DIO，芯片在第8个时钟下降沿产生ACK应答信号。

AIP650E的工作原理与TM1637类似，但增加了组合按键支持功能。其键盘扫描矩阵为7×4bit，支持检测同时按下的4个组合按键，适用于需要快捷键操作的设备。芯片内部同样采用动态扫描方式驱动数码管，段驱动电流不小于25mA，位驱动电流不小于150mA，确保高亮度显示。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别40：音频功放

要点1：什么是音频功放

音频功放芯片（Audio Power Amplifier IC）是将微弱的音频信号放大到足以驱动扬声器发声的功率集成电路。根据工作方式的不同，音频功放可分为A类、B类、AB类、D类和K类等。其中D类功放以高效率著称，K类功放在D类基础上集成了电荷泵升压技术，能够在低电池电压下输出更大功率。

AW8733系列属于Class-K（K类）音频功放，内置电荷泵转换器将电池电压升压后驱动功放输出级，在4.2V供电下可向8Ω扬声器输出2W功率，同时集成RNS（RF噪声抑制）、NCN（防破音）和EEE（增强EMI消除）等专利技术，特别适用于手机、便携音频设备等对音质和EMC有较高要求的应用。

要点2：常见型号与特点

型号	厂商	通信接口	关键参数	特点
AW8733ATQR	上海艾为电子(Awinic)	单线脉冲控制（SHDN引脚）	供电2.5\~5.5V，电荷泵输出6.5V，输出功率2W@8Ω/4.2V（1% THD），增益可选12/16/24/27.5dB，4种工作模式，QFN 3×3×0.75mm-20L	K类功放，内置RNS射频噪声抑制，NCN防破音保护，EEE电磁干扰消除，低底噪29µV

要点3：应用场景

- 手机/平板电脑：扬声器驱动，RNS功能有效抑制GSM/TD-LTE射频干扰

- 便携蓝牙音箱：高效率K类功放延长电池续航，2W输出满足小型音箱需求

- 智能音箱/语音助手：驱动扬声器播放语音提示和音乐

- 对讲机/通讯设备：NCN防破音功能保证通话清晰度

- 智能门铃/安防设备：音频告警和语音播报

- 儿童故事机/教育设备：便携式音频播放设备

要点4：硬件接口设计

通信接口说明：AW8733ATQR通过SHDN引脚的单线脉冲控制工作模式和增益。主控设备（例如合宙AirXXXX模组）通过GPIO输出不同数量的脉冲来切换4种工作模式（每种模式对应不同的增益设置）。音频信号从INP/INN引脚差分输入或从INP单端输入，放大后从VOP/VON引脚差分输出驱动扬声器。

ASCII接线图：

合宙模组(AirXXXX模组)              AW8733ATQR              扬声器
  ┌──────────┐                ┌──────────┐           ┌──────┐
  │          │                │          │           │      │
  │  DAC输出 │────────────────│ INP      │           │  +   │
  │  (PWM/   │                │          │           │      │
  │   I2S)   │                │      VOP │───────────│  扬  │
  │          │                │          │           │  声  │
  │  GPIO22  │────────────────│ SHDN     │           │  器  │
  │          │                │      VON │───────────│  -   │
  │ VDD(3.3V)│────────┬───────│ VDD      │           │      │
  │          │        │       │          │           └──────┘
  │  GND     │────────│───────│ GND      │
  │          │        │       │          │
  └──────────┘        │       │  CP/CN   │
                      │       │ (飞跨电容)│
                ┌─────┴─────┐ │  1µF     │
                │  10µF     │ │          │
                │  去耦电容  │ │  PVDD    │
                └─────┬─────┘ │  10µF    │
                      │       └──────────┘
                     GND

注意事项：

VDD引脚必须就近并联10µF电解电容和0.1µF陶瓷电容
电荷泵飞跨电容（CP-CN之间）建议使用1µF/10V陶瓷电容，直接影响升压效果
PVDD引脚需并联10µF电容，储能供电
音频输入走线应尽量短，避免与高频信号平行走线，建议使用差分走线
SHDN引脚悬空时芯片处于关断模式，需通过GPIO控制
扬声器走线应尽量短且宽，减少寄生电感
VOP/VON输出不可接地，也不可串联电容，直接连接扬声器

要点5：工作原理

AW8733ATQR采用K类放大架构，核心工作原理如下：

1. 电荷泵升压：芯片内置电荷泵（Charge Pump）转换器，将电池电压（2.5\~5.5V）升压至6.5V（PVDD），为功放输出级提供更高的供电电压。这使得在4.2V电池电压下仍能向8Ω扬声器输出2W功率，远超直接使用电池电压的传统D类功放。

2. D类功放输出：音频信号经输入级放大后，进入PWM调制器，将模拟音频信号转换为高频PWM脉冲信号。PWM信号驱动H桥MOSFET输出级，在VOP和VON之间产生差分PWM输出。扬声器线圈作为低通滤波器，将高频PWM分量滤除，还原音频信号。

3. RNS射频噪声抑制：内置RNS电路检测GSM/TD-LTE射频干扰（217Hz/4.33ms周期的TDD噪声），通过反向补偿技术大幅降低射频噪声对音频输出的影响。

4. NCN防破音保护：芯片实时监测输出信号的失真状态，当检测到"破音"（Crack Noise）时，自动降低系统增益，防止扬声器在高功率下损坏，保护扬声器的同时提供舒适的听感。

5. 模式控制：通过SHDN引脚的单线脉冲切换4种工作模式，每种模式对应不同的增益设置（12dB/16dB/24dB/27.5dB），适应不同灵敏度的扬声器。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别41：I2S音频功放

要点1：什么是I2S音频功放

I2S音频功放是一种直接接收数字音频信号（I2S/PCM格式）并进行D类功率放大的集成电路。与传统模拟输入功放不同，I2S音频功放内部集成了DAC（数模转换器）和D类功放，主控设备（例如合宙AirXXXX模组）只需通过I2S接口发送数字音频数据，芯片即可自动完成数模转换和功率放大，直接驱动扬声器发声。

这种架构省去了外部DAC和模拟前置放大电路，减少了模拟信号走线带来的噪声干扰，提高了系统的抗干扰能力和音质表现。同时，D类功放的高效率（典型92%）使其特别适合电池供电的便携设备。

要点2：常见型号与特点

型号	厂商	通信接口	关键参数	特点
MAX98357A	Maxim Integrated（现属Analog Devices）	I2S / Left-Justified / TDM	供电2.5\~5.5V，输出功率3.2W@4Ω/5V（10% THD），采样率8\~96kHz，支持16/24/32位数据，5种增益可选（3/6/9/12/15dB），92%效率，无需MCLK，TQFN-16/WLP-9	纯数字输入，无需外部DAC，滤波less D类输出，内置热保护和过流保护，低底噪25µVrms

要点3：应用场景

- 智能音箱/语音助手：直接接收主控设备（例如合宙AirXXXX模组）的I2S数字音频数据，驱动扬声器播放语音和音乐

- 物联网语音播报设备：工业报警、车站广播、智能家居语音提示

- 便携蓝牙音箱：高效率D类功放延长电池续航，3.2W输出满足便携音箱需求

- 教育电子设备：故事机、点读机、学习平板的音频输出

- 对讲系统/门禁对讲：数字音频传输减少噪声，提高通话质量

- 数字音频播放器：替代传统DAC+功放方案，简化系统设计

要点4：硬件接口设计

通信接口说明：MAX98357A通过标准I2S接口接收数字音频数据，需要3根信号线：DIN（数据）、BCLK（位时钟）和LRCLK（左右声道帧同步）。该芯片不需要MCLK（主时钟），简化了接口设计。增益通过GAIN引脚的电平设置，声道选择通过SD_MODE引脚配置。

ASCII接线图：

合宙模组(AirXXXX模组)              MAX98357A模块            扬声器
  ┌──────────┐                ┌───────────┐           ┌──────┐
  │          │                │           │           │      │
  │  I2S_DIN │────────────────│ DIN       │           │  +   │
  │  (GPIO5) │                │           │           │      │
  │  I2S_CLK │────────────────│ BCLK      │      VOUT+│──────│  扬
  │  (GPIO6) │                │           │           │  声  │
  │  I2S_WS  │────────────────│ LRCLK     │           │  器  │
  │  (GPIO7) │                │      GAIN │           │      │
  │          │                │       (接 │           │  -   │
  │ VDD(3.3V)│────────┬───────│ GND) VDD  │      VOUT-│──────│
  │          │        │       │      GND  │           │      │
  │  GND     │────────│───────│      SD_MODE          └──────┘
  │          │        │       │      (接GND: (L+R)/2)│
  └──────────┘        │       └───────────┘
                      │
                ┌─────┴─────┐
                │  10µF     │
                │  去耦电容  │
                └─────┬─────┘
                     GND

  GAIN引脚配置：
  - 接GND:  12dB增益
  - 悬空:    9dB增益（默认）
  - 接VDD:  15dB增益
  - 15kΩ下拉:  6dB
  - 100kΩ下拉: 3dB

  SD_MODE引脚配置：
  - 接GND:  (L+R)/2 混合输出（默认）
  - 悬空:    左声道
  - 接VDD:  右声道

注意事项：

VDD引脚必须就近并联10µF电解电容和0.1µF陶瓷电容，供电稳定性直接影响音质
I2S信号线（DIN/BCLK/LRCLK）走线应等长，避免时序偏差
I2S信号线避免与扬声器输出线平行走线，防止数字噪声耦合到模拟输出
VOUT+和VOUT-为BTL（桥接负载）输出，不可接地，不可串联耦合电容，直接连接扬声器
扬声器阻抗建议4Ω或8Ω，4Ω时可获得更大输出功率（3.2W）
GAIN和SD_MODE引脚可通过电阻或直接连接设置，也可通过GPIO动态控制
该芯片无需外部LC滤波器，利用扬声器自身电感实现滤波，简化外围电路

要点5：工作原理

MAX98357A的工作流程为：数字音频接收 → DAC转换 → D类功率放大 → 滤波less输出

1. I2S数字音频接收：芯片通过DIN、BCLK和LRCLK三线接收标准I2S格式的数字音频数据。内部锁相环（PLL）从BCLK恢复时钟信号，实现数据同步。芯片支持8kHz\~96kHz采样率和16/24/32位数据宽度。MAX98357A不需要MCLK主时钟信号，减少了引脚数量和EMI。

2. 数字增益控制：接收到的PCM数据先经过数字增益调节单元，根据GAIN引脚的设置（3/6/9/12/15dB）对数字信号进行放大。

3. Sigma-Delta调制：增益调节后的PCM数据进入Sigma-Delta（Σ-Δ）调制器，将多比特PCM信号转换为单比特PDM（脉冲密度调制）信号。扩频调制技术使开关频率在一定范围内抖动，分散谐波能量，降低EMI。

4. D类H桥输出：PDM信号控制H桥MOSFET的开关，在VOUT+和VOUT-之间产生高频PWM方波。由于采用滤波less架构，不需要外部LC低通滤波器，直接利用扬声器线圈的电感特性滤除高频开关分量，还原音频信号。

5. 保护机制：芯片内置过热保护（热关断）和过流保护（短路保护），当输出电流过大或芯片温度过高时自动关断输出，保护芯片和扬声器不受损坏。

6. Click-Pop抑制：芯片内置精密的启动/关断时序控制，在上电和断电过程中抑制扬声器产生的"噼啪"声（Click-Pop噪声），提供平滑的音频体验。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

第六篇：接口扩展芯片

类别42：GPIO扩展

要点1：什么是GPIO扩展

GPIO扩展芯片（GPIO Expander）是一种通过串行总线（如I2C、SPI）为微控制器增加通用输入输出引脚数量的集成电路。当主控主控设备（例如合宙AirXXXX模组）的GPIO引脚不足以满足外设连接需求时，GPIO扩展芯片提供了一种低成本、高效率的解决方案。

GPIO扩展芯片的主要功能包括：

通过I2C或SPI总线与主控通信，扩展出8位、16位甚至更多位的并行I/O端口
每个I/O引脚可独立配置为输入或输出方向
支持中断输出，当输入状态变化时通知主控
部分型号集成PWM功能（如PCA9685），可用于LED调光和舵机控制
支持多个器件通过不同地址共用同一条总线，进一步扩展I/O数量

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
PCA9555	NXP / TI	I2C	16位I/O，2.3-5.5V，400kHz	3个硬件地址引脚，可级联8个器件，带极性反转寄存器
PCA9685	NXP	I2C	16通道12位PWM，2.3-5.5V，1MHz Fm+	专为LED驱动设计，每通道25mA驱动能力，可级联62个器件
PCF8574	NXP / TI	I2C	8位准双向I/O，2.5-5.5V，400kHz	准双向端口无需方向控制，低待机电流10μA
MCP23008	Microchip	I2C	8位I/O，1.8-5.5V，100kHz/400kHz/1.7MHz	带中断输出、上拉电阻，25mA驱动能力
MCP23017	Microchip	I2C	16位I/O，1.8-5.5V，1.7MHz	双8位端口(PORTA/PORTB)，双中断输出，可级联8个器件
MCP23S17	Microchip	SPI	16位I/O，1.8-5.5V，10MHz	SPI接口版本，高速通信，硬件地址引脚可选

要点3：应用场景

1. 工业控制面板：扩展按键、LED指示灯、继电器控制等I/O接口

2. 智能家居网关：增加传感器接口和执行器控制引脚

3. LED矩阵显示：使用PCA9685驱动多路LED，实现亮度PWM调光

4. 安防系统：扩展门磁、红外探头等干接点输入

5. 机器人控制：扩展舵机控制信号和传感器接口

6. 仪器仪表：增加数字I/O用于控制多路开关和状态指示

要点4：硬件接口设计

通信接口：I2C（PCA9555/PCA9685/PCF8574/MCP23008/MCP23017）或SPI（MCP23S17）

ASCII接线图（以MCP23017为例，I2C接口）：

AirXXXX模组         MCP23017
  ┌──────────┐            ┌──────────┐
  │          │            │          │
  │  I2C_SCL ├────────────┤ SCL      │
  │  I2C_SDA ├────────────┤ SDA      │
  │      3V3 ├────────────┤ VDD      │
  │      GND ├────────────┤ GND      │
  │          │            │          │
  │ GPIO(IRQ)├───────-────┤ INTA     │
  │          │            │ GPA0-GPA7├── 外设I/O
  │          │            │ GPB0-GPB7├── 外设I/O
  └──────────┘            └──────────┘
       │                        │
       └── 4.7kΩ上拉到3V3 ──────┘
       └── 4.7kΩ上拉到3V3 ──────┘

注意事项：

I2C总线需接4.7kΩ上拉电阻到VDD
MCP23017的A0/A1/A2地址引脚接GND或VDD设置I2C地址
PCA9685的OE引脚可控制所有输出使能/禁用
工作电压需与主控匹配，3.3V系统可直接连接

要点5：工作原理

GPIO扩展芯片内部包含移位寄存器、数据寄存器、方向寄存器和中断逻辑电路。以MCP23017为例：

1. 寄存器结构：内部包含IODIRA/IODIRB（方向寄存器）、GPIOA/GPIOB（端口寄存器）、OLATA/OLATB（输出锁存寄存器）、GPINTENA/GPINTENB（中断使能寄存器）等

2. 输出模式：主控通过I2C写入OLAT寄存器，数据经锁存后输出到对应引脚

3. 输入模式：引脚电平状态实时反映在GPIO寄存器中，主控通过I2C读取

4. 中断机制：当配置了中断使能的输入引脚状态发生变化，INT引脚产生中断信号通知主控，同时中断捕获寄存器（INTCAP）记录变化时的端口状态

5. PCA9685的PWM工作原理：内部集成25MHz振荡器，通过预分频器生成可编程PWM频率（24Hz-1526Hz），每通道独立的12位ON/OFF时间寄存器实现4096级亮度控制

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别43：串口扩展

要点1：什么是串口扩展

串口扩展芯片（UART Expander）是一种通过SPI、I2C或UART接口将一路串行总线扩展为多路独立UART通道的集成电路。当主控主控设备（例如合宙AirXXXX模组）的硬件UART资源不足，需要连接多个串口外设（如RS485设备、蓝牙模块、GPS模块等）时，串口扩展芯片提供了高效的多串口解决方案。

串口扩展芯片的主要功能包括：

将单一SPI/I2C/UART接口扩展为2-8路独立的全双工UART通道
每个扩展串口独立配置波特率、数据位、停止位、校验位
内置独立FIFO收发缓冲，减少主控中断负担
兼容16C550标准寄存器，便于软件移植
支持RS485半双工自动方向控制
部分型号支持IrDA红外通信编解码

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
CH9434	WCH（沁恒微）	SPI	4路UART，3.3V，最高4Mbps	兼容16C550，25路GPIO，SPI最高20Mbit/s，支持RS485方向控制
CH9438	WCH（沁恒微）	SPI	8路UART，1.8-3.3V，最高12Mbps	8组独立全双工串口，SPI最高25Mbit/s，8路GPIO，支持低功耗
WK2114	WEIKAI（为开微电子）	UART	4路UART，2.5-5V，最高2Mbps	UART扩展4路串口，256字节FIFO，支持IrDA
WK2124	WEIKAI（为开微电子）	SPI	4路UART，2.5-5V，最高2Mbps	SPI扩展4路串口，256字节FIFO，SPI模式0，最高10Mbit/s

要点3：应用场景

1. 多串口服务器：工业环境中连接多台RS485/RS232设备

2. 物联网网关：同时连接蓝牙、WiFi、4G等多个无线串口模块

3. 工业自动化：多路RS485总线通信，连接PLC、变频器、传感器

4. 车载终端：连接GPS、OBD、显示屏等多个串口外设

5. 数据采集系统：同时采集多路串口传感器的数据

6. POS终端：连接打印机、扫描枪、刷卡器等外设

要点4：硬件接口设计

通信接口：SPI（CH9434/CH9438/WK2124）或UART（WK2114）

ASCII接线图（以CH9438为例，SPI接口扩展8路UART）：

     AirXXXX模组                 CH9438
  ┌──────────────┐         ┌──────────────┐
  │              │         │              │
  │  SPI_CS      ├─────────┤ SCS          │
  │  SPI_SCK     ├─────────┤ SCLK         │
  │  SPI_MOSI    ├─────────┤ SDIN         │
  │  SPI_MISO    ├─────────┤ SDOUT        │
  │  3V3         ├─────────┤ VCC          │
  │  GND         ├─────────┤ GND          │
  │  GPIO(IRQ)   ├─────────┤ INT          │
  │              │         │              │
  │              │         │  TX0/RX0 ────┤ 设备1
  │              │         │  TX1/RX1 ────┤ 设备2
  │              │         │  TX2/RX2 ────┤ 设备3
  │              │         │  ...         │
  │              │         │  TX7/RX7 ────┤ 设备8
  └──────────────┘         └──────────────┘

注意事项：

CH9438支持内部时钟，无需外接晶振，简化设计
I/O电压支持1.8V/2.5V/3.3V，可匹配不同电平的外设
WK2124的SPI只支持模式0，CS需在每次传输时控制
多路UART的波特率可独立设置，但总SPI带宽需满足所有通道之和

要点5：工作原理

串口扩展芯片的核心是一个总线桥接器（Bridge），其工作原理如下：

1. 数据通路：主控通过SPI/I2C/UART接口将数据写入扩展芯片的指定通道FIFO，芯片内部的UART发送模块将FIFO中的数据按设置的波特率和格式串行发送到对应TX引脚；接收端RX引脚收到的串行数据被存入对应通道的接收FIFO，主控通过SPI/I2C/UART接口读取

2. 寄存器映射：兼容16C550标准，每个UART通道有独立的寄存器组（LCR线路控制、FCR FIFO控制、IER中断使能、LSR线路状态等），通过子通道号和寄存器地址联合寻址

3. FIFO缓冲：每路UART的发送和接收方向各有独立FIFO（如CH9438为发送1536字节/接收2048字节），减少主控频繁读取的需求

4. 中断机制：当接收FIFO达到触发阈值、发生接收超时或线路错误时，芯片通过INT引脚向主控发出中断，主控读取全局中断状态寄存器确定具体通道和事件

5. RS485方向控制：TNOW引脚在发送数据时自动拉高，发送完成后自动拉低，实现RS485收发方向自动切换，无需软件干预

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别44：移位寄存器

要点1：什么是移位寄存器

移位寄存器（Shift Register）是一种将串行数据转换为并行数据输出（或反向转换）的逻辑器件。74HC595是最经典的8位串行输入/并行输出移位寄存器，通过3根控制线（数据、时钟、锁存）即可扩展8路输出，且支持级联实现更多路数的输出扩展。

移位寄存器的主要功能包括：

串行输入、并行输出：用少量引脚控制大量输出
内置输出锁存寄存器，移位过程不影响当前输出状态
三态输出，支持总线挂接
支持级联：多个芯片串联，仅用3根线即可控制任意数量的输出
2V-6V宽工作电压，适合多种逻辑电平系统

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
74HC595	TI / Nexperia / ST等	串行移位（类SPI）	8位输出，2-6V，fmax>50MHz	3态输出，级联扩展，±6mA驱动，低成本
SN74HCS595	TI	串行移位	8位输出，2-6V，75MHz	施密特触发输入，抗噪声能力强
74HCT595	Nexperia	串行移位	8位输出，4.5-5.5V，TTL电平	兼容TTL逻辑电平输入

要点3：应用场景

1. LED点阵/数码管驱动：用3根线驱动8×8 LED矩阵或多位数码管

2. 继电器控制板：扩展多路继电器控制输出

3. IO扩展：为引脚紧张的主控设备（例如合宙AirXXXX模组）增加数字输出

4. 状态指示灯阵列：控制多路LED状态指示

5. 步进电机驱动：输出多路电机控制信号

6. 工业面板指示：控制大量面板指示灯

要点4：硬件接口设计

通信接口：串行移位接口（DATA/SRCLK/RCLK，类似SPI）

ASCII接线图（74HC595级联扩展16路输出）：

  AirXXXX模组            74HC595 #1         74HC595 #2
  ┌──────────┐          ┌──────────┐       ┌──────────┐
  │          │          │          │       │          │
  │  GPIO(A) ├──────────┤ SER(DS)  │       │          │
  │  GPIO(B) ├──────────┤ SRCLK    ├───────┤ SRCLK    │
  │  GPIO(C) ├──────────┤ RCLK     ├───────┤ RCLK     │
  │          │          │          │       │          │
  │  3V3     ├──────────┤ VCC      │       │ VCC      │
  │  GND     ├──────────┤ GND      │       │ GND      │
  │          │          │          │       │          │
  │          │          │ Q0-Q7 ───┤ 输出1 │ Q0-Q7 ───┤ 输出2
  │          │          │ Q7'  ────┼───────┤ SER(DS)  │
  │          │          │SRCLR──3V3│       │SRCLR──3V3│
  │          │          │OE──GND   │       │OE──GND   │
  └──────────┘          └──────────┘       └──────────┘

注意事项：

SER(串行数据)、SRCLK(移位时钟)、RCLK(锁存时钟)需3根控制线
SRCLR接高电平（不复位），OE接低电平（输出使能）
级联时前一级的Q7'连接后一级的SER
数据在SRCLK上升沿移入，RCLK上升沿锁存到输出
74HC595工作电压2-6V，3.3V系统可直接连接

要点5：工作原理

74HC595内部包含两个主要部分：8位移位寄存器和8位存储寄存器（D型锁存器）。

1. 移位过程：SER引脚上的数据在SRCLK的每个上升沿被移入移位寄存器的最低位，原有数据依次向高位移动一位，第8位数据从Q7'引脚输出（用于级联）

2. 锁存过程：当所有数据位移位完成后，RCLK产生一个上升沿，移位寄存器的8位数据被并行复制到存储寄存器中，存储寄存器的输出直接反映在Q0-Q7引脚上

3. 输出控制：OE（输出使能）为低电平时输出有效，为高电平时输出为高阻态；SRCLR（移位清零）为低电平时清空移位寄存器

4. 级联原理：多片74HC595共用SRCLK和RCLK，前一级的Q7'串接到后一级的SER，数据依次移位通过所有芯片后统一锁存输出

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别45：DAC模块

要点1：什么是DAC模块

DAC（Digital-to-Analog Converter，数模转换器）是将数字信号转换为模拟电压输出的器件。MCP4725是一款常用的12位分辨率单通道I2C接口DAC芯片，内置EEPROM可保存上电默认输出值，适用于需要精确模拟电压输出的应用场景。

DAC模块的主要功能包括：

将12位数字量转换为对应的模拟电压输出（0-VDD，分辨率VDD/4096）
内置EEPROM，断电后保持配置，上电自动恢复输出
I2C接口通信，支持100kHz/400kHz/3.4MHz三种速率
轨到轨输出，低功耗设计
支持掉电模式，可配置不同输出负载阻抗

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
MCP4725	Microchip	I2C	12位分辨率，2.7-5.5V，6μs建立时间	内置EEPROM，8个可配置I2C地址，SOT-23-6小封装
MCP4725A0	Microchip	I2C	12位，±0.2 LSB DNL	基础地址0x60，低成本
MCP4725A1	Microchip	I2C	12位，±0.2 LSB DNL	基础地址0x62

要点3：应用场景

1. 传感器校准：为传感器提供可编程参考电压或偏置电压

2. 闭环控制：输出模拟控制信号驱动执行器（如比例阀、电机调速）

3. 音频前级：生成模拟音频信号驱动功放

4. 可编程电源：配合稳压器实现可编程电压输出

5. 波形发生器：生成正弦波、三角波等模拟波形

6. LCD对比度调节：输出可调电压控制LCD偏置

要点4：硬件接口设计

通信接口：I2C

ASCII接线图：

AirXXXX模组         MCP4725
  ┌──────────┐            ┌──────────┐
  │          │            │          │
  │  I2C_SCL ├────────────┤ SCL      │
  │  I2C_SDA ├────────────┤ SDA      │
  │      3V3 ├────────────┤ VDD      │
  │      GND ├────────────┤ VSS(GND) │
  │          │            │          │
  │          │            │ VOUT ────┤ 模拟电压输出
  └──────────┘            └──────────┘
       │                        │
       └── 4.7kΩ上拉到3V3 ──────┘

注意事项：

I2C总线需接4.7kΩ上拉电阻
A0引脚接GND或VDD设置I2C地址低位（0x60或0x61）
VDD同时作为器件供电和DAC参考电压
VOUT输出为电压信号，驱动能力有限，需运放缓冲驱动大电流负载
建议VDD处加旁路电容（0.1μF）减小噪声

要点5：工作原理

MCP4725的DAC转换原理基于电阻串结构（R-2R或电阻分压网络）：

1. 数字输入：主控通过I2C接口发送12位数字值（0-4095）到DAC输入寄存器

2. 转换过程：DAC内部的电阻串网络根据输入数字值选择对应的抽头点，产生比例电压。输出电压 = VDD × (数字值 / 4096)

3. 输出放大：内部轨到轨运算放大器缓冲电阻串输出电压，提供低阻抗驱动能力

4. EEPROM写入：当I2C命令中包含EEPROM写入位时，当前DAC值和配置位被写入非易失性EEPROM，下次上电时自动加载

5. 掉电模式：可通过配置位进入掉电模式，输出端连接1kΩ/100kΩ/500kΩ负载电阻到GND，降低功耗

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别46：CAN控制器

要点1：什么是CAN控制器

CAN控制器（CAN Controller）是实现CAN（Controller Area Network）总线通信协议的集成电路。MCP2515是Microchip推出的独立CAN控制器芯片，通过SPI接口与主控主控设备（例如合宙AirXXXX模组）连接，支持CAN V2.0B协议规范，最高通信速率1Mbps。当主控主控设备（例如合宙AirXXXX模组）没有内置CAN控制器时，MCP2515提供了外扩CAN总线通信的能力。

CAN控制器的主要功能包括：

实现CAN V2.0B协议（标准帧11位ID和扩展帧29位ID）
支持最高1Mbps通信速率
3个发送缓冲器和2个接收缓冲器
6个29位验收滤波器和2个11位验收滤波器
SPI接口通信，最高10MHz
支持单触发模式，确保消息只发送一次
帧起始（SOF）信号输出引脚

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
MCP2515	Microchip	SPI	CAN V2.0B，2.7-5.5V，1Mbps，SPI 10MHz	独立CAN控制器，3发送/2接收缓冲，6个滤波器
MCP2515FD	Microchip	SPI	CAN FD，最高8Mbps	支持CAN FD协议，灵活数据速率

要点3：应用场景

1. 汽车电子：OBD-II诊断接口、车载ECU通信

2. 工业自动化：CANopen协议网络、设备间控制通信

3. 电机驱动：多轴运动控制器与驱动器间的CAN总线通信

4. 光伏储能：逆变器与BMS之间的CAN通信

5. 楼宇自动化：CAN总线传感器网络

6. 农业机械：拖拉机ISOBUS标准通信

要点4：硬件接口设计

通信接口：SPI

ASCII接线图：

AirXXXX模组        MCP2515         CAN收发器(TJA1050)
  ┌──────────┐          ┌──────────┐     ┌──────────┐
  │          │          │          │     │          │
  │  SPI_CS  ├──────────┤ CS       │     │          │
  │  SPI_SCK ├──────────┤ SCK      │     │          │
  │  SPI_MOSI├──────────┤ SI(MOSI) │     │          │
  │  SPI_MISO├──────────┤ SO(MISO) │     │          │
  │  3V3     ├──────────┤ VDD      │     │ VCC(5V)  │
  │  GND     ├──────────┤ GND      │     │ GND      │
  │  GPIO    ├──────────┤ INT      │     │          │
  │          │          │          │     │          │
  │          │          │ TXCAN ───┼─────┤ TXD      │
  │          │          │ RXCAN ───┼─────┤ RXD      │
  │          │          │          │     │ CANH ────┤ CAN总线
  │          │          │          │     │ CANL ────┤ CAN总线
  └──────────┘          └──────────┘     └──────────┘

注意事项：

MCP2515需要外接CAN收发器（如TJA1050、SN65HVD230）连接物理总线
MCP2515需外接晶振（通常8MHz或16MHz）
CAN总线两端需接120Ω终端电阻
INT引脚建议连接到主控GPIO中断引脚，及时处理CAN消息
MCP2515工作电压2.7-5.5V，3.3V系统可直接连接

要点5：工作原理

MCP2515的CAN通信工作原理：

1. 协议引擎：内部CAN协议引擎完全实现CAN V2.0B规范，包括位定时、仲裁、CRC校验、ACK处理、错误管理等功能

2. 发送过程：主控通过SPI将报文ID、数据长度和数据写入指定发送缓冲器（TXB0/TXB1/TXB2），设置发送请求位后，协议引擎在总线空闲时自动发送。发送完成后产生中断通知主控

3. 接收过程：总线上的报文经过验收滤波器筛选后存入接收缓冲器，通过INT引脚通知主控读取。滤波器可配置为匹配特定ID或ID范围

4. 位定时：通过配置CNF1/CNF2/CNF3寄存器设置同步跳转宽度、相位段1、相位段2和波特率预分频器，实现不同波特率（如500kbps需根据晶振频率计算分频参数）

5. 错误管理：内置发送错误计数器和接收错误计数器，当错误计数超过阈值时自动进入错误被动或总线关闭状态

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别47：RTC模块

要点1：什么是RTC模块

RTC（Real-Time Clock，实时时钟）模块是一种提供精确时间和日期信息的集成电路，即使在主电源断开后也能通过备用电池维持时间走时。RTC模块广泛用于需要时间戳记录、定时唤醒和日历功能的嵌入式系统。

RTC模块的主要功能包括：

提供年、月、日、时、分、秒、星期等完整日历信息
自动处理闰年、不同月份天数等日历规则
内置晶振或TCXO（温度补偿晶振）提供精确走时
支持备用电池输入，主电源断开后继续走时
提供可编程闹钟和方波输出功能
I2C接口通信，功耗极低

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
DS3231	Maxim（ADI）	I2C	±2ppm精度，2.3-5.5V，400kHz	内置TCXO温度补偿晶振，数字温度传感器，±3.5ppm(-40\~+85℃)
PCF8563T	NXP	I2C	1.0-5.5V，400kHz	超低功耗（0.25μA@3V），外接32.768kHz晶振，可编程时钟输出

要点3：应用场景

1. 数据记录设备：为传感器数据添加精确时间戳

2. 定时唤醒系统：低功耗IoT设备定时唤醒采集数据

3. 电表/水表：记录抄表时间和计费时段

4. 安防系统：记录事件发生的精确时间

5. 门禁系统：按时段控制门禁权限

6. 工业控制器：PLC定时任务和日志记录

要点4：硬件接口设计

通信接口：I2C

ASCII接线图（以DS3231为例）：

AirXXXX模组         DS3231
  ┌──────────┐            ┌──────────┐
  │          │            │          │
  │  I2C_SCL ├────────────┤ SCL      │
  │  I2C_SDA ├────────────┤ SDA      │
  │      3V3 ├────────────┤ VCC      │
  │      GND ├────────────┤ GND      │
  │          │            │          │
  │  GPIO    ├────────────┤ INT/SQW  │
  │          │            │          │
  │          │            │ VBAT ────┤ CR2032电池
  │          │            │ 32kHz ───┤ 方波输出(可选)
  └──────────┘            └──────────┘
       │                        │
       └── 4.7kΩ上拉到3V3 ──────┘

注意事项：

DS3231内置TCXO，无需外接晶振；PCF8563需外接32.768kHz晶振
VBAT引脚接CR2032纽扣电池（3V）实现断电保持
I2C地址：DS3231为0x68，PCF8563为0x51
DS3231的INT/SQW引脚可配置为闹钟中断或方波输出
PCF8563功耗极低（0.25μA），适合电池供电系统

要点5：工作原理

RTC模块的核心是计时电路和晶振振荡器：

1. DS3231工作原理：

内置温度补偿晶振（TCXO），32.768kHz频率经分频得到1Hz秒脉冲
TCXO通过内部温度传感器实时监测温度，根据温度-频率补偿曲线调整振荡频率，实现±2ppm（0-40℃）的高精度
秒、分、时、日、月、年寄存器以BCD码存储，每秒自动递增
内置电源切换电路：VCC有电时使用VCC供电，VCC断电时自动切换到VBAT
闹钟比较器在设定时间匹配时触发INT引脚中断

2. PCF8563工作原理：

依赖外接32.768kHz晶振产生基准时钟，功耗极低（0.25μA）
内部分频链将32.768kHz分频为1Hz驱动计时寄存器
CLKO引脚可输出32.768kHz/1024Hz/32Hz/1Hz可编程方波
电压检测器在VDD低于阈值时设置VL标志位，提示时间可能不准确

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别48：Flash存储芯片

要点1：什么是Flash存储芯片

Flash存储芯片是一种非易失性存储器件，断电后数据不丢失。W25N01GV是Winbond（华邦）推出的1Gbit（128MB）SPI NAND Flash芯片，支持标准SPI、Dual SPI和Quad SPI接口，内置ECC（错误校正码）和坏块管理功能，适用于大容量数据存储场景。

Flash存储芯片的主要功能包括：

提供1Gbit（128MB）非易失性存储空间
SPI/Dual/Quad SPI接口，最高104MHz时钟频率
内置1-bit ECC错误校正，提高数据可靠性
坏块管理查找表（BBM LUT），自动替换坏块
支持缓冲读取和连续读取两种模式
页大小2048+64字节（数据区+Spare区）
深度掉电模式，降低待机功耗

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
W25N01GVZEIG	Winbond（华邦）	SPI/Dual/Quad	1Gbit，2.7-3.6V，104MHz	内置1-bit ECC，BBM坏块管理，SON-8封装，2048+64字节页
W25N02GV	Winbond	SPI/Dual/Quad	2Gbit，2.7-3.6V，104MHz	双倍容量，兼容W25N01GV引脚

要点3：应用场景

1. 数据日志存储：IoT设备长期采集数据的存储介质

2. 固件OTA升级：存储备份固件和升级包

3. 行车记录仪：循环存储视频/图像数据

4. 音频/图像存储：存储语音文件、图片资源

5. 通信设备：存储配置文件和日志

6. 工业监控：存储传感器历史数据和事件记录

要点4：硬件接口设计

通信接口：SPI（支持Dual/Quad SPI）

ASCII接线图：

AirXXXX模组        W25N01GVZEIG
  ┌──────────┐            ┌──────────┐
  │          │            │          │
  │  SPI_CS  ├────────────┤ CS#      │
  │  SPI_SCK ├────────────┤ CLK      │
  │  SPI_MOSI├────────────┤ DI/IO0   │
  │  SPI_MISO├────────────┤ DO/IO1   │
  │  GPIO    ├────────────┤ WP#/IO2  │
  │  GPIO    ├────────────┤ HOLD#/IO3│
  │      3V3 ├────────────┤ VCC      │
  │      GND ├────────────┤ GND      │
  └──────────┘            └──────────┘

注意事项：

标准SPI模式仅使用CS/CLK/DI/DO四根线
Quad SPI模式需额外连接WP#(IO2)和HOLD#(IO3)引脚
WP#和HOLD#在标准SPI模式下应接高电平（使能）
NAND Flash按页/块组织，写前必须擦除（块擦除）
NAND Flash存在坏块，需软件或硬件BBM管理
建议VCC处加0.1μF去耦电容

要点5：工作原理

W25N01GV作为SPI NAND Flash，其存储结构和工作原理如下：

1. 存储组织：1Gbit存储空间分为1024个块（Block），每块64页，每页2048+64字节（主数据区+Spare区）。擦除操作以块为单位（128KB），编程操作以页为单位

2. 写入流程：写数据前必须先擦除对应块。编程操作分两步：先将数据写入内部数据缓冲区（Page Data Load），再触发编程命令将缓冲区数据写入NAND阵列（Program Execute）

3. 读取流程：先发送读取命令将指定页数据从NAND阵列加载到内部缓冲区（Page Data Read），再通过SPI从缓冲区读取数据（Read Data）

4. ECC机制：内部硬件ECC引擎在编程时生成校验码写入Spare区，读取时自动校验并纠正1-bit错误，检测2-bit错误

5. 坏块管理：BBM LUT（坏块管理查找表）在SRAM中维护坏块替换映射，将坏块替换为预留的好块，对上层提供连续地址空间

6. 连续读取模式：设置连续读取模式后，可跨页连续读取大量数据，无需反复发送页地址命令，适合代码映射执行和大文件读取

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

第七篇：电源管理芯片

类别49：电池充电芯片

要点1：什么是电池充电芯片

电池充电芯片（Battery Charger IC）是专门用于安全充电单节或多节锂电池的集成电路。它实现恒流-恒压（CC-CV）充电曲线，内置过压保护、温度监控、涓流预充等安全功能，确保锂电池安全充满。这类芯片广泛应用于便携式电子设备，可直接从USB端口或适配器取电为锂电池充电。

电池充电芯片的主要功能包括：

恒流（CC）/恒压（CV）自动切换充电模式
可编程充电电流，通过外部电阻设置
预设充电电压（4.2V/4.35V等），±1%精度
涓流充电：电池电压低于阈值时以小电流预充
充电终止：电流降至设定值1/10时自动终止
自动再充电：电池电压下降后自动恢复充电
电池温度监测（NTC热敏电阻）
充电状态指示输出（LED驱动）
软启动限流，防止涌入电流
待机模式极低功耗（\<2μA电池漏电流）

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
TC4058H544	凌矽半导体(SuperChip)	无（独立工作）	600mA充电，4.2V，SOT23-5	电池正负极反接保护，最高输入9V，低功耗
TP4056	南京拓品微电子(TopPower)	无（独立工作）	1A充电，4.2V，ESOP8	经典型号，无需外部二极管，热调节，双LED状态指示
DA267	——	无（独立工作）	单节锂电池充电	小电流充电IC，适用于低功耗便携设备
TP4066	南京拓品微电子(TopPower)	无（独立工作）	1A充电，4.2V/4.35V/3.6V，ESOP8/DFN	电池正负极反接保护，多电压可选，过压保护7V
YHM2712A	——	无（独立工作）	单节锂电池充电	国产充电芯片，低成本方案

要点3：应用场景

1. 便携式IoT设备：锂电池供电的无线传感器节点

2. 移动电源/充电宝：为内置锂电池充电管理

3. 智能手表/手环：可穿戴设备的微型电池充电

4. 蓝牙耳机/TWS：小型锂电池充电管理

5. GPS追踪器：车载/人员追踪设备的电池充电

6. 手持终端：PDA、扫码枪等工业手持设备

要点4：硬件接口设计

通信接口：无（独立工作，通过电阻设置参数）

ASCII接线图（以TP4056为例）：

AirXXXX模组          TP4056              锂电池
  ┌──────────┐           ┌──────────┐         ┌──────────┐
  │          │           │          │         │          │
  │  5V(USB) ├───────────┤ VCC      │         │          │
  │  GND     ├───────────┤ GND      │         │  BATT+   │
  │          │           │          │         │          │
  │  GPIO    ├───────────┤CHRG( LED)│         │  BATT-   │
  │  GPIO    ├───────────┤STDBY(LED)│         │          │
  │          │           │          │         │          │
  │          │           │ BAT ─────┼─────────┤ +        │
  │          │           │ GND ─────┼─────────┤ -        │
  │          │           │          │         │          │
  │          │           │ PROG ──┐ │         │          │
  │          │           │        │ │         │          │
  │          │           │     1.2kΩ          │          │
  │          │           │        │ │         │          │
  │          │           │ GND ◄──┘ │         │          │
  └──────────┘           └──────────┘         └──────────┘

注意事项：

PROG引脚电阻设置充电电流：I = 1200/R_PROG(kΩ)，如1.2kΩ=1A
TP4056的CHRG引脚充电时拉低（红灯），STDBY充满时拉低（绿灯）
TEMP引脚接NTC热敏电阻监测电池温度（可接GND跳过）
TP4066支持电池正负极反接保护，更安全
大电流充电时需注意散热，TP4056在1A时功耗约1.5W
建议BAT输出处加10μF电容减小纹波

要点5：工作原理

锂电池充电芯片的CC-CV充电过程：

1. 涓流预充阶段（Trickle Charge）：当电池电压低于2.9V（阈值可因型号而异）时，以约设定电流1/10的小电流预充电，防止过放电电池直接大电流充电造成损坏

2. 恒流充电阶段（CC）：电池电压超过2.9V后，芯片以PROG电阻设定的恒定电流充电，电池电压逐渐上升。此阶段充电效率最高，充入约70%电量

3. 恒压充电阶段（CV）：电池电压达到预设值（4.2V/4.35V）后，芯片切换为恒压模式，电压保持不变，充电电流逐渐减小。此阶段充入剩余30%电量

4. 充电终止：当充电电流降至设定值的1/10（C/10）时，芯片自动终止充电，进入待机模式

5. 自动再充电：待机状态下持续监测电池电压，当电压降至4.05V以下时自动启动新的充电周期

6. 热调节：芯片内置温度传感器，当结温超过115℃时自动降低充电电流，实现热保护，防止过热损坏

7. 内部PMOS架构：采用内部PMOSFET作为功率管，无需外部隔离二极管和检测电阻，简化外围电路

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别50：锂电高精度电量计

要点1：什么是锂电高精度电量计

锂电高精度电量计（Fuel Gauge IC）是一种通过监测电池电压、电流和温度等参数，结合先进算法精确计算锂电池剩余电量（SOC，State of Charge）和健康状态（SOH，State of Health）的集成电路。与简单的电压检测法不同，电量计芯片采用库仑计数、开路电压法和自适应算法，实现全工况下的精确电量测量。

电量计芯片的主要功能包括：

实时监测电池电压、充放电电流和温度
内置高精度ADC（14位电压/温度、16位电流）
FastCali自适应算法，无需完整充放电校准
支持低至1mΩ的采样电阻，实现大电流精确测量
提供SOC（剩余电量百分比）、SOH（健康度）和循环次数
低电量告警中断输出
支持系统端或电池包端安装
超低功耗：工作模式12μA，睡眠模式0.5μA

要点2：常见型号与特点

型号	生产厂商	通信接口	关键参数	特点
CW2217	赛微微电(CellWise)	I2C	14位V/T ADC，16位电流ADC，1mΩ采样电阻	FastCali算法，无需校准循环，DFN-12封装，SOC误差±3%
CW2217B	赛微微电(CellWise)	I2C	同上，WLCSP-9封装	超小封装1.58×1.53mm，适合可穿戴设备
CW2015	赛微微电(CellWise)	I2C	14位ADC，无采样电阻	无需电流采样电阻，CSP-9封装，SOC误差±3%

要点3：应用场景

1. 移动电源/充电宝：精确显示剩余电量百分比

2. 智能手机/平板：电池电量显示和低电量管理

3. 智能手表/TWS耳机：可穿戴设备的微型电池电量监测

4. 电动工具：电池包电量管理和过放保护

5. 物联网设备：远程监测电池状态，预测续航时间

6. 便携医疗设备：精确监测电池剩余工作时间

要点4：硬件接口设计

通信接口：I2C

ASCII接线图：

   AirXXXX模组              CW2217            锂电池
  ┌──────────┐           ┌──────────┐      ┌──────────┐
  │          │           │          │      │          │
  │  I2C_SCL ├───────────┤ SCL      │      │          │
  │  I2C_SDA ├───────────┤ SDA      │      │          │
  │      3V3 ├───────────┤ VDD      │      │  BAT+    │
  │      GND ├───────────┤ GND      │      │          │
  │          │           │          │      │  BAT-    │
  │  GPIO    ├───────────┤ INT/ALARM│      │          │
  │          │           │          │      │          │
  │          │           │ BAT ─────┼──────┤ +        │
  │          │           │ CS+ ─────┼──────┤ +        │
  │          │           │          │ 1mΩ  │          │
  │          │           │ CS- ─────┼──────┤ -        │
  │          │           │          │      │          │
  │          │           │ NTC ─────┤ NTC热敏电阻到GND
  └──────────┘           └──────────┘      └──────────┘
       │                       │
       └── 4.7kΩ上拉到3V3 ─────┘

注意事项：

采样电阻必须使用1mΩ精密电阻（1%精度），连接在电池负极与系统GND之间
CS+连接电池正极侧，CS-连接负载侧
I2C地址为0x64
INT引脚在SOC低于阈值或温度异常时产生中断
NTC热敏电阻连接NTC引脚到GND实现温度监测
电池特性参数需预先写入芯片RAM（电池profile）

要点5：工作原理

CW2217电量计的工作原理基于多参数融合和自适应算法：

1. 电压测量：14位Sigma-Delta ADC实时采样电池端电压，精度可达mV级

2. 电流测量：16位ADC通过测量1mΩ采样电阻上的压降计算充放电电流，正电流为充电，负电流为放电

3. 温度测量：通过外接NTC热敏电阻或内部温度传感器测量电池温度

4. FastCali算法：

结合开路电压（OCV）法和库仑计数法
开路电压法：在电池静置时通过V-SOC查表获得初始SOC
库仑计数法：对电流积分得到充放电电量变化，实时更新SOC
自适应校准：算法在电池工作过程中自动学习电池特性，无需完整充放电校准循环

5. 电池特性建模：芯片内部RAM存储电池的OCV-SOC曲线、内阻特性等profile数据，不同电池需烧录对应profile

6. SOC计算：综合电压、电流积分、温度补偿和电池老化信息，输出0-100%的SOC值，误差≤±3%

7. 告警机制：当SOC降至预设阈值（如10%）或温度超出范围时，INT引脚产生中断通知主控

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

第八篇：通信模块

通信模块是物联网系统中实现设备间数据交换的核心组件。本篇涵盖无线收发、RFID射频识别、GPS卫星定位、红外遥控接收与红外遥控收发五大类别，共5个类别的通信器件。

类别51：无线模块

要点1：什么是无线模块

无线模块是指利用无线电波进行数据收发的集成电路芯片或模块化产品，工作在ISM（工业、科学、医疗）免授权频段，无需物理线缆即可实现点对点或点对多点的数据通信。2.4GHz无线模块是其中最常见的一类，工作在2.4GHz ISM频段，具有传输速率高、体积小、功耗低、成本低等优势，广泛应用于无线键鼠、智能家居、有源RFID、无线数据传输等场景。

无线模块的核心功能包括：

- 射频收发：将数字数据调制为射频信号发送，并接收解调射频信号还原为数字数据

- 协议处理：处理数据包的封装、地址匹配、CRC校验、自动应答（Auto-ACK）和自动重传（Auto-Retry）

- 频道管理：支持多信道切换，避免干扰

要点2：常见型号与特点

型号	厂商	通信接口	工作频段	调制方式	数据速率	发射功率	接收灵敏度	工作电压	封装	特点
Si24R1	南京中科微电子	SPI（10MHz）	2.4-2.525GHz	GFSK/FSK	2/1/0.25Mbps	+7dBm	-83dBm@2Mbps	1.9-3.6V	QFN20(4×4mm)	兼容nRF24L01+，内置ARQ引擎，超低功耗
nRF24L01+	Nordic Semiconductor	SPI（10MHz）	2.4-2.525GHz	GFSK	2/1/0.25Mbps	0dBm	-82dBm@2Mbps	1.9-3.6V	QFN20(4×4mm)	经典2.4G芯片，应用广泛
CC2500	Texas Instruments	SPI	2.4-2.4835GHz	2-FSK/GFSK/MSK	500kbps	+1dBm	-104dBm@2.4kbps	1.8-3.6V	QFN20(4×4mm)	灵敏度极高，支持多种调制

Si24R1 核心特点：

- 南京中科微电子生产，完全兼容nRF24L01+，可直接替换

内置智能ARQ（自动重传请求）基带协议引擎，硬件自动应答和重传
超低功耗：关断电流仅1μA，待机电流15μA
支持126个1MHz带宽信道（2400-2525MHz）
收发数据硬件中断输出，支持1bit RSSI输出
内部集成高PSRR LDO，极少外围器件
快速启动时间≤130μs

要点3：应用场景

1. 无线鼠标/键盘：低功耗2.4G无线输入设备，电池供电可达数月

2. 有源RFID：2.4GHz有源电子标签，用于人员/车辆定位与门禁

3. 智能家居控制：无线灯光控制、窗帘控制、安防传感器数据传输

4. 无线数据传输模块：工业现场数据采集与无线传输

5. 无线音频传输：无线麦克风、无线音频模块

6. 低功耗自组网传感网节点：无线传感器网络中的数据中继与传输

通信接口说明：

Si24R1采用四线SPI接口与主控主控设备（例如合宙AirXXXX模组）通信，最高SPI时钟10MHz。除SPI外，还需要CE（芯片使能）和IRQ（中断输出）两根控制线。

引脚说明：

Si24R1引脚	功能	说明
CSN	SPI片选	低电平有效，选中芯片
SCK	SPI时钟	由主控产生
MOSI	主出从入	主控->Si24R1
MISO	主入从出	Si24R1->主控
CE	芯片使能	高电平激活收发模式
IRQ	中断输出	数据收发完成触发，低电平有效
VCC	电源	1.9-3.6V
GND	地	-

ASCII 接线图（AirXXXX模组 \<--> Si24R1模块）：

     AirXXXX模组                    Si24R1 模块
    ┌──────────┐                  ┌──────────────┐
    │          │                  │              │
    │  GPIO8   │──────────────────│ CE           │
    │  GPIO9   │──────────────────│ CSN          │
    │  GPIO10  │──────────────────│ SCK          │
    │  GPIO11  │──────────────────│ MOSI         │
    │  GPIO12  │──────────────────│ MISO         │
    │  GPIO13  │──────────────────│ IRQ          │
    │  3.3V    │──────────────────│ VCC          │
    │  GND     │──────────────────│ GND          │
    │          │                  │              │
    └──────────┘                  └──────────────┘

注意事项：

Si24R1工作电压1.9-3.6V，AirXXXX模组的3.3V电源可直接供电
数字IO电压范围1.9-5.25V，与3.3V 主控设备（例如合宙AirXXXX模组）直连无需电平转换
模块需外接16MHz晶振（±60ppm）和少量无源器件
IRQ引脚为开漏输出，需外接4.7kΩ上拉电阻
PCB布局时射频走线应尽量短，天线附近避免铺铜

要点5：工作原理

Si24R1工作在2.4GHz ISM频段，采用GFSK（高斯频移键控）调制方式。其内部集成了完整的射频收发链路：

发射链路：主控设备（例如合宙AirXXXX模组）通过SPI将待发送数据写入TX FIFO -> Si24R1内部GFSK调制器将数字数据调制为基带信号 -> 上变频至2.4GHz -> 功率放大器（PA）放大至设定功率（最高+7dBm） -> 天线发射
接收链路：天线接收2.4GHz射频信号 -> 低噪声放大器（LNA）放大 -> 下变频解调 -> GFSK解调器还原数字数据 -> 写入RX FIFO -> 通过IRQ中断通知主控设备（例如合宙AirXXXX模组）读取
ARQ协议引擎：发送数据后，Si24R1自动切换到接收模式等待应答；若在设定时间内未收到ACK，自动重发（重发次数可配置）。这一过程完全由硬件完成，主控设备（例如合宙AirXXXX模组）无需干预。
信道管理：工作频率2400-2525MHz，共126个1MHz带宽信道，可通过寄存器配置切换信道以规避干扰。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别52：RFID模块

要点1：什么是RFID模块

RFID（Radio Frequency Identification，射频识别）模块是一种利用无线电波进行非接触式双向数据通信的识别设备。RFID系统由读写器（Reader）和电子标签（Tag）组成，读写器通过天线发射射频信号，激活进入磁场区域的标签，读取或写入标签中的数据。

RFID按工作频率分为三大类：

- 低频（LF）：125kHz/134kHz，读取距离短（\<1m），如门禁卡

- 高频（HF）：13.56MHz，读取距离约5-10cm，如MIFARE卡、NFC

- 超高频（UHF）：840-960MHz，读取距离可达10m以上，如物流标签

RFID模块的核心功能包括：

- 卡片检测与防冲突：检测进入射频场的多张卡片并逐一寻址

- 身份认证：通过密钥验证卡片合法性（如MIFARE Classic的CRYPTO1加密）

- 数据读写：读取或写入卡片存储区的数据

- 协议处理：处理ISO 14443、ISO 18000-6C等通信协议的帧格式和校验

要点2：常见型号与特点

型号	厂商	工作频率	支持协议	通信接口	读取距离	工作电压	封装/形态	特点
FM17622	上海复旦微电子	13.56MHz	ISO14443 A/B, M1加密	SPI/I2C/UART	≤50mm	2.5-3.6V	QFN32(5×5mm)	支持LPCD低功耗检测(7uA)，Type A/B双协议
RC522	NXP（恩智浦）	13.56MHz	ISO14443 A, MIFARE	SPI/I2C/UART	≤50mm	2.5-3.3V	HVQFN32(5×5mm)	经典RFID芯片，支持CRYPTO1加密，64字节FIFO
UHF-R200	-	840-960MHz	EPC C1G2/ISO 18000-6C	UART(TTL)	5-10m	3.6-5.5V	模块化	基于Impinj R2000，30dBm输出，>600tags/s
Impinj R2000	Impinj	840-960MHz	EPC C1G2/ISO 18000-6C	-	10-20m	-	芯片级	高性能UHF RFID读写器IC，RX灵敏度-82dBm，密集读取

各型号详细说明：

- FM17622：复旦微电子生产的高集成度非接触通信芯片，支持ISO/IEC 14443 Type A和Type B双协议读写器模式，支持M1加密。具备LPCD（低功耗卡片检测）功能，在7uA@340ms扫描周期下可实时检测进场卡片，特别适合电池供电的智能门锁、电表等低功耗应用。支持SPI（最高10Mbps）、I2C（最高3.4Mbps）和UART（最高1.2Mbps）三种主机接口。深度关断模式功耗仅50nA。

- RC522（MFRC522）：NXP恩智浦推出的经典13.56MHz RFID读写芯片，支持ISO/IEC 14443 A/MIFARE协议。内部发射器可直接驱动天线，无需额外有源电路。支持CRYPTO1加密算法用于MIFARE系列产品验证。64字节FIFO缓冲，内置CRC协处理器和27.12MHz晶体振荡电路。通信速率支持106/212/424/848 kBd。是物联网和嵌入式领域低成本RFID方案的首选。

- UHF-R200：UHF超高频RFID读写模块，工作在840-960MHz频段（默认920-925MHz），基于Impinj R2000射频芯片。最大输出功率30dBm（1W），配合8dBi天线读取距离可达10m以上，标签识别速度超过600张/秒。支持密集读取模式（DRM）、RSSI信号强度检测和载波消除技术。通过UART串口通信，波特率默认115200bps。工作电压3.6-5.5V，峰值电流1.5A。

- Impinj R2000：Impinj公司的高性能UHF RFID读写器IC，集成了模拟射频前端与基带数字信号处理模块。接收灵敏度-82dBm，支持EPC C1G2和ISO 18000-6C协议，工作频率840-960MHz，覆盖中国、欧洲、美国等全球频段。是高端UHF RFID读写器（如8通道模块）的核心器件，适用于仓储物流、服装盘点、生产线管理等高挑战应用环境。支持前向调制方式DSB-ASK和PR-ASK。

要点3：应用场景

1. 智能门禁/考勤系统：读取员工卡UID验证身份，支持MIFARE卡加密认证

2. 公交卡/校园卡/消费机：读写卡内金额和数据块，实现电子钱包功能

3. 智能电表/水表/燃气表：FM17622低功耗LPCD模式，电池供电实时检测刷卡

4. 仓储物流管理：UHF-R200批量读取货物标签，实现快速盘点和出入库管理

5. 服装零售防伪溯源：UHF超高频远距离读取，支持多标签同时识别

6. NFC标签读写：读写NFC NTAG标签，用于智能海报、设备配对等场景

要点4：硬件接口设计

高频RFID（FM17622/RC522）- SPI接口：

13.56MHz RFID芯片通过SPI接口与主控通信。AirRC522_1000模块已集成天线和匹配电路，仅需连接SPI四线+复位+电源即可。

ASCII 接线图（AirXXXX模组 \<--> RC522模块）：

     AirXXXX模组                    RC522 模块
    ┌───────────┐               ┌──────────────┐
    │           │               │              │
    │  GPIO9    │───────────────│ SDA(CS)      │
    │  GPIO10   │───────────────│ SCK          │
    │  GPIO11   │───────────────│ MOSI         │
    │  GPIO12   │───────────────│ MISO         │
    │  GPIO35   │───────────────│ RST          │
    │  3.3V     │───────────────│ VCC          │
    │  GND      │───────────────│ GND          │
    │           │               │              │
    └───────────┘               └──────────────┘

UHF RFID（UHF-R200）- UART接口：

UHF模块功率较大，需注意电源供电能力。

ASCII 接线图（AirXXXX模组 \<--> UHF-R200模块）：

    AirXXXX模组                  UHF-R200 模块
    ┌───────────┐               ┌──────────────┐
    │           │               │              │
    │  UART2_TX │───────────────│ RXD          │
    │  UART2_RX │───────────────│ TXD          │
    │  GPIO8    │───────────────│ EN(使能)     │
    │  5V(USB)  │───────────────│ VCC(5V)      │
    │  GND      │───────────────│ GND          │
    │           │               │              │
    └───────────┘               └──────────────┘
         │                          │
         │                    ┌─────┴─────┐
         │                    │  UHF天线   │
         │                    │ (SMA接口)  │
         │                    └───────────┘

注意事项：

高频RFID模块（RC522/FM17622）工作电压2.5-3.3V，合宙模组3.3V可直接供电
RC522模块已集成天线，读卡距离约3-5cm，无需自行设计天线匹配电路
UHF-R200模块峰值电流可达1.5A（30dBm发射时），必须使用5V/2A以上电源，不能仅靠模组3.3V供电
UHF模块需外接SMA天线，无天线时严禁发射（可能烧毁功放）
SPI通信时CPOL=0、CPHA=0（Mode 0），时钟建议不超过10MHz
FM17622的IRQ引脚为开漏输出，需外接4.7kΩ上拉电阻

要点5：工作原理

高频RFID（13.56MHz）工作原理：

1. 能量传输：读写器天线在13.56MHz频率下产生交变磁场，当无源标签（如MIFARE卡）进入磁场范围，标签天线感应产生电能，为卡片内部芯片供电

2. 负载调制：标签通过改变天线负载的方式，将数据调制到13.56MHz载波上反射回读写器（类似于反向散射）

3. 解调解码：读写器接收端检测天线端的微弱变化，经放大、解调、解码还原出数字数据

4. ISO 14443协议流程：读写器发送REQA（请求）-> 标签响应ATQA（应答类型） -> 防冲突循环（获取UID） -> 选卡（SEL） -> 认证（AUTH密钥验证） -> 读/写数据块

UHF RFID（840-960MHz）工作原理：

1. 射频发射：读写器通过天线发射840-960MHz的射频载波，能量远高于高频RFID

2. 标签激活：UHF标签（无源）天线接收射频能量并整流为直流电为芯片供电

3. 反向散射调制：标签通过改变天线反射阻抗，将数据"反射"回读写器

4. 密集读取：R2000芯片支持DRM（密集读取模式），在多读写器环境下通过频分/时分复用避免干扰

5. 多标签防碰撞：采用基于时隙的ALOHA算法，读写器可同时识别数百张标签

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别53：红外遥控接收器

要点1：什么是红外遥控接收器

红外遥控接收器（IR Receiver）是一种集成化的红外信号接收器件，用于接收红外遥控器发射的38kHz载波调制信号，并将其解调还原为数字脉冲信号输出给主控设备（例如合宙AirXXXX模组）处理。它内部集成了红外光电二极管、前置放大器、带通滤波器、AGC（自动增益控制）、积分器和整形电路，仅需三根引脚（VCC、GND、OUT）即可工作。

红外遥控接收器的核心功能包括：

- 光电转换：将红外光信号转换为电信号

- 信号放大：高增益前置放大微弱信号

- 带通滤波：只通过38kHz载波频率信号，抑制其他频率干扰

- 解调整形：去除载波，输出TTL/CMOS电平的基带数字信号

- 抗干扰：AGC自动调节增益，抵抗环境光和电磁干扰

要点2：常见型号与特点

型号	厂商	载波频率	工作电压	接收距离	接收角度	工作电流	输出电平	封装	特点
VS1838B	SIVAGO Semiconductor	38kHz(37.9kHz)	2.7-5.5V	11-13m	±35°	0.6-1.0mA	TTL/CMOS低有效	TO-5(环氧树脂+屏蔽壳)	经典型号，宽电压，抗干扰强
HS0038B	Vishay	38kHz	2.5-5.5V	10-20m	±45°	0.5-1.0mA	TTL低有效	TO-5	高灵敏度，工业级
TSOP38238	Vishay	38kHz	2.5-5.5V	10-25m	±45°	0.35mA	TTL低有效	Minicast	低功耗，高抗干扰
IRM-3638N	Everlight	38kHz	2.7-5.5V	8-15m	±35°	0.8mA	TTL低有效	TO-5	性价比高

VS1838B 核心特点：

VS1838B是SIVAGO Semiconductor（世华高半导体）生产的38kHz红外遥控接收器，采用环氧树脂封装外加外屏蔽抗干扰设计。内含高速高灵敏度PIN光电二极管和低功耗高增益前置放大IC。

关键参数：

载波频率：37.9kHz（38kHz标准）
带通滤波带宽：8kHz
工作电压：2.7-5.5V（宽电压，兼容3.3V和5V系统）
工作电流：0.6-1.0mA（低功耗）
接收距离：11-13m（室内，200±50Lux环境光下）
接收半角：±35°
输出：TTL/CMOS兼容，低电平有效
ESD保护：4000V HBM
工作温度：-30°C \~ +85°C
引脚排列：OUT(1)、GND(2)、VCC(3)
通过REACH和SGS认证，环保产品

要点3：应用场景

1. 家电遥控接收：电视、音响、DVD、机顶盒的红外遥控信号接收

2. 空调控制：接收空调遥控器的红外指令

3. 智能照明：红外遥控调光、开关灯

4. 风扇/取暖器控制：遥控开关和风速调节

5. 红外数据传输：短距离红外数据通信

6. 红外感应触发：检测红外信号触发特定动作

要点4：硬件接口设计

通信接口说明：

VS1838B为三脚器件，仅需连接电源和信号输出引脚。输出为低电平有效信号，无红外信号时输出高电平，接收到38kHz红外信号时输出低电平。主控设备（例如合宙AirXXXX模组）通过GPIO输入捕获或外部中断方式读取信号。

引脚定义：

VS1838B引脚	功能	说明
1 (OUT)	信号输出	低电平有效，接主控设备（例如合宙AirXXXX模组） GPIO
2 (GND)	地	接系统地
3 (VCC)	电源	2.7-5.5V

ASCII 接线图（AirXXXX模组 \<--> VS1838B）：

    AirXXXX模组                   VS1838B
    ┌───────────┐               ┌─────────┐
    │           │               │   ___    │
    │  GPIO     │───────────────│ 1 OUT   │
    │  3.3V     │───────┬───────│ 3 VCC   │
    │  GND      │       │       │         │
    │           │      100Ω     │ 2 GND   │
    │           │       │       │         │
    └───────────┘       │       └────┬────┘
                        │            │
                       4.7μF         │
                        │            │
                       GND────────-──┘

    注意：VCC引脚建议串联100Ω电阻并并联4.7μF电解电容+0.1μF陶瓷电容滤波
         OUT引脚建议外接10kΩ上拉电阻（芯片内部可能有上拉）

注意事项：

VS1838B工作电压2.7-5.5V，合宙模组3.3V可直接供电
电源滤波非常重要：VCC引脚必须并联4.7μF电解电容和0.1μF陶瓷电容，否则电源纹波会导致接收误码
接收器应避免阳光直射和强日光灯照射，否则会降低灵敏度
焊接时温度不超过350°C，时间不超过5秒，焊点离胶体根部2mm以上
引脚弯折需在焊接前完成，避免施力损坏胶体
接收窗口应朝向遥控器方向，安装角度考虑使用场景
建议使用GPIO中断方式接收信号，避免轮询丢失短脉冲

要点5：工作原理

VS1838B的内部信号处理链路如下：

1. 光电转换：内置PIN光电二极管接收940nm波长的红外光信号，将其转换为微弱电流信号。PIN二极管具有高速响应特性，能检测到纳秒级的光脉冲变化。

2. 前置放大：低功耗高增益前置放大IC将光电二极管的微弱电流信号放大数万倍。AGC（自动增益控制）电路根据信号强度自动调节增益，确保不同距离下都能稳定接收。

3. 带通滤波：内置带通滤波器（BPF）中心频率为38kHz（37.9kHz），带宽约8kHz。只有38kHz载波调制的红外信号能通过滤波器，其他频率的光干扰（如日光灯50Hz/100Hz频闪、太阳光直流分量）被有效抑制。

4. 积分与检波：积分器对滤波后的信号进行积分，包络检波器提取调制包络，去除38kHz载波，还原出基带数字信号。

5. 整形输出：信号整形器将包络信号转换为标准TTL/CMOS电平的方波输出。无信号时输出高电平，接收到38kHz红外脉冲时输出低电平（低电平有效）。

6. 红外协议解码：主控设备（例如合宙AirXXXX模组）通过GPIO中断或输入捕获测量OUT引脚的高低电平持续时间，按照红外协议（如NEC、RC5、SIRC等）的时序规则解码出按键编码。

以NEC协议为例：

引导码：9ms低电平 + 4.5ms高电平
数据"0"：562.5μs低电平 + 562.5μs高电平
数据"1"：562.5μs低电平 + 1687.5μs高电平
完整帧：引导码 + 8位地址 + 8位地址反码 + 8位命令 + 8位命令反码 + 结束位

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别54：红外遥控

要点1：什么是红外遥控

红外遥控（IR Remote Control）是一种利用红外线进行无线控制的技术，通过发射38kHz载波调制的红外光信号来传递控制指令。与类别54中仅接收红外信号的红外接收器不同，红外遥控强调双向收发能力--既能接收遥控器的红外指令进行学习，也能模拟遥控器发射红外信号控制家电设备。

红外遥控系统的核心功能包括：

- 红外信号接收：接收遥控器发出的38kHz调制红外信号并解码

- 红外码学习：通过接收遥控器指令，记录原始红外编码数据（raw data）

- 红外信号发射：通过红外发射LED（IR LED）以38kHz载波发射学习到的或预设的红外编码

- 多协议支持：兼容NEC、RC5、RC6、SIRC、Daikin、Gree、Mitsubishi等多种红外协议

- 家电智能控制：将传统红外家电接入物联网，实现远程控制和自动化

红外遥控通常采用软件模拟方式产生38kHz载波，无需专用硬件编码器，通过主控设备（例如合宙AirXXXX模组）的GPIO精确控制红外LED的通断时间来生成调制信号。有效通信距离约8米。

要点2：常见方案与特点

> 说明： 本类别无固定芯片型号，采用软件方案实现。以下列出常见的红外遥控开源方案和器件组合。

方案/库	来源	支持协议	载波频率	收发能力	平台	特点
IRremoteESP8266	GitHub开源社区	100+种（NEC/RC5/RC6/Daikin/Gree/Mitsubishi/Samsung/LG等）	38kHz(可调)	双向收发	ESP8266/ESP32	协议覆盖最全，支持空调/电视/音响，有Web控制界面
IRremote	Arduino开源社区	20+种（NEC/RC5/RC6/Sony等）	38kHz(可调)	双向收发	Arduino/ESP	经典红外库，使用简单，社区活跃
LIRC（Linux Infrared Remote Control）	Linux开源项目	自定义协议	38kHz	双向收发	Linux/树莓派	支持自定义协议配置文件，适合PC/嵌入式Linux
纯软件模拟（LuatOS）	自行实现	NEC等基本协议	38kHz	双向收发	合宙模组	用PWM或GPIO模拟38kHz载波，灵活定制

IRremoteESP8266 详细说明：

IRremoteESP8266是GitHub上最流行的红外遥控开源库（项目地址：https://github.com/crankyoldgit/IRremoteESP8266），专为ESP8266/ESP32设计，支持发送和接收超过100种红外协议。其核心特性包括：

- 空调控制：支持Daikin、Gree、Mitsubishi、Samsung、LG、Haier、Midea等主流品牌空调的完整控制（开关、模式、温度、风速、摆风等）

- 电视/音响控制：支持Sony、LG、Panasonic、Sharp、JVC等品牌电视遥控协议

- 通用协议：支持NEC、RC5、RC6、SIRC等通用红外协议

- 红外码学习：通过IRrecvDumpV2/V3示例可捕获并分析任意遥控器的红外编码

- IRac类：提供跨品牌空调统一控制接口，只需设置协议类型即可用相同API控制不同品牌

- Web控制：提供IRMQTTServer和Web-AC-control示例，通过浏览器或MQTT远程控制家电

要点3：应用场景

1. 智能空调控制：学习空调遥控器红外码，通过手机APP或语音助手远程控制空调开关、温度、模式

2. 万能遥控器：一个设备替代多个遥控器，集中控制电视、音响、机顶盒、空调等

3. 红外码学习与转发：接收遥控器指令并存储，后续按需重放，实现红外信号中继

4. 智能家居联动：配合温湿度传感器自动控制空调，人体传感器触发后自动开电视

5. 自定义红外设备控制：控制非标准红外设备（如电动窗帘、投影仪等）

6. 红外码库分享与备份：捕获红外编码并存储，方便备份和分享遥控器配置

要点4：硬件接口设计

通信接口说明：

红外遥控双向系统需要两个硬件组件：

- 红外接收：使用VS1838B等一体化接收头（详见类别54），通过GPIO输入捕获解码

- 红外发射：使用红外发射LED（IR LED，940nm波长），通过GPIO或PWM驱动，以38kHz软件模拟载波

红外LED的驱动电路通常使用三极管放大电流，因为主控设备（例如合宙AirXXXX模组） GPIO的驱动能力有限（通常\<20mA），而红外LED需要50-100mA的峰值电流才能达到8米左右的有效发射距离。

ASCII 接线图（AirXXXX模组P \<--> 红外收发电路）：

    AirXXXX模组                  红外收发电路
    ┌───────────┐              ┌──────────────────────┐
    │           │              │                      │
    │  GPIO7    │──────────────│ VS1838B OUT (引脚1)  │  接收
    │           │              │                      │
    │           │              │   ┌────────────┐     │
    │  3.3V     │──────────────│   │ VS1838B    │     │
    │           │              │   │ (接收头)    │     │
    │  GND      │──────────────│   │GND(2) VCC(3)│    │
    │           │              │   └────────────┘     │
    │           │              │                      │
    │  GPIO6    │──────┬───────│  发射电路             │
    │           │      │       │                      │
    │           │     220Ω     │     ┌─── IR LED ───┐ │  发射
    │           │      │       │     │   (940nm)    │ │
    │           │    ┌─┴─┐     │    VCC             │ │
    │           │    │NPN│     │     │   ←  电阻    │ │
    │           │    │Q1 │     │     │   10-47Ω     │ │
    │           │    │e c│─────│─────┘              │ │
    │           │    └─┬─┘     │                    │ │
    │           │      │       │     GND            │ │
    │           │     GND      │     └─────────-────┘ │
    │           │              │                      │
    └───────────┘              └──────────────────────┘

    发射电路说明：
    - GPIO6 通过220Ω限流电阻接NPN三极管基极
    - NPN发射极接GND
    - NPN集电极接IR LED负极
    - IR LED正极接VCC(3.3V)，串联10-47Ω限流电阻

    接收电路说明：
    - VS1838B引脚1(OUT) -> GPIO7
    - VS1838B引脚2(GND) -> GND
    - VS1838B引脚3(VCC) -> 3.3V（串联100Ω+并联4.7μF电容滤波）

注意事项：

红外发射LED波长选择940nm，与VS1838B接收波长相匹配
IR LED正向电流需50-100mA（峰值），主控设备（例如合宙AirXXXX模组） GPIO无法直接驱动，必须使用三极管放大
38kHz载波通过软件PWM或GPIO精确翻转产生，每个载波周期约26.3μs（高电平13μs+低电平13μs）
发射和接收LED应朝向相同方向，避免自发自收干扰
有效距离约8米，受发射功率、角度和环境光影响
若需更远距离，可使用多颗IR LED并联或使用聚光透镜
双向收发均使用38kHz软件模拟载波，收发不可同时进行（半双工）

要点5：工作原理

红外遥控系统的收发原理基于38kHz载波调制技术：

发射原理：

1. 载波生成：主控设备（例如合宙AirXXXX模组）通过GPIO或PWM产生38kHz方波信号（周期约26.3μs）。这个38kHz信号作为载波，是红外遥控的标准频率。

2. 数字调制：将待发送的数字数据（按键编码）按照特定红外协议（如NEC）的时序规则，控制38kHz载波的开/关（OOK调制，On-Off Keying）：

发送"1"比特：输出562.5μs的38kHz载波（约21个载波周期），然后停止562.5μs
发送"0"比特：输出562.5μs的38kHz载波，然后停止1687.5μs
引导码：输出9ms的38kHz载波，然后停止4.5ms

3. LED驱动：主控设备（例如合宙AirXXXX模组） GPIO输出控制三极管通断，三极管驱动IR LED以50-100mA峰值电流发射940nm红外光。载波"开"时LED发光，载波"关"时LED熄灭。

4. 红外码学习：接收模式下，VS1838B解调出的基带信号通过GPIO输入主控设备（例如合宙AirXXXX模组），主控设备（例如合宙AirXXXX模组）测量高低电平持续时间并记录为raw data数组，后续可原样重放。

接收原理（与类别54相同）：

VS1838B接收头内部完成光电转换、放大、38kHz带通滤波和解调，输出TTL电平基带信号。主控设备（例如合宙AirXXXX模组）通过GPIO中断或轮询方式测量信号时序，按协议规则解码出按键编码。

38kHz软件模拟载波的关键：

载波周期：1/38000 ≈ 26.3μs
每个周期：高电平约13μs + 低电平约13μs（50%占空比）
软件实现方式1：使用PWM硬件外设，设置频率38kHz、占空比50%
软件实现方式2：GPIO精确翻转，高电平13μs、低电平13μs循环
载波精度影响接收距离，频率偏差超过±2kHz会导致接收距离显著下降

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

第九篇：行业通信协议

本篇介绍LuatOS开发中常用的行业通信协议标准，包括电力行业的DL/T 645-2007多功能电能表通信协议和环保行业的HJ 212-2017污染物在线监控系统数据传输标准。这两个协议不是硬件器件，而是行业标准的通信协议规范，在各自的行业领域中具有广泛的应用。

类别55：电力通信协议（DL/T 645-2007）

要点1：什么是DL/T 645协议

DL/T 645《多功能电能表通信协议》是中华人民共和国电力行业标准，定义了电能表与数据终端设备（如采集器、手持单元）之间进行数据交换的通信协议规范。该协议由中国国家发展和改革委员会发布，是中国电能计量领域应用最广泛、最核心的通信标准。

DL/T 645协议采用 主从式半双工通信模式，数据终端设备（主站）发起请求，电能表（从站）进行应答。协议规定了完整的物理层、链路层和应用层规范，包括帧结构、地址寻址、控制码、数据标识、校验机制等内容。

DL/T 645协议经历了两个主要版本：

- DL/T 645-1997：首版标准，地址域仅2字节，功能较为简单

- DL/T 645-2007：现行版本，地址域扩展至6字节，新增安全认证、结构化数据标识等功能，是当前主流版本

要点2：协议版本和适用范围

版本	发布时间	地址域长度	数据标识	安全认证	通信速率	状态
DL/T 645-1997	1997年	2字节	简单	不支持	1200/2400bps	已废止
DL/T 645-2007	2007年	6字节（BCD码）	4字节结构化	支持（ESAM模块）	最高9600bps	现行标准

DL/T 645-2007适用范围：

1. 本地数据采集：通过手持抄表机（PDA）或便携电脑，在现场对单个或多个电能表进行数据读取和参数设置

2. 集中器下行通信：在用电信息采集系统中，集中器通过RS-485总线连接下属多块电表，定时或实时采集数据

3. 厂站终端调试：电表生产、检测、安装及维护环节，用于配置表计地址、费率、时间等参数

4. 远程费控：通过安全认证实现预付费、远程拉闸/合闸等费控功能

协议网络层次：

OSI层次	DL/T 645对应内容
物理层	RS-485总线（推荐标准），支持多点总线拓扑
链路层	帧格式、地址寻址、主从通信机制
应用层	数据标识（DI）、控制码、业务功能

要点3：应用场景

1. 智能电网用电信息采集系统：集中器通过DL/T 645协议抄读台区内所有电能表的电量、电压、电流等数据

2. 手持抄表终端：抄表员使用PDA通过RS-485接口直接连接电表，现场抄读数据

3. 电表生产检测：电表出厂前的精度校验、参数配置、功能测试等环节

4. 预付费电表管理：通过安全认证实现远程充值、拉闸、合闸等费控操作

5. IoT网关电表数据采集：使用合宙模组作为数据采集网关，通过RS-485接口和DL/T 645协议采集电表数据，再通过4G/WiFi等网络上报至云平台

6. 分布式能源监测：监测光伏发电、储能等分布式能源的电量数据

要点4：硬件接口设计

物理接口：RS-485总线

DL/T 645-2007协议通常运行在RS-485物理层之上，RS-485采用差分信号传输，支持多点总线拓扑，最远通信距离可达1200米，一条总线可连接多达32个节点。

ASCII接线图：

┌───────────────────────────┐      ┌────────────────┐      ┌───────────────────────────┐
│        主控模组           │       │ RS485收发芯片  │       │         电能表            │
│      (AirXXXX模组)        │      │   (MAX485)     │       │     (DL/T 645从站)        │
│                           │      │                │      │                           │
│  UART1_TXD ───────────────┼──────┼── DI           │      │                           │
│  UART1_RXD ───────────────┼──────┼── RO           │      │                           │
│  UART1_DIR ───────────────┼──────┼── DE/RE        │      │                           │
│  GND ─────────────────────┼──────┼── GND          │      │                           │
│                           │      │                │      │                           │
│                           │      │ A ─────────────┼──────┼── A+ (D+)                 │
│                           │      │ B ─────────────┼──────┼── B- (D-)                 │
│                           │      │                │      │                           │
└───────────────────────────┘      └────────────────┘      └───────────────────────────┘

RS-485接线说明：

主控模组侧	RS-485收发芯片	电能表侧	说明
UART1_TXD	DI（发送输入）	-	模组发送数据至485总线
UART1_RXD	RO（接收输出）	-	模组从485总线接收数据
UART1_RTS/GPIO	DE/RE（方向控制）	-	控制收发方向，高=发送，低=接收
GND	GND	GND	共地
-	A+	A+ (D+)	差分正信号
-	B-	B- (D-)	差分负信号

注意事项：

1. 方向控制：RS-485为半双工通信，需要通过GPIO控制收发芯片的DE/RE引脚切换发送和接收方向。发送数据前拉高DE，发送完成后立即拉低DE切换到接收模式

2. 终端电阻：RS-485总线两端建议各安装一个120Ω终端电阻，防止信号反射

3. 波特率：DL/T 645-2007常用波特率为2400bps，部分支持4800/9600bps，需与电表设置一致

4. 总线负载：单条RS-485总线建议不超过32个节点，超过时需增加中继器

5. 防雷保护：户外安装的电表需在RS-485接口处增加TVS管或气体放电管等防雷保护器件

6. 电平匹配：合宙模组UART为3.3V电平，RS-485收发芯片通常使用5V供电，需注意电平兼容

要点5：协议原理

帧结构：

DL/T 645-2007协议的数据帧由以下域组成：

组成部分	代码	长度（字节）	说明
前导字节	FEH	0-4（可选）	用于唤醒接收方，可不发送
帧起始符	68H	1	固定为0x68，标识帧开始

| 地址域 | A0\~A5 | 6 | 电表通信地址，12位BCD码，低字节在前 |

| 帧起始符 | 68H | 1 | 固定为0x68 |

| 控制码 | C | 1 | 指示操作类型和传输方向 |

| 数据域长度 | L | 1 | 数据域的字节数，读数据时L≤200 |

| 数据域 | DATA | 变长 | 数据内容，每个字节需加0x33 |

| 校验码 | CS | 1 | 从第一个0x68到校验码前所有字节的模256和 |

| 结束符 | 16H | 1 | 固定为0x16，标识帧结束 |

帧结构图示：

┌──────┬──────┬───────────────┬──────┬──────┬──────┬────────┬──────┬──────┐
│ FEH  │ 68H  │ A0 A1 A2 A3   │ 68H  │  C   │  L   │  DATA  │  CS  │ 16H  │
│(可选) │起始符│ A4 A5 (地址域) │起始符│控制码│长度  │(加0x33)│校验码│结束符│
└──────┴──────┴───────────────┴──────┴──────┴──────┴────────┴──────┴──────┘

控制码（C）位定义：

位	名称	说明
D7	传输方向	0=主站发出的命令帧；1=从站发出的应答帧
D6	异常标志	0=正常应答；1=异常应答
D5	后续帧标志	0=无后续数据帧；1=有后续数据帧
D4-D0	功能码	00001=读数据；00100=写数据；01000=广播校时；01010=改变通信速率；01011=修改密码

常用控制码：

控制码	二进制	含义
0x11	0001 0001	主站读数据
0x91	1001 0001	从站正常应答（读数据）
0xD1	1101 0001	从站异常应答
0x14	0001 0100	主站写数据
0x94	1001 0100	从站正常应答（写数据）
0x18	0001 1000	广播校时

数据标识（DI）：

数据标识由4字节组成（DI3-DI2-DI1-DI0），采用分层结构索引电表数据：

数据标识	含义	数据格式
0x00000000	当前组合有功总电能	XXXXXX.XX kWh
0x00010000	当前正向有功总电能	XXXXXX.XX kWh
0x0001FF00	当前正向有功总电能及各费率	XXXXXX.XX kWh
0x00020000	当前反向有功总电能	XXXXXX.XX kWh
0x02010000	A相电压	XX.X V
0x02010100	B相电压	XX.X V
0x02010200	C相电压	XX.X V
0x02020000	A相电流	XX.XXX A
0x02020100	B相电流	XX.XXX A
0x02020200	C相电流	XX.XXX A
0x02030000	A相有功功率	XX.XXXX kW
0x020300FF	A相总有功功率	XX.XXXX kW
0x02800002	日期和时间	YYMMDDWWhhmmss

数据域加解密规则：

数据域在传输时，每个字节都需要加上0x33。发送时加0x33，接收时减0x33还原原始数据。

校验码计算：

校验码CS = 从第一个帧起始符（0x68）到校验码前所有字节的算术和模256。

要点6：软件实现

目前，合宙正在针对常见的传感器，开发传感器扩展库和对应的demo示例；

扩展库使用说明参考：LuatOS传感器扩展库索引

类别56：环保行业国标通信协议（HJ 212-2017）

要点1：什么是HJ 212协议

HJ 212《污染物在线监控（监测）系统数据传输标准》是中华人民共和国国家环境保护标准，由环境保护部（现生态环境部）于2017年4月24日发布，2017年5月1日起实施。该标准规定了污染物在线监控（监测）系统、污染物排放过程（工况）自动监控系统与监控中心之间的数据传输格式和代码定义，是中国环保监测领域最核心的数据通信标准。

HJ 212协议替代了早期的HJ/T 212-2005标准，扩充了适用范围，新增了污染物排放过程（工况）自动监控设备与监控中心之间的数据交换传输功能，新增了数据采集传输仪与在线监控仪器仪表之间的数据传输通讯协议，并扩充了监测因子编码表和命令集。

HJ 212协议采用 请求-应答模式 或 主动上报模式 进行通信，支持TCP和UDP两种传输层协议。在典型应用场景中，现场监控设备（现场机）通过数采仪（或直接）向监控中心（上位机）主动上报实时监测数据，监控中心也可下发控制命令或请求历史数据。

要点2：协议版本和适用范围

版本	发布时间	实施时间	主要变化	状态
HJ/T 212-2005	2005年	2005年	首版标准	已废止
HJ 212-2017	2017年4月	2017年5月	扩充适用范围、新增工况监控、扩充命令和编码表	现行标准

HJ 212-2017适用范围：

1. 污染物在线监控系统：污染源（废水、废气）在线监控设备与监控中心之间的数据传输

2. 污染物排放过程（工况）自动监控系统：工况监控设备与监控中心之间的数据交换

3. 在线监控仪器仪表与数采仪之间的通信：规定了仪器与数采仪之间的数据传输格式

4. 环境质量监测站：空气质量、地表水、地下水、土壤、声环境等监测站的数据上报

系统结构：

┌──────────┐     ┌──────────┐     ┌──────────┐
│ 现场监控  │     │ 数据采集  │     │  监控中心 │
│设备(现场机)│───>│ 传输仪    │────>│ (上位机)  │
│          │     │ (数采仪)  │     │          │
└──────────┘     └──────────┘     └──────────┘
  传感器/仪器      HJ 212协议        环保局/企业
  (水/气/声)      (TCP/UDP)         监控平台

常用系统编码（ST）：

系统编码	含义	系统编码	含义
21	地表水水质	22	空气质量
23	地下水水质	24	土壤质量
25	声环境	26	挥发性有机物
31	污水	32	废气
33	污染物排放过程（工况）	51	地下水

要点3：应用场景

1. 污染源在线监测：工厂废水排放口COD、氨氮等污染物在线监测数据上报至环保局监控平台

2. 烟气在线监测（CEMS）：工厂烟囱SO2、NOx、颗粒物等烟气污染物在线监测数据上报

3. 空气质量监测站：城市空气质量监测站点PM2.5、PM10、O3等数据上报

4. 水质自动监测站：河流、湖泊水质自动监测站数据上报

5. IoT环保网关：使用合宙模组作为环保数据采集网关，通过RS-485/RS-232采集仪器数据，再通过4G网络按HJ 212协议上报至监控中心

6. 工况监控系统：工厂治理设施运行状态（如电机电流、阀门开关状态等）监控数据上报

要点4：硬件接口设计

物理接口：网络通信（TCP/UDP）或串口通信（RS-232/RS-485）

HJ 212协议在监控设备与数采仪之间通常使用RS-232或RS-485串口通信，在数采仪与监控中心之间使用TCP或UDP网络通信。

ASCII接线图（网络方式）：

┌─────────────────────────┐    ┌───────────────┐          ┌──────────────────────────┐
│      主控模组            │    │ AirXXXX模组PM │  4G网络  │      监控中心             │
│    (AirXXXX模组)         │    │   TCP客户端   │  TCP/IP │    (环保局平台)           │
│                         │    │               │          │                          │
│  UART2 ────┐            │    │               │          │     监听端口             │
│            │            │    │               │          │     (如:8888)            │
│  传感器    │            │    │               │          │                          │
│  (RS485) ──┼────────────┼───>│               │          │                          │
│            │            │    │               │          │                          │
│  GND  ─────┘            │    │               ┼──────────┼──>  TCP连接              │
│                         │    │               │          │                          │
└─────────────────────────┘    └───────────────┘          └──────────────────────────┘
       现场监测设备                                               环保监控平台

网络通信参数：

参数	说明
传输协议	TCP（推荐）或UDP
通信模式	长连接，数采仪主动连接监控中心
默认端口	由监控中心指定（常用8888或2404）
字符编码	UTF-8
报文结束符	\r\n（回车换行）

注意事项：

1. 网络连接：使用合宙模组的4G网络建立TCP连接，需确保SIM卡已开通数据业务且网络注册成功

2. 心跳机制：HJ 212协议建议保持长连接，当无数据上报时定期发送心跳包维持连接

3. 断线重连：网络异常断开时需实现自动重连机制，重连间隔建议30-60秒

4. 数据缓存：网络不可用时，监测数据需本地缓存，网络恢复后补传

5. 时间同步：现场设备需保持时间同步，可通过NTP或监控中心下发校时命令实现

6. 数据完整性：HJ 212协议支持拆分包和应答确认机制，确保大数据量传输的完整性

要点5：协议原理

帧结构：

HJ 212-2017协议的通信报文由以下部分组成：

组成部分	长度	说明
起始符	2字节	固定为"##"
系统编码 (ST)	2字符	标识系统类型，如"32"表示废气
命令编码 (CN)	4字符	标识命令类型，如"1062"表示取设备状态
访问密码 (PW)	6字符	通信密码，默认"123456"
设备唯一标识 (MN)	14字符	设备唯一标识号
拆分包及应答标志 (Flag)	1字符	Bit0=是否应答，Bit6=是否拆分包
指令参数 (CP)	变长	CP=\&\&数据内容\&\&
CRC校验	4字符	CRC16校验码（4位十六进制大写）
结束符	2字节	\r\n（回车换行）

帧结构图示：

┌────┬──────┬──────┬──────┬──────────┬──────┬─────────────────┬──────┬──────┐
│ ## │  ST  │  CN  │  PW  │    MN    │ Flag │  CP=&&...&&     │ CRC  │ \r\n │
│起始│ 系统  │ 命令 │ 密码 │ 设备标识  │标志   │  指令参数        │校验码│ 结束  │
└────┴──────┴──────┴──────┴──────────┴──────┴─────────────────┴──────┴──────┘

Flag标志位定义：

位	名称	说明
Bit0	是否需要应答	0=不需要应答，1=需要应答
Bit1-Bit5	保留	默认为0
Bit6	是否拆分包	0=不拆分，1=拆分包（需包序号）
Bit7	保留	默认为0

常用命令编码（CN）：

命令编码	含义	方向
1061	取设备唯一标识（MN）	上位机→现场机
1062	取设备状态	上位机→现场机
2011	取污染物实时数据	现场机→上位机（主动上报）
2021	取污染物分钟数据	上位机→现场机
2031	取污染物小时数据	上位机→现场机
2041	取污染物日数据	上位机→现场机
3011	设置超时时间	上位机→现场机
3021	设置实时数据上报间隔	上位机→现场机
9011	设置设备唯一标识	上位机→现场机
9021	设置密码	上位机→现场机

常用监测因子编码：

因子编码	含义	因子编码	含义
01	化学需氧量(COD)	02	氨氮(NH3-N)
03	总磷(TP)	04	总氮(TN)
05	pH值	06	水温
10	二氧化硫(SO2)	11	氮氧化物(NOx)
14	颗粒物	15	烟气含氧量
22	烟气流速	24	烟气温度
a01001	PM2.5	a01002	PM10
a01003	一氧化碳(CO)	a01004	臭氧(O3)

CRC16校验算法：

HJ 212协议使用CRC16-Modbus校验算法，多项式为0xA001，初始值为0xFFFF。校验范围从"##"后第一个字符到"\&\&"结束符（不含"\&\&"后的CRC和\r\n）。

通信实例（上报实时数据）：

现场机上报报文:
  ##0132QN=20230715120000;ST=32;CN=2011;PW=123456;MN=device001;Flag=0;
  CP=&&DataTime=20230715120000;01-Rtd=35.2;01-Flag=N;02-Rtd=1.85;02-Flag=N&&
  CRC16\r\n

  解析:
  ##           起始符
  01           系统编码(32=废气)... 注意:实际ST为32，这里01为示例
  QN           请求编码(时间戳)
  ST=32        系统编码:废气
  CN=2011      命令:取污染物实时数据(主动上报)
  PW=123456    密码
  MN=device001 设备唯一标识
  Flag=0       不需要应答，不拆分
  CP=&&...&&   数据段:包含数据时间和各污染物实时值
  CRC16        4位十六进制CRC校验码
  \r\n         结束符