Cortex References
Device Discovery & Connection
Device Discovery & Connection
Discovery & Connection
| Command | Options | Notes |
|---|---|---|
voltra scan | [--timeout-ms <ms>] [--timeout <ms>] [--all] [--json] | Scan for VOLTRA devices. Default: known/matching only; --all shows everything. Requires persisted API key. |
voltra connect <device> | [--replace-known <id>] [--timeout-ms <ms>] [--timeout <ms>] [--json] | Connect, perform handshake, save as known device, start background session. <device> accepts: ID/MAC, exact name, or 1-based scan result index. |
voltra reconnect | [--timeout-ms <ms>] [--timeout <ms>] [--json] | Reconnect to the last successfully connected device. |
voltra disconnect | [--json] | Disconnect the current background session. |
voltra list-known / voltra devices | [--json] | List locally saved known devices. devices is an alias. |
voltra scan --timeout-ms 10000
voltra scan --all
voltra connect <DEVICE_ID>
voltra connect 1 # 1st result from most recent scan
voltra connect <NEW_ID> --replace-known <OLD_ID>
voltra reconnect
voltra disconnect
voltra --json devicesDevice Status
| Command | Options | Notes |
|---|---|---|
voltra status | [--device-id <id>] [--device <id>] [--timeout-ms <ms>] [--json] | Live device snapshot. Defaults to last connected device. Optional device selector connects/targets that device first. |
voltra refresh [scope] | [--device-id <id>] [--device <id>] [--json] | Refresh device parameters. scope: all, epStatus, trainingMode, weightTraining, resistanceBand, damper, isokinetic, autoUnload, cableLength, workoutState. Default: all. |
voltra status --json
voltra status --device-id <DEVICE_ID>
voltra refresh all --jsonBackground Session
| Command | Options | Notes |
|---|---|---|
voltra daemon status | [--json] | Report daemon running status, PID, and session info. |
voltra daemon stop | [--json] | Stop the background daemon. Use before reinstalling or when a clean restart is needed. |
voltra daemon status --json
voltra daemon stopLogs
| Command | Options | Notes |
|---|---|---|
voltra logs path | [--json] | Print local log file paths (cli / daemon / ble). |
voltra logs tail | [-n <lines>] [--file cli|daemon|ble|all] [--json] | Print recent log lines. Default: 100 lines, all files. |
voltra logs clear | [--json] | Remove all local log files. Irreversible. |
voltra logs path --json
voltra logs tail --file cli -n 200
voltra logs clearDiagnostics
| Command | Options | Notes |
|---|---|---|
voltra doctor | [--json] | General CLI/system diagnostics. |
voltra ble doctor | [--json] | BLE-focused diagnostics. Use when scan/connect fails. Currently equivalent to voltra doctor. |
voltra doctor --json
voltra ble doctor