• APP示例

    APP示例

    下面代码提供一个简易的应用示例。展示：

    • 基本的应用框架
    • 创建一个设备
      • 包含一个输入项
    • 使用随机数作为数据值
    • 输出报文

    代码：

    1. local class = require 'middleclass'
    3. --- 注册对象(请尽量使用唯一的标识字符串)
    4. local app = class("YOUR_APP_NAME_App")
    5. --- 设定应用最小运行接口版本(目前版本为1,为了以后的接口兼容性)
    6. app.API_VER = 1
    8. ---
    9. -- 应用对象初始化函数
    10. -- @param name: 应用本地安装名称。 如modbus_com_1
    11. -- @param sys: 系统sys接口对象。参考API文档中的sys接口说明
    12. -- @param conf: 应用配置参数。由安装配置中的json数据转换出来的数据对象
    13. function app:initialize(name, sys, conf)
    14.     self._name = name
    15.     self._sys = sys
    16.     self._conf = conf
    17.     --- 获取数据接口
    18.     self._api = self._sys:data_api()
    19.     --- 获取日志接口
    20.     self._log = sys:logger()
    21.     --- 设备实例
    22.     self._devs = {}
    24.     self._log:debug("XXXX Application initlized")
    25. end
    27. --- 应用启动函数
    28. function app:start()
    29.     self._api:set_handler({
    30.         --[[
    31.         --- 处理设备输入项数值变更消息，当需要监控其他设备时才需要此接口，并在set_handler函数传入监控标识
    32.         on_input = function(app, sn, input, prop, value, timestamp, quality)
    33.         end,
    34.         ]]
    35.         on_output = function(app, sn, output, prop, value)
    36.         end,
    37.         on_command = function(app, sn, command, param)
    38.         end,    
    39.         on_ctrl = function(app, command, param, ...)
    40.         end,
    41.     })
    43.     --- 生成设备唯一序列号
    44.     local sys_id = self._sys:id()
    45.     local sn = sys_id.."."..self._sys:gen_sn('example_device_serial_number')
    47.     --- 增加设备实例
    48.     local inputs = {
    49.         {name="tag1", desc="tag1 desc"}
    50.     }
    51.     local meta = self._api:default_meta()
    52.     meta.name = "Example Device"
    53.     meta.description = "Example Device Meta"
    54.     local dev = self._api:add_device(sn, meta, inputs)
    55.     self._devs[#self._devs + 1] = dev
    57.     return true
    58. end
    60. --- 应用退出函数
    61. function app:close(reason)
    62.     --print(self._name, reason)
    63. end
    65. --- 应用运行入口
    66. function app:run(tms)
    67.     for _, dev in ipairs(self._devs) do
    68.         dev:dump_comm("IN", "XXXXXXXXXXXX")
    69.         dev:set_input_prop('tag1', "value", math.random())
    70.     end
    72.     return 10000 --下一采集周期为10秒
    73. end
    75. --- 返回应用对象
    76. return app