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 块。