ELCO Remocon-net 2 MQTT

Two way's to get data from your Elco Remocon-Net boiler system, published on MQTT broker and display on a Home Assistant dashboard.

The Repo is now DEPRECATED in favor of the ELCO Remocon.net AppDaemon app

Description

I initially wrote a python script to get data from my boiler system and forward then to a MQTT broker. Than I found a easy way to install, debug and share with Home-Assistant community via a node-RED flow.

Setup

I recommend to use the Node-RED way.

node-RED way's

First you have to install Node-RED Community Add-on for Home Assistant.

You can also install node-RED on a standalone server, if you prefer.

Node-RED requirements

The flow use the node credentials.

Install node-red-contrib-credentials before import the flow.

On Install tab, search for node-red-contrib-credentials module and install it.

Node-RED flow

Then import the flow.json file.

Node-RED configuration

You have to configure the Elco Remocon-Net credentials.

You also need to know your gatewayId.

The easy way to get the gatewayId is to login to the Elco Remocon-Net webapp.

After login, you will see the gatewayId in the URL. For example FFEEBBAA0011: https://www.remocon-net.remotethermo.com/R2/Plant/Index/FFEEBBAA0011?navMenuItem=0&breadcrumbPath=0

With the gatewayId, you can now configure the Remocon Auth node.

Set the your gatewayId, your username and password, click Ok and deploy the flow.

If everything correctly configured, you will see the boiler data in the debug tab.

Ensure that the MQTT broker is running and the MQTT node is configured for Home-Assistant.

Python way's

This Python script gets the data from the gas boiler system via the Elco Remocon-Net cloud service.

The data will be published via MQTT.

You can use this script on a standalone server, I never try it directly Home Assistant server.

Requirements

Install Python3 requirements

pip3 install -r requirements.txt

Configuration

Rename or copy default.example to default.cfg and adapt it to your configuration

python3 ./remocon2mqtt.py

It not a service but just a script, you have to schedule it via a crontab for instance.

Home Assistant side

No auto-discovery in home-assistant for the moment. You have to create manually your MQTT entities.

In your configuration.yaml add a packages merge dir named packages

homeassistant:
  packages: !include_dir_named packages 

Create in your config folder a sub-folder named packages

add the remocon.yaml file inside.

At the end you will have this structure:

packages/remocon.yaml
configuration.yaml

For more details about package usage check the Packages folder documentation in Home Assistant.

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 the 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, just copy the 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, just copy the yaml code and paste it 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

Limitation

I'ts a readonly integration, we can't modify set-point or any parameters on the boiler, just read.

License

MIT