Last modified by Alexander Mott on 2023/12/19 00:37
From version 16.2
edited by Alexander Mott
on 2023/12/18 23:17
Change comment: (Autosaved)
To version 17.16
edited by Alexander Mott
on 2023/12/19 00:31
Change comment: There is no comment for this version

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -*Addressing Devices from Toolbox
1 +Addressing Devices from Toolbox
Hidden
... ... @@ -1,1 +1,1 @@
1 -true
1 +false
Content
... ... @@ -2,8 +2,16 @@
2 2  {{toc/}}
3 3  {{/box}}
4 4  
5 -Introduction
5 +In ShowRunnerCLC™, all hardware on the job is defined in the configuration so that it can be registered with the processor when the program starts. Once the program has been installed and all hardware is reporting online, the program still will not work unless the hardware has been addressed according to the config.
6 6  
7 +The hardware definitions in the configuration (which are reflected in the SRTakeoff) are based on the approved submittals provided by the Crestron Agent. If the as-built conditions do not match the submittals, then it is generally preferable to modify the installation (i.e. move Cresnet cables around, reconnect devices, etc.) so that the as-built conditions match the design as given in the submittals. If this cannot be accomplished, then the configuration may be modified to match the as-built conditions, though some restrictions still apply (e.g. the limit of 25 devices per Net on a DIN-CENCN-2 is a hard limit built into the hardware and there is no software workaround).
8 +
9 +Some the following is a non-exhaustive list of some of the details which require configuration changes to implement:
10 +
11 +* Specific host device (e.g. the specific DIN-CENCN-2, CEN-GWEXER, or processor that a device is connected to)
12 +* Specific net of the host device (e.g. whether a device is landed at Net 1 or Net 2 of a DIN-CENCN-2)
13 +* Specific Connection ID or Network ID of the device
14 +
7 7  = Network Device Tree View =
8 8  
9 9  (% class="box warningmessage" %)
... ... @@ -12,47 +12,65 @@
12 12  Check the currently installed version of Toolbox by navigating to Help > About Crestron Toolbox... and upgrade or downgrade your installation as necessary, or use an alternate method of addressing devices
13 13  )))
14 14  
15 -Network Device Tree View is the most user-friendly way of manually addressing devices for Crestron systems. Below is information specific to using the Network Device Tree View tool to address devices; see our [[Toolbox Basics page>>doc:SHOWRUNNER™ Setup Guide.SHOWRUNNER™ Installation Guide.Preparation.Toolbox Basics.WebHome||anchor="HNetworkDeviceTreeView"]] page for more general information on using and configuring the tool. When using the Network Device Tree View tool to address devices, keep the following in mind:
23 +Network Device Tree View is the most user-friendly way of manually addressing devices for Crestron systems. Below is information specific to using the Network Device Tree View tool to address devices; see our [[Toolbox Basics page>>doc:SHOWRUNNER™ Setup Guide.SHOWRUNNER™ Installation Guide.Preparation.Toolbox Basics.WebHome||anchor="HNetworkDeviceTreeView"]] page for more general information on using and configuring the tool.
16 16  
17 -*
25 +Below are some tips and things to keep in mind when using the Network Device Tree View tool to address devices for a ShowRunnerCLC™ deployment:
26 +
18 18  * **It is generally recommended to right-click and ensure that "Show by Device Connection" is checked.** While "Show by Category" can be useful in some situations, it is not recommended when addressing devices as it gives no indication which Net a device is connected to and may lead to accidentally misaddressing devices. "Show by Device Connection" will group devices by their connection to the host device (e.g., Cresnet devices on a DIN-CENCN-2 will be sorted by the Net that they are connected to, Zūm Wireless devices will be sorted by the ZUM-NETBRIDGE they are connected to, etc.).
19 -* In the below screenshot, all devices have already been addressed so all devices appear with the yellow circle indicating "Status: OK"
20 -* [[image:ndtv_by connection.png||height="508" width="401"]]
21 -* A new system where all devices are online but have not been re-addressed may look more like the following example, with a red exclamation point indicating duplicate Network IDs (all devices ship from the factory with the same Network ID, which inevitably leads to duplicate IDs 
28 +** In the below screenshot, all devices have already been addressed so all devices appear with the yellow circle indicating "Status: OK"
29 +[[image:ndtv_by connection.png||height="508" width="401"]]
30 +** A new system where all devices are online but have not been re-addressed may look more like the following example, with a red exclamation point indicating duplicate Network IDs (all devices ship from the factory with the same Network ID, which inevitably leads to duplicate IDs on an uncommissioned system)
22 22  [[image:ndtv_all loops.png||height="503" width="404"]]
23 -** Other types of status indicator may include a black circle for "Invalid Network ID" or "Invalid/duplicate TSID or Serial Number"
24 -* Right-clicking on an individual device will give many options to resolve common issues, as well as allow for identifying a specific device:
25 -** "Refresh All" use to refresh the list of actively connected devices, necessary e.g. if a Cresnet cable has been connected/disconnected from the device
26 -*** F5 is the keyboard shortcut for this function, though in both cases it may be more reliable to completely close and reopen Network Device Tree View to ensure all devices are refreshed
27 -** "Change Network ID..." use to change the Network ID (CID) of a specific device (see our [[device addressing page>>doc:SHOWRUNNER™ Setup Guide.SHOWRUNNER™ Installation Guide.Device Addressing.Addressing Devices from Toolbox.WebHome||anchor="HNetworkDeviceTreeView"]] for more information)
28 -*** F2 is the keyboard shortcut for this function
29 -** "Identify This Device..." will put a specific device into "Identify" mode, the specific behavior for which depends on the individual device:
30 -*** Note that entering identify mode may stop the ShowRunnerCLC™ program and restart it when exiting identify mode: **to avoid losing progress and placing strain on the processor**, it is recommended to either identify and address all hardware prior to loading the ShowRunnerCLC™ program, or temporarily suspend the program with the console command ##stopprog -p:01## and then resume the program once done identifying all devices with the command ##progreset##
31 -*** Some devices will flash an LED (Cresnet keypads, GLS-SIMs, et al.)
32 -*** Some devices will flash an LED and make a noise (Cresnet occupancy sensors, most room controllers, et al.)
33 -*** Load controllers will typically flash all connected loads
34 -** "Change Serial Number..." is used to change the device's Serial Number (and thus its TSID); this is rarely required and is only necessary in cases where a device reports an invalid or duplicate SN/TSID, or where the reported SN does not match the SN physically printed on the device
35 -** "Open Text Console..." will open a Text Console window directly to the specific selected Cresnet/RFID device (//not// to the host device you are connected to in Network Device Tree View); only recommended for advanced users
36 -[[image:ndtv_rc on device.png]]
32 +** Other types of status indicator may include a black circle for "Invalid Network ID" or "Invalid/duplicate TSID or Serial Number"
33 +* To address an individual device, open the Change Network ID dialog by:
34 +** Select the device so that it is highlighted and press the F2 key (you may need to hold down the "Fn" button on your laptop)
35 +** Right-click on an individual device and select "Change Network ID..."
36 +* With the Change Network ID dialog open, type the new hexadecimal Network ID for the device into the "New Value" field and click "OK"
37 +[[image:ndtv_change nid.png]]
38 +* After a few moments, the device should update its ID and the updated ID should be displayed
39 +** If the displayed ID is not updated and there is a message at the bottom of the tool which reads "Cannot set primary ID for [x] device" or there is a button reading "Errors", then there may be Cresnet/ZUMLINK wiring issues or some other issue specific to the individual device that could not be addressed
40 +** If the displayed ID is not updated but there is no error message, try refreshing the results by pressing F5, right-click "Refresh All", or closing and reopening the Network Device Tree View tool
37 37  
38 38  = Text Console =
39 39  
40 -Command for processor/no nets
44 +With the correct preparation, the Text Console can be a much faster way of addressing devices as compared to Network Device Tree View since it is possible to rapidly address multiple devices near-simultaneously instead of being restricted to addressing one device at a time. Some caveats for addressing through Text Console are:
41 41  
42 -Command for devices with nets (DIN-CENCN-2/ZUMNET)
46 +* You must know the TSID of the device to be addressed
47 +** This can be obtained through Network Device Tree View or by using the ##ppndiscover## command (this command returns all online devices listed with their model, Network ID, and TSID)
48 +** Devices which have a 1:1 correlation of serial number to TSID can also be converted using an Excel plugin or with the "Utility > Serial/TSID Conversion..." menu in Toolbox
49 +* Using Excel's CONCAT() function can be useful for automatically constructing the necessary console commands provided the Takeoff has been kept up-to-date with the TSID and required Network ID for each device
43 43  
44 -Command for RFID
51 +The command required for addressing a device varies by the host device you are connected to:
45 45  
53 +* For Cresnet devices without Nets (such as processors and GLPACs): 
54 +** ##setcresnetidbyppn [CID] [TSID]##
55 +** [CID] is the network ID for the device as dictated in the Takeoff/configuration (hexadecimal value as low as 03 with a variable maximum value determined by host device)
56 +** [TSID] is the touch-settable ID of the device
57 +* For Cresnet/ZUMLINK devices with Nets (such as DIN-CENCN-2s and ZUMNET-JBOXs):
58 +** ##setcresnetidbyppn [NET] [CID] [TSID]##
59 +** [NET] is the net that the device is landed on (for DIN-CENCN-2s, this is either "1" or "2"; for ZUMNET-JBOXs this is always 1)
60 +** [CID] is the network ID for the device as dictated in the Takeoff/configuration (hexadecimal value as low as 03 with a variable maximum value determined by host device)
61 +** [TSID] is the touch-settable ID of the device
62 +* For RFID devices (such as CEN-GWEXERs): 
63 +** ##setrfidbytsid [CID] [TSID]##
64 +** [CID] is the network ID for the device as dictated in the Takeoff/configuration
65 +** [TSID] is the touch-settable ID of the device
66 +
46 46  = Troubleshooting Tips and Tools =
47 47  
48 -== General Tips ==
69 +When addressing devices, there are a number of issues that can occur. The causes of these issues can vary wildly and troubleshooting them requires taking a methodical approach to narrowing potential causes of the issue. Below are some general tips for troubleshooting Cresnet, but is by no means exhaustive and learning to troubleshoot low-voltage data is a skill that can only really be developed through experience.
49 49  
50 -Verify correct connection point
71 +== General Troubleshooting Tips ==
51 51  
73 +* Verify
74 +
52 52  Isolate cables
53 53  
54 54  Check for cabling loops
55 55  
56 -== Network Analyzer Tool ==
57 -
58 58  == DIN-CENCN-2 Specific Tips ==
80 +
81 +There are some unique console commands and features available on DIN-CENCN-2s that provide additional information about potential Cresnet wiring issues:
82 +
83 +* The ##cnettest## console command will provide information such as power fault, shorts between two of the 24/Y/Z/G wires, communication issues at specific devices, among others
84 +* Navigating to the DIN-CENCN-2 IP address in a web browser will bring up the web UI (default credentials "crestron
ndtv_change nid.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.alexander\.mott@chiefintegrations\.com
Size
... ... @@ -1,0 +1,1 @@
1 +19.9 KB
Content