Wiki source code of Ethernet Intersystem Communications Export (Crestron)

Version 10.1 by Alexander Mott on 2023/05/11 15:30

version	line-number	content
6.1	1	(% class="box warningmessage" %)
	2	(((
	3	Note: Any changes to load hardware/scene quantity will require a regeneration of the EISC and will result in signal changes.
	4	)))
	5
9.1	6	ShowRunnerCLC™ provides Ethernet Intersystem Communications interfaces for integration with 3rd party Crestron systems.
1.1	7
	8	* EISCs may be Classic, 3-Series, or Server/Client (VC-4) types
	9	* EISCs can have their IP-ID and IP Address of the remote changed at run-time without a program restart
	10	* An RSD file will be built for each EISC and a URL will be displayed on the touchscreen to retrieve it
	11	* There are 2 EISC modes and only one mode is supported on an EISC definition, multiple EISCs may be defined
	12	** AV Integration
	13	*** Provides a standardized interface for controlling areas
2.1	14	*** Area selection may be changed at run-time
	15	*** [[AV Integration Demo>>url:https://files.chiefintegrations.com/s/Di4aypEKX7APn8n]]
3.1	16	*** Signals Provided per Area (signals vary by Area settings/configuration):
	17	**** Area Name
	18	**** Occupied
	19	**** Occupancy Enable/Disable
	20	**** Color Temp Auto
	21	**** Color Temp Manual Set and Feedback
	22	**** Area Master Raise/Lower
	23	**** Save Current Scene
	24	**** Recall Scene # and Current Scene Feedback
	25	**** Extended Scene Export option set
	26	***** Scene Count
	27	***** Scene Names
	28	**** Load Count
	29	**** Load Level Analogs
	30	**** Load Names
	31	**** Extended Load Export option set
	32	***** CCT Load type: Color Temp
	33	***** RGB[A\|W]: Individual Color Channels
	34	**** Shade Count
	35	**** All Shade Open/Close
	36	**** Shade Name
	37	**** Shade Open/Close/Stop
5.1	38	**** Ignore Fade Times option set
	39	***** Fade Times are not sent out, only final value. Reduces traffic.
1.1	40	** Device Export
3.1	41	*** Exports devices with specific signals for each device type
	42	**** Occupancy Sensor
	43	***** Occupied
	44	***** Online Feedback
	45	**** Keyswitch
	46	***** Active Feedback
	47	**** Partition Sensor
	48	***** Combined Feedback
	49	**** Keypad
	50	***** Enable/Disable w/ Feedback
	51	***** Button Press Event
	52	***** Button Feedback Setting
	53	***** Extended Keypad Export option set
	54	****** Button Tap/Double Tap/Held Events
	55	**** Global Actions
	56	***** Activate
	57	**** Shade
	58	***** Open/Close/Stop
	59	**** Load
	60	***** Level Set and Feedback
	61	**** Photocell
	62	***** Sensor Reading
	63	**** Area
	64	***** Scene Set and Feedback
6.1	65	*** Devices to be exported are defined in the configuration and are not changeable at run-time.
8.1	66
10.1	67	(% class="wikigeneratedid" %)
	68	==== Processors with Control Subnets ====
	69
	70	When integrating a 3-Series EISC with a processor that has both a LAN port and a Control Subnet using a connection over the LAN, there are some additional settings that need to be enabled in order for the integration to work correctly. These commands are the same for both 3-Series and 4-Series processors:
	71
	72	* ##securegateway default##
	73	** Enables non-secure connections (CIP on port 41794) from the LAN side instead of requiring a secure connection (SCIP on port 41796)
	74	* ##isolatenetworks off##
	75	** Enables communications between the LAN and the Control Subnet, where the actual control processor is located
	76
8.1	77	==== VC-4 Specific Notes ====
	78
	79	===== Prerequisites =====
	80
	81	* VC-4 server installed
	82	* Recommended VC-4 server hardened per [[Crestron>>https://support.crestron.com/app/answers/detail/a_id/1001249/kw/harden%20VC-4]]
9.1	83	** Will require SETCSAUTHENTICATION command on processor
8.1	84	** VC-4 installer will need to provide username and password for processor to connect, this is used with SETCSAUTHENTICATION
9.1	85	* ShowRunnerCLC™ running on a processor
	86	* EISC created in the ShowRunnerCLC™ config
8.1	87	* AV program running on VC-4, AV programmer will need to provide the ROOM ID from VC-4
	88
9.1	89	===== ShowRunnerCLC™ Config Settings =====
8.1	90
	91	* Define EiscType in config: ##"EiscType": "VirtualControlEiscClient"##
	92	* Define Vc4RoomId in config: ##"Vc4RoomId": "VC4ROOMID"##
	93	* IpAddressOrHostname will not used, instead VCSERVERADDR will be used instead
	94
	95	===== Processor Settings =====
	96
	97	* Use console command VCSERVERADDR (or processor configuration pages) to add the VC-4 server IP address or hostname. Example: ##VCSERVERADDR my-vc-4-server.mycorpnet.com##
	98	* If security (hardening) is enabled use console command SETCSAUTHENTICATION to enroll the credentials used to login to VC-4. Example: ##SETCSAUTHENTICATION -n:vc4user -p:vc4password##
	99	* Reboot after entering the above settings
	100
	101	(% class="box warningmessage" %)
	102	(((
9.1	103	ShowRunnerCLC™ will generate the RSD file as an EISC type, the SIMPL Windows programmer will need to convert the symbol to an //EISC Server//. At the time of this writing, Crestron does not allow import/export of RSD files for //EISC Client//, //EISC Server,// and //Virtual Control EISC Client// types.
8.1	104	)))
	105
	106	(% class="box warningmessage" %)
	107	(((
9.1	108	ShowRunnerCLC™ uses analog join 4001 on normal EISCs to confirm the logic is fully online. Join 4001 is not available on //EISC Client//, //EISC Server,// and //Virtual Control EISC Client// types so 4000 is used instead.
8.1	109	)))