# DeviceConfig 表字段说明

## 数据库表：device_config

### 字段结构说明

#### 1. `config_json` 列
**用途**：存储**通用配置参数**（前端"配置参数"卡片中的键值对）

**数据结构**：
```json
[
  {
    "paramKey": "参数名1",
    "paramValue": "参数值1",
    "description": "描述1"
  },
  {
    "paramKey": "参数名2",
    "paramValue": "参数值2",
    "description": "描述2"
  }
]
```

**前端位置**：设备编辑弹窗 → "配置参数"卡片

**特点**：
- 通用的键值对配置
- 可以添加任意参数
- 用于存储设备特定的自定义参数

---

#### 2. `extra_params` 列
**用途**：存储**扩展参数**（结构化的JSON对象）

**数据结构**：
```json
{
  "connectionConfig": {
    "moduleCode": "模块编号",
    "protocolType": "通讯协议",
    "timeout": 30,
    "retryCount": 3,
    "heartbeatInterval": 30
  },
  "plcConfig": {
    "dbArea": "DB1",
    "beginIndex": 0,
    "autoModeInterval": 5000,
    "plcType": "S7-1200"
  },
  "plcProjectId": "项目ID",
  "deviceLogic": {
    // 根据设备类型不同而不同
    // 上大车设备：
    "vehicleCapacity": 6000,
    "glassIntervalMs": 1000,
    "autoFeed": true,
    "maxRetryCount": 5,
    "positionMapping": {
      "POS1": 1,
      "POS2": 2
    }
    // 大理片设备：
    // "glassSize": 2000,
    // "processingTime": 5000,
    // "autoProcess": true
    // 玻璃存储设备：
    // "storageCapacity": 100,
    // "retrievalMode": "FIFO",
    // "autoStore": true,
    // "autoRetrieve": true
  }
}
```

**前端位置**：设备编辑弹窗中的多个配置区域

---

### extra_params 详细说明

#### 2.1 `connectionConfig` - 连接配置
**前端位置**："连接配置"卡片

| 字段 | 说明 | 前端显示位置 |
|------|------|------------|
| `moduleCode` | 模块编号 | 连接配置 → 模块编号 |
| `protocolType` | 通讯协议 | 连接配置 → 通讯协议 |
| `timeout` | 超时时间(秒) | 连接配置 → 超时时间 |
| `retryCount` | 重试次数 | 连接配置 → 重试次数 |
| `heartbeatInterval` | 心跳间隔(秒) | 连接配置 → 心跳间隔 |

#### 2.2 `plcConfig` - PLC地址配置
**前端位置**："PLC 地址配置"卡片

| 字段 | 说明 | 前端显示位置 |
|------|------|------------|
| `dbArea` | DB块 | PLC地址配置 → DB块 |
| `beginIndex` | 起始索引 | PLC地址配置 → 起始索引 |
| `autoModeInterval` | 自动间隔(ms) | PLC地址配置 → 自动间隔 |
| `plcType` | PLC类型 | 基本信息 → PLC类型（但保存在这里） |

#### 2.3 `plcProjectId` - PLC项目ID
**说明**：用于标识PLC项目，在PLC操作时使用

#### 2.4 `deviceLogic` - 设备逻辑参数
**前端位置**："设备逻辑配置"卡片（根据设备类型动态显示）

**上大车设备**：
- `vehicleCapacity`: 车辆容量
- `glassIntervalMs`: 玻璃间隔(ms)
- `autoFeed`: 自动上料
- `maxRetryCount`: 最大重试次数
- `positionMapping`: 位置映射对象

**大理片设备**：
- `glassSize`: 玻璃尺寸
- `processingTime`: 处理时间(ms)
- `autoProcess`: 自动处理
- `maxRetryCount`: 最大重试次数

**玻璃存储设备**：
- `storageCapacity`: 存储容量
- `retrievalMode`: 取货模式 (FIFO/LIFO/RANDOM)
- `autoStore`: 自动存储
- `autoRetrieve`: 自动取货
- `maxRetryCount`: 最大重试次数

---

## 字段对比总结

| 字段 | 存储内容 | 前端位置 | 用途 |
|------|---------|---------|------|
| `config_json` | 通用键值对参数 | "配置参数"卡片 | 自定义参数，灵活配置 |
| `extra_params.connectionConfig` | 连接相关配置 | "连接配置"卡片 | 通讯连接参数 |
| `extra_params.plcConfig` | PLC地址配置 | "PLC地址配置"卡片 | PLC读写地址参数 |
| `extra_params.deviceLogic` | 设备逻辑参数 | "设备逻辑配置"卡片 | 设备业务逻辑参数 |
| `extra_params.plcProjectId` | 项目ID | 隐藏字段 | 内部使用 |

---

## 使用建议

1. **config_json**：用于存储不常用的、自定义的配置参数
2. **extra_params.connectionConfig**：用于存储连接相关的标准配置
3. **extra_params.plcConfig**：用于存储PLC地址相关的配置
4. **extra_params.deviceLogic**：用于存储设备业务逻辑相关的配置（根据设备类型不同）