Modbus Schnittstellenbeschreibung eingefügt

2025-05-14 18:13:10 +02:00
parent 97c11ddaff
commit 8958fd8bf2
20 changed files with 482 additions and 0 deletions
--- a/source/modbus/EMS_Schnittstelle.rst
+++ b/source/modbus/EMS_Schnittstelle.rst
@@ -0,0 +1,115 @@
+#################
+EMS-Schnittstelle
+#################
+Allgemeine Informationen zu der Schnittstelle zwischen BMS und EMS:
+
+* Das Interface wir düber Modbus-TCP/IP abgebildet
+* Das EMS wird vom Kunden zur Verfügung gestellt
+* Das BMS wird von der CMBlu Energy AG bereitgestellt
+* Alle Register können über die Modbus-Funktion 0x03 "Read Holding Register" gelesen und die Funktion 0x06 "Write Single Register" oder 0x10 "Write Multiple Registers" geschrieben werden.
+  Dabei ist auf die in den Tabellen angegebene Lese und Schreibberechtigung zu achten.
+* Alle Strings sind im ASCII-Format
+* Alle Register haben die byte order: Big Endian
+* Die Pollrate des EMS sollte nicht kleiner sein als 200 ms
+* Der Adressbereicht ist: 10.000...16.000
+
+
+**********
+Datentypen
+**********
+.. csv-table:: Datentypen
+    :file: tables/datatypes.csv
+    :header-rows: 1
+
+
+********************
+Interface Definition
+********************
+.. csv-table:: Modbus Register
+    :file: tables/interface.csv
+    :header-rows: 1
+
+
+********************
+Enum Werte
+********************
+
+.. list-table:: Battery status
+    :header-rows: 0
+
+    * - ERROR
+      - 1
+    * - OFF
+      - 2
+    * - READY
+      - 3
+    * - ACTIVE
+      - 4
+    * - MAINTENANCE
+      - 5
+    * - TESTING
+      - 6
+
+.. list-table:: Charge status
+    :header-rows: 0
+
+    * - UNDEFINED
+      - 1
+    * - EMPTY
+      - 2
+    * - CHARGING
+      - 3
+    * - DISCHARGING
+      - 4
+    * - FULL
+      - 5
+
+.. list-table:: Reactive Power Type
+    :header-rows: 0
+
+    * - INDUCTIVE
+      - 1
+    * - CAPACITIVE
+      - 2
+    * - NONE
+      - 3
+
+
+*********************************
+Fehlermeldungen Registerübersicht
+*********************************
+.. csv-table:: Übersicht Fehler und Warnungen BMS
+    :file: tables/FW_Uebersicht_BMS.csv
+    :header-rows: 1
+
+.. csv-table:: Übersicht Warnungen Units
+    :file: tables/Warnungen_Uebersicht_Units.csv
+    :header-rows: 1
+
+.. csv-table:: Übersicht Fehler Units
+    :file: tables/Fehler_Uebersicht_Units.csv
+    :header-rows: 1
+
+
+*********************************************
+Registerbeschreibung Fehler und Warnungen BMS
+*********************************************
+.. csv-table:: Aktive BMS Warnungen - Register 13.000
+  :file: tables/Reg_13000_detail.csv
+  :header-rows: 1
+
+.. csv-table:: Aktive BMS Fehler - Register 13.001
+  :file: tables/Reg_13001_detail.csv
+  :header-rows: 1
+
+
+***********************************************
+Registerbeschreibung Fehler und Warnungen Units
+***********************************************
+.. csv-table:: Aktive Unit Warnungen - Register 14.000 - 14.046
+  :file: tables/Reg_14000_detail.csv
+  :header-rows: 1
+
+.. csv-table:: Aktive Unit Fehler - Register 15.000 - 15.046
+  :file: tables/Reg_15000_detail.csv
+  :header-rows: 1