GrabBag/App/BeltTearing/Doc/撕裂ModbusTCP简化协议文档.md

# 皮带撕裂检测系统 - ModbusTCP协议文档

## 版本信息

**当前版本**：v1.1.0
**文档状态**：正式发布


| 版本号 | 修订日期 | 修订人 | 修订说明 |
|--------|---------|--------|----------|
| v1.1.0 | 2025-11-30 | - | 调整寄存器地址<br>将复位命令移至第一个寄存器，便于后续扩展 |
| v1.0.0 | 2025-11-25 | - | 初始版本，定义基础报警和复位功能 |

---

## 1. 概述

本文档描述了皮带撕裂检测系统与PLC系统通过ModbusTCP协议进行数据交互的简化规范。系统提供撕裂报警信息和手动复位功能。

## 2. 系统架构

- **服务器端**：皮带撕裂检测系统
- **客户端**：PLC或外部控制系统
- **通信协议**：ModbusTCP
- **默认端口**：502

## 3. 寄存器地址分配

| Modbus地址 | 寄存器名称 | 类型 | 读/写 | 描述 |
|-----------|----------|------|------|------|
| 40001 | 复位命令 | UInt16 | 读/写 | 写入1执行复位，清除报警 |
| 40002 | 撕裂报警标志 | UInt16 | 只读 | 0=无报警，1=撕裂报警 |
| 40003 | 最大长度 | UInt16 | 只读 | 撕裂最大长度值(mm) |
| 40004 | 最大宽度 | UInt16 | 只读 | 撕裂最大宽度值(mm) |
| 40005 | 最大撕裂ID | UInt32 | 只读 | 最大撕裂对应的ID<br>占用2个寄存器，40005-40006|

## 4. 工作原理

### 4.1 报警流程

1. 系统检测到撕裂时，**40002寄存器**自动置为1
2. 同时更新**40003**（最大长度）、**40004**（最大宽度）和**40005-40006**（最大撕裂ID）数据
3. 报警状态会一直保持，直到手动复位

### 4.2 复位流程

1. PLC向**40001寄存器**写入值1
2. 系统执行复位操作：
   - 清除40001复位命令（置为0）
   - 清除40002报警标志（置为0）
   - 清除40003和40004数据（置为0）
   - 清除40005-40006最大撕裂ID（置为0）
   - 重置内部检测状态
3. 系统恢复正常监测状态

## 5. 功能码支持

| 功能码 | 描述 | 支持情况 |
|--------|------|----------|
| 0x03 | 读取保持寄存器 | 支持 |
| 0x06 | 写单个寄存器 | 支持(仅40001复位寄存器) |
| 0x10 | 写多个寄存器 | 支持(仅40001复位寄存器) |

## 6. 使用示例

### 6.1 读取报警状态

```
请求：
功能码: 0x03 (读取保持寄存器)
起始地址: 40001
寄存器数量: 6

响应示例（有报警）：
- 40001: 0x0000 (复位命令)
- 40002: 0x0001 (报警)
- 40003: 0x0032 (长度50mm)
- 40004: 0x000A (宽度10mm)
- 40005: 0x0000 (撕裂ID高16位)
- 40006: 0x2710 (撕裂ID低16位，ID=10000)
```

### 6.2 复位报警

```
请求：
功能码: 0x06 (写单个寄存器)
寄存器地址: 40001
寄存器值: 0x0001

响应：
功能码: 0x06
寄存器地址: 40001
寄存器值: 0x0001 (确认写入成功)
```

复位完成后再次读取：
```
请求：
功能码: 0x03 (读取保持寄存器)
起始地址: 40001
寄存器数量: 6

响应示例（复位后）：
- 40001: 0x0000 (复位命令已清除)
- 40002: 0x0000 (无报警)
- 40003: 0x0000 (数据已清除)
- 40004: 0x0000 (数据已清除)
- 40005: 0x0000 (ID已清除)
- 40006: 0x0000 (ID已清除)
```

## 7. 注意事项

1. **报警保持特性**：报警标志(40002)一旦置位，只能通过写入复位寄存器(40001)来清除，不会自动复位
2. **数据单位**：长度和宽度数据单位为毫米(mm)，范围0-65535
3. **复位操作**：只有40001寄存器支持写操作，写入其他地址将返回异常
4. **复位值**：向40001写入任何非零值都会触发复位操作，建议统一使用1
5. **读取频率**：建议PLC以100ms-500ms的周期轮询读取40002寄存器监测报警状态
6. **数据有效性**：仅当40002=1时，40003、40004和40005-40006的数据才有意义
7. **撕裂ID格式**：最大撕裂ID是32位整数，占用2个寄存器（40005为高16位，40006为低16位），采用大端字节序
8. **扩展性设计**：复位命令位于第一个寄存器(40001)，便于后续在末尾扩展更多数据字段而不影响核心功能

## 8. 错误处理

系统可能返回以下Modbus异常码：

| 异常码 | 描述 | 常见原因 |
|--------|------|----------|
| 0x01 | 非法功能码 | 使用了不支持的功能码 |
| 0x02 | 非法数据地址 | 访问了未定义的寄存器地址 |
| 0x03 | 非法数据值 | 写入了不合法的数据值 |
| 0x04 | 从设备故障 | 检测系统内部故障 |

## 9. 典型应用场景

### 场景1：PLC监控报警
```
循环执行：
1. PLC定时读取40002寄存器（报警标志）
2. 如果40002=1，读取40003、40004和40005-40006获取撕裂尺寸和ID
3. PLC触发声光报警
4. 操作员检查现场后，通过HMI按钮触发复位
5. PLC向40001写入1执行复位
```

### 场景2：自动记录报警历史
```
循环执行：
1. 检测到40002从0变为1
2. 立即读取40003、40004和40005-40006
3. 记录时间戳、撕裂尺寸和撕裂ID数据
4. 等待手动复位指令
5. 执行复位后继续监测
```

## 10. 地址映射说明

| 寄存器描述地址 | Modbus协议地址 | 实际寄存器地址 |
|--------------|---------------|---------------|
| 40001 | 功能码0x03/0x06, 地址0 | 内部地址0 |
| 40002 | 功能码0x03, 地址1 | 内部地址1 |
| 40003 | 功能码0x03, 地址2 | 内部地址2 |
| 40004 | 功能码0x03, 地址3 | 内部地址3 |
| 40005 | 功能码0x03, 地址4 | 内部地址4 |
| 40006 | 功能码0x03, 地址5 | 内部地址5 |

**注意**：Modbus协议中实际使用的寄存器地址需要减去40001，例如访问40001时使用地址0，访问40006时使用地址5。