Difference between revisions of "AvigilonWEB"
| (5 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | Avigilon Control Center (ACC) 7 | + | Avigilon Control Center (ACC) 7 and Avigilon Unity (ACC 8) are video management softwares 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 | The current release of the I/O Server has been tested with the Avigilon Control Center WebEndpoint | ||
| Line 54: | Line 54: | ||
=== Communication === | === Communication === | ||
| − | *'''IP Address''': IP address of the AVIGILON ACC 7 server. | + | *'''IP Address''': IP address of the AVIGILON ACC 7 or AVIGILON UNITY server. |
*'''IP Port''': TCP/IP port to use, leave blank to use default port 8443 | *'''IP Port''': TCP/IP port to use, leave blank to use default port 8443 | ||
| Line 61: | Line 61: | ||
=== Options === | === Options === | ||
| − | *'''username''': Username of the AVIGILON ACC 7 client. | + | *'''username''': Username of the AVIGILON ACC 7 or AVIGILON UNITY client. |
| − | *'''password''': Password of the AVIGILON ACC 7 client. | + | *'''password''': Password of the AVIGILON ACC 7 or AVIGILON UNITY client. |
*'''userkey''': User api key [https://support.avigilon.com/s/technology-partners Avigilon developer page]. | *'''userkey''': User api key [https://support.avigilon.com/s/technology-partners Avigilon developer page]. | ||
*'''usernonce''': User api nonce [https://support.avigilon.com/s/technology-partners Avigilon developer page]. | *'''usernonce''': User api nonce [https://support.avigilon.com/s/technology-partners 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 | *'''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 == | == Datapoints == | ||
| Line 86: | Line 87: | ||
|- | |- | ||
| − | |rowspan="2" |alarm | + | |rowspan="2" |<alarmName>.alarm |
|0 | |0 | ||
|R | |R | ||
| Line 95: | Line 96: | ||
|The alarm is on | |The alarm is on | ||
|- | |- | ||
| − | |state | + | |<alarmName>.state |
|active, autoacknowledged, acknowledged | |active, autoacknowledged, acknowledged | ||
|R | |R | ||
|get an alarm state | |get an alarm state | ||
| + | |- | ||
| + | |<alarmName>.command | ||
| + | |trigger | ||
| + | |W | ||
| + | |triggers an alarm | ||
| + | |- | ||
| + | |<alarmName>.command | ||
| + | |ack | ||
| + | |W | ||
| + | |acks an alarm | ||
|- | |- | ||
|} | |} | ||
Latest revision as of 09:24, 20 December 2023
Avigilon Control Center (ACC) 7 and Avigilon Unity (ACC 8) are video management softwares 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
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.
Contents
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
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 or AVIGILON UNITY 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 | triggers an alarm |
| <alarmName>.command | ack | W | acks an alarm |
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
