← All drivers

Wireless networks

ESPHome

ESPHome devices (ESP32, ESP8266) directly, over their own API with encryption, without MQTT or internet.

What it does

  • The hub finds the devices on the network. Connected from Partner with the device's encryption key.
  • Relays and switches, lights with brightness, colour and colour temperature, shutters with position.
  • Air conditioners and thermostats with mode, temperature and fan, in °C even when the device counts in °F. Fans with speed and oscillation.
  • The device's buttons become scenes. Restart and settings stay out.
  • Sensors with the device's own unit and decimals, contacts, motion, and text sensors.
  • Every command is confirmed by the state the device sends. If the device drops off, the hub reconnects by itself.

Worth knowing

  • Locks, alarms, numbers and selects are not loaded yet.
  • Tested against a simulated device so far, not yet on a real ESPHome device.

Setup guide

Driver: systems.arvio.esphome. Local: it talks to the device directly, over its own API with encryption. It needs no MQTT and no internet.

For ESPHome devices: ESP32 and ESP8266 with relays, lights, shutters, air conditioners, fans, buttons and sensors.

What you need

  • The device on the same network as the hub, its address reserved on the router.
  • api: in the device's YAML, ideally with encryption: key:.
  • The encryption key from the YAML (you see it in ESPHome Builder, in the device's file).

How it connects

If the driver is not in «Προσθήκη συσκευής» (Add device), bring it into the installation first: Marketplace → this driver → «Εισαγωγή σε εγκατάσταση» (Import into installation).

In Partner, open the hub and go to «Συσκευές» → «Προσθήκη συσκευής» → «ESPHome».

  1. Pick the device it found, or type its address.
  2. Paste the encryption key. If the device has no encryption, leave it empty.
  3. Press «Σύνδεση».

When Partner says «Προστέθηκε», press «Ανανέωση» and put the entities in rooms.

What works

  • Relays and switches, lights with brightness, colour and colour temperature, shutters with position.
  • Air conditioners and thermostats with mode, temperature and fan, in °C even when the device counts in °F. Fans with speed and oscillation.
  • The device's buttons become scenes. Restart, «Safe mode» and anything else that is a setting stay out.
  • Sensors with the device's own unit and decimals, contacts, motion, and text sensors.
  • Every command is confirmed by the state the device sends.
  • If the device restarts or drops off, the hub reconnects by itself.
  • An entity you do not want leaves with «Διαγραφή» (delete), and the rest of the device stays.

Limits

  • Locks, alarms, numbers and selects are not loaded yet.
  • A button has no state: «done» means the device took the press.
  • Tested against a simulated device so far, not yet on a real ESPHome device.

If something goes wrong

  • «Έχει κρυπτογράφηση» (it has encryption): the YAML has encryption: key:. Copy it.
  • «Το κλειδί δεν ταιριάζει» (the key does not match): the key changed in the YAML and the device was flashed again. Take the new one.
  • «Δεν έχει κρυπτογράφηση» (no encryption): the device has no encryption:; leave the key empty.
  • «Δεν απαντά» (does not answer): the device is off, on another network, or has no api: in its YAML.