Skip to content

suya hw

suya hw drives hardware validation through BitCrucible. Validation runs execute against real targets via registered agents, and you can review the history of past runs. Agents bridge your physical hardware to the Subaya backend.

Manage the agents that connect your hardware to Subaya.

Register a new agent.

Terminal window
suya hw agent register --name bench-01
Flag Description
--name <n> Display name for the agent.

List registered agents.

Terminal window
suya hw agent list

Revoke an agent by id.

Terminal window
suya hw agent revoke <agent-id>

Run the agent process (the bridge that services validation runs).

Terminal window
suya hw agent run

Start a hardware validation run against a target.

Terminal window
suya hw run --target <target> --test-plan plan.yaml
Flag Description
--target <t> The validation target to run against.
--test-plan <file> Optional test plan file driving the run.

Show the history of hardware validation runs.

Terminal window
suya hw history
suya hw history --project <project-id> --limit 20
Flag Description
--project <id> Scope history to a project.
--limit <N> Maximum number of entries to return.
  • Core concepts — where hardware validation sits in the phases.
  • suya sim — simulate before you validate on hardware.