KeyenceNanoMaster
插件用途
KEYENCE KV Nano Upper Link 地址读写和状态诊断驱动
选择入口
进入“开发配置 → 采集配置”，创建设备并在“采集插件”中选择“KeyenceNanoMaster”。
支持的通道和数据类型
| 通道类型 | 配置前检查 |
|---|---|
| 串口 | 确认串口未被其它程序占用，并与设备保持一致的波特率、数据位、停止位和校验位。 |
| TCP 客户端 | 确认设备 IP、端口和网关到设备的网络可达性。 |
| TCP 服务端 | 确认本地监听地址和端口可用，并允许现场设备主动连接网关。 |
可选数据类型： Boolean、Int16、UInt16、Int32、UInt32、Float、String
插件参数
协议参数
| 参数 | 说明 |
|---|---|
| PLC 站号 | 默认：0；填写：文本输入。PLC 站号；多分支链路连接命令使用 0 至 99 的两位站号 |
| 连接时使用站号 | 默认：否；填写：开关。连接时使用站号；启用后 CR 连接命令携带两位站号 |
地址规则
- 基恩士 KV 上位链路布尔地址：R、CR、MR、LR 必须使用 字编号.位编号，例如 R10.3；B、VB 使用十六进制编号；T、C、CTH、CTC 可读取接点。
- WORD 地址：DM、CM、TM、VM、EM、FM、ZF、W、Z；R、CR、MR、LR、B、VB 打包视图必须显式添加 .U，例如 R10.0.U、B10.U。
- DWORD 地址：AT、TS、TC、CC、CS；T、C、CTH、CTC 的三十二位当前值访问必须显式添加 .D，例如 T1.D。
- 请求以 CR 结束，响应必须以 CRLF 结束；每次连接或重连执行 CR，正常断开前执行 CQ；TCP 常用端口为 8501。
特殊方法
| 方法 | 用途 | 参数 |
|---|---|---|
| ClearErrorAsync | 清除 CPU 错误 | 无参数 |
| ReadPlcTypeAsync | 读取 PLC 型号 | 无参数 |
| ReadPlcModeAsync | 读取 PLC 模式 | 无参数 |
| SetDateTimeAsync | 设置 PLC 时间 | 日期时间 |
| ReadAnnotationAsync | 读取软元件注释 | 软元件地址 |
| ReadExpansionAsync | 读取扩展单元 | 单元号,起始地址,WORD 数量 |
| WriteExpansionAsync | 写入扩展单元 | 单元号,起始地址,十六进制字节 |
写入、启停、复位、装载、删除或控制类方法会改变现场设备状态。执行前应确认设备处于可操作状态，并准备停止或回退措施。
设备调试
进入“开发配置 → 采集配置”，选择当前设备后点击“更多功能”并打开“调试”。
专用调试页
协议调试页分为概览、注释和扩展单元三个页签。
| 功能 | 作用 |
|---|---|
| 读取 PLC 型号/模式 | 确认连接对象和当前运行模式，不改变 PLC 状态。 |
| 清除 CPU 错误 | 清除控制器错误，属于控制操作。 |
| 设置控制器时间 | 修改 PLC 时钟，属于控制操作。 |
| 读取注释 | 按软元件地址读取 PLC 中的注释。 |
| 读取扩展单元 | 按单元号、起始地址和 WORD 数量读取扩展区。 |
| 写入扩展单元 | 向扩展区写入十六进制 WORD，属于高风险写入。 |
验证重点
- 先读取 PLC 型号和模式，确认与目标控制器一致。
- 读取一个已知 WORD 地址和一个布尔地址，例如
DM100与R10.3。 - 读取 WORD 视图时按地址规则添加
.U，读取三十二位当前值时添加.D。 - 在“注释”页签读取一个已存在注释的软元件，确认地址和返回文本一致。
- 扩展单元先只读验证；清错、设置时间和扩展区写入必须在现场允许后执行。
排障差异
- PLC 型号和模式均无法读取：核对通道、常用 TCP 端口
8501、PLC 站号和“连接时使用站号”。 - 连接后立即断开：查看 CR 连接命令和 CRLF 响应是否完整，并检查透明 TCP 设备是否改写了结束符。
- WORD 或 DWORD 值不正确：确认
.U、.D后缀和地址区域匹配，不要把接点地址直接作为数值区读取。 - 扩展单元读取失败：核对单元号、起始地址和 WORD 数量；写入前确认十六进制数据长度正确。
- 特殊方法执行失败：核对方法参数和权限；控制、写入或复位类方法还需确认设备处于允许操作的状态。
- 串口设备无响应：确认串口未被占用，并核对波特率、数据位、停止位和校验位。