Pexip Layout Controls for Cisco endpoints

You can enhance your meeting room experience with the Pexip Layout Controls feature, which allows you to switch between different conference layouts using the touch panel of a Cisco room system during a call. Participants must be dialed in as a host participant to use this control but the Pexip Layout Controls button still appears for all participants, including endpoints, on the touch panel.

The Pexip Layout Controls feature uses the Layout Controls macro installed on the endpoint, which sends DTMF digits to the conference. You can still use the endpoint's keypad to change the layout and manage meetings but the Layout Controls macro provides an improved user experience with the addition of the Layout Controls button on the endpoint's touch panel.

On this page:

Supported endpoints and conferences

Pexip Layout Controls is supported:

  • on Cisco Room Devices MX, SX, DX and Room Kit Series, but not SX10.
  • in Pexip, BlueJeans, Zoom, or Webex conferences.

Prerequisites

  • Firmware CE9.14 or newer, or RoomOS 10 or newer.
  • Admin user access to the Cisco endpoint for configuration.

Manual installation of Pexip Layout Controls

The following instructions explain how to install the Layout Controls macro manually on a single endpoint. If you use Enhanced Room Management (ERM) and want to provision the macro on multiple endpoints simultaneously, proceed to ERM installation of Pexip Layout Controls.

During the macro installation, you will require some or all of the following files so we recommend that you download them now.

Download link Required?

macro.js

Required in all installations.

settings.js

Required in all installations.

checksum.txt

Optional file to verify the macro.js file. Instructions on how to verify are described below.

To verify the macro you can use the following commands and compare the value to the file in checksum.txt.

Windows

certutil -hashfile C:/Users/user1/Downloads/macro.js SHA256

Linux

sha256sum [file location].

Example:

sha256sum ~/Downloads/macro.js

MacOS

shasum -a 256 [file location].

Example:

shasum -a 256 ~/Downloads/macro.js

Installing the Layout Controls macro

  1. Log into the web interface of your Cisco endpoint in your browser.
  2. Go to Macro Editor.

  3. Select Enable Macros. This prompt only appears if you have never used a macro before.
  4. In the Macro Editor, select Import from file and select the settings file (settings.js) that you downloaded earlier.
  5. Select the Save to video system icon:

  6. Select Import from file again, and select the macro file (macro.js) that you downloaded earlier.
  7. Select the Save to video system icon.

  8. Toggle the macro switch from off to on.
  9. Refresh the web page.

With immediate effect, the touch panel of the Cisco endpoint shows the Layout Controls button during conferences and is ready for use by host participants.

If required, you can rename the macro in the Macro Editor. You must not rename the settings file but you can edit the default settings.

Edit default macro settings

The default settings contain 3 pre-defined conferencing providers as shown below:

const DTMF_Macro_Settings = [

{"id":"ZoomRC","name":"ZOOM","dtmf":"11"},

{"id":"bjn.vc","name":"BJN","dtmf":"*1"},

{"id":"@.*\\.webex","name":"WEBEX","dtmf":"2"}

]

You can modify, add, or delete entries as you wish.

  • ID: RegEx to match the domain.
  • name: name of the conferencing provider that is prompted on logs.
  • dtmf: the DTMF digits to send.

Troubleshooting

If you need to troubleshoot the Layout Controls macro at any point, you can download logs from the web interface in

System Maintenance > Issues and Diagnostics > Systems logs > Download logs...

ERM installation of Pexip Layout Controls

If you use Enhanced Room Management (ERM), you can enable Pexip Layout Controls on multiple endpoints simultaneously.

During the macro installation, you will require some or all of the following files so we recommend that you download them now.

Download link Required?

macro.js

Required in all installations.

settings.js

Required in all installations.

checksum.txt

Optional file to verify the macro.js file. Instructions on how to verify are described below.

To verify the macro you can use the following commands and compare the value to the file in checksum.txt.

Windows

certutil -hashfile C:/Users/user1/Downloads/macro.js SHA256

Linux

sha256sum [file location].

Example:

sha256sum ~/Downloads/macro.js

MacOS

shasum -a 256 [file location].

Example:

shasum -a 256 ~/Downloads/macro.js

Installing Layout Controls macro in ERM

  1. Go to Enhanced Room Management > Panels and macros.
  2. On the Room Controls tab, select the + button.

  3. Enter a title and description for the settings.
  4. Attach the settings.js file that you downloaded earlier and select Add.
  5. Again, select the + button.
  6. Enter a title and description for the macro.
  7. Attach the macro.js file that you downloaded earlier and select Add.

The Layout Controls macro and settings are now installed in ERM.

Provisioning Pexip Layout Controls on multiple endpoints in ERM

The following instructions explain how to provision one or more Cisco endpoints in ERM with Pexip Layout Controls.

  1. Go to Enhanced Room Management > Systems.
  2. On the Search tab, select all room systems that you want to deploy the Pexip Layout Controls to.
  3. Select Provisioning.
  4. Select Apply macros/panels and from the Controls options select Layout Controls macro.
  5. To enable the macro on the endpoints with immediate effect select Apply, otherwise select Schedule for the night.