KegLand KL20596 RAPT Pill Hydrometer and Thermometer Instruction Manual

KegLand KL20596 RAPT Pill Hydrometer and Thermometer Instruction Manual

RAPT PILL
Hydrometer & Thermometer
KL20596

KegLand Distribution PTY LTD
www.kegland.com.au

Watch our helpful instructional YouTube Videos
Video instructions now available. The KegLand YouTube Channel (https://www.youtube.com/KegLand). You can find the link on our website www.KegLand.com.au

If there is any part of these videos above that you do not understand or you cannot access please call or email www.KegLand.com.au or your nearest KegLand Distributor for more assistance.

Warning

• 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.
• 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 and StellarClean and sanitisers such as StellarSan or Phosphoric Acid.

Battery Installation

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.

Only use KegLand approved 18650 rechargeable Lithium-ion batteries (KL26734). If non-approved batteries are used the device will require calibration.

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.

LED Indicators

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

• Solid Red when plugged into USB-C – Charging
• Light Off when plugged into USB-C – Fully Charged
• Very rapid flashes: Battery not installed 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
• Slow green flashes (approx. one per second): Searching for WiFi network
• Faster green flashes (approx. 2 per second): Connected to WiFi
• Rapid Green Flashes: Movement detected

Registering your Device

1. Sign up for a RAPT account
To utilise the Wi-Fi connectivity of the RAPT Pill you will need to sign up for an account on the RAPT portal. This will allow you to track and monitor your specific gravity and fermentation temperature in real time.

1. Sign up for an account on the RAPT portal.
2. Once signed up log in to your account on the RAPT portal.

2. Connect your smart phone or tablet to the RAPT Pills Wi-Fi Network

1. Plug your Rapt Pill into a charger or computer with a USB-C cable (not included).
2. On your smart phone or tablet, open your Wi-Fi settings and connect to the “RAPT Pill XXXX” Wi-Fi network using the password “kegland1”.

3. Open the RAPT Pill Captive Portal

1. Once you have connected your smart phone or tablet to your RAPT Pills Wi-Fi network you will need to open the RAPT Pill Captive Portal.
2. Your smart phone or tablet should provide a prompt to sign into the network of your RAPT Pill when you connect to its Wi-Fi Network. Clicking on this prompt will open the RAPT Pill Captive Portal.

If you are not prompted to sign into the network of your RAPT Pill by your smart phone or tablet then open your Wi-Fi settings and select the “RAPT Pill XXXX” Wi-Fi network again to open the Pill Captive Portal.

TIP: Once you have opened the RAPT Pill Captive Portal navigate to Diagnostics and write down the IP (AP). This is the IP address of your RAPT Pill and can be input into your web browser to quickly connect the RAPT Pill Captive Portal when plugged into power.

Once you have connected to your RAPT Pill’s Wi-Fi network and opened the Pill Captive Portal you will still need to connect your RAPT Pill to your home Wi- Fi network and register the device to your RAPT account before the RAPT Pill will send any telemetry.

4. Connect the RAPT Pill to your home Wi-Fi network

1. Select your home Wi-Fi network in the RAPT Pill captive portal, enter your Wi-Fi password and select Join. This will connect your Pill to your Wi-Fi network.
   NOTE: The RAPT Pill cannot connect to 5GHz networks so if you have a dual band router make sure you are connecting to the 2.4GHz network.

2. Once you have joined, click on the Registration link to see your MAC address and User Code. Write both of these down or copy them on your device. You will need to enter the MAC address and User Code to register your Pill on your RAPT account.

5. Register your RAPT Pill to your account on the RAPT Cloud

1. Ensure your RAPT Pill is connected to your Wi-Fi (above). Note – if you click on your Wi-Fi network, you can note the IP address of the Pill. This can be used to access the Pill AP in a browser.
2. Ensure you are logged in to the RAPT Portal (https://app.rapt.io) on a second device that is connected to the same home Wi-Fi network as the Pill you are registering.
3. In the RAPT Portal select Add New Device. Select Pill (Digital Hydrometer) from the drop down. Select Next and enter the MAC address and Validation Code when prompted in the required fields, then select Next.
4. Congratulations! Your RAPT Pill is connected to Wi-Fi and registered to your RAPT Portal.

RAPT Pill Captive Portal

The Rapt Pill Captive Portal can only be accessed when the RAPT Pill is plugged in to USB-C. You can access the Captive Portal in two ways. You can connect directly to the Pill’s WiFi using a phone, tablet or computer. Simply connect to the Pill’s WiFi network (the network name will be in the form RAPT Pill XXXX where the last 4 digits correspond to the last digits of the Pill’s MAC address).

Alternatively, once the Pill has been connected to your WiFi network, you can access the Captive Portal by entering the Pill’s IP address on a browser. The IP address can be found in the Diagnostics screen of the Captive Portal.

Note: The Pill Captive Portal will close automatically after 10 minutes. This is by design to maximise battery life.

There are five options available in the Captive Portal.

WiFi
This screen is where we select and connect to the desired user WiFi network when first setting up the Pill. Once connected, this screen displays the network that the Pill is connected to, as well as a list of available WiFi networks.

Note: The RAPT Pill can only store one network at a time. Should you need to connect it to a different network, this must be done manually through this screen.

Registration
When the Pill is first set up, this is where you navigate in order to see the MAC Address and Validation Code to register. Once registered, you can elect to Clear Registration in this screen. This should not be necessary in normal use.

Settings
The Settings tab enables you to select the Telemetry method. You can toggle between WiFi and Bluetooth. WiFi telemetry is the default option. Bluetooth should only be selected if you have a suitable Bluetooth enabled RAPT device such as a RAPT Fermentation Chamber or a RAPT Temperature Controller. Bluetooth will only work within the RAPT ecosystem.

Note: Bluetooth requires a compatible RAPT device such as a Fermentation Chamber or Temperature Controller. Bluetooth will not broadcast unless the RAPT Pill is first registered to the RAPT Portal using WiFi.

The Telemetry Interval can be set in this screen. The default telemetry interval for WiFi is 60 minutes (recommended) or 1 minute (recommended) for Bluetooth. Setting shorter telemetry intervals will impact battery life negatively.

The minimum telemetry interval for WiFi is 15 minutes.

The maximum recommended telemetry interval for Bluetooth is 1 minute. Note: The default Sensor Timeout for RAPT Fermentation Chambers and Temperature Controllers is 130 seconds, thus it is important for Bluetooth operation that the telemetry interval is less than this.

The Set Temperature Offset option allows to to calibrate your RAPT Pill against a known, calibrated thermometer. Note: During calibration the displayed temperature will generally be higher than actual, as the battery will be in use and thus affecting the board temperature. For temperature calibration we recommend comparing against a calibrated thermometer during normal use. Use of the temperature offset will not be needed in most cases.

Diagnostics
The diagnostics screen shows real time telemetry from the RAPT Pill, including temperature, accelerometer values, angle etc. The current firmware can be checked in this screen.

The Telemetry Sent information can be useful when troubleshooting. Telemetry sent is presented in the form X/Y, where X is Telemetry received (by the RAPT device over Bluetooth, or the RAPT Portal over WiFi) and Y is Telemetry sent. Thus, in normal operation these values should be the same. If there is no Telemetry received (thus a value such as 0/18) then this is a good indicator that there is potentially a network or registration issue.

From the Diagnostics screen you can manually:

Send Telemetry now: this will manually send a telemetry packet to the RAPT cloud or to a Bluetooth enabled RAPT device

Check for new firmware: This will manually check for updated firmware and allow you to force an update if a firmware update is available.

Send diagnostics log. This will manually send a diagnostics log. This is not required unless requested by KegLand.

Reboot device: This will reboot the Pill. This can be helpful in the event of network issues

Factory reset: This will restore the device to factory settings. This will remove all calibration, WiFi settings and registration.

Calibration
The Calibration allows you to calibrate the Pill using the Standard, Advanced or Custom calibration methods. Standard is recommended for most users. Advanced is recommended for potentially better accuracy in high gravity worts. Custom calibration is generally not required but is an option for the advanced user.

Should you need to clear an existing calibration this can be done here as well.

Real time angle and current calculated gravity can be seen in this screen.

Assembly Instructions

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.

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

Operation Instructions

After charging, assembly and device registration your RAPT Pill should be calibrated before use. Refer to the Calibration section for instructions on how to calibrate your device.

1. Calibrate and then assemble your RAPT Pill. After calibration confirm your RAPT Pill is correctly sending telemetry to the RAPT Portal by leaving it in a jug of water or sugar solution for an hour and checking to see if telemetry has been received by the RAPT Portal.
   It is best to conduct this test in the position where the Pill will be located during fermentation such as if you are fermenting in a fermentation chamber place the Pill in a jug in the fermentation chamber to confirm that telemetry is received and your RAPT Pill has good signal strength.

2. Once it is confirmed that your RAPT Pill is sending telemetry then sanitise your RAPT Pill with an approved sanitiser such as StellarSan or Phosphoric Acid which has been correctly diluted according to the instructions on the sanitiser’s container.

3. Drop your RAPT Pill into your fermenter to monitor the specific gravity and temperature of your brew in real time.

Sleep Mode
The RAPT Pill will enter sleep mode when the device is in a horizontal orientation. It will automatically wake up when its orientation is changed indicated by the illumination of a green light on the circuit board.

When not in use ensure the RAPT Pill is in a horizontal orientation to ensure it remains asleep.

Calibration

• Calibration before first use is strongly encouraged for best results.
• It is recommended to recalibrate after the Pill is connected to USB-C, as tiny changes when opening/closing the housing can affect calibration

1. Plug your Rapt Pill into a charger or computer with a USB-C cable (not included).

2. On your smart phone or tablet, open your Wi-Fi settings and connect to the “RAPT Pill XXX” access point (AP) using the password “kegland1”. You may not need to enter the password if you have previously connected your device to the Pill’s Wi-Fi.

3. Open the Pill Captive Portal when prompted to sign into the network of your RAPT Pill by your smart phone or tablet.
   If you are not prompted to sign into the network of your RAPT Pill by your smart phone or tablet then open your Wi-Fi settings and select the “RAPT Pill XXXX” Wi-Fi network again to open the Pill Captive Portal.

4. Once the RAPT Pill Access Portal is open on your phone or tablet, navigate to the Calibration tab.

5. Select the desired calibration method (Standard, Advanced or Custom) and follow the relevant steps.

IMPORTANT: The RAPT Pill is designed to disconnect from the RAPT Portal once the USB-C cable is unplugged to preserve battery life. Opening the Calibration or Diagnostics screen will keep the Pill Portal active to allow calibration of the Pill. You will be prompted after to 10 minutes to “Click Here To Maintain Connection” if the calibration process takes longer than 10 minutes.

Once you have entered a Calibration mode, please assemble your Pill according to the directions so that it can be removed from the USB and calibrated according to the instructions below.

There are three ways to calibrate your RAPT Pill: Standard Calibration, Advanced Calibration and Custom Calibration.

1: Standard Calibration
The Standard calibration mode is recommended for most users.
Standard calibration is the quickest and simplest method of calibration.

1. Fill a container of sufficient volume to hold the RAPT Pill in suspension with a liquid of known gravity. It is simplest and easiest to use water which has a gravity of 1.000.
2. Once the angle reading has stabilised* enter the gravity (1.000 for water) and press Calibrate. Wait until the screen indicates that calibration is complete.

Your Pill is now ready to use!

• The angle will never be completely steady, as it is extremely sensitive. Press Calibrate when the RAPT Pill has stabilised as much as possible.

2: Advanced Calibration
The advanced calibration mode can give greater accuracy across a wider range.

Advanced calibration is also quite quick and easy, and can provide a more accurate result than Standard Calibration. It is the same procedure as standard calibration, but in addition to water at 1.000, have a solution of a known gravity prepared.

We recommend using a gravity in the range that your fermentation will start – 1.040-1.060 for typical beers, for example.

1. Fill a container of sufficient volume to hold it in suspension with a liquid of known gravity. It is simplest and easiest to use water which has a gravity of 1.000.
2. Prepare another vessel capable of holding the Pill in suspension with a solution of known gravity in the range representative of the upper limit of your starting gravities.
3. Place the Pill in the weaker solution. Once the angle reading has stabilised enter the gravity (1.000 for water) and hit Calibrate. Wait until the screen indicates that calibration is complete.
4. Place the Pill in the stronger solution. Enter the gravity as determined by a calibrated hydrometer. Once the angle reading has stabilised press Calibrate. Wait until the screen indicates that calibration is complete.

3: Custom Calibration
Warning! Custom Calibration is for advanced users only.
This mode can provide the most accurate readings across a wider range than the other calibration modes.

Only proceed if you are comfortable with spreadsheets and complex curves. If you are working with solutions with gravities higher than 1.080, then custom calibration is advised.
For Custom calibration, you will need to take readings at various gravity points roughly 10 gravity points apart, and make a note of the angle of the Pill at each point. We recommend readings from 1.080 down to 1.000, 10 points apart (so, 1.080, 1.070, 1.060 etc). Note that it does not matter if the gravity readings are not exactly 10 points apart, as long as the gravity reading is correct. Use of a hydrometer that is known to be accurate is quite important.

To perform Custom Calibration, it is easiest to start with the strongest solution and dilute to progressively weaken the solution. It is important to use a calibrated hydrometer to ensure accurate gravity readings.

1. Place the Pill in the first solution of known gravity. Wait for the angle to stabilise, then make a note of the angle and the gravity.
2. Repeat this step for solutions of different gravity, making a note of the angle and the gravity at each step. It is easiest to dilute the starting solution in steps of approximately 10 points. Finish with a reading in a solution with a gravity of 1.000 (IE water).

Once you have sufficient readings, the angle and the gravity need to be entered on an Excel spreadsheet (or similar such as Google Sheets) as a graph with gravity on the ‘y’ axis and angle on the ‘x’ axis. The more readings you take, the more accurate this calibration will be. We recommend a minimum of 6 samples, with 10 or more providing a greater degree of accuracy.

When you have created the graph, create a polynomial trend line onto the graph with the degree of the polynomial being at least one less than the number of data points. If the trend line creates an irregular curve (such as not passing through the data point at 1.000 correctly or not following a polynomial shape) reduce the number of data points (ensuring that there are still more data points than the degree of the polynomial) until the curve matches.

With 10 data points, a polynomial degree between 5 and 8 will typically give the best results.This is a sample only

Copy the equation of the trend line that is generated once this is done.

Paste this equation into the field provided on the Custom Calibration screen (In Google Sheets, set your label to Use Equation).

This will look similar to this:

This is a sample only – DO NOT USE THIS EQUATION AS IT WILL NOT BE ACCURATE

Paste this equation into the field in your Custom Calibration to complete the calibration. Congratulations! Your Pill is calibrated and ready to go.

Updating Firmware

Your RAPT Pill will automatically check and install for firmware updates when plugged in to USB power with a USB-C cable (not supplied).

To check the firmware on your Pill, plug the Pill in with a USB-C cable then open the Pill Access Portal by connecting to the Access Point on your phone or tablet or through the Pill IP address.

1. Plug your Pill in to USB power with a USB-C cable.
2. Connect to the Pill Access Portal with your phone or tablet or through the Pill IP address.
3. Navigate to the Diagnostics page.
4. Check that your Pill is running the latest firmware.
5. If a firmware update is available, this will be updated automatically when the Pill is plugged in to USB with a USB-C cable (not supplied).
6. To check and update manually in the event that this is not up to date, select Check for new firmware. Your device will automatically download and update the most current available firmware.

Bluetooth Operation

The RAPT Pill can send telemetry via WiFI or Bluetooth. For general use WiFi is the default option.

Bluetooth will only work if the RAPT is paired with a Bluetooth capable RAPT device such as a RAPT Fermentation Chamber, a RAPT Temperature Controller or a RAPT Gen 4 BrewZilla.

Enable Bluetooth/WiFi
To enable Bluetooth on the Pill, you must first connect to the Pill Captive Portal by following the instructions above. Then, navigate to the Settings page of the Captive Portal.

There is a dropdown menu for Telemetry Method. This enables you to switch between WiFi or Bluetooth for telemetry, and also to set the desired telemetry interval.

The default telemetry interval for WiFI is 60 minutes.
The default telemetry interval for Bluetooth is 60 seconds.
It is recommended to keep these settings as they are. Shorter intervals will impact battery life.
Once Bluetooth has been enabled in the Pill Captive Portal, the Pill must be Bonded with a RAPT Bluetooth device such as a RAPT Fermentation Chamber, a RAPT Temperature Controller or a RAPT Gen 4 BrewZilla.

Note: Bluetooth requires a compatible RAPT device such as a Fermentation Chamber or Temperature Controller. Bluetooth will not broadcast unless the RAPT Pill is first registered to the RAPT Portal using WiFi.

Troubleshooting Registration and Telemetry

User code is not appearing on the Pill Captive Portal

If the space for the user/validation code on the Pill Captive Portal is blank then make sure that your RAPT Pill is connected to your home Wi-Fi network (See Determine whether your RAPT Pill is connected to Wi-Fi below).

No telemetry is being displayed on the RAPT Portal.
The default setting for telemetry is 60 minutes. As a result, you will not see telemetry in the RAPT Portal right away. Should the telemetry data not appear after 60 has passed you should check the following:

Determine whether your RAPT Pill is connected to Wi-Fi
If your RAPT Pill is not connected to your home Wi-Fi network it will be unable to send telemetry to the RAPT Portal.

To check this, plug your RAPT Pill in to power and open the RAPT Pill Captive Portal and Navigate to Wi-Fi. Check that it shows that the RAPT Pill is connected to your home Wi-Fi network.

You can also check by navigating to Diagnostics and checking that it shows your networks IP address next to IP (STA).

To connect your RAPT Pill to your home Wi-Fi network, see Connecting the RAPT Pill to your Home Wi-Fi Network

Check the signal strength
If your RAPT Pill is connected to your home Wi-Fi network and there is no telemetry being received check that your RAPT Pill has a good signal strength in the area/vessel/chamber you are fermenting in.

To check the signal strength, log in to the RAPT Portal and click on the information symbol below your RAPT Pill on the dashboard.

Signal strength is represented on a scale of 0 to -100dbm

Re-Register Your RAPT Pill
If your RAPT Pill is still not sending telemetry despite being connected to Wi-Fi and with a good, reliable signal strength then you may need to re- register your RAPT Pill to your account. 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 Portal on your smart phone or tablet. (See Opening the RAPT Pill Captive Portal).

Go to the Registration tab in your Pill Access Portal.

Click the Clear Registration button, and wait a couple of seconds for a new User Code to be generated.

In a separate device, open and sign in to the RAPT Portal (https://app.rapt.io).

Click on the 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 user/validation code that was generated and click Save. Your RAPT Pill should now be registered successfully.

If you are unable to sign up for an account or your RAPT portal displays an error please forward as many visual pieces of supporting information and a detailed description of the error to [email protected]

General Troubleshooting

Red (battery) light flashes rapidly when plugged in to USB-C
Please install the battery or check that it is making good contact with the terminals.

Lights turn off immediately when disconnected from USB-C
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.

If the battery has a good charge level, gently bend the terminals out in order to ensure there is good contact with the battery. The lights will also turn off immediately if the Pill is plugged in to USB-C but the Captive Portal is not opened

Battery level reads 0% or not displaying in the RAPT Portal

1. 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)
2. Discharge the battery by using the RAPT Pill for 4 weeks or by removing the battery and discharging in a device that uses power faster
3. Plug the pill into the USB Type C charging cable for 24 hours.

The lights on the Pill stop flashing shortly after it is unplugged

This is normal behaviour. There is an approximately 10 minute timeout after the Pill is unplugged.

There are no lights on the Pill when unplugged
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 briefly when this happens.

Cannot access the Pill Captive Portal
This can only be accessed when the Pill is plugged in to USB-C. Access to the portal will cease after 10 minutes and the Pill will enter a sleep state. Unplugging and reconnecting to USB-C will allow it to be reconnected.

Valication code is not appearing on the Pill Captive Portal
If the space for the Validation code on the Pill Captive Portal is blank then make sure that your RAPT Pill is connected to your home Wi-Fi network (See Determine whether your RAPT Pill is connected to Wi-Fi below).

Warranty (Australia) & Support

Please join the Facebook RAPT Users Group for support on how to use your RAPT Pill & Thermometer or the RAPT Portal.

If you need hardware support, please contact your nearest distributor.

The RAPT Pill & Thermometer comes with a 12-month warranty when sold in Australia. To lodge a warranty claim in Australia please forward as many visual pieces of supporting information and a detailed description of your issue to

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 condition please visit our website here -> Terms & Conditions

[email protected]

www.KegLand.com.au

Read More About This Manual & Download PDF:

References

• Home Brew Supplies - KegLand Australia
• Home Brew Supplies - KegLand Australia
• RAPT Cloud
• RAPT Cloud
• 18650 Rechargeable Li-Ion Battery 3200mAh 3.60V | RAPT Pill replacement battery
• KegLand Pure Phosphoric Acid 85% 500ml
• RAPT Pill Hydrometer & Thermometer - WiFi - Bluetooth
• StellarClean, Sodium Percarbonate, Oxypur, PBW, Home Brew, Cleaner, Keg and Line Cleaner
• StellarOxy 100% Sodium Percarbonate, Oxypur, PBW, Home Brew, Cleaner, Keg and Line Cleaner
• Terms and Conditions

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>