diff --git a/source/_integrations/refoss.markdown b/source/_integrations/refoss.markdown new file mode 100644 index 00000000000..50e423f9e96 --- /dev/null +++ b/source/_integrations/refoss.markdown @@ -0,0 +1,59 @@ +--- +title: Refoss +description: Integrate Refoss devices +ha_category: + - Switch +ha_release: 2024.1 +ha_codeowners: + - '@ashionky' +ha_iot_class: Local Polling +ha_domain: refoss +featured: true +ha_config_flow: true +ha_platforms: + - 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 %} + +### 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. \ No newline at end of file