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