©2023 Axis Communications AB. AXIS COMMUNICATIONS, AXIS, ARTPEC and VAPIX are registered trademarks of Axis AB in various jurisdictions. All other trademarks are the property of their respective owners.
This repository contains the source code to build a small ACAP version 3 application that exposes AXEvent compatible scenario events (alarm status) through OPC UA (open62541).
Note
Please note that even if this ACAP would fit right into your use case, its purpose is above all to serve as an example and boilerplate rather than being ready for production.
The ACAP application's backend can subscribe to the following ACAP applications:
The following examples assume that you have a SCADA (Supervisory Control And Data Acquisition) system or a PLC (Programmable Logic Controller) system with OPC UA as the communication protocol and you want to take advantage of the AXIS device capabilities to enrich or complement your operations.
With AXIS Fence Guard you can monitor objects/persons crossing a line (virtual fence) with a predefined direction and get an actionable event in your SCADA/PLC.
For example:
- get a SCADA alarm every time an object passes through a checkpoint, like on a conveyor belt system
- shutdown or start a PLC process if a person enters an area through a predefined and barred entry point, like approaching the hot side of an exhaust system
- count objects that move in opposite directions (incoming/outgoing) and graph their totals in a SCADA Screen
With AXIS Video Motion Detection or AXIS Motion Guard, you can monitor motion (or absence of motion) in a predefined area and and get an actionable event in your SCADA/PLC.
For example:
- get a SCADA alarm every time an object moves within a specific part of the area, like objects falling off the conveyor belt on the wrong side
- shutdown or start a PLC process if a person enters (or leaves) a predefined area, like a truck loading/unloading platform
- get a SCADA alarm if a machine with moving parts, like a conveyor belt or a motor, stops (or starts) working
- get a SCADA alarm if a monitored item starts (or stops) spewing liquid, like a liquid overflow outlet
- get a SCADA alarm if an object is swaying too much, like a tree close to a power line on a windy day
With AXIS Loitering Guard you can also monitor if a person has exceeded some predefined time being present in an area and thus, get an alarm in your SCADA/PLC.
Warning
Please note that any analytic process may produce false positives or negatives and the system designer has to account for those occurrences.
Requires any of the compatible video motion analytics ACAP applications referenced above, to be available on the device.
Create and enable a profile in the analytics ACAP (VMD 4 profile example). Then, install and configure the OPC UA VMD Events ACAP to pick up the chosen analytics ACAP events.
The exposed event profile names are of the following form: CameraXProfileY (i.e. Camera1Profile1, Camera1Profile2, etc.).
The special event CameraXProfileANY will always fire alongside any other profile event firing.
The OPC UA object view for a single analytics profile configured, looks like this:
The OPC UA Server port (default is 4840) can also be set through the ACAP's settings.
# With the environment initialized, use:
acap-build .The handling of this is integrated in the Makefile, so if you have Docker on your computer all you need to do is:
make dockerbuildor perhaps build in parallel:
make -j dockerbuildIf you do have Docker but no make on your system:
# 32-bit ARM
DOCKER_BUILDKIT=1 docker build --build-arg ARCH=armv7hf -o type=local,dest=. .
# 64-bit ARM
DOCKER_BUILDKIT=1 docker build --build-arg ARCH=aarch64 -o type=local,dest=. .