Compare commits

...

8 Commits
v3.0 ... main

Author SHA1 Message Date
f76a4b60c7 Update deu translation (#265)
Kept some parts of older translations, renewed some,
can check the translation when you have added the headers :-)
2025-08-09 10:45:38 +01:00
24232acfbe Add TLS 1.2 compatibility guidance for Garmin Wi-Fi/LTE connection issues (#266)
This update adds a note to the “Limits of Use” section explaining that
some Garmin devices use TLS 1.2 for HTTPS handshakes. If a server or
proxy enforces a minimum TLS version of 1.3 or higher, users may
experience SSL handshake errors with the message HTTP request returned
error code = 0.

The documentation now includes:

An explanation of the issue

How to identify the error

A practical solution example for Cloudflare Tunneling users to lower the
minimum TLS version to 1.2

A security note advising against lowering TLS below 1.2

This helps users troubleshoot connectivity problems when using Wi-Fi or
LTE features on Garmin watches with Home Assistant.
2025-08-09 10:40:52 +01:00
50eccad4dc docs: clarify TLS 1.2 limitation for Garmin Wi-Fi/LTE connections
Signed-off-by: Ali Alaei <49282631+aalaei@users.noreply.github.com>
2025-08-09 11:33:51 +02:00
8b641f1ee9 docs: add TLS 1.2 compatibility note for Garmin Wi-Fi/LTE connections
Signed-off-by: Ali Alaei <49282631+aalaei@users.noreply.github.com>
2025-08-08 23:46:01 +02:00
fa8ec2ec4d Added all contributors
Signed-off-by: Lars Pöpperl <45465820+tispokes@users.noreply.github.com>
2025-08-08 11:33:51 +02:00
c2f99d71ad Updated German corrections
Signed-off-by: Lars Pöpperl <45465820+tispokes@users.noreply.github.com>
2025-08-08 11:28:32 +02:00
8a8d64bcab Update Wi-Fi.md
Videos only work when they are uploaded to https://github.com/user-attachments/assets/, so that means drag and drop the video into the markdown file rather than reference one already in your source tree.

Signed-off-by: Philip Abbey <philipabbey@users.noreply.github.com>
2025-07-25 18:42:37 +01:00
55bbb4901c Update HISTORY.md
Amended v3.0 change text.

Signed-off-by: Philip Abbey <philipabbey@users.noreply.github.com>
2025-07-25 12:32:27 +01:00
3 changed files with 65 additions and 24 deletions

View File

@ -45,4 +45,4 @@
| 2.30 | <img src="images/Venu2_glance_default.png" width="200" title="Default Glance"/><br/>Extensive re-work of the [Glance](examples/Glance.md) view, including the ability to customise it with a user supplied template. | | 2.30 | <img src="images/Venu2_glance_default.png" width="200" title="Default Glance"/><br/>Extensive re-work of the [Glance](examples/Glance.md) view, including the ability to customise it with a user supplied template. |
| 2.31 | Adding [two new options](./examples/Actions.md#exit-on-tap) to the menu items: 1) The ability to disable a menu item, e.g. temporarily for seasonal changes, 2) The option to exit after a menu item has been select. | | 2.31 | Adding [two new options](./examples/Actions.md#exit-on-tap) to the menu items: 1) The ability to disable a menu item, e.g. temporarily for seasonal changes, 2) The option to exit after a menu item has been select. |
| 2.32 | Bug fix for a breaking change extracting options caused by the need to rearrange function parameters for an [annoying compiler error](https://github.com/house-of-abbey/GarminHomeAssistant/issues/253). | | 2.32 | Bug fix for a breaking change extracting options caused by the need to rearrange function parameters for an [annoying compiler error](https://github.com/house-of-abbey/GarminHomeAssistant/issues/253). |
| 3.0 | First version with the ability to use [Wi-Fi](Wi-Fi.md) instead of Bluetooth but with limited functionality. | | 3.0 | First version with the ability to use [Wi-Fi or LTE](Wi-Fi.md) instead of Bluetooth but with limited functionality, thanks to [@vincentezw](https://github.com/vincentezw). |

View File

@ -16,13 +16,20 @@ With version 3.0 onwards the application now includes the ability to temporarily
4. Remember that you need to be within range of your watch's configured Wi-Fi access point to utilize this functionality. If supported by your device, LTE offers a longer range, but network charges may apply. 4. Remember that you need to be within range of your watch's configured Wi-Fi access point to utilize this functionality. If supported by your device, LTE offers a longer range, but network charges may apply.
5. On some Garmin devices, the HTTPS handshake is performed using **TLS 1.2**. If your server or proxy enforces a higher minimum (e.g., TLS 1.3), you will encounter an SSL handshake error with the message:
```
HTTP request returned error code = 0
```
This limitation only affects **Wi-Fi/LTE connections**. When connected over **Bluetooth**, the watch routes requests through the paired phone, which handles the TLS handshake and supports newer TLS versions (such as 1.3) without issue.
To fix this, lower the minimum TLS setting to allow TLS 1.2. For example, if you are using **Cloudflare Tunneling**, go to:
`SSL/TLS → Edge Certificates → Minimum TLS Version`
and set it to **at most TLS 1.2**. _Reducing below TLS 1.2 is not recommended due to security risks._
## Video ## Video
This video using will hopefully make it obvious how slow it is to use the Wi-Fi option and illustrate the cautionary notes above. This video using will hopefully make it obvious how slow it is to use the Wi-Fi option and illustrate the cautionary notes above.
<video width="100%" controls style="max-width:250px"> https://github.com/user-attachments/assets/269981e9-12dc-44f2-a28f-b8e844b2b2f8
<source src="./images/wi-fi.mp4" type="video/mp4">
</video>
### Please Note ### Please Note

View File

@ -16,35 +16,69 @@
<!-- <!--
Corrections for the German language Corrections for the German language
Korrekturen für die deutsche Sprache Korrekturen für die deutsche Sprache
Contributors:
Someone0nEarth
tarekbecker
moesterheld
tispokes
--> -->
<strings> <strings>
<string id="UnhandledHttpErr">Die HTTP-Anfrage gab folgenden Fehlercode zurück = </string> <string id="ApiFlood">Zu viele API-Aufrufe in kurzer Zeit. Bitte verlangsame deine Anfragen.</string>
<string id="ApiUrlNotFound">URL nicht gefunden. Möglicher Fehler in der API-URL in den Einstellungen.</string>
<string id="ConfigUrlNotFound">URL nicht gefunden. Möglicherweise falsche Konfigurations-URL in den Einstellungen.</string>
<string id="TemplateError">Template konnte nicht gerendert werden</string>
<string id="Available" scope="glance">OK</string> <string id="Available" scope="glance">OK</string>
<string id="Checking" scope="glance">Prüfe...</string>
<string id="Unconfigured" scope="glance">Nicht konfiguriert</string>
<string id="Cached" scope="glance">gecacht</string> <string id="Cached" scope="glance">gecacht</string>
<string id="Checking" scope="glance">Prüfe...</string>
<string id="ConfigUrlNotFound">URL nicht gefunden. Möglicherweise falsche Konfigurations-URL in den Einstellungen.</string>
<string id="GlanceMenu" scope="glance">Menü</string> <string id="GlanceMenu" scope="glance">Menü</string>
<string id="Memory" scope="glance">Speicher</string> <string id="Memory" scope="glance">Speicher</string>
<string id="NoAPIKey" scope="glance">Kein API-Schlüssel in den App-Einstellungen vorhanden.</string>
<string id="NoApiUrl" scope="glance">Keine API-URL in den App-Einstellungen vorhanden.</string>
<string id="NoConfigUrl" scope="glance">Keine Konfigurations-URL in den App-Einstellungen vorhanden.</string>
<!-- Für die Einstellungs-GUI --> <string id="NoJson">Keine JSON-Datei aus der HTTP-Anfrage zurückbekommen.</string>
<string id="NoPhoneNoCache" scope="glance">Keine Telefonverbindung und kein gecachtes Menü.</string>
<string id="NoResponse">Keine Antwort, bitte Internetverbindung prüfen.</string>
<string id="TimedOut">Anfragezeit überschritten.</string>
<string id="PinInputLocked">PIN-Eingabe gesperrt für</string>
<string id="PotentialError">Möglicher Fehler</string>
<string id="TemplateError">Template konnte nicht gerendert werden</string>
<string id="TrailingSlashErr">API-URL darf nicht mit einem Schrägstrich '/' enden.</string>
<string id="UnhandledHttpErr">Die HTTP-Anfrage gab folgenden Fehlercode zurück = </string>
<string id="WebhookFailed">Webhook-Registrierung fehlgeschlagen.</string>
<string id="WrongPin">Falsche PIN.</string>
<string id="WifiLteNotAvailable">Kein WLAN oder LTE verfügbar.</string>
<string id="WifiLtePrompt">Über WLAN/LTE ausführen?</string>
<string id="WifiLteExecutionTitle">Sende an Home Assistant.</string>
<string id="WifiLteExecutionDataError">Keine Daten empfangen.</string>
<!-- Für die Einstellungs-GUI: Reihenfolge entspricht der Nutzung -->
<string id="SettingsSelect">Auswählen...</string>
<string id="SettingsApiKey">API-Schlüssel für HomeAssistant.</string>
<string id="SettingsApiKeyPrompt">Langzeit-Zugangstoken.</string>
<string id="SettingsApiUrl">URL der HomeAssistant-API.</string> <string id="SettingsApiUrl">URL der HomeAssistant-API.</string>
<string id="SettingsConfigUrl">URL der Menükonfiguration (JSON).</string> <string id="SettingsConfigUrl">URL für die Menükonfiguration (JSON).</string>
<string id="SettingsCacheConfig">Soll die Anwendung die Menükonfiguration cachen?</string> <string id="SettingsCacheConfig">Soll die App die Menükonfiguration cachen?</string>
<string id="SettingsClearCache">Soll die Anwendung beim nächsten Start den vorhandenen Cache löschen?</string> <string id="SettingsClearCache">Soll die Anwendung beim nächsten Start den vorhandenen Cache löschen?</string>
<string id="SettingsAppTimeout">Die App wird nach Ablauf der Zeit (in Sekunden) bei Inaktivität beendet, um den Akku <string id="SettingsVibration">Soll die App Rückmeldung per Vibration geben?</string>
des Geräts zu schonen.</string> <string id="SettingsAppTimeout">Timeout in Sekunden. Beendet die App nach dieser Inaktivitätszeit, um Akku zu sparen.</string>
<string id="SettingsConfirmTimeout">Nach dieser Zeit (in Sekunden) wird der Bestätigungsdialog einer Aktion geschlossen und die <string id="SettingsPollDelay">Zusätzliche Abfrageverzögerung (in Sekunden). Fügt zwischen den Status-Updates der Menüeinträge eine Pause ein.</string>
Aktion abgebrochen. Auf 0 setzen, um den Timeout zu deaktivieren.</string> <string id="SettingsConfirmTimeout">Nach dieser Zeit (in Sekunden) wird ein Bestätigungsdialog automatisch geschlossen und die Aktion abgebrochen. Mit 0 deaktivieren.</string>
<string id="SettingsPin">4-stellige PIN für alle Actions mit 'confirm': true (0000-9999).</string> <string id="SettingsPin">4-stellige PIN für alle Aktionen, die eine Bestätigung erfordern (0000-9999).</string>
<string id="SettingsPinError">Bitte eine gültige 4-stellige numerische PIN in den App Einstellungen eingeben (0000-9999).</string> <string id="SettingsPinError">Bitte eine gültige 4-stellige numerische PIN in den App Einstellungen eingeben (0000-9999).</string>
<string id="SettingsWidgetStart">(Nur Widget) Anwendung automatisch über das Widget starten ohne drauftippen zu müssen.</string> <string id="SettingsTextAlign">Menüausrichtung: Links (aus) oder Rechts (ein).</string>
<string id="SettingsEnableBatteryLevel">Hintergrunddienst aktivieren, um den Ladezustand der Batterie an HomeAssistant zu senden.</string>
<string id="SettingsBatteryLevelRefreshRate">Die Aktualisierungsrate (in Minuten) mit der der Ladezustand der Batterie <string id="RightToLeft">Von rechts nach links</string>
an HomeAssistant gesendet wird.</string> <string id="SettingsWidgetStart">(Nur Widget) App automatisch aus dem Widget starten, ohne auf Tippen zu warten.</string>
<string id="WebhookId">(Schreibgeschützt) Die von der Uhr erstellte Webhook-ID für Aktualisierungen des Ladezustands der Batterie. <string id="SettingsEnableBatteryLevel">Hintergrunddienst aktivieren, um Akkustand, Standort und (falls unterstützt) Aktivitätsdaten an Home Assistant zu senden.</string>
Möglicherweise wird dies zum Debuggen benötigt.</string> <string id="SettingsBatteryLevelRefreshRate">Intervall (in Minuten), in dem der Hintergrunddienst die Daten erneut senden soll.</string>
<string id="WebhookId">(Nur lesen) Die vom Gerät erstellte Webhook-ID für Hintergrund-Updates. Kann zum Debuggen benötigt werden.</string>
<string id="WifiLteExecution">Ausführung über WLAN-/LTE einschalten.</string>
<string id="WifiLteExecutionEnable">Befehlsausführung über WLAN/LTE aktivieren.</string>
<string id="WifiLteExecutionDescription">Ermöglicht das Starten der App ohne Telefonverbindung (bei zwischengespeichertem Menü) und fragt, ob der Befehl über WLAN/LTE ausgeführt werden soll.</string>
</strings> </strings>