Crestron Intercom Demo (TPMC-Only) v1_0_2 Release Notes
============================================

This is a simplified version of the complex Intercom Demo progam.

This program demonstrates programming to allow each Location to be able to Call one of many other Locations and then be able to talk with someone at the other location.  When a Call is made, an audible alert is heard notifying the user to Answer the call.  Additional features are included by allowing the user to select one of three modes for each Location.

This program implements a Crestron Intercom system, which includes interaction between TPMC touch panels only.  
There are 5 touch panelsprogrammed in this example. 

NVS-100 Video streaming devices are used in this program to manage the distribution of video from each video source to each TPMC over Ethernet.

Features
========
- Intercom interaction over Ethernet TPMC touch panels.
- Video over Ethernet managed by NVS-100 video streaming devices.
- Three operation modes - Available, Privacy, and Do Not Disturb
- Single location, all locations, or Selective (Group) Paging.  To perform an All Page to multiple TPMC panels, each TPMC must have its own Barix Audio Interface associated with it.
- Can monitor (listen to) a location without user interaction at that location.  If a location is in Do Not Disturb mode, it cannot be monitored.
- A location can prevent an incoming monitor connection by setting its operation mode to Do Not Disturb.


Notes
=====
- This program is designed as a Push-to-talk system.  Each user can control when they are heard at the other end.
- IP addresses of most TPMC Ethernet panels using the VoIP method, will be dynamically obtained by the processor.
- IP addresses for TPMC-4SMs must be entered manually on their respective location modules.
- If a touch panel is connected using Cresnet, it must use the analog audio/video method of interacting for Intercom.

To Program A Touchpanel on Cresnet:
- The same module for the Ethernet version of the module may be used.
  Example: To use a TPS-12 on Cresnet, insert the "Intercom TPS-12 (Ethernet) GUI Interface v3_0" module into the program and connect the hardware signals to the corresponding TPS-12.

General Operation
==============
This program allows each interface to operate in one of three modes.  The modes are Available, Privacy, and Do Not Disturb.  
When in Do Not Disturb mode, the location does not allow an incoming call, page or monitoring connection nor does it allow an audible alert to be heard at the location.  The location can still place a call when in Do Not Disturb.
Privacy is a notice to other locations.  The location can make and receive calls.  However, the location cannot be paged or monitored.  Also, an audible alert is not heard. Available is normal operation mode.  The location can make and receive calls, pages, and monitoring connections.

A location can initiate a call and must receive an answer in order to effectively communicate with the desired location.

Monitoring is to simply listen to another panel location.  To monitor location B from location A, enable monitoring on location A by touching the Monitor button next to Location B in the list .  The button will turn blue to show this is the room you are listening to.  You can only monitor one other location at a time.  To disable monitoring press the speaker icon, returns to black indicating monitoring is off.  By default, no locations have monitoring enabled at startup. If a location is currently monitoring or being monitored, and an incoming call is answered, the monitoring session will end.  If a location starts monitoring another location that is in a call already, the monitoring connection will not be allowed.

Paging is to only speak to one or more locations.  Individual paging is executed by touching the "Page" button next to the corresponding location.  Touch “All ROOMS” and speak or touch “Group #” and speak to page predefined paging groups .  You can set up to five different group configurations.


Important Information
=====================
CEN-NVS-100 Configurations
----------------------------------------
CEN-NVS-100#1 Video In to IVDS Out 18
CEN-NVS-100#2 Video In to IVDS Out 19
CEN-NVS-100#3 Video In to IVDS Out 20
CEN-NVS-100#4 Video In to IVDS Out 21
CEN-NVS-100#5 Video In to IVDS Out 22

TPMC-8X/TPMC-12/TPMC-8L Configuration
-------------------------------------------------------------
Configure the IP Table of the Touchpanel to point to the IP Address of the Pro2, see list of IPIDs below for specific IPID to use for the specific Location.
Default values for talk and listen thresholds for the Intercom application on TPMC Touch panels are set in the program on each of the corresponding TPMC location GUI modules.  These modules are located within subsytem S-4:VoIP Touchpanels.  These values have been set for optimal performance in this demo.  If these need to be changed do so by changing them on the appropriate location GUI module (located within subsytem S-4:VoIP Touchpanels) or using console commands.

Default values for wav volume are also set in the program. For TPMC Touch panels the default values are both 70%.  For the Doorbell, the doorbell wav volume is set to 50%. Your system may require changes to these default values - change these parameter values on the C2N-IIF Location GUI Interface found under subsystem S-5. Keep in mind this is like any audio system where each system is different. Be sure to check and balance your audio system just as you would any audio system. 


Customizing Locations
=================
To Remove a Location
-------------------------
- Disconnect the "UI_#_Information_IN" and  "UI_#_Information_OUT" cues from the Intercom Manager module for the corresponding Location.  The Intercom Manager is located within subsytem S-1.1.
  Ex. To remove location 8 (TPMC-8X), disconnect signal cues "Location_8_UI_Info_Out" and "Location_8_UI_Info_In" from the Intercom Manager's input (UI_8_Information_In) and output (UI_8_Information_Out) cues.

To Change Location Names
-------------------------------
To change the Location names, you must change the "Location Name" parameter on each location module. Location modules can be found under subsytems S-3:Analog Touchpanels, S-4:VoIP Touchpanels, and S-5:Interrupt (Doorbell).

To Configure Groups
------------------------
To add or remove a Location from a Group, enable (Yes) or disable (No) the location's corresponding group parameter on its location module.  (e.g. To add Location to group 1, set the Group 1 parameter on the Location module to Yes).


Configuration
=============
After completing your IP Address entries into the program, save, compile and load the program.
The SMW program contains a default IP Table. When loading the system, be sure to load the Default IP Table when prompted by Toolbox.  

Configure the IP tables on each of the Ethernet connected touch panels to point to the control system.  The correct IP IDs are shown below.

Select "NVRAM Disk" from the Functions pull down menu when System Info from Toolbox is communicating for your control system.  Verify NVRAM Disk is enabled or enable it from this dialog.

Using Toolbox's FileManager, add "Intercom.txt" into the NVRAM folder.  This file will be used to save the mode of each location.


This program is designed to work with the following hardware:

Pro2 Control System
-----------------------
Card slot 08 - C2ENET-1


Ethernet Devices
-----------------------
IP ID 29	- TPMC-8X Touch panel - Location 1
IP ID 2B	- TPMC-8X Touch panel - Location 2
IP ID 2D	- TPMC-8L Touch panel - Location 3
IP ID 2F	- TPMC-3X Touch panel - Location 4
IP ID 31	- TPMC-4SM Touch panel - Location 5

IP ID 34	- CEN-NVS-100 - NVS-100 #1
IP ID 35	- CEN-NVS-100 - NVS-100 #2
IP ID 36	- CEN-NVS-100 - NVS-100 #3
IP ID 37	- CEN-NVS-100 - NVS-100 #4
IP ID 38	- CEN-NVS-100 - NVS-100 #5

NOTE: When setting up IPIDs please be sure the touch panel does not also have a valid Cresnet ID for this program or is not connected to Cresnet of the control system.

Software Versions
=================
Simpl Windows:	2.12.42
Simpl+:		3.03.12
Device Database:	29.00.004.00
Crestron Database:	21.04.007.00
VTPro-e: 		4.1.0.8
Toolbox:		1.19.133
