49.4. VS diagnostics and statistics

49.4. VS diagnostics and statistics
	Chapter 49. VS - Video Surveillance

49.4.1. VS diagnostics

This command reports the current situation of the VS resource:

[13:21:19] ABILIS_CPX:d d vs

RES:Vs ------------------------------------------------------------------------
       Video_Surveillance                                                      
       STATE:ACTIVE
       CUR-MAX-RVS:4    CUR-RUN-RVS:2    CUR-MAX-CAM:4    CUR-RUN-CAM:2
       CUR-MAX-LIVE:0   CUR-LIVE:0       CUR-LIVE-REC:0   CUR-ALARMS-REC:0

The meaning:

STATE

VS driver state:

INACTIVE - configuration parameter ACT:NO.
ACTIVE - the driver is fully ready to work.
INIT - the driver is initializing.
DOWN - the driver is not working.

CUR-MAX-RVS

Current value of max-rvs parameter.

CUR-RUN-RVS

Number of currently running RVS.

CUR-MAX-CAM

Current value of max-cam parameter.

CUR-RUN-CAM

Number of currently running cameras.

CUR-MAX-LIVE

Current value of max-live parameter.

CUR-LIVE

Number of currently established live sessions.

CUR-LIVE-REC

Number of ongoing LIVE recordings.

CUR-ALARMS-REC

Number of ongoing ALARM recordings.

49.4.1.1. RVS diagnostics

This command reports the current situation of the RVS resource:

[13:27:01] ABILIS_CPX:d d rvs

RES:Rvs-1 ---------------------------------------------------------------------
       RVS_TEST                                                   
       STATE:UP                   MAC:B8-27-EB-00-9B-7E
       RemAdd-RemPort:192.168.000.222-41414
       CURRENT-IMAGE:5.1          FACTORY-IMAGE:5.000     BOARD:0.0
       - Digital Input Lines State --------------------------------------------
        1.. 4| ON  off ON  ON  
       ------------------------------------------------------------------------
       - Digital Output Lines State -------------------------------------------
        1.. 4| off off off off 
       ------------------------------------------------------------------------
       - Cameras diagnostics --------------------------------------------------
       CAM:  State:    LIVE: LIVE-REC: ALARM-REC: STORED-ALARMS: STORED-LIVE:
       ------------------------------------------------------------------------
       Cam-1 UP        0     NO        NO         631            2
       ------------------------------------------------------------------------

[13:43:00] ABILIS_CPX:d de rvs

RES:Rvs-1 ---------------------------------------------------------------------
       RVS_TEST                                                     
       STATE:UP                   MAC:B8-27-EB-00-9B-7E
       RemAdd-RemPort:192.168.000.222-41414
       CURRENT-IMAGE:5.1          FACTORY-IMAGE:5.000     BOARD:0.0
       - Digital Input Lines State --------------------------------------------
        1.. 4| ON  off ON  ON  
       ------------------------------------------------------------------------
       - Digital Output Lines State -------------------------------------------
        1.. 4| off off off off 
       ------------------------------------------------------------------------
       - Cameras diagnostics --------------------------------------------------
       CAM:  State:    LIVE: LIVE-REC: ALARM-REC: STORED-ALARMS: STORED-LIVE:
             Storage:  LAST-STORED-ALARM:         LAST-STORED-LIVE:
             STORED-IMAGES:  AVERAGE-IMAGE-SIZE:       FORECAST-CAPACITY:
             RESOLUTION:     ROTATION: JPEG-QUALITY:   EXPOSURE-TIME:
             LAMP-THRESHOLD: LAMP-DURATION:            LAMP-ON-EXPOSURE-TIME:
             PREVIEW:        HDR:      FLASH:          METERING:
             SHARPNESS:      CONTRAST: BRIGHTNESS:     SATURATION: 
       ------------------------------------------------------------------------
       Cam-1 UP        0     NO        NO         631            2
             ACTIVE    07/05/2018  11:51:57       07/05/2018  12:02:36
             97081           608 KB                    103470
             8               270       HIGH            AUTO
             0               30                        1/60
             MEDIUM          NA        OFF             AVERAGE
             0               0         0               0          
       -----------------------------------------------------------------------

The meaning:

STATE

RVS device driver state:

DOWN - RVS device driver is down.
UP - RVS device driver is active and ready
INACTIVE - RVS device driver is inactive.

MAC

RVS device driver MAC address.

RemAdd-RemPort

Remote IP address - port.

CURRENT-IMAGE

Current image version.

FACTORY-IMAGE

Factory image version.

BOARD

Current board version.

Digital Input Lines State 1.. 4

Digital Input Lines State:

off - line state is off.
ON - line state is on.
. - line state is not available.

Digital Output Lines State 1.. 4

Digital Output Lines State:

off - line state is off.
ON - line state is on.
. - line state is not available.

CAM

Camera identifier.

State

Camera state:

DOWN - the camera is disabled.
UNKNOWN - No information available from the device.
ACTIVE - the camera is fully working.
ABSENT - the camera is missing or not correctly connected (HW).
SW-ERROR - the camera (HW) is there but it is not working (SW).
INVALID - the used camera Identifier is not available at all.
LIVE-ONLY - the camera is working but the storage isn't so just live works.

LIVE

Number of currently established live sessions.

LIVE-REC

Whether LIVE recording is ongoing or not:

NO - LIVE recording not ongoing.
YES - LIVE recording ongoing.

ALARM-REC

Whether ALARM recording is ongoing or not:

NO - ALARM recording not ongoing.
YES - ALARM recording ongoing.

STORED-ALARMS

Number of ALARMS stored for running cameras, including ongoing ones.

LAST-STORED-ALARM

This is the time of most recent ALARM stored for running cameras, including ongoing ones, in milliseconds. When no ALARM are present the displayed value is '-'; otherwise the format is 'dd/mm/yyy hh:mm:ss'.

STORED-LIVE

Number of LIVE stored for running cameras, including ongoing ones.

LAST-STORED-LIVE

This is the time of most recent LIVE stored for running cameras, including ongoing ones, in milliseconds. When no LIVE are present the displayed value is '-'; otherwise the format is 'dd/mm/yyy hh:mm:ss'.

STORED-IMAGES

Number of images stored, including those pertaining to deleted live/alarm events.

AVERAGE-IMAGE-SIZE

Average size of images, in kbytes. When no images are present the displayed value is '-'.

FORECAST-CAPACITY

This is the forecasted capacity of the storage based on average image size and image part of storage size. When no images are present the displayed value is '-'.

RESOLUTION

The resolution (in megapixels).

ROTATION

The rotation (in degrees).

JPEG-QUALITY

The quality of jpeg images: HIGH, LOW, MEDIUM.

EXPOSURE-TIME

The exposure time.

LAMP-THRESHOLD

Scene brightness threshold for switching on the companion lamp.

LAMP-DURATION

Duration of companion lamp switch on.

LAMP-ON-EXPOSURE-TIME

Exposure time when LAMP is ON, in fraction of second.

PREVIEW

The rotation (in degrees).

HDR

The High dynamic range imaging.

FLASH

The flash mode.

METERING

The metering mode.

SHARPNESS

The sharpness.

CONTRAST

The contrast.

BRIGHTNESS

The brightness.

SATURATION

The saturation.

49.4.2. VS statistics

This command can help to understand what is happening, in case of troubles:

[13:26:59] ABILIS_CPX:d s vs 

RES:Vs ------------------------------------------------------------------------
       Video_Surveillance                                                      
       --- Cleared 1 days 00:45:26 ago, on 16/05/2018 at 16:00:29 -------------
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       CONN-SUCC  |           |          5|BOARD-ERR  |          0|           |
       CONN-FAIL  |           |          0|           |           |           |
       CLOSE      |          3|          0|           |           |           |
       CFG-FAIL   |          0|           |SET-AO-CUT |          0|           |
       SET-FAIL   |           |          0|           |           |           |
       PROT-ERR   |          0|          0|           |           |           |
       IMAGE-ERR  |          0|           |           |
       ------------------------------------------------------------------------
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       EVENTS     |          0|           |IMAGES     |          0|           |
       IMAGES-SZ  |          0|           |ERR-EVENTS |          0|           |
       ERR-IMAGES |          0|           |ERR-IMG-SZ |          0|           |
       OOO-EVENTS |          0|           |OOO-IMAGES |          0|           |
       ------------------------------------------------------------------------

With reference to the shown interval of time («Cleared 1 days 00:45:26 ago») these counters show the number of:

`CONN-SUCC`	Successful opened sessions, at least a response received.
`BOARD-ERR`	Connections aborted on Missing board.
`CONN-FAIL`	Aborted sessions (on opening), tcp failed or no response received.
`CLOSE`	IN: Times that the JMUX communication protocol with RVS it has been disconnected for "external" reasons (ad example RVS itself restarted the JMUX connection, or was restarted, etc ..). OUT: Times that the JMUX protocol of communication with RVS has been disconnected for "internal" reasons (the Abilis itself has restarted the connection).
`CFG-FAIL`	Failed configuration of digital/analog parameters.
`SET-AO-CUT`	Setting of analog outputs that where cutted.
`SET-FAIL`	Failed setting of digital/analog outputs.
`PROT-ERR`	Number of JMUX Errors.
`IMAGE-ERR`	Errors that occurred during the download and decryption of the image.
`EVENTS`	Number of recorded events.
`IMAGES`	Number of recorded images.
`IMAGES-SZ`	Total size of recorded images.
`ERR-EVENTS`	Number of errors that occurred during the recording of an event.
`ERR-IMAGES`	Number of errors that occurred while recording an image.
`ERR-IMG-SZ`	Total size of the images lost because the storage has given error.
`OOO-EVENTS/OOO-IMAGES`	Number of events/images discarded because the timestamp was not correct.

49.4.2.1. RVS statistics

This command can help to understand what is happening, in case of troubles:

[13:45:56] ABILIS_CPX:d s rvs

RES:Rvs-1 ---------------------------------------------------------------------
       --- Cleared 1 days 00:47:17 ago, on 16/05/2018 at 16:00:29 -------------
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       CONN-SUCC  |           |          2|BOARD-ERR  |          0|           |
       CONN-FAIL  |           |          0|           |           |           |
       CLOSE      |          1|          0|           |           |           |
       CFG-FAIL   |          0|           |SET-AO-CUT |          0|           |
       SET-FAIL   |           |          0|           |           |           |
       PROT-ERR   |          0|          0|           |           |           |
       IMAGE-ERR  |          0|           |           |
       ------------------------------------------------------------------------

[13:45:59] ABILIS_CPX:d se rvs

RES:Rvs-1 ---------------------------------------------------------------------
       --- Cleared 1 days 00:47:20 ago, on 16/05/2018 at 16:00:29 -------------
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       CONN-SUCC  |           |          2|BOARD-ERR  |          0|           |
       CONN-FAIL  |           |          0|           |           |           |
       CLOSE      |          1|          0|           |           |           |
       CFG-FAIL   |          0|           |SET-AO-CUT |          0|           |
       SET-FAIL   |           |          0|           |           |           |
       PROT-ERR   |          0|          0|           |           |           |
       IMAGE-ERR  |          0|           |           |
       ------------------------------------------------------------------------
       - Cameras statistics ---------------------------------------------------
       CAM:Cam-1
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       EVENTS     |          0|           |IMAGES     |          0|           |
       IMAGES-SZ  |          0|           |ERR-EVENTS |          0|           |
       ERR-IMAGES |          0|           |ERR-IMG-SZ |          0|           |
       OOO-EVENTS |          0|           |OOO-IMAGES |          0|           |
       ------------------------------------------------------------------------

With reference to the shown interval of time («Cleared 1 days 00:47:20 ago») these counters show the number of:

`CONN-SUCC`	Successful opened sessions, at least a response received.
`BOARD-ERR`	Connections aborted on Missing board.
`CONN-FAIL`	Aborted sessions (on opening), tcp failed or no response received.
`CLOSE`	IN: Times that the JMUX communication protocol with RVS it has been disconnected for "external" reasons (ad example RVS itself restarted the JMUX connection, or was restarted, etc ..). OUT: Times that the JMUX protocol of communication with RVS has been disconnected for "internal" reasons (the Abilis itself has restarted the connection).
`CFG-FAIL`	Failed configuration of digital/analog parameters.
`SET-AO-CUT`	Setting of analog outputs that where cutted.
`SET-FAIL`	Failed setting of digital/analog outputs.
`PROT-ERR`	Number of JMUX Errors.
`IMAGE-ERR`	Errors that occurred during the download and decryption of the image.
`EVENTS`	Number of recorded events.
`IMAGES`	Number of recorded images.
`IMAGES-SZ`	Total size of recorded images.
`ERR-EVENTS`	Number of errors that occurred during the recording of an event.
`ERR-IMAGES`	Number of errors that occurred while recording an image.
`ERR-IMG-SZ`	Total size of the images lost because the storage has given error.
`OOO-EVENTS/OOO-IMAGES`	Number of events/images discarded because the timestamp was not correct.


49.3. VS web interface		Part IV. CTI System