parkit programmers manual

/58

ParkIT Programmers Manual


For versions from 1.12.0.8

Document version: 12.09.19

Table of Contents

Introduction .................................................................................................................................................................................................................................... 4 The Camera Software ................................................................................................................................................................................................................... 4 The Camera Modules.................................................................................................................................................................................................................... 5 General Communication Interface .......................................................................................................................................................................................... 7

Setting Parameter Values ..................................................................................................................................................................................................... 7 Retrieving Parameter Values ............................................................................................................................................................................................... 7 Retrieving Parameter Ranges ............................................................................................................................................................................................. 8

Image Capturing Interface ......................................................................................................................................................................................................... 9 1. Introduction ......................................................................................................................................................................................................................... 9 2. Image Sensor .....................................................................................................................................................................................................................10 3. Frame Limiter.....................................................................................................................................................................................................................11 4. Flash Driver.........................................................................................................................................................................................................................11 5. De-Bayer ..............................................................................................................................................................................................................................12 6. Color Correction................................................................................................................................................................................................................12 7. Gamma Correction...........................................................................................................................................................................................................13 8. Mirroring and Rotation...................................................................................................................................................................................................14 9. Image Compressor...........................................................................................................................................................................................................14 10. Motion Detector.............................................................................................................................................................................................................15 11. Analyzer.............................................................................................................................................................................................................................17 12. Frame Buffers...................................................................................................................................................................................................................17 12.1 Getting Images from the Frame Buffer ................................................................................................................................................................18 13. Properties .........................................................................................................................................................................................................................19

System Hardware Date and Time ...........................................................................................................................................................................................21 1. Introduction .......................................................................................................................................................................................................................21 2. Retrieving Time Parameters ..........................................................................................................................................................................................21

Automatic Zoom Control ..........................................................................................................................................................................................................23 1. Manual Method.................................................................................................................................................................................................................23 2. Automatic Method...........................................................................................................................................................................................................23 3. Parameter Sets...................................................................................................................................................................................................................25 4. Errors.....................................................................................................................................................................................................................................25

Automatic Focus Control ..........................................................................................................................................................................................................26 1. Manual Method.................................................................................................................................................................................................................26 2. Autofocus............................................................................................................................................................................................................................26 3. Brightness and Autofocus .............................................................................................................................................................................................26 4. Parameters..........................................................................................................................................................................................................................27 5. Errors.....................................................................................................................................................................................................................................27

Automatic Brightness Control.................................................................................................................................................................................................28 1. Manual Mode.....................................................................................................................................................................................................................28 2. BrightNow!..........................................................................................................................................................................................................................28 3. Automatic Mode...............................................................................................................................................................................................................28 4. Module Parameters..........................................................................................................................................................................................................29 5. Operation of Strategies ..................................................................................................................................................................................................30 6. Errors.....................................................................................................................................................................................................................................30

Illuminator Configuration Manager ......................................................................................................................................................................................30 Scheduler Trigger.........................................................................................................................................................................................................................31

1. Introduction .......................................................................................................................................................................................................................31 2. Basic Parameters...............................................................................................................................................................................................................31 3. Level and Edge Control ..................................................................................................................................................................................................32 4. Errors.....................................................................................................................................................................................................................................32

Page 2/58 ParkIT Programmers Manual

Upload Manager ..........................................................................................................................................................................................................................33 1. Introduction .......................................................................................................................................................................................................................33 2. Parameters..........................................................................................................................................................................................................................33 3. Processing Logging Data ...............................................................................................................................................................................................35 4. Errors.....................................................................................................................................................................................................................................35

Event Manager..............................................................................................................................................................................................................................36 1. Short Description .............................................................................................................................................................................................................36 2. Detailed Description .......................................................................................................................................................................................................36 3. Commands and Parameters..........................................................................................................................................................................................37

Software Trigger...........................................................................................................................................................................................................................39 1. Short Description .............................................................................................................................................................................................................39 2. Detailed Description .......................................................................................................................................................................................................39 3. Parameters..........................................................................................................................................................................................................................39

GPIO Trigger ..................................................................................................................................................................................................................................40 1. Short Description .............................................................................................................................................................................................................40 2. Detailed Description .......................................................................................................................................................................................................40 3. Parameters..........................................................................................................................................................................................................................40

UART Trigger..................................................................................................................................................................................................................................41 1. Short Description .............................................................................................................................................................................................................41 2. Detailed Description .......................................................................................................................................................................................................41 3. Parameters..........................................................................................................................................................................................................................41

Interface to Camera Peripherals .............................................................................................................................................................................................42 1. Short Description .............................................................................................................................................................................................................42 2. Detailed Description .......................................................................................................................................................................................................42 3. Parameters..........................................................................................................................................................................................................................43

Logging...........................................................................................................................................................................................................................................45 1. Short Description .............................................................................................................................................................................................................45 2. Filtering Log Records.......................................................................................................................................................................................................45

Backup System .............................................................................................................................................................................................................................46 1. Short Description .............................................................................................................................................................................................................46 2. Module Parameters..........................................................................................................................................................................................................46

System Update .............................................................................................................................................................................................................................47 1. Short Description .............................................................................................................................................................................................................47 2. Uploading Backup File....................................................................................................................................................................................................47

ARHIP - PC API Description.......................................................................................................................................................................................................48 Module Initialization and Closure ...................................................................................................................................................................................48 Functions of Communication (query/answer) ............................................................................................................................................................48 Handling of Data Streams ..................................................................................................................................................................................................49 Creating Backup File with ARHIP PCAPI ........................................................................................................................................................................53 Uploading Backup File (Update) with ARHIP PCAPI..................................................................................................................................................54 Getting Images from the Scapture Module .................................................................................................................................................................55

Contact Information ...................................................................................................................................................................................................................58


Introduction Welcome to the Programmer's Manual of the ParkIT series cameras. This document is intended to provide you a complete understanding on the wide range of possibilities of integrating your ParkIT into your system. The ParkIT series of cameras are specially developed and optimized for license plate reading (ANPR) applications while offering a great deal of flexibility to suit your special needs. The two main capabilities of the ParkIT camera are capturing images optimized for ANPR and forwarding them via a selected protocol to your application. The special hardware features, such as for example the built-in high power pulsed-infra LED illumination, or the extended I/O capabilities backed up with software developed with device integration in mind, such as the built-in hardware motion detector, ensure that the unit should fit into your system quickly and easy. The camera is equipped with a DSP-based intelligent processing core and with large internal memory for image buffering. This core is hosting a Linux operating system and an intuitive web based control interface. Image processing in the camera is divided among modules: each module is responsible for a specific task. The camera can be configured and used by communicating with these modules.

The Camera Software The core of the camera software consists of modules that are responsible for handling different features of the device. (e.g. zooming is executed by the hwlayer/zoomcontrol module while trigger events are handled by the trigger/eventman module). Every module has a name and a group e.g. setup/network where setup is the group and network is the name and is responsible for setting up network connections of the camera. All features and functions of the camera are accessible by users through the camera software to an extent determined by their privileges.


The Camera Modules Every module of the camera is responsible for certain task(s) and has unique commands and functions. MODULE CATEGORIES, module groups and module names: [modulegroup/modulename] description:

MONITORING __________________________________________________________________________________ STAT [stat/memory] Memory Statistics [stat/listmodules] Module List LOGGING [logging/logstream] Device Log Streamer

SETTING ______________________________________________________________________________________ HWLAYER [hwlayer/cphw] CP Hardware Interface [hwlayer/cperiph] Camera Peripherals SETUP [setup/profiles] Profile Manager [setup/users] Set Users and Groups [setup/network] Network Setup [setup/exit] Shutdown/Restart Manager [setup/hwmotdet] Hardware Motion Detection Parameter Manager [setup/time] System/Hardware Date and Time [setup/imagepar] Image Parameter Manager FILE [file/reader] HTML Template Parser CONFIG [config/ledcfg] Illuminator Configuration Manager [config/cfgman] Configuration Manager

IMAGE ________________________________________________________________________________________ SCAPTURE [scapture/default] Image Capture Interface MCAPTURE [mcapture/default] Image Stream Interface CONTROL [control/focuscontrol] Automatic Focus Control [control/zoomcontrol] Automatic Zoom Control [control/brightnesscontrol] Automatic Brightness Control

TRIGGER-UPLOAD ______________________________________________________________________________ TRIGGER [trigger/eventman] Event Manager [trigger/swtrigger] Software Trigger [trigger/uarttrigger] UART Trigger [trigger/gpiotrigger] GPIO Trigger [trigger/scheduler] Scheduler Trigger UPLOAD [upload/uploadman] Upload Manager

UPDATE-MAINTENANCE _________________________________________________________________________ UPDATE [update/default] System Update BACKUP [backup/default] Backup System


Modules in bold text can be accessed and managed with camera commands as described in the following chapters. Other modules are intended for internal usage.

To communicate with these modules, three methods are available: Through the web interface of the ParkIT camera by submitting the forms on the pages. For more information

see ParkIT Users Manual.

As HTTP requests e.g. in browsers address bar according to syntaxes detailed below.

Through the PC API (for the C programming language) of the ParkIT camera (see PC API Description). The WEB interface is recommended for users, as it is very easy to use while the other methods are intended for programmers (C, C++ and HTML.) NOTE: For application development purposes, Mozilla Firefox is strongly recommended.

In the following sections of this manual, the ParkIT camera modules and the ParkIT PC API are described.


General Communication Interface You can set up and monitor the camera by using parameters. Parameters are composed of a name and a value. The value of a parameter has a type (int, string, etc.) and validity limits. Each of the modules listed in the previous chapter has a parameter list, which consists of the parameters that the given module accepts. In this chapter, we will deal with the issue of getting, setting and retrieving these parameter lists and ranges. Parameters can be read only (RO), in this case only a get operation is allowed on them, or read/write (RW), in which case both a get and a set operation is allowed. There are certain special parameters (for example commands), which are by nature write only (WO).

Setting Parameter Values Syntax: http://[camera ip]/[module group]/[module name]?[parameter name 1]=[parameter value 1]&[parameter name 2]=[parameter value 2]&... Example:

Query: http://192.0.2.3/control/zoomcontrol?zoom=32

Answer:

multipart=1 mimetype=text/html estr= eparams= zoom=32

NOTES:

1) You can set multiple properties in one query. 2) In the answer, the module may include more properties, other than those queried (see the documentation

of the modules below). 3) In general, the answer will contain the previous value of the parameter in the answer. To make sure that

the parameter value is accepted and set, query it with the get command.

Retrieving Parameter Values Syntax: http://[camera ip]/[module group]/[module name]?get[parameter name 1]&get[parameter name 2]&... Example:

Query: http://192.0.2.125/control/zoomcontrol?getzoom

Answer:

multipart=1 mimetype=text/html estr= eparams= zoom=32


Special parameters

multipart=1 Both image and image data are transferred (multipart=0: image only) ajaxcall=1 Query/set data are displayed on the web interface (ajaxcall=0: can be save as file) cameraapi=1 Substitutes the multipart=1 parameter when communicating with the [setup/time]

module.

Retrieving Parameter Ranges All modules (except scapture/default, which because its large number of parameters uses a different syntax, see its documentation below) return the validity range using the following syntax: http://[camera ip]/[module group]/[module name]?query[parameter name 1]&query[parameter name 2]&... Example:

Query: http://192.0.2.125/trigger/gpiotrigger?querysamplerate_hz&queryinvert

Answer:

listsamplerate_hz=1,2,5,10,20,50,100,200,500,1000,2000,5000,10000 listinvert=0,1 mimetype=text/plain multipart=1

Answers come in two types list and bound.

Syntaxes: list[parameter name]=[valid value1],[valid value2],... bound[parameter name]=[minimum value], [maximum value], [default value, or -1 if not applicable]


Image Capturing Interface [scapture/default]

1. Introduction The scapture/default module is responsible for the basic image capturing tasks detailed below. With the help of the module, it is possible to get camera images (in JPEG format) and to set and get image capturing parameters. Images returned by the camera have a parameter list attached. In this list, each value is listed twice: with and without the 'img' prefix. The parameter value with the 'img' prefix represents the value of the parameter at the time the image was captured, while the one without it represents the actual value. Steps of Image Processing:

Image Processing Pipeline


2. Image Sensor Camera images are captured by the image sensor. This sensor can be color or B&W as described in the scolor (0=B&W, 1=color) property. Pixels are captured with 12-bit depth. The image sensor also has attributes describing the number of vertical and horizontal pixels (described in the xsize and ysize parameters). Image sensors include a boost circuit to increase the brightness of the camera image. The extent of this boost can be adjusted through the gain parameter. Note that the higher the gain value is, the noisier the images will be. To make the camera image brighter, the exposure time can also be used. This time defines the length of time during which the sensor is collecting light. It can be set in microseconds through the shutter parameter. The longer the image sensor collects light, the brighter the camera image will be. In case of high shutter values, motion blur effect may occur in case of rapid motions. The image capturing frequency of the sensor is defined in FPS (describing the number of captured Frames Per Seconds) and can be adjusted by the ifps parameter. The actual number of processed images can be adjusted with the Frame Limiter (see below). The following parameters depend on the type of the camera image sensor:

Parameters of the Camera Image Sensor

imgsize RO The size of the image in bytes (read only).

If the amount of data exceeds this value then there it is extra data included (e.g. histogram information, etc.). In the sent data package, always the

image comes first and then comes the extra data.

imgxsize RO X (width) size of the image in pixels imgysize RO Y (height) size of the image in pixels

ifps RO

Querying the frame capturing speed of the sensor (read-only). This value depends on the camera sensor according to the followings:

752x480: 0, 60.0 = 60Hz (default), 50.0 = 50Hz 1280x960: 0, 22.5 = 22.5Hz (default), 11.25 = 11.25Hz 1600x1200: 0, 8.5 = 8.5Hz (default), 4.25 = 4.25Hz

(Flashing effect on the camera image caused by interference with camera environment light sources can be avoided by this option).

imgifps RO actual ifps value influenced by iskipframes (see below)

imgscolor RO Camera sensor color information.

0 = B&W sensor 1= Color sensor

gain RW

Gain value for image capturing. In case of sensors:

752x480: it is represented in percentage (1.0 = 100%) 1280x960 and 1600x1200: it is represented in decibels

NOTE: Adjusting gain is strongly recommended through the brightness control module.

imggain RO used gain value when the image was captured

shutter RW value of shutter in s (fractions can also be provided)

NOTE: Adjusting shutter is strongly recommended through the brightness control module.

imgshutter RO used shutter value when the image was captured


/58 ParkIT Programmers Manual

3. Frame Limiter In many cases, the speed with which the sensor captures images is too quick for image processing or it is unnecessary to operate the system at full speed (e.g. in case of parking facilities, 10 FPS is satisfactory). In these cases, the number of captured frames should be limited with the frame filter module that is capable of dropping frames from the incoming stream of from the sensor. When adjusting the number of dropped frames, it must be specified that after processing an image, how many should the module drop (ignore). The number of dropped images may vary between 0 and 15. If 0 is set, all images are forwarded (0 is dropped) while if 15 is set, the system drops 15 images after every processed one. The number of skipped frames can be set by the iskipframes property. E.g. iskipframes=3: Before limiter 1 2 3 4 5 6 7 8 9 After limiter 1 X X X 2 X X X 3 In the first row, the incoming frame indexes are enlisted, while in the second row, indexes of forwarded images are marked with green, indexes of dropped (ignored) images are marked with red.

Parameters of Frame Management

iskipframes RO

Number of frames skipped at capturing.

0 = no skipping 1 = every second is processed 2 = every third is processed

max. 15 = every fifteenth is processed)

The ifps and iskipframes parameters refer to data received from the sensor. The two parameters together define the number of frames downloaded from the camera.

imgiskipframes RO Used iskipframes value when the image was captured.

imgframetimems RW Time of frame capturing in msecs (system time). Updating system time changes this parameter.

imgframemonotimems RW Time of frame capturing according to a clock counting monotonically starting from the timestamp at camera startup, thus unaffected by time synchronization effects and manual time setting to ensure the order of images in time.*

imgframeindex RW Frame index of the image stored in 32 bit. It may overflow.

4. Flash Driver The flash module works with images filtered by the frame limiter. The flash control can be set to flash differently on images with odd/even frame index with the help of the flashmode property. (If the camera uses visible light for illumination, disturbing flashing (stroboscopic) effect may occur. To avoid this phenomenon, the flash1persec property can be used that defines the minimal number of flashes in one second. If there is no such phenomenon, then set this parameter to 0 to flash only at image capturing.)

* Timestamp in ms-s counted from the Unix epoch 1970.01.01 0:00:00.00 +0000 UTC

Parameters of Flashing

flashmode* RW

NOTE: Setting the flash mode is strongly recommended through the camera web interface: Setup/Advanced Setup/Flash Control. The camera can be set up to flash the illuminator on even/odd frames. Adjust flashing mode according to the followings: (0=turned off, one of the bits is 1 then turned on 0xF to make all of them available).

1. bit set to 1: emitting strobe signal to the illuminator on odd frames 3. bit set to 1: emitting strobe signal to the illuminator on even frames 4. bit: set to 0= even/odd frame differentiation is disabled

set to 1= even/odd frame differentiation is enabled E.g. to flash all light sources continuously: enable the 1. and the 3. bits: 10102=1010

flash1delay* RW Delay of flashing on the built-in illuminator in milliseconds. This value can be negative as well. NOTE: This value is factory preset. Do not alter.

flash1persec* RW Minimal number of flashes in one second on the built-in illuminator. It always

flashes once on a strobe signal. By this parameter, the number of flashes on the illuminator in one second can be defined (it is divided equally). If it is 0 then only

one flash will occur on a strobe signal.

5. De-Bayer This option is available only at color cameras. Most color sensors send images according to the so-called Bayer Pattern. The task of the De-Bayer module is to convert the pixels to the RGB color space. (During the conversion and further image processing tasks, calculating accuracy needed by the incoming 12bit accurate data exceeds the 24bit accuracy. To achieve better image quality, the algorithm uses weighted average calculation).

6. Color Correction Pixels, converted to RGB are exposed to further image processing which includes the following procedures:

white balance contrast saturation

With the help of the whitebalance parameter, the gain of the individual color channels can be adjusted: the red, green and blue components can be enhanced (moved to positive direction) and reduced (moved to negative direction). As a result of such adjustments, shade of the image color can be altered. With the help of the contrast and saturation parameters, the corresponding values can be adjusted. The adjustment can be negative (minimum -1.0) or positive (maximum +1.0). In case of 0, no modification is executed. A further task of the color correction module is to convert the pixels from RGB to the YUV color space. This color space is appropriate for JPEG and H264 compressions and is suitable for the motion detector. *These parameters cannot be adjusted in case of 1.3MP ParkIT camera models.


Parameters of Color Correction

saturation RW Adjusting saturation (between -1.0 and +1.0) This parameter is available only at color cameras. imgsaturation RO used saturation value when the image was captured

contrast RW contrast value (between -1.0 and +1.0) imgcontrast RO used contrast value when the image was captured

whitebalance RW values of white balance between -1.0 and +1.0 (R, G, B) e.g. whitebalance=0.0,0.1,0.8 imgwhitebalance RO used white balance values when the image was captured

7. Gamma Correction The gamma correction enables to enhance dark pixels differently from bright ones. This kind of modification helps to render the details of dark image sections (more) visible. The characteristic of the gamma curve is described by a number between 0.2 and 6.0. Values below 1.0 result in reduction of dark sections, while values above 1.0 mean the extension of them. The value 1.0 does not have any affect on the image. The average used gamma is 1.6 while 2.2 is considered to be strong gamma correction. This value can be set by the gamma property. Camera image can be darkened or brightened with the help of the brightness parameter. This parameter equally alters dark and bright parts of the image. The value -1.0 results in the darkest image, while 1.0 results in the brightest value. The value 0.0 does not have any effect on the image. It may occur that not even the darkest pixel on the camera image is black. To solve this problem, the blacklevel property can be used. The value of this parameter may vary between 0.0 and 1.0 where 1.0 stands for 100%. Default value: 0.0. The whitest pixel on the camera image can be adjusted with the help of the whitelevel property. The value of this parameter may vary between 0.0 and 1.0 where 1.0 stands for 100%. Default value: 1.0.

Parameters of Gamma Correction

gamma RW 1.0=no correction (linear), x=correction is used (between 0.2 and 6.0) Values must be rounded to tenth (e.g. 0.2, 0.3 5.9, 6.0). imggamma RO used gamma value when the image was captured

blacklevel RW Defines the lowest pixel value that stands for black. This will be the starting

point of the gamma curve. Values between 0 and 1.0 are valid. NOTE: The blacklevel value must be lower than whitelevel.

imgblacklevel RO used black level value when the image was captured

whitelevel RW Defines the highest pixel value that stands for white. This will be the end of

the gamma curve. Values between 0 and 1.0 are valid. NOTE: The blacklevel value must be lower than whitelevel.

imgwhitelevel RO used white level value when the image was captured

brightness RW Adjusting brightness (it moves the gamma curve to Y direction). Valid values are between -1.0 and +1.0 Default: 0.0

imgbrightness RO used brightness value when the image was captured


8. Mirroring and Rotation In some special cases, (e.g. when the camera is installed upside down or aimed at a mirror) mirroring the camera image vertically or horizontally or rotating it by 90 degrees to any direction may provide a solution. Note that rotation is not supported by every camera model. Most camera models support only horizontal (smirrhoriz property) and vertical (smirrvert property) mirroring and 180-degree rotation (srotate property). Note that in case of rotations by 90 and 270 degrees, the aspect ratio changes (e.g. 752x480 image turns to 480x752).

Parameters of Mirroring

smirrhoriz RO 1: horizontal mirroring is enabled 0: horizontal mirroring is disabled

smirrvert RO 1: vertical mirroring is enabled 0: vertical mirroring is disabled

srotate RO 0: image rotation is disabled 90: camera image is rotated by 90 degrees 180: camera image is rotated by 180 degrees 270: camera image is rotated by 270 degrees

9. Image Compressor The image compressor is capable of converting the pixels into JPEG images or H264 stream. Note that not every camera model supports the H264 format. In case of JPEG compression, the quality of the images can be adjusted by the jpegquality parameter between 0 and 100 where 0 results in the smallest but poorest quality image and 100 means the best quality but largest image file. The default value is 75. Since good quality images can be created with 80, providing greater ones is not recommended to avoid increased bandwidth usage and disk space consumption. NOTE: The jpegquality parameter can be adjusted through the camera web interface by the Compress Rate option according to the following formula: jpegquality=100-Compress Rate, that means 0 is the best quality/largest file combination and 100 is the smallest file/poorest quality. Most of the enlisted properties are read-only and contain information related to the captured image.

Parameters of Image Compression Parameter name RO/RW Description

imgchannel RO

Selecting channel, see above.

0 = normal image from the sensor in high resolution (default) 1 = minified grayscale image from the motion detector module

(optionally colored), H264_I_PCM format 2 = JPEG stream 3 = H264 stream

NOTE: If not the default (0) format is used, it must be marked in every query.

imgformat RO Image format (cannot be altered at runtime- also depends on the profile). Possible values are:


0 = Automatic 1 = RAW format 2 = JPEG (in case of imgchannel 0 and 2) 3 = BMP (in case of imgchannel 1 for creating grayscale images) 4 = H264 I_PCM frame (only in special cases) in case of imgchannel 1 5 = H264 (in case of imgchannel 0 and 3)

NOTE: H264 compression is not available in every camera model.

jpegquality RW

The quality of JPEG images can be set by this parameter (a number between 0 and 100). The higher this value is, the better the quality

of the images will be. Default=75. NOTE: Images of better quality are greater in size therefore, they increase

network load. Suggested values are between 60 and 80.

imgjpegquality RO used jpeg quality value when the image was captured. fileext RO recommended file extension (string, e.g. .jpg) (read only) mimetype RO It returns the type of the data e.g. image/jpeg.

10. Motion Detector With the help of the built-in motion detector, the camera is capable of detecting motions in image streams based on the pixel differences between consequent frames. This motion detector can be customized for different purposes through its parameters detailed below and can be used to launch trigger events on motions. For more information on triggering, see Event Manager description. Operation A speed and a sensitivity value can be specified for the motion detector. Based on these values, a new value is calculated (imgmdbgresult) from the learnt background and the changes (imgmdxresult) between the current image. It is advisable to use the latter parameter for motion detection. A limit value can also be set, above which motion is detected in the imgmdresult parameter. Motions can be framed as well. Images containing motions are organized into sequences to which numbers (IDs) are assigned (imgmdsequence). Within sequences, the frames are also counted (imgmdseqframe). If frames with no motion are found after motion sequences, these frames are inserted into the end of the previous motion sequence. By the imgmdresult parameter, it can be decided whether was there any motion in the given sequence or was not.

Parameters of the Motion Detector

mdmode RW Turning motion detection on/off: 0 = turned off, 3 = turned on

mdspeed RW

The speed of the motion detector. Both the speed of the background image and the motion image are set by this option. Setting speed is independent from the FPS. It is compensated automatically. 0 = slow100 = very quick. Default value: 75

mdsensitivity RW Setting the sensitivity of the motion detector. 0 = the least sensitive 100 = very sensitive Default value: 75

mdrectsens RW Setting sensitivity for defining motion detection frame. 0 = the least sensitive 100 = very sensitive Default value: 75

mdoutimg RW The output of the motion detector (minified image).

0 = minified grayscale image 1 = output of the motion detector (0=no movements, 0xFF=largest


movement) 2 = bitmask (in which position has the motion detection been

enabled)

mdreslevel RW Motion limit. The extent of pixel changes above which the detected motion is handled as motion (it is not ignored). Suggested value: 20

mddebug RW This parameter is for testing the motion detector.

0 = no debug information appears on the minified image (default) 1 = areas included in the frame are marked with blue

mdmask00 ..

mdmaskFF RW

A so-called forbidding mask can be set for the motion detector to mark areas to be excluded from motion detection. The image is divided into 16x16 pixel blocks. For every block, a bit belongs. If an image cannot be divided by 256 then the bits in the last block do not count. Because of this e.g. in case of a 752x480 image 48x30 bit is stored instead of 47x30. If a bit is 1 that represents disabling, if 0 then it represents enabling (by default).

imgmdwin RO The motion detector defines a frame within which motion detection is executed. The coordinates of this frame are represented by this read-only parameter according to the followings: imgmdwin=x1,y1,x2,y2

imgmdbgresult RO Difference against the background. It is executed on every block and it sums the absolute values of differences. Read only parameter.

imgmdxresult RO Motion value for the entire image based on the pixel changes. It is advisable to use this parameter for motion detection. Note that this parameter is read only.

imgmdresult RO With the help of this parameter, it can be checked if there has been any motion on the given image or has not. Note that this parameter is read only.

0 = no motion has occurred 1 = motion has occurred

imgmdsequence RO Motion detection sequences have unique IDs. This ID is a read-only 32 bit counter. imgmdseqframe RO The number of frames within sequences is counted by this 32 bit counter and can be queried only.

If there are parts in the image in which motion should be ignored (for example traffic on another lane, on the sidewalk or just a tree on the side of the road blown by the wind), then this part should be masked out. Masks can be drawn most freely with the commands below.

Motion Detection Mask Commands

mdfillmask Filling the entire mask with the specified value. 0= disabling every mask position (no motion detection) 1= enabling all mask position (motion detection is enabled)

mddraw

Drawing a full circle on the specified position of the motion detection mask. Command format: mddraw=x,y,t,s x= X coordinate of the normal image y= Y coordinate of the normal image t= Operation to be executed: 0=erasing, 1=adding, 2=inverting s= Size of the brush: 0=1 pixel, 1=3 pixel, 2=5 pixel

mdsavemask Saving the created mask file under the current profile. mdloadmask Loading mask file from the current profile.


11. Analyzer The analyzer module provides data for sharpness adjustment and brightness control to other modules. These data consist of the followings:

Data for sharpness adjustment Data for brightness control (shutter, gain, iris)

12. Frame Buffers Captured images and image data are stored in the camera memory, in a dynamic buffer. Depending on the settings, even hundreds of images (max. 1024) can be stored in this way. User applications may get previous images based on their image index or image time. Every image has a monotonic counter called the frame index. This index is represented by the frameindex parameter. Furthermore, every image has two different timestamps. The first one is the system time (frametimems), the second one is a monotonic clock measuring in milliseconds that starts counting after turning on the camera (framemonotimems, see above). System time can be altered by setting the clock (manually or automatically e.g. through an NTP server). With the help of the getframe property, users can specify if they want to download image, image data or both. The scapture module is capable of retaining the last queried image for every connection. Because of this, it is easy to query the following (next) or the closest (by frameindex or timestamp) image (best). If the last queried image is needed, the last value must be used with the capture parameter.

Commands of Frame Management

getframe

The state of returning images. It advisable to use this option when setting/querying parameters and no image is necessary from the camera. With the help of this command, the unnecessary network load can be avoided.

0=no image is returned (only parameters and data are transferred) 1=image and data are returned (all data are transferred). Default option. 2=image is taken inside the camera but only the image parameters are

returned.

capture

Specifies a frame to be taken from the buffer. Buffering is executed by an other (hwlayer) module. The scapture gets images from this buffer.

next = returns the next available image related to the previously downloaded one

last = returns the last captured image from the buffer best = returns the most appropriate image from the buffer

(Setting one parameter among the frametimems, framemonotimems and frameindex is mandatory for this parameter. Otherwise, it takes the last from the buffer).

local = By default, it returns the image last queried by the scapture module (if there has not been such image then it returns the last one from the central buffer.

query{groupname} Querying specific boundary groups (see below).


12.1 Getting Images from the Frame Buffer

12.1.1 Operation of the Frame Buffer The buffer stores the latest captured frames. The number of these frames is variable: it depends on more factors e.g. on the size of the images.

12.1.2 Parameters of Captured Frames (Images) The scapture module returns three parameters for every captured frame: imgframeindex, imgframetimems and imgframemonotimems.

imgframeindex: After camera startup, captured frames are counted. This parameter provides the number of the frame. imgframetimems: Time elapsed since 1st January 1970 until the capturing of the frame in milliseconds. imgframemonotimems: Time elapsed since camera startup until the capturing of the frame in milliseconds. The above parameters can be used to determine the time of capturing when getting frames from the scapture module. These parameters can be displayed in browsers as a part of a parameter list according to the followings: http://192.0.2.3/scapture?multipart=1&ajaxcall=1 In case of the above query, no image is displayed. To display the image, the parameters are valid on, the multipart=1 and the ajaxcall=1 parameters must be omitted: http://192.0.2.3/scapture

12.1.3 The Capture Parameter capture=last http://192.0.2.3/scapture?capture=last It returns the last captured image. No other parameter is necessary for this query. Example to return the parameters of the last captured image: http://192.0.2.3/scapture?capture=last&multipart=1&ajaxcall=1 capture=next It returns the frame that follows the last returned (queried) one. If this frame is not in the buffer anymore, (too much time has elapsed and it has been rewritten by newer images), it returns the oldest image from the buffer. The capture=next can be used by itself or together with the framemonotimems, imgframetimems and frameindex parameters: In these cases, frames, following the specified number/timestamp are returned (if they are still in the buffer): Examples: capture=next&framemonotimems=98741855 capture=next&imgframetimems=1337679820180 capture=next&frameindex=8390


capture=best It returns the frame that is closest (before or after) to the specified timestamp or frame index. If the buffer does not contain such a frame, the oldest one is returned. If the specified timestamp (framemonotimems, imgframetimems) or frameindex value is too high (refers to a yet non-existing frame) then the newest frame from the buffer is returned. Examples: capture=best&framemonotimems=106964188 capture=best&imgframetimems=1337695009069 capture=best&frameindex=193390 For more information on handling the above parameters through the ARHIP PCAPI, see PCAPI description.

13. Properties By default, the system does not return all the properties together with images. If we need to query the remaining properties, then the get prefix must be used before the name of the property. Validity limits of properties can be queried with the query prefix. get{propertyname}=1 Getting the value of the property

query{groupname}=1 Querying specific boundary groups or possible value(s) seen below. In case of returning boundaries, the returned values are as follows: [min. value], [max. value], [default value]

Queryable parameters and groups

Groupname Returned value Sample value

boundimgchannel 0,1,0 listimgformat 0 listfileext jpg

modefmt

listcapture next,last,best,local boundimgframetimems 0,18446744073709551615,0 boundimgframemonotimems 0,18446744073709551615,0 frame boundimgframeindex 0,4294967295,0 boundimgsize 0,4294967295,0 listimgxsize 752 imgsize listimgysize 480 listifps 60.0,50.0

capfps boundiskipframes 0,15,0 listgetframe 0,1

data listgetmcount 0,1

param boundgain 0.25,4.0,1.0


boundshutter 31.25,15000,1000 boundgamma 0.2,6.0,1.0 boundbrightness -1.0,1.0,0.0 boundsaturation -1.0,1.0,0.0 boundcontrast -1.0,1.0,0.0 boundjpegquality 0,100,80 boundwhitebalance -1.0,1.0,0.0 boundcmatrix -127.0,127.0,0.0 boundcyuvadd -127.0,127.0,0.0 boundblacklevel 0.0,1.0,0.0

paramadv

boundwhitelevel 0.0,1.0,1.0 boundflashmode 0,31,31 boundflash1delay -1000.0,1000.0,0.0 flash boundflash1persec 0,200,0 boundgpifreq 1,250000,25

gpi boundgpidebounce 1,255,5 mdmode 1,3,3 boundmdspeed 0,100,75 boundmdsensitivity 0,100,75 boundmdrectsens 0,100,75 boundmdoutimg 0,3,1 boundmddebug 0,1,0

md

boundmdreslevel 0,255,50 listsmirrhoriz 0,1,0 listsmirrvert 0,1,0 smirrot listsrotate 0,180,0

Example:

Query: http://192.0.2.180/scapture/default?querydata=1

Answer:

listgetframe=0,1 listgetmcount=0,1

It is necessary to make a single connection capable of querying an image and its data in two separate queries. In this case, the web server has to assign the opened channels to the HTTP session.



System Hardware Date and Time [setup/time]

1. Introduction With the help of this module, formatted time and date values can be queried from the camera. NOTE: When communicating with the setup/time module, the cameraapi=1 parameter must be used instead of the multipart=1.

2. Retrieving Time Parameters Sample URL request: http://192.0.2.3/setup/time?multipart=1&ajaxcall=1&cameraapi=1&g_ftime=$a, $d $h $Y $T GMT $Q Sample answer to the URL request: Fri, 12 Jul 2002 15:22:10 GMT 529 a_localtimems=1026480130051 a_monotimems=49108 a_tzcode=400#CET-1CEST,M3.5.0,M10.5.0/3 a_year=2002 a_month=7 a_day=12 a_hour=15 a_min=22 a_sec=10 a_ntp=0 a_ntpip= multipart=1 mimetype=text/html where the first line is the formatted time (specified with $a, $d $h $Y $T GMT $Q) and the rest of the values are always returned by the module. These values contain the following information (separated by enter-s): a_localtimems: local timestamp in milliseconds counted from the Epoch: 1970-01-01 00:00:00 +0000 UTC. a_monotimems: Time elapsed since camera startup in milliseconds. a_tzcode: code of the local time zone a_year: year of local time a_month: month of local time a_day: day of local time a_hour: hour of local time a_min: minute of local time a_sec: second of local time a_ntp: returns whether NTP synchronization is turned on or not. a_ntpip: IP address of the NTP server In order to configure the content and structure of the returned time information (first line of the answer), the following arguments can be used:

Arguments are the same as the strftime functions usable in C++ except the Q.

2.1 Querying Custom Time Information Argument Description

%a The abbreviated weekday name according to the current locale. %A The full weekday name according to the current locale. %b The abbreviated month name according to the current locale. %B The full month name according to the current locale. %c The preferred date and time representation for the current locale. %C The century number (year/100) as a 2-digit integer. %d The day of the month as a decimal number (range 01 to 31). %D Equivalent to %m/%d/%y. %e Like %d, the day of the month as a decimal number, but a leading zero is replaced by a space. %E Modifier: use alternative format, see below. %F Equivalent to %Y-%m-%d (the ISO 8601 date format).

%G The ISO 8601 week-based year with century as a decimal number. The 4-digit year corresponding to the ISO

week number (see %V). This has the same format and value as %Y, except that if the ISO week number belongs to the previous or next year, that year is used instead.

%g Like %G, but without century, that is, with a 2-digit year (00-99). %h Equivalent to %b. %H The hour as a decimal number using a 24-hour clock (range 00 to 23). %I The hour as a decimal number using a 12-hour clock (range 01 to 12). %j The day of the year as a decimal number (range 001 to 366).

%k The hour (24-hour clock) as a decimal number (range 0 to 23); single digits are preceded by a blank. (See also %H.)

%l The hour (12-hour clock) as a decimal number (range 1 to 12); single digits are preceded by a blank. (See also %I.) %m The month as a decimal number (range 01 to 12). %M The minute as a decimal number (range 00 to 59). %n A newline character. %O Modifier: use alternative format, see below.

%p Either "AM" or "PM" according to the given time value, or the corresponding strings for the current locale. Noon is treated as "PM" and midnight as "AM".

%P Like %p but in lowercase: "am" or "pm" or a corresponding string for the current locale. %Q millisecond part of the current time (3 digits) %r The time in a.m. or p.m. notation. In the POSIX locale this is equivalent to %I:%M:%S %p. %R The time in 24-hour notation (%H:%M). For a version including the seconds, see %T below. %s The number of seconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC). %S The second as a decimal number (range 00 to 60). (The range is up to 60 to allow for occasional leap seconds.) %t A tab character. %T The time in 24-hour notation (%H:%M:%S). %u The day of the week as a decimal, range 1 to 7, Monday is 1. See also %w.

%U The week number of the current year as a decimal number, range 00 to 53, starting with the first Sunday as the first day of week 01. See also %V and %W.

%V The ISO 8601 week number of the current year as a decimal number, range 01 to 53, where week 1 is the first week that has at least 4 days in the new year. See also %U and %W.

%w The day of the week as a decimal, range 0 to 6, Sunday is 0. See also %u.

%W The week number of the current year as a decimal number, range 00 to 53, starting with the first Monday as the first day of week 01. %x The preferred date representation for the current locale without the time. %X The preferred time representation for the current locale without the date. %y The year as a decimal number without a century (range 00 to 99). %Y The year as a decimal number including the century. %z The +hhmm or -hhmm numeric time zone (that is, the hour and minute offset from UTC). %Z The time zone or name or abbreviation. %+ The date and time in date(1) format. %% A literal '%' character.


Automatic Zoom Control [control/zoomcontrol]

Zoom adjustment is possible in two ways:

manually by automatic zoom Zoom From Geometry (ZFG) mode

1. Manual Method Select the manual method by setting the mode parameter to 0. After that, the following parameters can be used to adjust the zoom.

Parameter name Mandatory RO/RW Valid values Description

mode yes RW 0: manual zoom

1: automatic (ZFG) mode of zooming

zoom no RW [zoom_min..zoom_max]

integer to zoom to a

specified position

zoom_min no RO integer to query the minimal zoom position of the

camera

zoom_max no RO integer to query the

maximal zoom position of the

camera

zoom_pc no RW [0..100] value of zoom in percentage

NOTE: Minimum, maximum and default values of zoom and zoom_pc can be queried by queryzoom and queryzoom_pc. Values are returned as: {minimum value}, {maximum value}, {default value}. Sample query: http://192.168.2.235/control/zoomcontrol?queryzoom&ajaxcall=1 Sample answer: boundzoom=0,90,-1 (-1 refers to a non-existing value).

2. Automatic Method In automatic mode, the camera calculates the best zoom position (so that the pixel size of the license plate will correspond to the set char_pxl value) based on the ZFG parameters provided by the user (certain requirements and constraints can be specified as well). Moreover, the camera is capable of setting the appropriate LED power and flashing time as well, for the above set parameters. Requirements of automatic zoom

set the mode parameter to 1 provide all of the following parameters:


2.1 Mandatory Parameters for Automatic (ZFG) Zooming

Parameter name Mandatory Parameter title RO/RW Description

cam_d_mm only for ZFG Camera offset (mm) RW horizontal offset between the centre of the number plate and the camera cam_h_mm only for ZFG Camera height (mm) RW distance between the ground and the camera char_mm only for ZFG Character height (mm) RW physical character height in millimeters char_pxl only for ZFG Character height (pixel) RW desired character height in pixels

plate_d_mm only for ZFG Plate distance (mm) RW distance between the camera and

the number plate measured according to the figure below

plate_w_mm only for ZFG Plate width (mm) RW width of the number plate in millimeters

plate_h_mm only for ZFG Plate height (mm) RW height of the number plate in millimeters

plate_h0_mm only for ZFG Plate elevation (mm) RW distance between the ground and the centre of the number plate

NOTE: Legal values of the above parameters depend on the ANPR environment. Combinations, which describe physically impossible parameters, are rejected.

Visual interpretation of ZFG parameters

After setting the ZFG parameters, the camera adopts the best zoom value and calculates additional information can be queried by the user. These read-only parameters provide useful information for camera installment and operation:


Read-only post ZFG information parameters

Parameter name RO/RW Description

best_zoom RO best zoom position f_mm RO best focal length

hfov_deg RO horizontal field-of-view (in degrees) vfov_deg RO vertical field-of-view (in degrees) pan_deg RO camera pan angle (see below) tilt_deg RO camera tilt angle (see below) roi_left roi_right roi_top

roi_bottom

RO These parameters represent the coordinates of the number plate

bounding box. For more information see chapter Automatic Focus Control.

led_time RO suggested LED flashing time, s led_level RO suggested LED voltage level, index

estr RO error description (if there is any) eparam RO list of invalid parameters (if there is any)

Camera pan and tilt angles

3. Parameter Sets The default parameter set is updated after a complete and valid request has sent to the module. If a parameter set is invalid, the module sends back detailed description of the error and the list of the invalid parameter names. If a parameter set is incomplete, the module sends back the default parameter set.

4. Errors In case of invalid parameters, the detailed description of the error is sent back in the estr parameter and the names of the invalid parameters are listed in "eparam". These special parameters (estr and eparams) cannot be queried directly.



Automatic Focus Control [control/focuscontrol]

Focus adjustment of the camera image can be executed in two ways: manually and automatically (by autofocus).

1. Manual Method Select the manual method by setting the mode parameter to 0 then set the focus manually by the focus parameter within the boundaries of focus_min and focus_max values.

2. Autofocus When using autofocus, focusing is controlled entirely by the module (no manual adjustments are possible). After auto focusing, the module switches back to manual mode (in case of both a successful and an unsuccessful focusing). Progress of autofocus can be queried anytime through the progress parameter.

2.1 The ROI (Region of Interest) Box The Automatic Focus Control (AFC) module is able to focus in a region of the image called ROI (Region of Interest) box. This region can be the rectangle returned by the ZFG process. However, the position of this box can specified manually with the help of the following parameters:

Parameter name RO/RW Description

roi_left** RW distance of the left side of the ROI box from the top left corner of the camera image in pixels

roi_right** RW distance of the right side of the ROI box from the top left corner of the camera image in pixels*

roi_top** RW distance of the upper side of the ROI box from the top left corner of the camera image in pixels*

roi_bottom** RW distance of the lower side of the ROI box from the top left corner of the camera image in pixels*

** Camera model (optics and sensor) dependent properties.

NOTE: Using the same ROI coordinates at zoom and focus is recommended.

NOTE: The coordinates of the ROI must be set according to the resolution of the camera. E.g. 752x480.

3. Brightness and Autofocus Criteria of successful auto-focusing:

the brightness must be set to reach optimal contrast the camera must be targeted to capture stable images containing fine details in the ROI (edges, textures)

The auto-focusing algorithm waits for stable brightness while the autobrightness function is running on the camera. During this waiting process, the automatic focus control is in paused mode (mode=2). As soon as the brightness is stable, the module switches back to auto mode and starts the auto-focusing process.

Values are rounded to 16 multiples.

4. Parameters Parameter name RO/RW Valid values Description

mode RW [0,1,2]

mode of focusing 0: manual 1: auto 2: paused (can not be activated

by users but the system only) focus RW [focus_min..focus_max] focus position

focus_min** R minimal focus position focus_max** R maximal focus position

progress R [1..100] progress of the autofocus represented in percentage

focus_pc RW [0..100] focus position in percentage ** Camera model (optics) dependent properties. NOTE: Minimum, maximum and default values of focus and fous_pc can be queried by queryfocus and queryfocus_pc. Values are returned as: {minimum value}, {maximum value}, {default value}. Sample query: http://192.168.2.235/control/focuscontrol?queryfocus&ajaxcall=1 Sample answer: boundfocus=0,90,-1 (-1 refers to a non-existing value).

5. Errors In case of invalid parameters, the detailed description of the error is sent back in the estr parameter and the names of the invalid parameters are listed in eparam. These special parameters (estr and eparams) cannot be queried directly.


Automatic Brightness Control [control/brightnesscontrol]

Brightness adjustment of the camera image can be executed in two ways: manually and automatically (with the help of strategies).

1. Manual Mode In manual mode (mode=0), the gain, shutter and iris can be adjusted separately between the boundaries returned by the module. Values are represented according to the followings:

gain - in percentage or decibel, depending on the camera model shutter - in microseconds iris - position iris_pc - in percentage

NOTE: Although, gain and shutter adjustment can also be executed through the scapture/default module, setting

these values is strongly recommended through the Brightness module.

2. BrightNow! Use the BrightNow! function for single, quick and simple adjustments. Send mode=3 and a target value (see below) to the brightness module then the function executes a quick but less accurate adjustment which will end in couple of steps (this mode will not engage again until started manually). After this, the previously set mode is activated.

NOTE: Always send the target first, or together with the mode in order the avoid malfunction.

3. Automatic Mode For automatic brightness adjustment, the following strategies are available:

Overview strategy (for overview camera purposes), mode=1 ANPR strategy (for ANPR purposes), mode=2 Quick strategy (for quick adjustment), mode=4

Common features of strategies All the three strategies receive brightness target value from the user between -100 and 100. When a target value is set, the strategies set shutter, iris and gain automatically to reach and to maintain this value executing continuous adjustment on brightness changes. This value can be adjusted according to the figure below and is used mutually by the strategies so it is sufficient to provide it for one.

For all strategies, the boundaries and step values can be set for gain, shutter and iris respectively. Day and night configuration settings can also be provided for each strategy containing the previously mentioned boundaries and steps. The strategies switch between day and night modes automatically with the help of the camera light sensor. Both the actual value of the light sensor and the current strategy can be queried from the module (0 stands for day mode, 1 for night mode). Note that currentset cannot be queried if the brightness control mode is manual. Boundaries (minimal and maximal values) and current values can be queried anytime regardless the controlling mode.


/58


4. Module Parameters

Name RO/RW Valid values Description

mode RW [0,1,2,3,4] controlling strategy

gain RW [gain_min..gain_max] value of gain in percentage

gain_min1 RO minimal value of gain in percentage

gain_max1 RO minimal value of gain in percentage

shutter RW [shutter_min..shutter_max] value of shutter in secs

shutter_min1 RO minimal value of shutter in secs

shutter_max1 RO maximal value of shutter in secs

iris RW [iris_min..iris_max] iris position

iris_pc RW [0..100] iris value in percentage

iris_min1 RO minimal iris value

iris_max1 RO maximal iris value

target RW [-100..+100] integer target brightness value for strategies to set and maintain

current_set RW [0,1] day (0) or night (1) configuration (only if autobrightness is on)

light_sensor RO value of the light sensor

state RO [0,1,2]

State of the brightness controller. 1: stable (target is reached) 2: working (to reach the target) 3: unreachable (the target can not be reached

with the current light conditions)

histogram RO

256 pcs. of comma separated integers between 0 and 255

where X stands for the highest pixel intensity appearing on

the screen

returns histogram values in numeric format: 0.-255. values represent the cardinality of the given grayscale pixel intensity normalized to 100. 256. value represents the average pixel intensity.

1 Camera model (optics) dependent properties, query these parameters to get their values. NOTE: Minimum, maximum and default values of iris, shutter and gain can be queried by queryiris, queryiris_pc, queryshutter and querygain. Values are returned as: {minimum value}, {maximum value}, {default value}. Sample query: http://192.168.2.235/control/brightnesscontrol?queryiris&ajaxcall=1 Sample answer: boundiris=0,47,-1 (where -1 refers to a non-existing value).

5. Operation of Strategies

NOTE: It may take seconds to minutes for the current strategy to settle depending on its settings.

5.1 ANPR and Overview Strategies The overview strategy prioritizes gain over shutter and shutter over iris. That means it prefers adjusting gain (if possible) to shutter and prefers adjusting shutter to iris within their boundaries. The ANPR strategy uses a special function and a further controller method to provide appropriate image for license plate recognition it never lets the image burn out. The overview strategy does not have this protection the image of the observed area may burn out to maintain visibility in the entire image.

5.2 The Quick Strategy With the help of the quick brightness adjuster method, appropriate brightness can be reached quickly but less accurately. Adjustments are applied according to the above-mentioned priority. When the target level is approached as close as a defined limit value, the adjustment stops until lighting conditions change. If the target level cannot be reached with given number of steps, the quick adjusting method gives up. It chooses between day and night configurations at startup and does not query the light sensor after all (to increase speed). It uses the selected configuration until finished.

6. Errors In case of an inappropriate parameter sending, the description of the error will be in the estr answer parameter. These special answer parameters (estr and eparams) cannot be queried directly.

Illuminator Configuration Manager [config/ledcfg]

With the help of the Illuminator Configuration Manager, default flash settings can be customized for the different brightness modes and strategies on the built-in illuminator unit according to the followings: SETTING: http://{IP address}/config/ledcfg?{strategy}_{mode}_led_pcdose={value} E.g. http://192.0.2.170/config/ledcfg?overview_night_ledpcdose=45 As a result of the above command, the built-in illuminator flashes with 45 pc_dose value when the mode is night and the strategy is overview. QUERY: http://{IP address}/config/ledcfg?get{strategy}_{mode}

Possible parameter values

Strategy Mode led_pcdose

[anpr, overview, quick, manual] [day, night] [0..100]

NOTE: Values will be applied after saving settings and quick restart of the camera.

Page 30/58 ParkIT - Programmers Manual

Scheduler Trigger [trigger/scheduler]

1. Introduction With the help of this module, it is possible to schedule trigger events. On these events, certain tasks can be executed (e.g. uploading files to an FTP server).

2. Basic Parameters Name Mandatory Values Description

wday yes

[mon,tue,...,sat,sun][day_1-day_2] [mon;tue;...]

[every]

on which day(s) of the week should the timer be active example: wday=tue where day_1 < day_2: wday=tue-sat example: wday=wed;sun example: wday=every

day yes

[1-31] [1;2;...] [every]

on which day(s) of the month should the timer be active example: day=23-31 example: day=1;3;31 example: day=every

hour yes

[0-23] [0;1;2;...]

[every]

in which hour(s) of the day should the timer be active example: hour=8 example: hour=0;5;10 example: hour=every

min yes

[0-59] [0;1;2;...]

[every]

in which minute(s) of the hour should the timer be active example: min=1 example: min=15;23;42 example: min=every

sec yes

[0-59] [0;1;2;...]

[every]

in which second(s) should the timer be active example: min=1 example: min=15;23;42 example: min=every

output yes [0-(noutputs-1)] example: output=1 noutput no [uint] returns the number of scheduler outputs

drive yes [level,edge] Edge controlled or level controlled timer. level: level controlled (see below) edge: edge controlled (see below)

enabled no [true,false] Enabling or disabling a scheduler trigger Query example: http://192.0.2.45/trigger/scheduler?output=0&gethour Example for setting: http://192.0.2.45/trigger/scheduler?cmd=init&output=0&enabled=true&drive=edge&wday=mon-fri&day=1-31&hour=8-20&min=every&sec=every

NOTE: Accepted parameters are saved to the configuration file and will be applied at the next startup.


2.1 Information Commands

Command Name

Format Example Description

returns already set

timer parameters

getparams {ip_address}/trigger/scheduler?

getparams&output=1 http://192.0.2.33/trigger/ scheduler?output=1&getparams

3. Level and Edge Control Drive of trigger signals can be edge controlled or level controlled.

3.1 Edge controlled trigger signals last for a very short time instant (startms = endms).

3.2 Level controlled trigger signals on the other hand are always last for a period according to the followings:

23:12:59.999

If sec!=0-59

23:12:12.99923:12:12.000

If sec=0-59 and min=0-59

23:59:59.99923:00:00.000

If sec=0-59 and min!=0-59

23:12:00.000

So, if the timer uses level control then:

if not every second is active (If sec!=0-59) then startms = start of the second, endms = 999 msecs later

if every second and every minute is active (If sec=0-59 and min=0-59 ) then startms is the first msec of the hour while endms is the last msec of the hour

if every second is active (If sec=0-59 and min!=0-59) then startms is the first msec of the minute while endms is the last msec of the minute

4. Errors In case of invalid parameters, the module returns the following:

estr=Invalid parameter eparams= {invalid parameters separated by colons}


Upload Manager [upload/uploadman]

1. Introduction With the help of the upload/uploadman module, a protocol can be selected (FTP, SMTP or HTTP POST) via which image, image data (sent by the Event Manager) and trigger information will be forwarded from the camera. For sending trigger information, see Event Manager Description. Names of uploaded files can be specified in the filenametemplate parameter, image data is uploaded in text files of the following form: filenametemplate.params.txt

2. Parameters General Parameters (for every protocol)

Name Mandatory Values Description cmd yes [init] initializing protocol

method yes [ftp,smtp,post] selecting protocol e.g. method=ftp

currentmethod no [0,1,2] returns the actual protocol: 0: FTP 1: SMTP 2: HTTP POST

data no [0,1,2]

0: image + event data 1: image 2: data

type of data to be sent; if not set then both image and image data are

uploaded (data=0)

Parameters for the HTTP POST Protocol

Name Mandatory Values Description url yes [text] web server address

filenametemplate yes [$y,$r,$o,$d,$h,$m,$s,$l,$t,text] $y: year (4 characters) $r: year (2 characters) $o: month $d: day $h: hour $m: minute $s: second $l: millisecond $t: frametimems $i: motion sequence ID (hexadecimal number) $x: frame index within a sequence (hexadecimal number) text: string

definition of arguments

Filename template example: filenametemplate=$y-$o_$d-text-$d$m-text-$s-$l.JPEG Results in e.g. 2011-01_01-text-0113-text-12-123.JPEG Example: specifying parameters for HTTP POST protocol cmd=init&method=post&url=testserver/index.php&filenametemplate==$y/$o_$d/text-$d$m-text-$s-$l.JPEG&data=1


NOTES: it is not mandatory to use all of the arguments it is possible to use an argument at more places in the same command it is advisable to specify the extension of the file (as text)

Parameters for the FTP Protocol

Name Mandatory Values Description url yes [text] FTP server address

username no [text] FTP account username password no [text] FTP account password

filenametemplate yes [text] see above Example:

cmd=init&method=ftp&url=testserver&username=testuser&password=testpassword&filenametemplate=$y/$o_$d/text-$d$m-text-$s-$l.JPEG&data=0

NOTE: Setting the username and password are not mandatory. User name and password is stored in the camera unencrypted.

Parameters for the SMTP Protocol

Name Mandatory Values Description url yes [text] SMTP server address

username no [text] SMTP account username password no [text] SMTP account password

filenametemplate yes [$y,$r,$o,$d,$h,$m,$s,$l,$t,text] see above from no [email address] sender of the e-mail to yes [email1,email2,...] recipient(s) of the e-mail

Example: cmd=init&method=smtp&url=testserver&username=testuser&password=testpassword&filenametem late=$y/$o_$d/text-$d$m-text-$s-$l.JPEG &from=sender@testserver&to=recipient@testserver2&data=2

NOTE: Setting the username and password are not mandatory. User name and password is stored in the camera unencrypted.


Information Commands (to query previously set parameters)

Name Mandatory Values Description

getftpparams no -

The set FTP parameters. Returned values: url= filenametemplate= username= password= curltimeoutms= data= currentmethod=

getsmtpparams no -

Returns SMTP parameters. Returned values: url= filenametemplate= from= to= curltimeoutms= data= currentmethod=

getpostparams no -

returns HTTP POST parameters: url= filenametemplate= data= currentmethod=

returns logging data in the dataset section of the answer cmd no [getlog]

Query example: http://192.0.2.11/upload/uploadman?getftpparams

3. Processing Logging Data A record of the log file is built-up as follows: upload1_var_1,upload1_var_2,upload1_var_3,upload1_var_4,upload1_var_5; Fields are separated by commas while records are separated by semicolons. Sample record:

0,02/02-01-25-25-972.JPEG,0,0,No error;0,02/02-01-25-45-175.JPEG,0,0,No error;

Description of variables: var_1 : upload method [0,1,2,3] [ftp,smtp,http post,invalid] var_2 : filename var_3 : type of uploaded data [0,1,2] [image+data,image,data var_4 : success of uploading [0,1,2] [OK,failed,image ok + data failed] var_5 : error string [No error, or error message]

4. Errors In case of invalid parameters, the module returns the followings:

estr=invalid parameter eparams= invalid parameters separated by colons


Event Manager [trigger/eventman]

1. Short Description The Event Manager monitors the state of multiple trigger sources (such as Hardware Motion Detector or GPIO input), evaluates a user defined logical conjunction between these trigger source states and depending on the result of this evaluation initiates the uploading of a sequence of images. The Event Manager also implements image and trigger buffering, thus it offers greater flexibility with trigger timing.

2. Detailed Description

2.1 Trigger Inputs and Master Output The Event Manager can be imagined as a combinatorial logic network with multiple inputs and a single output. The inputs and the output may be either asserted or not asserted. The output becomes asserted if the inputs are asserted in such a combination, that the user defined logic expression (formula, see below) evaluates to 'true'. The inputs are labeled with capital letters from A to U (V-Z are reserved).

2.2 Registering The inputs can be assigned to various trigger sources. This process is called registering. If a trigger source has multiple outputs, it can be assigned to different inputs of the Event Manager.

2.3 Formula The trigger control formula of the Event Manager can be defined by using the capital letters and the logic symbols defined below. The shorthands 'each' for AND-ing all the inputs, or 'any' for OR-ing all the inputs can be used. The following logic symbols can be used: - & (web interface) or * (URL) for AND - | (web interface) or + (URL) for OR - ! for NOT - ( and ) for bracketing Valid formulas are for example: - A&B&C (Web interface) - (A+B)*C (URL) - A - A&!B (Web interface) NOTE: Spaces are not allowed in formulas.

2.4 Trigger Action There is a process within the Event Manager, which monitors the Master Output, and acts while it is asserted. This action is forwarding the images to the Upload Manager, which in turn will handle uploading of these images according to its current setup.


3. Commands and Parameters The event manager can be configured wit the help of the commands below. Structure of a command:

cmd=[command]&[param1=value1]&...&[paramN=valueN]

3.1 Commands

Command Format Example Description

register cmd=register&module_name=

[Module name]&output=[Output index]&input=[Input index]

cmd=register&module_name= trigger/swtrigger

&output=0&input=D

registers the module's given output to the

given input unregisters the

module registered at the given input

freeinput cmd=freeinput&input=[Input index] cmd=freeinput&input=D

sets the logic expression the Event Manager evaluates

setformula cmd=setformula&formula=[Logic expression]

cmd=setformula&formula= (D+A)*B

start cmd=start cmd=start starts the Trigger

Action process of the Event Manager

stops the Trigger Action process of the

Event Manager stop cmd=stop cmd=s

parkit programmers manual

Documents

retrieving parameter

setting parameter values

retrieving parameter

camera software

camera modules

image sensor

table of contents introduction

document version