KukaVariableProxyMaster

插件用途

通过 KUKA KRC4 变量代理按变量名读取或写入单个控制器变量。当前插件没有程序启动、停止或复位方法；需要程序控制时应使用支持对应操作的 KUKA 控制器插件。

选择入口

进入“开发配置 → 采集配置”，创建设备并在“采集插件”中选择“KukaVariableProxyMaster”。

支持的通道和数据类型

通道类型	配置前检查
TCP 客户端	确认设备 IP、端口和网关到设备的网络可达性。

可选数据类型： Byte、String

地址规则

• KUKA 变量代理地址为控制器变量名，例如 $POS_ACT；变量名和值固定使用 UTF-8。
• 周期采集支持 Byte 和 String；String 必须在地址中指定 len，例如 $PRO_NAME[];len=32;encoding=UTF-8。
• 每个变量独立请求，不进行跨变量打包。

特殊方法

方法	用途	参数
ReadVariableTextAsync	读取 KUKA 变量	address=变量名
WriteVariableTextAsync	写入 KUKA 变量	address=变量名,value=变量值

写入、启停、复位、装载、删除或控制类方法会改变现场设备状态。执行前应确认设备处于可操作状态，并准备停止或回退措施。

设备调试

进入“开发配置 → 采集配置”，选择当前设备后点击“更多功能”并打开“调试”。

专用调试页

协议调试页用于通过 KRC4 变量代理读取或写入单个控制器变量。

功能	作用
读取变量	按一个 KUKA 变量名读取文本值，不改变控制器状态。
写入变量	按变量名写入文本值，会修改控制器内存。
调试结果	显示变量返回值，或本次写入成功、失败及错误。

调试要点

先读取单变量；写变量会改变控制器内存，执行前必须二次确认。

验证重点

1. 先读取一个只读变量，例如 $POS_ACT，确认返回值与示教器当前显示一致。
2. 周期读取字符串时，在变量地址中填写 len 和 encoding=UTF-8，并核对完整文本。
3. 该插件每个变量独立请求；连续创建多个变量后，逐项观察响应时间和设备负载。
4. 写入只在专用测试变量上验证，写入后重新读取同一变量确认结果。

排障差异

• 变量读取没有返回：检查 TCP 地址、端口、KRC4 变量代理服务和变量名大小写。
• 字符串被截断：确认地址中的 len 足够容纳返回文本，并保持 encoding=UTF-8。
• 写入失败：确认变量允许外部修改、值格式符合控制器变量类型，并查看代理返回错误。
• 找不到程序控制：当前插件只提供单变量读写，不包含程序启动、停止或复位方法。

相关操作

• 采集配置：查看通道、设备和公共变量配置。
• 插件索引：查找其它采集或数据转发插件。