ZUMNET-JBOX Setup

Version 4.1 by Alexander Mott on 2022/06/14 23:03

ZUMNET-JBOXs in SHOWRUNNER™

ZUMNET-JBOXs are part of Crestron's latest Zūm Wired system, acting as a the main lighting controller for a Zūm Wired room. In networked applications of Zūm Wired, they also act as bridges connecting the Zūm Link network in each room to the Zūm Net network throughout the building. Since Zūm Link and Cresnet are interchangeable and Zūm Net is an Ethernet protocol, this means that ZUMNET-JBOXs can be thought of as single-net DIN-CENCN-2s.

Much like DIN-CENCN-2s in SHOWRUNNER™ installations, the IP address of the ZUMNET-JBOX also does not matter as long as it is in the same range as the processor and does not conflict with any other devices on the network. Instead, ZUMNET-JBOXs are identified to the processor via their IP-ID. If devices are moved between ZUMNET-JBOXs, or if the ZUMNET-JBOX needs to have a different IP-ID than it was initially assigned, then the configuration will need to be updated (see below). Chief Integrations typically provides an SRTakeoff.xlsx spreadsheet with an IP Table tab that lists all the ZUMNET-JBOX IP-IDs in the program. If no takeoff is provided, then the processor's IP table can be checked by running the ipt -t command from the processor after the configuration is loaded. ZUMNET-JBOX's will typically start with IP-IDs in the 30-5F range, but can potentially exceed this range.

ZUMNET-JBOX IP Configuration

Configuring ZUMNET-JBOXs must be done over Ethernet, and is easiest to do once all ZUMNET-JBOXs have been installed, powered up, and connected to the lighting network. (It is not necessary for all Zūm Link devices to be installed in order to configure ZUMNET-JBOXs.)

Since there is no option to configure ZUMNET-JBOXs via USB, a DHCP server is required. There are three options for DHCP servers:

  • Using a processor with a Control Subnet (only available on certain processors)
  • Using the built-in SHOWRUNNER™ DHCP Server (available on all processors running SHOWRUNNER™ v3.009 or newer)
  • Using third party DHCP server software on your computer

Most devices (DIN-CENCN-2, TSW, ZUMNET-JBOXs) rely only on IP-ID to identify themselves to the processor, but some devices (such as GLPACs, DMX controllers, and other processors) have IP addresses that are explicitly defined in the configuration file. The DHCP server should be configured to assign IP addresses that are visible to the processor, but excluded from assigning these explicitly defined IP addresses if possible.

Configuring ZUMNET-JBOXs can be broken up into two separate processes: 

  1. Identifying which DHCP assigned IP address corresponds to each ZUMNET-JBOX
  2. Connecting to each ZUMNET-JBOX and assigning a permanent static IP and the correct IP-ID

Identifying ZUMNET-JBOXs

Once all ZUMNET-JBOXs have been assigned temporary IP addresses from the DHCP server, they must each be identified so that the correct IP-ID can be assigned. The goal is to associate each assigned IP address with the room that each ZUMNET-JBOX is meant to control. Then we can connect to each ZUMNET-JBOX and set static IP addresses and update the IP table with the correct IP-ID. 

If the electrical contractor has provided a list of which serial numbers/MAC addresses belong to each installed ZUMNET-JBOX, then it is relatively easy to identify which ZUMNET-JBOX should get which IP-ID:

  • Connect to the lighting network and open Device Discovery Tool in Toolbox
  • The Device Discovery tool will automatically report how many Ethernet devices have been discovered
    • Verify that the correct number of Ethernet devices have been discovered, including any TSWs, GLPACs, DIN-CENCN-2s, etc.
    • Note that only Crestron devices will appear in Device Discovery; non-Crestron devices (such as Pharos or Enttec DMX controllers) will not appear in Device Discovery Tool
  • Click the "Export..." button below the list of discovered devices
    • If this button says "Address Book", then Toolbox needs to be updated
  • Click the Write Device Summary and save the DeviceSummary.txt to your computer
  • The DeviceSummary.txt provides the IP address, MAC address, and serial number for each device on the network
  • Cross reference the DeviceSummary.txt with the serial numbers/MAC addresses provided by the installer in order to determine which ZUMNET-JBOX has been assigned each IP address
  • Update the SRTakeoff.xlsx with the device serial number, MAC address, and automatically assigned IP address for all ZUMNET-JBOXs

If the electrical contractor has not provided a list of which serial numbers/MAC addresses belong to each installed ZUMNET-JBOX, then it is necessary to connect to each ZUMNET-JBOX individually and identify them individually:

  • Connect to the lighting network and open Device Discovery Tool in Toolbox
  • Note the IP addresses for all of the installed ZUMNET-JBOXs
  • Connect to the first ZUMNET-JBOX using Network Device Tree View
  • Locate the "ZUMNET-JBOX-xx-xx-LOCAL" device in the list of connected devices
    • The model will vary between 0-10V and DALI JBOXs
    • The ID should be "03" regardless of model
  • Right click the device and press "Identify This Device..." from the context menu
  • The device will blink any attached fixtures and make an alarm sound
  • Walk around the jobsite until the room/controlled fixtures are located
  • Update the SRTakeoff.xlsx with the device serial number, MAC address, and automatically assigned IP address
  • Repeat all steps for each ZUMNET-JBOXs until all of the ZUMNET-JBOXs have been identified

Assigning Permanent Static IP Addresses and IP-IDs

Once you have identified which IP address has been assigned to each ZUMNET-JBOX, you can begin configuring them with permanent static IP addresses and the correct IP-ID:

  • Open Text Console in Toolbox and connect to the first ZUMNET-JBOX 
  • Run the following commands to configure the ZUMNET-JBOXs IP settings (example is for a 10.0.0.0/24 subnet, with a permanent IP address of 10.0.0.20, an IP-ID of 30, a processor IP address of 10.0.0.10, and a hostname of ZNET-JBOX-RM-201)
    • Disable DHCP: dhcp 0 off
    • Set IP address: ipa 0 10.0.0.20
    • Set IP subnet mask: ipm 0 255.255.255.0
    • Set default gateway: defr 0 10.0.0.1
    • Update IP table: addm 30 10.0.0.10
    • Set hostname: host ZNET-JBOX-RM-201
    • Reboot the ZUMNET-JBOX: reboot
  • Repeat for all ZUMNET-JBOXs on the job

ZUMNET-JBOX Specific Configuration

App vs Cresnet mode

Master vs Slave

Changing IP-IDs

If ZUMNET-JBOXs must be assigned different IP-IDs than indicated in the SRTakeoff.xlsx, or if Zūm Link devices are moved between ZUMNET-JBOXs, then the configuration file must be updated. Every Zūm Link device in the configuration has a "DeviceHostId" associated with it, which corresponds to the IP-ID of the ZUMNET-JBOX hosting it.

If a Zūm Link device is moved from one ZUMNET-JBOX to another, then this "DeviceHostId" must be updated with the IP-ID of the new device.

If a ZUMNET-JBOX is assigned a different IP-ID, then it's own "DeviceHostId" as well as the "DeviceHostId" for all hosted Zūm Link devices must be changed to the new IP-ID. In addition to changing these "DeviceHostId", the "IpId" for the associated entry in "IpDevices" must be updated. "IpDevices" are located towards the beginning of the configuration file. Note that while the "DeviceHostId" is in hexadecimal, the "IpId" is a decimal integer. This means that a ZUMNET-JBOX with "DeviceHostId": "31" would be associated with an entry in "IpDevices" with "IpId": 49

Below are two snippets from a configuration file comparing a ZUMNET-JBOX-16A-LV lighting controller and it's associated entry in "IpDevices":

1655247008527-737.png

1655246948921-246.png