mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-30 06:46:49 +00:00
a31e9e5a3b
Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Co-authored-by: Robert Resch <robert@resch.dev>
69 lines
2.0 KiB
Markdown
69 lines
2.0 KiB
Markdown
---
|
|
title: Refoss
|
|
description: Integrate Refoss devices
|
|
ha_category:
|
|
- Sensor
|
|
- Switch
|
|
ha_release: 2024.1
|
|
ha_codeowners:
|
|
- '@ashionky'
|
|
ha_iot_class: Local Polling
|
|
ha_domain: refoss
|
|
ha_config_flow: true
|
|
ha_platforms:
|
|
- sensor
|
|
- switch
|
|
ha_integration_type: integration
|
|
---
|
|
|
|
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.
|
|
{% include integrations/config_flow.md %}
|
|
|
|
### 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` |
|
|
|
|
### 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.
|