RSOS

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

FeatureAndroid (Chrome)iPhone (Safari)
Player: breath light, words, voice, tonesYesYes
Your own recorded voiceYesYes
Vibration codes on the phone (the Lion ..- and every glyph)YesNo: iPhone browsers block vibration
Node studio, therapist mode, safety, contributeYesYes
A Bluetooth heart-rate strap as the stress triggerYesNo: Safari has no Web Bluetooth
An RSOS wristbandYes, by BluetoothNo
Motion sensing (fewer false stress alarms)YesYes, after a permission prompt
Works offline after the first visitYesYes

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

  1. Open the player in Chrome. r-a-elu-architecture.github.io/RSOS-Multimodal-Cue-Framework/player.html
  2. Install it. Chrome menu (⋮) → Add to Home screen or Install app. RSOS then opens like an app and works offline.
  3. 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.
  4. Practise once. Press Start, rate how you feel before and after. Every run is kept on the phone only.
  5. 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.
  6. 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.
  7. Add a wristband (optional) below: Connect by Bluetooth.
  8. 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.

Not connected.

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 ….

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

DeviceWorks with RSOSHow
A band built from the board kit (ESP32 and a coin motor)YesFlash the RSOS firmware; this page checks it
ESP32 watches and wearables you can flash: LilyGO T-Watch, M5StickC and M5Stack, WatchyYesThe same firmware; set the motor pin for the device
Any device that speaks the RSOS Device Protocol (RDP/1)YesThe protocol is open; the check above shows whether a device complies
Android phonesYes, vibration onlyThe 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 triggerConnect in the player; they measure, they do not vibrate RSOS codes
Open watches: PineTime, Bangle.jsNot yetTheir software is open; an RSOS port is possible and planned
Wear OS watches (Samsung Galaxy Watch, Pixel Watch, TicWatch)Not yetNeeds an RSOS app on the watch, published on Google Play
Apple WatchNot yetNeeds an RSOS app on the watch, published on the App Store
Fitbit, Garmin, Xiaomi Mi Band, Huawei, Whoop and other closed bandsNoTheir software cannot be replaced and they offer no way to play custom vibration patterns
iPhoneNo vibration from the webiPhone 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.

–degrees from upright

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: