AWTK 开源串口屏开发(17) - 通过 MODBUS 访问数组数据

在 AWTK 串口屏中，内置了 MODBUS Client Channel 的模型，不用编写代码即可实现在 ListView 中显示数组数据。

MODBUS 协议一次只能读取 125 个 WORD，AWTK-MODBUS Client Channel 支持长数据，自动分成多个请求访问。

1. 功能

不用编写代码，实现对远程设备上数组数据的显示。

2. 创建项目

从模板创建项目，将 hmi/template_app 拷贝 hmi/modbus_client_channel_input_registers 即可。

第一个项目最好不要放到其它目录，因为放到其它目录需要修改配置文件中的路径，等熟悉之后再考虑放到其它目录。路径中也不要中文和空格，避免不必要的麻烦。

3. 制作界面

用 AWStudio 打开上面 modbus_client_channel_input_registers 目录下的 project.json 文件。里面有一个空的窗口，做出类似下面的界面。

4. 添加绑定规则

第一次用到列表视图，有几点需要特别说明一下：

列表视图中的滚动视图需要指定 v-for-items 属性：

属性	值	说明
v-for-items	true	它保证其下的列表项，会根据数据自动生成｜

4.0 几个特殊的变量

• index 特指序数。
• item 特指当前的数据。比如在这里 ‘item.level’ 表示告警级别，‘item.time’ 表示时间，‘item.device’ 表示设备，‘item.message’ 表示告警信息。
• selected_index 表示当前选中的序数（可在列表视图之外绑定）。
• items 表示当前列表视图中的数据个数（可在列表视图之外绑定）。

4.1 序数

绑定属性	绑定规则	说明
v-data:value	{index}	index 特指序数。

4.2 告警级别

前面提到告警级别是正数，可以通过 item.level 来获取它。它的意义对应为：调试 (0); 信息 (1); 警告 (2); 错误 (3)，我们需要用 one_of 函数将它转换为对应的字符串。

绑定属性	绑定规则	说明
v-data:value	{one_of(‘调试；信息；警告；错误’, item.level)}	这里的 one_of 的功能是从指定的字符串数组中取出对应的子串。

4.3 时间

时间是整数（秒数），可以通过 item.time 来获取。

绑定属性	绑定规则	说明
v-data:value	{date_time_format(item.time, ‘Y-M-D hⓂ️s’)}	需要用 date_time_format 将 epoch 时间转换成人类可读的时间。

4.4 告警信息

告警信息是一个字符串，可以通过 item.message 来获取。

绑定属性	绑定规则	说明
v-data:value	{item.message}

4.5 URL

绑定属性	绑定规则	说明
v-data:value	{url}	url 表示远程设备的 URL

4.6 连接状态

绑定属性	绑定规则	说明
v-data:value	{connected ? ‘connected’ : ‘no connection’}	connected 表示当前是否连接

4.7 窗口模型

• 指定窗口的模型为

绑定属性	绑定规则	说明
v-model	modbus_client(name=modbus_demo)	配置文件名对应于 modbus_demo.json

modbus_client 是内置的模型，name 是配置文件的名称，不需要加后缀。

4.8 视图模型

• 为了使用 channel 的模型，还需要在窗口的下一级控件指定 modbus_client_channel 模型。

绑定属性	绑定规则	说明
v-model	modbus_client_channel(name=modbus_demo_input_register)	配置文件名对应于 modbus_demo_input_register.json

modbus_client_channel 是内置的模型，name 是配置文件的名称，不需要加后缀。

5. 配置文件

配置文件路径 design/default/data/modbus_demo.json

{
  "url":"tcp://localhost:502",
  "channels" : [
    {
      "update_interval" : 5000,
      "name" : "read_input_registers",
      "access_type" : 4,
      "read" : {
        "offset" : 0,
        "length" : 3200
      }
    }
  ]
}

在上面的配置中，定义了通道 read_input_registers，长度为 3200 个 registers，共 6400 字节。

配置文件路径 design/default/data/modbus_demo_input_register.json

{
  "channel":"read_input_registers",
  "items": 100,
  "variables": {
    "level": "byte[0].uint32",
    "time": "byte[4].uint32",
    "message": "byte[8].str[56]"
  }
}

在上面的配置中，将通道 read_input_registers 中的数据，分成 100 等份，也就是看作 100 元素的数组，每个元素 64 字节。这 64 字节的数据为三个成员：

• level: 4 字节，无符号整数
• time: 4 字节，无符号整数
• message: 56 字节，字符串

6. 描述需要持久化的数据

无

7. 编译运行

运行 bin 目录下的 demo 程序：

点击 Update 按钮，可以手工刷新数据

8. 注意

• 本项目并没有编写界面相关的代码，AWStudio 在 src/pages 目录下生成了一些代码框架，这些代码并没有用到，可以删除也可以不用管它，但是不能加入编译。

• 完整示例请参考：demo_modbus_client_channel_input_registers

• 使用 TCP 协议时，如果使用 modbus slave 工具 配套测试，需要将 unit id 设置为 255