Heliumgate troubleshooting (#508)

* Fix Helium miner antenna diagrams, and add more troubleshooting to the documentation. * Add more troubleshooting, including a video of the LEDs blinking normally.

Author: PetePycom

content/gettingstarted/registration/lora/helium_hotspot_registration.md

@@ -12,6 +12,8 @@ Installing a LoRa Hotspot means you are rewarded in HNT crypto coins as soon as
 * [Assert Location](#assert-location)
 * [Transfer Hotspot](#transfer-hotspot)
 
+# Getting started
+Start by connecting both antenna's to the hotspot.
 > Hint: The Hotspot is delivered with a WiFi and LoRa antenna. Please check the polarity of the connector on the antenna and match it with the correct antenna connector on the Hotspot:
 
 LoRa antenna:
@@ -22,14 +24,20 @@ WiFi antenna:
 
 ![](/gitbook/assets/lorawan/helium/wifi_antenna.png)
 
+Next, connect your device to the included USB-C power supply.
+Initially you will see an internal solid green light inside the case above the power lead. After around 20 seconds this should start to blink.
 
-## Add a Pycom Helium Miner
+Leave the miner booting while you set up your phone: it takes a minute or two to boot, and after this should be ready to be paired.
+
+## Add a Pycom Helium Miner using the app
+The Pycom Helium App allows you to configure the device and once it is up-and-running to reconfigure it. It works in conjunction with the Helium apps to administer your hotspot.
 
 Download and install the Pycom Helium App from the [Apple App Store](https://apps.apple.com/us/app/pycom-helium-app/id1630652083)
 
-For the Android Version, please download the app from [pycom-helium.apk](https://software.pycom.io/downloads/pycom-helium.apk)
+For the Android Version, please download the app from [pycom-helium.apk](https://software.pycom.io/downloads/pycom-helium.apk) and also please set Chrome to be your default browser (it can be set back to the original browser once setup is complete).
 > Hint: Please enable Location & Nearby Devices permissions in app settings.
 
+The app contains step-by-step instructions for getting you up and running. A summary is provided here:
  * Create an account or log in to your existing account
  * Click +Add Hotspot
  * ![](/gitbook/assets/lorawan/helium/helium_reg_1.png)
@@ -45,10 +53,38 @@ For the Android Version, please download the app from [pycom-helium.apk](https:/
 
 > Hint: The Hotspot is periodically checking for updates. It may take 30 minutes for the first firmware update to be downloaded.
 
+
+# Using your hotspot.
+
 ## Assert Location
 
-If you haven't asserted your location during onboarding, you can do this via this option in the app. You can also use the official Helium Hotspot app to assert your location. Please note that only one location assertion is payed by Pycom. If you wish to change your location later, any fees charged by the Helium network are the responsibility of the Hotspot owner!
+If you haven't asserted your location during setup, you can do this at a later date in the app. You can also use the official Helium Hotspot app to assert your location. Please note that only one location assertion is pre-payed by Pycom. If you wish to change your location later, any fees charged by the Helium network are the responsibility of the Hotspot owner!
 
 ## Transfer Hotspot
 
 You can use this option to transfer Hotspot ownership to a different wallet.
+
+# Troubleshooting
+## The app doesn't find my Helium hotspot / can't pair
+This can be caused by a variety of issues. The first step is to look at the LEDs on the side of the case.
+Initially you will see an internal solid green light inside the case above the power lead. After around 20 seconds this should start to blink.
+A video of a normal boot process is [here](/gitbook/assets/lorawan/helium/NormalBootLEDs.mp4)
+
+If this is the case, it is likely your hotspot is working correctly.
+ * On some devices, it may take several rescans before the hotspot shows in the app. Please keep retrying until it shows up.
+ * If it does not start to blink, you may have a board that has vibrated loose. We have discovered a small number of units where the board-to-board connectors that hold the Raspberry Pi module in have vibrated loose in transit.
+ * If you feel confident in such things, it is possible to disassemble the hotspot case and squeeze the Raspberry Pi module so it clicks back in to the header.
+ 
+
+## Hotspot won't connect to my WiFi
+Some users have encountered some issues where the hotspot doesn't connect to a particular WiFi network.
+
+If you're WiFi router has smart setup or similar, please try deactivating it. For BT broadband users, instructions for how to do this are [here]( https://www.bt.com/help/broadband/what-is-smart-setup-on-the-bt-hub--how-can-i-turn-it-on-and-off-)
+
+
+## App crashes when I assert location (Android)
+The pairing process requires that Chrome is the default browser. If you use a different browser, please temporarily make Chrome your default browser then try again.
+
+Some users have reported pressing decline when the app requests location permission this also fixes this error.
+
+