# 8Multi协议设备接入技术方案

## 一、项目背景

在现有8ADPRO设备接入系统的基础上，新增8Multi协议设备的接入支持。需要保持原有8ADPRO协议功能完全不受影响，通过扩展现有架构实现新协议的兼容。

## 二、协议对比分析

### 2.1 原8ADPRO协议格式
```
+YAV:设备号,温度,电流,计数1,计数2,模拟1,模拟2,模拟3,模拟4,模拟5,模拟6,模拟7,数字1,数字2,数字3,数字4,数字5,数字6,EEFF
```
- **字段数量**: 19个字段
- **特点**: 简单直接，所有值都是实际物理量

### 2.2 新8Multi协议格式
```
+YAV:id,电流1,电流2,质量1,质量2,温度,湿度,工作停机故障清零,频率1,计数1,频率2,计数2,供电报警软启动停止,从机数据1,从机数据2,触摸屏,EEFF
```

**C格式**: `+YAV:%d,%d,%d,%d,%d,%.1f,%.1f,%d,%d,%d,%d,%d,%d,%d,%d,0,EEFF`

- **字段数量**: 16个字段（不含帧头+YAV和帧尾EEFF）
- **特点**: 
  - 包含设备ID字段（g_tDevParam.Address）
  - 电流1/2：AI1/AI2，范围0-20A，需量程转换（0-65535映射）
  - 质量1/2：AI3/AI4，需量程转换（0-65535映射）
  - 温湿度：保留1位小数的实际值
  - 4路DI复合状态（工作/停机/故障/清零）
  - 2路频率+计数
  - 2路继电器+2路DO复合状态（供电/报警/软启动/停止）
  - 485从机数据2路
  - 触摸屏数据（固定发送0）

### 2.3 关键差异点

| 项目 | 8ADPRO | 8Multi |
|------|--------|--------|
| 设备识别 | 第1字段：设备号 | 第1字段：设备ID |
| 电流采集 | 1路电流（实际值） | 2路电流（需量程校准） |
| 质量采集 | 无 | 2路质量（需量程校准） |
| 温湿度 | 仅温度 | 温度+湿度 |
| 状态位 | 6个独立数字量 | 4个复合状态字段（位运算） |
| 计数器 | 2路计数 | 2路频率+计数 |
| 状态上传 | 无 | 2路继电器+2路DO状态 |
| 扩展功能 | 无 | 485从机+触摸屏 |

**说明**：8Multi协议的继电器和DO字段为下位机上传的状态，不涉及下发控制功能。

## 三、数据库设计方案

### 3.1 设备主表扩展 (device)

**新增字段**:
```sql
ALTER TABLE `device` 
ADD COLUMN `protocol_type` ENUM('8ADPRO', '8MULTI') NOT NULL DEFAULT '8ADPRO' 
    COMMENT '协议类型（8ADPRO=原协议，8MULTI=新协议），根据device_no自动判断：>200为8MULTI，<=200为8ADPRO' AFTER `device_code`,
ADD COLUMN `current1_range_start` DECIMAL(10,3) DEFAULT 0 
    COMMENT '电流1量程起点（A）' AFTER `protocol_type`,
ADD COLUMN `current1_range_end` DECIMAL(10,3) DEFAULT NULL 
    COMMENT '电流1量程终点（A），用于0-65535映射，8Multi设备必填' AFTER `current1_range_start`,
ADD COLUMN `current2_range_start` DECIMAL(10,3) DEFAULT 0 
    COMMENT '电流2量程起点（A）' AFTER `current1_range_end`,
ADD COLUMN `current2_range_end` DECIMAL(10,3) DEFAULT NULL 
    COMMENT '电流2量程终点（A），用于0-65535映射，8Multi设备必填' AFTER `current2_range_start`,
ADD COLUMN `quality1_range_start` DECIMAL(10,3) DEFAULT 0 
    COMMENT '质量1量程起点' AFTER `current2_range_end`,
ADD COLUMN `quality1_range_end` DECIMAL(10,3) DEFAULT NULL 
    COMMENT '质量1量程终点，用于0-65535映射，8Multi设备必填' AFTER `quality1_range_start`,
ADD COLUMN `quality1_unit` VARCHAR(10) DEFAULT NULL 
    COMMENT '质量1单位（前端配置，如kg/g）' AFTER `quality1_range_end`,
ADD COLUMN `quality2_range_start` DECIMAL(10,3) DEFAULT 0 
    COMMENT '质量2量程起点' AFTER `quality1_unit`,
ADD COLUMN `quality2_range_end` DECIMAL(10,3) DEFAULT NULL 
    COMMENT '质量2量程终点，用于0-65535映射，8Multi设备必填' AFTER `quality2_range_start`,
ADD COLUMN `quality2_unit` VARCHAR(10) DEFAULT NULL 
    COMMENT '质量2单位（前端配置，如kg/g）' AFTER `quality2_range_end`,
ADD COLUMN `current_unit` VARCHAR(10) DEFAULT 'A' 
    COMMENT '电流单位（前端配置，如A/mA）' AFTER `quality2_unit`;
```

**字段说明**:
- `protocol_type`: 区分设备使用的协议类型，根据`device_no`自动判断（>200为8MULTI，<=200为8ADPRO）
- `current1_range_start` / `current1_range_end`: 电流1量程起点和终点，8Multi设备必填
- `current2_range_start` / `current2_range_end`: 电流2量程起点和终点，8Multi设备必填
- `quality1_range_start` / `quality1_range_end`: 质量1量程起点和终点，8Multi设备必填
- `quality2_range_start` / `quality2_range_end`: 质量2量程起点和终点，8Multi设备必填
- `quality1_unit` / `quality2_unit`: 质量单位（前端配置，如kg/g）
- `current_unit`: 电流单位（前端配置，如A/mA）

**协议类型判断规则**:
- `device_no > 200`: 自动设置为8MULTI协议
- `device_no <= 200`: 自动设置为8ADPRO协议
- 同一设备不能在两种协议之间切换

**量程转换公式**: 
```
量程范围 = 量程终点 - 量程起点
实际值 = (原始值 / 65535.0) * 量程范围 + 量程起点
```

**设备状态判断**:
- 电流1实际值 >= 2A **且** 电流2实际值 >= 2A：设备开启状态（与运算）
- 其他情况：设备关闭状态

### 3.2 数据表扩展 (device_data)

**新增字段**:
```sql
ALTER TABLE `device_data`
ADD COLUMN `current1_raw` INT UNSIGNED DEFAULT NULL 
    COMMENT '电流1原始值（0-65535）' AFTER `current_value`,
ADD COLUMN `current2_raw` INT UNSIGNED DEFAULT NULL 
    COMMENT '电流2原始值（0-65535）' AFTER `current1_raw`,
ADD COLUMN `current1_value` DECIMAL(10,3) DEFAULT NULL 
    COMMENT '电流1实际值（A，经量程转换）' AFTER `current2_raw`,
ADD COLUMN `current2_value` DECIMAL(10,3) DEFAULT NULL 
    COMMENT '电流2实际值（A，经量程转换）' AFTER `current1_value`,
ADD COLUMN `quality1_raw` INT UNSIGNED DEFAULT NULL 
    COMMENT '质量1原始值（0-65535）' AFTER `current2_value`,
ADD COLUMN `quality2_raw` INT UNSIGNED DEFAULT NULL 
    COMMENT '质量2原始值（0-65535）' AFTER `quality1_raw`,
ADD COLUMN `quality1_value` DECIMAL(10,3) DEFAULT NULL 
    COMMENT '质量1实际值（kg，经量程转换）' AFTER `quality2_raw`,
ADD COLUMN `quality2_value` DECIMAL(10,3) DEFAULT NULL 
    COMMENT '质量2实际值（kg，经量程转换）' AFTER `quality1_value`,
ADD COLUMN `humidity` DECIMAL(10,3) DEFAULT NULL 
    COMMENT '湿度值（%RH）' AFTER `quality2_value`,
ADD COLUMN `status_work` TINYINT(1) DEFAULT NULL 
    COMMENT '工作状态（0=停止，1=工作）' AFTER `humidity`,
ADD COLUMN `status_stop` TINYINT(1) DEFAULT NULL 
    COMMENT '停机状态（0=运行，1=停机）' AFTER `status_work`,
ADD COLUMN `status_fault` TINYINT(1) DEFAULT NULL 
    COMMENT '故障状态（0=正常，1=故障）' AFTER `status_stop`,
ADD COLUMN `status_reset` TINYINT(1) DEFAULT NULL 
    COMMENT '清零状态（0=正常，1=清零）' AFTER `status_fault`,
ADD COLUMN `frequency1` INT DEFAULT NULL 
    COMMENT '频率1原始值' AFTER `status_reset`,
ADD COLUMN `frequency2` INT DEFAULT NULL 
    COMMENT '频率2原始值' AFTER `frequency1`,
ADD COLUMN `counter1_current` INT DEFAULT NULL 
    COMMENT '计数1当前累计值（下位机传值）' AFTER `frequency2`,
ADD COLUMN `counter1_delta` INT DEFAULT NULL 
    COMMENT '计数1增量值（当前值-上次值）' AFTER `counter1_current`,
ADD COLUMN `counter2_current` INT DEFAULT NULL 
    COMMENT '计数2当前累计值（下位机传值）' AFTER `counter1_delta`,
ADD COLUMN `counter2_delta` INT DEFAULT NULL 
    COMMENT '计数2增量值（当前值-上次值）' AFTER `counter2_current`,
ADD COLUMN `counter1_total_8multi` BIGINT UNSIGNED DEFAULT NULL 
    COMMENT '计数1累计总数（8Multi专用，从清零基准值开始累计）' AFTER `counter2_delta`,
ADD COLUMN `counter2_total_8multi` BIGINT UNSIGNED DEFAULT NULL 
    COMMENT '计数2累计总数（8Multi专用，从清零基准值开始累计）' AFTER `counter1_total_8multi`,
ADD COLUMN `relay_power` TINYINT(1) DEFAULT NULL 
    COMMENT '继电器-供电状态（0=断开，1=闭合）' AFTER `counter2_total_8multi`,
ADD COLUMN `relay_alarm` TINYINT(1) DEFAULT NULL 
    COMMENT '继电器-报警状态（0=正常，1=报警）' AFTER `relay_power`,
ADD COLUMN `do_soft_start` TINYINT(1) DEFAULT NULL 
    COMMENT 'DO-软启动（0=关，1=开）' AFTER `relay_alarm`,
ADD COLUMN `do_stop` TINYINT(1) DEFAULT NULL 
    COMMENT 'DO-停止（0=关，1=开）' AFTER `do_soft_start`,
ADD COLUMN `slave_data1` INT DEFAULT NULL 
    COMMENT '485从机数据1' AFTER `do_stop`,
ADD COLUMN `slave_data2` INT DEFAULT NULL 
    COMMENT '485从机数据2' AFTER `slave_data1`,
ADD COLUMN `touchscreen_data` INT DEFAULT NULL 
    COMMENT '触摸屏数据' AFTER `slave_data2`;
```

### 3.3 动态字段配置扩展 (device_field_header_config)

**修改字段枚举**:
```sql
ALTER TABLE `device_field_header_config`
MODIFY COLUMN `field_key` ENUM(
    'analog1','analog2','analog3','analog4','analog5','analog6','analog7',
    'digital1','digital2','digital3','digital4','digital5','digital6',
    'current1','current2','quality1','quality2','humidity',
    'frequency1','frequency2','slave_data1','slave_data2','touchscreen_data'
) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL 
COMMENT '字段标识（支持8ADPRO和8Multi协议字段）';
```

### 3.4 计数器字段设计（避免触发器冲突）

**问题**：现有触发器`update_counter_totals_on_insert`处理8ADPRO的`counter1_total`/`counter2_total`字段。

**解决方案**：为8Multi添加独立的计数器总计字段，不修改触发器

**字段对比**：

| 协议 | 当前值字段 | 增量值字段 | 总计字段 | 触发器 |
|------|-----------|-----------|---------|--------|
| 8ADPRO | counter1/counter2 | - | counter1_total/counter2_total | ✅ 使用 |
| 8Multi | counter1_current/counter2_current | counter1_delta/counter2_delta | counter1_total_8multi/counter2_total_8multi | ❌ 不使用 |

**8Multi计数器逻辑**（修订版）：
```java
// 1. 获取当前累计值（下位机传值）
int currentCounter1 = parseInt(parts[10]);

// 2. 获取清零基准值（baseline）
long baseline1 = device.getCounter1Baseline() != null ? device.getCounter1Baseline() : 0L;

// 3. 计算累计值（下位机当前值 - 清零基准值）
long total1 = (long)currentCounter1 - baseline1;
if (total1 < 0) total1 = 0L;  // 负值保护

// 4. 计算增量值（当前值 - 上次值）
int delta1 = currentCounter1 - lastCounter1;
if (delta1 < 0) delta1 = 0;  // 负值归零（下位机可能重置）

// 5. 存储
deviceData.setCounter1Current(currentCounter1);    // 下位机当前累计值
deviceData.setCounter1Delta(delta1);               // 本次增量
deviceData.setCounter1Total8multi(total1);         // 累计总值（= 下位机值 - baseline）
```

**关键设计说明**：
- **累计值 = 下位机当前值 - baseline**（不是累加增量！）
- **第一条数据**：累计值 = 下位机当前值（因为baseline默认为0）
- **清零功能**：设置baseline = 当前下位机值，累计值重新从0开始
- **优点**：即使下位机重置归零，累计值仍能正确计算

**优点**：
- ✅ 不修改现有触发器，8ADPRO功能完全不受影响
- ✅ 8Multi使用独立字段，逻辑清晰
- ✅ 两种协议完全隔离，互不干扰

## 四、数据解析规则

### 4.1 量程映射转换

**电流/质量原始值转换公式**:
```
实际值 = (原始值 / 65535.0) * 量程
```

**示例**:
- 电流1量程设置为100A
- 接收到原始值32768
- 实际电流1 = (32768 / 65535.0) * 100 = 50.0A

### 4.2 复合状态位解析

#### 4.2.1 DI状态字段解析（工作/停机/故障/清零）
```
字段值: U16格式，例如 0x004F
解析规则: 取最后一个F（低4位），然后取反
```

**解析代码示例**:
```java
int diValue = parseInt(parts[8]); // 例如 0x004F
int lastNibble = diValue & 0x0F;  // 取最后4位 = 0xF = 15
int inverted = (~lastNibble) & 0x0F; // 取反并保留4位 = 0x0 = 0

// 解析各个DI状态
boolean work = (inverted & 0x01) != 0;   // DI1: 工作
boolean stop = (inverted & 0x02) != 0;   // DI2: 停机
boolean fault = (inverted & 0x04) != 0;  // DI3: 故障
boolean reset = (inverted & 0x08) != 0;  // DI4: 清零
```

#### 4.2.2 继电器+DO状态字段解析（供电/报警/软启动/停止）
```
字段值: U16格式，例如 0x004F
解析规则: 取最后一个F（低4位），然后取反（与DI状态相同）
下发格式: DO=0_1（0为通道号，1为值）
```

**解析代码示例**:
```java
int doValue = parseInt(parts[12]); // 例如 0x004F
int lastNibble = doValue & 0x0F;  // 取最后4位 = 0xF = 15
int inverted = (~lastNibble) & 0x0F; // 取反并保留4位 = 0x0 = 0

// 解析各个继电器和DO状态
boolean power = (inverted & 0x01) != 0;      // 继电器1: 供电
boolean alarm = (inverted & 0x02) != 0;      // 继电器2: 报警
boolean softStart = (inverted & 0x04) != 0;  // DO1: 软启动
boolean stopDo = (inverted & 0x08) != 0;     // DO2: 停止
```

**下发控制示例**:
```
DO=0_1  // 通道0（供电），值为1（开启）
DO=1_0  // 通道1（报警），值为0（关闭）
```

### 4.3 计数器处理逻辑（修订版）

**核心设计原则**:
- 下位机传输的是累计值
- 累计值 = 下位机当前值 - 清零基准值（baseline）
- 增量值 = 当前值 - 上次值

**完整处理流程**:
```java
// 1. 获取下位机传来的当前累计值
int counter1Current = parseInt(parts[10]); // 计数器1
int counter2Current = parseInt(parts[12]); // 计数器2

// 2. 获取清零基准值（用于计算累计值）
Long baseline1 = device.getCounter1Baseline() != null ? device.getCounter1Baseline() : 0L;
Long baseline2 = device.getCounter2Baseline() != null ? device.getCounter2Baseline() : 0L;

// 3. 计算累计值（显示在前端卡片上的大数字）
Long total1 = (long)counter1Current - baseline1;
Long total2 = (long)counter2Current - baseline2;
if (total1 < 0) total1 = 0L;  // 负值保护
if (total2 < 0) total2 = 0L;

// 4. 查询上次累计值（用于计算增量）
DeviceData lastData = selectLastByDeviceId(deviceId);
Integer lastCounter1 = lastData != null ? lastData.getCounter1Current() : 0;
Integer lastCounter2 = lastData != null ? lastData.getCounter2Current() : 0;

// 5. 计算增量值（显示在前端卡片上的小字）
int delta1 = counter1Current - lastCounter1;
int delta2 = counter2Current - lastCounter2;
if (delta1 < 0) delta1 = 0;  // 负值归零（下位机可能重置）
if (delta2 < 0) delta2 = 0;

// 6. 存储到数据库
deviceData.setCounter1Current(counter1Current);    // 下位机原始值
deviceData.setCounter1Delta(delta1);               // 增量
deviceData.setCounter1Total8multi(total1);         // 累计值
deviceData.setCounter2Current(counter2Current);
deviceData.setCounter2Delta(delta2);
deviceData.setCounter2Total8multi(total2);
```

**清零功能实现**:
- 前端提供清零按钮
- 点击清零：`UPDATE device SET counter1_baseline = 当前下位机值 WHERE id = ?`
- 清零后：累计值 = 下位机值 - baseline，重新从0开始
- 下位机继续传累计值，不受影响

**数据库字段**:
```sql
ALTER TABLE `device`
ADD COLUMN `counter1_baseline` INT DEFAULT 0 COMMENT '计数1基准值（清零后的基准）',
ADD COLUMN `counter2_baseline` INT DEFAULT 0 COMMENT '计数2基准值（清零后的基准）',
ADD COLUMN `voltage1` DECIMAL(10,3) DEFAULT NULL COMMENT '电压1配置（V），用于功率1计算',
ADD COLUMN `voltage2` DECIMAL(10,3) DEFAULT NULL COMMENT '电压2配置（V），用于功率2计算';
```

**示例场景**:
```
时间线：
下位机值：  100 → 150 → 200 → [清零,baseline=200] → 250 → 300
累计值：    100 → 150 → 200 →         0          →  50 → 100
增量值：      0 →  50 →  50 →         0          →  50 →  50
```

## 五、接口设计方案

### 5.1 数据上报接口（复用现有）

**接口路径**: `POST /equipment/info/ingest/raw`

**请求示例**:
```
+YAV:1001,32768,16384,49152,8192,25.5,65.0,15,5000,100,3000,50,3,1000,2000,0,EEFF
```

**字段映射**:
1. 帧头: +YAV（固定）
2. id: 1001（设备ID，对应g_tDevParam.Address）
3. 电流1原始值: 32768（AI1，0-65535，对应usSRegHoldBuf[0]）
4. 电流2原始值: 16384（AI2，0-65535，对应usSRegHoldBuf[1]）
5. 质量1原始值: 49152（AI3，0-65535，对应usSRegHoldBuf[2]）
6. 质量2原始值: 8192（AI4，0-65535，对应usSRegHoldBuf[3]）
7. 温度: 25.5°C（保留1位小数）
8. 湿度: 65.0%RH（保留1位小数）
9. DI状态复合: 15（工作/停机/故障/清零，对应usSRegHoldBuf[DI_REG]）
10. 频率1: 5000Hz（对应freq1）
11. 计数1: 100（对应num_count1）
12. 频率2: 3000Hz（对应freq2）
13. 计数2: 50（对应num_count2）
14. 继电器+DO状态复合: 3（供电/报警/软启动/停止，对应usSRegHoldBuf[DO_REG]）
15. 从机数据1: 1000（对应usSRegHoldBuf[DATA_REG_1]）
16. 从机数据2: 2000（对应usSRegHoldBuf[DATA_REG_1+1]）
17. 触摸屏: 0（固定发送0）
18. 帧尾: EEFF（固定）

### 5.2 设备配置接口（扩展现有）

**新增量程配置接口**: `PUT /equipment/info/device/range`

**请求参数**:
```json
{
  "id": 1,
  "current1_range": 100.0,
  "current2_range": 50.0,
  "quality1_range": 1000.0,
  "quality2_range": 500.0,
  "calibration_offset": 0.5,
  "calibration_factor": 1.02
}
```

**响应**:
```json
{
  "code": 200,
  "msg": "量程配置成功"
}
```

### 5.3 设备创建接口（扩展现有）

**接口路径**: `POST /equipment/info/device`

**请求参数扩展**:
```json
{
  "deviceNo": 1001,
  "deviceName": "8Multi设备1",
  "protocol_type": "8MULTI",
  "current1_range": 100.0,
  "current2_range": 50.0,
  "quality1_range": 1000.0,
  "quality2_range": 500.0,
  "image_url": "/profile/upload/device.png",
  "headers": {
    "current1": "主电流",
    "current2": "辅助电流",
    "quality1": "主质量",
    "quality2": "辅助质量",
    "humidity": "环境湿度",
    "frequency1": "主频率",
    "frequency2": "辅助频率"
  }
}
```

## 六、前端界面扩展

### 6.1 设备卡片展示

**8ADPRO设备卡片** (保持不变):
- 温度、电流、功率、状态
- 计数器1、计数器2

**8Multi设备卡片** (新增):
- 温度、湿度
- 电流1、电流2
- 质量1、质量2
- 工作/停机/故障状态指示灯
- 频率1、频率2
- 计数器1、计数器2

### 6.2 设备详情抽屉

**新增8Multi专属字段**:
- 电流1/电流2（显示原始值和实际值）
- 质量1/质量2（显示原始值和实际值）
- 湿度
- 工作状态、停机状态、故障状态、清零状态
- 频率1、频率2
- 继电器状态（供电、报警）
- DO状态（软启动、停止）
- 从机数据1、从机数据2
- 触摸屏数据

### 6.3 设备配置对话框

**新增配置项**:
1. **协议类型选择**: 8ADPRO / 8Multi
2. **量程配置** (仅8Multi显示):
   - 电流1量程 (A)
   - 电流2量程 (A)
   - 质量1量程 (kg)
   - 质量2量程 (kg)
3. **校准配置**:
   - 校准偏移量
   - 校准系数

## 七、实现步骤

### 7.1 数据库变更
1. ✅ 执行device表ALTER语句，新增协议类型和量程字段
2. ✅ 执行device_data表ALTER语句，新增8Multi专属字段
3. ✅ 修改device_field_header_config表枚举，支持新字段

### 7.2 后端开发（已完成）

#### 7.2.1 实体类扩展
1. ✅ **MesDevice.java** - 添加17个8Multi字段
   ```java
   // 协议类型、量程起点/终点、单位、计数器基准值、电压1/电压2
   private String protocolType;
   private BigDecimal current1RangeStart, current1RangeEnd;
   private BigDecimal current2RangeStart, current2RangeEnd;
   private BigDecimal quality1RangeStart, quality1RangeEnd;
   private String quality1Unit, quality2Unit, currentUnit;
   private Integer counter1Baseline, counter2Baseline;
   private BigDecimal voltage1, voltage2;
   
   // 辅助方法
   public boolean is8Multi() { return "8MULTI".equals(this.protocolType); }
   public boolean is8ADPRO() { return "8ADPRO".equals(this.protocolType) || this.protocolType == null; }
   ```

2. ✅ **DeviceData.java** - 添加29个8Multi字段
   ```java
   // 电流/质量原始值和实际值、湿度、状态位、频率、计数器、继电器、DO、从机数据
   private Integer current1Raw, current2Raw;
   private BigDecimal current1Value, current2Value;
   private Integer quality1Raw, quality2Raw;
   private BigDecimal quality1Value, quality2Value;
   private BigDecimal humidity;
   private Integer statusWork, statusStop, statusFault, statusReset;
   private Integer frequency1, frequency2;
   private Integer counter1Current, counter1Delta, counter2Current, counter2Delta;
   private Long counter1Total8multi, counter2Total8multi;
   private Integer relayPower, relayAlarm, doSoftStart, doStop;
   private Integer slaveData1, slaveData2, touchscreenData;
   ```

#### 7.2.2 Service层
3. ✅ **Multi8ProtocolService.java** - 8Multi协议解析服务
   - `parse8MultiProtocol()` - 协议解析方法
   - `convertRangeValue()` - 量程转换方法
   - `resetCounter()` - 计数器清零方法

#### 7.2.3 Controller层
4. ✅ **Multi8Controller.java** - 8Multi设备控制器
   - `POST /equipment/multi8/resetCounter` - 计数器清零
   - `PUT /equipment/multi8/updateDeviceConfig` - 更新设备配置
   - `GET /equipment/multi8/getDeviceDetail/{id}` - 获取设备详情

#### 7.2.4 Mapper层
5. ✅ **DeviceDataMapper.java** - 添加方法
   ```java
   DeviceData selectLastByDeviceId(@Param("deviceId") Long deviceId);
   ```

6. ✅ **MesDeviceMapper.java** - 添加方法
   ```java
   MesDevice selectByDeviceNo(@Param("deviceNo") Integer deviceNo);
   ```

### 7.3 前端开发（需手动实现）

**文件位置**：`e:\Yavii_P3\MES\mes-ui\src\views\mes\equipment\info\index.vue`（1178行）

**修改原则**：
⚠️ **在现有8ADPRO代码基础上扩展，不删除任何8ADPRO功能**
⚠️ **通过`v-if`判断协议类型，动态渲染不同UI**
⚠️ **所有8Multi字段都要做空值处理**

#### 7.3.1 设备卡片扩展
通过`v-if`判断协议类型，动态渲染不同UI：
```vue
<!-- 8ADPRO设备卡片（保持不变） -->
<div v-if="!d.protocol_type || d.protocol_type === '8ADPRO'" class="device-info">
  <!-- 原有字段 -->
</div>

<!-- 8Multi设备卡片（新增） -->
<div v-else-if="d.protocol_type === '8MULTI'" class="device-info device-8multi">
  <!-- 温度/湿度、电流1/电流2、质量1/质量2、功率1/功率2、状态 -->
</div>
```

#### 7.3.2 设备详情抽屉扩展
添加8Multi字段展示：
- 温度、湿度
- 电流1/电流2、质量1/质量2
- 功率1/功率2（计算显示）
- 频率1/频率2
- 计数器1/计数器2（含清零按钮）
- 工作/停机/故障状态
- 继电器、DO状态
- 从机数据

#### 7.3.3 设备配置对话框扩展
根据`device_no > 200`动态显示8Multi配置项：
- 电流1/电流2量程（起点~终点）
- 质量1/质量2量程（起点~终点+单位）
- 电流单位
- 电压1/电压2配置

#### 7.3.4 JavaScript方法扩展
```javascript
// 计算功率
calculatePower1(data) {
  return data.voltage1 * data.current1_value
}

// 获取状态类型
getStatusType(data) {
  if (data.status_fault) return 'danger'  // 红色
  if (data.status_stop) return 'warning'  // 黄色
  if (data.status_work) return 'success'  // 绿色
}

// 计数器清零
resetCounter(counterNo) {
  this.$http.post('/equipment/multi8/resetCounter', {...})
}
```

### 7.4 测试验证
1. 8ADPRO协议回归测试（确保不受影响）
2. 8Multi协议功能测试
3. 量程转换准确性测试
4. 校准功能测试
5. 混合设备场景测试

## 八、待确认事项

### 8.1 位运算解析规则
- [x] **DI状态字段**：已确认，U16格式取最后4位F然后取反，DI1=工作，DI2=停机，DI3=故障，DI4=清零
- [x] **继电器+DO字段**：已确认，直接读取不取反（下位机上传状态）

### 8.2 校准功能细节
- [x] **校准功能**：已确认不需要校准偏移量和校准系数

### 8.3 状态上传功能
- [x] **继电器+DO状态**：已确认为下位机上传的状态，不涉及下发控制功能

### 8.4 从机和触摸屏数据
- [x] **从机数据展示**：已确认，从机数据1/2直接展示原始值
- [x] **触摸屏数据**：已确认固定发送0

### 8.5 协议格式细节
- [x] **设备ID映射关系**：已确认，device_no>200为8MULTI，<=200为8ADPRO
- [x] **触摸屏固定值**：已确认，触摸屏字段固定发送0
- [x] **字段顺序确认**：已确认，协议字段顺序完全按照文档描述

### 8.6 量程和单位配置
- [x] **电流量程范围**：已确认，AI1/AI2电流范围为0-20A
- [x] **质量量程配置**：已确认，质量1/质量2（AI3/AI4）需要前端配置量程起点和终点
- [x] **量程转换公式**：已确认，实际值=(原始值/65535)*量程范围+量程起点
- [x] **量程必填**：已确认，8Multi设备创建时必须强制配置量程
- [x] **量程修改影响**：已确认，量程修改后不需要重新计算已存储的历史数据
- [x] **单位配置**：已确认，质量单位和电流单位由前端配置

### 8.7 计数器处理逻辑
- [x] **计数器数据类型**：已确认，下位机传的计数1和计数2是累计值
- [x] **计数器处理方式**：已确认，需要做减运算（当前值-上次值），存储累计值和增量值
- [x] **计数器清零**：已确认，前端提供清零按钮，清零后设置基准值，增量=当前值-基准值
- [x] **频率显示**：已确认，频率1和频率2显示原始值

### 8.8 数据上报和存储
- [x] **上报间隔**：已确认，8Multi设备上报频率为10秒
- [x] **数据去重**：已确认，短时间内收到相同数据全部存储
- [x] **离线缓存**：已确认，不需要关注离线缓存补发，由下位机处理

### 8.9 设备状态判断
- [x] **运行判断依据**：已确认，电流1实际值>=2A **且** 电流2实际值>=2A（与运算）
- [x] **功率计算规则**：已确认需要计算功率，前端配置电压1和电压2，功率1=电压1*电流1，功率2=电压2*电流2（分别计算）
- [x] **状态指示灯颜色**：已确认，工作=绿色，停机=黄色，故障=红色，报警=红色

### 8.10 前端展示规范
- [x] **原始值显示**：已确认，前端只显示实际值，不显示原始值
- [x] **历史数据图表**：已确认，先不做历史数据图表

### 8.11 数据有效性校验
- [x] **数据校验**：已确认，不需要数据有效性校验

### 8.12 权限和安全
- [x] **数据加密传输**：已确认，设备上报的数据不需要加密传输

### 8.13 兼容性和迁移
- [x] **协议切换**：已确认，同一设备不能在8ADPRO和8Multi之间切换协议
- [x] **数据迁移工具**：已确认，不需要提供数据迁移工具
- [x] **8ADPRO兼容性**：已确认，千万不要影响8ADPRO的功能！

### 待确认事项汇总

**已确认事项**（共34项）：
- ✅ 所有核心功能已确认
- ✅ 协议解析规则已明确
- ✅ 数据库设计已完成
- ✅ 量程配置规则已确定
- ✅ 计数器处理逻辑已明确
- ✅ 兼容性要求已明确
- ✅ 功率计算规则已明确（分别计算）
- ✅ 前端展示规范已明确（只显示实际值）
- ✅ 数据安全要求已明确（不需要加密）
- ✅ 离线缓存策略已明确（不需要关注）

**待确认事项**（共0项）：
- 🎉 所有需求已确认完毕！

**核心要求**：
- ⚠️ **千万不要影响8ADPRO的功能！**
- ⚠️ **device_no>200为8MULTI，<=200为8ADPRO**
- ⚠️ **同一设备不能在两种协议之间切换**

## 九、8ADPRO设备相关文件清单

**说明**：以下仅列出与8ADPRO设备数据接收、解析、存储、展示相关的核心文件，不包括其他IoT功能（如点检、维修、车间设备等）。

### 9.1 后端文件（Java）

#### 9.1.1 Controller层
```
e:\Yavii_P3\MES\yjh-mes\src\main\java\cn\sourceplan\equipment\controller\
└── EquipmentInfoController.java          # 设备信息控制器（核心：数据接收、动态表头、清零）
    - ingestRawData()                     # 数据接收接口
    - getDynamicHeaders()                 # 动态表头接口
    - getDeviceDataPage()                 # 设备数据查询接口
    - resetCounter()                      # 计数器清零接口
```

#### 9.1.2 Service层
```
e:\Yavii_P3\MES\yjh-mes\src\main\java\cn\sourceplan\equipment\service\
├── IEquipmentInfoService.java            # 设备信息服务接口
└── impl\
    └── EquipmentInfoServiceImpl.java     # 设备信息服务实现（核心：协议解析、数据存储）
        - ingestFrame()                   # 协议解析方法（需扩展支持8Multi）
        - parseProtocolData()             # 数据解析逻辑
        - saveDeviceData()                # 数据存储逻辑
        - updateCounter()                 # 计数器累加逻辑
        - mergeDynamicHeaders()           # 动态表头合并逻辑
```

#### 9.1.3 Domain层（实体类）
```
e:\Yavii_P3\MES\yjh-mes\src\main\java\cn\sourceplan\equipment\domain\
├── MesDevice.java                        # 设备主表实体（需添加8Multi协议字段）
├── DeviceData.java                       # 设备数据实体（需添加8Multi数据字段）
├── DeviceLatest.java                     # 设备最新数据实体
├── DeviceLatestView.java                 # 设备最新数据视图实体
└── DeviceFieldHeaderConfig.java          # 设备字段表头配置实体
```

#### 9.1.4 Mapper层
```
e:\Yavii_P3\MES\yjh-mes\src\main\java\cn\sourceplan\equipment\mapper\
├── MesDeviceMapper.java                  # 设备主表Mapper
├── DeviceDataMapper.java                 # 设备数据Mapper
├── DeviceLatestMapper.java               # 设备最新数据Mapper
├── DeviceLatestViewMapper.java           # 设备最新数据视图Mapper
├── DeviceLatestJoinMapper.java           # 设备最新数据关联Mapper
└── DeviceFieldHeaderConfigMapper.java    # 设备字段表头配置Mapper
```

#### 9.1.5 Mapper XML文件
```
e:\Yavii_P3\MES\yjh-mes\src\main\resources\mapper\equipment\
└── (对应Mapper的XML文件，需要添加8Multi字段的SQL映射)
```

### 9.2 前端文件（Vue）

```
e:\Yavii_P3\MES\mes-ui\src\views\mes\equipment\info\
└── index.vue                             # 设备信息页面（核心：实时数据监控、动态表头、清零）
    - 设备卡片展示（需扩展8Multi设备卡片）
    - 设备详情抽屉（需添加8Multi字段）
    - 设备配置对话框（需添加量程、单位、电压配置）
    - 动态表头渲染
    - 实时数据刷新
    - 计数器清零按钮
    - 功率计算显示
```

### 9.3 核心文件修改要点

**8Multi接入需要修改的5个核心文件**：

1. **EquipmentInfoController.java**
   - 数据接收接口保持不变
   - 可能需要添加设备配置更新接口（量程、单位、电压）

2. **EquipmentInfoServiceImpl.java**
   - `ingestFrame()`方法：添加协议类型判断（device_no>200为8Multi）
   - 新增8Multi协议解析分支
   - 实现量程转换逻辑
   - 实现计数器减运算逻辑
   - 实现功率计算逻辑

3. **MesDevice.java**
   - 添加17个新字段（协议类型、量程起点/终点、单位、计数器基准值、电压1/电压2）

4. **DeviceData.java**
   - 添加29个新字段（8Multi协议数据字段，含counter1_total_8multi/counter2_total_8multi）

5. **info/index.vue**
   - 根据协议类型渲染不同的设备卡片
   - 设备详情抽屉支持8Multi字段展示
   - 设备配置对话框添加量程、单位、电压1/电压2配置
   - 功率计算显示（功率1=电压1*电流1，功率2=电压2*电流2）

### 9.4 数据库表

**核心表**：
- `device`：设备主表（新增17个字段）
- `device_data`：设备数据表（新增29个字段，含8Multi专用计数器总计字段）
- `device_latest`：设备最新数据表（视图或实体表）
- `device_field_header_config`：设备字段表头配置表

## 十、兼容性保证

### 10.1 数据库兼容
- 所有新增字段均为可空或有默认值
- 原有8ADPRO设备的protocol_type默认为'8ADPRO'
- 原有字段不做任何修改

### 10.2 代码兼容
- 通过protocol_type字段区分处理逻辑
- 8ADPRO协议解析逻辑完全保留
- 新增8Multi协议解析分支

### 10.3 前端兼容
- 根据设备协议类型动态渲染UI
- 8ADPRO设备展示保持不变
- 新增8Multi设备专属UI组件

## 十一、附录

### 11.1 8Multi协议字段详细对照表

| 序号 | 字段名 | 描述 | 数据类型 | 对应C变量 | 转换规则 |
|------|--------|------|---------|-----------|----------|
| 1 | +YAV: | 帧头 | String | 固定 | 固定发送+YAV: |
| 2 | id | 设备ID | int | g_tDevParam.Address | 设备唯一标识 |
| 3 | 电流1 | 模拟输入AI1 | int(0-65535) | usSRegHoldBuf[0] | 范围0-20A<br>实际值=(原始值/65535)*量程范围+量程起点<br>实际值>=2A为设备开启 |
| 4 | 电流2 | 模拟输入AI2 | int(0-65535) | usSRegHoldBuf[1] | 范围0-20A<br>实际值=(原始值/65535)*量程范围+量程起点 |
| 5 | 质量1 | 模拟输入AI3 | int(0-65535) | usSRegHoldBuf[2] | 实际值=(原始值/65535)*量程范围+量程起点<br>前端配置量程 |
| 6 | 质量2 | 模拟输入AI4 | int(0-65535) | usSRegHoldBuf[3] | 实际值=(原始值/65535)*量程范围+量程起点<br>前端配置量程 |
| 7 | 温度 | 温湿度传感器温度 | String | temp | 保留1位小数 |
| 8 | 湿度 | 温湿度传感器湿度 | String | dht | 保留1位小数 |
| 9 | DI状态 | 工作/停机/故障/清零 | int | usSRegHoldBuf[DI_REG] | U16格式，取最后4位F，然后取反<br>DI1=工作，DI2=停机，DI3=故障，DI4=清零 |
| 10 | 频率1 | 测频器1 | String | freq1 | 实际值 |
| 11 | 计数1 | 计数器1 | int | num_count1 | 下位机传累计值 |
| 12 | 频率2 | 测频器2 | String | freq2 | 实际值 |
| 13 | 计数2 | 计数器2 | int | num_count2 | 下位机传累计值 |
| 14 | 继电器+DO | 供电/报警/软启动/停止 | int | usSRegHoldBuf[DO_REG] | 直接读取，不取反<br>下发格式: DO=0_1（0为通道号，1为值） |
| 15 | 从机数据1 | 485从机数据1 | int | usSRegHoldBuf[DATA_REG_1] | 实际值 |
| 16 | 从机数据2 | 485从机数据2 | int | usSRegHoldBuf[DATA_REG_1+1] | 实际值 |
| 17 | 触摸屏 | 触摸屏数据 | int | 固定 | 固定发送0 |
| 18 | EEFF | 帧尾 | String | 固定 | 固定发送EEFF |

### 11.2 量程配置示例

| 设备类型 | 电流1量程 | 电流2量程 | 质量1量程 | 质量2量程 |
|---------|----------|----------|----------|----------|
| 小型设备 | 50A | 30A | 500kg | 200kg |
| 中型设备 | 100A | 80A | 1000kg | 500kg |
| 大型设备 | 200A | 150A | 2000kg | 1000kg |

---

**文档版本**: v2.1  
**创建日期**: 2025-11-15  
**创建人**: 周启威  
**最后更新**: 2025-11-15  
**更新内容**: 
- v1.1: 补充待确认事项8.5-8.13，新增优先级分类
- v1.2: 根据协议详细表更新字段对照表，明确C变量对应关系，更新已确认事项
- v1.3: 重大更新
  - 修改数据库设计：量程字段拆分为起点和终点（支持非零起点）
  - 更新量程转换公式：实际值=(原始值/65535)*量程范围+量程起点
  - 明确DI状态解析：U16格式取最后4位F然后取反
  - 明确继电器+DO解析：直接读取不取反，下发格式DO=通道号_值
  - 明确设备开启判断：电流1实际值>=2A
  - 明确计数器类型：下位机传累计值
  - 更新协议字段对照表，添加详细转换规则
- v2.0: 完整需求确认版本（30项已确认）
  - 移除校准功能：不需要校准偏移量和校准系数
  - 添加单位配置：质量单位和电流单位前端配置
  - 协议判断规则：device_no>200为8MULTI，<=200为8ADPRO
  - 设备状态判断：电流1>=2A且电流2>=2A（与运算）
  - 计数器处理：减运算+清零功能（存储累计值和增量值）
  - 频率显示：显示原始值
  - 从机数据：直接展示原始值
  - 数据上报：10秒间隔，相同数据全部存储
  - 权限管理：量程配置和下发控制需要权限
  - 状态指示灯：工作=绿，停机=黄，故障=红，报警=红
  - 兼容性：不能切换协议，不影响8ADPRO功能
  - 新增计数器基准值字段和单位字段
- v2.1: 功能调整
  - 移除下发控制功能：继电器和DO字段改为下位机上传状态，不涉及下发控制
  - 移除权限管理相关需求
  - 新增8ADPRO现有文件清单章节（第九章）
  - 列出所有后端Java文件（Controller、Service、Domain、Mapper、XML）
  - 列出所有前端Vue文件
  - 标注核心文件和修改要点
  - 新增功率计算功能：前端配置电压1和电压2，功率1=电压1*电流1，功率2=电压2*电流2（分别计算）
  - device表新增voltage1和voltage2字段（共17个新字段）
  - 精简文件清单：只列出8ADPRO设备相关文件，不包括其他IoT功能
  - 确认所有待确认事项：离线缓存、原始值显示、数据加密传输
  - 🎉 所有34项需求已确认完毕，可以开始开发！
- v2.2: 代码实现完成
  - ✅ 完成所有后端代码（实体类、Service、Controller、Mapper）
  - ✅ 添加8Multi协议解析服务
  - ✅ 添加设备控制器接口
  - ✅ 扩展Mapper查询方法
  - 📝 前端代码待实现（已提供详细说明）

## 十三、代码文件清单

### 后端文件

#### 1. 实体类（2个已完成）
- ✅ `MesDevice.java` - 添加17个8Multi字段
- ✅ `DeviceData.java` - 添加29个8Multi字段

#### 2. Service层（1个新建 + 1个需集成）
- ✅ `Multi8ProtocolService.java` - 8Multi协议解析服务（新建）
- ⚠️ `EquipmentInfoServiceImpl.java` - 需要集成8Multi协议判断
  - 参考文档：`后端集成说明_EquipmentInfoServiceImpl.md`
  - 修改点：
    1. 注入Multi8ProtocolService
    2. 在ingestFrame方法开头添加协议判断
    3. deviceNo > 200 调用8Multi解析

#### 3. Controller层（1个新建）
- ✅ `Multi8Controller.java` - 8Multi设备控制器（新建）

#### 4. Mapper层（2个已扩展）
- ✅ `DeviceDataMapper.java` - 添加`selectLastByDeviceId()`方法
- ✅ `MesDeviceMapper.java` - 添加`selectByDeviceNo()`方法

#### 5. Mapper XML
- ✅ 不需要XML文件（使用MyBatis-Plus注解方式）

### 前端文件（待实现）

#### 1. 设备信息页面（1个扩展）
- `e:\Yavii_P3\MES\mes-ui\src\views\mes\equipment\info\index.vue`
  - 扩展设备卡片（协议类型判断）
  - 扩展详情抽屉（8Multi字段展示）
  - 扩展配置对话框（量程、单位、电压配置）
  - 添加JavaScript方法（功率计算、状态判断、计数器清零）

### 数据库文件

#### 1. SQL脚本（1个）
- `e:\Yavii_P3\MES\.tasks\2025-11-15_01_周启威_8Multi接入.sql`
  - device表新增17个字段
  - device_data表新增29个字段
  - 不修改触发器（使用独立字段）

## 十四、后续工作

### 待完成
1. 前端代码实现（参考第7.3节）
2. 集成测试
3. 8ADPRO回归测试

### 注意事项
⚠️ **千万不要影响8ADPRO的功能！**
⚠️ **所有修改都要通过协议类型判断**
⚠️ **前端要在现有代码基础上扩展，不要删除任何8ADPRO代码**