ELCO Remocon.net AppDaemon app to fetch data from the gas boiler system via the Elco Remocon-Net cloud service and push them to home-assistant entities.
The backend application for HomeAssistant is written in a python for AppDaemon. This means it requires a working and running installation of AppDaemon.
The easiest way to install it is through Home Assistant's Supervisor Add-on Store, it will be automatically connected to your Home Assistant Instance.
You will need a way to edit the apps.yaml config file in the Appdaemon folder.
Install Studio Code Server from Home Assistant's Supervisor Add-on Store to easily edit configuration Files on your HomeAssistant Instance.
Any other method to modify your configuration files will also work.
HACS is the Home Assistant Community Store and allows for community integrations and automation to be updated easily from the Home Assistant web user interface. You will be notified of updates, and they can be installed by a click on a button.
With appdaemon 0.15 release, the appdaemon data folder will migrate/move out of the Home Assistant configuration folder into a dedicated folder for this add-on /addon_configs/<guid>_appdaemon/ . You can access add-on configuration folders using SSH, Samba, VSCode, and similar add-ons by accessing the addon_configs folder/share.
If you have this in your appdaemon.yaml file:
secrets: /config/secrets.yamlYou will need to adjust this to:
secrets: /homeassistant/secrets.yamlsee: https://github.com/hassio-addons/addon-appdaemon/pull/290
HACS install the addon inside the previous adddaemon folder not inside the new structure, you will have to manualy move the structure apps/elco-remocon-net-appdaemon folder inside of the /addon_configs/<guid>_appdaemon/ folder see issues #8
I hope this will be soon fixed on HACS
Create a Long Lived Access Tokens for appdaemon, and save it in your /config/secrets.yaml file.
Assing the token to the plugins HASS section in /addon_configs/<guid>_appdaemon/appdaemon.yaml file.
plugins:
HASS:
type: hass
ha_url: http://homeassistant.local:8123
token: !secret appdaemon_tokenEnsure to set a valid ha_url to match your setup.
No additional python packages are required.
To to get ELCO Remocon.net AppDaemon work with HACS, you will need to make sure that you enabled AppDaemon automation in HACS, as these are not enabled by default:
- Click on Configuration on the left menu bar in Home Assistant Web UI
- Select Devices & Services
- Select Integrations
- Find HACS and click on Configure
- In the window that opens, make sure that Enable AppDaemon apps discovery & tracking is checked, or check it and click Submit
AppDaemon discovery and tracking enabled for HACS.
It is required to have a working Elco Remocon-Net installation with a gateway. Base on that you have to find your gateway_id.
The gateway_id is the number you see in the URL when you are logged in to the Elco Remocon-Net cloud service, which you would find at https://www.remocon-net.remotethermo.com
Add the following information in your secrets.yaml file according to your Remocon-Net profile:
remocon_username: <YOUR_EMAIL>
remocon_password: <YOUR_PASSWORD>
remocon_gateway_id: <YOUR_INSTALLATION_NUMBER>
remocon_bearer_token: <REMOCON_LONG_LIVE_TOKEN>The remocon_bearer_token refers to a second long-lived Home Assistant token. Create a new one in your Home Assistant profile page for Remocon app.
Attention: For Apps in the AppDaemon, the secrets.yaml file location is define/configurable in /addon_configs/<guid>_appdaemon/appdaemon.yaml file.
secrets: /homeassistant/secrets.yamlIn this case I share same secrets.yaml file of Home-Assistant instance.
location: /addon_configs/<guid>_appdaemon/apps.yaml
Define your app like the following:
remocon:
module: elco-remocon-net-appdaemon
class: Remocon
plugin: HASS
base_url: https://www.remocon-net.remotethermo.com
username: !secret remocon_username
password: !secret remocon_password
gateway_id: !secret remocon_gateway_id
bearer_token: !secret remocon_bearer_token
# refresh_rate: 60 # optional
#ha_url: # optional, in case hassplugin ha_url undefined| key | optional | type | default | description |
|---|---|---|---|---|
base_url |
False | string | https://www.remocon-net.remotethermo.com | Remocon-net cloud service url |
username |
False | string | Your ELCO username to access remocon-net cloud service, recommended to use secrets. | |
password |
False | string | Your ELCO password to access remocon-net cloud service, recommended to use secrets. | |
gateway_id |
False | string | Your gateway id | |
bearer_token |
False | string | Long-lived Home Assistant token | |
refresh_rate |
True | int | 60 | The crawl rate in minutes |
ha_url |
True | string | HA url for callback | |
zone |
True | int | 1 | Zone number |
ELCO Remocon.net AppDaemonwill initiate a login session on Elco Remocon-Net cloud service base on your provided credential.- On success the AppDaemon will fetch all information of the specified installation provided by the gateway_id
- Last but not least the AppDaemon will push the data to the specified Home Assistant entities.
| sensor | Description | source | Detail |
|---|---|---|---|
| sensor.elco_outside_temperature | Elco Outside Temperature | plantData.outsideTemp | unit_of_measurement: °C |
| sensor.elco_domestic_hot_water_storage_temperature | Elco Domestic Hot Water Storage Temperature | plantData.dhwStorageTemp | unit_of_measurement: °C |
| sensor.elco_domestic_hot_water_temperature | Elco Domestic Hot Water Temperature | plantData.dhwComfortTemp.value | unit_of_measurement: °C |
| sensor.elco_comfort_room_temperature_setpoint | Elco Comfort room Temperature setpoint | zoneData.chComfortTemp.value | unit_of_measurement: °C |
| sensor.elco_reduced_room_temperature_setpoint | Elco Reduced room Temperature setpoint | zoneData.chReducedTemp.value | unit_of_measurement: °C |
| sensor.elco_room_temperature | Elco Room Temperature | zoneData.roomTemp | unit_of_measurement: °C |
| sensor.elco_desired_room_temperature | Elco Desired Room Temperature | zoneData.desiredRoomTemp | unit_of_measurement: °C |
| sensor.elco_room_operation_mode_heating | Elco Room Operation mode heating | zoneData.mode.value | Protection, Automatic, Reduction, Comfort |
| sensor.elco_cool_comfort_room_temperature_setpoint | Elco Cool Comfort room Temperature setpoint | zoneData.coolComfortTemp.value | |
| sensor.elco_cool_reduced_room_temperature_setpoint | Elco Cool Reduced room Temperature setpoint | zoneData.coolReducedTemp.value | |
| binary_sensor.elco_domestic_hot_water_storage_mode | Elco Domestic Hot Water Storage Mode | plantData.dhwMode.value | |
| binary_sensor.elco_domestic_hot_water_storage_temperature_error | Elco Domestic Hot Water Storage Temperature Error | plantData.dhwStorageTempError | |
| binary_sensor.elco_outside_temperature_error | Elco Outside Temperature Error | plantData.outsideTempError | |
| binary_sensor.elco_heatpump_on | Elco HeatPump On | plantData.heatPumpOn | |
| binary_sensor.elco_domestic_hot_water_enabled | Elco Domestic Hot Water Enabled | plantData.dhwEnabled | |
| binary_sensor.elco_has_outside_temperature_probe | Elco has Outside Temperature Probe | plantData.hasOutsideTempProbe | |
| binary_sensor.elco_flame_sensor | Elco Flame sensor | plantData.flameSensor | |
| binary_sensor.elco_has_domestic_hot_water_storage_probe | Elco has Domestic Hot Water Storage Probe | plantData.hasDhwStorageProbe | |
| binary_sensor.elco_room_heating_is_active | Elco Room Heating is Active | zoneData.isHeatingActive | |
| binary_sensor.elco_room_heating_is_request | Elco Room Heating or Cool is Request | zoneData.heatOrCoolRequest | |
| binary_sensor.elco_room_cooling_is_active | Elco Room Cooling is Active | zoneData.isCoolingActive | |
| binary_sensor.elco_room_temperature_error | Elco Room Temperature Error | zoneData.roomTempError |
I build a simple dashboard with the following 3 cards definition
To display the room temperature, the desired temperature, the operation mode and the heating status.
Just copy this yaml code and paste it in Manual card.
type: entities
entities:
- entity: sensor.elco_room_temperature
name: Current room temperature
secondary_info: last-changed
- entity: sensor.elco_desired_room_temperature
name: Desired temperature
secondary_info: last-changed
type: custom:multiple-entity-row
show_state: true
entities:
- entity: sensor.elco_reduced_room_temperature_setpoint
name: Reduced
- entity: sensor.elco_comfort_room_temperature_setpoint
name: Comfort
- entity: sensor.elco_outside_temperature
name: Outside
- entity: sensor.elco_room_operation_mode_heating
name: Operation mode heating
secondary_info: last-updated
- entity: binary_sensor.elco_room_heating_is_active
type: custom:uptime-card
title_template: Heating
hours_to_show: 48
status_adaptive_color: true
alias:
ok: Active
ko: Idle
show:
footer: false
- entity: binary_sensor.elco_room_heating_is_request
type: custom:uptime-card
title_template: Heating
hours_to_show: 48
status_adaptive_color: true
alias:
ok: Request
ko: Idle
show:
footer: false
title: false
icon: false
title: Home
state_color: true
footer:
type: graph
entity: sensor.elco_room_temperature
hours_to_show: 48
detail: 2This card use the custom component multiple-entity-row available on HACS, you need to install before.
To display the domestic hot water temperature, use this yaml code and paste it in Manual card.
type: entities
entities:
- entity: sensor.elco_domestic_hot_water_storage_mode
name: Storage Mode
- entity: binary_sensor.elco_domestic_hot_water_enabled
name: Enabled
secondary_info: none
- entity: sensor.elco_domestic_hot_water_temperature
name: Temperature
secondary_info: none
- entity: sensor.elco_domestic_hot_water_storage_temperature
name: Storage Temperature
secondary_info: last-changed
title: Domestic Hot Water
state_color: true
footer:
type: graph
entity: sensor.elco_domestic_hot_water_storage_temperature
detail: 1And finally to display the boiler status, use this yaml code in Manual card.
type: entities
entities:
- entity: binary_sensor.elco_heatpump_on
name: Heat Pump
- entity: binary_sensor.elco_outside_temperature_error
name: Outside Temperature Error
- entity: binary_sensor.elco_domestic_hot_water_storage_temperature_error
name: Domestic Hot Water Storage Temperature Error
title: THISION S 14.2 Status
state_color: true
footer:
type: graph
entity: sensor.elco_outside_temperature- This appdaemon's app only supports 1 gateway.
- Readonly access, not set point, for the moment.
- No support for Hot Water Heat Pumps
- THISION S boiler
- Altron B boiler