Skip to Content

Changes for page Zūm Discovery

Last modified by Austin Weygandt on 2025/05/02 20:21
From version 6.5
edited by Alexander Mott
on 2022/09/22 23:47
Change comment: (Autosaved)
To version 3.1
edited by Alexander Mott
on 2022/09/22 21:47
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -Zūm Discovery
1 +Zūm Autodiscovery
Content
... ... @@ -1,6 +1,6 @@
1 1  (% class="box warningmessage" %)
2 2  (((
3 -This article is about automatically building a SHOWRUNNER™ configuration using the Zūm Discovery feature of SHOWRUNNER™. 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]].
3 +This article is about automatically building a SHOWRUNNER™ configuration using the Zūm Autodiscovery feature of SHOWRUNNER™. 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 4  For instructions on configuring Zūm Net devices using Crestron Toolbox, see [[this page>>doc:SHOWRUNNER™ Setup Guide.SHOWRUNNER™ Installation Guide.SHOWRUNNER™ Installation and Network Setup.ZUMNET-JBOX Setup.WebHome]].
5 5  )))
6 6  
... ... @@ -10,97 +10,70 @@
10 10  
11 11  (% class="row" %)
12 12  (((
13 -If Zūm Wired or Wireless devices have been configured using Crestron's Zūm App, then it is possible to automatically build a SHOWRUNNER™ configuration file using the Zūm Discovery feature that is built into SHOWRUNNER™.
13 +If Zūm Net devices have been configured using Crestron's Zūm App
14 14  
15 -There are certain pre-requisites and limitations when building a SHOWRUNNER™ configuration this way, and it may sometimes be necessary make some adjustments to the final configuration, such as changing keypad types and moving loads between areas.
15 += Zūm Wired =
16 16  
17 -= Zūm Wired Discovery =
17 +Lorem
18 18  
19 -== Notes and Limitations ==
19 += Zūm Wireless =
20 20  
21 -* SHOWRUNNER™ version 3.014 or newer required
22 -* Zūm Wired firmware version 1.02.10 or greater required
23 -* Disconnect from any ZUMNET devices you may be connected to in Toolbox prior to running the discovery commands
24 -* Cresnet devices landed on Zūm Link will not be discovered (Crestron bug expected to be corrected in a future firmware release)
25 -* One area will be created per ZUMNET-JBOX; if there are more areas than ZUMNET-JBOXs, additional areas must be created manually
26 26  
27 -== Steps ==
22 +As of version 2.190 ShowRunner can discover RF Gateways and attached Zum NETBRIDGES. ShowRunner will find all devices, set them up, create areas and loads.
23 +*Disconnect from the gateway before discovery as they cannot support multiple connections*
24 +*Plug loads do not appear in the UI*
28 28  
29 -1.
26 +== Pre-Requisites: ==
30 30  
31 -= Zūm Wireless Discovery =
28 +* Zum NETBRIDGES acquired to their respective gateway (CEN-GWEXER/ZUMNET-GATEWAY)
29 +* ShowRunner installed and running on a 3-series processor on the same network as the gateway
30 +* NETBRIDGES do not need to have addresses assigned. ShowRunner will automatically address them. If devices all already addressed then their addresses will be honored.
32 32  
33 -== Notes and Limitations ==
34 -
35 -* Processor with SHOWRUNNER™ version 2.190 or newer must be running on the same network as the gateway(s) to be acquired
36 -** For SHOWRUNNER™ versions 3.014 and newer, replace ##sr discover zum## commands with ##sr discover zummesh##
37 -* ZUM-NETBRIDGES must already be acquired to their respective gateway
38 -* SHOWRUNNER™ will automatically address any ZUM-NETBRIDGES that do not need have addresses assigned, but will still honor any already addressed devices
39 -* Disconnect from any RF gateways you may be connected to in Toolbox prior to running the discovery command
40 -* Plug loads will not appear in the SHOWRUNNER™ UI
41 -)))
42 -
43 43  (% class="box warningmessage" id="HCaution:" %)
44 44  (((
45 -**Note:** SHOWRUNNER™ has two different approaches for Zūm Wireless Discovery
46 -
47 -1. **Manual RF Gateway Assignment** - SHOWRUNNER™ can be told which gateways it should scan. Use this approach if you have gateways that are used by multiple systems on the same local network.
48 -1. **Claim All RF Gateways** - SHOWRUNNER™ will find all CEN-GWEXERs [ZUMNET-GATEWAY] on the network and will claim them as its own. **DO NOT** use this method if there are gateways used by different SHOWRUNNER™ or other Crestron systems on the same local network.
34 +**Note,** SHOWRUNNER has two different types of Zum Wireless autodiscovery:
35 +1. Claim All RF Gateways - ShowRunner will find all CEN-GWEXERs [ZUMNET-GATEWAY] on the network and will claim them as its own.  DO NOT use this method if there are gateways used by different ShowRunner or other Crestron systems on the same local network.
36 +1. Manual RF Gateway Assignment - ShowRunner can be told which gateways it should scan. Use this approach if you have gateways that are used by multiple systems on the same local network.
49 49  )))
50 50  
51 -(% class="row" %)
52 -(((
53 -== Manual RF Gateway Assignment Instructions ==
39 +== Option 1: Claim All Gateways: ==
54 54  
55 -Use this method if you have multiple SHOWRUNNER™ instances on the same network or have gateways used by other Crestron systems.
41 +Use this method when you have a single ShowRunner instance on a local network with all gateways being used for ShowRunner.
56 56  
57 57  * Connect to the processor's console with Toolbox or your favorite SSH client.
58 -* Type "//sr devmgr ethernet query//" and press enter. This queries the local network for RF Gateways.
59 -* Type "//sr devmgr ethernet show devices//" and press enter. This displays all found Crestron ethernet devices.
60 -* For each gateway that you'd like this instance of SHOWRUNNER™ to use, use the hostname from the table of found ethernet devices. For example if the gateway Hostname is CEN-GWEXER-9E6ADA type "//sr ethernet device claim CEN-GWEXER-9E6ADA//". SHOWRUNNER™ will auto-assign an IP-ID. After all gateways have been claimed by SHOWRUNNER™, proceed to the next step.
61 -* Type "//sr discover zum false//" and press enter.
62 -* Status messages and the results will be displayed on the console. The process should take about 3 minutes.
63 -* When the discovery is finished type "//sr save//" and press enter to save the updated config. Due to an unknown quirk that we are looking into, SHOWRUNNER™ must be restarted to complete the acquire process.
64 -* Type "//progreset//" and press enter to restart SHOWRUNNER™
65 -* Once SHOWRUNNER™ has finished restarting type "//sr discover zum false//" and press enter. SHOWRUNNER™ will be able to acquire the loads attached to the Zūm rooms at this point.
66 -* Once completed SHOWRUNNER™ is now ready for full Zūm control
44 +* Type "//sr discover zum true//" and press enter.
45 +* Status messages and the results will be displayed on the console. The process should take about 3 minutes.
46 +* When the discovery is finished type "//sr save//" and press enter to save the updated config. Due to an unknown quirk that we are looking into, ShowRunner must be restarted to complete the acquire process.
47 +* Type "//progreset//" and press enter to restart ShowRunner
48 +* Once ShowRunner has finished restarting type "//sr discover zum false//" and press enter. ShowRunner will be able to acquire the loads attached to the Zum rooms at this point.
49 +* Once completed ShowRunner is now ready for full Zum control
67 67  
68 -== Claim All RF Gateways Instructions ==
51 +== Option 2: Manual RF Gateway Claiming: ==
69 69  
70 -Use this method when you have a single SHOWRUNNER™ instance on a local network with all gateways being used for SHOWRUNNER™.
53 +Use this method if you have multiple ShowRunner instances on the same network or have gateways used by other Crestron systems.
71 71  
72 72  * Connect to the processor's console with Toolbox or your favorite SSH client.
73 -* Type "//sr discover zum true//" and press enter.
74 -* Status messages and the results will be displayed on the console. The process should take about 3 minutes.
75 -* When the discovery is finished type "//sr save//" and press enter to save the updated config. Due to an unknown quirk that we are looking into, SHOWRUNNER™ must be restarted to complete the acquire process.
76 -* Type "//progreset//" and press enter to restart SHOWRUNNER™
77 -* Once SHOWRUNNER™ has finished restarting type "//sr discover zum false//" and press enter. SHOWRUNNER™ will be able to acquire the loads attached to the Zūm rooms at this point.
78 -* Once completed SHOWRUNNER™ is now ready for full Zūm control
56 +* Type "//sr devmgr ethernet query//" and press enter. This queries the local network for RF Gateways.
57 +* Type "//sr devmgr ethernet show devices//" and press enter. This displays all found Crestron ethernet devices.
58 +* For each gateway that you'd like this instance of ShowRunner to use, use the hostname from the table of found ethernet devices. For example if the gateway Hostname is CEN-GWEXER-9E6ADA type "//sr ethernet device claim CEN-GWEXER-9E6ADA//". ShowRunner will auto-assign an IP-ID. After all gateways have been claimed by ShowRunner proceed to the next step.
59 +* Type "//sr discover zum false//" and press enter.
60 +* Status messages and the results will be displayed on the console. The process should take about 3 minutes.
61 +* When the discovery is finished type "//sr save//" and press enter to save the updated config. Due to an unknown quirk that we are looking into, ShowRunner must be restarted to complete the acquire process.
62 +* Type "//progreset//" and press enter to restart ShowRunner
63 +* Once ShowRunner has finished restarting type "//sr discover zum false//" and press enter. ShowRunner will be able to acquire the loads attached to the Zum rooms at this point.
64 +* Once completed ShowRunner is now ready for full Zum control
79 79  
80 80  == Examples ==
81 81  
82 -=== Manual Example ===
68 +=== Example for Option 1: ===
83 83  
84 -{{{MC4>sr devmgr ethernet query
85 -Ethrenet AutoDiscovery Result: AutoDiscoveryOperationSuccess
86 -MC4>sr devmgr ethernet show devices
87 -
88 -+--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
89 -| Adapter | Hostname | IP Address | IP-ID | ID |
90 -+--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
91 -| EthernetLANAdapter | CI-SJC-CEN-CI3-1-COM3 | 10.44.5.20 | 00 | CEN-CI3-1-C3COM-3 [v1.1620.00000, #008436E2] type:1 |
92 -+--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
93 -| EthernetLANAdapter | SB-DIN-CENCN-2 | 10.44.5.81 | 00 | DIN-CENCN-2-POE [v1.3544.00006, #8AB25AA3] |
94 -+--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
95 -| EthernetLANAdapter | CEN-GWEXER-9E6ADA | 10.44.5.120 | 00 | CEN-GWEXER [v1.4230.00015, #848210AD] |
96 -+--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
97 -
98 -MC4>sr ethernet device claim CEN-GWEXER-9E6ADA
99 -Claimed ethernet device: CEN-GWEXER-9E6ADA
100 -MC4>Update request from IP-ID-30 in Program 01
101 -MC4>sr discover zum false
102 -Starting Zum Discovery without gateway claiming
103 -MC4>Performing Discovery on 1 Gateways.
70 +{{{MC4>sr discover zum true
71 +Starting Zum Discovery with gateway claiming
72 +MC4>Found 1 Gateways to check.
73 +Claimed Gateway SN: 1720JBH04269 at IP-ID: 30
74 +Update request from IP-ID-30 in Program 01
75 +Claimed 1 Gateways. Waiting for queries to finish.
76 +Performing Discovery on 1 Gateways.
104 104  Evaluating 3 Devices on Gateway 30
105 105  Claiming ZUM-NETBRIDGE SN: 1726NEJ01096 from IP-ID: 30
106 106  Dev: ZUM-NETBRIDGE addrssing to RF ID: 03
... ... @@ -111,7 +111,6 @@
111 111  Claiming ZUM-NETBRIDGE SN: 1914NEJ03098 from IP-ID: 30
112 112  Dev: ZUM-NETBRIDGE addrssing to RF ID: 05
113 113  Setting up RF Device 'ZUM-NETBRIDGE' on Gateway 30 at RF-ID 05
114 -Querying cresnet
115 115  Discovering Zum Loads on 1 Gateways.
116 116  Discovering Zum Loads on 3 Devices.
117 117  NETBIRDGE: NewLoads: 0 ModifiedLoads: 0 RemovedLoads: 0
... ... @@ -180,17 +180,31 @@
180 180  New Loads: 6
181 181  Modified Loads: 0
182 182  Removed Loads: 0
183 -Zum Discovery Finished}}}
155 +Zum Discovery Finished
156 +}}}
184 184  
185 -=== Claim All Example ===
158 +=== Example for Option 2: ===
186 186  
187 -{{{MC4>sr discover zum true
188 -Starting Zum Discovery with gateway claiming
189 -MC4>Found 1 Gateways to check.
190 -Claimed Gateway SN: 1720JBH04269 at IP-ID: 30
191 -Update request from IP-ID-30 in Program 01
192 -Claimed 1 Gateways. Waiting for queries to finish.
193 -Performing Discovery on 1 Gateways.
160 +{{{MC4>sr devmgr ethernet query
161 +Ethrenet AutoDiscovery Result: AutoDiscoveryOperationSuccess
162 +MC4>sr devmgr ethernet show devices
163 +
164 ++--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
165 +| Adapter | Hostname | IP Address | IP-ID | ID |
166 ++--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
167 +| EthernetLANAdapter | CI-SJC-CEN-CI3-1-COM3 | 10.44.5.20 | 00 | CEN-CI3-1-C3COM-3 [v1.1620.00000, #008436E2] type:1 |
168 ++--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
169 +| EthernetLANAdapter | SB-DIN-CENCN-2 | 10.44.5.81 | 00 | DIN-CENCN-2-POE [v1.3544.00006, #8AB25AA3] |
170 ++--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
171 +| EthernetLANAdapter | CEN-GWEXER-9E6ADA | 10.44.5.120 | 00 | CEN-GWEXER [v1.4230.00015, #848210AD] |
172 ++--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
173 +
174 +MC4>sr ethernet device claim CEN-GWEXER-9E6ADA
175 +Claimed ethernet device: CEN-GWEXER-9E6ADA
176 +MC4>Update request from IP-ID-30 in Program 01
177 +MC4>sr discover zum false
178 +Starting Zum Discovery without gateway claiming
179 +MC4>Performing Discovery on 1 Gateways.
194 194  Evaluating 3 Devices on Gateway 30
195 195  Claiming ZUM-NETBRIDGE SN: 1726NEJ01096 from IP-ID: 30
196 196  Dev: ZUM-NETBRIDGE addrssing to RF ID: 03
... ... @@ -201,6 +201,7 @@
201 201  Claiming ZUM-NETBRIDGE SN: 1914NEJ03098 from IP-ID: 30
202 202  Dev: ZUM-NETBRIDGE addrssing to RF ID: 05
203 203  Setting up RF Device 'ZUM-NETBRIDGE' on Gateway 30 at RF-ID 05
190 +Querying cresnet
204 204  Discovering Zum Loads on 1 Gateways.
205 205  Discovering Zum Loads on 3 Devices.
206 206  NETBIRDGE: NewLoads: 0 ModifiedLoads: 0 RemovedLoads: 0
... ... @@ -270,5 +270,5 @@
270 270  Modified Loads: 0
271 271  Removed Loads: 0
272 272  Zum Discovery Finished
273 -}}}
260 + }}}
274 274  )))