ZFADM001通讯协议

## ADM001称重模块通信协议V1.1

## 串口通信格式

| **起始位** | **数据位** | **停止位** | **奇偶校验位** | **默认波特率** |
|------------|------------|------------|----------------|----------------|
| 1          | 8          | 1          | 无             | 19200          |

## 数据帧格式

| **数据方向** | **设备地址** | **功能码** | **读/写** | **参数** | **校验码** |
|--------------|--------------|------------|-----------|----------|------------|
| 发送         | 1Byte        | 1Byte      | 1Byte     | nByte    | 1Byte      |
| 返回         | 1Byte        | 1Byte      | 无        | nByte    | 1Byte      |

- **数据采用十六进制格式，指令发送间隔时间≥10ms**
- **设备地址：**可设置范围1-255，0为广播地址
- **功能码：**用于区分指令功能，返回的功能码会+1
- **读/写：**0x00表示读，0x01表示写
- **参数：**不同功能码对应的参数内容、长度不同，具体看指令说明
- **校验码：**一帧数据的所有字节相加（除校验码本身），取低八位

## 功能指令

以下所有示例均以地址1为例

### 1、读取设备信息（只读）

| 数据方向 | 设备地址 | 功能码 | 读/写 | 参数     | 校验码 |
|----------|----------|--------|-------|----------|--------|
| 发送     | 0x01     | 0x00   | 0x00  | 1Byte    | /      |
| 返回     | 0x01     | 0x01   | 无    | 3/1Byte  | /      |

发送的参数第1个字节表示要读取的设备信息：
- 0x00：软件版本号（3个字节）
**例：**
- 发送 `01 00 00 00 01`；读取01地址设备信息
- 发送 `00 00 00 00 00`；使用广播地址设备信息
### 2、读取重量（只读）

| 数据方向 | 设备地址 | 功能码 | 读/写 | 参数 | 校验码 |
|----------|----------|--------|-------|------|--------|
| 发送     | 0x01     | 0x02   | 0x00  | 无   | /      |
| 返回     | 0x01     | 0x03   | 无    | 4Byte | /      |

返回的参数：
- 第1个字节表示正负数：0x00（负数）、0x01（正数）
- 第2~4个字节表示重量值

**例：**
- 发送 `01 02 00 03`；读取重量值
- 返回 `01 03 01 E2 40 2A`；重量为123456g

### 3、清零、设置默认零点（只写）

| 数据方向 | 设备地址 | 功能码 | 读/写 | 参数  | 校验码 |
|----------|----------|--------|-------|-------|--------|
| 发送     | 0x01     | 0x04   | 0x01  | 1Byte | /      |
| 返回     | 0x01     | 0x05   | 无    | 无    | /      |

发送的参数第1个字节表示：
- 0x00：清零
- 0x01：清零并设当前重量为默认零点

### 4、查询、设置滤波等级

| 数据方向 | 设备地址 | 功能码 | 读/写 | 参数  | 校验码 |
|----------|----------|--------|-------|-------|--------|
| 发送     | 0x01     | 0x08   | 0x01  | 1Byte | /      |
| 返回     | 0x01     | 0x09   | 无    | 无/1Byte | /      |

- 滤波等级越高，重量值变化越平稳，但也更慢
- 只有当判稳功能关闭时，滤波等级设置才起作用
- 发送的参数第1个字节表示滤波强度，参数值范围为0-2

### 5、查询、设置分度值

| 数据方向 | 设备地址 | 功能码 | 读/写 | 参数  | 校验码 |
|----------|----------|--------|-------|-------|--------|
| 发送     | 0x01     | 0x0C   | 0x01  | 1Byte | /      |
| 返回     | 0x01     | 0x0D   | 无    | 无    | /      |

发送的参数第1个字节表示分度值代号：
- 0：1g  1：2g  
- 2：5g  3：10g  
- 4：20g  5：50g  
- 6：100g  7：200g  
- 8：500g  9：1000g

### 6、查询、设置满量程

| 数据方向 | 设备地址 | 功能码 | 读/写 | 参数   | 校验码 |
|----------|----------|--------|-------|--------|--------|
| 发送     | 0x01     | 0x16   | 0x01  | 2Bytes | /      |
| 返回     | 0x01     | 0x17   | 无    | 无     | /      |

发送的参数第1~2个字节表示满量程，单位为kg

**例：**
- 发送 `01 16 01 00 28 40`；设置满量程为40kg

### 7、标定（只写）

| 数据方向 | 设备地址 | 功能码 | 读/写 | 参数  | 校验码 |
|----------|----------|--------|-------|-------|--------|
| 发送     | 0x01     | 0x18   | 0x01  | 2Byte | /      |
| 返回     | 0x01     | 0x19   | 无    | 无    | /      |

发送的参数第1~2个字节表示单位为kg的重量值

**标定流程：**
1. 清空秤盘，执行清零或设置默认零点
2. 加载砝码，执行标定
3. 建议最大标定重量不低于传感器量程的60%

**例：**
- 发送 `01 04 01 01 00 07`；清零
- 发送 `01 18 01 00 14 2E`；标定20kg

### 8、读取AD值、内码（只读）

| 数据方向 | 设备地址 | 功能码 | 读/写 | 参数  | 校验码 |
|----------|----------|--------|-------|-------|--------|
| 发送     | 0x01     | 0x1C   | 0x00  | 1Byte | /      |
| 返回     | 0x01     | 0x1D   | 无    | 4Bytes | /      |

发送的参数第1个字节表示读取的数据类型：
- 0x00：AD值，ADC芯片输出的原始值
- 0x01：内码值，把满量程分成一百万份，例如满量程为10kg，内码值100000时表示重量值1kg

返回的参数：
- 第1个字节表示正负：0x00（负数）、0x01（正数）
- 第2~4个字节表示AD或内码的数值

**例：**
- 发送 `01 1C 00 01 1E`；读取内码值
- 返回 `01 1D 01 E2 40 42`；内码值为123456

### 9、查询、设置设备地址

| 数据方向 | 设备地址 | 功能码 | 读/写 | 参数    | 校验码 |
|----------|----------|--------|-------|---------|--------|
| 发送     | 0x01     | 0x20   | 0x01  | 无/1Byte | /      |
| 返回     | 0x01     | 0x21   | 无    | 无      | /      |

发送的参数第1个字节表示新设备地址。若查询地址，参数为空

### 10、查询、设置波特率

| 数据方向 | 设备地址 | 功能码 | 读/写 | 参数    | 校验码 |
|----------|----------|--------|-------|---------|--------|
| 发送     | 0x01     | 0x22   | 0x01  | 无/1Byte | /      |
| 返回     | 0x01     | 0x23   | 无    | 无      | /      |

发送的参数第1个字节表示波特率代号：
- 0：9600  
- 1：19200  
- 2：38400  
- 3：57600  
- 4：115200

```