Changes for page Zūm Net Device Setup

Last modified by Alexander Mott on 2024/10/22 19:55
From version 10.1
edited by Alexander Mott
on 2022/06/16 20:41
Change comment: There is no comment for this version
To version 10.9
edited by Alexander Mott
on 2022/06/17 17:19
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -21,23 +21,60 @@
21 21  1. Identifying which DHCP assigned IP address corresponds to each ZUMNET-JBOX
22 22  1. Connecting to each ZUMNET-JBOX and assigning a permanent static IP address and IP-ID
23 23  
24 -==== Identifying Zūm Net Devices ====
24 +==== Identifying ZUMNET-JBOXs ====
25 25  
26 26  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.
27 27  
28 -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:
28 +There are three primary ways of identifying ZUMNET-JBOXs:
29 29  
30 +1. Identifying by hostname
31 +1. Identifying by serial number or MAC address
32 +1. Identifying through Device Tree View
33 +
34 +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.
35 +
36 +To generate a Device Summary in Toolbox:
37 +
30 30  * Connect to the lighting network and open Device Discovery Tool in Toolbox
31 31  * The Device Discovery tool will automatically report how many Ethernet devices have been discovered
32 -** Verify that the correct number of Ethernet devices have been discovered, including any TSWs, GLPACs, DIN-CENCN-2s, etc.
40 +* Verify that the expected number of Ethernet devices have been discovered, including any TSWs, GLPACs, DIN-CENCN-2s, etc.
33 33  ** 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
42 +** If no devices are discovered, verify that your computer is connected to the network and your IP address is compatible with the network
43 +** If some devices are missing, there may be an issue with your DHCP server settings or the network wiring
34 34  * Click the "Export..." button below the list of discovered devices
35 35  ** If this button says "Address Book", then Toolbox needs to be updated
36 -* Click the Write Device Summary button and save the DeviceSummary.txt to your computer
37 -* The DeviceSummary.txt provides the IP address, MAC address, and serial number for each device on the network
38 -* 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
39 -* Update the SRTakeoff.xlsx with the device serial number, MAC address, and automatically assigned IP address for all ZUMNET-JBOXs
46 +* Click the Write Device Summary button and save the Device Summary to your computer
47 +** Though saved as a text file, the Device Summary is actually a table of comma separated values
48 +** 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
40 40  
50 +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.
51 +
52 +===== Identifying by Hostname =====
53 +
54 +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.
55 +
56 +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.
57 +
58 +To change the hostname using the Crestron Zūm App:
59 +
60 +* Connect to the ZUMNET-JBOX in the App
61 +* Tap "Room Settings"
62 +* Tap "Network"
63 +* Tap the Hostname field and edit the Hostname
64 +* Scroll to the bottom of the page and tap "Save settings"
65 +* Tap "OK" to apply the changes and reboot the ZUMNET-JBOX
66 +** Note that rebooting the JBOX will cause the lights to briefly cut out
67 +
68 +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.
69 +
70 +===== Identifying by Serial Number or MAC Address =====
71 +
72 +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.
73 +
74 +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.
75 +
76 +===== Identifying through Network Device Tree View =====
77 +
41 41  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.
42 42  
43 43  * Connect to the lighting network and open Device Discovery Tool in Toolbox
... ... @@ -57,9 +57,9 @@
57 57  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:
58 58  
59 59  * Open Text Console in Toolbox and connect to the first ZUMNET-JBOX
60 -* 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.20**(%%), 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**(%%))
97 +* 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**(%%))
61 61  ** Disable DHCP: ##dhcp off##
62 -** Set IP address: ##ipa 0 (% style="color:blue" %)**10.0.0.20**(%%)##
99 +** Set IP address: ##ipa 0 (% style="color:blue" %)**10.0.0.80**(%%)##
63 63  ** Set IP subnet mask: ##ipm 0 (% style="color:darkgoldenrod" %)**255.255.255.0**(%%)##
64 64  ** Set default gateway: ##defr 0 **10.0.0.1**##
65 65  ** Update IP table: ##addm (% style="color:olive" %)**30**(%%) (% style="color:orange" %)**10.0.0.10**(%%)##
... ... @@ -69,14 +69,12 @@
69 69  
70 70  === Zūm Net Specific Configuration ===
71 71  
72 -Zūm Net devices have a two additional settings not present for other devices: Zūm/Cresnet mode and Master/Slave mode.
109 +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.
73 73  
74 74  ==== Zūm/Cresnet Mode ====
75 75  
76 -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.
113 +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).
77 77  
78 -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).
79 -
80 80  The commands to view or change the Zūm/Cresnet mode are:
81 81  
82 82  * View current mode: ##zwmode##
... ... @@ -87,10 +87,8 @@
87 87  
88 88  ==== Master/Slave Mode ====
89 89  
90 -ZUMNET-JBOXs should ship in "Master" mode by default, and generally this is how they should be configured.
125 +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:
91 91  
92 -"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:
93 -
94 94  1. It is connected to another ZUMNET-JBOX via the Zūm Link bus
95 95  1. It is being used as a Cresnet device, connected to a processor or DIN-CENCN-2 using a Cresnet/Zūm Link adapter
96 96