Skip to content

dotstar-consulting/ringone-app

Repository files navigation

Ring•One Companion App

Industrial smart ring reference platform by Dotstar Systems & Consulting
Hardware: Nordic Semiconductor nRF54L15 · ZephyrRTOS Firmware

"Ring•One" and "Dotstar" are trademarks of Dotstar Systems & Consulting. This licence does not grant permission to use these names in any product name, service, or promotional material without prior written permission from Dotstar Systems & Consulting.


What's in this repo

Path Description
src/ React + Web Bluetooth companion (Chrome on Android / desktop)
android/ Native Kotlin + Jetpack Compose Android app

BLE GATT Specification

Characteristic UUID Type Unit
Service fd0d5c94-193c-496e-b80f-511a474a449f
Temperature ac70a713-348e-43db-bf84-ffce9d82120d int16 LE 0.01 °C / LSB
Heart Rate 75fb4a26-440c-4dd3-be96-91ad75ecb864 uint8 BPM
SpO2 c4671ec2-35f1-40c4-887b-37bc00ec3427 uint8 %
Steps 7956ed3f-1cb4-47ce-89ad-9742bc0ab8bf uint32 LE count since boot
Battery 02e35db9-662d-4229-a874-d4f04c82653a uint8 %

Device advertisement name filter: Ring-One


Quick start — web app

npm install
npm run dev

Open in Chrome on Android or desktop, then click [ ACTIVATE_SCAN ] to pair with a Ring-One BLE device. The app falls back to an emulated SoC if no hardware is present.

Requirements: Chrome 85+ with Web Bluetooth enabled (HTTPS or localhost).


Quick start — Android

  1. Open the android/ directory in Android Studio (Hedgehog or later).
  2. Connect a device running Android 8.0+ (API 26).
  3. Run › app — the app requests Bluetooth permissions on first launch.

The native app uses a foreground BleService for background GATT connection persistence. See android/README.md for architecture notes and BLE quirk mitigations.


Hardware

Component Part
SoC Nordic Semiconductor nRF54L15 (ARM Cortex-M33)
RTOS ZephyrRTOS with BLE Controller v5.4
BLE Custom GATT server — notify-only streams

Firmware source: ringone-firmware repo — coming soon.


Project structure

ringone-android/
├── src/                    # React + Vite web app
│   ├── App.tsx             # Main app (Scan / Dashboard / Log screens)
│   ├── components/
│   │   └── Logos.tsx       # SVG brand assets
│   ├── index.css           # Tailwind + Google Fonts
│   └── main.tsx            # React entry point
├── android/
│   └── app/src/main/java/com/dotstarconsulting/ringone/
│       ├── MainActivity.kt
│       ├── data/model/RingOneData.kt
│       ├── data/repository/BleRepository.kt
│       ├── service/BleService.kt
│       ├── viewmodel/RingOneViewModel.kt
│       └── ui/screens/     # ScanScreen, DashboardScreen, LogScreen
├── .github/workflows/
│   └── android-build.yml   # CI: assembleDebug on push to main
├── package.json
└── vite.config.ts

License

Apache 2.0 — see LICENSE.

Trademark

"Ring•One" and "Dotstar" are trademarks of Dotstar Systems & Consulting.
This licence does not grant permission to use these names in any product name, service, or promotional material without prior written permission from Dotstar Systems & Consulting.

About

Companion Android app for Ring•One smart ring · Nordic nRF54L15 · ZephyrRTOS

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors