Changes for page Zūm Discovery

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -1,11 +1,18 @@
1	1	(% class="box errormessage" %)
2	2	(((
3		-WARNING: Cresnet Discovery is not currently working on ZUMNET-JBOXs. Crestron has acknowledged a fix has been sent to QE. Discovery must be fixed before SHOWRUNNER™ can auto-discover hardware.
	3	+WARNING: Cresnet Discovery is not currently working on ZUMNET-JBOXs. Crestron has acknowledged a fix has been sent to QE.
	4	+
	5	+Downgrade ShowRunnerCLC™ to v3.018 in order to auto-discover hardware. ShowRunnerCLC™ can be subsequently upgraded once discovery is complete.
4	4	)))
5	5
	8	+(% class="box errormessage" %)
	9	+(((
	10	+IMPORTANT: When using ShowRunnerCLC™ with a ZUM-HUB4, do not discover Zūm Rooms using the Crestron HUB4 Web UI. During discovery, the HUB4 will claim ZUMNET-JBOXs and prevent ShowRunnerCLC™ from auto-discovering or registering the Zūm hardware for itself.
	11	+)))
	12	+
6	6	(% class="box warningmessage" %)
7	7	(((
8		-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]].
	15	+This article is about automatically building a ShowRunnerCLC™ configuration using the Zūm Discovery feature of ShowRunnerCLC™. 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]].
9	9	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]].
10	10	)))
11	11
...	...	@@ -13,9 +13,9 @@
13	13	{{toc/}}
14	14	{{/box}}
15	15
16		-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™.
	23	+If Zūm Wired or Wireless devices have been configured using Crestron's Zūm App, then it is possible to automatically build a ShowRunnerCLC™ configuration file using the Zūm Discovery feature that is built into ShowRunnerCLC™.
17	17
18		-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.
	25	+There are certain pre-requisites and limitations when building a ShowRunnerCLC™ 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.
19	19
20	20	= Zūm Wired Discovery =
21	21
...	...	@@ -23,7 +23,7 @@
23	23
24	24	(% class="box warningmessage" %)
25	25	(((
26		-* SHOWRUNNER™ version 3.014 or newer required
	33	+* ShowRunnerCLC™ version 3.014 or newer required
27	27	* Zūm Wired firmware .puf version 1.02.10 or greater required (ZUMNET-JBOX installed minimum version 1.001.00081)
28	28	* Disconnect from any ZUMNET devices you may be connected to in Toolbox prior to running the discovery commands
29	29	* Cresnet devices landed on Zūm Link will not be discovered (Crestron bug expected to be corrected in a future firmware release)
...	...	@@ -32,13 +32,13 @@
32	32
33	33	== Steps ==
34	34
35		-1. [[Install SHOWRUNNER™>>doc:SHOWRUNNER™ Setup Guide.SHOWRUNNER™ Installation Guide.SHOWRUNNER™ Installation and Network Setup.WebHome]] on the processor and configure the processor as necessary
	42	+1. [[Install ShowRunner™>>doc:SHOWRUNNER™ Setup Guide.SHOWRUNNER™ Installation Guide.SHOWRUNNER™ Installation and Network Setup.WebHome]] on the processor and configure the processor as necessary
36	36	1*. Note that while Zūm Wired discovery will build a configuration, if a configuration file was provided then it should still be loaded as it may contain location data or non-Zūm devices.
37	37	1. If the ZUMNET-JBOX firmware is too out-of-date to connect using the Crestron Zūm App, then there are some additional steps required:
38	38	1*. Connect to the first ZUMNET-JBOX in Toolbox
39	39	1*. Configure a static IP address for the ZUMNET-JBOX if there is no DHCP server on the network
40		-1**. Note: The SHOWRUNNER™ built-in DHCP server is not meant to be used in production
41		-1**. If the SHOWRUNNER™ built-in DHCP server was used to assign IP addresses to devices, it is still necessary to give those devices static IP addresses
	47	+1**. Note: The ShowRunnerCLC™ built-in DHCP server is not meant to be used in production
	48	+1**. If the ShowRunnerCLC™ built-in DHCP server was used to assign IP addresses to devices, it is still necessary to give those devices static IP addresses
42	42	1*. Set unique Connection IDs for each device hosted on the ZUMNET-JBOX so that their firmware can be updated
43	43	1*. Load the Zūm Wired firmware to the ZUMNET-JBOX
44	44	1*. Repeat the above steps for all ZUMNET-JBOXs
...	...	@@ -49,18 +49,18 @@
49	49	1*. If unique CIDs are not automatically assigned, connect to the JBOX in Toolbox and give the devices unique CIDs
50	50	1. Configure a static IP address for the ZUMNET-JBOX if there is no DHCP server on the network
51	51	1*. If firmware was out-of-date, then this step should have already been completed
52		-1*. Note: The SHOWRUNNER™ built-in DHCP server is not meant to be used in production
53		-1*. If the SHOWRUNNER™ built-in DHCP server was used to assign IP addresses to devices, it is still necessary to give those devices static IP addresses
	59	+1*. Note: The ShowRunnerCLC™ built-in DHCP server is not meant to be used in production
	60	+1*. If the ShowRunnerCLC™ built-in DHCP server was used to assign IP addresses to devices, it is still necessary to give those devices static IP addresses
54	54	1. Optionally, manually configure the ZUMNET-JBOX IP table to point at the processor if you want to keep track of which ZUMNET-JBOX is at each IP-ID
55	55	1*. If you do not manually configure the IP table, then SHOWRUNNER™ will automatically configure the IP-ID for each ZUMNET-JBOX during discovery
56	56	1. Set the ZUMNET-JBOX into either Zūm ("App") mode or CNET mode as required for the program
57		-1*. Full control from SHOWRUNNER™ is only possible if all ZUMNET-JBOXs are in CNET mode. Odd behavior may result from conflicts between SHOWRUNNER™ and internal logic if the ZUMNET-JBOXs are not put into CNET mode
58		-1. Repeat from step 3 until all ZUMNET-JBOXs that are to be controlled by SHOWRUNNER™ have static IP addresses and unique CIDs for any hosted devices
	64	+1*. Full control from ShowRunnerCLC™ is only possible if all ZUMNET-JBOXs are in CNET mode. Odd behavior may result from conflicts between ShowRunnerCLC™ and internal logic if the ZUMNET-JBOXs are not put into CNET mode
	65	+1. Repeat from step 3 until all ZUMNET-JBOXs that are to be controlled by ShowRunnerCLC™ have static IP addresses and unique CIDs for any hosted devices
59	59	1. Disconnect from any ZUMNET-JBOXs and then connect to the processor in Toolbox
60	60	1. Run the command: ##sr discover zumnet true false##
61		-1*. This command tells SHOWRUNNER™ to discover all ZUMMNET-JBOXs on the network, configure their IP tables, and then add corresponding IP Devices to the configuration
	68	+1*. This command tells ShowRunnerCLC™ to discover all ZUMMNET-JBOXs on the network, configure their IP tables, and then add corresponding IP Devices to the configuration
62	62	1. Run the command: ##sr discover zumnet true true##
63		-1*. This command tells SHOWRUNNER™ to discover all Zūm Link hardware (including the internal ZUMNET-JBOX load controller) on the previously discovered Zūm Net devices and then add corresponding areas, loads, sensors, etc. to the configuration
	70	+1*. This command tells ShowRunnerCLC™ to discover all Zūm Link hardware (including the internal ZUMNET-JBOX load controller) on the previously discovered Zūm Net devices and then add corresponding areas, loads, sensors, etc. to the configuration
64	64	1**. One area will be created per ZUMNET-JBOX, and all hardware attached to that ZUMNET-JBOX will be assigned to that area
65	65	1*. This command **does not** bring in Cresnet devices: those must be added to the configuration manually until this issue is fixed in the Zūm Wired firmware
66	66	1. If all steps have been performed successfully, then you should be able to use the ##sr show area##, ##sr show load##, ##sr show keypad##, and ##sr show occ## commands to see that the ZUMNET and ZUMLINK hardware has been discovered correctly.
...	...	@@ -71,48 +71,48 @@
71	71
72	72	(% class="box warningmessage" %)
73	73	(((
74		-* Processor with SHOWRUNNER™ version 2.190 or newer must be running on the same network as the gateway(s) to be acquired
75		-** For SHOWRUNNER™ versions prior to 3.014 and newer, replace **##sr discover zummesh##** commands with **##sr discover zum##**
	81	+* Processor with ShowRunnerCLC™ version 2.190 or newer must be running on the same network as the gateway(s) to be acquired
	82	+** For ShowRunnerCLC™ versions prior to 3.014 and newer, replace **##sr discover zummesh##** commands with **##sr discover zum##**
76	76	* ZUM-NETBRIDGES must already be acquired to their respective gateway
77		-* SHOWRUNNER™ will automatically address any ZUM-NETBRIDGES that do not need have addresses assigned, but will still honor any already addressed devices
	84	+* ShowRunnerCLC™ will automatically address any ZUM-NETBRIDGES that do not need have addresses assigned, but will still honor any already addressed devices
78	78	* Disconnect from any RF gateways you may be connected to in Toolbox prior to running the discovery command
79		-* Plug loads will not appear in the SHOWRUNNER™ UI
	86	+* Plug loads will not appear in the ShowRunnerCLC™ UI
80	80	)))
81	81
82	82	(% class="box infomessage" id="HCaution:" %)
83	83	(((
84		-**Note:** SHOWRUNNER™ has two different approaches for Zūm Wireless Discovery
	91	+**Note:** ShowRunnerCLC™ has two different approaches for Zūm Wireless Discovery
85	85
86		-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.
87		-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.
	93	+1. **Manual RF Gateway Assignment** - ShowRunnerCLC™ 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.
	94	+1. **Claim All RF Gateways** - ShowRunnerCLC™ 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 ShowRunnerCLC™ or other Crestron systems on the same local network.
88	88	)))
89	89
90	90	== Manual RF Gateway Assignment Instructions ==
91	91
92		-Use this method if you have multiple SHOWRUNNER™ instances on the same network or have gateways used by other Crestron systems.
	99	+Use this method if you have multiple ShowRunnerCLC™ instances on the same network or have gateways used by other Crestron systems.
93	93
94	94	* Connect to the processor's console with Toolbox or your favorite SSH client.
95	95	* Type ##sr devmgr ethernet query## and press enter. This queries the local network for RF Gateways.
96	96	* Type ##sr devmgr ethernet show devices## and press enter. This displays all found Crestron ethernet devices.
97		-* 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.
	104	+* 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##. ShowRunnerCLC™ will auto-assign an IP-ID. After all gateways have been claimed by ShowRunnerCLC™, proceed to the next step.
98	98	* Type ##sr discover zummesh false## and press enter.
99	99	* Status messages and the results will be displayed on the console. The process should take about 3 minutes.
100		-* 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.
101		-* Type ##progreset## and press enter to restart SHOWRUNNER™
102		-* Once SHOWRUNNER™ has finished restarting type ##sr discover zummesh false## and press enter. SHOWRUNNER™ will be able to acquire the loads attached to the Zūm rooms at this point.
	107	+* 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, ShowRunnerCLC™ must be restarted to complete the acquire process.
	108	+* Type ##progreset## and press enter to restart ShowRunnerCLC™
	109	+* Once SHOWRUNNER™ has finished restarting type ##sr discover zummesh false## and press enter. ShowRunnerCLC™ will be able to acquire the loads attached to the Zūm rooms at this point.
103	103	* Once completed SHOWRUNNER™ is now ready for full Zūm control
104	104
105	105	== Claim All RF Gateways Instructions ==
106	106
107		-Use this method when you have a single SHOWRUNNER™ instance on a local network with all gateways being used for SHOWRUNNER™.
	114	+Use this method when you have a single ShowRunnerCLC™ instance on a local network with all gateways being used for ShowRunnerCLC™.
108	108
109	109	* Connect to the processor's console with Toolbox or your favorite SSH client.
110	110	* Type ##sr discover zummesh true## and press enter.
111	111	* Status messages and the results will be displayed on the console. The process should take about 3 minutes.
112		-* 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.
113		-* Type ##progreset## and press enter to restart SHOWRUNNER™
114		-* Once SHOWRUNNER™ has finished restarting type ##sr discover zummesh false## and press enter. SHOWRUNNER™ will be able to acquire the loads attached to the Zūm rooms at this point.
115		-* Once completed SHOWRUNNER™ is now ready for full Zūm control
	119	+* 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, ShowRunnerCLC™ must be restarted to complete the acquire process.
	120	+* Type ##progreset## and press enter to restart ShowRunnerCLC™
	121	+* Once ShowRunnerCLC™ has finished restarting type ##sr discover zummesh false## and press enter. ShowRunnerCLC™ will be able to acquire the loads attached to the Zūm rooms at this point.
	122	+* Once completed ShowRunnerCLC™ is now ready for full Zūm control
116	116
117	117	== Examples ==
118	118