# Troubleshooting & Glossary

### Glossary of Terms

| Term                        | Meaning                                                                                                                      |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **Minimum Fill Rate**       | The minimum liquid height increase required per second to maintain the cycle. (Default: 2.00mm/s)                            |
| **Fill Time Out**           | The maximum time allowed for a fill cycle to complete before the unit stops due to the Minimum Fill Rate not being achieved. |
| **Empty Pressure**          | The ambient atmospheric pressure reading captured during the calibration process.                                            |
| **Calibration Factor**      | The calculated pressure change (kPa per mm) determined during calibration.                                                   |
| **Fill Count**              | Total successful fills completed during the current session.                                                                 |
| **CPM (Cans Per Minute)**   | Current production speed based on the frequency of completed fills.                                                          |
| **AFT (Average Fill Time)** | The average duration (in seconds) to complete a single fill cycle in the current session.                                    |

***

### Filling Troubleshooting

| Problem                                    | Potential Solution                                                                                                                                                          |
| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Fill Time Out Error (settings)**         | **Decrease Min Fill Rate:** The rate may be set too high for your vessel (Default 2.0mm/s).                                                                                 |
|                                            | **Increase Fill Time Out:** Give the unit more time to reach the goal (Default 5s).                                                                                         |
|                                            | **Adjust Wait Time:** Increase the pause between purge and fill (Optimum: 0.5s–1.5s).                                                                                       |
|                                            | **Check Gas Line:** Use a glass of water to check for leaks in the gas tube; check the Diagnostics menu to see if pressure is dropping. Cut or replace any areas of damage. |
| **Fill Time Out Error (User/Environment)** | **Too Much Foam:** Foam prevents the sensor from reading the liquid level correctly. Chill liquid further, increase line resistance, or lower transfer pressure.            |
|                                            | **Transfer Speed:** If the flow is too slow, the min fill rate won't be hit. Increase pressure/speed.                                                                       |
|                                            | **Vessel Width:** Very wide vessels fill "slower" in terms of height per second.                                                                                            |
| **Inconsistent Fills**                     | **Residual Pressure:** Increase "Wait Time" in presets (0.5s minimum) to allow purge pressure to stabilisze before filling.                                                 |
| **"Purging, Wait, Ready" (No Fill)**       | **Recalibrate:** The calibration values are too close together. Ensure Empty Pressure is \~0.000 ±0.03 and Calibration Factor is \~0.01000 ±0.002 kPa/mm.                   |
| **Pressure Sensor Error**                  | **Kinked/Blocked Line:** Check for liquid or kinks in the external gas line. If clear, remove the housing screws to inspect the internal gas line connection.               |

***

### Connection & Registration Troubleshooting

<table data-full-width="true"><thead><tr><th>Problem</th><th>Solution</th></tr></thead><tbody><tr><td><strong>RAPT Network Not Visible</strong></td><td>Ensure Wi-Fi is enabled in Settings.</td></tr><tr><td></td><td>Reboot unit for 30 seconds.</td></tr><tr><td></td><td><strong>Check Diagnostics:</strong> If an IP is shown, it’s already connected.</td></tr><tr><td><strong>"No Internet" on Phone</strong></td><td>Select "Forget Network" or ignore the prompt; internet isn't needed for the setup portal. Then connect again</td></tr><tr><td><strong>Connection Failed</strong></td><td><strong>Check Band:</strong> Must be 2.4GHz (not 5GHz).</td></tr><tr><td></td><td><strong>Check Password &#x26; Wi-Fi Name:</strong> Remove non-alphanumeric characters (e.g., #, !, ?).</td></tr><tr><td></td><td><strong>Unsecured:</strong> Device cannot connect to networks without a password.</td></tr><tr><td></td><td>Reboot your modem/WiFi router</td></tr><tr><td></td><td>Try connecting to a different Wi-Fi 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>Install optional <a href="unit-upgrades-and-enhancements"><strong>Antenna Upgrade</strong></a> to improve WiFi connectivity</td></tr><tr><td><strong>Missing Validation Code</strong></td><td>Connect the device to your W-iFi network; then Update the firmware - select <strong>Check for OTA update</strong> in <strong>Settings</strong></td></tr><tr><td><strong>Error Registering Device</strong></td><td>Check that the device firmware is up to date - select <strong>Check for OTA update</strong> in the <strong>DIagnostics screen</strong></td></tr><tr><td></td><td>The <strong>Validation Code</strong> may have timed out. Reboot the device by unplugging it for at least 30 seconds, then plugging it back in. Log out of the <strong>RAPT Portal</strong> and log back in</td></tr><tr><td></td><td>If the above steps do not work, reboot the network that the device is connected to. Once the network has rebooted,  reboot the device by unplugging it for at least 30 seconds, then plugging it back in. Log out of the <strong>RAPT Portal</strong> and log back in. Note: if using a modem and seperate Wi-Fi routers, reboot the modem and then the Wi-Fi routers in that order. </td></tr><tr><td></td><td>A corrupt firmware install can prevent registration. This can happen if a firmware download is interrputed, for example. If the above steps do not allow registration, please refer to <a href="../rapt-brewzilla/rapt-device-boot-loop-troubleshooting-and-recovery-mode">RAPT Device Boot Loop Troubleshooting &#x26; Recovery Mode</a> to rollback firmware to a good version, then update to the current version</td></tr><tr><td><strong>Determine whether your device is connected to Wi-Fi</strong></td><td>To check this navigate to <strong>Diagnostics</strong> and check that it shows your network’s IP address next to <strong>IP (STA)</strong> - in the form 192.168.XX.XXX or similar. You can also check the WiFi AP (Access Point ) the device is connected to and the current WiFi signal strength</td></tr><tr><td><strong>Determine whether your device is registered to the RAPT Portal</strong></td><td>If the message "<strong>Register your device by pressing the select button to enter the main menu, then selecting the "Register Device</strong>" item in the main menu" is displayed, this is <strong>not registered</strong>. Please follow the steps outlined in <strong>Register Device</strong></td></tr><tr><td><strong>Cannot update firmware | 5379 Error</strong></td><td><strong>This is a network issue. The OTA Firmware Update could not be validated or was incomplete</strong>. Ensure your device is as close as possible to the router. Check signal strength in <strong>Diagnostics</strong></td></tr><tr><td></td><td>Ensure you have a strong 2.4gHz WiFi signal (not just 5gHZ). Check your signal strength against <a href="#signal-strength">this table</a></td></tr><tr><td></td><td>Make sure there are no VPNs in use, or filters or other potential issues set up in the router that can block an outgoing signal</td></tr><tr><td></td><td>If issues persist, reboot the device and also the modem</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 update firmware | 28674 Error</strong></td><td><strong>This is a network issue. The OTA Firmware Update could not be validated or was incomplete</strong>. Ensure your device is as close as possible to the router. Check signal strength in <strong>Diagnostics</strong></td></tr><tr><td></td><td>Error 28674 is an <strong>error opening an HTTP connection</strong>. Check your modem or router settings. A VPN, Firewall or other setting may be blocking outgoing connections - this is a common reason for this error</td></tr><tr><td></td><td>Ensure you have a strong 2.4gHz WiFi signal (not just 5gHZ). Check your signal strength against <a href="#signal-strength">this table</a></td></tr><tr><td></td><td>If issues persist, reboot the device and also the modem.</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></tbody></table>

#### SIgnal Strength

<figure><img src="https://570278281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUqN4sW0x2s4yh6iiT8NN%2Fuploads%2FcIkcwG6pWuQKIzRzB7rI%2FSIgnal%20Strength.png?alt=media&#x26;token=3008cc79-402c-4fc4-931e-bae66e2efd74" alt=""><figcaption><p>SIgnal Strength Table</p></figcaption></figure>

#### Using Phone as Hotspot

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-connectivity-and-registration) to connect to the phone Hotspot
5. Once connected, navigate to Settings/Check for OTA update on the RAPT Device
