Changes for page Zūm Discovery

Last modified by Alexander Mott on 2025/04/03 17:35

From version 5.1
edited by Alexander Mott
on 2022/09/22 21:55
Change comment: There is no comment for this version
To version 2.1
edited by Alexander Mott
on 2022/09/22 21:44
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -18,78 +18,61 @@
18 18  
19 19  = Zūm Wireless =
20 20  
21 +
21 21  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.
22 22  *Disconnect from the gateway before discovery as they cannot support multiple connections*
23 23  *Plug loads do not appear in the UI*
24 24  
25 -== Pre-Requisites: ==
26 +== **Pre-Requisites:** ==
26 26  
27 27  * Zum NETBRIDGES acquired to their respective gateway (CEN-GWEXER/ZUMNET-GATEWAY)
28 -* SHOWRUNNER™ installed and running on a 3-series processor on the same network as the gateway
29 -* NETBRIDGES do not need to have addresses assigned. SHOWRUNNER™ will automatically address them. If devices all already addressed then their addresses will be honored.
30 -)))
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.
31 31  
32 -(% class="box warningmessage" id="HCaution:" %)
33 -(((
34 -**Note:** SHOWRUNNER™ has two different approaches for Zūm Wireless Autodiscovery
32 +=== **Caution:** ===
35 35  
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.
37 -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.
38 -)))
34 +* ShowRunner has 2 discovery approaches.
35 +** Option 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 +** Option 2: 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.
39 39  
40 -(% class="row" %)
41 -(((
42 -== Manual RF Gateway Claiming ==
38 +== Option 1: Claim All Gateways: ==
43 43  
44 -Use this method if you have multiple SHOWRUNNER™ instances on the same network or have gateways used by other Crestron systems.
40 +Use this method when you have a single ShowRunner instance on a local network with all gateways being used for ShowRunner.
45 45  
46 46  * Connect to the processor's console with Toolbox or your favorite SSH client.
47 -* Type "//sr devmgr ethernet query//" and press enter. This queries the local network for RF Gateways.
48 -* Type "//sr devmgr ethernet show devices//" and press enter. This displays all found Crestron ethernet devices.
49 -* 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.
50 -* Type "//sr discover zum false//" and press enter.
51 -* Status messages and the results will be displayed on the console. The process should take about 3 minutes.
52 -* 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.
53 -* Type "//progreset//" and press enter to restart SHOWRUNNER™
54 -* 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.
55 -* Once completed SHOWRUNNER™ is now ready for full Zūm control
43 +* Type "//sr discover zum true//" and press enter.
44 +* Status messages and the results will be displayed on the console. The process should take about 3 minutes.
45 +* 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.
46 +* Type "//progreset//" and press enter to restart ShowRunner
47 +* 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.
48 +* Once completed ShowRunner is now ready for full Zum control
56 56  
57 -== Claim All RF Gateways ==
50 +== Option 2: Manual RF Gateway Claiming: ==
58 58  
59 -Use this method when you have a single SHOWRUNNER™ instance on a local network with all gateways being used for SHOWRUNNER™.
52 +Use this method if you have multiple ShowRunner instances on the same network or have gateways used by other Crestron systems.
60 60  
61 61  * Connect to the processor's console with Toolbox or your favorite SSH client.
62 -* Type "//sr discover zum true//" and press enter.
63 -* Status messages and the results will be displayed on the console. The process should take about 3 minutes.
64 -* 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.
65 -* Type "//progreset//" and press enter to restart SHOWRUNNER™
66 -* 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.
67 -* Once completed SHOWRUNNER™ is now ready for full Zūm control
55 +* Type "//sr devmgr ethernet query//" and press enter. This queries the local network for RF Gateways.
56 +* Type "//sr devmgr ethernet show devices//" and press enter. This displays all found Crestron ethernet devices.
57 +* 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.
58 +* Type "//sr discover zum false//" and press enter.
59 +* Status messages and the results will be displayed on the console. The process should take about 3 minutes.
60 +* 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.
61 +* Type "//progreset//" and press enter to restart ShowRunner
62 +* 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.
63 +* Once completed ShowRunner is now ready for full Zum control
68 68  
69 69  == Examples ==
70 70  
71 -=== Claim Selectively (Manual) Example ===
67 +=== Example for Option 1: ===
72 72  
73 -{{{MC4>sr devmgr ethernet query
74 -Ethrenet AutoDiscovery Result: AutoDiscoveryOperationSuccess
75 -MC4>sr devmgr ethernet show devices
76 -
77 -+--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
78 -| Adapter | Hostname | IP Address | IP-ID | ID |
79 -+--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
80 -| EthernetLANAdapter | CI-SJC-CEN-CI3-1-COM3 | 10.44.5.20 | 00 | CEN-CI3-1-C3COM-3 [v1.1620.00000, #008436E2] type:1 |
81 -+--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
82 -| EthernetLANAdapter | SB-DIN-CENCN-2 | 10.44.5.81 | 00 | DIN-CENCN-2-POE [v1.3544.00006, #8AB25AA3] |
83 -+--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
84 -| EthernetLANAdapter | CEN-GWEXER-9E6ADA | 10.44.5.120 | 00 | CEN-GWEXER [v1.4230.00015, #848210AD] |
85 -+--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
86 -
87 -MC4>sr ethernet device claim CEN-GWEXER-9E6ADA
88 -Claimed ethernet device: CEN-GWEXER-9E6ADA
89 -MC4>Update request from IP-ID-30 in Program 01
90 -MC4>sr discover zum false
91 -Starting Zum Discovery without gateway claiming
92 -MC4>Performing Discovery on 1 Gateways.
69 +{{{MC4>sr discover zum true
70 +Starting Zum Discovery with gateway claiming
71 +MC4>Found 1 Gateways to check.
72 +Claimed Gateway SN: 1720JBH04269 at IP-ID: 30
73 +Update request from IP-ID-30 in Program 01
74 +Claimed 1 Gateways. Waiting for queries to finish.
75 +Performing Discovery on 1 Gateways.
93 93  Evaluating 3 Devices on Gateway 30
94 94  Claiming ZUM-NETBRIDGE SN: 1726NEJ01096 from IP-ID: 30
95 95  Dev: ZUM-NETBRIDGE addrssing to RF ID: 03
... ... @@ -100,7 +100,6 @@
100 100  Claiming ZUM-NETBRIDGE SN: 1914NEJ03098 from IP-ID: 30
101 101  Dev: ZUM-NETBRIDGE addrssing to RF ID: 05
102 102  Setting up RF Device 'ZUM-NETBRIDGE' on Gateway 30 at RF-ID 05
103 -Querying cresnet
104 104  Discovering Zum Loads on 1 Gateways.
105 105  Discovering Zum Loads on 3 Devices.
106 106  NETBIRDGE: NewLoads: 0 ModifiedLoads: 0 RemovedLoads: 0
... ... @@ -169,17 +169,31 @@
169 169  New Loads: 6
170 170  Modified Loads: 0
171 171  Removed Loads: 0
172 -Zum Discovery Finished}}}
154 +Zum Discovery Finished
155 +}}}
173 173  
174 -=== Claim All Example ===
157 +=== Example for Option 2: ===
175 175  
176 -{{{MC4>sr discover zum true
177 -Starting Zum Discovery with gateway claiming
178 -MC4>Found 1 Gateways to check.
179 -Claimed Gateway SN: 1720JBH04269 at IP-ID: 30
180 -Update request from IP-ID-30 in Program 01
181 -Claimed 1 Gateways. Waiting for queries to finish.
182 -Performing Discovery on 1 Gateways.
159 +{{{MC4>sr devmgr ethernet query
160 +Ethrenet AutoDiscovery Result: AutoDiscoveryOperationSuccess
161 +MC4>sr devmgr ethernet show devices
162 +
163 ++--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
164 +| Adapter | Hostname | IP Address | IP-ID | ID |
165 ++--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
166 +| EthernetLANAdapter | CI-SJC-CEN-CI3-1-COM3 | 10.44.5.20 | 00 | CEN-CI3-1-C3COM-3 [v1.1620.00000, #008436E2] type:1 |
167 ++--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
168 +| EthernetLANAdapter | SB-DIN-CENCN-2 | 10.44.5.81 | 00 | DIN-CENCN-2-POE [v1.3544.00006, #8AB25AA3] |
169 ++--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
170 +| EthernetLANAdapter | CEN-GWEXER-9E6ADA | 10.44.5.120 | 00 | CEN-GWEXER [v1.4230.00015, #848210AD] |
171 ++--------------------+-------------------------------+-------------+-------+----------------------------------------------------------------------------------+
172 +
173 +MC4>sr ethernet device claim CEN-GWEXER-9E6ADA
174 +Claimed ethernet device: CEN-GWEXER-9E6ADA
175 +MC4>Update request from IP-ID-30 in Program 01
176 +MC4>sr discover zum false
177 +Starting Zum Discovery without gateway claiming
178 +MC4>Performing Discovery on 1 Gateways.
183 183  Evaluating 3 Devices on Gateway 30
184 184  Claiming ZUM-NETBRIDGE SN: 1726NEJ01096 from IP-ID: 30
185 185  Dev: ZUM-NETBRIDGE addrssing to RF ID: 03
... ... @@ -190,6 +190,7 @@
190 190  Claiming ZUM-NETBRIDGE SN: 1914NEJ03098 from IP-ID: 30
191 191  Dev: ZUM-NETBRIDGE addrssing to RF ID: 05
192 192  Setting up RF Device 'ZUM-NETBRIDGE' on Gateway 30 at RF-ID 05
189 +Querying cresnet
193 193  Discovering Zum Loads on 1 Gateways.
194 194  Discovering Zum Loads on 3 Devices.
195 195  NETBIRDGE: NewLoads: 0 ModifiedLoads: 0 RemovedLoads: 0
... ... @@ -259,5 +259,5 @@
259 259  Modified Loads: 0
260 260  Removed Loads: 0
261 261  Zum Discovery Finished
262 -}}}
259 + }}}
263 263  )))