elco-remocon-net-appdaemon

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.

Installation

Installing AppDaemon

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.

(Optional) Installing Studio Code Server

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.

Installing HomeAssistant Community Store

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.

Installing AppDaemon Backend Application

Configuration

⚠️ appdaemon location changed

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.yaml

You will need to adjust this to:

secrets: /homeassistant/secrets.yaml

see: https://github.com/hassio-addons/addon-appdaemon/pull/290

⚠️ HACS didn't yet install the addons in /addon_configs/ folder

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

Long Lived Token

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_token

Ensure to set a valid ha_url to match your setup.

AppDaemon's python packages pre-requisites

No additional python packages are required.

HACS configuration

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.

Remocon-Net configuration

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

secrets.yaml

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.yaml

In this case I share same secrets.yaml file of Home-Assistant instance.

apps.yaml

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

Usage

• ELCO Remocon.net AppDaemon will 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.

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

Home Assistant dashboard

I build a simple dashboard with the following 3 cards definition

Room temperature

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: 2

This card use the custom component multiple-entity-row available on HACS, you need to install before.

Domestic hot water

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: 1

Boiler status

And 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

Limitations

• This appdaemon's app only supports 1 gateway.
• Readonly access, not set point, for the moment.
• No support for Hot Water Heat Pumps

Tested system

• THISION S boiler
• Altron B boiler

License

MIT