Wiki source code of Zūm Net Device Setup

Last modified by Alexander Mott on 2024/10/22 19:55

Hide last authors
Alexander Mott 23.1 1 (% class="box warningmessage" %)
Alexander Mott 19.1 2 (((
Alexander Mott 49.1 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.SHOWRUNNER™ Installation Guide.Preparation.Zūm App Overview.WebHome]].
Alexander Mott 48.1 4 For details on using the Zūm Discovery feature to automatically build a ShowRunnerCLC™ configuration based on the Zūm App settings, see [[this page>>doc:SHOWRUNNER™ Setup Guide.SHOWRUNNER™ Installation Guide.Program Configuration.Zūm Discovery.WebHome]].
Alexander Mott 19.1 5 )))
6
Alexander Mott 29.1 7 {{box cssClass="floatinginfobox" title="**CONTENTS**"}}
Alexander Mott 22.1 8 {{toc/}}
9 {{/box}}
Alexander Mott 1.1 10
Robert Hoppe 47.1 11 Zūm Net devices are part of Crestron's latest Zūm Wired system, acting as 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 ShowRunnerCLC™ is identical, so they will be referred to collectively as ZUMNET-JBOXs for the purposes of this article.
Alexander Mott 1.1 12
Scott Kohlmann 39.1 13 Much like DIN-CENCN-2s in ShowRunnerCLC™ 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.
Alexander Mott 1.1 14
Alexander Mott 22.1 15 = Identification and IP Configuration =
Alexander Mott 1.1 16
Alexander Mott 4.1 17 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.)
Alexander Mott 1.1 18
Alexander Mott 4.1 19 Since there is no option to configure ZUMNET-JBOXs via USB, a DHCP server is required. There are three options for DHCP servers:
Alexander Mott 1.1 20
Alexander Mott 4.1 21 * Using a processor with a Control Subnet (only available on certain processors)
Scott Kohlmann 39.1 22 * Using the built-in [[ShowRunnerCLC™ DHCP Server>>doc:SHOWRUNNER™ Setup Guide.Troubleshooting Guide.Advanced Tools.DHCP Server.WebHome]] (available on all processors running ShowRunnerCLC™ v3.009 or newer)
Alexander Mott 4.1 23 * Using third party DHCP server software on your computer
24
25 Most devices (DIN-CENCN-2, TSW, ZUMNET-JBOXs) rely only on IP-ID to identify themselves to the processor, but some devices (such as GLPACs, DMX controllers, and other processors) have IP addresses that are explicitly defined in the configuration file. The DHCP server should be configured to assign IP addresses that are visible to the processor, but excluded from assigning these explicitly defined IP addresses if possible.
26
27 Configuring ZUMNET-JBOXs can be broken up into two separate processes:
28
29 1. Identifying which DHCP assigned IP address corresponds to each ZUMNET-JBOX
Alexander Mott 5.2 30 1. Connecting to each ZUMNET-JBOX and assigning a permanent static IP address and IP-ID
Alexander Mott 4.1 31
Alexander Mott 22.1 32 == Identifying ZUMNET-JBOXs ==
Alexander Mott 4.1 33
Alexander Mott 5.2 34 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.
Alexander Mott 4.1 35
Alexander Mott 10.2 36 There are three primary ways of identifying ZUMNET-JBOXs:
37
38 1. Identifying by hostname
39 1. Identifying by serial number or MAC address
Alexander Mott 10.7 40 1. Identifying through Device Tree View
Alexander Mott 10.2 41
Alexander Mott 10.3 42 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.
43
44 To generate a Device Summary in Toolbox:
45
46 * Connect to the lighting network and open Device Discovery Tool in Toolbox
47 * The Device Discovery tool will automatically report how many Ethernet devices have been discovered
48 * Verify that the expected number of Ethernet devices have been discovered, including any TSWs, GLPACs, DIN-CENCN-2s, etc.
49 ** 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
50 ** If no devices are discovered, verify that your computer is connected to the network and your IP address is compatible with the network
51 ** If some devices are missing, there may be an issue with your DHCP server settings or the network wiring
52 * Click the "Export..." button below the list of discovered devices
53 ** If this button says "Address Book", then Toolbox needs to be updated
Alexander Mott 10.4 54 * Click the Write Device Summary button and save the Device Summary to your computer
55 ** Though saved as a text file, the Device Summary is actually a table of comma separated values
56 ** 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
Alexander Mott 10.3 57
Alexander Mott 38.1 58 See the [[Export to Device Summary>>doc:SHOWRUNNER™ Setup Guide.SHOWRUNNER™ Installation Guide.Preparation.Toolbox Basics.WebHome||anchor="HExporttoDeviceSummary"]] section of the Toolbox Basics page for more detail.
Alexander Mott 10.10 59
Alexander Mott 10.7 60 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.
61
Alexander Mott 22.1 62 === Identifying by Hostname ===
Alexander Mott 10.2 63
Scott Kohlmann 39.1 64 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 ShowRunnerCLC™ 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 ShowRunnerCLC™ logic in order to minimize disruption to end-users in the event of a processor or network failure.
Alexander Mott 10.2 65
Alexander Mott 10.8 66 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.
67
68 To change the hostname using the Crestron Zūm App:
69
70 * Connect to the ZUMNET-JBOX in the App
71 * Tap "Room Settings"
72 * Tap "Network"
73 * Tap the Hostname field and edit the Hostname
74 * Scroll to the bottom of the page and tap "Save settings"
75 * Tap "OK" to apply the changes and reboot the ZUMNET-JBOX
76 ** Note that rebooting the JBOX will cause the lights to briefly cut out
77
78 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.
79
Alexander Mott 49.1 80 Full instructions on configuring Zūm Wired using the Crestron Zūm App, can be found [[here>>SHOWRUNNER™ Setup Guide.SHOWRUNNER™ Installation Guide.Preparation.Zūm App Overview.WebHome]].
Alexander Mott 19.1 81
Alexander Mott 22.1 82 === Identifying by Serial Number or MAC Address ===
Alexander Mott 10.8 83
Alexander Mott 10.9 84 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.
Alexander Mott 10.8 85
Alexander Mott 10.9 86 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.
Alexander Mott 4.1 87
Alexander Mott 22.1 88 === Identifying through Network Device Tree View ===
Alexander Mott 4.1 89
Alexander Mott 10.10 90 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.
Alexander Mott 4.1 91
Alexander Mott 10.10 92 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.
93
94 * Generate a Device Summary and note the IP addresses for all installed ZUMNET-JBOXs
Alexander Mott 4.1 95 * Connect to the first ZUMNET-JBOX using Network Device Tree View
96 * Locate the "ZUMNET-JBOX-xx-xx-LOCAL" device in the list of connected devices
97 ** The model will vary between 0-10V and DALI JBOXs
98 ** The ID should be "03" regardless of model
99 * Right click the device and press "Identify This Device..." from the context menu
100 * The device will blink any attached fixtures and make an alarm sound
101 * Walk around the jobsite until the room/controlled fixtures are located
Alexander Mott 10.10 102 * Edit the Device Summary or SRTakeoff.xlsx so that you remember which JBOX is which
103 * Repeat for each ZUMNET-JBOX until all of the ZUMNET-JBOXs have been identified
Alexander Mott 4.1 104
Alexander Mott 10.10 105 Once you have determined and recorded which ZUMNET-JBOX is which, you may proceed to IP configuration.
106
Alexander Mott 22.1 107 == Assigning Permanent Static IP Addresses and IP-IDs ==
Alexander Mott 4.1 108
Alexander Mott 45.1 109 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.
Alexander Mott 4.1 110
Alexander Mott 45.1 111 Note that static IP addresses are only required on jobs where there is no permanent DHCP server. Manual IP-ID assignment is not required for jobs intended to be used with Zūm Auto Discovery, though it may still be recommended in order to keep track and document which IP-ID is associated with each area (Auto Discovery will auto-assign IP-IDs to ZUMNET-JBOXs without IP-IDs, but if a ZUMNET-JBOX already has an IP table entry it will be imported to the configuration with that pre-existing IP-ID).
112
Alexander Mott 4.1 113 * Open Text Console in Toolbox and connect to the first ZUMNET-JBOX
Alexander Mott 10.10 114 * 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)
Alexander Mott 10.3 115 ** Set IP address: ##ipa 0 (% style="color:blue" %)**10.0.0.80**(%%)##
Alexander Mott 1.1 116 ** Set IP subnet mask: ##ipm 0 (% style="color:darkgoldenrod" %)**255.255.255.0**(%%)##
117 ** Set default gateway: ##defr 0 **10.0.0.1**##
Alexander Mott 4.1 118 ** Update IP table: ##addm (% style="color:olive" %)**30**(%%) (% style="color:orange" %)**10.0.0.10**(%%)##
119 ** Set hostname: ##host (% style="color:purple" %)**ZNET-JBOX-RM-201**(%%)##
Alexander Mott 40.1 120 ** Disable DHCP: ##dhcp off##
Alexander Mott 4.1 121 ** Reboot the ZUMNET-JBOX: ##reboot##
Alexander Mott 16.1 122 *** Note that rebooting the JBOX will cause the lights to briefly cut out
Alexander Mott 4.1 123 * Repeat for all ZUMNET-JBOXs on the job
Alexander Mott 1.1 124
Alexander Mott 22.1 125 = Zūm Net Specific Configuration =
Alexander Mott 1.1 126
Alexander Mott 44.1 127 Zūm Net devices have a two additional settings not present for other devices: Primary/Secondary mode and Zūm/Cresnet mode. ZUMNET-JBOX-DALI have a third setting for Group/Legacy DALI mode, and all ZUMNET-JBOX-* that are in CNET mode can optionally be configured to automatically switch back and forth between CNET and App mode depending on whether the control processor is reachable.
Alexander Mott 5.2 128
Alexander Mott 50.2 129 == Updating Firmware ==
130
131 (% class="box errormessage" %)
132 (((
Alexander Mott 52.1 133 Per Crestron's Zūm Wired firmware v4.01.06 release notes, devices running firmware v3.09.05 or earlier "are not supported for upgrade via the Zum App / Hub / or Toolbox" and users should contact Crestron True Blue Support for upgrade paths when required.
134
135 Zūm Wired JBOXs operating as the Primary controller in App mode with firmware versions 4.x.x and above are limited in the number of secondary devices that can be supported on the Zūm Link bus:
136
137 * ZUMNET-JBOX-DALI : 7 maximum secondary devices
138 * ZUMNET-JBOX-~*~** : 14 maximum secondary devices
139 * ZUMLINK-JBOX-~*~** : 14 maximum secondary devices
140
141 These limitations do not apply to JBOXs operating in CNET mode //or// running firmware versions 3.x.x
Alexander Mott 50.2 142 )))
143
Alexander Mott 50.6 144 It is best practice to upgrade all Zūm Wired devices to the latest version, or at the very least update all devices to the same firmware version across the job. The recommended process for updating Zūm Wired firmware is:
Alexander Mott 50.2 145
146 1. Ensure that the ZUMNET-JBOX for the room is in Primary / Zūm Mode (see below) so that it will re-address all connected Zūm Link devices
Alexander Mott 50.3 147 1. Connect to the ZUMNET-JBOX in Network Device Tree View and verify that all expected Zūm Link devices are online and that there are no conflicting/duplicate IDs
Alexander Mott 50.2 148 1*. We have run into issues where devices will not always be uniquely addressed, typically as a result of cabling termination issues (incorrect pin-out or use of "EZ RJ45" passthrough connectors)
Alexander Mott 50.3 149 1*. Occasionally, ZUMLINK-KP will be stuck at ID 03 after the ZUMNET-JBOX has been put into Primary/App Mode - in these cases, briefly disconnecting the keypad, reconnecting it, and waiting a few minutes will allow the keypad's address to be changed
Alexander Mott 50.4 150 1. Use the Zūm Wired .puf file or the Firmware Updating Script tool built into ShowRunner™ to update all the ZUMNET-JBOXs
151 1*. Note that as part of the update process, the ZUMNET-JBOX will reboot, which will cycle the connected load and briefly interrupt Ethernet connection to any downstream ZUMNET-JBOXs or other Ethernet devices, which in rare instances will cause the firmware update to fail
Alexander Mott 50.5 152 1. Verify that all the ZUMNET-JBOXs have successfully updated by using the Device Discovery Tool device export and checking the reported firmware version
Alexander Mott 50.6 153 1. If any ZUMNET-JBOXs failed to update, try to update it again in case the update failure was caused by an upstream device rebooting
Alexander Mott 51.1 154 1. If a ZUMNET-JBOX fails to update more than twice in a row, further investigation is required:
155 1*. ZUMNET-JBOXs will update their firmware only after all connected Zūm Link devices have been successfully updated
156 1**. If any connected Zūm Link devices have conflicting or duplicate IDs, the update will fail
157 1**. Zūm Link cabling issues may also cause firmware updates to fail
158 1*. An unstable network (Ethernet) connection to the ZUMNET-JBOX may also cause the update to fail
Alexander Mott 50.2 159
160 Alternatively, rooms can be updated through the Crestron Zūm App as of firmware v1.03.54, however only one room can be upgraded at a time and your mobile device will become occupied for the duration of the firmware upgrade (15-45 minutes depending on firmware version and quantity of Zūm Wired devices in the room)
161
Alexander Mott 41.1 162 == Primary/Secondary Mode ==
Alexander Mott 9.1 163
Alexander Mott 41.1 164 (% class="box warningmessage" %)
165 (((
Alexander Mott 43.1 166 Zūm Wired firmware v1.03.27 (device firmware v1.002.00026) updates the terminology from "master"/"slave" to "primary"/"secondary", and changes the ##zwms## command to ##zwps##
167 Devices running this newer firmware will not accept commands using "master"/"slave" as arguments.
Alexander Mott 41.1 168 )))
Alexander Mott 9.1 169
Alexander Mott 41.1 170 ZUMNET-JBOXs can be in either "Primary" or "Secondary" mode. In most situations, "Primary" is the desired mode of operations, as "Secondary" mode effectively turns a ZUMNET-JBOX into a ZUMLINK-JBOX and prevents it from discovering devices on the Zūm Link bus or performing any logic. There are two scenarios in which a ZUMNET-JBOX should be configured in "Secondary" mode:
171
Alexander Mott 9.1 172 1. It is connected to another ZUMNET-JBOX via the Zūm Link bus
173 1. It is being used as a Cresnet device, connected to a processor or DIN-CENCN-2 using a Cresnet/Zūm Link adapter
174
Alexander Mott 41.1 175 ZUMNET-JBOXs with firmware 1.006.00012 or newer will ship from the factory in "Primary" mode, but will go to "Secondary" mode if a hardware reset is performed. ZUMNET-JBOXs with older firmware will ship in "Secondary" mode. The commands to view or change the Primary/Secondary mode are:
Alexander Mott 9.1 176
Alexander Mott 41.1 177 * View current mode:
178 ** Current FW: ##zwps## or ##zwmode##
179 ** Old FW: ##zwms##
Alexander Mott 42.1 180 * Make "Primary":
Alexander Mott 41.1 181 ** Current FW: ##zwps primary##
182 ** Old FW: ##zwms master##
Alexander Mott 42.1 183 * Make "Secondary":
184 ** Current FW: ##zwps secondary##
185 ** Old FW: ##zwms slave##
Alexander Mott 9.1 186
Alexander Mott 41.1 187 A reboot is required if the mode is changed.
Alexander Mott 9.1 188
Alexander Mott 44.1 189 == Zūm/Cresnet Mode ==
Alexander Mott 4.1 190
Alexander Mott 50.1 191 Zūm Mode (also known as App Mode) is the default setting for ZUMNET-JBOXs shipping on newer firmware, and allows them to be configured from the Crestron Zūm App as long as a ZUMLINK-KP is connected to the JBOX. 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.
Alexander Mott 44.1 192
Alexander Mott 50.1 193 Generally, ZUMNET-JBOXs do not need to be in Cresnet mode to work with ShowRunnerCLC™ except in specific cases:
194
195 * ZUMNET-JBOX-DALI controllers are being used in legacy mode
196 * Site-specific security requirements do not allow for wireless connectivity to the lighting controls
197 * Certain ShowRunnerCLC™ features are required (such as changing the dimming response curve)
198 * On older versions of firmware, Cresnet mode was required if non-Zūm Link devices were connected to the ZUMNET-JBOX (e.g. a GL-EXP-DIMU-CN phase dimmer or C2N-CBD-P Cameo keypads)
199 ** This is no longer the case on recent firmware, and ZUMNET-JBOXs with Cresnet hardware connected to them can be left in Zūm/App mode, though the Cresnet hardware will not be able to function without the control processor
200
201 When a ZUMNET-JBOX is in Zūm Mode and configured to communicate with a processor running ShowRunnerCLC™ software, it is operating in a kind of "App Plus" mode, where any actions that are defined in ShowRunnerCLC™ are performed "on top of" the actions defined in the App:
202
203 * A keypad with actions defined in the Zūm App will perform actions defined in ShowRunnerCLC™ in addition to those App-defined actions while the ZUMNET-JBOX is in Zūm Mode
204 ** This is useful when trying to add functionality to a keypad, such as allowing the keypad to control devices not available in the Zūm App (e.g. shades, loads that are controlled by other ZUMNET-JBOXs or Cresnet load controllers, etc.), but can cause confusion in other situations where there are conflicts between the App-defined actions and the ShowRunnerCLC™-defined actions (e.g. if a rocker keypad with the default All On and All Off actions defined in the App is programmed in ShowRunnerCLC™ to act as a single load toggle, it will not work correctly)
205 ** A ZUMLINK-KP that is disabled from ShowRunnerCLC™ (i.e. by using the Keypad Disable function) will not perform any actions
206 ** A ZUMLINK-KP that has null actions defined in the Zūm App will only perform those actions that are defined in ShowRunnerCLC™
207 * If occupancy sensor load assignments in the App do not match ShowRunnerCLC™, then odd behavior may result
208
Alexander Mott 44.1 209 The commands to view or change the Zūm/Cresnet mode are:
210
211 * View current mode: ##zwmode##
212 * Make Zūm/App mode: ##zwmode zum##
213 * Make Cresnet mode: ##zwmode cnet##
214
215 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.
216
217 === DALI Group/Legacy Mode ===
218
219 ZUMNET-JBOX-DALI that are operating in App mode should be kept in "Groups" DALI mode, and DALI loads must be configured through the Zūm App. ZUMNET-JBOX-DALI that are operating in CNET mode with ShowRunner™ must be changed to "Legacy" DALI mode, and the DALI ballasts must be addressed and grouped using the Crestron Toolbox DALI Commissioning 2.0 Tool.
220
221 To change modes, run the appropriate dalisetmode command, wait 5 seconds, and then reboot the ZUMNET-JBOX-DALI:
222
223 * Set Legacy mode: ##dalisetmode 1 1##
224 * Set Groups mode: ##dalisetmode 1 2##
225
226 === Zūm Mode Auto Switch ===
227
228 Zūm Mode Auto Switch is a feature introduced by Crestron in November of 2022 with .puf firmware v1.04.05 (device firmware 1.004.00005). This feature is intended to address concerns that arose from projects using custom programs with ZUMNET-JBOX-* devices in CNET Mode. Previously, if a device in CNET Mode lost connection to the processor, then it would be impossible to maintain any sort of control over the lighting. With Zūm Mode Auto Switch enabled, a ZUMNET-JBOX running in CNET Mode will automatically switch to App Mode and process local logic in the event that it loses connection to the processor.
229
Alexander Mott 46.1 230 Note that on 0-10V and switched JBOXs, the connected loads will flash once when rebooting. On ZUMNET-DALI-JBOX models, the JBOX will reboot once when switching to App mode and twice when switching back to CNET mode (once to switch to CNET, and a second time to switch to Legacy DALI mode)
231
Alexander Mott 44.1 232 Enable Zūm Mode Auto Switch using the command: ##autoswitch on##
233
234 Rebooting after changing Auto Switch modes is not officially required, but is still recommended.
235
236 //Any configuration changes made through the Zūm App should be made while the control processor is disconnected: the easiest ways to accomplish this are to either disconnect the Cat5e/Cat6 cable at the processor or use Text Console commands (//##stopprog -p:01##//)to temporarily suspend the custom program on the processor.//
237
238 == Changing IP-IDs ==
239
Alexander Mott 4.1 240 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.
241
242 If a Zūm Link device is moved from one ZUMNET-JBOX to another, then this ##"DeviceHostId"## must be updated with the IP-ID of the new device.
243
244 If a ZUMNET-JBOX is assigned a different IP-ID, then it's own ##"DeviceHostId"## as well as the ##"DeviceHostId"## for all hosted Zūm Link devices must be changed to the new IP-ID. In addition to changing these ##"DeviceHostId"##, the ##"IpId"## for the associated entry in ##"IpDevices"## must be updated. ##"IpDevices"## are located towards the beginning of the configuration file. Note that while the ##"DeviceHostId"## is in hexadecimal, the ##"IpId"## is a decimal integer. This means that a ZUMNET-JBOX with ##"DeviceHostId": "31"## would be associated with an entry in ##"IpDevices"## with ##"IpId": 49##
245
246 Below are two snippets from a configuration file comparing a ZUMNET-JBOX-16A-LV lighting controller and it's associated entry in ##"IpDevices"##:
247
248 [[image:1655247008527-737.png]]
249
250 [[image:1655246948921-246.png]]