How To Use Ecowitt with Home Assistant

Integrating Ecowitt weather stations and sensors with Home Assistant is a fantastic way to bring your local environmental data into your smart home system. In this guide, you’ll learn which Ecowitt models are supported, the pros and cons of the integration, and a straightforward, step‑by‑step setup process.

Supported Ecowitt Devices

Home Assistant’s built‑in Ecowitt integration works with any Ecowitt gateway (the GW series) or display console that supports DIY upload. These include the following:

• All GWxxxx gateways
• HP2550 / HP2560 TFT‑panel consoles
• WS2910, WS2320 and similar solar‑powered stations
• WH5360 and other upload‑capable display stations

Any sensors connected to these (wind, rain, UV, soil moisture, PM2.5, CO₂, lightning, etc.) will appear automatically in Home Assistant.

Why Integrate with Home Assistant

• No cloud dependencies – data stays local
• Centralises smart home devices
• Fast updates (polling down to ~16 s)
• Supports all Ecowitt sensors
• Native Home Assistant entities for use in dashboards and automations

Step-by-Step Guide
Top Tip: I recommend that you document important configuration settings. This will be useful in the future if you need to troubleshoot any issues

1. Add the Ecowitt Integration

1. In Home Assistant, go to Settings → Devices & Services and click Add Integration.
2. Search for “Ecowitt”, select it and click Submit.
3. Copy the server details shown (URL, port, path).

2. Configure Your Ecowitt Device

You can point your Ecowitt station’s DIY upload to Home Assistant either in the mobile app or via the station’s web interface:

Via the Ecowitt App

1. Open the Ecowitt smartphone app and select your station.
2. Tap the menu (⋮) and choose Others → DIY Upload Servers.
3. Add a Custom server: enter your Home Assistant IP, port (usually 8123), and path (e.g. /log/ha), choose “Ecowitt” protocol and set an interval (e.g. 60 s).

Via the Web Interface

1. Open your station’s IP address in a browser and log in (default has no password).
2. Under Customized upload settings, enable DIY upload with the Ecowitt protocol.
3. Enter the Home Assistant details and save.

3. Verify in Home Assistant

1. Go back to Settings → Devices & Services and click the Ecowitt integration.
2. If no devices appear, use the menu (…) to Reload.
3. Your gateway and all connected sensors should show up as entities (e.g. temperature, humidity, wind speed, rainfall, soil moisture, PM2.5, etc.).

4. Build Dashboards & Automations

Use Lovelace cards—such as mini‑graph, gauge and sensor cards, to visualise data. Create automations, for example:

• Close windows when rain sensor > 0 mm
• Start irrigation when soil moisture < 30 %
• Send alerts if PM2.5 exceeds a threshold

Common Issues

• Port Conflicts: If you run the Home Assistant OTBR add‑on, change the Ecowitt upload port to avoid clashes (e.g. use 8090 instead of 8081).
• Integration Breaks: After major HA upgrades, if Ecowitt stops updating, reload the integration or check GitHub for patches.
• Use Core Integration: Remove any old HACS‑based Ecowitt plugins and rely on the built‑in integration (added in HA 2022.9).

Conclusion

Getting Ecowitt smart devices to work in Home Assistant is much easier than you might think, thanks to the Ecowitt core integration.