node-red-contrib-symi/DEVICE_CONFIG.md

Node-RED nodes for smart home device communication with Home Assistant integration, supporting HassKit, Clowire, Alive, LF and complete Symi protocols

# 设备配置说明

## 设备参数详解

### 1. 设备UID (Device UID)
- **作用**: 设备的唯一标识符，用于区分不同的设备实例
- **格式**: 数字，如 `1001`, `2001`, `3001`
- **用途**: 
  - 在总线通信中标识特定设备
  - 用于设备状态跟踪和管理
  - 确保命令发送到正确的设备

### 2. 设备地址 (Device Address)
- **作用**: 设备在通信总线上的物理地址
- **格式**: 数字，通常为 `1-255`
- **用途**:
  - RS485/Modbus总线地址
  - TCP网络中的设备节点地址
  - 用于路由和寻址

### 3. 设备通道 (Device Channel)
- **作用**: 设备内部的具体通道或端口号
- **格式**: 数字，通常为 `0-15` 或更多
- **用途**:
  - 多路开关的不同路数
  - 多通道调光器的不同通道
  - 空调的不同功能模块

## 通信方式

### TCP网络通信
- **适用场景**: 以太网连接的设备
- **配置项**:
  - Host: 设备IP地址或主机名
  - Port: TCP端口号（默认8666）

### 串口通信 (RS485/RS232)
- **适用场景**: 串口总线连接的设备
- **配置项**:
  - 串口路径: `/dev/ttyUSB0` (Linux) 或 `COM1` (Windows)
  - 波特率: 9600, 19200, 38400, 115200等
  - 数据位: 5, 6, 7, 8
  - 停止位: 1, 2
  - 校验位: 无校验, 奇校验, 偶校验

## 协议支持

### 1. CLOWIRE协议
- **数据帧长度**: 9字节
- **CRC校验**: 16位CRC
- **支持设备**: 开关、调光、空调等

### 2. HASSKIT协议
- **数据帧长度**: 8字节
- **校验方式**: 简单累加校验
- **支持设备**: 气候控制、开关设备

### 3. ALIVE协议
- **特点**: 心跳保活机制
- **用途**: 设备在线状态监控

### 4. LF协议
- **特点**: 轻量级协议
- **用途**: 简单设备控制

### 5. 亖米(SYMI)协议
- **数据帧长度**: 15字节
- **设备类型**:
  - 0x01: 灯光设备
  - 0x02: 空调设备
  - 0x03: 窗帘设备
  - 0x05: 地暖设备
  - 0x06: 新风设备

## 配置示例

### 开关设备配置
```
设备UID: 1001
设备地址: 1
设备通道: 0
协议类型: CLOWIRE
```

### 多路开关配置
```
设备UID: 1002
设备地址: 1
设备通道: 1-4 (不同通道对应不同路)
协议类型: CLOWIRE
```

### 空调设备配置
```
设备UID: 2001
设备地址: 2
设备通道: 0
协议类型: HASSKIT
```

## 注意事项

1. **设备UID必须唯一**: 同一系统中不能有重复的UID
2. **地址冲突**: 同一总线上的设备地址不能冲突
3. **通道范围**: 通道号不能超过设备支持的最大通道数
4. **协议匹配**: 确保选择的协议与实际设备匹配
5. **通信参数**: 串口通信时确保波特率等参数与设备一致