# protocol-templates.json 字段说明

## 模板对象字段

- `id`: 协议模板唯一标识（实例配置里 `protocolTemplateId` 对应此值）。
- `name`: 协议模板显示名称。
- `version`: 协议版本号（便于区分现场版本）。
- `fields`: 字段映射列表。

## fields 数组中每个字段含义

- `fieldKey`: 业务字段名（建议唯一）。  
  例：`11001_TaskNo`、`StackerCraneStatus`
- `dbNumber`: 对应 PLC 的 DB 块号。  
  例：`50`、`900`、`901`
- `offset`: 字节偏移（从 0 开始）。
- `bit`: 位偏移（仅 `Bool` 类型有效，范围 `0-7`）。
- `dataType`: 数据类型枚举值。
- `length`: 长度。  
  - `String` 类型：字符串长度  
  - 其他类型：通常填 `1`
- `direction`: 数据方向枚举值。

## dataType 枚举

- `0 = Byte`
- `1 = Int`（16 位有符号）
- `2 = DInt`（32 位有符号）
- `3 = String`
- `4 = Bool`

## direction 枚举

- `0 = WcsToPlc`（WCS 写 PLC）
- `1 = PlcToWcs`（PLC 写 WCS）
- `2 = Bidirectional`（双向）

## 维护建议

- 一个模板内 `fieldKey` 不要重复。
- 同一个字段地址（`dbNumber + offset + bit`）不要被多个不同语义字段复用。
- 修改 `dbNumber` 时，确保实例配置里的 `dbBlockNumbers` 包含对应 DB 块。