The Divisible Workspaces Blueprint provides a drastically simplified installation for two-way and three-way combinable workspaces while leveraging Cisco Pro Series Microphones. This solution leverages the flexibility and customization capabilities within Room OS on Cisco Video Devices to provide a simplified "art of the possible" blueprint.
Important Considerations:
- All Macros are considered Custom Code and are NOT supported by Cisco through the Technical Assistance Center (TAC).
- The Divisible Workspace Blueprint is provided AS IS, please reference the license included in this repository.
The solution leverages the following:
- Cisco Codec EQs or Codec Pros
- Cisco Table or Ceiling Microphone Pros (up to 8)
- Cisco Room Vision PTZ / Cisco PTZ4K Cameras
- Cisco Catalyst 9K Series Switches
- Additional Macros including Audio Zone Manager Library
- Certified HDMI Distrubution Amplifiers: Certified Third Party Devices
| Minimum RoomOS Version | Webex Cloud | Webex Edge (Hybrid Cloud) | On-Premise | Microsoft Teams Room On Cisco Devices |
|---|---|---|---|---|
| 11.31 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ Not Supported |
The Divisible Workspace Blueprint is compatible with Room OS 26!
Please join this Webex messaging space for best effort and community level support: https://eurl.io/#nakTe_Vn3
Key Terminology: Top
| Term | Definition |
|---|---|
| Primary/Primary Codec | References the codec/workspace that provides the main control for all Divisible state changes. |
| Node /Node Codec | References the codec/workspace that will not have an active role in a combined state. |
| AV Integrator Option Key | References the add on license for the Codec EQ that enables Audio Console and advanced xAPIs for audio. |
| Audience Camera | Refers to the Quad Camera at the front of each room. |
| Presenter Camera | Refers to the Speaker Tracking enabled PTZ camera in each room. |
| Automation Mode | Refers to the automatic compositing/switching of the front of room audience cameras based on microphone activity. |
| Presenter Reinforcement | Describes the use of amplified speakers to project a presenter's audio into the same room they are being captured from. |
| File | Purpose |
|---|---|
| DWS_AZM_Lib.js | The Audio Zone Manager Library macro. This library contains the logic needed for clean audio based events. |
| DWS_Wizard.js | The initial setup wizard functionality loaded onto the Primary Codec. |
| DWS_Setup.js | A background macro that handles the installation and base configuration. |
| DWS_Core.js | The "main" macro that handles all logic. Runs on Primary Codec. |
| DWS_Node.js | The "secondary" macro that handles tasks on the Node Codecs. |
| DWS_Config.js | This autogenerated macro handles the "running" configuration on each codec. |
| DWS_State.js | This autogenerated macro handles saving state for reboots, etc. |
| DWS_Images.js | This file is used for storing long variables for better reability. |
| ciscortr.cfg | This is the pre-configured Cisco Catalyst 9K configuration file. |
Supported Hardware: Top
This blueprint has been validated with following Codecs:
- Codec Pro
- Codec EQ (AV Integrator license required on Primary)
The following Cameras have been validated:
- Cisco Quad Camera
- Cisco Room Vision PTZ
- Cisco PTZ4K
- Cisco P60
The following Microphones have been validated:
- Cisco Table Microphone Pro
- Cisco Ceiling Microphone Pro
The following models (SKUs) of switches have been validated:
- C9200CX-8P-2X2G-E
- C9200CX-12P-2X2G-E
- C9200L-24P-4G-E
- C9300L-24P-4G-E
- C9200-24P-E
- C9300-24P-E
Installation: Top
Follow the installation documentation that matches your network access and registration type:
Cloud & Hybrid (Control Hub) registration with network access to GitHub: Cloud Install Guide
On-premise registration (CUCM or Expressway) with network access to GitHub: Premise Install Guide
Any registration without network access to GitHub: Network Restricted Install Guide
These tables provides the supported combinations of codecs and number of secondary displays and their respective wiring diagram.
| Codec | # of Displays | Vison PTZ | PTZ4K/P60 |
|---|---|---|---|
| Codec EQ | Single | Diagram | Diagram |
| Codec EQ | Dual | Diagram | Not Supported |
| Codec Pro | Single | Diagram | Diagram |
| Codec Pro | Dual | Diagram | Diagram |
| Codec | # of Displays | Vison PTZ | PTZ4K/P60 |
|---|---|---|---|
| Codec EQ | Single | Diagram | Not Supported |
| Codec EQ | Dual | Diagram | Not Supported |
| Codec Pro | Single | Diagram | Diagram |
| Codec Pro | Dual | Diagram | Diagram |
Download the switch configuration based on your design:
| Switch Model | Two Way | Three Way |
|---|---|---|
| C9200CX-8P-2X2G-E | ciscortr.cfg | Not supported |
| C9200CX-12P-2X2G-E | ciscortr.cfg | ciscortr.cfg |
| C9200L-24P-4G-E | ciscortr.cfg | ciscortr.cfg |
| C9200-24P-E | ciscortr.cfg | ciscortr.cfg |
| C9300L-24P-4G-E | ciscortr.cfg | ciscortr.cfg |
| C9300-24P-E | ciscortr.cfg | ciscortr.cfg |
User Guide: Top
Access the end user documentation here: End User Guide
Administrator Guide: Top
Access the end user documentation here: Admin Guide
FAQ: Top
Is this a Cisco TAC supported deployment?
- No. This repository is a custom blueprint and is not supported through Cisco Technical Assistance Center. Implementation, troubleshooting and support is the express responsibility of the end customer and/or AV Integrator.
Do I need the AV Integrator Option Key / License?
- Yes! You will require the AV Integrator Option Key to be purchased and installed on the Primary Codec EQ. It is not required on any node Codec EQs. This is not required for Codec Pro (as this functionality is already included).
How many Microphone Pros (Ceiling and Table) can I use in each room?
- Combined mode operation can support a maximum of 8 microphones. They can be split amongst either room during split operation in any variation.
Can I use Third Party IP Microphones instead of Cisco Ceiling or Table Mic Pro with this blueprint?
- The blueprint provides support for only Cisco Pro Series Microphones as audience microphones. Third party audio support is limited to presenter use cases and must leverage USB or Analog.
How many divisible spaces can I combine with this blueprint?
- This blueprint is specifically designed to support two and three way divisible spaces only.
Is the blueprint compatible with "Cinematic Meeting" features such as Cross View or Extended Speaker Mode?
- TBD, the use of multi-camera cinematic features have not been validated with this blueprint.
Does this blueprint support Amplified Audio (in addition to the Quad Camera speakers)?
- Yes! The use of amplified audio output from the codecs is supported via USB and Analog outputs.
Does the blueprint support Speaker Reinforcement scenarios?
- Speaker reinforcement (projecting the presenters voice over amplified speakers in the same room) is supported by leveraging automatic microphone ducking (lowering/raising the gain of the Cisco Ceiling Microphones when the presenter speaks into the third party USB or analog microphones) or manual toggling of presenter or audience microphones using in call controls.
Where is the Partition Sensor?
- This blueprint does not leverage a partition sensor. The Combine/Split operation is manually controlled by the end user.
Can you help me make this do "X"?
- Any additional capabilities would require you or your AV Integrator to make and support any required modifications to the provided examples.
