# S7 PLC 数据解析问题排查指南

## 问题现象
虽然有数据返回,但解析出来的数值与实际PLC中的值不一致。

## 常见原因及解决方案

### 1. 字节序问题 (最常见)

**问题描述:**
- 西门子S7协议使用**大端序**(Big-Endian)
- 如果库返回的是小端序,会导致数值错误

**示例:**
```
PLC中VW100 = 256 (0x0100)
大端序: [0x01, 0x00] → 计算: (0x01 << 8) | 0x00 = 256 ✓
小端序: [0x00, 0x01] → 计算: (0x00 << 8) | 0x01 = 1 ✗
```

**当前实现:**
代码已使用大端序转换:
```java
private int bytesToWord(byte[] data) {
    return ((data[0] & 0xFF) << 8) | (data[1] & 0xFF);  // 大端序
}
```

**排查方法:**
查看日志中的原始数据和计算结果:
```
读取VW区: addr=VW100, data=[1, 0], hex=01 00, value=256
```

---

### 2. DB块号问题

**问题描述:**
V区(VB/VW/VD)对应PLC中的数据块(DB),不同项目可能使用不同的DB块号。

**当前实现:**
```java
// 固定使用DB1
data = connector.read(DaveArea.DB, 1, addressInfo.getByteOffset(), 2);
```

**解决方案:**
如果你的PLC使用其他DB块(如DB2、DB100等),需要修改代码或配置。

**排查步骤:**
1. 在PLC程序中确认V区对应的DB块号
2. 查看TIA Portal或STEP 7中的符号表
3. 修改代码中的DB块号参数

---

### 3. AIW/AQW地址偏移问题

**问题描述:**
模拟量模块的地址可能不是从0开始,而是从64、128等开始。

**示例:**
```
第一个模拟量通道: AIW0
第二个模拟量通道: AIW2 或 AIW64 (取决于硬件配置)
```

**排查方法:**
1. 查看PLC硬件组态
2. 确认模拟量模块的起始地址
3. 在PLC监控表中验证实际地址

---

### 4. 数据类型不匹配

**问题描述:**
使用了错误的读取方法,导致数据类型解析错误。

**对照表:**
| PLC地址 | 正确方法 | 错误示例 |
|---------|---------|---------|
| VW100 (字) | bytesToWord() - 2字节 | bytesToDWord() - 4字节 |
| VD200 (双字) | bytesToDWord() - 4字节 | bytesToWord() - 2字节 |
| M0.1 (位) | getBit() | 直接读取字节 |

**排查方法:**
查看日志中的字节长度:
```
读取VW区: data=[1, 0]      ← 应该是2字节
读取VD区: data=[64, 66, 0, 0]  ← 应该是4字节
```

---

### 5. 浮点数精度问题

**问题描述:**
VD区存储的是IEEE 754浮点数,转换可能有精度损失。

**示例:**
```
PLC中: 25.5
读取后: 25.500001 或 25.499999
```

**解决方案:**
在应用层进行四舍五入:
```java
BigDecimal value = new BigDecimal(result);
value = value.setScale(2, BigDecimal.ROUND_HALF_UP);
```

---

## 调试步骤

### 第1步: 启用DEBUG日志

在`application.yml`或`application.properties`中设置:
```yaml
logging:
  level:
    com.mh.user.s7.S7ConnectorUtil: DEBUG
```

### 第2步: 查看原始数据日志

运行程序后,查看日志输出:
```
2026-06-23 10:30:15 DEBUG - 读取VW区: addr=VW100, data=[1, 0], hex=01 00, value=256
2026-06-23 10:30:15 INFO  - 读取成功: addr=VW100, value=256
```

### 第3步: 对比PLC实际值

1. 打开TIA Portal或STEP 7
2. 进入在线监控模式
3. 查看对应地址的实际值
4. 对比日志中的value值

### 第4步: 分析差异

**情况A: 字节顺序相反**
```
PLC显示: 256 (0x0100)
日志显示: data=[0, 1], value=1
```
→ 需要交换字节顺序

**情况B: 数值完全不对**
```
PLC显示: 100
日志显示: value=16777216
```
→ 可能是DB块号错误或地址偏移错误

**情况C: 浮点数异常**
```
PLC显示: 25.5
日志显示: value=1.23E-40
```
→ 字节序错误或数据类型错误

---

## 常见问题案例

### 案例1: VW区读数是小端序

**现象:**
```
PLC: VW100 = 256
日志: data=[0, 1], value=1
```

**解决:**
检查`bytesToWord()`方法,确保是大端序:
```java
// 正确 - 大端序
return ((data[0] & 0xFF) << 8) | (data[1] & 0xFF);

// 错误 - 小端序
return (data[0] & 0xFF) | ((data[1] & 0xFF) << 8);
```

---

### 案例2: VD区浮点数解析错误

**现象:**
```
PLC: VD200 = 25.5
日志: data=[65, 76, 0, 0], value=25.5  ← 正确
或
日志: data=[0, 0, 76, 65], value=异常值  ← 错误
```

**解决:**
确认`bytesToDWord()`使用大端序:
```java
int intBits = ((data[0] & 0xFF) << 24) |
              ((data[1] & 0xFF) << 16) |
              ((data[2] & 0xFF) << 8) |
              (data[3] & 0xFF);
return Float.intBitsToFloat(intBits);
```

---

### 案例3: DB块号错误

**现象:**
```
PLC: DB100.DBW0 = 1000
日志: value=0 或随机值
```

**解决:**
修改读取时的DB块号:
```java
// 如果V区对应DB100
data = connector.read(DaveArea.DB, 100, addressInfo.getByteOffset(), 2);
```

---

## 快速验证方法

### 方法1: 使用已知值测试

在PLC程序中设置一个已知值:
```
MB10 = 123 (0x7B)
VW100 = 256 (0x0100)
VD200 = 10.5 (浮点数)
```

然后读取并对比:
```
预期日志:
读取M区: addr=M10, data=[123], hex=7B, value=123
读取VW区: addr=VW100, data=[1, 0], hex=01 00, value=256
读取VD区: addr=VD200, data=[65, 40, 0, 0], hex=41 28 00 00, value=10.5
```

### 方法2: 使用PLC仿真软件

1. 安装S7-PLCSIM Advanced
2. 创建测试程序,设置已知值
3. 运行Java程序读取
4. 对比结果

### 方法3: 使用其他S7客户端工具

推荐使用:
- **Modbus Poll** (支持S7)
- **CAS Modbus Scanner**
- **QModMaster**

用这些工具读取相同的地址,对比结果。

---

## 性能优化建议

### 1. 批量读取

如果需要读取多个连续地址,建议使用批量读取:
```java
// 一次性读取10个字
byte[] data = connector.read(DaveArea.DB, 1, 0, 20);  // 20字节 = 10个字
```

### 2. 减少日志输出

生产环境关闭DEBUG日志:
```yaml
logging:
  level:
    com.mh.user.s7.S7ConnectorUtil: INFO
```

### 3. 连接复用

当前已实现连接缓存,确保不要频繁创建新连接。

---

## 联系支持

如果以上方法都无法解决问题,请提供:

1. **日志输出**: 包含完整的DEBUG日志
2. **PLC截图**: TIA Portal中对应地址的监控值
3. **地址信息**: 具体的registerAddr配置
4. **期望值vs实际值**: 对比表格

---
**更新日期**: 2026-06-23