diff --git a/ha_addon_debug/DOCS.md b/ha_addon_debug/DOCS.md index 310c54a..cce376c 100644 --- a/ha_addon_debug/DOCS.md +++ b/ha_addon_debug/DOCS.md @@ -71,6 +71,9 @@ inverters: node_id: PV-Garage suggested_area: Garage modbus_polling: true + client_mode.host: 192.168.x.x + client_mode.port: 8899 + client_mode.forward: true pv1.manufacturer: Shinefar pv1.type: SF-M18/144550 pv2.manufacturer: Shinefar @@ -83,6 +86,8 @@ inverters: **Note**: _This is just an example, you need to replace the values with your own!_ +more information about the configuration can be found in the [configuration details page][configdetails]. + ## MQTT settings By default, this add-on requires no `mqtt` config from the user. **This is not an error!** @@ -154,3 +159,4 @@ SOFTWARE. [AdGuard]: https://github.com/hassio-addons/addon-adguard-home [repository-badge]: https://img.shields.io/badge/Add%20repository%20to%20my-Home%20Assistant-41BDF5?logo=home-assistant&style=for-the-badge [repository-url]: https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fs-allius%2Fha-addons +[configdetails]: https://github.com/s-allius/tsun-gen3-proxy/wiki/Configuration-details diff --git a/ha_addon_debug/config.yaml b/ha_addon_debug/config.yaml index ccfd9ed..4957ae3 100644 --- a/ha_addon_debug/config.yaml +++ b/ha_addon_debug/config.yaml @@ -39,8 +39,9 @@ schema: node_id: str suggested_area: str modbus_polling: bool - client_mode_host: str? - client_mode_port: int? + client_mode.host: str? + client_mode.port: int? + client_mode.forward: bool? #strings: # leider funktioniert es nicht die folgenden 3 parameter im schema aufzulisten. möglicherweise wird die verschachtelung nicht unterstützt. # - string: str # type: str diff --git a/ha_addon_debug/translations/de.yaml b/ha_addon_debug/translations/de.yaml index 57a6959..cf48599 100755 --- a/ha_addon_debug/translations/de.yaml +++ b/ha_addon_debug/translations/de.yaml @@ -5,83 +5,91 @@ configuration: description: >+ Für jeden Wechselrichter muss die Seriennummer des Wechselrichters einer MQTT Definition zugeordnet werden. Dazu wird der entsprechende Konfigurationsblock mit der - <16-stellige Seriennummer> gestartet, so dass alle nachfolgenden Parameter diesem - Wechselricher zugeordnet sind. + 16-stellige Seriennummer gestartet, so dass alle nachfolgenden Parameter diesem + Wechselrichter zugeordnet sind. Weitere wechselrichterspezifische Parameter (z.B. Polling Mode) können im Konfigurationsblock gesetzt werden. - Die Seriennummer der GEN3 Wechselrichter beginnne mit `R17` und die der GEN3PLUS + Die Seriennummer der GEN3 Wechselrichter beginnen mit `R17` und die der GEN3PLUS Wechselrichter mir `Y17`oder `47`! - monitor_sn # Die GEN3PLUS "Monitoring SN:" - node_id # MQTT-Ersatz für die Seriennummer des Wechselrichters - suggested_area # Vorgeschlagener Installationsbereich für Home-Assistant - modbus_polling # Optionale MODBUS-Polling deaktivieren - pv1 # Optional, PV Module Beschreibung - pv2 # Optional, PV Module Beschreibung + Siehe Beispielkonfiguration im Dokumentations-Tab tsun.enabled: name: Verbindung zur TSUN Cloud - nur für GEN3-Wechselrichter - description: >- - switch on/off connection to the TSUN cloud - This connection is only required if you want send data to the TSUN cloud - eg. to use the TSUN APPs or receive firmware updates. + description: >+ + Schaltet die Verbindung zur TSUN Cloud ein/aus. + Diese Verbindung ist erforderlich, wenn Sie Daten an die TSUN Cloud senden möchten, + z.B. um die TSUN-Apps zu nutzen oder Firmware-Updates zu erhalten. - on - normal proxy operation - off - The Inverter become isolated from Internet + ein => normaler Proxy-Betrieb. + aus => Der Wechselrichter wird vom Internet isoliert. solarman.enabled: - name: Connection to Solarman Cloud - for GEN3PLUS inverter only - description: >- - switch on/off connection to the Solarman cloud - This connection is only required if you want send data to the Solarman cloud - eg. to use the Solarman APPs or receive firmware updates. + name: Verbindung zur Solarman Cloud - nur für GEN3PLUS Wechselrichter + description: >+ + Schaltet die Verbindung zur Solarman Cloud ein/aus. + Diese Verbindung ist erforderlich, wenn Sie Daten an die Solarman Cloud senden möchten, + z.B. um die Solarman Apps zu nutzen oder Firmware-Updates zu erhalten. - on - normal proxy operation - off - The Inverter become isolated from Internet + ein => normaler Proxy-Betrieb. + aus => Der Wechselrichter wird vom Internet isoliert. inverters.allow_all: - name: Allow all connections from all inverters + name: Erlaube Verbindungen von sämtlichen Wechselrichtern description: >- - The proxy only usually accepts connections from known inverters. - Switch on for test purposes and unknown serial numbers. + Der Proxy akzeptiert normalerweise nur Verbindungen von konfigurierten Wechselrichtern. + Schalten Sie dies für Testzwecke und unbekannte Seriennummern ein. mqtt.host: name: MQTT Broker Host description: >- - Hostname or IP address of the MQTT broker. if not set, the addon will try to connect to the Home Assistant MQTT broker + Hostname oder IP-Adresse des MQTT-Brokers. Wenn nicht gesetzt, versucht das Addon, eine Verbindung zum Home Assistant MQTT-Broker herzustellen. mqtt.port: name: MQTT Broker Port description: >- - Port of the MQTT broker. if not set, the addon will try to connect to the Home Assistant MQTT broker + Port des MQTT-Brokers. Wenn nicht gesetzt, versucht das Addon, eine Verbindung zum Home Assistant MQTT-Broker herzustellen. mqtt.user: - name: MQTT Broker User + name: MQTT Broker Benutzer description: >- - User for the MQTT broker. if not set, the addon will try to connect to the Home Assistant MQTT broker + Benutzer für den MQTT-Broker. Wenn nicht gesetzt, versucht das Addon, eine Verbindung zum Home Assistant MQTT-Broker herzustellen. mqtt.passwd: - name: MQTT Broker Password + name: MQTT Broker Passwort description: >- - Password for the MQTT broker. if not set, the addon will try to connect to the Home Assistant MQTT broker + Passwort für den MQTT-Broker. Wenn nicht gesetzt, versucht das Addon, eine Verbindung zum Home Assistant MQTT-Broker herzustellen. ha.auto_conf_prefix: - name: MQTT prefix for subscribing for homeassistant status updates + name: MQTT-Präfix für das Abonnieren von Home Assistant-Statusaktualisierungen ha.discovery_prefix: - name: MQTT prefix for discovery topic + name: MQTT-Präfix für das discovery topic ha.entity_prefix: - name: MQTT topic prefix for publishing inverter values + name: MQTT-Themenpräfix für die Veröffentlichung von Wechselrichterwerten ha.proxy_node_id: - name: MQTT node id, for the proxy_node_id + name: MQTT-Knoten-ID für die proxy_node_id ha.proxy_unique_id: - name: MQTT unique id, to identify a proxy instance + name: MQTT-eindeutige ID zur Identifizierung einer Proxy-Instanz tsun.host: name: TSUN Cloud Host description: >- - Hostname or IP address of the TSUN cloud. if not set, the addon will try to connect to the cloud default - on logger.talent-monitoring.com + Hostname oder IP-Adresse der TSUN-Cloud. Wenn nicht gesetzt, versucht das Addon, eine Verbindung zur Cloud logger.talent-monitoring.com herzustellen. solarman.host: name: Solarman Cloud Host description: >- - Hostname or IP address of the Solarman cloud. if not set, the addon will try to connect to the cloud default - on iot.talent-monitoring.com + Hostname oder IP-Adresse der Solarman-Cloud. Wenn nicht gesetzt, versucht das Addon, eine Verbindung zur Cloud iot.talent-monitoring.com herzustellen. + gen3plus.at_acl.tsun.allow: + name: TSUN GEN3PLUS ACL allow + description: >- + Liste erlaubter AT-Befehle für TSUN GEN3PLUS + gen3plus.at_acl.tsun.block: + name: TSUN GEN3 ACL block + description: >- + Liste blockierter AT-Befehle für TSUN GEN3PLUS + gen3plus.at_acl.mqtt.allow: + name: MQTT GEN3PLUS ACL allow + description: >- + Liste erlaubter MQTT-Befehle für GEN3PLUS + gen3plus.at_acl.mqtt.block: + name: MQTT GEN3PLUS ACL block + description: >- + Liste blockierter MQTT-Befehle für GEN3PLUS network: - 8127/tcp: x... - 5005/tcp: listening Port for TSUN GEN3 Devices - 10000/tcp: listening Port for TSUN GEN3PLUS Devices + 5005/tcp: listening Port für TSUN GEN3 Wechselrichter + 10000/tcp: listening Port für TSUN GEN3PLUS Wechselrichter diff --git a/ha_addon_debug/translations/en.yaml b/ha_addon_debug/translations/en.yaml index b6025d8..42d01da 100755 --- a/ha_addon_debug/translations/en.yaml +++ b/ha_addon_debug/translations/en.yaml @@ -5,42 +5,37 @@ configuration: description: >+ For each GEN3 inverter, the serial number of the inverter must be mapped to an MQTT definition. To do this, the corresponding configuration block is started with - <16-digit serial number> so that all subsequent parameters are assigned + 16-digit serial number so that all subsequent parameters are assigned to this inverter. Further inverter-specific parameters (e.g. polling mode) can be set in the configuration block The serial numbers of all GEN3 inverters start with `R17` and that of the GEN3PLUS inverters with ‘Y17’ or ‘47’! - - monitor_sn # The GEN3PLUS "Monitoring SN:" - node_id # MQTT replacement for inverters serial number - suggested_area # suggested installation area for home-assistant - modbus_polling # Disable optional MODBUS polling - pv1 # Optional, PV module descr - pv2 # Optional, PV module descr + + For reference see example configuration in Documentation Tab tsun.enabled: name: Connection to TSUN Cloud - for GEN3 inverter only - description: >- - switch on/off connection to the TSUN cloud + description: >+ + switch on/off connection to the TSUN cloud. This connection is only required if you want send data to the TSUN cloud eg. to use the TSUN APPs or receive firmware updates. - on - normal proxy operation - off - The Inverter become isolated from Internet + on => normal proxy operation. + off => The Inverter become isolated from Internet. solarman.enabled: name: Connection to Solarman Cloud - for GEN3PLUS inverter only - description: >- - switch on/off connection to the Solarman cloud + description: >+ + switch on/off connection to the Solarman cloud. This connection is only required if you want send data to the Solarman cloud eg. to use the Solarman APPs or receive firmware updates. - on - normal proxy operation - off - The Inverter become isolated from Internet + on => normal proxy operation. + off => The Inverter become isolated from Internet inverters.allow_all: name: Allow all connections from all inverters description: >- - The proxy only usually accepts connections from known inverters. + The proxy only usually accepts connections from configured inverters. Switch on for test purposes and unknown serial numbers. mqtt.host: name: MQTT Broker Host @@ -71,16 +66,30 @@ configuration: tsun.host: name: TSUN Cloud Host description: >- - Hostname or IP address of the TSUN cloud. if not set, the addon will try to connect to the cloud default + Hostname or IP address of the TSUN cloud. if not set, the addon will try to connect to the cloud on logger.talent-monitoring.com solarman.host: name: Solarman Cloud Host description: >- - Hostname or IP address of the Solarman cloud. if not set, the addon will try to connect to the cloud default + Hostname or IP address of the Solarman cloud. if not set, the addon will try to connect to the cloud on iot.talent-monitoring.com - + gen3plus.at_acl.tsun.allow: + name: TSUN GEN3PLUS ACL allow + description: >- + List of allowed TSUN GEN3PLUS AT commands + gen3plus.at_acl.tsun.block: + name: TSUN GEN3 ACL block + description: >- + List of blocked TSUN GEN3PLUS AT commands + gen3plus.at_acl.mqtt.allow: + name: MQTT GEN3PLUS ACL allow + description: >- + List of allowed MQTT GEN3PLUS commands + gen3plus.at_acl.mqtt.block: + name: MQTT GEN3PLUS ACL block + description: >- + List of blocked MQTT GEN3PLUS commands network: - 8127/tcp: x... 5005/tcp: listening Port for TSUN GEN3 Devices 10000/tcp: listening Port for TSUN GEN3PLUS Devices diff --git a/ha_addon_dev/DOCS.md b/ha_addon_dev/DOCS.md index 310c54a..cce376c 100644 --- a/ha_addon_dev/DOCS.md +++ b/ha_addon_dev/DOCS.md @@ -71,6 +71,9 @@ inverters: node_id: PV-Garage suggested_area: Garage modbus_polling: true + client_mode.host: 192.168.x.x + client_mode.port: 8899 + client_mode.forward: true pv1.manufacturer: Shinefar pv1.type: SF-M18/144550 pv2.manufacturer: Shinefar @@ -83,6 +86,8 @@ inverters: **Note**: _This is just an example, you need to replace the values with your own!_ +more information about the configuration can be found in the [configuration details page][configdetails]. + ## MQTT settings By default, this add-on requires no `mqtt` config from the user. **This is not an error!** @@ -154,3 +159,4 @@ SOFTWARE. [AdGuard]: https://github.com/hassio-addons/addon-adguard-home [repository-badge]: https://img.shields.io/badge/Add%20repository%20to%20my-Home%20Assistant-41BDF5?logo=home-assistant&style=for-the-badge [repository-url]: https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fs-allius%2Fha-addons +[configdetails]: https://github.com/s-allius/tsun-gen3-proxy/wiki/Configuration-details diff --git a/ha_addon_dev/config.yaml b/ha_addon_dev/config.yaml index 564b863..4ef3832 100755 --- a/ha_addon_dev/config.yaml +++ b/ha_addon_dev/config.yaml @@ -39,8 +39,9 @@ schema: node_id: str suggested_area: str modbus_polling: bool - client_mode_host: str? - client_mode_port: int? + client_mode.host: str? + client_mode.port: int? + client_mode.forward: bool? #strings: # leider funktioniert es nicht die folgenden 3 parameter im schema aufzulisten. möglicherweise wird die verschachtelung nicht unterstützt. # - string: str # type: str diff --git a/ha_addon_dev/translations/de.yaml b/ha_addon_dev/translations/de.yaml index 1ab99f5..cf48599 100755 --- a/ha_addon_dev/translations/de.yaml +++ b/ha_addon_dev/translations/de.yaml @@ -5,86 +5,91 @@ configuration: description: >+ Für jeden Wechselrichter muss die Seriennummer des Wechselrichters einer MQTT Definition zugeordnet werden. Dazu wird der entsprechende Konfigurationsblock mit der - <16-stellige Seriennummer> gestartet, so dass alle nachfolgenden Parameter diesem - Wechselricher zugeordnet sind. + 16-stellige Seriennummer gestartet, so dass alle nachfolgenden Parameter diesem + Wechselrichter zugeordnet sind. Weitere wechselrichterspezifische Parameter (z.B. Polling Mode) können im Konfigurationsblock gesetzt werden. - Die Seriennummer der GEN3 Wechselrichter beginnne mit `R17` und die der GEN3PLUS + Die Seriennummer der GEN3 Wechselrichter beginnen mit `R17` und die der GEN3PLUS Wechselrichter mir `Y17`oder `47`! - monitor_sn # Die GEN3PLUS "Monitoring SN:" - node_id # MQTT-Ersatz für die Seriennummer des Wechselrichters - suggested_area # Vorgeschlagener Installationsbereich für Home-Assistant - modbus_polling # Optionale MODBUS-Polling deaktivieren - pv1 # Optional, PV Module Beschreibung - pv2 # Optional, PV Module Beschreibung + Siehe Beispielkonfiguration im Dokumentations-Tab tsun.enabled: - name: Verbindung zur TSUN-Cloud - nur für GEN3-Wechselrichter - description: >- - Die Verbindung zur TSUN-Cloud ein- und ausschalten - Diese Verbindung wird nur benötigt, wenn Sie Daten an die TSUN-Cloud senden - wollen z.B. um die TSUN APPs zu nutzen oder Firmware Updates zu erhalten. + name: Verbindung zur TSUN Cloud - nur für GEN3-Wechselrichter + description: >+ + Schaltet die Verbindung zur TSUN Cloud ein/aus. + Diese Verbindung ist erforderlich, wenn Sie Daten an die TSUN Cloud senden möchten, + z.B. um die TSUN-Apps zu nutzen oder Firmware-Updates zu erhalten. - on - normaler Proxy-Betrieb - off - Der Wechselrichter wird vom Internet isoliert + ein => normaler Proxy-Betrieb. + aus => Der Wechselrichter wird vom Internet isoliert. solarman.enabled: - name: Verbindung zur Solarman/TSUN-Cloud - nur für GEN3PLUS-Wechselrichter - description: >- - Die Verbindung zur Solarman/TSUN-Cloud ein- und ausschalten - Diese Verbindung wird nur benötigt, wenn Sie Daten an die TSUN-Cloud senden - wollen z.B. um die TSUN APPs zu nutzen oder Firmware Updates zu erhalten. + name: Verbindung zur Solarman Cloud - nur für GEN3PLUS Wechselrichter + description: >+ + Schaltet die Verbindung zur Solarman Cloud ein/aus. + Diese Verbindung ist erforderlich, wenn Sie Daten an die Solarman Cloud senden möchten, + z.B. um die Solarman Apps zu nutzen oder Firmware-Updates zu erhalten. - on - normaler Proxy-Betrieb - off - Der Wechselrichter wird vom Internet isoliert + ein => normaler Proxy-Betrieb. + aus => Der Wechselrichter wird vom Internet isoliert. inverters.allow_all: - name: Verbindungen von allen Wechselrichtern zulassen + name: Erlaube Verbindungen von sämtlichen Wechselrichtern description: >- - Der Proxy akzeptiert in der Regel nur Verbindungen von bekannten Wechselrichtern. - Für Testzwecke und unbekannte Seriennummern einschalten. + Der Proxy akzeptiert normalerweise nur Verbindungen von konfigurierten Wechselrichtern. + Schalten Sie dies für Testzwecke und unbekannte Seriennummern ein. mqtt.host: name: MQTT Broker Host description: >- - Hostname oder IP-Adresse des MQTT-Brokers. Wenn nicht angegeben, versucht das Addon, - sich mit dem MQTT-Broker des Home Assistant zu verbinden. + Hostname oder IP-Adresse des MQTT-Brokers. Wenn nicht gesetzt, versucht das Addon, eine Verbindung zum Home Assistant MQTT-Broker herzustellen. mqtt.port: name: MQTT Broker Port description: >- - Portnummer des MQTT-Brokers. Wenn nicht angegeben, versucht das Addon, - sich mit dem MQTT-Broker des Home Assistant zu verbinden. + Port des MQTT-Brokers. Wenn nicht gesetzt, versucht das Addon, eine Verbindung zum Home Assistant MQTT-Broker herzustellen. mqtt.user: - name: MQTT Broker Benutzername + name: MQTT Broker Benutzer description: >- - Benutzername für den MQTT-Brokers. Wenn nicht angegeben, versucht das Addon, - sich mit dem MQTT-Broker des Home Assistant zu verbinden. + Benutzer für den MQTT-Broker. Wenn nicht gesetzt, versucht das Addon, eine Verbindung zum Home Assistant MQTT-Broker herzustellen. mqtt.passwd: name: MQTT Broker Passwort description: >- - Passwort für den MQTT-Brokers. Wenn nicht angegeben, versucht das Addon, - sich mit dem MQTT-Broker des Home Assistant zu verbinden. + Passwort für den MQTT-Broker. Wenn nicht gesetzt, versucht das Addon, eine Verbindung zum Home Assistant MQTT-Broker herzustellen. ha.auto_conf_prefix: - name: MQTT-Präfix zum Abonnieren von Homeassistant-Statusaktualisierungen + name: MQTT-Präfix für das Abonnieren von Home Assistant-Statusaktualisierungen ha.discovery_prefix: - name: MQTT-Präfix für `discovery topic` + name: MQTT-Präfix für das discovery topic ha.entity_prefix: - name: MQTT Topic Präfix zum publizieren von Wechselrichter Daten + name: MQTT-Themenpräfix für die Veröffentlichung von Wechselrichterwerten ha.proxy_node_id: - name: MQTT Node ID, für die `proxy_node_id` + name: MQTT-Knoten-ID für die proxy_node_id ha.proxy_unique_id: - name: MQTT eindeutige ID, zu Indentifizierung einer Proxy Instanz + name: MQTT-eindeutige ID zur Identifizierung einer Proxy-Instanz tsun.host: name: TSUN Cloud Host description: >- - Hostname oder IP-Adresse der TSUN-Cloud. Wenn nicht angegeben, versucht das Addon, sich mit der - Standard-Cloud auf logger.talent-monitoring.com zu verbinden + Hostname oder IP-Adresse der TSUN-Cloud. Wenn nicht gesetzt, versucht das Addon, eine Verbindung zur Cloud logger.talent-monitoring.com herzustellen. solarman.host: name: Solarman Cloud Host description: >- - Hostname oder IP-Adresse der Solarman/TSUN-Cloud. Wenn nicht angegeben, versucht das Addon, sich mit der - Standard-Cloud auf iot.talent-monitoring.com zu verbinden + Hostname oder IP-Adresse der Solarman-Cloud. Wenn nicht gesetzt, versucht das Addon, eine Verbindung zur Cloud iot.talent-monitoring.com herzustellen. + gen3plus.at_acl.tsun.allow: + name: TSUN GEN3PLUS ACL allow + description: >- + Liste erlaubter AT-Befehle für TSUN GEN3PLUS + gen3plus.at_acl.tsun.block: + name: TSUN GEN3 ACL block + description: >- + Liste blockierter AT-Befehle für TSUN GEN3PLUS + gen3plus.at_acl.mqtt.allow: + name: MQTT GEN3PLUS ACL allow + description: >- + Liste erlaubter MQTT-Befehle für GEN3PLUS + gen3plus.at_acl.mqtt.block: + name: MQTT GEN3PLUS ACL block + description: >- + Liste blockierter MQTT-Befehle für GEN3PLUS network: - 5005/tcp: Listening Port für TSUN GEN3 Geräte - 10000/tcp: Listening Port für TSUN GEN3PLUS Geräte + 5005/tcp: listening Port für TSUN GEN3 Wechselrichter + 10000/tcp: listening Port für TSUN GEN3PLUS Wechselrichter diff --git a/ha_addon_dev/translations/en.yaml b/ha_addon_dev/translations/en.yaml index a3ded7f..42d01da 100755 --- a/ha_addon_dev/translations/en.yaml +++ b/ha_addon_dev/translations/en.yaml @@ -3,44 +3,39 @@ configuration: inverters: name: Inverters description: >+ - For each inverter, the serial number of the inverter must be mapped to an MQTT + For each GEN3 inverter, the serial number of the inverter must be mapped to an MQTT definition. To do this, the corresponding configuration block is started with - <16-digit serial number> so that all subsequent parameters are assigned to this - inverter. Further inverter-specific parameters (e.g. polling mode) can be set + 16-digit serial number so that all subsequent parameters are assigned + to this inverter. Further inverter-specific parameters (e.g. polling mode) can be set in the configuration block The serial numbers of all GEN3 inverters start with `R17` and that of the GEN3PLUS inverters with ‘Y17’ or ‘47’! - - monitor_sn # The GEN3PLUS "Monitoring SN:" - node_id # MQTT replacement for inverters serial number - suggested_area # suggested installation area for home-assistant - modbus_polling # Disable optional MODBUS polling - pv1 # Optional, PV module descr - pv2 # Optional, PV module descr + + For reference see example configuration in Documentation Tab tsun.enabled: name: Connection to TSUN Cloud - for GEN3 inverter only - description: >- - switch on/off connection to the TSUN cloud + description: >+ + switch on/off connection to the TSUN cloud. This connection is only required if you want send data to the TSUN cloud eg. to use the TSUN APPs or receive firmware updates. - on - normal proxy operation - off - The Inverter become isolated from Internet + on => normal proxy operation. + off => The Inverter become isolated from Internet. solarman.enabled: - name: Connection to Solarman/TSUN Cloud - for GEN3PLUS inverter only - description: >- - switch on/off connection to the Solarman/TSUN cloud - This connection is only required if you want send data to the Solarman/TSUN cloud - eg. to use the TSUN APPs or receive firmware updates. + name: Connection to Solarman Cloud - for GEN3PLUS inverter only + description: >+ + switch on/off connection to the Solarman cloud. + This connection is only required if you want send data to the Solarman cloud + eg. to use the Solarman APPs or receive firmware updates. - on - normal proxy operation - off - The Inverter become isolated from Internet + on => normal proxy operation. + off => The Inverter become isolated from Internet inverters.allow_all: - name: Allow connections from all inverters + name: Allow all connections from all inverters description: >- - The proxy only usually accepts connections from known inverters. + The proxy only usually accepts connections from configured inverters. Switch on for test purposes and unknown serial numbers. mqtt.host: name: MQTT Broker Host @@ -71,14 +66,29 @@ configuration: tsun.host: name: TSUN Cloud Host description: >- - Hostname or IP address of the TSUN cloud. if not set, the addon will try to connect to the cloud default + Hostname or IP address of the TSUN cloud. if not set, the addon will try to connect to the cloud on logger.talent-monitoring.com solarman.host: name: Solarman Cloud Host description: >- - Hostname or IP address of the Solarman cloud. if not set, the addon will try to connect to the cloud default + Hostname or IP address of the Solarman cloud. if not set, the addon will try to connect to the cloud on iot.talent-monitoring.com - + gen3plus.at_acl.tsun.allow: + name: TSUN GEN3PLUS ACL allow + description: >- + List of allowed TSUN GEN3PLUS AT commands + gen3plus.at_acl.tsun.block: + name: TSUN GEN3 ACL block + description: >- + List of blocked TSUN GEN3PLUS AT commands + gen3plus.at_acl.mqtt.allow: + name: MQTT GEN3PLUS ACL allow + description: >- + List of allowed MQTT GEN3PLUS commands + gen3plus.at_acl.mqtt.block: + name: MQTT GEN3PLUS ACL block + description: >- + List of blocked MQTT GEN3PLUS commands network: 5005/tcp: listening Port for TSUN GEN3 Devices diff --git a/ha_addon_rel/DOCS.md b/ha_addon_rel/DOCS.md index 310c54a..cce376c 100644 --- a/ha_addon_rel/DOCS.md +++ b/ha_addon_rel/DOCS.md @@ -71,6 +71,9 @@ inverters: node_id: PV-Garage suggested_area: Garage modbus_polling: true + client_mode.host: 192.168.x.x + client_mode.port: 8899 + client_mode.forward: true pv1.manufacturer: Shinefar pv1.type: SF-M18/144550 pv2.manufacturer: Shinefar @@ -83,6 +86,8 @@ inverters: **Note**: _This is just an example, you need to replace the values with your own!_ +more information about the configuration can be found in the [configuration details page][configdetails]. + ## MQTT settings By default, this add-on requires no `mqtt` config from the user. **This is not an error!** @@ -154,3 +159,4 @@ SOFTWARE. [AdGuard]: https://github.com/hassio-addons/addon-adguard-home [repository-badge]: https://img.shields.io/badge/Add%20repository%20to%20my-Home%20Assistant-41BDF5?logo=home-assistant&style=for-the-badge [repository-url]: https://my.home-assistant.io/redirect/supervisor_add_addon_repository/?repository_url=https%3A%2F%2Fgithub.com%2Fs-allius%2Fha-addons +[configdetails]: https://github.com/s-allius/tsun-gen3-proxy/wiki/Configuration-details diff --git a/ha_addon_rel/translations/de.yaml b/ha_addon_rel/translations/de.yaml index 57a6959..cf48599 100755 --- a/ha_addon_rel/translations/de.yaml +++ b/ha_addon_rel/translations/de.yaml @@ -5,83 +5,91 @@ configuration: description: >+ Für jeden Wechselrichter muss die Seriennummer des Wechselrichters einer MQTT Definition zugeordnet werden. Dazu wird der entsprechende Konfigurationsblock mit der - <16-stellige Seriennummer> gestartet, so dass alle nachfolgenden Parameter diesem - Wechselricher zugeordnet sind. + 16-stellige Seriennummer gestartet, so dass alle nachfolgenden Parameter diesem + Wechselrichter zugeordnet sind. Weitere wechselrichterspezifische Parameter (z.B. Polling Mode) können im Konfigurationsblock gesetzt werden. - Die Seriennummer der GEN3 Wechselrichter beginnne mit `R17` und die der GEN3PLUS + Die Seriennummer der GEN3 Wechselrichter beginnen mit `R17` und die der GEN3PLUS Wechselrichter mir `Y17`oder `47`! - monitor_sn # Die GEN3PLUS "Monitoring SN:" - node_id # MQTT-Ersatz für die Seriennummer des Wechselrichters - suggested_area # Vorgeschlagener Installationsbereich für Home-Assistant - modbus_polling # Optionale MODBUS-Polling deaktivieren - pv1 # Optional, PV Module Beschreibung - pv2 # Optional, PV Module Beschreibung + Siehe Beispielkonfiguration im Dokumentations-Tab tsun.enabled: name: Verbindung zur TSUN Cloud - nur für GEN3-Wechselrichter - description: >- - switch on/off connection to the TSUN cloud - This connection is only required if you want send data to the TSUN cloud - eg. to use the TSUN APPs or receive firmware updates. + description: >+ + Schaltet die Verbindung zur TSUN Cloud ein/aus. + Diese Verbindung ist erforderlich, wenn Sie Daten an die TSUN Cloud senden möchten, + z.B. um die TSUN-Apps zu nutzen oder Firmware-Updates zu erhalten. - on - normal proxy operation - off - The Inverter become isolated from Internet + ein => normaler Proxy-Betrieb. + aus => Der Wechselrichter wird vom Internet isoliert. solarman.enabled: - name: Connection to Solarman Cloud - for GEN3PLUS inverter only - description: >- - switch on/off connection to the Solarman cloud - This connection is only required if you want send data to the Solarman cloud - eg. to use the Solarman APPs or receive firmware updates. + name: Verbindung zur Solarman Cloud - nur für GEN3PLUS Wechselrichter + description: >+ + Schaltet die Verbindung zur Solarman Cloud ein/aus. + Diese Verbindung ist erforderlich, wenn Sie Daten an die Solarman Cloud senden möchten, + z.B. um die Solarman Apps zu nutzen oder Firmware-Updates zu erhalten. - on - normal proxy operation - off - The Inverter become isolated from Internet + ein => normaler Proxy-Betrieb. + aus => Der Wechselrichter wird vom Internet isoliert. inverters.allow_all: - name: Allow all connections from all inverters + name: Erlaube Verbindungen von sämtlichen Wechselrichtern description: >- - The proxy only usually accepts connections from known inverters. - Switch on for test purposes and unknown serial numbers. + Der Proxy akzeptiert normalerweise nur Verbindungen von konfigurierten Wechselrichtern. + Schalten Sie dies für Testzwecke und unbekannte Seriennummern ein. mqtt.host: name: MQTT Broker Host description: >- - Hostname or IP address of the MQTT broker. if not set, the addon will try to connect to the Home Assistant MQTT broker + Hostname oder IP-Adresse des MQTT-Brokers. Wenn nicht gesetzt, versucht das Addon, eine Verbindung zum Home Assistant MQTT-Broker herzustellen. mqtt.port: name: MQTT Broker Port description: >- - Port of the MQTT broker. if not set, the addon will try to connect to the Home Assistant MQTT broker + Port des MQTT-Brokers. Wenn nicht gesetzt, versucht das Addon, eine Verbindung zum Home Assistant MQTT-Broker herzustellen. mqtt.user: - name: MQTT Broker User + name: MQTT Broker Benutzer description: >- - User for the MQTT broker. if not set, the addon will try to connect to the Home Assistant MQTT broker + Benutzer für den MQTT-Broker. Wenn nicht gesetzt, versucht das Addon, eine Verbindung zum Home Assistant MQTT-Broker herzustellen. mqtt.passwd: - name: MQTT Broker Password + name: MQTT Broker Passwort description: >- - Password for the MQTT broker. if not set, the addon will try to connect to the Home Assistant MQTT broker + Passwort für den MQTT-Broker. Wenn nicht gesetzt, versucht das Addon, eine Verbindung zum Home Assistant MQTT-Broker herzustellen. ha.auto_conf_prefix: - name: MQTT prefix for subscribing for homeassistant status updates + name: MQTT-Präfix für das Abonnieren von Home Assistant-Statusaktualisierungen ha.discovery_prefix: - name: MQTT prefix for discovery topic + name: MQTT-Präfix für das discovery topic ha.entity_prefix: - name: MQTT topic prefix for publishing inverter values + name: MQTT-Themenpräfix für die Veröffentlichung von Wechselrichterwerten ha.proxy_node_id: - name: MQTT node id, for the proxy_node_id + name: MQTT-Knoten-ID für die proxy_node_id ha.proxy_unique_id: - name: MQTT unique id, to identify a proxy instance + name: MQTT-eindeutige ID zur Identifizierung einer Proxy-Instanz tsun.host: name: TSUN Cloud Host description: >- - Hostname or IP address of the TSUN cloud. if not set, the addon will try to connect to the cloud default - on logger.talent-monitoring.com + Hostname oder IP-Adresse der TSUN-Cloud. Wenn nicht gesetzt, versucht das Addon, eine Verbindung zur Cloud logger.talent-monitoring.com herzustellen. solarman.host: name: Solarman Cloud Host description: >- - Hostname or IP address of the Solarman cloud. if not set, the addon will try to connect to the cloud default - on iot.talent-monitoring.com + Hostname oder IP-Adresse der Solarman-Cloud. Wenn nicht gesetzt, versucht das Addon, eine Verbindung zur Cloud iot.talent-monitoring.com herzustellen. + gen3plus.at_acl.tsun.allow: + name: TSUN GEN3PLUS ACL allow + description: >- + Liste erlaubter AT-Befehle für TSUN GEN3PLUS + gen3plus.at_acl.tsun.block: + name: TSUN GEN3 ACL block + description: >- + Liste blockierter AT-Befehle für TSUN GEN3PLUS + gen3plus.at_acl.mqtt.allow: + name: MQTT GEN3PLUS ACL allow + description: >- + Liste erlaubter MQTT-Befehle für GEN3PLUS + gen3plus.at_acl.mqtt.block: + name: MQTT GEN3PLUS ACL block + description: >- + Liste blockierter MQTT-Befehle für GEN3PLUS network: - 8127/tcp: x... - 5005/tcp: listening Port for TSUN GEN3 Devices - 10000/tcp: listening Port for TSUN GEN3PLUS Devices + 5005/tcp: listening Port für TSUN GEN3 Wechselrichter + 10000/tcp: listening Port für TSUN GEN3PLUS Wechselrichter diff --git a/ha_addon_rel/translations/en.yaml b/ha_addon_rel/translations/en.yaml index b6025d8..42d01da 100755 --- a/ha_addon_rel/translations/en.yaml +++ b/ha_addon_rel/translations/en.yaml @@ -5,42 +5,37 @@ configuration: description: >+ For each GEN3 inverter, the serial number of the inverter must be mapped to an MQTT definition. To do this, the corresponding configuration block is started with - <16-digit serial number> so that all subsequent parameters are assigned + 16-digit serial number so that all subsequent parameters are assigned to this inverter. Further inverter-specific parameters (e.g. polling mode) can be set in the configuration block The serial numbers of all GEN3 inverters start with `R17` and that of the GEN3PLUS inverters with ‘Y17’ or ‘47’! - - monitor_sn # The GEN3PLUS "Monitoring SN:" - node_id # MQTT replacement for inverters serial number - suggested_area # suggested installation area for home-assistant - modbus_polling # Disable optional MODBUS polling - pv1 # Optional, PV module descr - pv2 # Optional, PV module descr + + For reference see example configuration in Documentation Tab tsun.enabled: name: Connection to TSUN Cloud - for GEN3 inverter only - description: >- - switch on/off connection to the TSUN cloud + description: >+ + switch on/off connection to the TSUN cloud. This connection is only required if you want send data to the TSUN cloud eg. to use the TSUN APPs or receive firmware updates. - on - normal proxy operation - off - The Inverter become isolated from Internet + on => normal proxy operation. + off => The Inverter become isolated from Internet. solarman.enabled: name: Connection to Solarman Cloud - for GEN3PLUS inverter only - description: >- - switch on/off connection to the Solarman cloud + description: >+ + switch on/off connection to the Solarman cloud. This connection is only required if you want send data to the Solarman cloud eg. to use the Solarman APPs or receive firmware updates. - on - normal proxy operation - off - The Inverter become isolated from Internet + on => normal proxy operation. + off => The Inverter become isolated from Internet inverters.allow_all: name: Allow all connections from all inverters description: >- - The proxy only usually accepts connections from known inverters. + The proxy only usually accepts connections from configured inverters. Switch on for test purposes and unknown serial numbers. mqtt.host: name: MQTT Broker Host @@ -71,16 +66,30 @@ configuration: tsun.host: name: TSUN Cloud Host description: >- - Hostname or IP address of the TSUN cloud. if not set, the addon will try to connect to the cloud default + Hostname or IP address of the TSUN cloud. if not set, the addon will try to connect to the cloud on logger.talent-monitoring.com solarman.host: name: Solarman Cloud Host description: >- - Hostname or IP address of the Solarman cloud. if not set, the addon will try to connect to the cloud default + Hostname or IP address of the Solarman cloud. if not set, the addon will try to connect to the cloud on iot.talent-monitoring.com - + gen3plus.at_acl.tsun.allow: + name: TSUN GEN3PLUS ACL allow + description: >- + List of allowed TSUN GEN3PLUS AT commands + gen3plus.at_acl.tsun.block: + name: TSUN GEN3 ACL block + description: >- + List of blocked TSUN GEN3PLUS AT commands + gen3plus.at_acl.mqtt.allow: + name: MQTT GEN3PLUS ACL allow + description: >- + List of allowed MQTT GEN3PLUS commands + gen3plus.at_acl.mqtt.block: + name: MQTT GEN3PLUS ACL block + description: >- + List of blocked MQTT GEN3PLUS commands network: - 8127/tcp: x... 5005/tcp: listening Port for TSUN GEN3 Devices 10000/tcp: listening Port for TSUN GEN3PLUS Devices