CMMS 協定配接器

CMMS 協定配接器用於把現場系統和設備訊號接入 FactVerse 維護工作流程。當 CMMS 或設施營運專案需要讀取 BACnet、Modbus 或 SNMP 設備點位，並把這些值用於資產脈絡、工單分診、預測性維護或證據審閱時，請使用本頁。

協定配接器應與現場自控負責人一起規劃。點位映射進入營運前，需要穩定的點位 ID、地址、資料型別、單位、唯讀設定和核准後的寫入策略。

前置條件

CMMS 營運或設施營運中已經有設備和位置記錄。
現場自控負責人已確認協定、設備地址範圍、網路路徑和讀取頻率。
每個映射點位都有穩定點位 ID、資料型別、單位和業務含義。
可寫點位單獨審閱，客戶營運策略批准前保持停用。
DFS 或 AI Agent 消費方已明確需要目前值、歷史時序，還是兩者都需要。

配接器工作流程

支援的協定類型

協定	典型用途	讀取行為	寫入行為
BACnet/IP	樓宇自控、空調箱、冰水主機、風機、水泵和控制器點位。	讀取已配置 BACnet 物件的 `present-value`，未配置點位時可進行設備發現。	僅對標記為可寫的映射點位寫入 `present-value`。
Modbus TCP	PLC、儀表、冰水主機、控制櫃和工業控制器。	讀取已配置線圈、離散輸入、輸入暫存器和保持暫存器。	透過配置的功能碼寫入可寫線圈和保持暫存器。
RTU-over-TCP	透過 TCP 承載 Modbus RTU 訊框的現場網路。	使用已配置 unit ID 和點位映射讀取。	透過 TCP 傳送帶 CRC 的 RTU 訊框。
SNMP	UPS、網路電力設備、環境監測設備和受管基礎設施。	對映射 OID 執行 GET，也可在配置根 OID 後執行發現 walk。	僅對已批准的可寫 OID 使用 SET。

BACnet 映射

BACnet 連線使用 BACnet/IP。連線可以設定逾時、本地 UDP 連接埠和可選 BBMD 外部設備註冊。配置了點位時，發現結果返回這些點位；未配置點位時，可以發送 Who-Is 並返回發現到的設備項目。

物件類型	範例
Analog	`analog-input`、`analog-output`、`analog-value`
Binary	`binary-input`、`binary-output`、`binary-value`
Multi-state	`multi-state-input`、`multi-state-output`、`multi-state-value`
Device	用於發現中繼資料的設備記錄

{
  "timeoutMs": 5000,
  "localPort": 0,
  "bbmdHost": "10.10.0.20",
  "bbmdPort": 47808,
  "foreignDeviceTtlSeconds": 300,
  "points": [
    {
      "pointId": "ahu-supply-temp",
      "address": "analog-input,0",
      "dataType": "FLOAT",
      "readOnly": true,
      "unit": "C"
    }
  ]
}

Modbus 映射

Modbus 連線使用明確點位映射。配接器讀取已配置點位，不掃描任意設備地址範圍。暫存器地址、unit ID、縮放和單位應由現場自控負責人確認。

點位類型	讀取支援	寫入支援
Coil	功能碼 01	功能碼 05
Discrete input	功能碼 02	唯讀
Holding register	功能碼 03	功能碼 06 或 16
Input register	功能碼 04	唯讀

{
  "transport": "tcp",
  "unitId": 1,
  "timeoutMs": 3000,
  "poolSize": 2,
  "points": [
    {
      "pointId": "chiller-discharge-pressure",
      "type": "holding-register",
      "register": 40001,
      "dataType": "INT",
      "scale": 0.1,
      "readOnly": false,
      "unit": "bar"
    }
  ]
}

32 位元浮點暫存器應把 dataType 設為 FLOAT，把 quantity 設為 2，並在設備要求時記錄 wordOrder 或 byteOrder。

SNMP 映射

SNMP 連線支援 v1、v2c 和 v3。客戶安全標準要求認證和加密存取時，應使用 v3。需要接收 trap 訊息的部署可以配置 trap 監聽連接埠。

{
  "version": "v3",
  "securityName": "operator",
  "authProtocol": "SHA",
  "authPassphrase": "auth-secret",
  "privacyProtocol": "AES128",
  "privacyPassphrase": "priv-secret",
  "timeoutMs": 3000,
  "retries": 1,
  "discoveryRootOid": "1.3.6.1.2.1.33",
  "trapListenPort": 0,
  "points": [
    {
      "pointId": "ups-battery-charge",
      "oid": "1.3.6.1.2.1.33.1.2.4.0",
      "dataType": "INT",
      "unit": "%",
      "readOnly": true,
      "syntax": "integer"
    }
  ]
}

SET 語法可使用 integer、gauge、counter、oid、ipAddress 和 octetString。

寫入治理

可寫協定點位需要明確營運決策。啟用寫入前，請確認：

點位適合透過 CMMS 或營運工作流程變更；
點位負責人已核准寫入邊界；
角色或服務帳號具備所需寫入 scope；
工作流程記錄請求人、目標點位、目標值、原因、時間和結果；
現場負責人清楚回復或人工修正方式；
現場團隊清楚哪個系統是該點位的權威來源。

唯讀部署仍可把協定值用於儀表板、工單分診、證據審閱和預測性維護輸入。

驗證檢查表

每個點位都有穩定的 pointId、來源地址、資料型別、單位和唯讀標記。
樣本讀取返回符合預期的值、單位和縮放。
發現結果符合已核准的設備或點位範圍。
可寫點位具備負責人核准和審閱工作流程。
讀取失敗、逾時和寫入拒絕對操作人員可見。
協定憑證和 community string 遵循客戶密鑰管理策略。
CMMS 工單和資產脈絡使用與 DFS、MDM 一致的設備身分。

前置條件​

配接器工作流程​

支援的協定類型​

BACnet 映射​

Modbus 映射​

SNMP 映射​

寫入治理​

驗證檢查表​

相關文件​