# Get Started!

### Setup and Registration

{% embed url="<https://youtu.be/zV_hRTh9HpE>" %}
RAPT Pill Captive Portal % Registration
{% endembed %}

### Register Your Pill Hydrometer

<mark style="color:red;">**Ensure you have updated the firmware on your device before attempting to register**</mark>

<mark style="color:red;">**In order to use your RAPT Pill Hydrometer, it must be connected to your WiFI network and registered to the RAPT Portal**</mark>

If your Pill is assembled, charged and ready to go, then you just need to connect it to WiFI and Register your Pill to the RAPT Portal. If it is not ready to go, please refer to [Setup & Assembly](#setup-and-assembly)

### **Connect your Pill Hydrometer to your WiFi network**

* Plug your Pill Hydrometer into power using using a USB-C cable (not included).
* **OR** (**Wireless Charging ONLY)** Place the Pill on the Wireless Charging base. Note. The battery needs to have sufficient charge to broadcast the Captive Portal when wireless charging is used.
* On your smart phone or tablet, open your **Wi-Fi settings** and connect to the **RAPT Pill XXX** network using the password **kegland1**
* Once your smart phone or device is connected to the Pill network, the **Pill Captive Portal** will open automatically.
* Select your WiFi network from the list of available networks, and enter the WiFi password for your network then select **Join**. This will connect your Pill Hydrometer to your WiFi network.
* Once the Pill is sucessfully connected to your WiFi Network, navigate to the Diagnostics screen in the Pill Captive Portal. Select **Check for new firmware**. If a newer firmware is available, this will be downloaded and installed.

### **Register your Pill Hydrometer to your Account on the RAPT Portal**

* Once your Pill Hydrometer is connected to your Wi-Fi network and the firmware is up to date navigate to the **Registration** screen in the Pill Captive Portal.
* A **Mac Address** and **Validation Code** will be displayed in the Pill Captive Portal. Write both of these down or ensure that your smart phone screen stays on so that you can acess this information. You will need to enter the MAC address and Validation Code on the RAPT Portal to register your device.
* Log in to the RAPT Portal (<https://app.rapt.io/>) on a device that is *connected to the same Wi-Fi network* as the Pill Hydrometer you are registering.
* In the RAPT Portal select the <img src="/files/xtgVBmEgTKDxMGw28LeA" alt="" data-size="line"> button from the menu. Select **Pill Hydrometer** from the drop down. Select **Next** after ensuring that your Pill Hydrometer is connected to your WiFi network as above.
* Enter the **MAC address** (this will default to All Caps - that is normal) and **Validation Code** when prompted in the required fields, then select **Next**.
* You will be prompted to enter a name for your Pill Hydrometer. This is to identify the device in the RAPT Portal, and does not have any functional effect. Input the desired name and select **Finish**
* Check the **Registration** screen in the **Pill Captive Portal**. This should now display the following message: **REGISTRATION DONE!**
* If this is still showing the MAC address and Validation Code then registration was unsuccesful. Please re-register your Pill using the instuctions below. If that fails, please refer to [**troubleshooting**](https://app.gitbook.com/o/wlVNEjFt3UiW0iKxpA2G/s/UqN4sW0x2s4yh6iiT8NN/~/changes/90/equipment/rapt-pill-hydrometer/troubleshoot-pill-hydrometer)
* **Congratulations! Your RAPT Pill Hydrometer is connected to WiFi and registered to your RAPT Portal. You can now access telemetry through the RAPT Portal.**

### **Re-Register your RAPT Pill**

If, after troubleshooting, your RAPT Pill is visible in the RAPT Portal but not registered or sending telemetry after at least 60 minutes have elapsed, open the **Pill Captive Portal** to check **Registration** status.

* 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 *not* been sucessful.

To re-register your RAPT Pill **do not delete** the device from the RAPT Portal, instead follow the steps below.

* Connect the Pill via USB-C cable. Open the **Pill Captive Porta**l on your smart phone or tablet.
* Navigate to the **Registration** tab in the  Pill Captive Portal. Click the Clear Registration button, and wait a couple of seconds for a new Validation Code to be generated. **Note: If there is no Clear Registration option then the Pill has not been registered to the RAPT Portal and this step can be skipped.**
* On a **separate device that is connected to your WiFi network**, open and sign in to the [RAPT Portal](https://app.rapt.io/)
* Click on the <img src="/files/I4Eb5O1qPMMW7WlzhG4h" alt="" data-size="line"> **Edit** button of the RAPT Pill that you wish to re-register.
* Go to the **Troubleshooting** tab.
* Click the **Reset Device Authentication** button.
* When prompted, enter the new **Validation Code** that was generated and click **Save**. Your RAPT Pill should now be registered successfully.

### Setup & Assembly

A guide to assembling and charging your new RAPT Pill Hydrometer and Thermometer

### <mark style="color:red;">WARNING</mark> <a href="#warning" id="warning"></a>

* Fully Charge the Li-ion battery after installation before first time use by plugging a USB-C cable into the USB-C charging port on the circuit board until the RED charging LED turns off. This allows the device to calibrate and correctly determine the remaining battery charge. The initial charging period is typically around 24 hours.
* Incorrect battery orientation can damage the circuit board.
* Always leak test your RAPT Pill by submerging in water prior to sanitising and dropping in your fermenter
* Only use KegLand approved cleaners such as [StellarOxy](https://www.kegland.com.au/stellaroxy-100-sodium-percarbonate.html) and [StellarClean ](https://www.kegland.com.au/stellarclean-pbw-powerful-brewing-wash-brewery-cleaner-beer-line-cleaner-keg-wash.html)and sanitisers such as [StellarSan ](https://www.kegland.com.au/phosphoric-acid-blend-sanitiser-500ml-starsan.html)or [Phosphoric Acid](https://www.kegland.com.au/pure-phosphoric-acid-85-pure-500ml.html).

### Battery Installation <a href="#battery-installation" id="battery-installation"></a>

The battery will come pre-installed in the RAPT Pill with a non-conductive strip on each terminal to prevent the device from being activated during transit.

Before plugging the device into power, **you will need to remove the battery and remove the two non-conductive strips from the terminals**. Then reinstall the battery making sure you follow the (+) and (-) inscriptions on the battery and battery housing to ensure you install the battery in the correct orientation.

### <mark style="color:red;">**BEFORE CHARGING**</mark>

* <mark style="color:red;">**REMOVE BATTERY**</mark>
* <mark style="color:red;">**REMOVE BLUE NON-CONDUCTIVE STRIPS**</mark>
* <mark style="color:red;">**RE-INSERT BATTERY (ENSURE CORRECT ORIENTATION)**</mark>

<figure><img src="/files/4Qg4WfBNOGmh19L28wQF" alt=""><figcaption><p>Remove blue tabs <strong>before</strong> charging!</p></figcaption></figure>

Only use KegLand approved 18650 rechargeable Lithium-ion batteries ([KL26734](https://kegland.com.au/products/rapt-pill-replacement-lithium-ion-rechargeable-battery-3200mah-18650-3-60v?_pos=1&_psq=KL26734&_ss=e&_v=1.0)). If non-approved batteries are used the device will require calibration.

<figure><img src="/files/Bm5GP8UoIFcGjFTDOxST" alt=""><figcaption><p>Battery Terminals</p></figcaption></figure>

<figure><img src="/files/MM5LTvcTC5Biqmb9BjPQ" alt=""><figcaption><p>Correct battery polarity in terminals</p></figcaption></figure>

Once installed ensure your battery has good contact with the terminals. After installing the battery rotate it slightly within the battery holder to ensure it has good contact.

Important: Once you have installed the Li-ion battery in the correct orientation FULLY charge the battery before first time use by plugging a USB-C Cable into the USB-C Charging port on the circuit board (USB-C cable NOT included).

**Leave the USB-C Cable plugged in for at least 24 hours.**

### **Assembly** <a href="#assembly" id="assembly"></a>

When installing the circuit board into the housing it is important to insert the circuit board in the correct orientation to ensure the correct weight distribution for accurate readings. The yellow end of the circuit board should be inserted into the yellow housing as shown below.

<figure><img src="/files/cPnhbszSYFvbgjDkBTjC" alt=""><figcaption><p>Correct circuit board orientation</p></figcaption></figure>

Once the circuit board has been inserted into the yellow housing, screw the two housings together hand-tight until both o-rings are hidden to ensure formation of a hermetic seal.

<figure><img src="/files/QSdHp9cktPpShxB1UbSe" alt=""><figcaption><p>Both O-rings sealing on face of coloured housing</p></figcaption></figure>

The housing is typically quite tight, especially when the housing is brand new. A dab of food grade lube on the threads can make the Pill easier to to assemble.

### LED Indicators <a href="#led-indicators" id="led-indicators"></a>

The RAPT Pill features two onboard LEDs Charging LED (RED)

* Solid Red when plugged into USB-C – Charging
* No Red Light when plugged into USB-C – Fully charged
* Red Light flashing rapidly – battery not inserted/inserted incorrectly

ESP LED (GREEN) When not connected to USB-C

* Solid green: will pulse green briefly when sending telemetry/movement detected

ESP LED (GREEN) When connected to USB-C or charging on the Wireless Charger (sold seperately)

* Slow green flashes (approx. one every 1.6 seconds): Searching for WiFi network
* Faster green flashes (approx. 3.2 per second): Connected to WiFi
* Rapid Green Flashes: Movement detected


---

# 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/get-started.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.
