User Guide

Table of Contents

1. Sensor Calibration v3.3
2. First Start
3. WiFi Connection
4. Sensor Types
5. Dashboard
6. "Strhni Pípu" Game
7. Flow Memory
8. MQTT & Home Assistant v3.3
9. Cloud IoT
10. Firmware Update (OTA)
11. Troubleshooting

Sensor Calibration v3.3

Flow meter accuracy depends on temperature, pressure and beer line length. Every setup is different, so we recommend calibrating at home. We've set reasonable default values, but custom calibration ensures maximum accuracy.

How to Calibrate (v3.3+)

1. Open "Calibration" from the device menu
2. Select the target volume (0.3 / 0.4 / 0.5 L)
3. Reset the flow counter and pour exactly the chosen volume into a measuring container
4. Watch the factor recalculate in real time while pouring
5. Click "Apply" to save the new factor. Repeat for better accuracy.

Why Calibrate?

Even the most accurate sensor behaves differently depending on conditions: beer temperature, CO2 pressure, hose length and diameter, number of bends in the line. Calibration eliminates these deviations and achieves accuracy under 1%.

Quick Calibration (without measuring)

In Settings you'll find buttons for quick default value setup:

• YF-S301 — Turbine sensor, default factor 168, flow mode
• RB OW-01 — Oval wheel sensor, default factor 80.5, flow mode

First Start

1. After powering on, the device creates a WiFi hotspot RoboPipa + unique ID
2. Connect with password 123456789
3. Open 192.168.4.1 in your browser (on most devices it opens automatically)
4. Choose the language and set the sensor type

WiFi Connection

AP Mode (hotspot)

Default mode. The device creates its own WiFi network. Ideal for simple use without a home network. MQTT and Cloud do not work in this mode.

Switching to Home WiFi (client)

1. In Settings, enter the SSID and password of your home WiFi
2. Click "Save and switch to client mode"
3. The device will restart and connect to your network
4. The new IP address is shown on the display (ORI version: 1 minute, MAX version: permanently)

Sensor Types

YF-S301 (Turbine)

• Measurement type: Flow rate
• Accuracy: ±3%
• Default factor: 168
• Mode: Flow (switching to pulses not recommended)

RB OW-01 (Oval Wheels)

• Measurement type: Volume displacement
• Accuracy: <1% (theoretical)
• Default factor: 80.5 (flow mode)
• Mode: Flow (recommended)

Don't Forget to Set Up

Before first use, set: number of sensors (1 or 2), sensor type for each input, and perform calibration.

Dashboard

The Dashboard displays remaining volume in kegs as a graphical indicator. Select the keg size (5, 10, 15, 20, 30 or 50 litres) and watch the beer decrease in real time. When the keg is empty, click "Fill" to reset.

"Strhni Pípu" Game

The "Strhni Pípu" game tracks consumption of individual players. Supports 1-12 players with custom names.

1. Click "Strhni Pípu" in the main menu
2. In "Game Settings", set the number of players and their names
3. Set the price per beer
4. During the event, switch the active player and track statistics

Flow Memory

In Settings you'll find two important toggles:

• Reset on restart: ON — Flow resets to zero after restart (default)
• Reset on restart: OFF — Flow is restored from the last saved value after restart
• Flow saving: ON — Flow is automatically saved to EEPROM every 5 minutes

MQTT & Home Assistant v3.3

RoboPípa supports the MQTT protocol for integration with Home Assistant and other smart home systems.

Prerequisites

• The device must be in Client mode (connected to home WiFi)
• A working MQTT broker (e.g. Mosquitto as a Home Assistant add-on)
• Know the broker IP address, username and password

Setup in RoboPípa

1. In Settings, find the MQTT section and enable the toggle
2. Fill in Host (Home Assistant IP address), User and Password
3. Save. Port 1883 is the default and is set automatically.

MQTT Topics

The device publishes volumes to these topics:

robopipa/{DEVICE_ID}/sensor1/volume
robopipa/{DEVICE_ID}/sensor2/volume

{DEVICE_ID} is the unique ID of your device, found in Settings under the Cloud section (e.g. d4e9f4e1a31c).

Home Assistant Setup

Add the following to your /homeassistant/configuration.yaml file:

mqtt:
  sensor:
    - name: "RoboPipa S1"
      state_topic: "robopipa/{DEVICE_ID}/sensor1/volume"
      unit_of_measurement: "L"
      icon: mdi:glass-mug-variant

    - name: "RoboPipa S2"
      state_topic: "robopipa/{DEVICE_ID}/sensor2/volume"
      unit_of_measurement: "L"
      icon: mdi:glass-mug-variant

Replace {DEVICE_ID} with your actual Device ID from the device. Restart Home Assistant after saving.

Cloud IoT

Cloud IoT lets you track flow remotely via the internet at robopipa.cz. The device must be in Client mode. In Settings, click "Register" to link the device to your account.

Firmware Update (OTA)

Firmware can be updated wirelessly through the web interface:

1. Open "Firmware Update" on the device page
2. If the device is online, it will automatically check for a new version
3. Download the .bin file and upload it via the form on the page

Troubleshooting

Device is unresponsive / frozen

1. Connect the device to a PC via USB
2. Use the Flash Download Tool: perform an ERASE (clears EEPROM) and then reflash the firmware

WiFi won't connect

The device automatically returns to AP mode. Connect to the hotspot and check SSID/password. Passwords with diacritics or special characters may cause issues.

Inaccurate measurement

Perform calibration (see section above). Make sure you have the correct sensor type and matching factor. In v3.3, calibration is easy directly on the device.