View source for ICT Protege GX (IC-EDGE Integration)

{{E}}
==Introduction==
This article describes how you integrate ICT Protege GX and an IC-EDGE system to incorporate audio communication into Protege GX’s integrated access control and intruder detection system. 
==Prerequisites==

The following prerequisites are required:

*An operational Protege GX 4.3.285.21 or later system.
*An PRT-GX-SIP-10 license for Protege GX.
*A Zenitel device configured as [[Getting_Started_(IC-Edge)#Set_Edge_Controller|EDGE controller]] with one IC-EDGE Server-SIP-Client Extension [[Licensing_in_IC-EDGE|license]] per connected Protege GX SIP client.

==Integration Overview==
Communication between IC-EDGE and Protege GX is through SIP. Video from the Zenitel devices or an external IP camera is supported using RTSP.

<table style="max-width:80%; border-style: double; border-color: #c7c7c7;">
<tr style="rowspan:2;">
<td style="display: block; vertical-align: bottom;">[[Image:Protege GX1.JPG|600px]]</td>
</tr>
<tr>
<td style="background-color:#efefef;">System overview</td>
</tr>
</table>
<br clear="all" />

The following instructions outline the steps required to configure the integration:

*Configure the Zenitel IC-EDGE controller
*Programming the Camera
*Programming the Workstation
*Associating Zenitel devices with doors
*Creating a Floor Plan
*Testing the Integration

==Configure the Zenitel IC-EDGE controller==
Before proceeding with the integration, you will first need to gather information as described below.

1. Using a web browser, connect to the IC-EDGE controller to open the configuration page and log into the system.

[[Image:Protege GX2.JPG|left|600px]]
<br clear="all" /> 

2. Click the Edge Controller tab. Take note of the following information associated with the:

*Number
*Name
*IP Address

3. Click on System Configuration.

4. In the Manually Added Devices section, hover the mouse cursor on the + symbol and click 3rd Party SIP.

5. Make the following configuration settings:

*Number: Define a number for connecting to the Protege GX SIP client.
*Name: Define a name for the Protege GX SIP client.
*SIP Password: Leave blank
*Profile: Set the profile to “Default”.
*Click Save

When finished the configuration should look something like this:

[[Image:Protege GX3.jpg|left|600px]]
<br clear="all" />

==Configure ICT Protege GX==


===Programming the camera===
If the Zenitel intercom device is a video device, or if you’d like to use an external IP camera, create a camera for the intercom in Protege GX as follows:

1. In Protege GX, navigate to Monitoring | Setup | Cameras.

2. Click Add to create a new camera.

3. Define a Name for the camera.

4. Set the Type to “H.264 & Motion JPEG Stream Camera”.

5. Set the URL to the address of the camera stream. You may need to refer to the device’s documentation to determine the proper URL.

6. Click Save.
[[Image:Protege GX4.JPG|left|600px]]
<br clear="all" /> 

===Programming Zenitel intercom devices in Protege GX===

1. Navigate to Monitoring | Setup | Intercoms.

2. Click Add to create a new intercom.

3. Define a Name for the intercom. Consider matching the Name of the Intercoms in the EDGE 

4. In the URI field, enter the address necessary to establish a connection to the Zenitel intercom device. This address should be in the form of Number@IP_Address. For example, if the intercom’s number is 101 and its IP address is 192.168.1.125, define the URI as 101@192.168.1.125.

5. If you created a Camera for this intercom device, use the drop down to select the camera you created in step 3 of “Programming the Camera”.

6. Click Save.

[[Image:Protege GX5.JPG|left|600px]]
<br clear="all" /> 

===Programming the Protege GX Workstation===

1. Navigate to Events | Workstations.

2. Click Add to create a new Workstation.

3. Set the Name for the workstation to match the username given to the 3rd Party SIP Device user being used for this integration.

4. Set the Computer Name to the hostname of this PC.

5. Set the Server Address to the IP address of the IC-EDGE controller.

6. Set the Account Name to the Directory Number given to the 3rd Party SIP Device user being used for this integration. 

7. Leave the Password blank

8. Set the SIP Port to match the port used by the Zenitel intercom device (typically 5060).

9. Choose the Microphone from the drop-down list of available microphones on this PC.

10. Choose the Speakers from the drop-down list of available speakers on this PC.

11. Click Save.

[[Image:Protege GX6.JPG|left|600px]]
<br clear="all" /> 

===Associating Zenitel intercom devices with a Door===

1. Navigate to Programming | Doors.

2. Select a door.

3. Set Intercom (Entry) to the name of the Zenitel intercom device you programmed.

4. Click Save.
[[Image:Protege GX7.JPG|left|600px]]
<br clear="all" /> 

===Creating a Floor Plan===

1. Navigate to Monitoring | Setup | Floor Plan Editor.

2. Click Add to create a new floor plan.

3. Define a Name for the floor plan.

4. Click OK.

5. Expand the Devices section in the right-hand panel of the floor plan.

6. Click the Add button to add a device.

7. In the resulting Door list, highlight the door you associated with the intercom and drag-and-drop this door into the floor plan.

8. Click Close to close the Door list.

9. Click Save


==Testing the Integration==

1. Verify the new SIP client has successfully been registered with the SIP server by clicking on the telephone icon in the lower left corner of the Protege GX client. You should see a “Registered with Server” message such as the one shown below.

[[Image:Protege GX8.JPG|left|300px]]
<br clear="all" />

2. In the floor plan, right-click on the door you associated with the intercom device and then click the Call Intercom button from the resulting dialog.

[[Image:Protege GX9.JPG|left|300px]]
<br clear="all" />

3. Verify you can successfully communicate with the intercom device. Also, if you have associated a camera, verify you can successfully view its live video.

[[Image:Protege GX10.JPG|left|300px]]
<br clear="all" />

4. Click the Unlock Door button and verify the door associated with the intercom device unlocks.

5. Close the intercom dialog.

6. On the Zenitel intercom device, press the Call button to initiate a call to  Protege GX

7. In Protege GX, verify an Intercom Call dialog appears on the screen.

[[Image:Protege GX11.JPG|left|200px]]
<br clear="all" />

8. Click the Accept button.

9. Verify you can successfully communicate with the intercom device. Also, if you have associated a camera, verify you can successfully view its live video.

10. Click the Unlock Door button and verify the door associated with the intercom unlocks

==Related articles==

*[[Getting Started (IC-Edge)]]
*[[Licensing in IC-EDGE]]
*[[Configure 3rd party SIP devices (Edge)]]

[[Category:3rd party integration]]
[[Category:IC-EDGE Integrations]]