# 点位模版
# 概述
点位模版是WDS-186智能网关提供的一种快速配置工具,用于管理设备的数据点位信息。通过创建点位模版,可以实现:
- 快速部署: 相同类型设备可复用同一套点位模版
- 统一管理: 集中管理设备点位配置
- 减少错误: 避免重复配置带来的错误
- 提高效率: 大幅缩短设备添加时间
# 点位模版概念
# 什么是点位
点位是设备上的一个数据采集单元,通常对应:
- Modbus设备: 一个寄存器或寄存器组
- DI设备: 一个数字输入通道
- AI设备: 一个模拟输入通道
- 其他协议: 一个数据标识符
# 点位属性
每个点位包含以下属性:
| 属性 | 说明 | 示例 |
|---|---|---|
| 点位标识 | 点位的唯一英文标识 | temperature、humidity、pressure |
| 点位名称 | 点位的中文名称 | 温度、湿度、压力 |
| 功能码 | Modbus功能码 | 3(读保持寄存器)、15(写多个线圈) |
| 寄存器地址 | 设备中的寄存器地址 | 0、1、2...（十进制） |
| 数据类型 | 数据的类型 | int16、uint16、float32_big_big |
| 单位 | 数据单位 | ℃、%RH、kPa、V、A |
| 边缘计算 | 值的转换公式 | value / 10、value * 100 |
# 创建点位模版
# 操作步骤
进入模版管理
- 登录系统
- 进入"采集通道"页面
- 点击"设备点位模版"按钮
新增模版
- 在弹出窗口中点击"新增"按钮
- 输入模版名称(唯一,不能重复)
- 点击"确定"
添加点位
- 在模版编辑窗口中点击"添加一行"
- 填写点位信息:
- 点位标识: 英文标识，如 temperature
- 点位名称: 中文名称，如 温度
- 功能码: Modbus功能码，如 3
- 寄存器地址: 十进制地址，如 0
- 数据类型: 选择数据类型，如 int16
- 单位: 数据单位（可选），如 ℃
- 边缘计算: 转换公式（可选），如 value / 10
- 点击"确定"
# 数据类型说明
系统支持以下数据类型:
| 数据类型 | 说明 |
|---|---|
| int16 | 16位 无符号整数 |
| uint16 | 16位 有符号整数 |
| int16_bcd | 16位 BCD码 |
| int32_big_big | 32位 无符号 大端序 高字节在前 (ABCD) |
| int32_big_little | 32位 无符号 大端序 低字节在前 (CDAB) |
| int32_little_big | 32位 无符号 小端序 高字节在前 (BADC) |
| int32_little_little | 32位 无符号 小端序 低字节在前 (DCBA) |
| uint32_big_big | 32位 有符号 大端序 高字节在前 (ABCD) |
| uint32_big_little | 32位 有符号 大端序 低字节在前 (CDAB) |
| uint32_little_big | 32位 有符号 小端序 高字节在前 (BADC) |
| uint32_little_little | 32位 有符号 小端序 低字节在前 (DCBA) |
| float32_big_big | 32位 浮点数 大端序 高字节在前 (ABCD) |
| float32_big_little | 32位 浮点数 大端序 低字节在前 (CDAB) |
| float32_little_big | 32位 浮点数 小端序 高字节在前 (BADC) |
| float32_little_little | 32位 浮点数 小端序 低字节在前 (DCBA) |
| int32_bcd | 32位 BCD码 |
| unixtime | 32位 Unix时间戳 |
| float64_big_big | 64位 浮点数 大端序 高字节在前 |
| float64_big_little | 64位 浮点数 大端序 低字节在前 |
| float64_little_big | 64位 浮点数 小端序 高字节在前 |
| float64_little_little | 64位 浮点数 小端序 低字节在前 |
| bit | 32字节 定位型（用于位操作） |
| string | 字符串类型（可变长度） |
注意: 选择数据类型时，请参考设备的Modbus寄存器手册，确认正确的数据类型和字节序。
# Modbus点位配置示例
# 温湿度传感器模版
设备型号: TH-100 温湿度传感器
Modbus参数:
- 协议: Modbus RTU
- 从站地址: 1
- 波特率: 9600
- 数据位: 8
- 校验位: None
- 停止位: 1
点位配置:
| 点位标识 | 点位名称 | 功能码 | 寄存器地址 | 数据类型 | 单位 | 边缘计算 |
|---|---|---|---|---|---|---|
| temperature | 温度 | 3 | 0 | int16 | ℃ | value / 10 |
| humidity | 湿度 | 3 | 1 | int16 | %RH | value / 10 |
| device_addr | 设备地址 | 3 | 2 | uint16 | - | value |
| baudrate | 波特率 | 3 | 3 | uint16 | bps | value |
# 电表模版
设备型号: PM-200 三相电表
点位配置:
| 点位标识 | 点位名称 | 功能码 | 寄存器地址 | 数据类型 | 单位 | 边缘计算 |
|---|---|---|---|---|---|---|
| voltage_a | A相电压 | 3 | 0 | uint16 | V | value / 10 |
| voltage_b | B相电压 | 3 | 1 | uint16 | V | value / 10 |
| voltage_c | C相电压 | 3 | 2 | uint16 | V | value / 10 |
| current_a | A相电流 | 3 | 3 | uint16 | A | value / 100 |
| current_b | B相电流 | 3 | 4 | uint16 | A | value / 100 |
| current_c | C相电流 | 3 | 5 | uint16 | A | value / 100 |
| power | 有功功率 | 3 | 6 | uint32_big_big | kW | value / 10 |
| energy | 电能 | 3 | 8 | uint32_big_big | kWh | value / 100 |
# DI/AI点位配置示例
# DI(数字输入)模版
应用场景: 开关量采集
| 点位标识 | 点位名称 | 通道 | 单位 | 边缘计算 | 说明 |
|---|---|---|---|---|---|
| door_state | 门状态 | DI1 | - | value | 0=关闭,1=打开 |
| alarm_signal | 报警信号 | DI2 | - | value | 0=正常,1=报警 |
| run_state | 运行状态 | DI3 | - | value | 0=停止,1=运行 |
| fault_signal | 故障信号 | DI4 | - | value | 0=正常,1=故障 |
# AI(模拟输入)模版
应用场景: 4-20mA电流采集
| 点位标识 | 点位名称 | 通道 | 量程 | 单位 | 边缘计算 | 说明 |
|---|---|---|---|---|---|---|
| water_level | 液位 | AI1 | 4-20mA | m | (value - 4) / 16 * 10 | 水箱液位，满量程10米 |
| pressure | 压力 | AI2 | 4-20mA | MPa | (value - 4) / 16 * 1.6 | 管道压力，满量程1.6MPa |
# 模版管理
# 查看模版
- 进入点位模版管理页面
- 查看已创建的模版列表
- 点击模版名称查看详情
# 编辑模版
- 在模版列表中点击"编辑"按钮
- 修改模版信息或点位配置
- 点击"保存"应用修改
# 删除模版
- 选择要删除的模版
- 点击"删除"按钮
- 确认删除操作
# 使用模版
创建模版后,在添加设备时可以:
- 进入设备管理页面
- 添加新设备
- 在"点位模版"下拉框中选择已创建的模版
- 系统自动填充点位配置
- 根据实际情况微调(如需要)
- 保存设备配置
详见设备管理文档。
# 最佳实践
# 模版命名规范
建议使用清晰的命名规则:
- 格式:
设备类型_型号_版本 - 示例:
温湿度传感器_TH100_v1三相电表_PM200_v2PLC_S7-1200_标准
# 点位命名规范
点位标识命名（英文）:
- 使用小写字母和下划线
- 清晰表达含义
- 保持简洁
良好示例:
temperature- 温度water_level- 水位total_power- 总功率
不佳示例:
temp1- 不够清晰value1- 无意义data- 过于宽泛
点位名称命名（中文）:
- 使用中文名称,便于理解
- 避免特殊字符
- 保持简洁明了
- 可以包含位置信息
良好示例:
一号车间温度进水管压力总有功功率
不佳示例:
temp1值1数据
# 版本管理
- 重大修改时创建新版本
- 保留旧版本以便回退
- 在描述中注明版本变更内容
# 文档管理
- 为每个模版添加详细描述
- 记录设备型号和厂家信息
- 注明点位地址的参考来源
# 常见问题
# 模版名称重复
解决方法: 使用唯一的模版名称,可以加上版本号或日期。
# 点位地址冲突
解决方法: 检查设备手册,确认正确的地址映射关系。
# 数据类型选择
解决方法: 参考设备Modbus寄存器表,选择匹配的数据类型。
# 边缘计算设置说明
边缘计算公式用于将采集的原始值转换为实际值。
常用公式示例:
value / 10: 原始值除以10（如原始值100表示实际值10.0）value * 10: 原始值乘以10（如原始值100表示实际值1000）(value - 4) / 16 * 量程: 4-20mA转换公式value: 不转换，直接使用原始值
示例:
- 如果原始值为235，边缘计算为
value / 10，实际值为 23.5 - 如果原始值为10，边缘计算为
(value - 4) / 16 * 100，实际值为 37.5