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.

Mode Switching

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 resistance
resistanceBand — non-linear elastic band simulation
damper — velocity-based resistance
isokinetic — fixed-velocity mode
isometric — static hold mode
customCurve (Professional) — custom force profile
rowing / skiing — cardio mode (share write value 3, differentiated by activity parameter)

Cardio: Rowing & Skiing

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

Weight Training

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>`	`[--percent] [--unit lbs\|kg] [--device-id <id>] [--json]`	lbs by default, integer percentage with `--percent`	Extra resistance increasing with cable extension. Percentage range: `0..300`.
`voltra set-eccentric <n>`	`[--percent] [--unit lbs\|kg] [--device-id <id>] [--json]`	lbs by default, integer percentage with `--percent`	Extra load during eccentric phase. Percentage range: `-100..300`.
`voltra set-inverse-chains <on\|off>`	`[--device-id <id>] [--json]`	—	Chains resistance decreases as cable extends.
`voltra set-chain-mode <standard\|inverse\|mountain>`	`[--device-id <id>] [--json]`	—	Select the chain curve. Mountain requires device support; inverse and Mountain are mutually exclusive.
`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-chain-mode mountain
voltra set-chains 125 --percent
voltra set-eccentric -50 --percent
voltra set-auto-unload 3 12
voltra set-auto-unload off off

--percent selects the device's percentage-force interpretation and accepts integer values only. It automatically enables percentage force for that command; using an absolute chains or eccentric value switches that interpretation back to lbs. Do not combine --percent with --unit kg.

set-chain-mode writes the normal/inverse and Mountain switches together so the two directional curves cannot be enabled at the same time. All chain-mode changes require the device to be unloaded. Mountain is rejected when the connected device does not advertise support.

Resistance Band

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

Damper

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

Isokinetic

Command	Options	Unit	Notes
`voltra set-isokinetic-velocity <n>`	`[--device-id <id>] [--json]`	m/s (converted to mm/s internally)	Concentric target velocity. Negative and non-numeric values rejected.

voltra set-mode isokinetic
voltra set-isokinetic-velocity 0.5

Isometric

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. Cortex does not expose those realtime notifications through stream; after upload, completed historical results are available through workout list --workout-type 5 and workout sets <workout-id>.

voltra set-mode isometric
voltra check-cable-zero
voltra config accept-physical-risk
voltra load
# … perform test; historical results are available through workout list/sets …
voltra finish-training

Power Control

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

Device Settings

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

Training Modes & Device Control

On this page