Overview
This page serves as your guide to the documentation: you'll find an overview of how everything is organized, recommended reading paths for newcomers, and direct links to every section you might need.
Reading flow#
If you're starting out, read the sections in this order. Each step links to a section overview, so this doubles as a guided tour.
- Getting started — link the SDK, connect a device, and reach your first subsystem.
- Main concepts — the mental model: what each subsystem senses or actuates, and the vocabulary the rest of the reference assumes.
- Examples — complete, runnable programs. The fastest way to feel the API on real hardware.
- API · Core then API · Subsystems — the header-by-header reference, for when you know what you want to build.
Already have a device connected? The Getting started page ends with a deeper reading flow tailored to running real code.
The full map#
1 · Introduction#
Set up and get oriented.
| Page | What's there |
|---|---|
| Overview (this page) | How the docs are organized and where to start. |
| Getting started | Requirements, loading teslasuit_api at runtime, connecting a device, and accessing a subsystem. |
2 · Main concepts#
What the hardware does — the ideas the API assumes.
| Page | What's there |
|---|---|
| Overview | A map of the XR5 subsystems with a per-topic reading list. |
| Haptics & EMS | Programmable electrical stimulation, from light touch through to muscle contractions driven by electrical muscle stimulation (EMS) and functional electrical stimulation (FES). |
| Mocap | Full-body motion capture from the suit's inertial measurement units (IMUs): skeleton, raw IMU, and biomechanical angles. |
| PPG | Optical photoplethysmography (PPG) heart-rate sensing, with heart rate variability (HRV) and raw pulse signals. |
| Body & channel map | An interactive tool showing how the suit addresses channels by anatomical bone. It is Python-first, but the C API follows the same layout mapping. |
3 · API · Core#
The layer above subsystems — library lifecycle, device management, bone-channel mapping, and shared types.
| Page | What's there |
|---|---|
| Common Types | ts_types.h — structs, enums and type aliases shared by every module. |
| Core API | ts_core_api.h — library init/uninit and version info. |
| Device API | ts_device_api.h — device discovery, open/close, connection events. |
| Asset API | ts_asset_api.h — load and manage haptic assets. |
| Mapping API | ts_mapping_api.h — resolve anatomical bones to physical channels. |
4 · API · Subsystems#
One header per device capability.
| Page | What's there |
|---|---|
| Haptic API | ts_haptic_api.h — create, play and control haptic touches and playables. |
| Mocap API | ts_mocap_api.h — stream raw IMU, skeleton and biomechanical data. |
| Biometry API | ts_biometry_api.h — PPG and HRV biometrics. |
5 · Examples#
Complete, compilable C program source code grouped by subsystem.
| Page | What's there |
|---|---|
| Overview | Every runnable example, grouped by subsystem. |
| Play a haptic touch | Play your first touch on the suit. |
| Read heart rate | Read live heart rate from a PPG node. |
| Measure HRV | Read the Mean inter-beat interval from the PPG sensor. |
| Stream motion data | Stream skeleton data and biomechanical angles. |
Next: head to Getting started to link the SDK, connect a device, and play your first touch.