Shure System API Server Integration Guide

This document serves as a comprehensive guide that outlines the prerequisites required to successfully integrate the Shure System API Server, which provides connectivity to devices such as MXA microphones and DSPs such as P300 and ANIUSB, with the NetSpeek platform.

This device type uses a concept called “sub-integration” which means that the Edge VM uses another component to reach orchestrated devices. In the case of this integration, that component is the Shure System API Server, which is described in Shure’s documentation here. Please review Shure’s documentation and ensure that all requirements, specifically minimum firmware versions, are met.

For the full list of devices from Shure currently supported by NetSpeek via the integration method described here, see NetSpeek Supported Devices and Controls.

Note also that the Shure IMX Compute system (also known as Intellimix Room Kit) is not addressed by this integration guide. IMX Compute is integrated directly with the NetSpeek Edge VM, and does not require the System API Server sub-integration described here. For the Intellimix guide, see Shure Intellimix Compute Integration Guide.

Prerequisites

Before beginning the integration, confirm the following:

  • Your Shure System API Server, and any devices to be orchestrated through it, are powered on and connected to the same network as your NetSpeek Edge.
  • You have deployed a NetSpeek Edge client as described here: https://docs.netspeek.ai/netspeek-edge-installation-guide/
    • Note: This integration requires an Edge running software version 1.1 or later.
  • Deploying and configuring the Shure System API Server, and Shure microphones, speakers, wireless receivers, DSPs, or other components controlled by the API server, is outside the scope of this document. This guide assumes an operational Shure environment.

Step 1. Create Sub-Integration (Tenant-Level)

Sub-Integration Configuration

This step assumes an Edge VM is already deployed – the sub-integration is added as a configuration parameter to the Edge at the tenant level.

  1. Navigate to Settings → Tenant Management → (select tenant) → Integrations
  2. Click Add Integration
  3. Choose the Shure System API integration type.
    1. Note that for integrations where a sub-integration applies (and only those integrations), a “Parent Integration” field is shown.
  4. Select the appropriate NetSpeek Edge VM to serve as the parent.

Configure the relevant data about the System API Server (its IP address, API Key, Passphrase, and port if necessary) such as in the image below.

Step 2. Add Device to NetSpeek Room Canvas

Device Provisioning Flow

  1. In the NetSpeek Console, navigate to Room Management
  2. Select the room you wish to add your Shure device to
  3. Click Launch Room Canvas
  4. Click Add device to room
  5. Choose the appropriate device from the device model list.
  6. Select a previously created NetSpeek Edge VM sub-integration from Step 1, and ensure that the Edge VM is on a network that can reach the Shure System API Server’s configured IP address
  7. In the configuration panel, enter the necessary fields:
    • IP address is an optional field for display purposes – the integration with the Shure System API Server is based on the Serial Number of the device (meaning microphone/DSP/etc) being orchestrated.

Verification

Once credentials are configured:

  • To validate the integration, select a Shure device in the NetSpeek console, open the Device Actions Tab, and select an available device action.
  • On the device, observe the selected action occurring.

Troubleshooting

Connection Issues

  • Confirm the IP address is correct and reachable from the NetSpeek network.
  • Ensure the port used is not blocked by firewall rules on the machine running your NetSpeek Edge.
  • Ensure the Shure System API Server is operational, and that components controlled by it are powered on and configured correctly.

Support

If you run into any issues during onboarding or have questions, contact NetSpeek Support at support@netspeek.com.