# Troubleshooting

### Wifi, Registration and Telemetry Issues

<table data-full-width="true"><thead><tr><th>Problem</th><th>Solution</th></tr></thead><tbody><tr><td><strong>Cannot open Pill Captive Portal</strong></td><td>Check that WiFi is active on your mobile device</td></tr><tr><td></td><td>Select <strong>RAPT Pill XXXX</strong> network</td></tr><tr><td></td><td>Enter password '<strong>kegland1</strong>' </td></tr><tr><td></td><td>Plug the Pill into USB-C or place on wireless charger (if using the wireless charging kit)</td></tr><tr><td></td><td>If the green LED is not flashing, unplug the Pill for 20 seconds and plug it back in (or place back on charger)</td></tr><tr><td><strong>Cannot see RAPT Pill XXX in my list of available networks</strong></td><td>Plug the Pill inot USB-C or place on wireless charger (if using the wireless charging kit)</td></tr><tr><td></td><td>If the green LED is not flashing, unplug the Pill for 20 seconds and plug it back in (or place back on charger)</td></tr><tr><td></td><td>If the above do not work, reboot the Pill by removing the battery for 30 seconds, then plugging it back into USB-C</td></tr><tr><td></td><td>If using the wireless charging kit, the Pill Captive Portal cannot be accessed unless the Pill has a minimum charge level. It must be charged for <em>at least</em> 12 hours on first use</td></tr><tr><td>"<strong>Selected Network is not connected to the Internet</strong>" <strong>error</strong></td><td>Select the <strong>RAPT Pill XXX</strong> network and choose "<strong>Forget This Network</strong>"</td></tr><tr><td><strong>Pill does not connect to my WiFi network</strong></td><td>Check that your network is broadcasting a 2.4gHz signal and ensure that the Pil is as close as possible to the router</td></tr><tr><td></td><td>Non alphanumeric characters in the SSID or password can cause issues - change these to simple (letters and numbers <em>only</em>) characters</td></tr><tr><td></td><td>Ensure you are selecting the correct network and inputting the correct password for that network</td></tr><tr><td></td><td>The network <em>must</em> have a password – the Pill cannot connect to an unsecured network</td></tr><tr><td></td><td>The Pill may already be connected. Check the IP (STA) in Diagnostics. If this is populated with an IP address that is not 0.0.0.0 then the Pill is likely already connected</td></tr><tr><td></td><td>Open <strong>Diagnostics</strong> in the Pill Captive Portal and select <strong>Reboot</strong></td></tr><tr><td></td><td>Reboot your modem/WiFi router</td></tr><tr><td></td><td>Reboot the Pill using <strong>Reboot</strong> option in DIagnostics screen in the Captive Portal</td></tr><tr><td></td><td>Try connecting to a different WiFi network</td></tr><tr><td></td><td>Turn off any VPN or anything that can block an outgoing signal on the router</td></tr><tr><td></td><td>If the above do not work, see <a href="#using-phone-as-hotspot">Using Phone as Hotspot</a> below</td></tr><tr><td><strong>Cannot see a Validation Code</strong></td><td>Connect the Pill to your WiFi network</td></tr><tr><td></td><td>Update the Pill firmware - select <strong>Check for new firmware</strong> in the <strong>DIagnostics screen</strong></td></tr><tr><td><strong>Error when Registering Pill</strong></td><td>Check that the Pill Firmware is up to date - select <strong>Check for new firmware</strong> in the <strong>DIagnostics screen</strong></td></tr><tr><td></td><td>The <strong>Validation Code</strong> may have timed out. Reboot the Pill using the <strong>Reboot</strong> option in the <strong>Diagnostics</strong> screen. Log out of the <strong>RAPT Portal</strong> and log back in</td></tr><tr><td></td><td>Ensure the RAPT Portal is open on a device connected to the same network as the Pill. <em>If the Pill Captive Portal is open on the device, it is not connected to the internet and Registration will not work.</em> Open the RAPT Portal on a seperate device such as a laptop or tablet</td></tr><tr><td><strong>Determine whether your RAPT Pill is connected to Wi-Fi</strong></td><td>To check this, plug your RAPT Pill in to power and open the <strong>RAPT Pill Captive Portal</strong> and Navigate to <strong>WiFi</strong>. It will display the network the Pill is currently connected to. You can also check by navigating to <strong>Diagnostics</strong> and checking that it shows your network’s IP address next to <strong>IP (STA)</strong> - in the form 192.168.XX.XXX or similar</td></tr><tr><td><strong>Determine whether your RAPT Pill is registered to the RAPT Portal</strong></td><td>Open the Pill Captive Portal on your mobile device. Navigate to Registration. If the message reads REGISTRATION DONE! then your RAPT Pill has been sucessfully registered. If it is displaying the MAC address and Validation Code then registration has <em>not</em> been sucessful - see <strong>Re-Register my Pill below</strong></td></tr><tr><td><strong>Re-register my RAPT Pill</strong></td><td>Refer to <a href="/pages/VlgYYcAv3Y1nNSduKstk#re-register-your-rapt-pill"><strong>Re-Register My RAPT Pill</strong></a></td></tr><tr><td><strong>Telemetry is only received when the Pill is powered by USB-C</strong></td><td>Ensure you have updated to the current firmware</td></tr><tr><td></td><td>Check that the battery is making good connection with the battery terminals of the Pill’s board. It may be necessary to gently bend these out in order to ensure the battery is making good contact in order to power the Pill when it is not connected to USB-C</td></tr><tr><td><strong>No telemetry displayed  in the RAPT Portal</strong></td><td>Telemetry will take at least 60 minutes to display. If the message <strong>Last Contact: never</strong> is still di[played  in the Pill Status after at least 60 minutes, <a href="/pages/VlgYYcAv3Y1nNSduKstk#re-register-your-rapt-pill"><strong>Re-Register</strong></a> your Pill to correct this</td></tr><tr><td></td><td><strong>Check that the Pill is Registered.</strong> Plug your RAPT Pill in to power and open the RAPT Pill Captive Portal and Navigate to <strong>Registration</strong>. If Registration has been successful this will display the message <strong>REGISTRATION DONE!</strong> If registration was not successful then this will display the MAC Address and Validation Code. <a href="/pages/VlgYYcAv3Y1nNSduKstk#re-register-your-rapt-pill"><strong>Re-Register</strong></a> your Pill to correct this</td></tr><tr><td></td><td><strong>Check that your Pill is connected to WiFi in the Pill Captive Portal</strong>. Plug your RAPT Pill in to power and open the RAPT Pill Captive Portal and Navigate to <strong>Wi-Fi.</strong> Check that it shows that the RAPT Pill is connected to your home Wi-Fi network</td></tr><tr><td></td><td><p><strong>Check that the Pill firmware is up to date</strong>.</p><p>Connect to the Pill Captive Portal and navigate to the Diagnostics screen. Select Check for new firmware. If a more up to date firmware is available this will be downloaded and installed</p></td></tr><tr><td></td><td>Check your signal strength. Please refer to the <a href="#signal-strength">SIgnal Strength Graph below</a>. Signal Strength can be checked in the expanded graph in the RAPT Portal</td></tr><tr><td><strong>Battery % shows 0 or no value</strong></td><td>The battery is not calibrated yet. The battery must be charged completely for the Pill to calibrate the battery charge level. If the battery was fully charged but not calibrated simply let the battery drain (easiest to just use the Pill as intended). Then, recharge the battery fully. This will allow the Pill to register the fully charged battery.  This can happen if it is removed from the charger <em>before</em> the Pill has registered the calibration state</td></tr></tbody></table>

#### Signal Strength

<figure><img src="/files/C5wY2itRjjeQu29Mq8nm" alt=""><figcaption><p>Signal Strength Graph</p></figcaption></figure>

### Using Phone as Hotspot <a href="#using-phone-as-hotspot" id="using-phone-as-hotspot"></a>

If updating the firmware persistently fails or throws an error, and all troubleshooting steps have failed, then try using your mobile phone as a Hotspot to resolve this.

Using the phone as a Hotspot will typically solve firmware update issues of this kind

1: It helps eliminate potential network or modem/router issues which can cause problems that can be hard to isolate and resolve

2: It can help eliminate signal strength or poor WiFi connection issues as the phone can be positioned right next to the RAPT device when in Hotspot mode.

To connect to the phone Hotspot and update the firmware there are a few steps to follow

1. On the phone, turn WiFi **OFF**. When troubleshooting firmware download or network issues, we do not want to use the same network thus the phone must be disconnected from the WiFi network in order to do this
2. Enable **Personal Hotspot** (sometimes just called Hotspot) on your phone. This is typically located under the WiFi or Network menu in the Settings menu of the phone. On IOS this is under **Settings**/**Personal Hotspot**. The menu names will vary on Android depending on device
3. Enable **Maximise Compatibility** (on IOS) or **2.4gHz Network Only** (on Android - again, this will have different names depending on device/OS). This will help minimise issues when connecting
4. Once **Hotspot** is enabled on the device, following the steps in [Getting Started](https://docs.rapt.io/equipment/rapt-can-filler/getting-started) to connect to the phone Hotspot
5. Once connected, navigate to Settings/Check for OTA update on the RAPT Device

### General Troubleshooting

<table data-full-width="true"><thead><tr><th>Problem</th><th>Solution</th></tr></thead><tbody><tr><td><strong>Red (battery) light flashes very rapidly when plugged in to USB-C</strong></td><td>Please install the battery or check that it is making good contact with the terminals</td></tr><tr><td><strong>Lights turn off immediately when disconnected from USB-C</strong></td><td>This is normal. To conserve battery power, the Captive Portal will disconnect as soon as the Pill is unplugged from USB-C</td></tr><tr><td></td><td>To keep the Captive Portal open, you must first open either the <strong>Diagnostics</strong> or the <strong>Calibration</strong> screen of the <strong>Pill Captive Portal</strong> before disconnecting the Pill from USB-C. The Captive Portal will timeout automatically after 10 minutes</td></tr><tr><td></td><td>If the Pill disconnects despite the <strong>Diagnostics</strong> or <strong>Calibra</strong>tion screen being open, please check the charge level of the battery – it may be insufficient to power the Pill. The battery may be faulty, or not making good connection to the terminals. A fully charged battery has around 4.2V – this can be tested with a multimeter</td></tr><tr><td></td><td>If the battery has a good charge level but is not powering the Pill it may be necessary to gently bend the terminals out in order to ensure there is good contact with the battery</td></tr><tr><td><strong>Battery level reads 0% or not displaying in the RAPT Portal</strong></td><td>This indicates that the Pill has not detected a fully charged battery. Note that the battery must be charged in the Pill for this to be detected the first time</td></tr><tr><td></td><td>Ensure the RAPT Pill is successfully registered to your RAPT login (the calibration figure will not work unless the pill is linked with your RAPT account)</td></tr><tr><td></td><td>Discharge the battery by using the RAPT Pill for at least 1-2 weeks or by removing the battery and discharging in a device that uses power faster, then plug the pill into the USB Type C charging cable for 24 hours. This will allow the Pill to register a fully charged battery which enables accurate battery life data to be displayed</td></tr><tr><td><strong>The lights on the Pill stop flashing when it is unplugged</strong></td><td>This is normal. The Pill will be ‘asleep’ by default and will wake briefly at the set interval to send telemetry. The green light will flash when this happens. It may also wake when movement is detected</td></tr><tr><td>G<strong>ravity reading  is not correct</strong></td><td>Check calibration</td></tr><tr><td></td><td>Physical factors can affect accuracy - gently shake the fermenter to dislodge stuck krausen etc</td></tr><tr><td></td><td>Ensure the Pill can float freely and unobstructed</td></tr><tr><td><strong>Temperature is incorrect</strong></td><td>Calibrate temperature</td></tr><tr><td></td><td><a href="/pages/RwGNuIODTWBSXEymTiOA#settings">Calibrate temperature offset</a></td></tr><tr><td></td><td>The temperature reading will typically be high when the Pill is active - for example, plugged in to USB-C, charging or during calibration. This is because the battery generates enough heat to affect the on board thermometer. When in normal use, this is not an issue as the Pill will only be active for a few seconds in order to send telemetry.</td></tr></tbody></table>

### Warranty

The RAPT Pill Hydrometer & Thermometer comes with a 12-month Warranty when sold in Australia.

Warranty does not cover product failure as a result of installation or operating procedure not in accordance with installation and operating guidelines as described in the instruction manual.

To lodge a warranty claim in Australia please forward as many visual pieces of supporting information and a detailed description of your issue to <beer@kegland.com.au>

If you purchased your unit from an international distributor, you will be required to go through their warranty claims process.

For a full terms and conditions, please visit our website: [Terms & Conditions](https://kegland.com.au/pages/terms-and-conditions)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.rapt.io/equipment/rapt-pill-hydrometer-or-user-guide/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.