Cortex References
Training Modes & Device Control
Most device control commands require a background session — run voltra connect <DEVICE_ID> first.
All device control commands require a persisted API key.
When not connected, some commands will auto-scan, connect, execute, and disconnect.
Command Options Notes voltra set-mode <mode>[--resistance <1..10>] [--wear-level <1..10>] [--device-id <id>] [--device <id>] [--json]Set training mode. Requires device unloaded before switching. Valid modes: none, weightTraining / weight-training, resistanceBand / resistance-band, damper, isokinetic, isometric, customCurve / custom-curve, rowing, skiing. --resistance applies to rowing & skiing (written as 0..9). --wear-level applies to rowing only (written as 0..9). voltra finish-training[--device-id <id>] [--device <id>] [--json]Exit current training mode, return to none. Also ends cardio workouts.
voltra set-mode weight-training voltra set-mode rowing --resistance 5 --wear-level 3 voltra set-mode skiing --resistance 5 voltra set-mode none voltra finish-training Supported training modes (device protocol TRAINING_MODE 20400):
weightTraining — constant, smooth resistanceresistanceBand — non-linear elastic band simulationdamper — velocity-based resistanceisokinetic — fixed-velocity modeisometric — static hold modecustomCurve (Professional) — custom force profilerowing / skiing — cardio mode (share write value 3, differentiated by activity parameter)
Command Options Notes voltra set-mode rowing[--resistance <1..10>] [--wear-level <1..10>]Enter rowing mode. Does NOT start a distance workout — use rowing-start for that. voltra set-mode skiing[--resistance <1..10>]Enter skiing mode. Does NOT start a distance workout. voltra rowing-start <preset>[--resistance <1..10>] [--wear-level <1..10>] [--device-id <id>] [--json]Start rowing workout at target distance. One-step mode switch + preset setup. Presets: just-row, 50, 100, 500, 1000, 2000, 5000. just-row = no target, 500m splits. voltra skiing-start <preset>[--resistance <1..10>] [--device-id <id>] [--json]Start skiing workout at target distance. Same presets as rowing-start. No --wear-level.
voltra rowing-start just-row voltra rowing-start 500 --json voltra rowing-start 2000 --resistance 5 voltra rowing-start 1000 --resistance 5 --wear-level 3 voltra skiing-start just-row voltra skiing-start 1000 --resistance 5 Command Options Unit Notes voltra set-weight <n>[--unit lbs|kg] [--device-id <id>] [--json]lbs (or kg with --unit kg) Target load. voltra set-chains <n>[--unit lbs|kg] [--device-id <id>] [--json]lbs (or kg with --unit kg) Extra resistance increasing with cable extension. voltra set-eccentric <n>[--unit lbs|kg] [--device-id <id>] [--json]lbs (or kg with --unit kg) Extra load during eccentric phase. Supports negative values. voltra set-inverse-chains <on|off>[--device-id <id>] [--json]— Chains resistance decreases as cable extends. voltra set-auto-unload <s> <r>[--device-id <id>] [--json]seconds, reps Triggers when holding still for s seconds OR reaching r reps. 0 0 or off off disables.
voltra set-mode weight-training voltra set-weight 20 --unit lbs voltra set-chains 5 voltra set-eccentric 10 voltra set-eccentric -5 voltra set-inverse-chains on voltra set-auto-unload 3 12 voltra set-auto-unload off off Command Options Unit Notes voltra set-resistance-band <n>[--unit lbs|kg] [--device-id <id>] [--json]lbs (or kg with --unit kg) Target resistance level.
voltra set-mode resistance-band voltra set-resistance-band 15 --unit lbs Command Options Unit Notes voltra set-damper <n>[--device-id <id>] [--json]1–10 (dimensionless) 1 = lightest, 10 = heaviest.
voltra set-mode damper voltra set-damper 5 Command Options Unit Notes voltra set-isokinetic-speed <n>[--device-id <id>] [--json]m/s (converted to mm/s internally) Concentric target speed. Negative and non-numeric values rejected.
voltra set-mode isokinetic voltra set-isokinetic-speed 0.5 Phase 1: switch to isometric mode → zero-position check → load power on. Test results (peak force / RFD / TPF / impulse) are determined by the device and pushed via notifications — the CLI does not currently subscribe to or read them back. View results on the device or in the app.
voltra set-mode isometric voltra check-cable-zero voltra config accept-physical-risk voltra load # … perform test, view results on device / app … voltra finish-training Command Options Notes voltra load[--force] [--device-id <id>] [--device <id>] [--json]Activate power. Requires prior accept-physical-risk and training mode not none. --force bypasses cable-zero check. voltra unload[--device-id <id>] [--device <id>] [--json]Deactivate power in any mode.
voltra config accept-physical-risk voltra set-mode weight-training voltra set-weight 20 voltra load voltra load --force voltra unload Command Options Notes voltra set-weight-unit <lbs|kg>[--json]Set device display unit preference. Must unload + finish-training first. Global, not per-mode. This does NOT convert input values — use --unit kg for input conversion. voltra check-cable-zero[--device-id <id>] [--device <id>] [--json]Verify cable is at retracted zero position. voltra cable-length <enter|exit>[--device-id <id>] [--device <id>] [--json]Enter/exit cable length adjustment mode.
voltra unload voltra finish-training voltra set-weight-unit kg voltra check-cable-zero --json voltra cable-length enter