Commissioning ESPhome sensors

Set up, connect, maintain: everything about the Eco sensors at a glance

Set up

Connect

Maintenance & help

All sensors of the Eco series are based on the open-source ESPhome firmware, configured accordingly to be compatible with our service. This guide therefore applies equally to all of these sensors. What applies only to a specific device is in the respective device documentation (see Device documentation).

After unpacking a sensor, proceed as follows:

  1. Set up WiFi – the sensor logs in to your network
  2. Open the web interface – view readings and identify the sensor
  3. Set the access password – protects the web interface and the firmware update (EcoMBR1)
  4. Register the sensor – so that the data appears in your dashboard
  5. Update the firmware – even when the sensor has long been at its place of use

After that you can integrate the sensor into other systems if needed (Home Assistant, REST API). If something does not work, Troubleshooting helps.

Register the sensor

For the readings of your sensor to appear in your dashboard, it has to be assigned to your account once. For this you need the EcoSensor ID (eco…-<ID>) from the hot spot or the web interface and, on newer sensors (e.g. EcoMBR1), also the Pairing Code from the web interface, EcoSensor group. With the code the cloud sets up the sensor's own access; until it is registered it sends no values to the cloud. How registration works is described in the documentation Register a device.

Device documentation

The following pages contain everything that applies only to the respective device – e.g. connection, compatibility, technical data and special features of the firmware update via USB:

  • EcoPVGX – for Growatt inverters
  • EcoMBR1 – for ModBus RTU devices
  • EcoSPM – for Shelly PM Mini Gen3