Crestron e-control™ Software Development Kit & CNX Gateway Contents Crestron e-control™: Software Development Kit & CNX Gateway 1 Introduction ............................................................................................................................... 1 What is Crestron e-control Software Development Kit? ............................................. 1 How do I Choose Whether to Use HTML/Java or ActiveX Components? ................. 2 What Other System Requirements are There?........
Crestron e-control™ Software Development Kit & CNX Gateway Crestron e-control™: Software Development Kit & CNX Gateway Introduction Crestron e-control consists of two separate products – the Software Development Kit (SDK) and the CNX Gateway. The SDK is a free download containing tools for developing demo webpages or Visual Basic programs that have the potential to communicate with Crestron CNX equipment. The CNX Gateway must be purchased and licensed from Crestron.
Software Development Kit & CNX Gateway Crestron e-control™ How do I Choose Whether to Use HTML/Java or ActiveX Components? Use the HTML/Java/Web page method if you need platform independence (i.e., you must run from Macintoshes as well as PCs) and you have the ability to write HTML. At this time, Crestron does not provide any method for developing Web pages.
Crestron e-control™ Software Development Kit & CNX Gateway e-control™ System Architecture Web Browser VC++ VB IE Clients ActiveCNX Control CNX Gateway/ Web Server Server Crestron Network Any Crestron Controllable Device Operations Guide - DOC.
Software Development Kit & CNX Gateway Crestron e-control™ Installing the Software Depending upon where you received your e-control software, installation procedures may vary. Currently, there are two ways to get a copy of the e-control SDK software. 1. Purchase the CNX Gateway from Crestron (you receive a CD-ROM). 2. Download the e-control Software Development Kit (SDK) from the Crestron website.
Crestron e-control™ Software Development Kit & CNX Gateway Running the Demos NOTE: Change the communication component in the HTML code of the demo. Make sure the IP address is the IP address of the control system. Also, the control system programming needs to have the IP address of the CNX Gateway. To run either of the CNMSX demo programs that are shipped with this SDK, use the Viewport to load “Net Demo.bin". This file has been written for a CNMSX-PRO. If you are using a unit without a front panel (eg.
Software Development Kit & CNX Gateway Crestron e-control™ additional connections by calling Crestron Customer Support and getting a new site key. Transferring an Existing License To Another Computer As mentioned above, a license is only valid on the computer for which it was obtained. However, a license can be transferred from one computer to another. There are several reasons to transfer a license.
Crestron e-control™ Software Development Kit & CNX Gateway Setup Hardware Setup of CNMSX Follow these steps to enable Ethernet communications in your CNX control system: Operations Guide - DOC. 5778A 1. Install the CNXENET Direct Processor Access (DPA) card into the CNMSX. Refer to the CNXENET manual (latest revision of Doc. 8129) for instructions. 2. Connect your PC to the CNMSX computer port via a serial cable, as usual. Refer to the CNMSX manual (latest revision of Doc. 8118) for instructions. 3.
Software Development Kit & CNX Gateway Crestron e-control™ “Reply from address …”. If you are running on an “isolated network” (i.e., a network that contains only your PC and the CNMSX equipment and is not connected to the larger intranet) and do not get a response from the “ping” to the IP address of the CNMSX, go back to the previous steps to see if you can find an error. C:\WINDOWS>ping 132.149.2.2 Pinging 132.149.2.2 with 32 bytes of data: Reply Reply Reply Reply from from from from 132.
Crestron e-control™ Software Development Kit & CNX Gateway Configure the CNX Gateway The CNX Gateway is self-configuring and requires no manual adjustments. Upon starting, it acquires the IP address and name of the host PC (the computer on which it is running). If you want the CNX Gateway to begin running automatically when your PC starts, place it in the Windows StartUp menu. Click on Start, then Settings, then Taskbar. Choose tab “Start Menu Programs”, and then click on “Add”. Browse for the CNX Gateway.
Software Development Kit & CNX Gateway Crestron e-control™ 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.
Crestron e-control™ Software Development Kit & CNX Gateway Typical e-control Configuration Virtual Touchpanel IP ID : 03 CNX Gateway IP Address: 1.2.3.4 Virtual Touchpanel IP ID : 05 CNX Gateway IP Address: 1.2.3.4 NOTE: The default IP address should be the CNX Gateway and Web Server IP address. SIMPL Windows Program CNMSX IP Address: 1.1.1.1 Network CNX Gateway and Web Server IP Address: 1.2.3.4 Connected as IP ID : 03 PC running Web Browser or ActiveCNX app. 1.2.3.4 Server IP: 1.1.1.
Software Development Kit & CNX Gateway Crestron e-control™ Running Start the CNX Gateway The CNX Gateway must be running whenever any Web page or Visual Basic program attempts to communicate with Crestron equipment. Refer to the discussion above if you want to place the CNX Gateway in your Startup menu. Only one CNX Gateway needs to run on any network, although it is possible to run one or multiple copies on some or all PCs.
Crestron e-control™ Software Development Kit & CNX Gateway Troubleshooting If a Crestron e-control web page is not communicating to a control system, refer to the following troubleshooting tips prior to calling Crestron for assistance. 1. Verify the CNX Gateway is running on the same PC as the Web Server. 2. Verify the contents of the IP table match the IP address of the CNX Gateway and the IP ID of the e-control page. 3.
Software Development Kit & CNX Gateway Crestron e-control™ 12. System Configuration Details – Basic System Diagram. Use of Ping or Telnet to Verify Communication Ping Tests communication between PC and CNMSX’s IP Address Telnet 41794 Telnets into CNX Gateway and establishes a connection. The connections can be seen in the CNX Gateway dialog. Leaving Telnet breaks the connection.
Crestron e-control™ Software Development Kit & CNX Gateway Appendix A: Contents of the Crestron e-control SDK CD The ActiveX control is installed in the \windows\system directory and is registered when installed. The folder structure of the installed components of the Crestron e-control SDK is as follows: Gateway Folder: Contains CNX Gateway (if CNX Gateway product was ordered). SDK Folder: Contains a readme file. ActivCNX Subfolder: • Contains ActiveX components and examples.
Software Development Kit & CNX Gateway Crestron e-control™ Glossary of Terms CNX Control System Any Crestron control processor in the CNX product line. Currently, these include the CNMSX-PRO and CNMSX-AV. CNX Gateway A Crestron software package that routes control messages between the Crestron econtrol SDK and the Crestron Ethernet device. Cresnet ID A unique identity code, ranging from 03 to FE (in hex), given to all devices that communicate using the Cresnet network protocol.
Crestron e-control™ Software Development Kit & CNX Gateway Subnet Mask A pattern of bits in IP address format (e.g., 255.255.255.0) which, when bitwise "and"ed with your address, produces a network address. If an outgoing packet's network address has the same network address as the source of the packet, it is sent on the local network wire, to be received by a device on that local network. Otherwise, it is sent to the gateway address instead, to be routed to a device existing on another network.
Software Development Kit & CNX Gateway Crestron e-control™ Software License Agreement This License Agreement (“Agreement”) is a legal contract between you (either an individual or a single business entity) and Crestron Electronics, Inc. (“Crestron”) for software referenced in this guide, which includes computer software and, as applicable, associated media, printed materials, and “online” or electronic documentation (the “Software”).
Crestron e-control™ Software Development Kit & CNX Gateway If You are a business or organization, You agree that upon request from Crestron or its authorized agent, You will within thirty (30) days fully document and certify that use of any and all Software at the time of the request is in conformity with Your valid licenses from Crestron of its authorized agent.
