Changes for page Zūm Net Device Setup

Last modified by Alexander Mott on 2024/10/22 19:55
From version 29.1
edited by Alexander Mott
on 2022/09/19 16:08
Change comment: There is no comment for this version
To version 10.3
edited by Alexander Mott
on 2022/06/17 16:47
Change comment: There is no comment for this version

Summary

Details

Page properties
Parent
... ... @@ -1,1 +1,1 @@
1 -SHOWRUNNER™ Setup Guide.SHOWRUNNER™ Installation Guide.SHOWRUNNER™ Installation and Network Setup.WebHome
1 +SHOWRUNNER™ Setup Guide.SHOWRUNNER™ Installation Guide.WebHome
Content
... ... @@ -1,20 +1,10 @@
1 -(% class="box warningmessage" %)
2 -(((
3 -This article is for configuring Zūm Net devices using Crestron Toolbox. For instructions on configuring Zūm Wired rooms using the Crestron Zūm App, see [[this page>>SHOWRUNNER™ Setup Guide.Wiring Guide.Zūm Wired System Overview.Crestron Zūm App Overview.WebHome]].
4 -)))
1 +=== Zūm Net Devices in SHOWRUNNER™ ===
5 5  
6 -{{box cssClass="floatinginfobox" title="**CONTENTS**"}}
7 -{{toc/}}
8 -{{/box}}
9 -
10 -(% class="row" %)
11 -(((
12 -
13 13  Zūm Net devices 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 local Zūm Link devices in each room to the overall lighting network throughout the building. Since Zūm Link and Cresnet are [[interchangeable>>https://wiki.chiefintegrations.com/SHOWRUNNER%E2%84%A2%20Setup%20Guide/Wiring%20Guide/Wiring%20Overview/Z%C5%ABm%20Net/#HZ16BmLink]], and Zūm Net is an Ethernet protocol, this means that Zūm Net devices can be thought of as single-net DIN-CENCN-2s. As of Summer 2022, there are only two Zūm Net devices that have been announced and are in production: the ZUMNET-JBOX-16A-LV 0-10V load controller and the ZUMNET-JBOX-DALI DALI load controller. Configuring these devices for use with SHOWRUNNER™ is identical, so they will be referred to collectively as ZUMNET-JBOXs for the purposes of this article.
14 14  
15 15  Much like DIN-CENCN-2s in SHOWRUNNER™ installations, ZUMNET-JBOXs identify themselves to the processor via their IP-ID, so the specific IP address of any given ZUMNET-JBOX 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. If hosted devices are moved between ZUMNET-JBOXs, or if the ZUMNET-JBOX needs to have a different IP-ID than it was initially assigned, the configuration will need to be updated (see below). Chief Integrations typically provides an SRTakeoff.xlsx spreadsheet which will list all the Zūm Net and Zūm Link devices and their associated IP-IDs. 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.
16 16  
17 -= Identification and IP Configuration =
7 +=== Identification and IP Configuration ===
18 18  
19 19  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.)
20 20  
... ... @@ -31,7 +31,7 @@
31 31  1. Identifying which DHCP assigned IP address corresponds to each ZUMNET-JBOX
32 32  1. Connecting to each ZUMNET-JBOX and assigning a permanent static IP address and IP-ID
33 33  
34 -== Identifying ZUMNET-JBOXs ==
24 +==== Identifying ZUMNET-JBOXs ====
35 35  
36 36  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.
37 37  
... ... @@ -39,7 +39,7 @@
39 39  
40 40  1. Identifying by hostname
41 41  1. Identifying by serial number or MAC address
42 -1. Identifying through Device Tree View
32 +1. Identifying through Toolbox
43 43  
44 44  Each of these methods involves generating a Device Summary using the Device Discovery Tool in Toolbox. The Device Summary is a file which lists all devices that are discoverable on the network along with useful information such as their hostname, IP address, and MAC address.
45 45  
... ... @@ -53,52 +53,32 @@
53 53  ** If some devices are missing, there may be an issue with your DHCP server settings or the network wiring
54 54  * Click the "Export..." button below the list of discovered devices
55 55  ** If this button says "Address Book", then Toolbox needs to be updated
56 -* Click the Write Device Summary button and save the Device Summary to your computer
57 -** Though saved as a text file, the Device Summary is actually a table of comma separated values
58 -** Renaming DeviceSummary.txt to DeviceSummary.csv will allow it to be opened and manipulated in common spreadsheet software such as Microsoft Excel or LibreOffice Calc
46 +* Click the Write Device Summary button and save the DeviceSummary.txt to your computer
47 +* The DeviceSummary.txt provides the IP address, MAC address, and serial number for each device on the network
48 +* 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
49 +* Update the SRTakeoff.xlsx with the device serial number, MAC address, and automatically assigned IP address for all ZUMNET-JBOXs
59 59  
60 -Below is an example of a Device Summary for a fully-configured job:
51 +===== Identifying by Hostname =====
61 61  
62 -* DeviceSummary.txt:
63 -[[image:1655487020590-542.png]]
64 -* DeviceSummary.csv:
65 -[[image:1655487132138-904.png]]
53 +Oftentimes,
66 66  
67 -Once the Device Summary has been generated, proceed to identifying each ZUMNET-JBOX using the hostname, SN/MAC, or Device Tree View methods described below.
55 +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:
68 68  
69 -=== Identifying by Hostname ===
57 +* Connect to the lighting network and open Device Discovery Tool in Toolbox
58 +* The Device Discovery tool will automatically report how many Ethernet devices have been discovered
59 +** Verify that the correct number of Ethernet devices have been discovered, including any TSWs, GLPACs, DIN-CENCN-2s, etc.
60 +** 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
61 +* Click the "Export..." button below the list of discovered devices
62 +** If this button says "Address Book", then Toolbox needs to be updated
63 +* Click the Write Device Summary button and save the DeviceSummary.txt to your computer
64 +* The DeviceSummary.txt provides the IP address, MAC address, and serial number for each device on the network
65 +* 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
66 +* Update the SRTakeoff.xlsx with the device serial number, MAC address, and automatically assigned IP address for all ZUMNET-JBOXs
70 70  
71 -The Crestron Zūm App is used to configure the internal logic of Zūm Wired rooms. This internal logic determines the room behavior when ZUMNET-JBOXs are used in standalone applications or if communication to the processor is lost. Even on SHOWRUNNER™ jobs with a central program running the lighting controls, it is best practice to configure the internal logic to match as closely as possible the SHOWRUNNER™ logic in order to minimize disruption to end-users in the event of a processor or network failure.
68 +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 through Toolbox. Putting a device into identify will stop any programs running on a processor, and taking a device out of identify mode will restart the program. This starting/stopping of the program can be time consuming when a large number of devices are being identified, so it may be a good idea to run the ##stopprog -p:01## command on the processor prior to identifying devices. Once all the devices are identified, run the ##progreset## command to resume the program.
72 72  
73 -In addition to configuring default room logic, the Crestron Zūm App can be used to change the hostname of the ZUMNET-JBOX for each room. By default, the hostname for a ZUMNET-JBOX is the model followed by the last six digits of the MAC address, e.g. "ZUMNET-JBOX-16A-LV-F2DA94". If you or the electrical contractor already intend to configure the internal logic each ZUMNET-JBOX, it would be a good idea to also change the hostname to something more identifiable.
74 -
75 -To change the hostname using the Crestron Zūm App:
76 -
77 -* Connect to the ZUMNET-JBOX in the App
78 -* Tap "Room Settings"
79 -* Tap "Network"
80 -* Tap the Hostname field and edit the Hostname
81 -* Scroll to the bottom of the page and tap "Save settings"
82 -* Tap "OK" to apply the changes and reboot the ZUMNET-JBOX
83 -** Note that rebooting the JBOX will cause the lights to briefly cut out
84 -
85 -If all hostnames have been set, then it becomes very easy to know which DHCP assigned IP address is associated with each room using the Device Summary. Generate a Device Summary with the new hostnames and proceed to IP configuration.
86 -
87 -Full instructions on configuring Zūm Wired using the Crestron Zūm App, can be found [[here>>SHOWRUNNER™ Setup Guide.Wiring Guide.Zūm Wired System Overview.Crestron Zūm App Overview.WebHome]].
88 -
89 -=== Identifying by Serial Number or MAC Address ===
90 -
91 -Both the serial number and MAC address are printed onto each ZUMNET-JBOX. Just like with Cresnet jobs, it is good practice for the electrical contractor to record serial numbers as they install devices. It is also good to collect the MAC addresses, but it is not necessary since Device Summary will have both the serial number and MAC address.
92 -
93 -If the electrical contractor has provided a list of which serial numbers/MAC addresses belong to each installed ZUMNET-JBOX, then generate a Device Summary and proceed to IP configuration.
94 -
95 -=== Identifying through Network Device Tree View ===
96 -
97 -If the electrical contractor has not provided a list of which serial numbers/MAC addresses belong to each installed ZUMNET-JBOX and nobody intends to rename each ZUMNET-JBOX using the Crestron Zūm App, then the only way to identify which ZUMNET-JBOX is installed where is to use the Device Tree View tool in Toolbox. This is by far the slowest and most disruptive way to identify devices, so it is only recommended as a last resort.
98 -
99 -Putting a ZUMNET-JBOX into identify mode will make it continuously produce an alarm-clock sound and flash any connected loads. Additionally, putting a device into identify mode will stop any programs running on a processor, and taking a device out of identify mode will restart the program. This starting/stopping of the program can be time consuming when a large number of devices are being identified, so it may be a good idea to suspend the program using the ##stopprog -p:01## command on the processor prior to identifying devices. Once all the devices are identified, run the ##progreset## command to resume the program.
100 -
101 -* Generate a Device Summary and note the IP addresses for all installed ZUMNET-JBOXs
70 +* Connect to the lighting network and open Device Discovery Tool in Toolbox
71 +* Note the IP addresses for all of the installed ZUMNET-JBOXs
102 102  * Connect to the first ZUMNET-JBOX using Network Device Tree View
103 103  * Locate the "ZUMNET-JBOX-xx-xx-LOCAL" device in the list of connected devices
104 104  ** The model will vary between 0-10V and DALI JBOXs
... ... @@ -106,17 +106,15 @@
106 106  * Right click the device and press "Identify This Device..." from the context menu
107 107  * The device will blink any attached fixtures and make an alarm sound
108 108  * Walk around the jobsite until the room/controlled fixtures are located
109 -* Edit the Device Summary or SRTakeoff.xlsx so that you remember which JBOX is which
110 -* Repeat for each ZUMNET-JBOX until all of the ZUMNET-JBOXs have been identified
79 +* Update the SRTakeoff.xlsx with the device serial number, MAC address, and automatically assigned IP address
80 +* Repeat all steps for each ZUMNET-JBOXs until all of the ZUMNET-JBOXs have been identified
111 111  
112 -Once you have determined and recorded which ZUMNET-JBOX is which, you may proceed to IP configuration.
82 +==== Assigning Permanent Static IP Addresses and IP-IDs ====
113 113  
114 -== Assigning Permanent Static IP Addresses and IP-IDs ==
115 -
116 116  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:
117 117  
118 118  * Open Text Console in Toolbox and connect to the first ZUMNET-JBOX
119 -* Run the following commands to configure the ZUMNET-JBOXs IP settings (example is for a **10.0.0.0(% style="color:darkgoldenrod" %)/24(%%)** subnet, with a permanent IP address of (% style="color:blue" %)**10.0.0.80**(%%), an IP-ID of (% style="color:olive" %)**30**(%%), a processor IP address of (% style="color:orange" %)**10.0.0.10**(%%), and a hostname of (% style="color:#800080" %)**ZNET-JBOX-RM-201**(%%); the hostname can be skipped if it has already been configured from the Crestron Zūm App)
87 +* Run the following commands to configure the ZUMNET-JBOXs IP settings (example is for a **10.0.0.0(% style="color:darkgoldenrod" %)/24(%%)** subnet, with a permanent IP address of (% style="color:blue" %)**10.0.0.80**(%%), an IP-ID of (% style="color:olive" %)**30**(%%), a processor IP address of (% style="color:orange" %)**10.0.0.10**(%%), and a hostname of (% style="color:#800080" %)**ZNET-JBOX-RM-201**(%%))
120 120  ** Disable DHCP: ##dhcp off##
121 121  ** Set IP address: ##ipa 0 (% style="color:blue" %)**10.0.0.80**(%%)##
122 122  ** Set IP subnet mask: ##ipm 0 (% style="color:darkgoldenrod" %)**255.255.255.0**(%%)##
... ... @@ -124,17 +124,18 @@
124 124  ** Update IP table: ##addm (% style="color:olive" %)**30**(%%) (% style="color:orange" %)**10.0.0.10**(%%)##
125 125  ** Set hostname: ##host (% style="color:purple" %)**ZNET-JBOX-RM-201**(%%)##
126 126  ** Reboot the ZUMNET-JBOX: ##reboot##
127 -*** Note that rebooting the JBOX will cause the lights to briefly cut out
128 128  * Repeat for all ZUMNET-JBOXs on the job
129 129  
130 -= Zūm Net Specific Configuration =
97 +=== Zūm Net Specific Configuration ===
131 131  
132 -Zūm Net devices have a two additional settings not present for other devices: Zūm/Cresnet mode and Master/Slave mode. ZUMNET-JBOXs should ship as Master devices in Zūm Mode from the factory, and this is typically the desired setting.
99 +Zūm Net devices have a two additional settings not present for other devices: Zūm/Cresnet mode and Master/Slave mode.
133 133  
134 -== Zūm/Cresnet Mode ==
101 +==== Zūm/Cresnet Mode ====
135 135  
136 -Zūm Mode (also known as App Mode) is the default setting for new ZUMNET-JBOXs, and allows them to be configured from the Crestron Zūm App. If a ZUMNET-JBOX is put into Cresnet mode, it will no longer be able to be configured using the Crestron Zūm App and all internal logic will be disabled. Generally, Cresnet mode is only required if non-Zūm Link devices are connected to the ZUMNET-JBOX (e.g. a GL-EXP-DIMU-CN phase dimmer or C2N-CBD-P Cameo keypads) or if certain SHOWRUNNER™ features are required (such as changing the dimming response curve).
103 +ZUMNET-JBOXs should ship in "Zūm Mode" by default, also known as "App Mode" because this is the setting required to be able to configure Zūm Wired rooms using the Crestron Zūm Mobile App.
137 137  
105 +If a ZUMNET-JBOX is put into Cresnet mode, it will no longer be able to be configured using the App and all internal logic will be disabled. Generally, Cresnet mode is only required if non Zūm Link devices are connected to the ZUMNET-JBOX (e.g. a GL-EXP-DIMU-CN phase dimmer or C2N-CBD-P Cameo keypads).
106 +
138 138  The commands to view or change the Zūm/Cresnet mode are:
139 139  
140 140  * View current mode: ##zwmode##
... ... @@ -143,10 +143,12 @@
143 143  
144 144  A reboot is required if the mode is to be changed. Note that this command will also display the current Master/Slave mode, but will not allow you to change it.
145 145  
146 -== Master/Slave Mode ==
115 +==== Master/Slave Mode ====
147 147  
148 -ZUMNET-JBOXs ship in "Master" mode by default, and generally this is how they should be configured. "Slave" mode effectively turns a ZUMNET-JBOX into a ZUMLINK-JBOX. There are two scenarios in which a ZUMNET-JBOX will need to be configured in "Slave" mode:
117 +ZUMNET-JBOXs should ship in "Master" mode by default, and generally this is how they should be configured.
149 149  
119 +"Slave" mode effectively turns a ZUMNET-JBOX into a ZUMLINK-JBOX. There are two scenarios in which a ZUMNET-JBOX will need to be configured in "Slave" mode:
120 +
150 150  1. It is connected to another ZUMNET-JBOX via the Zūm Link bus
151 151  1. It is being used as a Cresnet device, connected to a processor or DIN-CENCN-2 using a Cresnet/Zūm Link adapter
152 152  
... ... @@ -158,7 +158,7 @@
158 158  
159 159  A reboot is required if the mode is to be changed.
160 160  
161 -= Changing IP-IDs =
132 +=== Changing IP-IDs ===
162 162  
163 163  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.
164 164  
... ... @@ -171,8 +171,3 @@
171 171  [[image:1655247008527-737.png]]
172 172  
173 173  [[image:1655246948921-246.png]]
174 -
175 -= Problems Connecting to Zūm Room (Error 13) =
176 -
177 -{{display excludeFirstHeading="true" reference="SHOWRUNNER™ Setup Guide.Wiring Guide.Zūm Wired System Overview.Crestron Zūm App Overview.WebHome" section="HProblemsConnectingtoZ16BmRoom28Error1329"/}}
178 -)))
1655487002500-174.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,1 +1,0 @@
1 -51.5 KB
Content
1655487008788-390.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,1 +1,0 @@
1 -51.5 KB
Content
1655487020590-542.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,1 +1,0 @@
1 -51.5 KB
Content
1655487132138-904.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,1 +1,0 @@
1 -53.0 KB
Content