API / SDK / developer guide
ModbusTcpClient
| 目標讀者 TA | 輪詢開發者 |
|---|---|
| 官方文件能力 | 同步 TCP 用戶端。 |
| 輸入 → 輸出 | 請求 → Modbus 回應。 |
| 執行環境 | 固定3.15；TCP 裝置。 |
| 本站選型評估 | 呼叫需序列化。 |
| 本站建議驗證 | 建議門檻：驗證裝置映射與清理。 |
工業 IoT／SCADA · SDK / protocol
PyModbus
PyModbus Project
使用 Python 客戶端、伺服器與模擬器進行 Modbus 通訊。
PYMODBUS / DEVELOPER FIELD GUIDE
選對接口，定義可驗證的結果。
公司／專案背景、十個技術入口，以及每份引用的實作分析。
2026-10-08 · 串接尚未實測
公司／專案背景全貌
依官方公司或專案自述撰寫的原創概要；完整原文請見來源。
| 專案 | PyModbus 是 Python Modbus 實作，包含用戶端、伺服器與模擬器功能。 |
|---|---|
| 版本邊界 | 目錄 latest 網址目前顯示未發布4.0開發文件。本選集採穩定3.15文件，需固定版本。 |
| 適用角色 | 進行 AI 供應商初選的採購、合作夥伴與產品負責人。 |
|---|---|
| 本站評估 | 用定位與公司背景判斷初步適配度；另行取得專案部署、支援與商務條件。 |
已核對官方來源。未呼叫供應商 API 或執行推論；結果為內部契約示意。
十項技術入口比較
依實作決策選出的十個技術文件入口，非十套獨立 SDK 或官方排名。
| 接口 | 用途與 TA |
|---|---|
| 01 · ModbusTcpClientAPI / SDK / developer guide | 同步 TCP 用戶端。輪詢開發者 |
| 02 · AsyncModbusTcpClientAPI / SDK / developer guide | 可 await 的 TCP 操作。非同步整合者 |
| 03 · ModbusSerialClientAPI / SDK / developer guide | 序列埠 Modbus 用戶端。序列整合者 |
| 04 · read_holding_registersAPI / SDK / developer guide | 讀取保持暫存器。暫存器映射整合者 |
| 05 · convert_from_registersAPI / SDK / developer guide | 將暫存器轉為型別化數值。遙測解碼者 |
| 06 · Server APIAPI / SDK / developer guide | 提供設定的 Modbus 資料環境。模擬器開發者 |
| 07 · Simulator entrypointAPI / SDK / developer guide | 設定虛擬 Modbus 行為。整合品保 |
| 08 · Simulator data modelAPI / SDK / developer guide | 定義虛擬裝置資料與暫存器配置。測試資料作者 |
| 09 · ExceptionResponseAPI / SDK / developer guide | 表示 Modbus 例外 PDU。錯誤處理開發者 |
| 10 · API changesAPI / SDK / developer guide | 審查破壞性簽章與資料模型變更。程式庫維護者 |
逐份文件分析
能力摘要依據官方文件；限制與建議測試為本站工程評估。
API / SDK / developer guide
AsyncModbusTcpClient
| 目標讀者 TA | 非同步整合者 |
|---|---|
| 官方文件能力 | 可 await 的 TCP 操作。 |
| 輸入 → 輸出 | await 請求 → 回應。 |
| 執行環境 | 所屬事件迴圈。 |
| 本站選型評估 | 並行呼叫需應用控制。 |
| 本站建議驗證 | 建議門檻：驗證取消與重連政策。 |
API / SDK / developer guide
ModbusSerialClient
| 目標讀者 TA | 序列整合者 |
|---|---|
| 官方文件能力 | 序列埠 Modbus 用戶端。 |
| 輸入 → 輸出 | 序列請求 → 回應。 |
| 執行環境 | serial 額外套件；符合序列埠設定。 |
| 本站選型評估 | 錯誤訊框妨礙有效通訊。 |
| 本站建議驗證 | 建議門檻：向裝置擁有者確認接線與設定。 |
API / SDK / developer guide
read_holding_registers
| 目標讀者 TA | 暫存器映射整合者 |
|---|---|
| 官方文件能力 | 讀取保持暫存器。 |
| 輸入 → 輸出 | 位址／數量／device_id → 暫存器。 |
| 執行環境 | 正確目標／暫存器映射。 |
| 本站選型評估 | 位址編號可能與手冊不同。 |
| 本站建議驗證 | 建議門檻：解碼前確認數量。 |
API / SDK / developer guide
convert_from_registers
| 目標讀者 TA | 遙測解碼者 |
|---|---|
| 官方文件能力 | 將暫存器轉為型別化數值。 |
| 輸入 → 輸出 | 暫存器／型別／字組順序 → 值。 |
| 執行環境 | 裝置專屬編碼。 |
| 本站選型評估 | 字組順序影響結果。 |
| 本站建議驗證 | 建議門檻：比較已知原始位元與工程單位。 |
API / SDK / developer guide
Server API
| 目標讀者 TA | 模擬器開發者 |
|---|---|
| 官方文件能力 | 提供設定的 Modbus 資料環境。 |
| 輸入 → 輸出 | 用戶端請求 → 由資料環境產生伺服器回應。 |
| 執行環境 | 3.x 伺服器 API 與選定傳輸。 |
| 本站選型評估 | 舊資料儲存方式預定於4.0替換。 |
| 本站建議驗證 | 採隔離測試綁定位址並驗證啟停生命週期。 |
API / SDK / developer guide
Simulator entrypoint
| 目標讀者 TA | 整合品保 |
|---|---|
| 官方文件能力 | 設定虛擬 Modbus 行為。 |
| 輸入 → 輸出 | 模擬設定 → 模擬請求／回應。 |
| 執行環境 | 模擬器相依與明確裝置設定。 |
| 本站選型評估 | 模擬無法證明實體裝置相容。 |
| 本站建議驗證 | 規劃有效、非法位址與逾時情境，不使用實際設備。 |
API / SDK / developer guide
Simulator data model
| 目標讀者 TA | 測試資料作者 |
|---|---|
| 官方文件能力 | 定義虛擬裝置資料與暫存器配置。 |
| 輸入 → 輸出 | 資料模型定義 → 模擬暫存器狀態。 |
| 執行環境 | 相符 SimData／SimDevice API 版本。 |
| 本站選型評估 | 測試資料設計須符合預定裝置語意。 |
| 本站建議驗證 | 記錄有效範圍及無效位址邊界。 |
API / SDK / developer guide
ExceptionResponse
| 目標讀者 TA | 錯誤處理開發者 |
|---|---|
| 官方文件能力 | 表示 Modbus 例外 PDU。 |
| 輸入 → 輸出 | 功能與例外碼 → 協定錯誤回應。 |
| 執行環境 | 版本相符回應型別。 |
| 本站選型評估 | 協定例外不同於有效量測。 |
| 本站建議驗證 | 保留代碼，並在應用錯誤中區分連線失敗。 |
API / SDK / developer guide
API changes
| 目標讀者 TA | 程式庫維護者 |
|---|---|
| 官方文件能力 | 審查破壞性簽章與資料模型變更。 |
| 輸入 → 輸出 | 安裝／目標版本 → 遷移動作。 |
| 執行環境 | 固定版本與相符範例。 |
| 本站選型評估 | 3.10 替換 slave 關鍵字並移除 payload 輔助工具。 |
| 本站建議驗證 | 審查每次次版本更新；不可假設語意版本相容。 |
Official documentation
| TA | 工程師與技術產品負責人 |
|---|---|
| 本站驗證建議 | 實作前固定版本並依目標環境核對支援條件。 |
04 / INPUT · EXPECTED OUTPUT · ACCEPTANCE
實作前先看懂預期結果
暫存器讀取契約示意；未執行 Modbus 連線、模擬器、輪詢或寫入。
示意契約 · 未呼叫 API 或執行模型 · 不是供應商實測輸出
暫存器解碼
| 輸入 | 虛構暫存器235，採明確虛構比例0.1。 |
|---|---|
| 預期結果 | 僅在該應用映射下為23.5C。 |
| 驗收條件 | 真實驗收需要製造商暫存器映射、型別、順序與單位。 |
無輪詢目標
| 輸入 | 應用設定沒有啟用目標。 |
|---|---|
| 預期結果 | skipped；未送出協定請求。 |
| 驗收條件 | 不可送 count=0 模擬空資料庫查詢。 |
協定例外
| 輸入 | 裝置拒絕要求的暫存器範圍。 |
|---|---|
| 預期結果 | 含代碼的協定錯誤；無解碼值。 |
| 驗收條件 | 不可將例外內容轉成感測讀值。 |
無回應
| 輸入 | 裝置未於設定政策內回應。 |
|---|---|
| 預期結果 | 通訊失敗；無新值。 |
| 驗收條件 | 獨立保留最後已知時間戳並限制重試。 |
將預期結果對應至你的應用
將實際執行環境回應對應至此建議應用契約。所有數值皆為示意，不含憑證或真實執行。
預期輸出 JSON — 示意，非實測 · PyModbus-expected-results.json
{
"schema_version": "1.0.0",
"example": true,
"provider": "PyModbus",
"status": "ok",
"input_id": "sample-001",
"data": {
"device_id": 1,
"address": 0,
"registers": [
235
],
"decode_rule": "demo unsigned integer /10",
"temperature_c": 23.5,
"physical_validation": false
},
"error": null,
"verification": "illustrative-only;not-provider-response"
}| 狀態語意 | 有效空結果與錯誤不同；等待中的工作不可提前顯示成功。 |
|---|---|
| 證據 | 記錄服務與 SDK 版本、請求識別、設定及回應映射。此處未執行或量測效能。 |
| 建議驗收 | 以授權代表樣本測試前，先約定數值誤差與負載目標。 |
開發評估
唯讀暫存器監視器
開發構想規格・串接尚未實測
接口能力依據官方文件或程式庫；以下產品方向、輸入、交付與驗收條件則是我們的開發評估。
需整合驗證
估算可交付產品前，需共同驗證執行環境、資料結構或硬體。
- 原型輸入規劃
- 測試設備或模擬器、訊號對照表與明確單位。
- 原型交付規劃
- 附時間、資料新鮮度、單位與連線狀態的設備數值。
- 驗收條件
- 對照來源驗證比例與時間；設備斷線時不得顯示正常。
- 依賴條件
- 閘道或服務帳號、設備資料結構與測試環境。
開發順序
- 確認 PyModbus 的存取、授權與支援版本。
- 準備上述樣本，針對「唯讀暫存器監視器」先實作一個有官方文件的操作。
- 整理輸出時保留來源、時間與錯誤狀態，並保留供應商回應供審核。
- 通過驗收條件後，再估算擴展投入與客戶交付。
如何驗證需求
記錄產品瀏覽、官方文件點擊、規格下載與技術 Hub 點擊。這些是事件次數，不等於獨立人數或已完成串接。
本次可行性評估依實作條件判斷；尚未給定流量排名或交期承諾。