VDG Sense Quick Start Guide 2.4 – English

Knowledge Base - Quick Start Guides (archive)
2.4 - 10/02/2016
Print

Chapter 1 – Introduction

Video manuals regarding the topics discussed in this guide are available at https://support.tkhsecurity.com/downloads/manuals/

This manual explains all necessary steps required to create a fully functional Sense installation in a relatively short time. It assumes a simple standalone or single-server, single-client setup where all components are configured and accessible via the network:

  • IP cameras are configured with IP address
  • Sense Client is configured with IP address
  • Sense Server is configured with IP address

Sense Standalone installation:

 

Sense Server-Client installation:

 

Chapter 2 – Installation

The installation program SenseSetup.exe is required to install Sense. It can be downloaded in the support section on the https://support.tkhsecurity.com/downloads/software/ website. It is a single executable installer with all necessary components to install Sense as server, client or standalone system. The diagram below shows the items Sense Setup contains.

 

2.1 Versioning

The first page shown after starting Sense Setup is the version info page. It shows version information of all included and installed Sense components.

 

2.2 Standalone installation

Select both ’Client’ and ’Server’ options to install Sense as a standalone system. It will install the following Sense components:

  • Sense Server
  • Sense Client
  • Sense Manager
  • Sense Monitor
  • Sense Player
  • Sense SystemInfo
  • Postgres database

 

2.3 Server installation

Select ’Server’ option to install Sense as a server. It will install the following Sense components:

  • Sense Server
  • Sense Manager
  • Sense Monitor
  • Sense SystemInfo
  • Postgres database

 

2.4 Client installation

Select ’Client’ option to install Sense as a client. It will install the following Sense components:

  • Sense Client
  • Sense Player
  • Sense SystemInfo

 

2.5 Update

The installation package Sense Setup is also used to update the Sense software to a newer (or lower) version. Use the same procedure as described in paragraph 2.2, 2.3 and 2.4. Keep in mind that an update will not remove the license and settings.

Chapter 3 – Login

Before using the Sense software an operator needs to login. After starting the Sense Client the login dialog is displayed first.

image 5

 

It contains the following items:

  • Language bar to choose the language which is used in Sense
  • Server address field
  • Sense credential fields
  • Settings button (lower left corner) for autostart and autologin settings
  • Login button

Sense automatically finds available servers in the network, this also includes the local system. Click the down arrow on the right side of the login address field to show the list of Sense servers. If the server is not automatically found the IP address or host name of the Sense server can be entered manually. To login click on the green button in lower right corner of the dialog.

The default Sense administrator account credentials are as follows:

Name: administrator
Password: !DVadmin

3.1 Autologin

Sense Client can be configured to launch automatically on Windows startup (after windows login) and to automatically login to a Sense Server. Click the gear wheel in the lower left corner of the dialog to open the settings. It contains the following items:

  • Language bar to choose the language which is used in Sense
  • Checkbox to enable automatic login
  • Default server address and default user credential fields
  • Checkbox to automatically launch Sense Client on windows startup (after login)

image 6

3.2 Menu

After login the main application starts by showing the top menu bar and optionally a default (multi) layout if configured.

Top menu after login

image 7

 

From left to right the top menubar functions are as follows:

  • Eye icon: Open menu or go to live mode
  • Tools icon: Go to settings
  • Lock icon: Open dialog to close or logout Sense Client
  • Monitor icons: List of local and remote monitors
  • Date and time: Current date and time of Sense Client system
  • Sense logo: Displays ”Sense about”, which displays Sense Client version and other information

Eye icon, open the treeview Menu by clicking the eye icon:

image 8

The menu functions are explained in chapter 6

Tools icon, open Settings menu by clicking the tools icon:

image 9

All Sense settings are grouped by tabs, how to use them is explained in following chapters.

Lock icon, open logout/close menu:

image 10

Select ’Close’ to close the Sense Client application and select ’Logout’ to logout and open the login dialog for another user to login or to change the current Sense language.

Chapter 4 – License

Sense is protected by a software license key. In order to run this product a software license file is required. As Sense Server does not have a graphical user interface the license needs to be uploaded using Sense client. The license key can either reside on the license USB card or provided by e-mail.

 

4.1 Upload license

Activation is the process by which the software and license key are validated, to ensure that they are used in accordance with the purchased license and services. Activation is intended to protect your end user rights as well as TKH Security’s rights as a software author. Only genuine Sense software entitles you to critical updates and technical support. You may not be able to use Sense software if it is not activated.

 

 

 Requirements

  • A Sense Client and Sense Server installation, Since Sense Server has no graphical user interface, you need to activate the Sense Server software via a Sense Client.
  • A Sense license key, The license key file may be provided on a USB card or by email. The USB card should be inserted into the Sense Client platform machine (not the Sense server). You can also manually enter the license key by pasting or typing it into the license key field of the activation wizard.
  • An internet connection, The Sense Client needs an internet connection for the activation process, as well as being able to connect to the Sense Server over the network. Note that the Sense Server does not require any internet connection.

 Upload License key

  • Open the activation wizard by selecting the server to be activated in the Sense Client config, then click the ’Enter the license key’ button.

image 12

 

  • When the USB card is inserted into the Sense Client platform machine, it will automatically recognize the license key file. In the other case, you will have to browse for a license key file or enter it manually.

image 13

 

  • When clicking the ’Verify’ button, the key parameter will be sent to the Sense Server. If verification is successful, you can use your Sense software for ten days. After ten days you need to complete the activation process to continue using Sense software.

image 14

 

4.2 Activate license

4.2.1 Online activation

  • To activate your software you will need to provide a valid email address. Your license file will be emailed to this address.

 

image 15

  • After clicking the ’Activate’ button, you need to confirm (click the ’Confirm’ button) the summary in order to complete the activation of your software.

image 16

 

  • When successfully activated the software license status changes and will be able to display more detailed license features.

image 18

 

4.2.2 Offline activation

  • To activate your software you need to save the activation file to a USB stick or drive. Click the ’Save’ button. You can also copy the contents of the activation file

image 17

 

 

Create license file

  • To retrieve an activated license file you need to transfer the activation file to another computer with an internet connection. On this computer you can access the Sense licensing portal at the following link https://service.vdgsecurity.com/en/licensing/activate.

image 19

 

  • After you completed the activation wizard on the Sense licensing portal, you need to save the license file to a USB stick or drive.

image 20

 

Save license file

  • To finish the activation process, you need to load the saved license file from the Sense licensing portal (stored on the USB stick or drive). You need to confirm the license file in order to complete the activation of your software.

image 21

 

  • When successfully activated the software license status changes and will be able to display more detailed license features.

image 18

 

Chapter 5 – Setup mode

Sense settings are visible after clicking the toolset icon in the topbar menu. Settings are grouped in tabs where each tab holds specific settings related to the name of the tab. Normal procedure to setup a Sense system is to work through the setup tabs from left to right, starting with the server tab and ending with user management. Configuration is normally done using the administrator account.

5.1 Servers

The server tab holds the list of servers and settings related to the selected server. From left to right you see the serverlist, the cameralist of the selected server, settings of the selected server and server statistics related to CPU, memory, network and harddisk load.

image 22

 

 5.1.1 Add via find

Click ’Find’ in the lower left corner of the screen to open the find dialog. After a few seconds it shows the list of all servers found in the local network on all NIC’s. Select the server(s) and click ’Add’ to add selected server(s) to the configuration and close the dialog.

image 23

 

5.1.2 Add manually

To add a server press ’+’ in the lower left corner of the screen. Enter the server address in the dialog which appears. On a standalone system the localhost server (127.0.0.1) is automatically added to the list. In a server-client configuration the server is also automatically added to the list after login.

image 24

 

5.2 Devices

A list of Sense-compatible devices can be found here: https://support.tkhsecurity.com/compatibility-list/camera/

The ’Devices’ tab contains the list and configuration of devices for the selected server. The server can be selected just below the ’Server’ tab.

image 25

 

The devicelist has three sections which are from left to right:

  • Cameras (camera icon): the camera list
  • Intercom servers (circle with lines icon): list of intercom servers
  • I/O devices (four dots icon): list of I/O devices

The settings for each camera are divided into 4 sections which are from left to right:

  • General: basic settings which are needed to connect to a camera
  • Advanced: advanced configuration options like multicast (if available)
  • PTZ: settings to configure PTZ
  • Live: fullscreen view to help focus the camera

5.2.1 Add via find

Click ’Find’ in the lower left corner of the screen to open the find dialog. After a few seconds it shows the list of all devices found in the local network on all NIC’s, including intercom servers and IO devices. Select one or more cameras and click ’Add’ to add selected devices to the configuration. It will also close the dialog.

image 26

 

 5.2.2 Add manually

Click ’+’ in the lower left corner of the screen to add a new device to the list.

image 27

 

Fill in all required fields to connect to the device. See the list below for explanation on the fields.

  • Name: The name of the device.
  • Location: The name of the physical location of the device.
  • Type: The device type or brand.
  • Address: The IP-address of the device to which Sense should connect.
  • Port: Port number, is set to default value when devicetype is chosen.
  • Video channel: Video channel number of the device, mainly used if the device is an encoder
  • User name: Username used to connect to the device.
  • Password: Password used to connect to the device.
  • Max Storage (hours): Maximum storage duration in hours (for video). This is set to 99999 by default, which means no maximum. If the storage volume is not big enough to hold the maximum storage duration, the actual duration will be less. This can be verified in the ’Statistics’ tab.
  • Angle: Video rotation if the camera is mounted under a different angle.
  • Codec: Videostream codec Sense tries to get from the camera. NOTE: some cameras require the codec to be configured in the webpage of the camera (first stream).

After all configuration fields are configured correctly, click ’Apply’ in the lower right corner of the screen. After a few seconds you should be able to see a live video. If not please review the settings again.

5.3 Layouts

The ’Layouts’ tab is used to configure all (multi)layouts. Layouts are required in live mode to display live or recorded video or to handle (video)events. They can be custom designed to fit the needs of the operator. When opening the ’Layouts’ tab the setup tabs are hidden and the ’Layout Manager’ is opened. The layout manager is a floating menu which is used to create, delete and modify (multi)layouts and panels.

A layout consists of panels where each panel has a specific function. For instance a panel can be used to display live video, recorded video, to hold playback controls, display a map or to manage events. The complete list of panel types can be found in the ’Type’ list in the panel section of the ’Layout Manager’.

image 28

 

5.3.1 Live layout

Click ’New’ in the ’Layouts’ menu of the ’Layout Manager’, the following dialog will appear:

image 29

 

Several layout-templates are available in order to be able to quickly create new layouts. Select template ’Live 2×2’ in the template list to create a layout for 4 cameras. Select the resolution of the monitor on which the layout should be displayed and choose a name for the layout. Click ’Ok’ to create the layout and close the dialog.

image 30

 

It should be taken into account that layouts are created for a specific resolution, they cannot be resized after they are created. This layout consists of 4 live-panels. The icon in the lower left corner of each panel identifies the type of panel. A panel for live video uses a camera icon as identifier. After selecting a panel its properties are shown in ’Panels’ section of the Layout manager. To assign a camera to the selected panel select the camera in the ’Camera’ list of the panel properties.

5.3.2 Playback layout

Click ’New’ in the ’Layout’ menu of the layout manager, a dialog will appear:

image 31

 

Select template ’Playback 2×2 with controls’ in the template list to create a layout for simultaneous playback of 4 cameras. Select the resolution of the monitor on which the layout should be displayed and choose a name for the layout. Click ’Ok’ to create the layout and close the dialog.

image 32

 

This layout is composed of 4 playback-panels and controls to actually playback recorded video. The panel to display recorded video uses a green triangle icon as identifier. The playback controls uses a play/stop icon as identifier. To assign a camera to the selected panel select the camera in the ’Camera’ list of the panel properties.

5.3.3 Multi layout

A ’Multi Layout’ is a group of layouts with a pre-defined monitor selection. It is used to quickly assign several layouts at once to different monitors. To create a multi-layout click ’Edit’ in the ’Multi-Layout’ menu of the layout manager, a dialog will appear:

image 33

 

On the left side of the dialog is the list of multi layouts. Multi layouts can be added, removed or edited by using the buttons below the list of ’Multi layouts’. On the right side of the dialog is the list of monitors which belong to the selected multi layout. Monitors can be added or removed using the buttons below the ’Layouts’ list. The monitor numbering corresponds to the monitor numbering in the ’Monitors’ tab and in the top menu bar. To assign a layout to a monitor, select one from the list of layouts next to the monitor icon. NOTE: a layout only can be assigned once per multi layout. When finished click ’Close’ to close the dialog.

 5.4 User Management

Sense User Management provides the administrator with the ability to control the access level of users logged in to Sense. Access to cameras, servers, layouts and several other functions can be limited to groups of users. In Sense this is called a ’User Group’, it holds the privileges of users assigned to the group.

5.4.1 Users & Groups

The Users & Groups is used to manage all user related settings in Sense. On the left side of the screen is the list of user groups. User groups can be added, removed or modified using the buttons below this list user groups. On the right side of the screen are the privileges which can be assigned to the groups, divided by subtabs.

image 34

 

Click ’+’ below the group list to add a user group, a dialog will appear where the name of the user group can be entered. Click ’Ok’ in the dialog to create the group and close the dialog.

Create User:

Click ’+’ below the ’Users’ list in the users subtab to create a user. A dialog appears where the name, username and password of the user can be entered.

image 35

 

Create Devicegroups:

A devicegroup defines which cameras a user is allowed to see. Open tab ’Device groups’ to create a device group. On the left side is the list of created device groups. Using the buttons below the list devicegroups can be added, removed or edited. On the right side is the list of cameras.

image 36

 

Click ’+’ below the ’Device group’ list to create a devicegroup. A dialog appears where the name of the device group can be entered. Use a meaningful name, like ’All cameras’. Click ’Ok’ to close the dialog and add the device group to the list. Drag and drop the cameras from the cameralist on the right to one of the device groups on the left.

Assigning privileges:

If all users, layouts, multilayouts, servers and devicegroups are created, they can be drag and dropped to the corresponding usergroup. To remove a privileges select the it in the usergroup and Click ’-’ below the grouplist.

    Users: Add newly created user
    Servers: Add the server with address ’192.168.5.10’
    Device groups: Add newly created devicegroup
    Multilayouts: Add the layout ’Live & Playback’
    Layouts: Add the layout ’Live 2×2 and ’Playback 2×2’
    Functions: Add the function ’Live’

End result:

The end result should look like this:

image 37

 

Chapter 6 – Operator mode

Click following link to see the video manual: https://support.tkhsecurity.com/downloads/manuals/

Live mode or ’Home’ is accessed by clicking on the ’Eye’ icon on the upper left corner of the screen of the first monitor. This icon is also used to open the menu where Layouts can be selected. See below for a screenshot of a multi-monitor setup. The left monitor shows a layout with live cameras and the right monitor shows a layout for playback. These are the layouts which are created in ’Setup’ mode.

image 38

 

6.1 Treeview Menu

The menu is accessed by clicking on the ’Eye’ icon on the upper left corner of the screen of the first monitor.

image 39

It contains the following items:

Multi Layouts: Contains all multi-layouts available for the currently logged in user. Selecting a multilayout will update all monitors which are configured in this multi-layout.

Layouts: Contains all layouts available for the currently logged in user. Selecting a layout will update the currently selected monitor with this layout.

Fixed Layouts: Contains all fixed-layouts available for the currently logged in user. Selecting a fixed-layout will update the currently selected monitor with this layout. A fixed-layout is a pre-defined layout with specific functions:

  • Database, maintains person list for use with CarR and FaceR algorithms. FaceR and CarR are available if included in the license.
  • Sense Match, eventlist for use with FaceR algorithms.
  • Sense Search, provides functions to search for events and meta data.

Cameras: Contains all cameras available for the currently logged in user sub-grouped by location names. The subgroup ’All locations’ contains all cameras. Selecting a camera will update the currently selected videopanel in the layout.

Monitors: Contains all local monitors and the remote monitors available for the currently logged in user. Selecting a monitor will change the focus of the monitor.

Camera Sequences: Contains camera sequences for the currently logged in user.

System: Contains link to ’System Events’ dialog and ’Tagged Video List’ dialog.

6.2 Live

image 40

This layout contains 4 live panels where each panel has the following features:

  • Record icon: in lower left corner, indicates panel is live panel. Red means video is recorded, grey means video is not recorded.
  • Audio icon: next to recording icon, only visible if there is audio available in the videostream (panel should be selected to hear the audio).
  • Camera name: next to recording icon, the camera name.
  • Motion detected: next to camera name, indicates current motion percentage.
  • Digital zoom: hold left mousebutton or scroll and move cursor over the videopanel.
  • Double click on panel: switch panel to full screen or switch camera to ’Target panel’.
  • Green focus ring: currently selected panel, used for camera selection.

6.2.1 PTZ controls

The live control panel is needed to control PTZ domes. This panel can be pre-configured in a layout, but it will also automatically appear after double-clicking on a videopanel with a PTZ device; the camera will be displayed in fullscreen mode including the dome controls. PTZ commands are sent to the camera which is currently selected (which has a green border).

image 41

 

To pan and tilt a ptz camera hold the left mouse button and move the cursor over the orange dial. The speed of the dome is determined by the cursor-distance from the center of the dial; close to the center the speed is low, on the outside the speed is high. The buttons have the following functions:

  • image 42 Focus near.
  • image 43 Focus far.
  • image 44 Switch auto focus/auto iris on.
  • image 45 Zoom in.
  • image 46 Zoom out.
  • image 47 Open iris.
  • image 48 Close iris.
  • image 49 Go to preset ‘Home’.
  • image 50 Go to preset 1.
  • image 51 Rotate 180 degrees.
  • image 53 Save the current position of the dome as a preset.
  • image 52 Go to the selected preset in the list.
  • preset Opens the preset dialog to give each preset a name.

 

6.3 Playback

image 54

 

This layout contains 4 playback panels and playback controls where each panel has the following features:

  • Green triangular icon: in lower left corner, indicates panel is playback panel
  • Audio icon: next to recording icon, only visible if there is audio available in the videostream (panel should be selected to hear the audio).
  • Camera name: next to recording icon, the camera name.
  • Date and time: next to camera name, date and time of displayed image.
  • Digital zoom: hold left mousebutton or scroll and move cursor over the videopanel.
  • Doubleclick on panel: switch panel to full screen or switch camera to ’Target panel’.
  • Green focus ring: currently selected panel, used for camera selection.

6.3.1 Playback controls

image 55

 

The Playback controls panel is needed to playback recorded video. It has two trackbars where the top bar has a resolution in days and the lower trackbar has a resolution of 24 hours (of the selected day). The playback speed is set by the ’red-green’ trackbar; red is backwards, green is forwards. The date and time on the left and right side of the trackbars correspond to the first and last recorded video image of the cameras which are visible in the layout. From left to right the function of the buttons are as follows:

  • image 56 Go to the beginning of the recordings of the cameras visible in the layout.
  • image 57 One minute backwards
  • image 58 One frame backwards.
  • image 59 Playback backwards. For streaming codec video only I-Frames are played back.
  • image 60 Stop playback.
  • image 61 Playback forward.
  • image 62 One frame forwards.
  • image 63 One minute forwards.
  • image 64 Go to the end of the recordings of the cameras visible in the layout.
  • image 65 Opens the date time search panel.
  • image 66 Set export range, explained in section 6.3.2 on exporting video.
  • image 67 Enable audio playback and set playback speed to realtime (panel should be selected to hear the audio).
  • image 68 Opens the export image dialog, explained in section 6.3.3 on exporting images.
  • image 69 Opens the export video dialog, explained in section 6.3.2 on exporting images.

 

 6.3.2 Export Video

Recorded video (and audio) can be exported to different media: CD/DVD, hard drive, USB stick or network share. A single export can hold video of multiple devices from multiple servers in the same time range. The video itself is exported in Sense format, it is not transcoded to a generic codec. The export comes with a program called ’Sense Player’ which is used to playback exported video. To open the ’Export Video’ dialog press the export video button in ’Playback Controls’.

image 70

 

  • Servers: List all available servers. Select server to display cameras from that server in the cameralist.
  • Cameras: List of cameras from the selected server. Select camera and press ’>’ button to add camera to list of cameras for export.
  • Start and end time: Start and end time of the export. These can be modified regardless whether the range of the trackbar is used or not.
  • Reset date and time: Reset time range to initial values.
  • Full date/time range: Set time range to beginning and endtime of all recorded video of selected cameras.
  • Include Sense Player: Include software to playback the exported video, on by default.
  • Export location: Destination of the exported video. Click ’…’ to select the path. The free space of the export location should be large enough to hold the exported video.

There are two ways to define the time-range of an export; using the playback controls trackbar or using the start/endtime edit box in the video export dialog:

Timerange using trackbar:
Click ’E’ in the playback controls panel, three buttons appear: ’Start’, ’Clear’ and ’Stop’. Set the thumb-tracker to the starting point of the video that needs to be exported and click ’Start’. Set the thumb tracker to the end point of the video that needs to be exported and press ’Stop’. The time range is highlighted in green. To clear the selection and start over click ’Clear’. After defining the range open the video export dialog. The camera(panel) which has focus will automatically be added to the list of export cameras. The begin and end time are also set automatically.

image 71

 

Timerange using dialog:
Video can also be exported manually without using the trackbar to define the time range. When opening the export video dialog it will use the current playback time (position of thumbtracker) and set the start time with current time minus 5 minutes and end time to current time plus 5 minutes. The camera(panel) which has focus will automatically be added to the list of export cameras.

 6.3.3 Export Image

Single images or snapshots can be exported from recorded video to a PDF document which can be stored to any windows storage location (like a USB stick). The PDF report contains information about the exported image and comments which can be entered in the Export Image dialog. To create a report select the playback panel with the image that should be exported and click the ’Disk’ button in the ’Playback Controls’ (see section 6.3.1 on playback controls), it will open the dialog as shown below:

image 72

 

  • Image to export
  • Option to add pre and post images Check this option to add 2 pre images and 1 post image to the report.
  • Information about the image including camera name, date and time of the images and which operator has exported the image
  • Comments field: Enter some comments.
  • Path and filename: Target location for report, click ’…’ button to change path and filename.

 

 


Related articles

quick-start-en