Modbus、MQTT 與 API 設備串接，如何整合既有系統？
說明 Modbus、MQTT 與 API 在設備串接中的分工，以及點位、單位、時間、斷線與重複資料的處理，讓既有設備資料能用於監測、告警與報表。
電表、感測器與既有管理系統各有自己的介面。要把它們放進同一個監測畫面，除了取得讀值，還需要知道資料來自哪台設備、代表什麼、何時量測，以及現在是否仍可使用。這些資訊會直接影響告警判斷、能源報表與後續維修。
Modbus、MQTT 與 API 可以一起出現在同一套系統裡。例如，Gateway 透過 Modbus 讀取電表，再以 MQTT 傳送到平台；平台透過 API 把事件交給既有管理系統。整合時，每一段的資料定義與失敗處理都需要接得起來。
三種介面各自負責什麼
| 介面 | 常見用途 | 串接時的重點 |
|---|---|---|
| Modbus | 讀取設備點位，或執行設備支援的寫入 | 點位表、位址、資料格式與讀取頻率 |
| MQTT | 將設備或 Gateway 的訊息分送給訂閱端 | Topic、訊息內容、交付設定與資料時間 |
| API | 與既有軟體交換狀態、事件、台帳或工單 | 認證、欄位定義、用量限制與重試方式 |
Modbus 接入設備點位
Modbus 以功能碼與位址指定讀寫內容。Modbus RTU 與 Modbus TCP 的連線設定不同，點位含義仍需查設備廠商的對應表。Modbus Organization 的協定說明介紹了請求、回應與暫存器映射的基本關係。
接入一個點位時，記錄設備型號、文件版本、功能碼、位址及資料格式。確認文件中的編號與驅動程式要求的位址是否有偏移，跨暫存器數值也要核對字序、倍率與單位。用設備面板或已知讀值比對結果，再把同一組設定套用到其他設備。設定選項可參照Schneider Electric 的 Modbus 暫存器文件，各型號的實際映射仍由廠商文件決定。
MQTT 分送設備訊息
MQTT 使用發布與訂閱模式，發布端將訊息送到 Topic，由 Broker 分送給訂閱端。QoS 1 可能重複交付；保留訊息（retained message）可供新訂閱端接收，因此接收時間可能晚於原始資料時間。這些行為見於 OASIS MQTT 5.0 規範。
串接時，把設備編號、量測時間、單位與訊息識別碼放進約定的資料格式，並設定哪些帳號能發布或訂閱哪些 Topic。應用程式依識別碼或約定的唯一欄位處理重複資料。顯示保留訊息時，檢查原始時間與允許的資料年齡，將過期狀態標示清楚。
API 連接既有軟體
API 是系統提供給其他程式使用的介面。以常見的 HTTP API 為例，整合端需確認認證方式、讀寫權限、欄位、分頁、用量限制與版本。設備編號在兩套系統中若不同，要留下對應關係，才能把事件接到正確的資產或工單。
建立工單或送出指令時，重試方式尤其重要。HTTP Semantics 的冪等性說明指出，非冪等請求自動重試需要額外條件。若 API 提供冪等鍵，可依文件使用；連線中斷後，也可查詢請求處理狀態，確認是否已建立紀錄，再決定後續動作。
讓不同來源的資料有共同定義
同一台設備在 Gateway、平台與工單系統中應有可追溯的識別碼。每個量測點至少記錄來源、欄位名稱、數值、單位、量測時間、接收時間與品質狀態。保留原始資料，並記錄轉換規則，才查得到報表中的數值如何產生。
功率的 W 與 kW 需要換算，功率與累積用電量則是不同欄位。時間要約定時區與格式；缺少設備時間時，明確標示使用接收時間。告警和報表依這些定義讀取資料，避免把不同量測期間或不同意義的數值放在一起比較。
斷線、補送與重複資料要能辨認
設備停止更新時，畫面保留最後有效值及其時間，並顯示資料過期或通訊異常。超時、讀取失敗與有效的零值分開記錄，告警規則才能選擇適合的處置。更新頻率與過期門檻依設備能力、網路及管理需求設定。
有離線緩存的設備或 Gateway，要確認保存容量、補送順序與保存期限。恢復連線後，用原始量測時間處理補送資料，並測試重複與順序顛倒的情況。需累計事件或建立工單的功能，應能辨認同一筆資料已處理過，避免重複計算或建立紀錄。
讀取資料與設備控制分別配置
初步串接可先採唯讀方式，確認點位、時間與品質狀態。需要控制設備時，再配置可寫入的點位、操作權限、安全規則與核可流程，並測試失敗處理及設備回報狀態。指令送出後，系統應有能確認執行結果的方式。
網路存取、加密及認證依設備和服務實際支援的方式配置；限制可連線的端點及帳號權限。串接文件也要留下憑證到期、介面變更與設備替換時的維護責任，讓日常管理有人接手。
用一條完整資料路徑開始
選一組具代表性的設備，從原始讀值走到管理畫面、告警或報表。正常讀取之外，一起測試斷線、資料過期、重複補送與介面錯誤。若功能會接上維修工單，可以搭配巡檢數位化的作業整理，確認事件交給誰、如何追蹤及結案。
lvsota 的設備與資料整合服務串接多廠牌設備、Modbus、MQTT 與 API，支援能源、儲能管理及現場作業。準備設備清單、介面文件、資料範例與預期使用的監測或報表畫面，即可洽談串接需求。
進一步了解 設備與資料整合