From 4e98dc0c0fd24b100cabe7d5189c80d24f5c2f8d Mon Sep 17 00:00:00 2001 From: DS_Starter Date: Tue, 19 Mar 2024 20:55:49 +0000 Subject: [PATCH] 70_PylonLowVoltage: edit commandref git-svn-id: https://svn.fhem.de/fhem/trunk@28685 2b470e98-0d58-463d-a4d8-8e2adae1ed80 --- fhem/CHANGED | 1 + fhem/FHEM/70_PylonLowVoltage.pm | 493 ++++++++++++++++++-------------- 2 files changed, 280 insertions(+), 214 deletions(-) diff --git a/fhem/CHANGED b/fhem/CHANGED index 63ee57cae..5ddacab19 100644 --- a/fhem/CHANGED +++ b/fhem/CHANGED @@ -1,5 +1,6 @@ # Add changes at the top of the list. Keep it in ASCII, and 80-char wide. # Do not insert empty lines here, update check depends on it. + - change: 70_PylonLowVoltage: edit commandref - feature: 93_DbLog: support of MariaDB driver and more, see Forum:#137480 - feature: 93_DbRep: sqlCmdBlocking can use sql Keywords §timestamp_end§ etc. - change: 93_DbRep: prevent some attr eval as long as init_done is not set diff --git a/fhem/FHEM/70_PylonLowVoltage.pm b/fhem/FHEM/70_PylonLowVoltage.pm index 009969dc4..36776bae3 100644 --- a/fhem/FHEM/70_PylonLowVoltage.pm +++ b/fhem/FHEM/70_PylonLowVoltage.pm @@ -122,6 +122,7 @@ BEGIN { # Versions History intern (Versions history by Heiko Maaz) my %vNotesIntern = ( + "0.2.3" => "19.03.2024 edit commandref ", "0.2.2" => "20.02.2024 correct commandref ", "0.2.1" => "18.02.2024 doOnError: print out faulty response, Forum:https://forum.fhem.de/index.php?msg=1303912 ", "0.2.0" => "15.12.2023 extend possible number of batteries up to 14 ", @@ -1504,41 +1505,41 @@ return; =begin html - -

PylonLowVoltage

-
-Module for integration of low voltage batteries with battery management system (BMS) of the manufacturer Pylontech via -RS485/Ethernet gateway. Communication to the RS485 gateway takes place exclusively via an Ethernet connection.
-The module has been successfully used so far with Pylontech batteries of the following types:
+ +

PylonLowVoltage

+
+ Module for integration of low voltage batteries with battery management system (BMS) of the manufacturer Pylontech via + RS485/Ethernet gateway. Communication to the RS485 gateway takes place exclusively via an Ethernet connection.
+ The module has been successfully used so far with Pylontech batteries of the following types:
- + -The following devices have been successfully used as RS485 Ethernet gateways to date:
- + The following devices have been successfully used as RS485 Ethernet gateways to date:
+ -In principle, any other RS485/Ethernet gateway should also be compatible. -

+ In principle, any other RS485/Ethernet gateway should also be compatible. +

-Requirements -

-This module requires the Perl modules: - -The data format must be set on the RS485 gateway as follows: -
+ The data format must be set on the RS485 gateway as follows: +

+ + Example configuration of a Waveshare RS485 to Ethernet converter +

+ The converter's web interface offers several pages with settings. The relevant settings are shown below + as an example. The assignment of a fixed IP address is assumed in advance. +
-Limitations -
-The module currently supports a maximum of 14 batteries (master + 13 slaves) in one group. -

+ +
- -Definition - -Mode of operation - + Mode of operation + - -Get -
- - -Attributes - - - -Readings - +

=end html =begin html_DE - -

PylonLowVoltage

-
-Modul zur Einbindung von Niedervolt-Batterien mit Batteriemanagmentsystem (BMS) des Herstellers Pylontech über RS485 via -RS485/Ethernet-Gateway. Die Kommunikation zum RS485-Gateway erfolgt ausschließlich über eine Ethernet-Verbindung.
-Das Modul wurde bisher erfolgreich mit Pylontech Batterien folgender Typen eingesetzt:
+ +

PylonLowVoltage

+
+ Modul zur Einbindung von Niedervolt-Batterien mit Batteriemanagmentsystem (BMS) des Herstellers Pylontech über RS485 via + RS485/Ethernet-Gateway. Die Kommunikation zum RS485-Gateway erfolgt ausschließlich über eine Ethernet-Verbindung.
+ Das Modul wurde bisher erfolgreich mit Pylontech Batterien folgender Typen eingesetzt:
- + -Als RS485-Ethernet-Gateways wurden bisher folgende Geräte erfolgreich eingesetzt:
- + Als RS485-Ethernet-Gateways wurden bisher folgende Geräte erfolgreich eingesetzt:
+ -Prinzipiell sollte auch jedes andere RS485/Ethernet-Gateway kompatibel sein. -

+ Prinzipiell sollte auch jedes andere RS485/Ethernet-Gateway kompatibel sein. +

-Voraussetzungen -

-Dieses Modul benötigt die Perl-Module: - -Das Datenformat muß auf dem RS485 Gateway wie folgt eingestellt werden: -
+ Das Datenformat muß auf dem RS485 Gateway wie folgt eingestellt werden: +

+ + Beispielkonfiguration eines Waveshare RS485 to Ethernet Converters +

+ Das Webinterface des Konverters bietet mehrere Seiten mit Einstellungen an. Die relevanten Einstellungen sind nachfolgend + beispielhaft gezeigt. Die Zuweisung einer festen IP-Adresse wird vorab vorausgesetzt. +
-Einschränkungen -
-Das Modul unterstützt zur Zeit maximal 14 Batterien (Master + 13 Slaves) in einer Gruppe. -

+ +
- -Definition - -Arbeitsweise - + Arbeitsweise + - -Get -
- - -Attribute - -
    + + Attribute + +
    • disable 0|1
      Aktiviert/deaktiviert die Gerätedefinition. @@ -1823,66 +1888,66 @@ Batteriemanagementsystem über die RS485-Schnittstelle zur Verfügung stellt. Der automatisch ermittelte Batterietyp (Reading batteryType) wird durch die angegebene Zeichenfolge ersetzt.

      • -
    +
- -Readings -
    -
  • averageCellVolt
    mittlere Zellenspannung (V)
    • -
  • bmsTemperature
    Temperatur (°C) des Batteriemanagementsystems
    • -
  • cellTemperature_0104
    Temperatur (°C) der Zellenpacks 1 bis 4
    • -
  • cellTemperature_0508
    Temperatur (°C) der Zellenpacks 5 bis 8
    • -
  • cellTemperature_0912
    Temperatur (°C) der Zellenpacks 9 bis 12
    • -
  • cellTemperature_1315
    Temperatur (°C) der Zellenpacks 13 bis 15
    • -
  • cellVoltage_XX
    Zellenspannung (V) des Zellenpacks XX. In dem Batteriemodul sind "packCellcount" - Zellenpacks in Serie geschaltet verbaut. Jedes Zellenpack besteht aus parallel - geschalten Einzelzellen.
    • -
  • chargeCurrentLimit
    aktueller Grenzwert für den Ladestrom (A)
    • -
  • chargeEnable
    aktuelles Flag Laden erlaubt
    • -
  • chargeFullRequest
    aktuelles Flag Batteriemodul voll laden (notfalls aus dem Netz)
    • -
  • chargeImmediatelySOCXX
    aktuelles Flag Batteriemodul sofort laden - (05: SOC Grenze 5-9%, 09: SOC Grenze 9-13%)
    • -
  • chargeVoltageLimit
    aktuelle Ladespannungsgrenze (V) des Batteriemoduls
    • -
  • dischargeCurrentLimit
    aktueller Grenzwert für den Entladestrom (A)
    • -
  • dischargeEnable
    aktuelles Flag Entladen erlaubt
    • -
  • dischargeVoltageLimit
    aktuelle Entladespannungsgrenze (V) des Batteriemoduls
    • + + Readings +
      +
    • averageCellVolt
      mittlere Zellenspannung (V)
      • +
    • bmsTemperature
      Temperatur (°C) des Batteriemanagementsystems
      • +
    • cellTemperature_0104
      Temperatur (°C) der Zellenpacks 1 bis 4
      • +
    • cellTemperature_0508
      Temperatur (°C) der Zellenpacks 5 bis 8
      • +
    • cellTemperature_0912
      Temperatur (°C) der Zellenpacks 9 bis 12
      • +
    • cellTemperature_1315
      Temperatur (°C) der Zellenpacks 13 bis 15
      • +
    • cellVoltage_XX
      Zellenspannung (V) des Zellenpacks XX. In dem Batteriemodul sind "packCellcount" + Zellenpacks in Serie geschaltet verbaut. Jedes Zellenpack besteht aus parallel + geschalten Einzelzellen.
      • +
    • chargeCurrentLimit
      aktueller Grenzwert für den Ladestrom (A)
      • +
    • chargeEnable
      aktuelles Flag Laden erlaubt
      • +
    • chargeFullRequest
      aktuelles Flag Batteriemodul voll laden (notfalls aus dem Netz)
      • +
    • chargeImmediatelySOCXX
      aktuelles Flag Batteriemodul sofort laden + (05: SOC Grenze 5-9%, 09: SOC Grenze 9-13%)
      • +
    • chargeVoltageLimit
      aktuelle Ladespannungsgrenze (V) des Batteriemoduls
      • +
    • dischargeCurrentLimit
      aktueller Grenzwert für den Entladestrom (A)
      • +
    • dischargeEnable
      aktuelles Flag Entladen erlaubt
      • +
    • dischargeVoltageLimit
      aktuelle Entladespannungsgrenze (V) des Batteriemoduls
      • -
    • moduleSoftwareVersion_manufacture
      Firmware Version des Batteriemoduls
      • +
    • moduleSoftwareVersion_manufacture
      Firmware Version des Batteriemoduls
      • -
    • packAlarmInfo
      Alarmstatus (ok - Batterienmodul ist in Ordnung, failure - im Batteriemodul liegt - eine Störung vor)
      • -
    • packCapacity
      nominale Kapazität (Ah) des Batteriemoduls
      • -
    • packCapacityRemain
      aktuelle Kapazität (Ah) des Batteriemoduls
      • -
    • packCellcount
      Anzahl der Zellenpacks im Batteriemodul
      • -
    • packCurrent
      aktueller Ladestrom (+) bzw. Entladstrom (-) des Batteriemoduls (A)
      • -
    • packCycles
      Anzahl der Vollzyklen - Die Anzahl der Zyklen ist in gewisserweise ein Maß für den - Verschleiß der Batterie. Eine komplettes Laden und Entladen wird als ein Zyklus - gewertet. Wird die Batterie 50% entladen und wieder aufgeladen, zählt das nur als ein - halber Zyklus. Pylontech gibt eine Lebensdauer von mehreren 1000 Zyklen an - (siehe Datenblatt).
      • -
    • packImbalance
      aktuelles Ungleichgewicht der Spannung zwischen den Einzelzellen des - Batteriemoduls (%)
      • -
    • packPower
      aktuell bezogene (+) bzw. gelieferte (-) Leistung (W) des Batteriemoduls
      • -
    • packSOC
      Ladezustand (%) des Batteriemoduls
      • -
    • packState
      aktueller Arbeitsstatus des Batteriemoduls
      • -
    • packVolt
      aktuelle Spannung (V) des Batteriemoduls
      • +
    • packAlarmInfo
      Alarmstatus (ok - Batterienmodul ist in Ordnung, failure - im Batteriemodul liegt + eine Störung vor)
      • +
    • packCapacity
      nominale Kapazität (Ah) des Batteriemoduls
      • +
    • packCapacityRemain
      aktuelle Kapazität (Ah) des Batteriemoduls
      • +
    • packCellcount
      Anzahl der Zellenpacks im Batteriemodul
      • +
    • packCurrent
      aktueller Ladestrom (+) bzw. Entladstrom (-) des Batteriemoduls (A)
      • +
    • packCycles
      Anzahl der Vollzyklen - Die Anzahl der Zyklen ist in gewisserweise ein Maß für den + Verschleiß der Batterie. Eine komplettes Laden und Entladen wird als ein Zyklus + gewertet. Wird die Batterie 50% entladen und wieder aufgeladen, zählt das nur als ein + halber Zyklus. Pylontech gibt eine Lebensdauer von mehreren 1000 Zyklen an + (siehe Datenblatt).
      • +
    • packImbalance
      aktuelles Ungleichgewicht der Spannung zwischen den Einzelzellen des + Batteriemoduls (%)
      • +
    • packPower
      aktuell bezogene (+) bzw. gelieferte (-) Leistung (W) des Batteriemoduls
      • +
    • packSOC
      Ladezustand (%) des Batteriemoduls
      • +
    • packState
      aktueller Arbeitsstatus des Batteriemoduls
      • +
    • packVolt
      aktuelle Spannung (V) des Batteriemoduls
      • -
    • paramCellHighVoltLimit
      Systemparameter obere Spannungsgrenze (V) einer Zelle
      • -
    • paramCellLowVoltLimit
      Systemparameter untere Spannungsgrenze (V) einer Zelle (Alarmgrenze)
      • -
    • paramCellUnderVoltLimit
      Systemparameter Unterspannungsgrenze (V) einer Zelle (Schutzgrenze)
      • -
    • paramChargeCurrentLimit
      Systemparameter Ladestromgrenze (A) des Batteriemoduls
      • -
    • paramChargeHighTempLimit
      Systemparameter obere Temperaturgrenze (°C) bis zu der die Batterie lädt
      • -
    • paramChargeLowTempLimit
      Systemparameter untere Temperaturgrenze (°C) bis zu der die Batterie lädt
      • -
    • paramDischargeCurrentLimit
      Systemparameter Entladestromgrenze (A) des Batteriemoduls
      • -
    • paramDischargeHighTempLimit
      Systemparameter obere Temperaturgrenze (°C) bis zu der die Batterie entlädt
      • -
    • paramDischargeLowTempLimit
      Systemparameter untere Temperaturgrenze (°C) bis zu der die Batterie entlädt
      • -
    • paramModuleHighVoltLimit
      Systemparameter obere Spannungsgrenze (V) des Batteriemoduls
      • -
    • paramModuleLowVoltLimit
      Systemparameter untere Spannungsgrenze (V) des Batteriemoduls (Alarmgrenze)
      • -
    • paramModuleUnderVoltLimit
      Systemparameter Unterspannungsgrenze (V) des Batteriemoduls (Schutzgrenze)
      • -
    • protocolVersion
      PYLON low voltage RS485 Prokollversion
      • -
    • serialNumber
      Seriennummer
      • -
    -

    +
  • paramCellHighVoltLimit
    Systemparameter obere Spannungsgrenze (V) einer Zelle
    • +
  • paramCellLowVoltLimit
    Systemparameter untere Spannungsgrenze (V) einer Zelle (Alarmgrenze)
    • +
  • paramCellUnderVoltLimit
    Systemparameter Unterspannungsgrenze (V) einer Zelle (Schutzgrenze)
    • +
  • paramChargeCurrentLimit
    Systemparameter Ladestromgrenze (A) des Batteriemoduls
    • +
  • paramChargeHighTempLimit
    Systemparameter obere Temperaturgrenze (°C) bis zu der die Batterie lädt
    • +
  • paramChargeLowTempLimit
    Systemparameter untere Temperaturgrenze (°C) bis zu der die Batterie lädt
    • +
  • paramDischargeCurrentLimit
    Systemparameter Entladestromgrenze (A) des Batteriemoduls
    • +
  • paramDischargeHighTempLimit
    Systemparameter obere Temperaturgrenze (°C) bis zu der die Batterie entlädt
    • +
  • paramDischargeLowTempLimit
    Systemparameter untere Temperaturgrenze (°C) bis zu der die Batterie entlädt
    • +
  • paramModuleHighVoltLimit
    Systemparameter obere Spannungsgrenze (V) des Batteriemoduls
    • +
  • paramModuleLowVoltLimit
    Systemparameter untere Spannungsgrenze (V) des Batteriemoduls (Alarmgrenze)
    • +
  • paramModuleUnderVoltLimit
    Systemparameter Unterspannungsgrenze (V) des Batteriemoduls (Schutzgrenze)
    • +
  • protocolVersion
    PYLON low voltage RS485 Prokollversion
    • +
  • serialNumber
    Seriennummer
    • +
+

=end html_DE