APRUS Lua-MitsuMC配置说明

第一章 概述

1.1 文档说明

文档概述APRUS Lua-MitsuMC协议相关配置说明，APRUS 的Lua包含APRUS.lua和config.lua两个文件。APRUS通过MitsuMC协议与三菱MC系列PLC通信，然后配置config.lua即可采集需要的数据。如需修改APRUS.lua文件的内容时，请咨询相关的技术人员，随意修改会导致适配器不能正常工作，所以此文档主要介绍config.lua内容。
此文档目的是为了让相关人员清楚如何通过对脚本的配置实现对应协议的数据采集，详细介绍config.lua的相关内容，如遇到新的需求或者处理不当的地方联系相关负责人。

1.2 适用对象

本文档的目的读者是所有通过适配器对三菱MC系列PLC（MitsuMC协议）进行数据采集的人员。

1.3 术语和缩略词

序号 术语名称 其它名称 术语说明
1 APRUS Advanced Programmable Remote Utility Server 高级可编程远程数据适配终端

1.4 参考资料

  • [1].《HslCommunicationDemo》
  • [2].《昆仑通态HMI屏编程软件》

第二章 背景介绍

  1. APRUS 在数据获取时，分为两部分，数据采集（CollrReg）和数据上报（CollpReg），主要是为了提升采集效率而设定，数据采集过程中尽可能把能连续采集的一次性完成。
  2. 数据上报是指将已经采集的数据进行必要的处理后上报到云端。

第三章 配置说明

3.1 config.lua配置

说明：

序号 模块 说明 备注
1 ipmode IP获取方式 默认Manual，不更改
2 Inet_addr APRUS IP 与对接设备保持相同网段，且同网段内IP不能重复
3 netmask 子网掩码 默认255.255.255.0，一般不修改，除非相同网段内没有足够IP
4 Luaver 脚本版本号 每次变更脚本都需更新版本，以便区分不同版本的区别
5 devinfo 设备类型 对接的设备类型

3.1.1 Ipmode: IP获取方式

ipmode=”Manual”。
ipmode为APRUS的IP获取方式，默认为Manual，手动模式，人为填写APRUS的IP。

3.1.2 Inet_addr: APRUS IP

Inet_addr=”192.168.1.234”。
Inet_addr为APRUS的IP，需要同对接设备保持在相同的网段内，否则无法与对接设备通过网口通信。

3.1.3 Netmask: 子网掩码

netmask=”255.255.255.0”。
netmask为子网掩码，默认为255.255.255.0，通常情况下均为255.255.255.0不变。

3.1.4 Devinfo: 设备类型

devinfo= “MixsuMCDev”。
devinfo设置设备类型，用于标识对接的是哪类设备。

3.1.5 Luaver: 脚本版本

Luaver = “MAPRUS.L.V030005.R”。
Luaver设置当前脚本的版本号，每次更新都需要更改并向上增加版本号，以确保之前的版本有备份，能够自动升级。

3.1.6 MitsuMC:Device: MitsuMC设备信息

Device={
    Type="3E-Binary",
    ip="192.168.1.200",
    port=502
},

Mitsufx设备信息

  1. Type=”3E-Binary”
    MC协议子类 目前仅支持 3E-Binary

  2. ip=”192.168.1.200”
    PLC IP地址

  3. Port=502
    PLC 端口号

3.1.7 Node节点信息

node={
collect={
{reg=”X”, addr=0, cnt=50},
{reg=”D”, addr=0, cnt=50},
},
variable={
{reg=”X”,addr=0,dtype=”bit”,dBit=0,pMode={1,8},dStyle={“L1_X_0”}},
{reg=”D”,addr=0,dtype=”bit”,dBit=5,pMode={1,8},dStyle={“L1_D_0_5”}},
},

1 collect:采集配置

  • collect设置采集配置，采集配置主要有几个参数构成
    • 采集配置 参数 说明 备注
      • CollrReg reg 寄存器类型 X/Y/M/L/F/V/B D
      • addr 采集地址起始 以双字节为单位的起始地址X/Y/M/L/F/V/B 寄存器: 以位为单位的起始地址
      • cnt 采集长度 D寄存器: 一个采集长度为2字节 X/Y/M/L/F/V/B 寄存器: 一个采集长度为1位

2 variable:上报配置

  • variable设置上报配置，上报配置时需要把采集到的数据处理成最终实际使用的数据，包括数据处理逻辑，上报逻辑，数据分类等等；由于采集时是按照双字（short）或位(bit)采集，所以在数据处理的时候要需要注意。
    • 注意：上报配置设置的地址，一定是在采集配置里面有的，否则数据不准确。
    • 采集配置 参数 说明 备注
      • CollpReg reg 寄存器 寄存器类型 X/Y/M/L/F/V/B寄存器： 仅支持bit数据类型 D寄存器： 支持 bit、byte、short、int float数据类型
      • addr 变量地址 addr=0 需要上报的数据地址
      • dtype 变量数据类型 dtype=”short” bit byte short/ushort（Word类型即为short/ushort） Int/uint（Double Word类型即为int/uint） float
      • pMode 采集上报方式 pMode={1,5} 详见附件一
      • dOffset 数据偏移 dOffset={{“+”,10},{“*”,5}} 数据偏移在关于bit处理的时候是不需要的，详见附件二
      • dBit 位处理 dBit=5 位标识，详见附件三
      • dExt 附件报文处理 dExt={0,{0,0},{0,0}} (选填)改变上报条件限制, 当pMode为{2,0}时有效，{“>”, 100} 表示 当原始数据发生改变 并且改变值大于100时上报，{“<”, 100} 表示 当原始数据发生改变 并且改变值小于100时上报，{“=”, 100} 表示 当原始数据发改变 并且改变值等于100时上报
      • dStyle KEY dStyle={“L1_3_0_0”} 自行设置
      • len 字符串长度 len=5 当dtype为bytes时有效，表示字符串长度

3.2 apurs.lua配置

说明：function start() 为主流程入口函数

3.2.1 user 全局通用/配置类

  1. 本机网络配置方法
    • user.ipconfig(config.APRUSX.ipmode,config.APRUSX.inet_addr,config.APRUSX.netmask)
  2. 消息捕获方法
    • msg = user.waitmsg()
      • msg.from：消息来源 mqtt-sys 来自mqtt系统消息 mqtt-msg 来自mqtt数据消息 mitsumc 来自mitsumc管理器的消息
  3. 以下为 msg.from为 modbus opcua mitsufx mitsumc dlt645等协议时通用
    • msg.session: 消息会话对象
    • msg.code：消息号
    • msg.style_L：变量名称
    • msg.val_L：变量值
    • msg.style_E：事件变量名称
    • msg.val_E：事件变量值
    • msg.z：条件改变标志位
  4. 以下为 msg.from为 mqtt时使用
    • msg.topic：mqtt话题
    • msg.payload：mqtt消息数据
  5. 以下为 msg.from为 mqtt-sys时使用
    • msg.code：mqtt事件 0： mqtt断开 1： mqtt 连接
  6. 设置Lua版本信息
    • user.setLuaver(Luaver)
  7. 设置设备信息
    • user.setdevinfo(devinfo)

3.2.2 mqtt对象方法

  1. 创建mqtt对象实例
    • mqttobj = mqtt.new()
  2. 配置mqtt连接信息 (选填)
    • mqtt.config(mqttobj, "mqtt_1", "192.168.1.159", "1883")
      • param 1 mqtt对象实例
      • param 2 实例id
      • param 3 mqtt服务器ip
      • param 4 mqtt 服务器端口
      • 注：此配置选填,如果不填,则通过gards 服务器自动指定
  3. 话题订阅
    • mqtt.subscribe(mqttobj, "p2p")
  4. 发布消息
    • mqtt.publish(mqttobj, reserve, topic, payload)
      • reserve: 预留参数,必须有,可填nil
  5. mqtt运行
    • mqtt.run(mqttobj)
      • 备注：支持多实例，最大可创建3个mqtt对象

3.2.3 MitsuMc 对象方法

  1. 创建mitsumc对象实例
    • mitsumcobj = mitsumc.new()
  2. Mitsumc对象配置
    • mitsumc.config(mitsumcobj, ip, port, type)
      • param 1 mitsumc对象实例
      • param 2 设备ip
      • param 3 设备端口
      • param 4 协议子类型
  3. Mitsumc 添加采集节点
    • mitsumc.add_collectnode(mitsumcobj, reg, addr, cnt)
      • param 1 mitsumc对象实例
      • param 2 寄存器名称
      • param 3 寄存器地址
      • param 4 采集长度
  4. Mitsumc 添加变量节点
    • mitsumc.add_collectnode(mitsumcobj, reg, addr, dtype, dBit, len, pMode, dStyle, dOffset, dExt)
      • param 1 mitsumc对象实例
      • param 2 寄存器名称
      • param 3 寄存器地址
      • param 4 变量类型
      • param 5 位偏移 (只有当数据类型为bit时有效 但此字段必须有)
      • param 6 变量长度 (只有当数据类型为bytes时有效 但此字段必须有)
      • param 7 采集上报模式
      • param 8 采集上报名称
      • param 9 数据补偿计算
      • param 10改变上报条件限制
  5. Mitsumc向被指定节点写入数据
    • mitsufx.write(mitsumcobj, style, val)
      • param 1 mitsumc对象实例
      • param 2 变量名称
      • param 3 变量值
  6. Mitsumc 实例启动
    • mitsumc.run(mitsumcobj)
  7. Mitsumc 实例停止
    • mitsumc.stop(mitsumcobj)
      • 备注 ： mitsumc 可支持多实例模式，即一对多(PLC)采集
文档更新时间: 2025-01-10 17:28   作者：CGL