在 AWTK 串口屏中,内置了 MODBUS Client 的模型,支持用 MODBUS 协议从远程设备获取数据。不用编写一行代码即可实现对远程设备数据的显示和修改。
1. 功能
不用编写代码,实现对远程设备数据的显示和修改。
2. 创建项目
从模板创建项目,将 hmi/template_app 拷贝 hmi/modbus_client_input_registers 即可。
第一个项目最好不要放到其它目录,因为放到其它目录需要修改配置文件中的路径,等熟悉之后再考虑放到其它目录。路径中也不要中文和空格,避免不必要的麻烦。
3. 制作界面
用 AWStudio 打开上面 modbus_client_input_registers 目录下的 project.json 文件。里面有一个空的窗口,做出类似下面的界面。
4. 添加绑定规则
4.1 URL
绑定属性 | 绑定规则 | 说明 |
---|---|---|
v-data:value | {url} | url 表示远程设备的 URL |
4.2 连接状态
绑定属性 | 绑定规则 | 说明 |
---|---|---|
v-data:value | {connected ? ‘connected’ : ‘no connection’} | connected 表示当前是否连接 |
4.3 湿度
绑定属性 | 绑定规则 | 说明 |
---|---|---|
v-data:value | {湿度} | 湿度 在配置文件中定义,参考后面的配置 |
4.4 温度
绑定属性 | 绑定规则 | 说明 |
---|---|---|
v-data:value | {温度} | 温度 在配置文件中定义,参考后面的配置 |
4.5 窗口模型
- 指定窗口的模型为
绑定属性 | 绑定规则 | 说明 |
---|---|---|
v-model | modbus_client(name=modbus_demo) | 配置文件名对应于 modbus_demo.json |
modbus_client 是内置的模型,name 是配置文件的名称,不需要加后缀。
5. 配置文件
配置文件路径 design/default/data/modbus_demo.json
{"url":"tcp://localhost:502","channels" : [{"update_interval" : 3000,"name" : "read_input_registers","access_type" : 4,"read" : {"offset" : 0,"length" : 4}}],"variables": {"温度": "read_input_registers.word[0]","湿度": "read_input_registers.word[1]"}
}
- url: 远程设备的 URL
- update_interval: 更新间隔,单位毫秒
- channels: 通道列表
- name: 通道名称
- access_type: 访问类型
- read: 读取配置
- offset: 偏移
- length: 长度
- variables: 变量列表
- 温度: 映射到 modbus 通道的 word[0]
- 湿度: 映射到 modbus 通道的 word[1]
6. 描述需要持久化的数据
无
7. 编译运行
运行 bin 目录下的 demo 程序:
点击 Update 按钮,可以手工刷新数据
8. 注意
-
本项目并没有编写界面相关的代码,AWStudio 在 src/pages 目录下生成了一些代码框架,这些代码并没有用到,可以删除也可以不用管它,但是不能加入编译。
-
完整示例请参考:demo_modbus_client_input_registers
-
使用TCP协议时,如果使用modbus slave工具配套测试,需要将unit id设置为255