Heisig_GmbH/Uniper_Sphinx_Docu
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Modbus Schnittstellenbeschreibung eingefügt

Browse Source
This commit is contained in:
Matthias Heisig
2025-05-14 18:13:10 +02:00
parent 97c11ddaff
commit 8958fd8bf2
20 changed files with 482 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
source/modbus/tables/FW_Uebersicht_BMS.csv Normal file
View File

@@ -0,0 +1,6 @@
"Startadresse", "Größe (WORD)", "Name", "Typ", "Beschreibung"
13000,1,"BMSWarnings","WORD","Aktive BMS Warnungen"
13001,1,"BMSErrors","WORD","Aktive BMS Fehler"
13002,1,"StringWarnings","WORD","Liste der Strings mit aktiven Warnungen (Bit 0 -> String 1, Bit 1 -> String 2, etc.)"
13003,1,"StringErrors","WORD","Liste der Strings mit aktiven Fehlern (Bit 0 -> String 1, Bit 1 -> String 2, etc.)"
13004,1,"ConfirmAlarms","WORD","Durch schreiben einer 1 in diese Register werden die Alarme quittiert"
1 Startadresse Größe (WORD) Name Typ Beschreibung
2 13000 1 BMSWarnings WORD Aktive BMS Warnungen
3 13001 1 BMSErrors WORD Aktive BMS Fehler
4 13002 1 StringWarnings WORD Liste der Strings mit aktiven Warnungen (Bit 0 -> String 1, Bit 1 -> String 2, etc.)
5 13003 1 StringErrors WORD Liste der Strings mit aktiven Fehlern (Bit 0 -> String 1, Bit 1 -> String 2, etc.)
6 13004 1 ConfirmAlarms WORD Durch schreiben einer 1 in diese Register werden die Alarme quittiert

5
source/modbus/tables/Fehler_Uebersicht_Units.csv Normal file
View File

@@ -0,0 +1,5 @@
"Startadresse", "Größe (WORD)", "Name", "Typ", "Beschreibung"
15000,2,"Unit 1 active errors","DWORD","Bitmap mit den aktiven fehlern der Unit 1"
15002,2,"Unit 2 active errors","DWORD","Bitmap mit den aktiven fehlern der Unit 2"
"...",,,,
15046,2,"Unit 24 active errors","DWORD","Bitmap mit den aktiven fehlern der Unit 24"
1 Startadresse Größe (WORD) Name Typ Beschreibung
2 15000 2 Unit 1 active errors DWORD Bitmap mit den aktiven fehlern der Unit 1
3 15002 2 Unit 2 active errors DWORD Bitmap mit den aktiven fehlern der Unit 2
4 ...
5 15046 2 Unit 24 active errors DWORD Bitmap mit den aktiven fehlern der Unit 24

17
source/modbus/tables/Reg_13000_detail.csv Normal file
View File

@@ -0,0 +1,17 @@
"Bit", "Beschreibung"
0, "Nicht alle Komponeten im Automatikmodus"
1, "Safetyinterlock String 1 aktiv"
2, "Safetyinterlock String 2 aktiv"
3, ""
4, ""
5, ""
6, ""
7, ""
8, ""
9, ""
10, ""
11, ""
12, ""
13, ""
14, ""
15, ""
1 Bit Beschreibung
2 0 Nicht alle Komponeten im Automatikmodus
3 1 Safetyinterlock String 1 aktiv
4 2 Safetyinterlock String 2 aktiv
5 3
6 4
7 5
8 6
9 7
10 8
11 9
12 10
13 11
14 12
15 13
16 14
17 15

17
source/modbus/tables/Reg_13001_detail.csv Normal file
View File

@@ -0,0 +1,17 @@
"Bit", "Beschreibung"
0, "E-Stop nicht ok"
1, "EtherCAT Kommunikationsfehler"
2, "DC-Hauptschater String 1 nicht geschlossen"
3, "DC-Hauptschater String 2 nicht geschlossen"
4, "Allgemeiner Fehler"
5, ""
6, ""
7, ""
8, ""
9, ""
10, ""
11, ""
12, ""
13, ""
14, ""
15, ""
1 Bit Beschreibung
2 0 E-Stop nicht ok
3 1 EtherCAT Kommunikationsfehler
4 2 DC-Hauptschater String 1 nicht geschlossen
5 3 DC-Hauptschater String 2 nicht geschlossen
6 4 Allgemeiner Fehler
7 5
8 6
9 7
10 8
11 9
12 10
13 11
14 12
15 13
16 14
17 15

17
source/modbus/tables/Reg_14000_detail.csv Normal file
View File

@@ -0,0 +1,17 @@
"Bit", "Beschreibung"
0, "Temperatur Negolyt zu gering"
1, "Temperatur Negolyt zu hoch"
2, "Temperatur Posolyt zu gering"
3, "Temperatur Posolyt zu hoch"
4, "Druck Segmenteinlass Negolyt zu gering"
5, "Druck Segmenteinlass Negolyt zu hoch"
6, "Druck Segmenteinlass Posolyt zu gering"
7, "Druck Segmenteinlass Posolyt zu hoch"
8, "Druck Tanke Negolyt zu gering"
9, "Druck Tank Negolyt zu hoch"
10, "Druck Tank Posolyt zu gering"
11, "Druck Tank Posolyt zu hoch"
12, "Segmentspannung zu gering"
13, "Segmentspannung zu hoch"
14, ""
15, ""
1 Bit Beschreibung
2 0 Temperatur Negolyt zu gering
3 1 Temperatur Negolyt zu hoch
4 2 Temperatur Posolyt zu gering
5 3 Temperatur Posolyt zu hoch
6 4 Druck Segmenteinlass Negolyt zu gering
7 5 Druck Segmenteinlass Negolyt zu hoch
8 6 Druck Segmenteinlass Posolyt zu gering
9 7 Druck Segmenteinlass Posolyt zu hoch
10 8 Druck Tanke Negolyt zu gering
11 9 Druck Tank Negolyt zu hoch
12 10 Druck Tank Posolyt zu gering
13 11 Druck Tank Posolyt zu hoch
14 12 Segmentspannung zu gering
15 13 Segmentspannung zu hoch
16 14
17 15

33
source/modbus/tables/Reg_15000_detail.csv Normal file
View File

@@ -0,0 +1,33 @@
"Bit", "Beschreibung"
0, "Temperatur Negolyt zu gering"
1, "Temperatur Negolyt zu hoch"
2, "Fehler Temperatursensor Negolyt"
3, "Temperatur Posolyt zu gering"
4, "Temperatur Posolyt zu hoch"
5, "Fehler Temperatursensor Posolyt"
6, "Druck Segmenteinlass Negolyt zu gering"
7, "Druck Segmenteinlass Negolyt zu hoch"
8, "Fehler Drucksensor Segmenteinlass Negolyt"
9, "Druck Segmenteinlass Posolyt zu gering"
10, "Druck Segmenteinlass Posolyt zu hoch"
11, "Fehler Drucksensor Segmenteinlass Posolyt"
12, "Druck Tanke Negolyt zu gering"
13, "Druck Tank Negolyt zu hoch"
14, "Fehler Drucksensor Tank Negolyt"
15, "Druck Tank Posolyt zu gering"
16, "Druck Tank Posolyt zu hoch"
17, "Fehler Drucksensor Tank Posolyt"
18, "Segmentspannung zu gering"
19, "Segmentspannung zu hoch"
20, "Fehler Sensor Segmentspannung"
21, "Fehler Ventil Negolyt"
22, "Fehler Ventil Posolyt"
23, "Fehler Pumpe Negolyt"
24, "Fehler Pumpe Posolyt"
25, "Leckage an Unit"
26, "Software Safetyinterlocks aktiv"
27, ""
28, ""
29, ""
30, ""
31, ""
1 Bit Beschreibung
2 0 Temperatur Negolyt zu gering
3 1 Temperatur Negolyt zu hoch
4 2 Fehler Temperatursensor Negolyt
5 3 Temperatur Posolyt zu gering
6 4 Temperatur Posolyt zu hoch
7 5 Fehler Temperatursensor Posolyt
8 6 Druck Segmenteinlass Negolyt zu gering
9 7 Druck Segmenteinlass Negolyt zu hoch
10 8 Fehler Drucksensor Segmenteinlass Negolyt
11 9 Druck Segmenteinlass Posolyt zu gering
12 10 Druck Segmenteinlass Posolyt zu hoch
13 11 Fehler Drucksensor Segmenteinlass Posolyt
14 12 Druck Tanke Negolyt zu gering
15 13 Druck Tank Negolyt zu hoch
16 14 Fehler Drucksensor Tank Negolyt
17 15 Druck Tank Posolyt zu gering
18 16 Druck Tank Posolyt zu hoch
19 17 Fehler Drucksensor Tank Posolyt
20 18 Segmentspannung zu gering
21 19 Segmentspannung zu hoch
22 20 Fehler Sensor Segmentspannung
23 21 Fehler Ventil Negolyt
24 22 Fehler Ventil Posolyt
25 23 Fehler Pumpe Negolyt
26 24 Fehler Pumpe Posolyt
27 25 Leckage an Unit
28 26 Software Safetyinterlocks aktiv
29 27
30 28
31 29
32 30
33 31

5
source/modbus/tables/Warnungen_Uebersicht_Units.csv Normal file
View File

@@ -0,0 +1,5 @@
"Startadresse", "Größe (WORD)", "Name", "Typ", "Beschreibung"
14000,2,"Unit 1 active warnings","DWORD","Bitmap mit den aktiven warnungen der Unit 1"
14002,2,"Unit 2 active warnings","DWORD","Bitmap mit den aktiven warnungen der Unit 2"
"...",,,,
14046,2,"Unit 24 active warnings","DWORD","Bitmap mit den aktiven warnungen der Unit 24"
1 Startadresse Größe (WORD) Name Typ Beschreibung
2 14000 2 Unit 1 active warnings DWORD Bitmap mit den aktiven warnungen der Unit 1
3 14002 2 Unit 2 active warnings DWORD Bitmap mit den aktiven warnungen der Unit 2
4 ...
5 14046 2 Unit 24 active warnings DWORD Bitmap mit den aktiven warnungen der Unit 24

12
source/modbus/tables/datatypes.csv Normal file
View File

@@ -0,0 +1,12 @@
Name ,Größe (WORD),Beschreibung,Bereich
INT16 ,1,16-bit signed integer,-32.768...+32.767
UINT16 ,1,16-bit unsigned integer,0...65.535
INT32 ,2,32-bit signed integer,-2.147.483.648...+2.147.483.647
UINT32 ,2,32-bit unsigned integer,0...4.294.967.295
INT64 ,4,64-bit signed integer,-9.223.372.036.854.775.808...9.223.372.036.854.775.807
UINT64 ,4,64-bit unsigned integer,0 to 18.446.744.073.709.600.000
FLOAT32 ,2,"32-bit; Single precision float mit Vorzeichen bit, 8 bits Exponent,
23 bits Mantisse",-3.4028E+38...+3.4028E+38
ENUM16 ,1,Unsigned Integer 16; Decimalwert entspricht einem enum Wert ,
ASCII ,1...n ,"Eine Zeichenkette aus ASCII Zeichen, welche aus 1..n Register belegt; Byte order ist Big Endian; 2 ASCII Zeichen passen in 1 Register;",
BITMAP ,1...n ,"Ein zusammengesetztes bitfeld, welches 1..n Register Belegt, Gelesen von rechts nach links",
1 Name Größe (WORD) Beschreibung Bereich
2 INT16 1 16-bit signed integer -32.768...+32.767
3 UINT16 1 16-bit unsigned integer 0...65.535
4 INT32 2 32-bit signed integer -2.147.483.648...+2.147.483.647
5 UINT32 2 32-bit unsigned integer 0...4.294.967.295
6 INT64 4 64-bit signed integer -9.223.372.036.854.775.808...9.223.372.036.854.775.807
7 UINT64 4 64-bit unsigned integer 0 to 18.446.744.073.709.600.000
8 FLOAT32 2 32-bit; Single precision float mit Vorzeichen bit, 8 bits Exponent, 23 bits Mantisse -3.4028E+38...+3.4028E+38
9 ENUM16 1 Unsigned Integer 16; Decimalwert entspricht einem enum Wert
10 ASCII 1...n Eine Zeichenkette aus ASCII Zeichen, welche aus 1..n Register belegt; Byte order ist Big Endian; 2 ASCII Zeichen passen in 1 Register;
11 BITMAP 1...n Ein zusammengesetztes bitfeld, welches 1..n Register Belegt, Gelesen von rechts nach links

36
source/modbus/tables/interface.csv Normal file
View File

@@ -0,0 +1,36 @@
Start Adresse, Größe (WORD), Name, Typ, EMS Access, BMS Access, Einheit, Beschreibung, Kommentar
10000,16, Manufacturer, ASCII, R, RW, ,Batterie Hersteller Name, ""
10016,16, Modell Name, ASCII, R, RW, ,Batterie Modell, ""
10032,16, Serial Number, ASCII, R, RW, ,Batterie Seriennummer, ""
10048,32, BMS Version, ASCII, R, RW, , BMS Version, ""
10080,1, Total Parallel Members, UINT16, R, RW, ,"Anzahl aller parallel verschalteten Strings", ""
10081,1, Active Parallel Members, UINT16, R, RW, ,"Anzahl der aktuell aktiven parallel veschalteten Strings", ""
11000,1, Battery Status, ENUM16, R, RW, ,Batterie Status (Siehe 'Enum & Bitmap Values'), ""
11001,1, Charge Status, ENUM16, R, RW, , Lade Status (Possible values in the table 'Enum & Bitmap Values'), ""
11002,1, Self discharge rate, UINT16, R, RW, %, Selbstentladerate in Prozent der gesamtkapazität (WHRtg) pro Tag, "Nicht implementiert"
11003,1, Max allowed SoC, UINT16, R, RW, %, "Maximaler SoC in abhägigkeit der gerade verwendeten Ladeleistung", "Nicht implementiert"
11004,1, Min allowed SoC, UINT16, R, RW, %, "Minimaler SoC in abhägigkeit der gerade verwendeten Entladeleistung", "Nicht implementiert"
11005,1, Current SoC, UINT16, R, RW, %, "State of charge", "Nicht implementiert"
11006,1, Current DoD, UINT16, R, RW, %, "Depth of discharge", "Nicht implementiert"
11007,1, Current SoH, UINT16, R, RW, %, "Aktueller Gesundheitszustand der Batterie (100% = Neu)", "Nicht implementiert"
11008,2, Charge Capacity, UINT32, R, RW, Ah,"Ladekapazität in Amperestunden in abhängigkeit der aktuellen Ladeleistung",Nicht implementiert
11010,2, Energy Capacity, UINT32, R, RW, Wh,"Energiekapazität in Wattstunden in abhängigkeit der aktuellen Ladeleistung",Nicht implementiert
11012,2, Max Charging Active Power, UINT32, R, RW, W,"Maximale zulässige Ladeleistung", ""
11014,2, Max Discharging Active Power, UINT32, R, RW, W,"Maximal zulässige Entladeleistung", ""
11016,2, Max Available Inductive Reactive Power, UINT32, R, RW, var,"Maximal zulässige induktive Blindleistung", ""
11018,2, Max Available Capacitive Reactive Power, UINT32, R, RW, var,"Maximal zulässige kapazitive Blindleistung", ""
11020,2, Charged energy, UINT32, R, RW, Wh, "Geladene Energie", ""
11022,2, Available energy, UINT32, R, RW, Wh,"Maximal verfügbare Energie",Nicht implementiert
11024,2, Total AC Current Phase 1, INT32, R, RW, A, "AC Summenstrom aller Umrichter für Phase 1", ""
11026,2, Total AC Current Phase 2, INT32, R, RW, A, "AC Summenstrom aller Umrichter für Phase 2", ""
11028,2, Total AC Current Phase 3, INT32, R, RW, A, "AC Summenstrom aller Umrichter für Phase 3", ""
11030,2, Setpoint Active Power Mirror, INT32, R, RW, W, "Von 'Setpoint Active Power' empfangener, umkopierter Wert", ""
11032,2, Setpoint CosPhi Mirror,FLOAT32, R, RW, , "Von 'Setpoint CosPhi' empfangener, umkopierter Wert", ""
11034,2, Current Active Power, INT32, R, RW, W, "Aktuelle Wirkleistung der Gesamtbatterie. Ein positiver Wert bedeutet, dass die Batterie Entladen wird. Ein negativer, dass die Batterie geladen wird.", ""
11036,2, Current Reactive Power, INT32, R, RW, var,"Aktuelle Blindleistung der Gesamtbatterie. Ein positiver Wert steht für induktive und ein negativer für Kapazitive Blindleistung", ""
11038,2, Life Message, UINT32, R, RW, , "Lebenszeichen vom BMS. Wird jeden aktiven Kommunikationszyklus über die Modbus-Schnittstelle inkrementiert. Kann zur Erkennung von Kommunikationsausfällen genutzt werden.", ""
11040,4, Warning Bitmap, BITMAP, R, RW, ,"Bitmaske mit Warnung", "Obsolet"
11044,4, Error Bitmap, BITMAP, R, RW, ,"Bitmaske mit Fehlern", "Obsolet"
12000,2, Setpoint Active Power, INT32, RW, R, W, "Leistungsvorgabe des EMS an das BMS. Negative Leistungsvorgabe zum Laden der Batterie und positive zum Entladen", ""
12002,2, Setpoint CosPhi, FLOAT32, RW, R, , "Blindleistungsvorgabe des EMS an das BMS per CosPhi","Nicht implementiert, da keine Blidleistung erlaubt ist"
12004,1, Reactive Power Type, ENUM16, RW, R, ,"Gibt vor, welche Art von Blindleistung, 'Induktiv', 'Kapaziziv' oder 'Keine' vom BMS eingestellt werden soll","Nicht implementiert, da keine Blidleistung erlaubt ist"
1 Start Adresse Größe (WORD) Name Typ EMS Access BMS Access Einheit Beschreibung Kommentar
2 10000 16 Manufacturer ASCII R RW Batterie Hersteller Name
3 10016 16 Modell Name ASCII R RW Batterie Modell
4 10032 16 Serial Number ASCII R RW Batterie Seriennummer
5 10048 32 BMS Version ASCII R RW BMS Version
6 10080 1 Total Parallel Members UINT16 R RW Anzahl aller parallel verschalteten Strings
7 10081 1 Active Parallel Members UINT16 R RW Anzahl der aktuell aktiven parallel veschalteten Strings
8 11000 1 Battery Status ENUM16 R RW Batterie Status (Siehe 'Enum & Bitmap Values')
9 11001 1 Charge Status ENUM16 R RW Lade Status (Possible values in the table 'Enum & Bitmap Values')
10 11002 1 Self discharge rate UINT16 R RW % Selbstentladerate in Prozent der gesamtkapazität (WHRtg) pro Tag Nicht implementiert
11 11003 1 Max allowed SoC UINT16 R RW % Maximaler SoC in abhägigkeit der gerade verwendeten Ladeleistung Nicht implementiert
12 11004 1 Min allowed SoC UINT16 R RW % Minimaler SoC in abhägigkeit der gerade verwendeten Entladeleistung Nicht implementiert
13 11005 1 Current SoC UINT16 R RW % State of charge Nicht implementiert
14 11006 1 Current DoD UINT16 R RW % Depth of discharge Nicht implementiert
15 11007 1 Current SoH UINT16 R RW % Aktueller Gesundheitszustand der Batterie (100% = Neu) Nicht implementiert
16 11008 2 Charge Capacity UINT32 R RW Ah Ladekapazität in Amperestunden in abhängigkeit der aktuellen Ladeleistung Nicht implementiert
17 11010 2 Energy Capacity UINT32 R RW Wh Energiekapazität in Wattstunden in abhängigkeit der aktuellen Ladeleistung Nicht implementiert
18 11012 2 Max Charging Active Power UINT32 R RW W Maximale zulässige Ladeleistung
19 11014 2 Max Discharging Active Power UINT32 R RW W Maximal zulässige Entladeleistung
20 11016 2 Max Available Inductive Reactive Power UINT32 R RW var Maximal zulässige induktive Blindleistung
21 11018 2 Max Available Capacitive Reactive Power UINT32 R RW var Maximal zulässige kapazitive Blindleistung
22 11020 2 Charged energy UINT32 R RW Wh Geladene Energie
23 11022 2 Available energy UINT32 R RW Wh Maximal verfügbare Energie Nicht implementiert
24 11024 2 Total AC Current Phase 1 INT32 R RW A AC Summenstrom aller Umrichter für Phase 1
25 11026 2 Total AC Current Phase 2 INT32 R RW A AC Summenstrom aller Umrichter für Phase 2
26 11028 2 Total AC Current Phase 3 INT32 R RW A AC Summenstrom aller Umrichter für Phase 3
27 11030 2 Setpoint Active Power Mirror INT32 R RW W Von 'Setpoint Active Power' empfangener, umkopierter Wert
28 11032 2 Setpoint CosPhi Mirror FLOAT32 R RW Von 'Setpoint CosPhi' empfangener, umkopierter Wert
29 11034 2 Current Active Power INT32 R RW W Aktuelle Wirkleistung der Gesamtbatterie. Ein positiver Wert bedeutet, dass die Batterie Entladen wird. Ein negativer, dass die Batterie geladen wird.
30 11036 2 Current Reactive Power INT32 R RW var Aktuelle Blindleistung der Gesamtbatterie. Ein positiver Wert steht für induktive und ein negativer für Kapazitive Blindleistung
31 11038 2 Life Message UINT32 R RW Lebenszeichen vom BMS. Wird jeden aktiven Kommunikationszyklus über die Modbus-Schnittstelle inkrementiert. Kann zur Erkennung von Kommunikationsausfällen genutzt werden.
32 11040 4 Warning Bitmap BITMAP R RW Bitmaske mit Warnung Obsolet
33 11044 4 Error Bitmap BITMAP R RW Bitmaske mit Fehlern Obsolet
34 12000 2 Setpoint Active Power INT32 RW R W Leistungsvorgabe des EMS an das BMS. Negative Leistungsvorgabe zum Laden der Batterie und positive zum Entladen
35 12002 2 Setpoint CosPhi FLOAT32 RW R Blindleistungsvorgabe des EMS an das BMS per CosPhi Nicht implementiert, da keine Blidleistung erlaubt ist
36 12004 1 Reactive Power Type ENUM16 RW R Gibt vor, welche Art von Blindleistung, 'Induktiv', 'Kapaziziv' oder 'Keine' vom BMS eingestellt werden soll Nicht implementiert, da keine Blidleistung erlaubt ist