impress_sig_mesh_hacs/参数配置表.md

SigMesh Gateway - 参数配置表

用途: 用于快速调整和记录配置参数

---

1. 串口参数

参数名	配置键	默认值	可调范围	当前值	说明
设备路径	serial_device	/dev/ttyUSB0	系统决定	______	串口设备路径
波特率	baudrate	115200	9600-921600	______	串口通信速率
数据位	bytesize	8	5-8	______	通常为 8
停止位	stopbits	1	1, 1.5, 2	______	通常为 1
校验位	parity	N	N/E/O/M/S	______	N=无校验
超时	timeout	0.1	0.01-10s	______	读取超时 (秒)

常见串口路径:

• Linux: /dev/ttyUSB0, /dev/ttyUSB1, /dev/ttyACM0
• Windows: COM3, COM4
• macOS: /dev/cu.usbserial-*

---

2. 协调器参数

参数名	配置键	默认值	可调范围	当前值	说明
轮询间隔	poll_interval	30	5-3600s	______	定时刷新间隔
防抖冷却	debounce_cooldown	1	0.1-10s	______	事件防抖间隔
更新超时	update_timeout	10	5-60s	______	更新超时限制
重连间隔	reconnect_interval	5	1-60s	______	断线重连间隔
重连次数	reconnect_attempts	3	1-10	______	最大重连次数

---

3. 协议参数

参数名	默认值	说明	调整建议
事件前缀	+EVENT=	串口消息前缀	根据网关固件调整
行结束符	\r\n	行分隔符	通常为\r\n或\n
Mesh 前缀	+EVENT=MESH,recv	Mesh 消息标识	-
配网前缀	+EVENT=PROV	配网事件标识	-

---

4. 实体参数

4.1 传感器

Property ID	名称	单位	缩放因子	启用状态
0x0050	PRESENCE_DETECTED	布尔	×1	□
0x0051	MOTION_DETECTED	布尔	×1	□
0x0059	AMBIENT_TEMPERATURE	°C	÷100	□
0x005A	AMBIENT_HUMIDITY	%	÷100	□
0x005D	LIGHT_INTENSITY	lx	×1	□
0x0075	BATTERY_LEVEL	%	×1	□
0x0092	CO2_CONCENTRATION	ppm	×1	□
0x00B4	PM2_5_CONCENTRATION	μg/m³	×1	□
0x00B9	TVOC_CONCENTRATION	ppb	×1	□

4.2 模型 ID 映射

模型 ID	名称	实体类型	启用状态
0x1000	OnOff Server	Switch/Binary Sensor	□
0x1300	Light Lightness	Light	□
0x1307	HSL	Light	□
0x130C	Color	Light	□
0x130D	CTL	Light	□
0x1100	Sensor Server	Sensor	□

---

5. 日志级别配置

模块	推荐级别	当前配置
custom_components.sigmesh_gateway	INFO	______
custom_components.sigmesh_gateway.serial_reader	DEBUG	______
custom_components.sigmesh_gateway.protocol_parser	DEBUG	______
custom_components.sigmesh_gateway.coordinator	INFO	______

日志级别: DEBUG < INFO < WARNING < ERROR < CRITICAL

---

6. 性能参数

参数	默认值	最小值	最大值	当前值
最大设备数	200	1	500	______
消息队列大小	100	10	1000	______
读取间隔 (ms)	10	1	100	______
内存限制 (MB)	50	10	200	______

---

7. 调试开关

开关名	默认值	说明	当前状态
原始数据打印	False	打印原始串口数据	□
解析详情打印	False	打印解析中间结果	□
时间戳记录	True	记录消息时间戳	□
性能统计	False	统计处理延迟	□

---

8. 配置变更记录

日期	参数名	旧值	新值	原因	效果
______	______	______	______	______	______
______	______	______	______	______	______
______	______	______	______	______	______

---

9. 快速配置模板

9.1 标准配置

serial_device: /dev/ttyUSB0
baudrate: 115200
poll_interval: 30

9.2 调试配置

serial_device: /dev/ttyUSB0
baudrate: 115200
poll_interval: 10
logger: debug

9.3 高性能配置

serial_device: /dev/ttyUSB0
baudrate: 921600
poll_interval: 5
debounce_cooldown: 0.5

---

10. 故障排查记录

日期	问题描述	排查步骤	解决方案	状态
______	______	______	______	□
______	______	______	______	□
______	______	______	______	□