Crestron e-Control Operation Manual page 14

Software Development Kit & CNX Gateway
10 • Crestron e-control™: Software Development Kit & CNX Gateway
Ethernet devices that are addressed by the control system may have their IP
addresses set either in the SIMPL Windows program or through the Viewport with a
PC. Just as each Cresnet device is assigned a Cresnet ID, e.g. 03 through FE, to be
used when programming, an Ethernet device is assigned an IP ID which also may
range from 03 through FE. Ultimately, each IP ID is converted into an actual IP
address through an IP Table that exists inside the CNX control system. This will be
discussed in more detail below.
2. Add Ethernet-Connected Devices to a SIMPL Windows
Program
To add Ethernet devices to your program, in the SIMPL Windows' Configuration
Manager, drag an Ethernet-connected device, e.g. a CEN-IO or a Virtual Touchpanel
symbol, into the program. Drop it on the CNXENET card or the "Ethernet Units"
arrow underneath the "Cresnet Units" arrow. (Pull the window divider down further
if you don't see it in the System View window.) Double click on the icon and assign
an IP ID and a corresponding IP address in the tabbed configuration dialog titled "IP
Net Address". For example, drop a CEN-IO and assign it IP ID: 03 at IP address
192.168.2.7. In the SIMPL Windows Program Manager, connect signals to the
"Virtual Touchpanel" symbol, exactly as you would to a regular wired Touchpanel
symbol.
3. Change the IP Address of Ethernet Devices without
Changing the Program
When your SIMPL Windows program is compiled, the compiler makes an "IP
Table" consisting of the IP IDs and the IP addresses that were entered in for the
various Ethernet devices added to the program. During upload, you can choose
whether to load this IP table or whether to use the IP table that already exists in the
control system.
You can modify the corresponding IP address for any IP ID without changing or
reloading the program by changing the IP table in the control system directly. From
the Viewport select Setup IP Table... from the Function menu. Now click on the
button labeled Retrieve Current IP Table from Control System. This will extract
the IP Table from the CNX system and list it in the dialog box. You are now able to
modify or delete existing entries as well as add new ones. When you have made all
the changes necessary, you can save the new table to disk and/or load it back into the
control system. Once you have made these changes, be careful not to overwrite the
IP table in the control system the next time you upload the program, unless the
addresses in your program supercede those in the current IP table.
4. IP ID Behavior in the Crestron e-control SDK
It is extremely important that the IP ID in the SIMPL Windows program MATCH
the IP ID (sometimes called the Cres ID) encoded in the Crestron e-control SDK
object by the developer of the Web page or Visual Basic program. Refer to the
diagram on the next page.
If more than one computer uses the same IP ID for a connection (e.g. each loads the
same Web page), the CNX Gateway will duplicate all packets that are received from
the CNMSX to each of the identical IP IDs. This is known as Touchpanel tracking in
standard Crestron terms. The IP Address that is typed into the "Virtual Touchpanel"
devices in the SIMPL Windows program is the IP Address of the CNX Gateway, not
of the individual PCs (running a web browser or Active CNX application), since
these individual computers may change, but the CNX Gateway remains fixed.
Crestron e-control™
Operations Guide - DOC. 5778A