Skip to main content
Works with: Cisco collaboration devices running RoomOS, including the Room Kit, Room Bar, Board, Desk and Codec series.

​
Before you start

  1. In the device’s web interface, add a local user with the Admin role for M.A.R.C.U.S. to use. The HTTP xAPI requires that role.
  2. Check HTTPS is enabled. It is by default; if NetworkServices HTTP Mode has been changed, it must still include HTTPS.
  3. RoomOS uses a self-signed certificate unless you’ve installed your own. If you haven’t, set the tls_skip_verify tag to true on the device.

​
Add the device

  1. In the portal, go to Devices and select New device.
  2. Choose the Collector that can reach the device, and set Protocol to Cisco RoomOS.
  3. Enter the settings below and save. The Collector picks up the new device within five minutes.
Tags are set under Advanced (JSON) → Tags in the device form, as a JSON object, for example {"tls_skip_verify": "true"}.

​
Readings

These values appear under Device Information on the device page, and can be checked in Room Readiness routines.

​
Commands

Each command is a button on the device page, and can be used in Room Readiness routines.
Power: Power Off puts the device into standby and Power On wakes it. The device page shows the standby state: Off (awake), Halfwake, EnteringStandby or Standby.
Diagnostics: Fault Count and Faults come from the device’s own health check. They include its Warning, Error and Critical messages, such as a camera that isn’t detected.