在 AWTK 串口屏中，內置 MODBUS 客戶端通道模型，不用編寫代碼即可實現在 ListView 中顯示遠程設備上的數組數據。

1. 功能

不用編寫代碼，實現對遠程設備上數組數據的顯示。

2. 創建項目

從模板創建項目，將 hmi/template_app 拷貝 hmi/modbus_client_channel_input_registers 即可。

第一個項目最好不要放到其它目錄，因為放到其它目錄需要修改配置文件中的路徑，等熟悉之后再考慮放到其它目錄。路徑中也不要中文和空格，避免不必要的麻煩。

3. 制作界面

用 AWStudio 打開上面 modbus_client_channel_input_registers 目錄下的 project.json 文件。里面有一個空的窗口，做出類似下面的界面。

4. 添加綁定規則

第一次用到列表視圖，有幾點需要特別說明一下：列表視圖中的滾動視圖需要指定v-for-items屬性。

4.1 幾個特殊的變量

• index 特指序數。
• item 特指當前的數據。比如在這里‘item.level’表示告警級別，‘item.time’表示時間，‘item.device’表示設備，‘item.message’表示告警信息。
• selected_index 表示當前選中的序數（可在列表視圖之外綁定）。
• items 表示當前列表視圖中的數據個數（可在列表視圖之外綁定）。

4.2序數

4.3告警級別前面提到告警級別是正數，可以通過 item.level 來獲取它。它的意義對應為：調試(0);信息(1);警告(2);錯誤(3)，我們需要用 one_of 函數將它轉換為對應的字符串。

4.4時間時間是整數（秒數），可以通過 item.time 來獲取。

4.5告警信息告警信息是一個字符串，可以通過 item.message 來獲取。

4.6URL

4.7連接狀態

4.8窗口模型

指定窗口的模型為：

modbus_client 是內置的模型，name 是配置文件的名稱，不需要加后綴。

4.9視圖模型

為了使用 channel 的模型，還需要在窗口的下一級控件指定 modbus_client_channel 模型。

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。