User manual CRESTRON ACTIVE CNX

[. . . ] These inputs go into the control system and appear to the control system as an "e-control PC Interface" symbol. From that point, the user programs the SIMPL logic as if the system was a real touchpanel. When a signal changes on the inputs of the "e-control PC Interface", a message is sent to the ActiveCNX control. The control responds by firing an event. [. . . ] If this value is set to TRUE, a dynamic entry is added into the device's IP ID table. Otherwise, to get feedback to the application, a static entry must be manually added to the IP table in the CEN device (refer to the latest revision of the specific CEN documentation). The default value of this property is FALSE. There is only one connection per ActiveCNX Control so if connect is called the second time Disconnect() is automatically called and Connect() is issued again with the new properties. For multiple connections per application, simply drop multiple ActiveCNX controls on the form. Methods The general procedure for using the components methods are to first call Connect() to start the control session and when complete call Disconnect(). Between Connect() and Disconnect() any combination of the sending and receiving the three data types can be used. At anytime during development if the programmer needs to see Introduction & Tutorial - DOC. 5777A Active CNX · 3 Software Crestron Active CNX methods, properties, or events available for the ActiveCNX they can bring up the "Object Browser" in Visual Basic. The Object browser list for the ActiveCNX control is shown below. Object Browser List Events OnDigital OnAnalog OnSerial OnError OnConnect OnDisconnect The ActiveCNX control also triggers events used for feedback and for handling errors. In "design mode" the user can select the ActiveX component from the combo box on the left then select which event to capture. Once the event is selected, it is entered into the program as a "sub procedure". From this point, the programmer can handle the signal however they choose. For example, a digital "on" could signal another component to send a specific email. The event returns the join number and the corresponding value. For example if a temperature sensor value on the Cresnet network changes and the signal is fed into the "Virtual Touch Panel" symbol the OnAnalog event is fired with its join number and the analog value (Long) as parameters. The OnConnect() event is only fired if the connection is successful after calling the Connect() method. If Connect() fails for some reason the type and description is sent to the OnError() event. The OnDisconnect() event is only fired if there is a successful disconnection. 4 · Active CNX Introduction & Tutorial - DOC. 5777A Crestron Active CNX Software Errors When an error occurs the OnError() event is triggered with one of the following parameters and a description string. ERROR CODES: CNX_BASEERROR CNX_CANNOT_CREATE CNX_ALREADY_CONN CNX_NOT_CONN CNX_NETDOWN CNX_CONNRESET CNX_CONNABORTED CNX_CONNREFUSED CNX_CONNCLOSED CNX_INVALID_IP CNX_NOT_AVAIL CNX_TIMEDOUT CNX_NOT_SOCK CNX_NOTCONNECTED CNX_REJECT CNX_GENERAL CNX_NOTCIPNODE 7000 7001 7002 7003 7004 7005 7006 7007 7008 7009 7010 7011 7012 7013 7014 7015 7016 Can not create socket. Already connected Not connected to server The Windows Sockets implementation detected that the network subsystem failed. The virtual circuit was reset by the remote side. [. . . ] The foregoing remedy shall be your exclusive remedy for any claim or loss arising from the Software. CRESTRON shall not be liable to honor warranty terms if the product has been used in any application other than that for which it was intended, or if it as been subjected to misuse, accidental damage, modification, or improper installation procedures. Furthermore, this warranty does not cover any product that has had the serial number or license code altered, defaced, improperly obtained, or removed. Notwithstanding any agreement to maintain or correct errors or defects Crestron, shall have no obligation to service or correct any error or defect that is not reproducible by Crestron or is deemed in Crestron's reasonable discretion to have resulted from (1) accident; unusual stress; neglect; misuse; failure of electric power, operation of the Software with other media not meeting or not maintained in accordance with the manufacturer's specifications; or causes other than ordinary use; (2) improper installation by anyone other than Crestron or its authorized agents of the Software that deviates from any operating procedures established by Crestron in the material and files provided to You by Crestron or its authorized agent; (3) use of the Software on unauthorized hardware; or (4) modification of, alteration of, or additions to the Software undertaken by persons other than Crestron or Crestron's authorized agents. [. . . ]