PyTool Modbus

Quan Lin

關於這個應用程式

PyTool Modbus 是一個很好的 Modbus 開發、調試和監控工具。
它具有 Python 腳本功能，可為您提供最大的靈活性。

為什麼 Modbus 工具需要腳本功能？
電氣工程師發現使用 Android 手機或平板電腦等手持設備在現場、工廠或實驗室中調試或監控 Modbus 通信非常方便。
但是幾乎每個 Modbus 通信系統都有自己的數據格式。
在像“02a5b4ca....ff000803”這樣的十六進制數據的海洋中搜索並試圖弄清楚正在發生的事情一點也不愉快。
這就是 PyTool Modbus 可以提供幫助的地方。
憑藉運行自定義 Python 腳本的能力，PyTool Modbus 可以讀取和解析任何接收到的數據，以您想要的方式顯示它，甚至在需要時採取相應的行動。

有快速啟動的腳本示例。只需複制並粘貼其中之一即可試用。

還有一個方便的 Modbus 控制接口供一般使用。

它支持主流 USB 串行驅動程序，包括：
FTDI 驅動程序
CDC ACM 驅動程序
CP210x 驅動程序
CH34x 驅動程序
PL2303驅動

腳本通用指南
==================

* 本應用中使用的 Python 版本為 3.8。

* 儘管可以在腳本字段中編輯腳本，但此應用程序並非設計為腳本編輯器。
最好的方法是使用您喜歡的腳本編輯器，然後復制並粘貼腳本。

* 始終使用 4 個空格作為縮進，以避免出現奇怪的錯誤。

* 標準 Python 庫中的大多數包都可以導入。

* 如果需要 while 循環，請始終使用 `app.running_script` 作為條件以正確停止腳本。

* 使用`app.version` 獲取應用程序版本字符串。

* 使用`app.get_output()` 以字符串形式獲取腳本輸出字段。

* 使用`app.set_output(object)` 在腳本輸出字段中將`object` 顯示為字符串。

* 使用`app.print_text(object)` 作為`app.set_output(app.get_output() + str(object))` 的快捷方式，將文本附加到腳本輸出字段。

* 使用`app.clear_text()` 作為`app.set_output("")` 的快捷方式來清除腳本輸出字段。

* 使用`app.fc01_read_coils(mbid, addr, num)`發送功能碼01請求。
mbid (int): Modbus ID
addr (int): 數據地址
num (int)：數據數量
返回（int 列表）：請求的數據列表

* 使用`app.fc02_read_discrete_inputs(mbid, addr, num)`發送功能碼02請求。
mbid (int): Modbus ID
addr (int): 數據地址
num (int)：數據數量
返回（int 列表）：請求的數據列表

* 使用`app.fc03_read_holding_registers(mbid, addr, num)`發送功能碼03請求。
mbid (int): Modbus ID
addr (int): 數據地址
num (int)：數據數量
返回（int 列表）：請求的數據列表

* 使用`app.fc04_read_input_registers(mbid, addr, num)`發送功能碼04請求。
mbid (int): Modbus ID
addr (int): 數據地址
num (int)：數據數量
返回（int 列表）：請求的數據列表

* 使用`app.fc05_write_single_coil(mbid, addr, val)`發送功能碼05請求。
mbid (int): Modbus ID
addr (int): 數據地址
val (int)：數據值
return (int)：數據數量（始終為 1）

* 使用`app.fc06_write_single_register(mbid, addr, val)`發送功能碼06請求。
mbid (int): Modbus ID
addr (int): 數據地址
val (int)：數據值
return (int)：數據數量（始終為 1）

* 使用`app.fc15_write_multiple_coils(mbid, addr, vals)`發送功能碼15請求。
mbid (int): Modbus ID
addr (int): 數據地址
vals（int 列表）：數據值列表
return (int): 數據數量

* 使用`app.fc16_write_multiple_registers(mbid, addr, vals)`發送功能碼16請求。
mbid (int): Modbus ID
addr (int): 數據地址
vals（int 列表）：數據值列表
return (int): 數據數量

* 使用`app.msg_out` 和`app.msg_in` 來檢查請求和響應消息。

* 使用`app.log_file(text)` 在存儲中保存日誌文件。
日誌文件位於 [Storage Directory]/PyToolModbus/log_[UTC Timestamp].txt。
text (str): 文本內容
return (str): 完整文件路徑

關於此應用程式

Version 0.3
Python version for the script is 3.8.
Now the script runs in Python global environment. Existing scripts should still work as before.
`app.version` is added for checking app version.