Troubleshooting

Device Not Being Detected by Home Assistant

The ESPHome integration in Home Assistant requires that zeroconf be enabled to automatically detect ESPHome devices on the network. Zeroconf is enabled by default, but may not be enabled if you are not using the default config. Add zeroconf: to your configuration.yaml file to enable zeroconf.

You can also manually add a device to Home Assistant once the device is connected to Wi-Fi on the same network as your Home Assistant server. You will need to figure out the IP address of the device by logging into your router or by using a network scanning app.

From Home Assistant’s Integrations configuration page, press the add integration button (marked 1 in the figure), and then select ESPHome (2). Enter the IP address of the device in the resulting popup (3).

Can’t Connect to Device’s WiFi AP

If you see a device’s WiFi AP being broadcast, but are having trouble connecting, there is another option. Each KAUF device is pre-programmed to try to connect to a WiFi network with the ssid being either initial_ap or initial_ap2, and the password being asdfasdfasdfasdf. Currently, initial_ap2 is more likely to be right. If you set up a temporary WiFi network with those credentials, the plug or bulb will connect to it instead of broadcasting its own AP. Then you can simply determine the IP address of the device, browse to the IP address, and flash a new firmware from there. Either Tasmota or your own build of ESPHome with your local network credentials built in would work.

Not Seeing a Device’s WiFi AP

If you are not seeing a device broadcast a WiFi AP as it should, there are ways to re-enable the Wifi AP that may work. For the bulbs, you have to power cycle the bulb without the bulb connecting to WiFi. Let the bulb power on for at least 10-15 seconds before removing power. After powering up a second time, the WiFi AP will be re-enabled. For the plug, hold down the button for at least 5 seconds and the plug will reboot with the WiFi AP enabled.

If the device is connecting to your local WiFi network, then the above procedures will not work. You will need to clear the existing credentials by toggling the “Clear WiFi Credentials” switch. This can be done by browsing to the device’s IP address in a web browser.

Captive Portal not Showing SSID and Password Fields

When you are connected to a KAUF product’s WiFi AP, you should be able to access a captive portal web page with fields to enter your local network’s WiFi SSID and Password. In some cases, typically if there are an extreme number of networks found, the page may not fully load and the fields to enter your credentials won’t be displayed. The following URL can be used to configure WiFi credentials if you are connected to the KAUF WiFi AP but the captive portal web page is not loading properly. Replace YOUR_SSID with your local network’s WiFi SSID and replace YOUR_PASSWORD with your local network’s WiFi password.

http://192.168.4.1/wifisave?ssid=YOUR_SSID&psk=YOUR_PASSWORD

To configure credentials from a Linux command line, use the curl command like so: curl ‘http://192.168.4.1/wifisave?ssid=YOUR_SSID&psk=YOUR_PASSWORD’

Smart Plug Glitches when Wi-Fi is Lost

ESPHome currently crashes every time its access point is enabled and the normal Wi-Fi connection becomes available. This creates the potential for our version 1.5 firmware that the KAUF Smart Plug could turn off power momentarily to whatever is plugged in if your home Wi-Fi goes out and then comes back. Please update to the latest firmware version using the bin file downloadable at our PLF10 page.

Light Bulb Dimming is Choppy at Low Brightness

Choppy dimming at low brightness has been addressed in the v1.6 update for the bulbs. The issue was a combination of (1) the sigmoid function used to fade lights in ESPHome going too close to zero too quickly, and (2) ESPHome using an older version of the Arduino ESP8266 core with poor PWM logic. The v1.6 firmware update addresses point 1 by adopting Tasmota’s gamma table for fades and addresses point 2 by using a newer version of the Arduino core with updated PWM logic. Please update to the latest firmware version using the bin file downloadable at our RGBWW bulb page.