2024.11.0
Home ▸ Integrations ▸

Refoss

Integrate Refoss devices into Home Assistant.

Prerequisites

  • The device needs to be connected to the local network first. There are two ways to connect devices to the local network:
    • Using the Refoss app (download and install the Refoss app on Google Play) to connect devices to the local network.
    • Using the Web page to connect devices to the local network.
      • The computer/mobile phone is connected to the device factory Wi-Fi.
      • In the browser, access the address 10.10.10.1, then select the local Wi-Fi needed for device configuration.
  • The integration will occupy port: 9989.

Configuration

To add the Refoss integration to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

Supported device models

Model Version
Refoss Smart Wi-Fi Switch, R10 all
Refoss Smart Wi-Fi Switch, R20 all
Refoss Smart Energy Monitor, EM06 v2.3.8 and above
Refoss Smart Energy Monitor, EM16 v3.1.7 and above

Discover device

  • After integrating Refoss, it will start socket broadcast and Home Assistant will automatically discover Refoss devices under the current LAN.

Entity naming

The integration uses the following strategy to name its entities:

  • The entity name will be generated by Device Name and Channel Number.

Single channel device.

Examples:

Device Name Channel Number Entity Name
r10 0 r10

Multi-channel device.

Examples:

Device Name Channel Number Entity Name
r10 0 r10
r10 1 r10-1

Reset device

Long-press the button on the device to reset it.