diff --git a/README.md b/README.md index b07ec7a..8da17e3 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ This integration will listen for data from your station and passes them to respective sensors. It also provides the ability to push data to `Windy API` or `Pocasi Meteo`. -### Ecowitt support is coming in the next major release +### In the next major release, I there will be support for Ecowitt stations as well --- @@ -19,73 +19,7 @@ This integration will listen for data from your station and passes them to respe ## Warning - WSLink APP (applies also for SWS 12500 with firmware >3.0) ---- - -### Integration rename is planned for the next major release - -The current name no longer reflects what the integration does. It was initially developed -primarily for the SWS 12500 station, but it already supports other weather stations as well -(Bresser, Garni and others), and Ecowitt support is on the way — so the current name has -become misleading. The transition will be announced via an update, and I'm also planning to -offer a full data migration from the existing integration to the new one, so you won't lose -any of your historical data. - -- The transition date hasn't been set yet, but it's currently expected to happen within the - next ~2–3 months. At the moment, I'm working on a full refactor and general code cleanup. - Looking further ahead, the goal is to have the integration fully incorporated into Home - Assistant as a native component — meaning it won't need to be installed via HACS but will - become part of the official Home Assistant distribution. - -- I'm also looking for someone who owns an Ecowitt weather station and would be willing to - help with testing the integration for these devices. - ---- - -## Warning — WSLink app (applies also to SWS 12500 with firmware > 3.0) - -Please read the **IMPORTANT** note below. - -For stations that use the WSLink app to set up the station and the WSLink API for resending -data (also SWS 12500 stations manufactured in 2024 or later), you will need to install the -[WSLink SSL proxy add-on](https://github.com/schizza/wslink-addon) into your Home Assistant -— unless you are already running Home Assistant in SSL mode or you have your own SSL proxy -in front of Home Assistant. - ---- - -> [!IMPORTANT] -> The recommendation above does not apply to all stations. As is known by now, some stations -> — even when configured via the `WSLink App` — do not use the `WSLink protocol` to send -> data to custom servers. It can therefore be confusing how to configure your station, and -> for that case I made a simple debugging server (see below). - -## Not Sure How Your Station Sends Data? - -If you are struggling with configuration and don't know which protocol your station uses (`WSLink` or `PWS/WU`), or whether it sends data over SSL or plain HTTP — use our public test server: - -**** - -1. Open the link above and create a new session. -2. Point your weather station to the generated subdomain address. -3. Within a few seconds the server will show you: - - the **protocol** your station is using (`WSLink` or `PWS/WU`) - - whether the request arrived over **SSL** or **non-SSL** - - the full query string, headers, and payload your station sent - -This information tells you exactly how to configure the integration in Home Assistant. - -### Quick Recommendations - -| Station sends via | Protocol | Recommended Setup | -|---|---|--- | -| **plain HTTP** | PWS/WU | Point the station directly at Home Assistant — no proxy needed. Keep `WSLink API` unchecked (disabled). | -| **plain HTTP** | WSLink | Point the station directly at Home Assistant — no proxy needed. Enable `WSLink API` in settings. | -| **HTTPS (SSL)** | PWS/WU | Install the [WSLink Proxy Add-on](https://github.com/schizza/wslink-addon) — it terminates TLS and forwards plain HTTP to Home Assistant. Keep `WSLink API` unchecked (disabled). | -| **HTTPS (SSL)** | WSLink | Install the [WSLink Proxy Add-on](https://github.com/schizza/wslink-addon) — it terminates TLS and forwards plain HTTP to Home Assistant, and enable `WSLink API`. | - -— If the test server shows your station is sending over SSL, you need the [WSLink Proxy Add-on](https://github.com/schizza/wslink-addon). If it sends plain HTTP, you can connect directly. - -Web server repo is reachable here: +For stations that are using WSLink app to setup station and WSLink API for resending data (also SWS 12500 manufactured in 2024 and later). You will need to install [WSLink SSL proxy addon](https://github.com/schizza/wslink-addon) to your Home Assistant if you are not running your Home Assistant instance in SSL mode or you do not have SSL proxy for your Home Assistant. ## Requirements @@ -94,40 +28,21 @@ Web server repo is reachable here: