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

1. 功能

不用編寫代碼，實現(xiàn)對遠程設(shè)備上數(shù)組數(shù)據(jù)的顯示。

2. 創(chuàng)建項目

從模板創(chuàng)建項目，將 hmi/template_app 拷貝 hmi/modbus_client_channel_input_registers 即可。

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

3. 制作界面

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

4. 添加綁定規(guī)則

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

4.1 幾個特殊的變量

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

4.2序數(shù)

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

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

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

4.6URL

4.7連接狀態(tài)

4.8窗口模型

指定窗口的模型為：

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

4.9視圖模型

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

modbus_client_channel 是內(nèi)置的模型，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字節(jié)。

配置文件路徑 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 中的數(shù)據(jù)，分成 100等份，也就是看作 100元素的數(shù)組，每個元素 64 字節(jié)。這 64 字節(jié)的數(shù)據(jù)為三個成員：

level: 4 字節(jié)，無符號整數(shù)；

time: 4 字節(jié)，無符號整數(shù)；

message: 56 字節(jié)，字符串。

6. 描述需要持久化的數(shù)據(jù)

無

7. 編譯運行

運行 bin 目錄下的 demo 程序：

點擊Update按鈕，可以手工刷新數(shù)據(jù)

8. 注意

• 本項目并沒有編寫界面相關(guān)的代碼，AWStudio 在 src/pages 目錄下生成了一些代碼框架，這些代碼并沒有用到，可以刪除也可以不用管它，但是不能加入編譯。
• 完整示例請參考：demo_modbus_client_channel_input_registers。

使用 TCP 協(xié)議時，如果使用 modbus slave 工具配套測試，需要將 unit id 設(shè)置為 255。