Skip to content

WiFi Configuration

The WattWächter supports two methods for WiFi setup: Bluetooth (BLE) via the smartphone app or AP mode via the browser.

Method 1: Bluetooth (App)

The recommended method for initial setup.

  1. Check LED — The device must be pulsing blue (BLE active)
  2. Open app — Launch the WattWächter app and select "Add Device"
  3. Select device — The app automatically scans for nearby WattWächter devices
  4. Choose WiFi — The device scans available networks and displays them in the app
  5. Enter password — Enter your WiFi password and confirm
  6. Wait — The device connects. LED turns green on success.

Bluetooth Range

For BLE setup, you should be near the device (max. 5–10 m).

Method 2: AP Mode (Browser)

Fallback method if Bluetooth is not available.

Connect

  1. The device creates its own WiFi network: WattWaechter-XXXX (XXXX = last 4 characters of the MAC address)
  2. Connect to this network (password on the device label)
  3. Open in your browser: http://192.168.4.1

Configure

  1. WiFi scan — Click "Scan Networks". Available networks are displayed sorted by signal strength.
  2. Choose network — Select your home network from the list
  3. Enter password — Enter your WiFi password
  4. Save — Click "Connect"
  5. The device restarts and connects to your WiFi

AP Mode Ends

After a successful connection, the access point is deactivated. The device is then available at http://ww.local.

After Connecting

Once the LED is green, the device is reachable on your network:

  • mDNS: http://ww.local
  • IP address: Shown in the app or your router's admin panel

Test the Connection

curl http://ww.local/api/v1/system/alive

Expected response:

{"alive": true, "version": "1.x.x"}

Changing WiFi Settings

If you want to switch WiFi networks later:

  1. Via API: Send new WiFi credentials via POST to /api/v1/settings
  2. Factory Reset: Hold the reset button for 10 seconds — the device restarts in setup mode
curl -X POST http://ww.local/api/v1/settings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_WRITE_TOKEN" \
  -d '{"wifi": {"primary": {"ssid": "NewNetwork", "password": "password123", "enable": true}}}'

Troubleshooting

Problem Solution
LED stays blue Check WiFi password, ensure router is in range
AP network not visible Power cycle the device, wait 30 seconds
ww.local not reachable mDNS must be supported on your network. Alternatively, look up the IP address in your router.
Connection drops Check WiFi signal strength (RSSI > -75 dBm recommended)