Your phone, and a wristband if you have one
RSOS starts on your phone: the player, the breath light, the words, the tones and, on Android, the vibration codes on the phone itself. A heart-rate strap can start offers when stress rises. A wristband is optional: it carries the vibration codes on your wrist.
Status: phone vibration and the browser connection are built and tested. The wristband firmware compiles with the real ESP32 toolchains and passes its USB and output checks in an emulator; it has not yet been run on a board. Research and development framework; not a medical device.
What works on your phone
| Feature | Android (Chrome) | iPhone (Safari) |
|---|---|---|
| Player: breath light, words, voice, tones | Yes | Yes |
| Your own recorded voice | Yes | Yes |
| Vibration codes on the phone (the Lion ..- and every glyph) | Yes | No: iPhone browsers block vibration |
| Node studio, therapist mode, safety, contribute | Yes | Yes |
| A Bluetooth heart-rate strap as the stress trigger | Yes | No: Safari has no Web Bluetooth |
| An RSOS wristband | Yes, by Bluetooth | No |
| Motion sensing (fewer false stress alarms) | Yes | Yes, after a permission prompt |
| Works offline after the first visit | Yes | Yes |
An Android phone is a complete RSOS device on its own. On iPhone, vibration and Bluetooth need a native app, which does not exist yet. Not built on any phone yet: heart rate from the camera, and starting a run from the background with the screen off.
Set up on Android
- Open the player in Chrome. r-a-elu-architecture.github.io/RSOS-Multimodal-Cue-Framework/player.html
- Install it. Chrome menu (⋮) → Add to Home screen or Install app. RSOS then opens like an app and works offline.
- Let it vibrate. In the player, keep Vibrate on under Output. In the phone's settings, Sound and vibration → Vibration and haptics must be on, and Do Not Disturb off while you practise. Test it: on the Glyphs page, choose 🦁 and press Feel it.
- Practise once. Press Start, rate how you feel before and after. Every run is kept on the phone only.
- Build your own nodes (optional) in the node studio: describe what you want in your own words, approve the plan, and it appears in the player.
- Add a heart-rate strap (optional). Turn on Bluetooth and Location (Android asks for Nearby devices). In the player, under Heart-rate trigger, press Connect heart-rate strap, choose your strap, then tick Offer the override when stress is detected. The strap learns your baseline in about six minutes.
- Add a wristband (optional) below: Connect by Bluetooth.
- Keep a backup. In the player, Save memory stores all your runs in one file you can load on another device.
A wristband
An RSOS wristband plays the codes on your wrist, on its own clock, and stops at once when you press Stop. Connect it by USB (Chrome or Edge on a computer) or by Bluetooth (Chrome on Android).
Not every wristband works. RSOS runs on bands whose software you can replace; most brand watches do not allow that. See which wristbands work. No band yet? The board kit lists the parts (an ESP32 board, a coin vibration motor, a transistor, a battery), the wiring and how to flash it.
Bluetooth pairing. The band accepts commands only from a paired, encrypted connection. The first time, your phone or computer asks for a six-digit passkey: read it on the band's screen if it has one, or connect the band by USB and type PASSKEY in a serial monitor. New devices can pair only in the first two minutes after the band is switched on (or after PAIR over USB). See the board kit.
Check the band
Seven checks on the band itself, about 15 seconds; the band vibrates during them. The same checks run from a computer with python -m rsso.board --port ….
| Check | What it requires | Result |
|---|
Feel a code
Your nodes' vibration codes, and any glyph's code. Strength stays under the safety envelope.
Play a program
The program's vibration (and scent or taste, with consent) plays on the band. Voice and light stay in the player.
Which wristbands work
| Device | Works with RSOS | How |
|---|---|---|
| A band built from the board kit (ESP32 and a coin motor) | Yes | Flash the RSOS firmware; this page checks it |
| ESP32 watches and wearables you can flash: LilyGO T-Watch, M5StickC and M5Stack, Watchy | Yes | The same firmware; set the motor pin for the device |
| Any device that speaks the RSOS Device Protocol (RDP/1) | Yes | The protocol is open; the check above shows whether a device complies |
| Android phones | Yes, vibration only | The player vibrates the phone; no extra device needed |
| Heart-rate straps and watches using the standard Bluetooth heart-rate service (for example Polar H10, Garmin HRM) | Yes, as the stress trigger | Connect in the player; they measure, they do not vibrate RSOS codes |
| Open watches: PineTime, Bangle.js | Not yet | Their software is open; an RSOS port is possible and planned |
| Wear OS watches (Samsung Galaxy Watch, Pixel Watch, TicWatch) | Not yet | Needs an RSOS app on the watch, published on Google Play |
| Apple Watch | Not yet | Needs an RSOS app on the watch, published on the App Store |
| Fitbit, Garmin, Xiaomi Mi Band, Huawei, Whoop and other closed bands | No | Their software cannot be replaced and they offer no way to play custom vibration patterns |
| iPhone | No vibration from the web | iPhone browsers do not allow web pages to vibrate; sound and light work in the player |
What the band says
More channels
The same programs and codes can reach a person through more than a phone and a band. Each class of device below carries some channels; for the ones not assembled yet, the firmware and drivers are written and tested in simulation, with the safety limits enforced on the device, so a builder only puts the parts together (board kit §8).
Posture
Hold the phone upright against your chest or clip it on. Leaning forward past 25 degrees for five seconds is one slouch, cued once; it ends when you are back under 15 degrees.
Lock screen
An image with a profile's symbol and phrase, to set as the lock screen: the cue is there each time the phone is picked up.
On several body sites
With motors in more than one place, each part of a code goes to the next site, so a two-part code is felt in two places. Up to three at once.
Carrier and rhythm
A vibration has a carrier (how fast it buzzes, 20-300 Hz) and can pulse at a slower rhythm (1-40 Hz). Hear it here on the speaker. A rhythm does not entrain the brain by being felt: that claim (C35) is untested and nothing here relies on it.
Warm and cool
For a wrist module that cools or warms: the firmware already runs these lines; the module is not built yet. The limits: at most 4 °C either way, at most two minutes, four times a session.
Read a protocol line
Paste a draft RDP/1.1 line: T for temperature, D for an image, HF for vibration with carrier, rhythm and site.
Build one
What a person needs to build each device: the parts, what they cost, the command that puts the software on it and the checks that show it works. The software is written and tested in simulation; none of these has been assembled and checked on hardware yet, so the first builder's results matter.
Pronunciation
Listen to a drill, say it back, and see how your melody, vowel sounds and rhythm compare, syllable by syllable. Your own voice pitch, voice type and speed are taken out first, so a different voice is not a mistake. Say each vowel with a short break between. The recording stays on this device.
No microphone? Try a simulated learner: