Manage Device Sequences
A Device Sequence is a saved, ordered list of switching steps for the devices in an Assembly — for example, turn a device on, turn it off, or wait — that you trigger as one action instead of switching each device by hand. Use it to bring an Assembly into a defined hardware state, such as a power-cycle or reset routine, reproducibly.
When to use Device Sequences
- To bring an Assembly's devices into a defined state before or after a test run — for example, power off Board X, wait, then power on Board Y.
- To replace repetitive manual relay switching with a single, repeatable action.
- To let a CI pipeline or a CANoe test trigger a defined switching routine through the API.
Jumpers are not part of Device Sequences
A sequence only switches devices on/off or waits — it cannot set jumpers. Jumper configuration is separate; see Relay Card & Jumpers.
Create a Device Sequence
Prerequisites
- An Assembly you have access to manage
- The device IDs of the devices you want to switch, listed in the Assembly Profile
Steps
1. Open the sequence dialog
- Open the Create/Edit dialog for Device Sequences from the Assembly Dashboard view.
2. Name the sequence
3. Add the steps in the order they should run
- Each step is one of:
-
- Turn On / Turn Off — switch a single device, selected by its device ID
- Turn All On / Turn All Off — switch every device in the Assembly
- Wait — pause for a given duration before the next step
-
A Wait step takes a wait time, Turn On/Turn Off take a device ID — never both on the same step.
4. Set as default (optional)
- Enable Set as default sequence to bind the sequence to the run button on the Assembly Dashboard view. Only one sequence per Assembly can be the default.
Run a Device Sequence
Prerequisites
- A Device Sequence on the Assembly
- The Assembly up and running — booked, with its HAI connection active
Steps
1. Start the run
- Run the sequence from the Assembly Dashboard view, or use the run button for the default sequence. The current step and run status update live.
2. Cancel the run (optional)
- A canceled sequence stops after the current step finishes.
Every referenced device needs a working HAI connection
If the Assembly is not running, or a device referenced by a step is not reachable through its HAI, the run fails on that step.
Troubleshooting
| Symptom | Likely cause | Solution |
|---|---|---|
| Run fails immediately, no steps executed | The Assembly is not up and running | Make sure the Assembly is booked and its HAI connection is active, then retry. |
| Run fails on a specific step | The device referenced by that step has no working HAI connection | Check the device's connection in Assembly Monitoring, then retry. |
| A run stays in progress much longer than expected | Another run is already active on the same virtual machine | Runs on the same virtual machine are serialized — wait for the current run to finish, or cancel it. |
Edit or Delete a Device Sequence
Edit a sequence's name, steps, or default flag in the same Create/Edit dialog you created it in.
Deletion cannot be undone
Deleting a sequence removes it permanently, including its run history.
API Reference
Device sequences are also available through the vHaaS REST API — see Device Sequences endpoints for the full list of operations, including creating, running, and canceling a sequence programmatically.
Related
- Assembly — the test setup a Device Sequence belongs to
- Assembly Manager — controls devices directly from C# CANoe test code, instead of a sequence saved on the Assembly
- Relay Card & Jumpers — jumper configuration, which Device Sequences do not cover