Electra Smart

The Electra Smart integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] lets you control air conditioners from Electra Air that are registered in the Electra Smart mobile app. Every air conditioner on your Electra account is added to Home Assistant as a climateThe Climate entity allows you to control and monitor HVAC (heating, ventilating, and air conditioning) devices and thermostats. [Learn more] entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more].

Use case

You can use the integration to:

  • Keep a room at a comfortable temperature with an automationAutomations in Home Assistant allow you to automatically respond to things that happen in and around your home. [Learn more] that turns the air conditioner on and off at set times.
  • Turn the air conditioner off when nobody is home, and turn it back on shortly before you return.
  • React to the temperature reported by the unit, for example to switch to a different fan mode when a room gets too warm.

Supported devices

Any air conditioner that can be added to the Electra Smart app is supported. The air conditioner needs to be online in the Electra Smart app for Home Assistant to control it.

Prerequisites

  1. The air conditioner must be added and working in the Electra Smart app.
  2. You need the phone number that is registered to your Electra Smart account. During setup, Electra sends a one-time password to that number by SMS.

Configuration

To add the Electra Smart hub to your Home Assistant instance, use this My button:

Electra Smart can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Electra Smart.

  • Follow the instructions on screen to complete the setup.

Phone number

The phone number you used to register in the Electra Smart app.

One-time password

The code that Electra sends to that phone number by SMS when you start the setup.

Supported functionality

Each air conditioner on your Electra account is added as a climate entityAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more].

Air conditioner

  • HVAC modes: off, heat, cool, dry, fan only, or auto.
  • Target temperature: between 17 °C and 30 °C, in steps of 1 °C.
  • Fan modes: auto, high, medium, or low.
  • Swing: on or off.
  • Preset: Shabat, which corresponds to the Shabat option in the Electra Smart app.
  • Current temperature: the temperature measured by the air conditioner.

Data updates

The integration pollsData polling is the process of querying a device or service at regular intervals to check for updates or retrieve data. By defining a custom polling interval, you can control how frequently your system checks for new data, which can help optimize performance and reduce unnecessary network traffic. [Learn more] the Electra cloud every 30 seconds and uses the settings that are reported there. The air conditioner only reports to the cloud when its network module wakes up, so a change made with the remote control or in the Electra Smart app can take a moment to appear in Home Assistant.

Known limitations

  • The integration controls the air conditioner through the Electra cloud, because the unit does not offer a local API. An internet connection and the vendor’s cloud service are required to control the air conditioner, and control is not possible when either is unavailable.
  • Commands are not confirmed immediately. Because the unit reports to the cloud periodically, Home Assistant can briefly show a state that is slightly behind the actual state of the unit.
  • The integration creates one config entry for your Electra account, and all air conditioners on that account are added automatically. They cannot be added or removed individually.

Troubleshooting

The air conditioner shows as unavailable

Symptom: the climate entity is unavailable

Home Assistant reports the air conditioner as unavailable and the entity cannot be controlled.

Description

Home Assistant has not received an update from the Electra cloud for the unit. This usually means the air conditioner itself is offline: it is powered off at the breaker, it has lost its network connection, or the vendor’s cloud service is temporarily unavailable.

Resolution

  1. Open the Electra Smart app and check whether it can still reach the air conditioner.
  2. If the app cannot reach it either, check the power supply of the unit and its network connection.
  3. If the app can reach the unit but Home Assistant cannot, select Reload from the menu of the integration entry to reconnect.
Setup fails with an invalid one-time password

Symptom: the one-time password is rejected

During setup, the form reports that the phone number or the one-time password is invalid.

Description

The one-time password expires shortly after Electra sends it, and the phone number must be the one registered in the Electra Smart app.

Resolution

  1. Make sure the phone number matches the number registered in the Electra Smart app.
  2. Cancel the current setup and start adding the integration again to request a new one-time password. Enter the new code as soon as it arrives.

Removing the integration

This integration follows standard integration removal.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. Next to the entry you want to remove, select the three dots menu. Then, select Delete.
    • Depending on the integration, the entries are listed under one of the following headings:
      • Devices
      • Hubs
      • Services
      • Integration entries
  3. To confirm, select Delete.
    • Home Assistant also deletes the devices and entities of the entry.
  4. If Home Assistant asks you to restart, restart Home Assistant.
  5. If Home Assistant asks whether to also delete the application credentials, select Remove or Keep.

After removing the integration entry, the air conditioners remain set up in the Electra Smart app and can be added to Home Assistant again at any time.