Create a routine
- In Room Readiness, open the Readiness checks tab and select Manage routines.
- Select Blank routine, or From standard template for a worked example that powers the room on, dials a test call from the codec, checks the microphones hear the returning audio, then hangs up. Edit its SIP address, and the DSP reading and preset command to match the names set up on your DSP.
- Give it a Name and a one-line Description.
- Add steps from the list on the right, then fill in each one. Drag steps to reorder them.
- Select Save changes.
Steps
Ping
Ping checks the network path to a device, not the device’s own control connection. Use it on one device or on the whole room. Devices on a serial port have no address to ping, so a whole-room or device-type ping leaves them out. Each device gets 3 pings by default, up to 10, and each ping has a second to reply. With no limits set, any reply passes. The result shows each device’s replies and average response time, such as Replied 3/3, 4 ms. Ping steps need Collector version 1.0.69 or later. On an older Collector the step fails and says the Collector needs updating.Up-to-date readings
Expect status and Check metric ask the Collector to check each device there and then, so they see the room as it is now, not as it was at the last scheduled check, which can be several minutes earlier. Allow up to a minute for a step that checks many devices. PDUs are the exception. They aren’t checked on demand, because they log in for each reading; steps use their latest regular reading instead, which can be up to 10 minutes old. If a device’s Collector can’t take a reading (it’s offline, or older than version 1.0.35), the step uses the device’s last report instead and says so if it fails. For Check metric that last report must be from within the Sample window: 5 seconds for a new step, or 30 seconds if you leave it empty. Update older Collectors from the Collectors page.Choose the devices
Every step except Section and Wait has a Target:- Whole room: every device in the room;
- By device type: every display, camera, video codec, DSP / audio, control panel, AV-over-IP or power / PDU device in the room;
- Specific device: one named device.
When a step fails
Set On failure on each step:
Any failed step marks the room as Failed, whichever option you choose. Power on, Power off and Device command steps have a Timeout (seconds); one that runs past it fails. Check metric has a Sample window (seconds) instead.
Diagram
Select Diagram to see the routine as a flow chart: each step in order, sections as bands around their steps, and what happens when each step fails (the run stops, carries on, or retries). It shows the routine as it is in the builder, including changes you haven’t saved yet. Download it as PNG for documents and email, or SVG to scale it in Word or PowerPoint.Advanced JSON
Select Advanced JSON to edit the steps as JSON, for example to copy a routine between environments. Switch back to Builder to carry on visually.Try it on a room
Select Test on a room, pick a room and start. The routine runs straight away against that room, whatever routine it normally uses, and you’re taken to the run to watch each step’s result arrive. Save your changes first.Updated 06 Nov 2026 14:07 · page 459294b