Subscribe to e-news:

Network Video News

Enter your E-mail:


Other e-newsletter options

Search

Important Video Developer Information

Axis always strives to maintain backwards compatibility on API level, however there are circumstances where this policy must be broken, such as standards compliance, and to solve security issues. When such issues are identified, we will try to give developers reasonable time to implement changes so that applications do not break down. 

Make sure to check this page regularly! 


7. 2008-August-19

Support for VAPIX 1 removed
The HTTP API version 1 (VAPIX 1) is not supported in firmware 5.xx products. 
The 3 CGIs
getparam.cgi 
setparam.cgi 
audio/getparam.cgi
 
which were obsolete in version 2 are removed and should be replaced by param.cgi.

Examples 
To request information about network parameters:
OLD 
http://myserver/axis-cgi/admin/getparam.cgi?Network 
NEW 
http://myserver/axis-cgi/param.cgi?action=list&group=Network

To set the default image resolution to 320x240 pixels:
OLD 
http://myserver/axis-cgi/admin/setparam.cgi?Image.Resolution=320x240 
NEW 
http://myserver/axis-cgi/param.cgi?action=update &Image.I0.Resolution=320x240

To request information about audio parameters:
OLD 
http://myserver/axis-cgi/audio/getparam.cgi 
NEW 
http://myserver/axis-cgi/param.cgi?action=list&group=Audio 


6. 2007-September-24

In order to further strength the security of Axis video products and as a response to requests from the market, Axis decided to add support for HTTP Digest Authentication in most Axis video products. HTTP Digest Authentication is used for more secure authentication over both HTTP and RTSP. For more information please see RFC 2617

IMPORTANT: During the implementation of Digest Authentication, Axis discovered a security issue with the current implementation of RTSP that soon will be corrected. Currently, when a client is opening a connection over RTSP to an Axis video product that require authentication, the RTSP authentication is only made for one of the first requests. The following requests that should require authentication are accepted without checking any authentication data and this will soon be corrected. This correction may affect a client application if you have not implemented the ability to handle the authentication data, i.e. even if you are not enabling Digest Authentication.

IMPORTANT: Axis will also change the authentication realm and make it unique for each product. It will include the name AXIS, an underscore, and the product's serial number, for example, AXIS_00408C123456. For more information about the use of realms in authentication please see RFC 2617. Since the default realm has been changed from "/" to a longer name, you have to verify that your HTTP client can handle this.

Axis provides instructions together with four product test releases supporting Digest Authentication, to help you determine if your application is affected by this correction. All applications, also those without Digest Authentication support, should be verified, please read the instruction of how to do this.

Affected products: Most current Axis video products (exceptions are a few products with limited memory resources)
Affected firmware versions: Firmware version 4.47 and above.
Time frame: The first official firmware release that includes Digest Authentication support is planned to be release at the end of the year/beginning of next year. And Digest Authentication will thereafter be included in firmware version 4.47 and above.

Instructions
AXIS 210A, test release
AXIS 211A, test release
AXIS 214 PTZ, test release
AXIS 241Q, test release


5. 2006-August-18

Firmware 4.40 - MPEG-4 & format of the SDP

In firmware version 4.40, the SDP will contain a few changes affection applications using AMC SDK prior to release 3.30 as well as some applications that do their own SDP parsing.

Changes in FW v. 4.40 are as follows:

  1. A semi-colon was incorrectly added to the end of the 'fmtp' attribute. It has now been removed in accordance with RFC 3640 4.4.1. The changes was necessary to support wireless devices.

  2. The framerate attribute is changed from integer to decimal format, also to comply with cellular phones and handheld devices.

  3. Parameter names for the MIME-type audio/mpeg4-generic are now capitalized in accordance with RFC 3640 4.1.

  4. Introduction of a new URL:
    http://<servername>/mpeg4[/<camera>]/media3gp.sdp, to comply with handhelds that do not support RTSP DESCRIBE. The media3gp.sdp announces unicast instead of multicast.


4. 2006-March-10

AXIS PTZ Cameras:
With the launch of firmware version 4.40, the pan/tilt support in our PTZ cameras will be significantly improved. One example is the introduction of zoom compensated pan/tilt speed for continuous movements which will adjust the pan/tilt speed in relation to the current zoom level for better controllability. 

Although this will be a standard default with the launch of firmware 4.40 (available Q2), it is easily configurable, if you prefer an earlier setting.


3. 2005-July-12

The scale for the optical zoom will from firmware version 4.30 always be 0 to 9999, despite if digital zoom is supported or not. The digital zoom scale, if supported, will be from 10000 to 19999. This change can cause set preset positions to get an incorrect zoom and focus factor after the firmware upgrading. Please check the release notes for the specific 4.30 release where it will be stated if the preset position has to be manually adjusted after the upgrading.

The change is made due to requests from our Application Development Partners to get consistency for the optical zoom scale in all products. The 4.30 firmware is estimated to be launched Q3, 2005.


2. 2005-June-27

The HTTP API for setting server and device preset positions and to remove preset positions in Axis Pan Tilt Zoom enabled products will be changed due to security reasons. The following HTTP request with view access is today used for this:
http://myserver/axis-cgi/com/ptz.cgi
This will be changed to:
http://myserver/axis-cgi/com/ptzconfig.cgi
which has admin access rights.

Setting PTZ preset positions using ptzconfig.cgi will be introduced in firmware version 4.30 (estimated to be launched Q3, 2005), but both APIs will remain until firmware version 4.40 (estimated to be launched Q1-Q2, 2006), where the functionality to set PTZ preset positions using ptz.cgi will be removed.


1. 2005-June-27 

A new parameter; UserDataEnabled, will be introduced in the firmware releases higher than 4.20. This parameter will by default be set to no and will exclude the user data in the MPEG-4 GOV header that today is included by default. The user data contains product information, time stamps and optionally also trigger data. The ability to enable/disable this data makes it possible to support even more MPEG-4 players e.g. Real Player used in many 3G telephones. Real Player does not accept these kinds of data in the GOV header.

 


Axis specializes in professional network video and printing solutions

    Glossary  |  Contact  |  Sites  |  Privacy Statement