Crestron TPMC IP Intercom Demo v5_0_7 Release Notes
============================================

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 TPS and TPMC touch panels.  
There are 9 touch panels and a Door Station programmed in this example. 

Line level audio routing is handled with an Intercom Audio Distribution System (IADS).  
A Barix Audio Interface is used in this program to manage the distribution of line level audio from the IADS over Ethernet.

Video routing is handled with an Intercom Video Distribution System (IVDS).
A NVS-100 Video streaming device is used in this program to manage the distribution of video from the IVDS/Video source over Ethernet.

Features
========
- Intercom interaction over Ethernet TPS and TPMC touch panels.
- Line level audio routing managed by the Intercom Audio Distribution System
- Audio over Ethernet managed by the Barix Interface
- Door Station interaction
- Both wired and streaming Video managed by the Intercom Video Distribution System.
- Video over Ethernet managed by the NVS-100 video streaming device.
- 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 and TPS 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-4SM 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.
- This program is designed to work with TPMC 8X panels either consistently using wireless or consistently using wired Ethernet addresses. 
 

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
=====================
Barix Configurations
---------------------------
Location 8 Barix#1 Audio Out to IADS Audio In 23 
Location 8 Barix#1 Audio In to IADS Audio Out 23

Location 9 Barix#2 Audio Out to IADS Audio In 30 
Location 9 Barix#2 Audio In to IADS Audio Out 24

Location 10 Barix#3 Audio Out to IADS Audio In 25 
Location 10 Barix#3 Audio In to IADS Audio Out 20

Location 11 Barix#4 Audio Out to IADS Audio In 26 
Location 11 Barix#4 Audio In to IADS Audio Out 21

Location 12 Barix#5 Audio Out to IADS Audio In 27 
Location 12 Barix#5 Audio In to IADS Audio Out 22

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

TPS-12 Configurations
-----------------------------
Connect Location 1 TPS-12 Audio I/O to IADS Remote Audio In/Out 1
Connect Location 2 TPS-12 Audio I/O to IADS Remote Audio In/Out 2

Connect Location 1 TPS-12 Video Input to IVDS Remote Video Out 1
Connect Location 2 TPS-12 Video Input to IVDS Remote Video Out 2

TPS-6L Configuration
-----------------------------
Connect Location 3 TPS-6L Audio I/O to IADS Remote Audio In/Out 3
Connect Location 3 TPS-6L Video Input to IVDS Remote Audio In/Out 3

See the Installation and Operations Manuals for the TPS-6L and C2N-IADS30x24 located on Crestron’s web site for pinout information 
To hear line level audio on the TPS-6L, an external speaker available for the TPS-6L must be connected.

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.

DoorBell -  C2N-IIF Unit
--------------------------------
Connect the Interrupt Location C2N-IIF unit to IADS Remote Audio In/Out 8

Default values for wav volume are also set in the program. For TPS and 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
=============
Set the Barix IP Address in the SIMPL Configure View for the TCI/IP Client.  
Also, in the SIMPL Programming View set the IP address on the corresponding Barix GUI Interface module located within subsystem S-6.1.

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 20	- TPS-12 Touch panel - Location 1
IP ID 21	- TPS-12 Touch panel - Location 2
IP ID 22	- TPS-6L Touch panel - Location 3
IP ID 23	- TPMC-12 Touch panel - Location 4
IP ID 24	- TPMC-12 Touch panel - Location 5
IP ID 25	- DGE-1 Touch panel - Location 6
IP ID 26	- DGE-1 Touch panel - Location 7

IP ID 29	- TPMC-8X Touch panel - Location 8
IP ID 2A	- TCP/IP Client (Interface to the Barix) - Barix for Location 8

IP ID 2B	- TPMC-8X Touch panel - Location 9
IP ID 2C	- TCP/IP Client (Interface to the Barix) - Barix for Location 9

IP ID 2D	- TPMC-8L Touch panel - Location 10
IP ID 2E	- TCP/IP Client (Interface to the Barix) - Barix for Location 10

IP ID 2F	- TPMC-3X Touch panel - Location 11
IP ID 30	- TCP/IP Client (Interface to the Barix) - Barix for Location 11

IP ID 31	- TPMC-4SM Touch panel - Location 12
IP ID 32	- TCP/IP Client (Interface to the Barix) - Barix for Location 12

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.

Cresnet Devices
---------------
ID 03 - C2N-IVDS24X24
ID 04 - C2N-IADS30X24
ID 05 - C2N-IIF - Doorbell/Interrupt Location


The physical INPUT/OUTPUT connections to the IADS are as follows:
Location 1	- IADS In 1/IADS Out 1
Location 2	- IADS In 2/IADS Out 2
Location 3	- IADS In 2/IADS Out 3
Location 4	- IADS In 2/IADS Out 4
Location 5	- IADS In 2/IADS Out 5
Location 6	- IADS In 2/IADS Out 6
Location 7	- IADS In 2/IADS Out 7
Location 8	- Uses Barix#1 (IADS In 23/IADS Out 23)
Location 9	- Uses Barix#2 (IADS In 30/IADS Out 24)
Location 10 - Uses Barix#3 (IADS In 25/IADS Out 20)
Location 11 - Uses Barix#3 (IADS In 26/IADS Out 21)
Location 12 - Uses Barix#3 (IADS In 27/IADS Out 22)
Interrupt Location (C2N-IIF) - IADS In 8/IADS Out 8


The physical INPUT/OUTPUT connections to the IVDS are as follows:
Location 1	- IVDS In 1/IVDS Out 1
Location 2	- IVDS In 2/IVDS Out 2
Location 3	- IVDS In 3/IVDS Out 3
Location 4	- IVDS In 4/IVDS Out 4
Location 5	- IVDS In 5/IVDS Out 5
Location 6	- IVDS In 6/IVDS Out 23
Location 7	- IVDS In 7/IVDS Out 24
Location 8	- Uses CEN-NVS100#1 (IVDS Out 18)
Location 9	- Uses CEN-NVS100#2 (IVDS Out 19)
Location 10 - Uses CEN-NVS100#3 (IVDS Out 20)
Location 11 - Uses CEN-NVS100#4 (IVDS Out 21)
Location 12 - Uses CEN-NVS100#1 (IVDS Out 22)
Interrupt Location (C2N-IIF) - IVDS In 8

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