diff --git a/resol/README.md b/resol/README.md deleted file mode 100755 index 466409b5d..000000000 --- a/resol/README.md +++ /dev/null @@ -1,126 +0,0 @@ -# resol - -SmarthomeNG-Plugin to read Resol datalogger: -http://www.resol.de/index/produktdetail/kategorie/4/id/8/sprache/de -http://www.cosmo-info.de/fileadmin/user_upload/DL/COSMO-Solarregelung/COSMO-Multi.pdf - -## Notes - -This plugin is still __under development__! -Many thanks to @MARKOV -https://knx-user-forum.de/forum/supportforen/smarthome-py/919242-neues-plugin-resol-vbus-cosmo-multi-solarthermie-logging/page2 - -## Prerequisite - -The following python packages need to be installed on your system: -- none - -### plugin.yaml - -``` -resol: - class_name: Resol - class_path: plugins.resol - ip: 192.168.178.111 # ip of VBUS LAN - cycle: 60 - port: 7053 # port of VBUS LAN usualy is 7053! - password: xxx -``` -More information of resol parameter and sources, see here: -https://github.com/danielwippermann/resol-vbus -https://danielwippermann.github.io/resol-vbus/#/vsf - -Install Programm Resol Service Center to read offset und Bituse: -- They are provided in XML by RESOL as part of the RSC (Resol Service Center) download. Just download, install (on linux use wine, it will work) and get the required file for your installation from: {Install_dir}/eclipse/plugins/de.resol.servicecenter.vbus.resol_2.0.0/ - - -### items.yaml - -```yaml - -resol: - resol_source: '0x7821' - resol_destination: '0x0010' - resol_command: '0x0100' - - temperature_soll: - type: num - visu_acl: ro - enforce_updates: 'true' - resol_offset: 24 - resol_bituse: 7 - resol_factor: - - '1.0' - - temperatur_2: - type: num - visu_acl: ro - enforce_updates: 'true' - resol_offset: 2 - resol_bituse: 15 - resol_factor: - - '0.1' - - '25.6' - - waermemenge: - type: num - visu_acl: ro - enforce_updates: 'true' - #json_variable: 'Waermemenge' - resol_offset: 28 - resol_bituse: 48 - resol_factor: - - '1' - - '256' - - '1000' - - '256000' - - '1000000' - - '256000000' - - solar: - resol_source@solar: '0x7721' - resol_destination@solar: '0x0010' - resol_command@solar: '0x0100' - - sensordefektmaske: - type: num - visu_acl: ro - resol_offset@solar: 36 - resol_bituse@solar: 16 - resol_factor@solar: - - '1.0' - - '256.0' - - temperatur_1: - name: 'Temperature Kollektor' - type: num - visu_acl: ro - database: init - database_maxage: 62 - resol_offset@solar: 0 - resol_bituse@solar: 16 - resol_factor@solar: - - '0.1' - - '25.6' - resol_isSigned@solar: - - False - - True - - -``` - -Resol protocol: - -Synch byte beween messages: 0xAA - -Message: - Byte Content - 0-1 Destination - 2-3 Source - 4 Protocol Version, 0x10 -> "PV1", 0x20 -> "PV2", 0x30 -> "PV3" - 5-6 Command - 7-8 Frame count, Example 0x1047-> 104 bytes - - - - -``` diff --git a/resol/user_doc.rst b/resol/user_doc.rst index 2be1058ef..6ef13a406 100755 --- a/resol/user_doc.rst +++ b/resol/user_doc.rst @@ -17,14 +17,96 @@ Allgemein Resol plugin, mit Unterstützung für Resol Solar Datenlogger, Frischwasserwärmetauscher und Regler. +http://www.resol.de/index/produktdetail/kategorie/4/id/8/sprache/de + +http://www.cosmo-info.de/fileadmin/user_upload/DL/COSMO-Solarregelung/COSMO-Multi.pdf + + Konfiguration ============= Die Informationen zur Konfiguration des Plugins sind unter :doc:`/plugins_doc/config/resol` beschrieben. -Weiterführende Informationen -============================ +Beispiel +======== + +.. code-block:: yaml + + resol: + resol_source: '0x7821' + resol_destination: '0x0010' + resol_command: '0x0100' + + temperature_soll: + type: num + visu_acl: ro + enforce_updates: 'true' + resol_offset: 24 + resol_bituse: 7 + resol_factor: + - '1.0' + + temperatur_2: + type: num + visu_acl: ro + enforce_updates: 'true' + resol_offset: 2 + resol_bituse: 15 + resol_factor: + - '0.1' + - '25.6' + + waermemenge: + type: num + visu_acl: ro + enforce_updates: 'true' + resol_offset: 28 + resol_bituse: 48 + resol_factor: + - '1' + - '256' + - '1000' + - '256000' + - '1000000' + - '256000000' + + solar: + resol_source@solar: '0x7721' + resol_destination@solar: '0x0010' + resol_command@solar: '0x0100' + + sensordefektmaske: + type: num + visu_acl: ro + resol_offset@solar: 36 + resol_bituse@solar: 16 + resol_factor@solar: + - '1.0' + - '256.0' + + temperatur_1: + name: 'Temperature Kollektor' + type: num + visu_acl: ro + database: init + database_maxage: 62 + resol_offset@solar: 0 + resol_bituse@solar: 16 + resol_factor@solar: + - '0.1' + - '25.6' + resol_isSigned@solar: + - False + - True + + + +Resol Protokoll +=============== + +Informationen +------------- Weitere Informationen zu Resol Parametern und Quellen sind hier zu finden: @@ -32,56 +114,19 @@ https://github.com/danielwippermann/resol-vbus https://danielwippermann.github.io/resol-vbus/#/vsf +Über die Installation der Resol Software Service Center können weitere Offsets und Bitmasken ausgelesen werden. +Diese werden im XML Format von RESOL als Teil der RSC Software (Resol Service Center) bereitgestellt. Hierzu +einfach download, installieren (unter Linux ``wine`` nutzen) und die benötigten XML Dateien von hier beziehen: {Install_dir}/eclipse/plugins/de.resol.servicecenter.vbus.resol_2.0.0/ - -Resol Protokol --------------- - -Synch byte beween messages: 0xAA +Synch byte zwischen verschiedenen Messages: 0xAA Message: - - Byte Content - - 0-1 Destination - - 2-3 Source - - 4 Protocol Version, 0x10 -> "PV1", 0x20 -> "PV2", 0x30 -> "PV3" - - 5-6 Command - - 7-8 Frame count, Example 0x1047-> 104 bytes - - -Beispiele -========= - -.. code-block:: yaml - - solar: - resol_source@solar: '0x7721' - resol_destination@solar: '0x0010' - resol_command@solar: '0x0100' - - sensordefektmaske: - type: num - resol_offset@solar: 36 - resol_bituse@solar: 16 - resol_factor@solar: - - '1.0' - - '256.0' - - temperatur_1: - name: 'Temperature Kollektor' - type: num - resol_offset@solar: 0 - resol_bituse@solar: 16 - resol_factor@solar: - - '0.1' - - '25.6' - resol_isSigned@solar: - - False - - True - - - +=============== ========================================================================= +Byte(s) Inhalt +=============== ========================================================================= +0-1 Destination +2-3 Source + 4 Protocol Version, 0x10 -> "PV1", 0x20 -> "PV2", 0x30 -> "PV3" +5-6 Command +7-8 Frame count, Example 0x1047-> 104 bytes +=============== =========================================================================