diff --git a/TroubleShooting.md b/TroubleShooting.md index 9d3f8ee..251189d 100644 --- a/TroubleShooting.md +++ b/TroubleShooting.md @@ -117,6 +117,7 @@ pause #### API: On-line There's an online way of testing the API URL too, thanks to [REQBIN](https://reqbin.com/post-online). This has less setup and it can be saved if you log into the web site. Please note two things: + 1. The URL entere below must include a trailing '/' unlike the URL entered into the watch settings. 2. The service imposes a limit on the number requests you can submit without a subscription, so click with purpose! NB. Changing browser buys you a few more clicks. @@ -125,13 +126,10 @@ There's an online way of testing the API URL too, thanks to [REQBIN](https://req #### SSL Certificate Chain With thanks to [@ziceva](https://github.com/ziceva) for solving this problem. The symptoms are: + 1. Using an API URL with SSL (HTTPS), the [web-based editor](https://house-of-abbey.github.io/GarminHomeAssistant/web/) running in a browser on the same phone running Garmin Connect works well. 2. The exact same configuration is set in the Garmin HomeAssistant application. -3. The Garmin HomeAssistant application reports: -``` -API: not available -Menu: not available -``` +3. The Garmin HomeAssistant application reports neither the API nor the menu are available. **Solution: Make sure you use a _full chain_ certificate in your HTTPS proxy as some watches might be unable to validate the site certificate alone.** @@ -147,7 +145,6 @@ To verify if you have this issue you can use a tool like [SSL Shoppers's SSL Che  - ### Top Problems 1. Failure to copy & paste keys and URLs leading to minor and hard to see errors in strings, even with protestations they are the same! (No they weren't...) @@ -158,17 +155,11 @@ To verify if you have this issue you can use a tool like [SSL Shoppers's SSL Che The [editor](https://house-of-abbey.github.io/GarminHomeAssistant/web/) provides the following functions: 1. Syntax highlighting - 2. Schema checking -  - 3. Entity name completion -  - 4. Rendering previews, to aid HA 'template' creation -   @@ -185,6 +176,7 @@ On (1) you will initially be presented with the following message. Please do not