| 54.1. VS resource | ||
|---|---|---|
 | Chapter 54. VS - Video Surveillance |  |
| 54.1. VS resource | ||
|---|---|---|
| | Chapter 54. VS - Video Surveillance | |
Videosurveillance stores on additional hard disk the videos obtained from one or more RVS cameras. The video is then viewable and manageable using a standard browser. It also manages alarms that in addition to record the videos can send email, SMS, as well as a phone call using DISA service.
The ABILIS can simultaneously record images from several RVS cameras. The recorded frames are displayed through a web page. Since the recording device is contained inside the router, it seamlessly links to all available networks.
Prerequisites:
The RVS devices are dynamically created or removed through the Rio/Rvs configuration web interface, and they appears in Abilis as RVS-x resources.
Add the resource to the Abilis system with the following command.
[09:08:14] ABILIS_CPX:a res:vs
COMMAND EXECUTEDThe VS resource may already exist in the system, but may not yet be active, and set the working directory and the storage size (in megabytes)
[09:10:00] ABILIS_CPX:s act res:vsCOMMAND EXECUTED [09:12:00] ABILIS_CPX:s p res:vs act:yes storage-wdir:D:\vs\ storage:10COMMAND EXECUTED [15:20:51] ABILIS_CPX:save confCOMMAND EXECUTED [15:20:51] ABILIS_CPX:warm start
![[Caution]](../images/caution.png) | Caution |
|---|---|
After adding or setting the VS active, or having set the working directory or the storage size you must restart the Abilis to make the resource running. Use the command save conf and restart Abilis (i.e. With warm start command) |
![[Warning]](../images/warning.png) | Warning |
|---|---|
The first time the VS is configured and Abilis rebooted the VS driver prepares the hard disk to handle the surveillance file. The VS driver will stay unavailable up this task is completed, so PLEASE WAIT the VS driver to become enable again, you can check it in the web interface or in VS diagnostics. |
![[Tip]](../images/tip.png) | Tip |
|---|---|
Interesting chapter: Section 70.24, “Rio/Rvs configuration”. |
![[Note]](../images/note.png) | Note |
|---|---|
Set the [15:21:01] ABILIS_CPX: |
Use the command d p vs to show the parameters of the resource and use the command d p vs ? to display the meaning of the parameters.
[10:42:19] ABILIS_CPX:d p vs
RES:Vs ------------------------------------------------------------------------
Run DESCR:Video_Surveillance
LOG:DS ACT:YES max-rvs:6 max-cam:6 max-live:6 TOS:0-N
wdir:c:\app\vs\
storage-wdir:e:\vs\
-- Camera "SYS" values -------------------------------------------------
STORAGE:60 GiB REC-MAXAGE:NOMAX IDLE-REC-INTERVAL:60
MIN-ALARM-DURATION:20 MAX-ALARM-DURATION:60 ALARM-HOLDOFF:5
LIVE-REC-DURATION:60
-- Notifications -------------------------------------------------------
NOTIFY-ON-ERROR:NONE
-- Mail ----------------------------------------------------------------
MAIL-FROM:AUTO (vs@abilis_cpx__)
MAIL-TO:
-- SMS -----------------------------------------------------------------
SMS-CDO:#
-- Disa Voice Call -----------------------------------------------------
DISA-USER:# DISA-SERVICE:#
DISA-CDO:# DISA-CGO:#Meaning of the most important parameters:
LOGLogging functionalities activation/deactivation.
ACTRuntime VS activation/deactivation.
max-rvsMaximum number of Rvs devices [1..16].
max-camMaximum number of Rvs cameras shareable between all Rvs devices [0..80].
max-liveMaximum number of LIVE sessions [1..80].
TOSType Of Service octet or Differentiated Services Field (DS):
' p-t', i.e. PRECEDENCE and TOS values, where 'p' can be [0..7] and 't' can be [N=None, D=Min. Delay, T=Max. Throughput, R=Max. Reliability, C=Min. Monetary Cost];
'bbbbbb', i.e. DS value bit by bit, where 'b' can be [0, 1].
wdirDirectory where helper files are saved. Full path with drive letter ['C'..'Z'] terminated by '\'. Max 128 chars. Spaces require double quotes (E.g. "C:\My dir\").
storage-wdirWorking directory where the storage is saved. Full path with drive letter ['C'..'Z'] terminated by '\'. Max 128 chars. Spaces require double quotes (E.g. "C:\My dir\").
STORAGESize in GiB of the camera storage [8..4000 GiB] The value must be multiple of 4 GiB, or will it be rounded down.
REC-MAXAGEImages older than this value are deleted [NOMAX, 0, 1..365 day]. When 0, the recording is disabled and only LIVE view is available. When NOMAX, images are kept up to the storage limit.
IDLE-REC-INTERVALTime interval between images capture during non-alarm periods (idle) [1..3600 s].
MIN-ALARM-DURATIONMinimal duration of high frequency recording when the alarm
condition is detected [10..3600 s] It will be extended up to
MAX-ALARM-DURATION if the alarm condition is
detected again during the ALARM-DURATION
period.
MAX-ALARM-DURATIONMaximal duration of an alarm event [10..3600 s].
ALARM-HOLDOFFIf an alarm is terminated by
MAX-ALARM-DURATION an holdoff is introduced
before the next alarm is allowed [0..3600 s].
LIVE-REC-DURATIONThe maximum duration of LIVE mode recording [10..3600 s].
NOTIFY-ON-ERRORDesired notification on storage or device errors
[NONE, MAIL,
SMS, DISA-CB]. Values can be
joined using ',' (comma).
MAIL-FROMSender of alarm e-mail. "SYS" or "AUTO" or a valid e-mail address.
SYS: the mail sender configured in
CXGEN 'MAIL-SENDER' is used;
AUTO: a fixed value is used (e.g.
vs@<cp-prompt>);
e-mail address: max 128 ASCII
characters. Space not allowed.
MAIL-TOExternal or internal alarms e-mail recipient(s). Max 128 ASCII characters. Space not allowed.
SMS-CDOOutgoing called number for SMS. # or max 20 digits optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] attributes or the name of an IN list between single quotes (e.g. 'mylist')
DISA-USERName of an existing CtiDisa user for DISA CallBack. # or max 16 ASCII characters. Space not allowed. If the user is not configured, the (!) mark is displayed beside the name.
DISA-SERVICEName of an existing CtiDisa service for DISA CallBack. # or max 16 ASCII characters. Space not allowed. If the service is not configured, the (!) mark is displayed beside the name.
DISA-CDOOutgoing called number for DISA CallBack. # or max 20 digits optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] attributes. See also HELP ISDN ATTRIBUTES.
DISA-CGOOutgoing calling number for DISA CallBack. # or max 20 digits optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] and/or PI [a, r, m, q] and/or SI [y, v, w, z] attributes. See also HELP ISDN ATTRIBUTES.
The following command allows the administrator to change the configuration of the resource:
s p vs parameter:value...
| Caution |
|---|---|
To activate the changes made on the upper case parameters, execute the initialization command init res:vs; while to set act the changes made on the lowercase parameters a save conf and an Abilis restart are required (i.e. With warm start command). |
| Tip |
|---|---|
Interesting chapter: Section 70.24, “Rio/Rvs configuration”. |
Set the STORAGE parameter accordingly so that
there is sufficient recording space for all cameras.
[15:21:01] ABILIS_CPX:d p vsRES:Vs ------------------------------------------------------------------------ Run DESCR:Video_Surveillance LOG:DS ACT:YES max-rvs:4 max-cam:4 max-live:4 TOS:0-N wdir:C:\APP\VS\ storage-wdir:e:\vs\ -- Camera "SYS" values ------------------------------------------------- STORAGE:8 GiB REC-MAXAGE:14 IDLE-REC-INTERVAL:60 MIN-ALARM-DURATION:180 MAX-ALARM-DURATION:600 ALARM-HOLDOFF:600 LIVE-REC-DURATION:600 -- Notifications ------------------------------------------------------- NOTIFY-ON-ERROR:NONE -- Mail ---------------------------------------------------------------- MAIL-FROM:AUTO (vs@abilis_cpx__) MAIL-TO: -- SMS ----------------------------------------------------------------- SMS-CDO:# -- Disa Voice Call ----------------------------------------------------- DISA-USER:# DISA-SERVICE:# DISA-CDO:# DISA-CGO:# [15:22:14] ABILIS_CPX:sys disk infoLogical drive(s) information: Drv Disk Label FS Free space Used space Total space Interface Sectors per block Cluster size Bootable ------------------------------------------------------------------------------- C: HD-12 FAT32 172 MiB 309 MiB 482 MiB AHCI 4,096 bytes YES ------------------------------------------------------------------------------- D: HD-13 FAT32 298 MiB 195 MiB 494 MiB AHCI 4,096 bytes YES ------------------------------------------------------------------------------- E: HD-14 vs-store FAT32 2571 MiB 73728 MiB 76300 MiB AHCI 65,536 bytes NO -------------------------------------------------------------------------------
The default value of STORAGE is 40 GiB, and if you have an HDD of 80 GiB, you will the possibility to activate by default only 2 RVS in the normal state. The third RVS, in this case, will display in diagnostic LIVE-ONLY.
[14:27:29] ABILIS_CPX:d d rvs-3
RES:Rvs-3 ---------------------------------------------------------------------
Ufficio_3
STATE:UP MAC:B8-27-EB-86-F1-3B IPRES:Ip-2
RemAdd-RemPort:192.168.166.120-41414
HW-DESCR:Raspberry Pi 3 Model B Rev 1.2 HW-ID:r3-1.2
CURRENT-IMAGE:5.1 FACTORY-IMAGE:5.000 BOARD:0.0
- Digital Input Lines State --------------------------------------------
1.. 4| ON ON 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 LIVE-ONLY 0 NO NO 0 0
------------------------------------------------------------------------The same error "LIVE-ONLY" will be displayed in other problems with storage, if the disk is full, or the HDD doesn't work, or bad configuration.
Type the following command to see if the storage is configured.
[14:49:16] ABILIS_CPX:d vs storage
Storages: 0
---------+-------+--------+----------------------------------------------------
RES | CAM | Orphan | Size
---------+-------+--------+----------------------------------------------------
*** NO STORAGE ***
*** NO STORAGE FOUND ***
If you have this error, please verify if the
storage-wdir is configured. In a normal situation
the previous command must display storages:
[15:49:35] ABILIS_CPX:d vs storage
Storages: 2
---------+-------+--------+----------------------------------------------------
RES | CAM | Orphan | Size
---------+-------+--------+----------------------------------------------------
Rvs-1 | Cam-1 | | 40,959 MiB
Rvs-2 | Cam-1 | | 40,959 MiBA useful command is the following:
[14:50:54] ABILIS_CPX:d rvs-1 log
CURRENT EVENTS LOG MASK: DFT (ERR+INFO)
Current Local Time: Thursday 29/08/2019 15:03:21 (UTC+02:00)
Date Time Event Event detail
------ ------ ----- ------------------------------------------------------
280819 201758 Info STORAGE INITIALIZATION STARTED FOR CAMERA:1
280819 201758 Info STORAGE INITIALIZATION FAILED CAMERA:1
280819 201758 Info STORAGE INITIALIZATION FAILED CODE:working directory not
configuredIn this situation, verify the storage-wdir
parameter.
If the disk is full and not enough free space you will see the following error:
[14:50:54] ABILIS_CPX:d rvs-1 log
CURRENT EVENTS LOG MASK: DFT (ERR+INFO)
Current Local Time: Thursday 29/08/2019 15:03:21 (UTC+02:00)
Date Time Event Event detail
------ ------ ----- ------------------------------------------------------
290819 150905 Info STORAGE INITIALIZATION STARTED FOR CAMERA:1
290819 150905 Info STORAGE INITIALIZATION FAILED CAMERA:1
290819 150905 Info STORAGE INITIALIZATION FAILED CODE:not enough free space
to setup the cameraIn this case, verify the STORAGE
parameter.
| Note |
|---|---|
If you can't resolve the issue with storage, please consult
Abilis support ( |
| |  | |
| Chapter 54. VS - Video Surveillance |  | 54.2. VS tables |