AvigilonAPI

Avigilon Control Center (ACC) 7 or Avigilon Unity are a video management software that can be integrated in HSYCO with a TCP/IP connection. The current release of the I/O Server has been tested with the Avigilon Control Center WebEndpoint

note

This driver supports only a single connection with an Avigilon Control Server. If you have multiple Avigilon Control Servers it is mandatory to add more I/O servers to HSYCO, one for each Avigilon Control Server. Every I/O server must use a different IP address and TCP/IP port.

Communication

Here's an example of how to configure Avigilon Control Center using WebEndpoint to send an alarm status to HSYCO.

Download the Avigilon WebEndpoint executable from the Avigilon download page

Install the software

Creating an alarm in ACC

Create a new alarm in ACC

Select your camera as the trigger source

Select your camera as the linked device

Select the users that should be notified by ACC

Select the alarm acknowledgment action

Give the alarm a lowercase name

note

only use characters from the english alphabet, don't use spaces, the only special characters allowed are - _

Creating a Motion Detection in ACC

Setup a new motion detection under your camera

HSYCO Configuration

Add an AVIGILONAPI I/O Server in the I/O Servers section of the Settings and set its parameters:

Communication

• IP Address: IP address of the AVIGILON ACC 7 server.
• IP Port: TCP/IP port to use, leave blank to use default port 8443

High Availability

• Shutdown when inactive: defaults to false.

Options

• username: Username of the AVIGILON ACC 7 or AVIGILON UNITY client.
• password: Password of the AVIGILON ACC 7 or AVIGILON UNITY client.
• userkey: User api key Avigilon developer page.
• usernonce: User api nonce Avigilon developer page.
• pollingtime: Time in milliseconds that hsyco will wait before the next alarm check, leave blank or set it o 0 to use default polling time 300
• usessl: Tells the driver if the webendpoint uses SSL or not, leave blank for true

Datapoints

ID	Value	R/W	Description
connection	online	R	HSYCO connection socket is open
	offline	R	HSYCO cannot create the connection socket
<alarmName>.alarm	0	R	The alarm is off
	1	R	The alarm is on
<alarmName>.state	active, autoacknowledged, acknowledged	R	get an alarm state
<alarmName>.command	trigger	W	trigger an alarm on Avigilon ACC/Unity
<alarmName>.command	ack	W	ack an alarm on Avigilon ACC/Unity

States

Value	Description
active	This state indicates that the motion detection actually detected some movement
acknowledged	This state indicates that the camera operator acknowledged the alarm
autoacknowledged	This state indicates that motion detection has stopped detecting the movement

Example

In this example HSYCO is using the following format to turn on a light when the alarm goes off:

io avigilonapi.newalarm.alarm = 1 : io dummy.light.1 = 1

Where "avigilonapi" is the name of the driver given in HSYCO and "newalarm" is the name of the alarm given in ACC

Release Notes

3.8.0

• initial release

---

AVIGILON is a registered trademark of Avigilon Corporation