0. Software Download

The software is available for free download from Google Drive and BaiduNetdisk.

The software supports only 64-bit operating systems.

We recommend using Windows 10 or later, or Ubuntu 18.04 or later.

The Kylin system and OpenEuler system provide support on a licensing basis.

1. Introduction

1.1 Main functions

TVMS Software is a Video Management Software for Tofu Products, can support functions including video display, video playback, GIS, log query, system settings and dashboard.

Provide AI functions such as target recognition, automatic tracking, manual tracking, target counting, moving target tracking. and PTZ control, video storage, image capture are also combined in the software.

1.2 Software Version and Copyright Statement

©️Copyright

The content presented in this document, including but not limited to text, images, graphics, videos,  software, and any other form of information or material  is the sole and exclusive property of Tofu Intelligence and is protected under international copyright laws and treaties.

1.3 Keyboard Shortcuts

For commonly used functions, the following keyboard shortcuts are provided.

Shortcut keys can be customized, please see chapter 9.

2. Device Management

2.1 Main Menu

The main menu of TVMS includes video monitoring, video playback, electronic map, message recording, and system setup.

The functions can be switched through the menu items above the window.

Video Display

Video Playback

Local Map

Online Map

Image Map

Satellite map analyse

Dashboard

Panorama

System Settings

2.2 Device Management

2.2.1 Device Addition

The devices default to the 192.168.1.** subnet, with a default IP address of 192.168.1.200 at the time of shipment.

Automatic search is supported when the client computer can directly access this subnet without a router or across subnets.

As shown in Figure, in the ‘Setup’ submenu, click 'Camera'.

Click the "Search" button at the top to activate the search function at the bottom.

If you have multiple network cards, please select the one connected to the devices.

Enter the default username and password (default is 'admin', 'admin'), then click 'Search All'.

If the network connection is successful, you will see the devices listed on the left side.

Click the 'Add Selection' or 'Add Current' button to add the specific devices to your working list.

After verifying the details, click 'Save'.

If you use router or in the world wide network or use VPN, devices can't be searched directly.

You need to add the devices manually.

Click '+Add' button, will show a new device on the list, then enter your own device 'AI Port' and 'Main Stream' address.

If you use router please activated the 'External' option.

Manufacture can be selected as 'Camera' or 'AI-Camera'. Using 'Camera' option can just see the video stream, Using 'AI-Camera' option can control the Tofu device's working mode and all settings.

2.2.2 Video preview

The devices add in the working list will be displayed in the device list, when switch to the 'Video' submenu.

Double-click the device's 'Main stream' to display the video. If the device connection is successful, the video will be shown in the subwindow of the display area, and the device icon will turn white (indicating a successful connection).

The video channel supports drag and drop operation, which can easily change the disaplay sub window location.

 If you need to turn off the video, you can click the "Close" button above the video window.

For devices in dual-video input mode, you can switch between different picture-in-picture(PiP)modes by clicking the display mode button in the“Device Control”—“Picture-in-Picture Mode”section on the right side.

The supported display modes include:

• Visual in Thermal(Large thermal image with visual content)

• Thermal in Visual(Large visual image with thermal content)

• Full Visual(Full visible light image)

• Full Thermal(Full infrared image)

• Fusion(Fusion mode)

Note that the Fusion mode is only supported on our company's integrated devices.

2.2.3 Change Device IP

Click the device on the 'Device List' or click the video on the display area, then click 'Settings' button.

In the IP address area at the bottom left of the pop-up window,the IP address of the current device is displayed.

Can modify it to the desired IP address, and then click the "Update" button, the device will be restart. The device that changed IP, need to be readded to the 'Device List'.

2.2.4 Input Video Stream Configuration

If you use independent IP Camera, Tofu device will need a RTSP stream to run the AI functions.

Write the  RTSP stream address in the blank, then click 'Update', device will restart and display the video if succeed, otherwise will show a whole blue or green screen shot in the video.

• Note 01: RTSP address formatrtsp://UserName:Password@ip:554/…

• Note 02: Please note whether the account and password are correct when entering the RTSP address

2.2.5 Device Software Upgrade

Select a device and click 'Settings'.

Click "Firmware Upgrade" then select the upgrade '.dev' file.

Click 'Open' then the upgrade will start, can see the percentage progress of the upgrade.

Do not change anything until finish upgrade. After finish transmite the upgrade file, will pop up a window, shows it is succeed.

The device will auto restart and reconnect to the TVMS software.  

Note:

When the system upgrade progress is not updated for a long time:

1. 1. Close the firewall of OS;

   2. Check the network is working;

   3. Turn off antivirus software

2.2.6 Device Restart and Reset

Select the device ‘Settings’. Click the "System Restart" button. TVMS will automatically reconnect the device after restart.

The 'System Reset' function is used to restore all parameters to default values, please use it very carefully.

2.2.7 Zoom List Upgrade

Only camera using motorized-lens need to upgrade the zoom list.

In order to adapt to the PTZ speed under different magnification of visible light, the lens magnification table can be imported to achieve adaptive conditions.Select the device and open the parameter device interface corresponding to the current device, as shown in Figure 2-16. The magnification table is divided into visible light, infrared and laser. Please consult the technician for the magnification table. If you use a third-party visible light movement, please consult whether it supports this function.

3. Algorithm function

TVMS can manage the algorithms of Tofu, including: object detection, automatic tracking,  manual tracking,  moving target tracking, and gate tracking, fence area drawing and support setting all the parameters of tracking and PTZ control.

Typical algorithm features description:

3.1 Object Detection

Selected a device,then switch the AI mode to "Object Detection" in the "Setup" area , and click the "Start" button.

There will be bounding boxes, after detecting objects.

3.1.1 Fence Area Drawing

The fence area is drawn in the video, and the AI camera only recognizes the targets in the area, and will not record the targets outside of the  area.

Click one device and click ‘Draw Area’.

Move the cursor to the video display area. The drawing steps are as follows:

1. Double click the left mouse button (start to draw a new fence area), and the mouse cursor will become the drawing state

2. Left click to select the fence inflection point 01

3. Left click to select the fence inflection point 02

4. Left click to select the fence inflection point N (less than or equal to 6)

5. Double click the left mouse button (end drawing the new fence area), and the mouse cursor will be restored to its original state.

After drawing, click the "End Draw Area" button to end the whole process of drawing the fence.

Note: The fence area can only have one, and the fence area coordinate inflection point is less than or equal to six.

The video after drawing the fence area is shown as follows:

 

 

 

 

 

 

 

 

 

3D fence area manage

Click the "Clear Fence" button to clear the fence area.

3.1.2 Detecting Class Configuration

AI cameras support target recognition of people, vehicles, ships ,drone and other customized objects, using different models.

If the names of objects are different from default names, also can be changed in the 'Setup' - 'General'submenu.

You can change the names of objects in the 'Detecting Objects'. The name is depends on the real-model used.

We provide several common models in Tofu，that can be switched in the 'Settings'-'AI Model Type'.

Note: Not all the models shown are supported, different Tofu series include different models. 

Can confirm it with sales.

3.2 Automatic Tracking

Using the automatic tracking mode, tracking will start by itself, after the Tofu device detect one or more objects.

If the Tofu device has PTZ control permission, will sends a PELCO-D/LPP command to control the PTZ, so that keeping the object in the center of the video.

Switch the AI mode to "Auto Tracking", and click the "Start" button, then the mode is activated.

3.3 Tracking Parameters

Select the video of display area, click "Setting" button, then can manage the parameters of tracking.

Figure  Tracking Settings Parameters

Parameter name	Default Parameters	explain
Start frame	5	The PTZ operates at a relatively low acceleration within the set frame number,25 frames/second video frame rate as reference, 5 corresponds to 200ms time
Max speed	2000	The maximum speed level of control, depends on the PTZ speed
Speed gradient	300	During the tracking process, the speed controlling gradient
Diff Coef	55	Control differential adjustment coefficient, 55 by default
Int Coef	0	Control integral adjustment coefficient, default 0
Manual speed	3	Manual control speed level
PTZ Protocol	PelcoD	PTZ control protocol, support PelcoD, ExPelcoD and LPP.

 

Figure  Tracking Process Parameters

Parameter name	Default Parameters	explain
Maintenance frame	80	Set value If there is no target recognition within the frame number, it is forced to judge that the target is lost
Auto-zoom Area	50	The picture center is the reference, and the auto zoom operation is performed within the setting value * 10 pixels. The auto zoom function plays a role when it is turned on.
Target Min Proportion	10	If the target size is less than the set value percentage of full frame, zoom lens will zoom in
Target Max Proportion	20	If the target size is greater than the set value percentage of full frame, the zoom lens will be reduced
Retracking delay	0	Time interval for re identification and tracking after target loss, in seconds
Auto-zoom	off	Whether the auto zoom function is enabled
Lost follow-up	off	Whether the PTZ continues to rotate in the original direction after the target is lost.

 

3.4 Manual Target Tracking

Can manually draw a rectangle to track.

Switch the AI mode to "ROI Tracking", and click the "Start" button.

Press and hold down the left mouse button and drag a rectangle in the video display area. Tracking will start while releasing the mouse.

3.5 Moving Target Tracking

Moving target can be detected and tracking in the fence area.

Switch the AI mode to "Motion Tracking" and click the "Start" button.

Press and hold down the left mouse button and drag a fence area rectangle in the video.

If there is a moving object in the area, it will be locked and tracked.

3.6 Auto data acquisition

The TVMS software provides an automatic data collection function.After selecting"Data Acquisition"in the AI mode,click"Start".

Enter the data collection interval in the pop-up window.It is recommended to set it at 10 seconds.Then click "OK".

During the data collection process,the picture saving button in the upper right corner of the channel video window will keep flashing,indicating that data is being collected.

To stop the data collection,simply switch the AI mode to another mode.The collected data is saved in the normal picture saving path that has been configured.The subfolder for the saved data is named"Date**/Ch*/collect/".

Examples of storage paths：

***\TVMS\image_normal\2025-01-23\Ch2\collect

4. Motion control

Motion control function includes: lens control, pan tilt control, lamp/IR mode control and data transmission.

The lens control includes zoom plus, zoom minus, focus plus, focus minus, lamp/IR mode on and off.

PTZ control includes PTZ left, top, right, bottom movement and stop.

Data fill in the blank can be transmitted to pantilt or camera directly. Receiving data also will be shown in the 'Receive' blank. 

TVMS provides Pelco-D,Expelco-D,LPP protocols to control the pantilt, that can be setted in 'Settings'-'PTZ Protocol'.

Speed of pantilt can be changed using 'Manual speed' parameter or drag and drop speed adjustment button.

4.1 Controller operation

TVMS supports the operation of PS controllers or Xbox controllers. The shortcuts and operation methods have already been configured. If you need to customize the buttons, you will need to reconfigure them in the shortcuts yourself. To enable the controller function, open the DS4Windows folder in the installation directory.

⚠️Controller operation is only supported on the Windows system.

First, install the driver and .NET. After the installation is complete,  restart your computer.

Once installed, run DS4Windows.exe as an administrator. Turn on your computer's Bluetooth(Wired controllers do not require this operation.), search for the controller, and connect it to use the controller operation.

The default shortcut button functions of the controller are shown in the figure below.

Customization of operation keys is supported. The customization function needs to correspond to the custom operation keys of TVMS.

5. Image operation

As shown in Figure 5-1, the device image operation includes video storage and image capture.

5.1 Video Storage

Click the icon button to start storing videos;Click the icon button again to stop video storage.The storage directory is in the "video_normal" folder of the software installation directory.If the "Alarm Video" function is selected, the manual video storage function will not be available.

5.2 Image Capture

Click the "current video screenshot" menu or "all videos screenshot" to start image capture.

Click the icon to capture the current video.

The storage directory is in the "image_normal" folder of the software installation directory.

5.3 Alarm Video

The "alarm video" is enabled. After an alarm occurs, the client will automatically store the video, and the length of the video is set by the "storage time".The storage directory is in the "video_alarm" folder of the software installation directory.

5.4 Alarm Screenshot

"Alarm Screenshot" function can be activated. After an alarm occurs, the client will automatically take a screenshot, and the time interval between screenshots can be set.The storage directory is in the "image_alarm" folder of the software installation directory.

As shown in Figure 5-6, the contents of the alarm screenshot can also be displayed in the "Image text alarm" sub window of the main interface.If there is an alarm, the display interval is one minute.Double click the alarm picture to enlarge and display the current alarm picture.

6. Device Map Information Management

6.1 Default Map Center and Level

The center position and magnification level of the initial map display can be setted in "Setup" - "General" - "Map Settings".

6.2 Location Setting

Select "Maps" - "Online Map" or "Local Map" to display the map of the setted area. The map supports mouse drag and wheel zoom functions for navigating and adjusting the map view.

Display the location of the device on the map by inputting its latitude and longitude information。

Or you can just click the point of map, latitude and longitute will change automatically in the blank, then select one device in 'Device No.', you want to locate.

Click the 'Update device pos' button, will refresh the position of the device.

6.3 Basic Parameters

The location of device also can be seen in the camera list.

For using map to control the device several parameter need to be setted.

• Max coverage distance
• Max Zoom Num
• Max View Degree
• PTZ Zero Point

6.4 Map and Device Integration

After setting the device parameters, the device can be directly controlled in the map, including pantilt movement, zoom in and out.

Click a device on the map. you will see the area, in light blue, that the device can reach to see and the current shooting area, in dark blue.

When you click a point in the light circle, the camera will automatically zoom in/out and moving the pantilt to the position, that clicked.

 

Double click the device on the map can open the video in a new pop up window.

If the PTZ Camera contains multi camera, the cameras in one device can be bounded together on the map, like above figure.

The light red circle is the area that the thermal camera can reach to see, and light blue circle is the visual camera can reach to see.

The dark red and dark blue area is now the thermal and visual cameras are shooting.

6.5 Satellite Map Analyse

TVMS supports detect objects in offline/online maps and tiles maps. 

7.Panorama

The panoramic scanning and stitching function is only applied to some of our company's integrated machine products.Please consult before using it.The panoramic scanning parameters of the pan-tilt camera have been calibrated at the factory.The corresponding configuration parameters will be provided with the equipment.Please do not modify them arbitrarily.

Clicking on“Load Panorama”allows you to manually load the previously stitched panoramic image.The blue box here represents the area of the current view within the panoramic image.

After clicking the“↑”expand button,you can see the fully expanded panoramic image.

The panoramic image does not necessarily need to cover a 360°range.The scanning range can be customized according to requirements.

For examplethe scanning range can be limited to 10°to 140°.

8. Dashboard

The Dashboard is displayed after clicking 'Playback' > 'Dashboard'. It is divided into four main areas for different types of data visualization.

At the top of the interface, the quantity statistics of different objects types are displayed. The left side shows the quantity bar charts for different time periods, and the right side shows the pie chart of objects quantity statistics.

Dashboard is calculated based on video channel numbers. Select the channel number and time period to be counted.

Now we support selecting two days as the time for statistics and comparison.

The basis for data statistics comes from the JSON communication between the Tofu device and TVMS software, so it is necessary to ensure stable communication during the process of recording statistical data.

The TVMS software internally calculates and updates the results every ten seconds. If the communication drops before the data update, it will affect the statistical results.

Before using this function please activate it in 'Setup'-'Dashboard' and reopen the TVMS software. 

All video channels, added in the video display window, can statistic data.

9. Shortcut Keys

Shortcuts keys can be customized. Click 'Setup'-'General'-'Shortcut keys'.

Select the corresponding function and press the keyboard button used for shortcut keys, click 'Save' to activate.

10. Software Licensing

The map and dashboard in TVMS software, as well as the inference part of the secondary deep learning algorithm, require authorization support. In order to facilitate your faster understanding of the software's functions, we will provide 30 days trial.

If you need device activation permanent authorization, please copy the computer ID in TVMS software and send to us.

After you get a license code, fill it in the 'License' blank area then click 'Activate'.

If activated successfully, a prompt window will pop up.

 

 

---