ACAP version 4.14 – May 3, 2024

Overview

The release contains:

• ACAP Computer Vision SDK 1.14
• ACAP Native SDK 1.14
• ACAP Runtime 1.3.1 (Release notes)
• Docker ACAP 3.0.0 (Release notes)
• Docker Compose ACAP 3.0.0 (Release notes)

Code examples:

• Code examples ACAP Computer Vision SDK v1.14 (Release notes)
• Code examples ACAP Native SDK v1.14 (Release notes)

Device software:

• Minimum AXIS OS version: 11.10

New features

• The following APIs have been added to the ACAP Native SDK:
  • Curl - An open-source library for transferring data with URLs.
  • Jansson - An open-source library for encoding, decoding and manipulating JSON data.
  • OpenSSL - An open-source library for general-purpose cryptography and secure communication.
• Manifest schema 1.7.0:

  • Make preparations on the host system so the application can run containers, and create symbolic links from various system-wide locations to Docker CLIs provided by the application.

    "acapPackageConf": {
        "configuration": {
            "containers": {
                "containerHost": true,
                "createDockerSymlinks": true
            }
        }
    }
    

  • Docker ACAP and Docker Compose ACAP are now rootless as part of the removal of root-privileged access initiative
  • The eap-install.sh script in the Native SDK now allows specifying the user. Find more details in the build, install, run documentation page.

Bug fixes

• A bug affecting ACAP applications that have specified multiple UDS sockets in their reverse proxy configuration, was causing traffic to get routed to the wrong internal socket from the application. It has been fixed in AXIS OS 11.10.

Limitations

• There is a limitation with Docker ACAP 3.0.0 and Docker compose ACAP 3.0.0
  • Only uid and gid are properly mapped between device and containers, not the secondary groups that the user is a member of. This means that resources on the device, even if they are volume or device mounted, can be inaccessible inside the container. This can also affect usage of unsupported D-Bus methods from the container. See Using host user secondary groups in container for information on how to handle this.

Upcoming changes

• Axis is planning to introduce signing of ACAP applications as default and remove root-privileged access in future AXIS OS releases. For reference see the announcement on Axis Developer Community about Removal of root-privileged access and ACAP application signing as default
• The next SDK release, 1.15 is going to be the last for the ACAP Computer Vision SDK on armv7hf. Support will continue for aarch64 devices.

APIs supported in this release

Axis API	Chip
Edge storage API	ARTPEC-8, ARTPEC-7, ARTPEC-6, CV25, i.MX 6SoloX, i.MX 6ULL, S5L, S5
Event API	ARTPEC-8, ARTPEC-7, ARTPEC-6, CV25, i.MX 6SoloX, i.MX 6ULL, S5L, S5
License Key API	ARTPEC-8, ARTPEC-7, ARTPEC-6, CV25, i.MX 6SoloX, i.MX 6ULL, S5L, S5
Machine learning API	ARTPEC-8, ARTPEC-7, CV25, S5L
Metadata Broker API	ARTPEC-8, ARTPEC-7, CV25
Overlay API	ARTPEC-8, ARTPEC-7, ARTPEC-6
Parameter API	ARTPEC-8, ARTPEC-7, ARTPEC-6, CV25, i.MX 6SoloX, i.MX 6ULL, S5L, S5
Serial port API	ARTPEC-8, ARTPEC-7
Video capture API	ARTPEC-8, ARTPEC-7, ARTPEC-6, CV25, S5L, S5

Open source API	Chip
Cairo	ARTPEC-8, ARTPEC-7, ARTPEC-6
Curl	ARTPEC-8, ARTPEC-7, ARTPEC-6, CV25, i.MX 6SoloX, i.MX 6ULL, S5L, S5
FastCGI	ARTPEC-8, ARTPEC-7, CV25, i.MX 6SoloX, i.MX 6ULL
Jansson	ARTPEC-8, ARTPEC-7, ARTPEC-6, CV25, i.MX 6SoloX, i.MX 6ULL, S5L, S5
OpenCL	ARTPEC-8, ARTPEC-7
OpenSSL	ARTPEC-8, ARTPEC-7, ARTPEC-6, CV25, i.MX 6SoloX, i.MX 6ULL, S5L, S5

Special API	Chip
VAPIX APIs	ARTPEC-8, ARTPEC-7, ARTPEC-6, CV25, i.MX 6SoloX, i.MX 6ULL, S5L, S5