Axis P8221 User Manual
TECHNICAL NOTE
AXIS P8221 Network I/O Audio Module
Notification messages
How to integrate AXIS P8221
Updated: August 19, 2011
Rev: 1.1
TECHNICAL NOTE – Axis Communications Notification messages
TABLE OF CONTENTS
1 INTRODUCTION 3
1.1 HTTP and TCP 3
1.2 VAPIX® 3
1.3 Liability Disclaimer 3
2 EXAMPLES 4
2.1 Play an audio clip 4
2.1.1 Preparations 4
2.1.2 Set up an event server in AXIS Q7401 4
2.1.3 Set up a triggered event in AXIS Q7401 4
2.2 Go to PTZ preset position when a door is opened 6
2.2.1 Preparations 6
2.2.2 Set up an event server in AXIS P8221 6
2.2.3 Set up a triggered event in AXIS P8221 6
2.3 Activate an output port 8
2.3.1 Preparations 8
2.3.2 Set up an event server in AXIS P8221 8
2.3.3 Set up a triggered event in AXIS P8221 8
2.4 Switch video source 10
2.4.1 Preparations 10
2.4.2 Set up an event server in AXIS P8221 10
2.4.3 Set up a triggered event in AXIS P8221 10
3 MORE INFORMATION 12
Rev: 1.1, Last updated: 19/08/2011 2
TECHNICAL NOTE – Axis Communications Notification messages
1 Introduction
AXIS P8221 Network I/O Audio Module provides additional I/O ports and audio functionality to a
network video installation and is intended to be used in combination with Axis network cameras, video
encoders and video decoders.
Integrating AXIS P8221 with Axis network video products involves sending notification messages
between AXIS P8221 and the other products. Notification messages can be sent via HTTP or TCP and
contain instructions, for example, to steer a PTZ camera to a preset position when one of the AXIS
P8221 input ports is activated. The messages are constructed using commands and parameters
available from Axis HTTP-based application programming interface (API), VAPIX®.
This white paper gives some examples of how to set up and construct these notification messages. The
paper should be considered as introduction and is in no way a complete description of all notification
messages and other possibilities provided by VAPIX®.
1.1 HTTP and TCP
Most of Axis network video products support both HTTP and TCP notification messages. HTTP
messages are more secure as HTTP servers require a login name and password.
1.2 VAPIX®
VAPIX® is an HTTP-based application programming interface (API) available in Axis network video
products. VAPIX® provides functionality for requesting images, controlling network camera functions
(PTZ, I/O ports, etc) and setting and retrieving internal parameter values. The purpose of the API is to
make it easier for developers to build applications that support Axis network video products.
The VAPIX® specification is available on www.axis.com/developer
A VAPIX® command (request) follows the syntax
http://<ip>/axis-cgi/<path and name of cgi>?<arguments and values>
where <ip> is to be replaced by the product’s IP address.
Note:
Axis Customer Support does not provide assistance with VAPIX-related issues.
1.3 Liability Disclaimer
Axis Communications AB makes no warranty of any kind with regard to the material
contained within this document, including, but not limited to, the implied warranties of
merchantability and fitness for a particular purpose. Axis Communications AB shall not be
liable nor responsible for incidental or consequential damages in connection with the
furnishing, performance or use of this material.
Later versions of this document will be posted on the Axis website.
Rev: 1.1, Last updated: 19/08/2011 3
TECHNICAL NOTE – Axis Communications Notification messages
2 Examples
2.1 Play an audio clip
This example describes how to set up AXIS P8221 to play an audio clip when triggered by a signal
from another Axis network video product, in this case AXIS Q7401 Video Encoder.
The idea is to use AXIS P8221 as an HTTP event server and to send an HTTP notification
from AXIS Q7401 to AXIS P8221. The HTTP notification is a VAPIX command instructing
AXIS P8221 to play the audio clip.
2.1.1 Preparations
Before following this example, you should:
• Upload the audio clip to AXIS P8221
Refer to the online help or the AXIS P8221 User’s Manual.
2.1.2 Set up an event server in AXIS Q7401
1. Open the AXIS Q7401 Setup pages in a web browser.
2. Go to Setup > Events > Event Servers
3. Click Add HTTP
4. Enter a Name, for example AXIS P8221
5. In the URL field, enter
http://<IP>/axis-cgi/playclip.cgi
6. Enter the user name and password for AXIS P8221
7. Click OK
Figure 1. Setting up an event server in AXIS Q7401. Replace “IP” with the IP address of AXIS P8221.
2.1.3 Set up a triggered event in AXIS Q7401
1. Open the AXIS Q7401 Setup pages in a web browser
2. Go to Setup > Events > Event Types
3. Click Add triggered
4. Enter a Name, for example Play audio clip
5. Select a trigger from the Triggered by drop-down list. For testing purposes, use the
manual trigger.
6. Under When Triggered, select Send HTTP notification.
Rev: 1.1, Last updated: 19/08/2011 4
Loading...