Revision History

· V1.1: add bit 15 for Time Zone Support

Foreword

AV Module is designed for transmission of AV data, it can be used on Set Top Box, IPTV, IP Camera, etc.

In the field of IP Camera Applications, we rolled out an client API which implements AV Module. This client API completely support devices which implements AV Module. Devices provides functions in a lot of aspect. To synchromize these devices and client , we formulate the “Service Type” to discriminate if a specific function is supported by device.

Instructions

“Service Type” is defined by AV Server. And it is passed by function avServerStart() on server side, avClientStart() on client side. Here is the definition of these functions.

int avServStart(int nIOTCSessionID, char *szViewAccount, char *szViewPassword, unsigned long nTimeout, unsigned long nServType, unsigned char nIOTCChannelID);

int avClientStart(int nIOTCSessionID, char *szViewAccount, char *szViewPassword, unsigned long nTimeout, unsigned long *pnServType, unsigned char nIOTCChannelID);

Duo to the definition of these two functions above, we will see these two functions passed information through an unsigned long variable. This variable “unsigned long” contains 4 bytes, equals 32 bits.

In the presentation of binary form:

「00000000 00000000 00000000 00000000」

We take every bit as a functional tag, so there are totally 32 functional tags.

When the value of a defined functional tag is 0, it means this function is valid. On the opposite side, value 1 means the function is invalid. For an example, the function “Audio In” is defined at the bit which index=0. If the value of this bit equals 0, it means the function “Audio In” is valid. One more example, Function “Pan/Tilt” is defined at the bit which index=2. If the value of the bit which index=2 is 1, it means this device do not support the function “Pan/Tilt”.

Function definition:

The definition of every bit is shown below:

Index	Function
0	Audio In, Device to Client
1	Audio Out, Client to Device
2	Pan / Tilt
3	Event list function
4	Playback function (required Event list function)
5	Wi-Fi setting function
6	Event setting function
7	Record setting function
8	Format SDCard function
9	Video flip function (Flip, Mirror, or both)
10	Environment mode (Indoor, Outdoor, Night mode)
11	Multi-streaming support
12	Audio out encoding format speex encoding: 0 ADPCM format: 1
13	Video Quality Setting Support
14	Device Info Support
15	Time Zone Support

Example:

Assume the Service Type of a device is defined as the table shown below:

Index	Function	Support or Not
0	Audio In, Device to Client	Yes
1	Audio Out, Client to Device	No
2	Pan / Tilt	No
3	Event list function	Yes
4	Playback function (required Event list function)	Yes
5	Wi-Fi setting function	Yes
6	Event setting function	No
7	Record setting function	Yes
8	Format SDCard function	Yes
9	Video flip function (Flip, Mirror, or both)	No
10	Environment mode (Indoor, Outdoor, Night mode)	No
11	Multi-streaming support	No
12	Audio Out Encoding Format	Speex
13	Video Quality Setting Support	Yes
14	Device Info Support	No
15	Time Zone Support	Yes

Translate the table above into binary presentation:

「0000-0000-0000-0000-0100-1110-0100-0110」

Then translate the binary presentation into decimal: “20038”.