透過 Modbus 讀取及控制 cFos Charging Manager

除了 HTTP 和 MQTT 之外，cFos Charging Manager 還提供 Modbus API。這是以SunSpec為藍本。您可以在計費管理器設定中的「SunSpec 位址設定」下指定 TCP 連接埠或 COM 連接埠參數以及 Modbus ID。這會導致 cFos Charging Manager 聆聽指定參數下的 TCP 連接埠或 COM 連接埠，以及 Modbus ID 和 Modbus ID + 1。一般 Charging Manager 值、參數、旗標和變數可在 Modbus ID 下使用。可在 ID + 1 下查詢在充電管理器（wallboxes 和 meter）中設定的裝置。作為 Modbus 功能，您可以使用 3 和 4 讀取，6 和 16 寫入。注意： 在 Raspberry 上，1024 以下的 TCP 連接埠保留給具有管理權限的程式使用。因此，最好選擇較高的連接埠號，例如 1502。

SunSpec Modbus 規格指出，Modbus 位址範圍以識別碼「SunS」開始，接著包含所謂的 SunSpec 機型。每個型號在偏移量 0 有一個型號識別碼，在偏移量 1 則有屬於該型號的其餘暫存器的長度規格。 型號的數值則從偏移量 2 開始。重要事項：您應該掃瞄 SunSpec 位址範圍，並總是在偏移量 1 估計長度。請勿假設固定長度或固定的暫存器位址，因為我們很可能會隨著時間的推移，為模型增加更多的值。模型 1（共通）永遠排在第一位，包含製造商、版本號碼等詳細資訊。請從 SunSpec Alliance 下載 SunSpec Modbus 規格，以取得詳細資訊。cFos 充電管理器的 SunSpec 位址範圍從位址 40000 開始。

cFos 充電管理器最初會在 Common 型號之後的 Modbus ID 下顯示下列值為 Model 213 (三相電表，浮動)：
Grid consumption
Total consumers
Total producers
PV surplus
Utilised wallbox power
Available wallbox power
Fault power

接下來是 "custom" model 60000，帶有 cFos Charging Manager 的設定參數： 在型號和長度之後目前跟隨 8 個浮動值： Maximum total current, reserve, overdraw, maximum total wallbox current in mA per phase, maximum phase imbalance (in mA), load management active (1 = active, 0 = inactive), imbalance incl.負載管理（1 = 動態，0 = 非動態），最大總電流（百分比）。這些是全局充電管理器參數，也可以在使用者介面中設定。這些值的變更會儲存（最長延遲 150 秒）。例如，以百分比為單位的總電流可用於根據電網運營商的要求動態調整充電功率。

接下來是 「自訂 」型號 60001。32 個暫存器（16 位元）跟隨型號和長度。這些暫存器可包含值 0 和 1，並讀取或寫入多達 32 個充電管理員旗標。這些旗號的狀態可以用 CM._flag1 至 CM._flag32 的公式查詢，並用於計算。

接下來是 「自訂 」型號 60002，在型號和長度之後是可能的 Charging Manager 變數。每個變數有 22 個暫存器可用。前 20 個暫存器是變數名稱的 Modbus 字串（太長的名稱會被截短）。接下來的 2 個暫存器包含變數目前的浮動值。如果寫入 Charging Manager 變數的浮動值，則會刪除任何現有公式，並將變數設定為固定值。

在 Modbus ID + 1 下，在充電管理器中設定的電表和壁掛盒會顯示如下。牆壁盒交換為 SunSpec 型號 113，由 2 個 16 位元暫存器擴充。偏移量 62 包含壁掛盒的狀態 (1= 等待中、2= 已插入、3= 正在充電、4= 通風充電、5= 錯誤)，而偏移量 63 則包含裝置 ID。1 = E1、2 = E2 等。計數器顯示的型號 213 由 2 個 16 位元暫存器擴充。偏移量 126 包含電錶的角色 (0= 顯示、1= 消耗、2= 發電、3= 電網消耗、4= 電動車消耗、5= 儲存家庭、6= 儲存所有)，偏移量 127 包含裝置 ID (-1 代表 M1、-2 代表 M2 等)。如果計量表是儲存裝置 (角色 5 或 6)，型號 213 之後是型號 124，型號 124 由 16 位元暫存器擴充。 偏移量 26 再次包含裝置 ID。若要顯示 Modbus ID + 1 下的裝置，您必須在裝置設定中啟動「透過 Modbus 發佈裝置資訊」。

Aufstellung Start-Addressen der Modelle:
Modbus ID:
Model: 1, Addr: 40002
Model: 213, Addr: 40070, Netzbezugszähler
Model: 213, Addr: 40196, Summe Verbraucher
Model: 213, Addr: 40322, Sume Erzeuger
Model: 213, Addr: 40448, PV Überschuss
Model: 213, Addr: 40574, Genutzte Wallboxleistung
Model: 213, Addr: 40700, Verfügbare Wallboxleistung
Model: 213, Addr: 40826, Fehler-Leistung
Model: 60000, Addr: 40952
Model: 60001, Addr: 40970
Model: 60002, Addr: 41004
Die konkreten Start-Addressen können bei späteren Versionen des cFos Charging Managers variieren, daher sollte der Register-Bereich, wie oben beschrieben, gescannt werden.
Modbus ID + 1:
Modelle und Startadressen hängen von den eingeblendeten Geräten ab.

型號 213 的數值清單：
偏移 0：213
偏移 1：長度
偏移 2：總電流 L1-L3 (A)
偏移 4：電流 L1 (A)
偏移 6：電流 L2 (A)
偏移 8：電流 L3 (A)
偏移 10：電壓 (V)
偏移 12：
偏移 14：電壓 L2 (V)
偏移 16：電壓 L3 (V)
偏移 26：50 Hz
偏移 28：功率 (W)
偏移 30：功率 L1 (W)
偏移 32：功率 L2 (W)
偏移 34：功率 L3 (W)
偏移 36：偏移 36： 顯現功率 (VA)
偏移 38： 顯現功率 L1 (VA)
偏移 40： 顯現功率 L2 (VA)
偏移 42： 顯現功率 L3 (VA)
偏移 44： 無功功率 (VAr)
偏移 60： 出口，有功功率 (Wh)
偏移 68：輸入，有功功率 (Wh)
偏移量 126：角色 (對於 Modbus ID + 1)
偏移量 127：裝置 ID (對於 Modbus ID + 1)

型號 113 的值清單：
偏移量 0：113
偏移量 1：長度
偏移量 2：總電流 L1-L3 (A)
偏移量 4：偏移 6：電流 L1 (A)
偏移 6：電流 L2 (A)
偏移 8：電流 L3 (A)
偏移 16：電壓 L1 (V)
偏移 18：電壓 L2 (V)
偏移 20：電壓 L3 (V)
偏移 22：功率 (W)
偏移 24：50 Hz
偏移 26：顯現功率 (VA)
偏移 32： 輸入、有功功率 (Wh)
偏移 62： 狀態（適用於 Modbus ID + 1）
偏移 63： 設備 ID（適用於 Modbus ID + 1）

型號 124 的值清單：
偏移 0：124
偏移 1：長度
偏移 2：最大充電/放電功率 (W)
偏移 3：電流充電功率限制百分比
偏移 4：電流放電功率限制百分比
偏移 8：充電狀態（百分比）
偏移 18：偏移 2 的比例因子
偏移 19：偏移量 3 和 4 的比例因子
偏移量 26：裝置 ID (用於 Modbus ID + 1)

型號 60000 的值清單：
所有值均為浮動值，讀/寫存取會導致快閃記憶體更新，即不要經常變更以避免損壞。即不要經常變更以避免損壞。
偏移 0: 60000 (unt16, 只讀)
偏移 1: Length (uint16, 只讀)
偏移 2: Max.總電流 (mA)
偏移 4: Power Reserve (mA)
偏移 6: Overdraw (mA)
偏移 8: Max Wallbox Total Current (mA)
偏移 10: Max.相位不平衡 (mA)
偏移 12: 1 = 啟動負載管理，0 = 未啟動
偏移 14: 1 = 將家庭消耗加入不平衡，0 = 未啟動
偏移 16: 最大總電流百分比，未儲存，可經常改變。

型號 60001 的值清單：
所有值為 0 或 1，int16，讀/寫存取，不儲存，可經常變更。
偏移量 0: 60001 (uint16, 只讀)
偏移量 1: Length (uint16, 只讀)
偏移量 2: CM._flag1
..
.偏移量 33: CM._flag32

型號 60002 的值清單：
所有值為浮動值，讀/寫存取，不儲存，可經常變更。偏移量 0: 60002 (uint16, 只讀)
偏移量 1: Length (uint16, 只讀)
偏移量 2...22: 名充電管理員變數值 1
偏移量 23...24: 值充電管理員變數值 1
偏移量 25...45: 名充電管理員變數值 2
偏移量 46...47: 值充電管理員變數值 2
...