Appearance
Device Operation Reference
A user intent requested through SenHub Web or SenCLI is planned once by the shared platform service into one canonical DeviceOperationPlan. For local hardware actions, either product can provide an eligible executor implementation; they do not define separate installation or flashing semantics.
Tutorials explain how to complete a task. This Reference defines the exact values exchanged by API, Web, CLI, and executor implementations.
Executor capability matching explains how a plan is assigned to Web or SenCLI.
Intents
| Value | Meaning |
|---|---|
install | Resolve the target and execute the complete installation workflow selected by SenHub. |
flash_firmware | Write a firmware artifact to a compatible local target through an eligible executor. |
ota_firmware | Deliver a firmware artifact through the device runtime route without a local cable. |
install_application | Install the selected Application artifact while preserving its published identity. |
install_config | Install a verified .sencfg configuration artifact and its logical snapshot identity. |
install_license | Install a license artifact through the managed operation and verification workflow. |
install_secrets | Collect requested secret inputs for execution without persisting plaintext values in the intent or plan. |
Plan actions
| Value | Meaning |
|---|---|
provider_operation | Ask an executor provider to perform a declared local capability such as target inspection or ROM flashing. |
runtime_command | Send one versioned SenCore command through the route selected by the plan. |
input_command_set | Resolve an operation input request and execute its declared runtime command without storing the submitted value in the plan. |
artifact_transfer | Transfer a digest-pinned artifact in chunks using commands and state transitions declared by the plan. |
runtime_checkpoint | Reacquire a runtime route, execute checkpoint commands, and evaluate response assertions. |
Statuses
| Value | Meaning |
|---|---|
CREATED | Canonical statuses value. |
INSPECTING | Canonical statuses value. |
PLANNING | Canonical statuses value. |
WAITING_FOR_EXECUTOR | Canonical statuses value. |
WAITING_FOR_INPUT | Canonical statuses value. |
PREFLIGHT | Canonical statuses value. |
EXECUTING | Canonical statuses value. |
VERIFYING | Canonical statuses value. |
BLOCKED | Canonical statuses value. |
SUCCEEDED | Canonical statuses value. |
FAILED | Canonical statuses value. |
CANCELED | Canonical statuses value. |
Errors
| Value | Meaning |
|---|---|
invalid_intent | Canonical errors value. |
target_not_found | Canonical errors value. |
target_facts_incomplete | Canonical errors value. |
target_facts_changed | Canonical errors value. |
board_mismatch | Canonical errors value. |
artifact_digest_mismatch | Canonical errors value. |
capability_unavailable | Canonical errors value. |
executor_disconnected | Canonical errors value. |
device_busy | Canonical errors value. |
input_required | Canonical errors value. |
input_canceled | Canonical errors value. |
device_command_failed | Canonical errors value. |
verification_failed | Canonical errors value. |
operation_canceled | Canonical errors value. |
Contract details
| Field | Value |
|---|---|
| Contract | device_operation |
| Schema version | 1.0 |