From 2d1940c3a64aabe99a8bc00c6e180df6a3852593 Mon Sep 17 00:00:00 2001 From: ashionky <35916938+ashionky@users.noreply.github.com> Date: Mon, 20 Jan 2025 15:44:17 +0800 Subject: [PATCH] Add known issue introduction (#36821) * refoss doc * refoss doc * refoss * refoss * refoss * refoss * refoss --- source/_integrations/refoss.markdown | 27 +++++++++++++++++++++------ 1 file changed, 21 insertions(+), 6 deletions(-) diff --git a/source/_integrations/refoss.markdown b/source/_integrations/refoss.markdown index 822401849ff..80f4eb10cbe 100644 --- a/source/_integrations/refoss.markdown +++ b/source/_integrations/refoss.markdown @@ -20,11 +20,8 @@ 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. +- Devices need to be connected to the local network first. +- Devices and Home Assistant must be connected to the same network. - The integration will occupy port: 9989. {% include integrations/config_flow.md %} @@ -39,7 +36,7 @@ Integrate Refoss devices into Home Assistant. ### Discover device - - After integrating Refoss, it will start socket broadcast and Home Assistant will automatically discover Refoss devices under the current LAN. +After integrating Refoss, it will start socket broadcast and Home Assistant will automatically discover Refoss devices under the current LAN. ## Entity naming @@ -67,3 +64,21 @@ Examples: ## Reset device Long-press the button on the device to reset it. + +## Troubleshooting + +### No devices found on the network + +If the Refoss device isn't discovered by Home Assistant automatically, follow these steps: +1. Verify that your Refoss device and Home Assistant are on the same network +2. Enable debug logging for the integration: + ```yaml + logger: + logs: + homeassistant.components.refoss: debug + ``` +3. Restart Home Assistant and attempt to add the integration again +4. Check the logs for messages containing "Discovered devices" +5. If no devices are found, verify: + - Network connectivity + - Device firmware version matches the supported versions listed above \ No newline at end of file