Breathing trainer

Instructions

Everything about operating the device directly — the rotary wheel with single, double and triple click, the OLED screens, the settings menu and the seven operating modes. The screenshots are rendered pixel-for-pixel from the firmware's screen renderer (v1.3.1).

First start

Splash

On power-up the OLED shows the AirLock wordmark and the running firmware version. The device then starts in Regulator mode — the safe default with the valve fully open.

Controls & gestures

A single rotary wheel with an integrated push-button operates the whole device. A 128 × 64-pixel OLED shows the mode, parameters and status. A ring of addressable RGB LEDs gives quick feedback on battery level, charging and connection. Turn to adjust and scroll; press in one of four ways:

Turn — change the highlighted value, or scroll through a list / selection wheel.
Single click — step to the next editable parameter in the current mode (the highlight box moves on). In a menu: confirm the highlighted entry.
Double click — open the mode selector. (Inside the wheel a double click cancels back out.)
Triple click — open the settings menu (Sleep, LED, Wifi & BT, System).
Long press (≥ 0.5 s) — start or stop the current mode (the HOLD/GO toggle). Exactly what it does depends on the mode (see below).

Operating modes

Seven modes, selectable via double click → mode wheel or via the mode tabs in the app. Regulator is the start default and leads the list. Top-right, every mode screen shows a HOLD or GO badge: HOLD = paused, valve fully open; GO = the mode is running. Toggle it with a long press. Mode names stay English in both languages — matching the device display and the app.

Regulator

Holds the valve at a fixed airflow value. HOLD pins it fully open; GO regulates to the target (60 % here). A single click while in GO toggles between the target and fully closed. The start mode after power-up.

Cycle

Alternates an open and a closed phase. Adjustable: open time, closed time, airflow (%) and waveform. A long press starts/stops the cycle — the same play/stop state as the big button at the bottom of the app.

Motion

IMU-driven. The valve closes once the device tilts past a set angle from its reference, and reopens as the motion settles. The cross shows yaw (horizontal) and pitch (vertical), the arc below it roll; a check mark flags each active axis. Adjustable: sensitivity (in degrees), active axes, airflow and waveform. A long press sets or clears the reference pose. Requires the IMU hardware variant.

Chaos

Open and closed durations are random — each somewhere between MIN and MAX. Adjustable: min, max, airflow and waveform. Predictable bounds, unpredictable rhythm. A long press starts/stops.

Progressive

A stepwise build-up. The open duration begins at the start value and grows by the step value at each stage. A 10-dot indicator shows the position in the sequence. Adjustable: start time, step, airflow and waveform. A long press starts/stops.

Tap

IMU-driven. A tap above the set threshold (in g) opens the valve for a fixed duration; with the duration at 0 the screen reads RDM and rolls a fresh one each time. Adjustable: duration, threshold and airflow. A long press arms/disarms. Requires the IMU hardware variant.

Loop

Record and replay. In the app, hold and move the airflow slider — the valve follows live, so while recording you feel exactly what is being captured. Release and playback starts automatically; the sequence is drawn as a line graph on the OLED with a playback cursor sweeping through it. A long press plays/stops. Recording needs the app or the web UI connected — with nothing recorded the screen reads “no sequence / Use app”.

Mode selector

Mode wheel

Open with a double click. The highlighted mode sits in the middle row; turn to scroll, single click to confirm, double click to cancel. The filled dot marks the currently active mode.

Mode banner

After a switch the OLED briefly flashes the name of the new mode (or the new LED animation) as a banner.

Settings menu

Triple click

Reachable from any mode with a triple click. Five entries: Sleep, LED, Wifi & BT, System and Back. Turn to scroll, single click to open. Sleep sends the device into deep sleep — the next button press wakes it. Submenus close via Back or with an extra click.

LED — animation

The LED submenu picks the idle animation of the LED ring — Helix, Breathe, Comet, Pulse, Heartbeat, Countdown, Bounce, Rain or Static. The filled dot marks the active animation. The same choice is in the app's settings sheet.

LED — brightness

The Brightness entry in the LED submenu opens a six-step brightness control (0–100 %). Turn to adjust, click to confirm. Level 0 turns the ring off entirely.

Wifi & BT

Layout

Eleven entries: the WiFi radio states first, then WiFi actions, then the Bluetooth states, and finally Back. A filled dot marks the active WiFi state and the active BT state.

WiFi Off / AP Mode / STA Mode — WiFi off, own access point, or join your home network.
Show QR — QR code for joining the device's WLAN.
Hints — current network details on the OLED.
Forget Network — delete the saved home-network credentials.
Reset Password — reset the AP password to the default.
BT Off / BT On — turn Bluetooth off or on.
Reset Bluetooth — clear all stored pairings to pair again from scratch.
Back — back to the settings menu.

Show QR

The OLED shows a QR code with the AP SSID and password. Scan it with the phone camera and join the device's WLAN in one tap — the embedded web UI is then reachable at airlock.local. No manual entry needed.

Hints

Current network details: in AP mode the SSID, password, host and IP; in STA mode the connected network, host and IP. Handy for seeing the address the web UI is served at.

Quick notes

If, for instance, joining the home network fails, the OLED shows a brief note for about a second and a half — nothing to dismiss.

Bluetooth pairing

Pair with a PIN

Pairing happens automatically — there is no separate menu entry for it any more.

In the Wifi & BT menu, choose BT On if Bluetooth is off.
In the app's scan view, tap the device (AirLock-XXXX).
A 6-digit PIN pops up automatically on the OLED (“Pair this device”). Type it on the phone — pairing done.
To re-pair or if something goes wrong: choose Reset Bluetooth in the Wifi & BT menu and repeat.

System submenu

Layout

Six entries: Factory Reset, Calibration (servo calibration), Reboot (restart), Travel Mode, Info and Back.

Info

A read-only page with the firmware version, hardware revision, the Bluetooth name (AirLock-XXXX), the MAC, the AP SSID, the IP and the serial number. Click to dismiss. The app reads the same data over BLE device-info.

Calibration — servo

Walks you through setting the closed and the open angle. Turn the wheel until the valve is fully closed and confirm with a single click — then the same for the fully open angle.

Calibration — confirm

A summary of the two angles to confirm. After Confirm they are written to non-volatile storage and survive reboots and firmware updates.

Travel Mode

Like Sleep, but waking is restricted: the device only wakes when a USB-C cable is plugged in. Ideal for shipping or longer storage so a stray button press in a bag can't wake it.

Factory Reset — confirm

A two-step confirmation guards against mistakes. The cursor starts on Back for safety — to wipe, turn to Confirm first, then click.

Factory Reset — animation

While the NVS storage is wiped, a short animation runs so it's clear the device hasn't hung. It then reboots into first-time setup.

Special states

Battery critical

If the battery drops below the critical threshold, the device fails open — the valve moves to the safe open position and a full-screen warning takes over the OLED. Plug in the charger to clear it.

Shutdown sweep

When entering deep sleep or Travel Mode, a short sweep runs across the OLED and LED ring — the last visible signal before the screen goes dark.