SIYI AI TRACKING MODULE USER MANUAL

SIYI AI TRACKING MODULE USER MANUAL Main - SIYI AI TRACKING MODULE USER MANUAL

Table of Contents

SIYI AI TRACKING MODULE USER MANUAL​

SIYI AI tracking module supports collaborative control with SIYI optical pods and gimbal cameras to achieve real-time tracking and capture of targets and can highlight the tracking target in the picture through real-time focus and zoom.

It supports the anti-lost function. During the tracking process, if the target is blocked or briefly leaves the monitoring screen, the AI tracking module can automatically recognize and continue tracking when it re-enters the monitoring screen.

To ensure you a good experience of the product, please read this manual carefully.

INTRODUCTION
Product Features
4T Computing Power

SIYI AI tracking module has a computing power of up to 4Tops @ INT8, has strong performance in processing big-data artificial intelligence calculations, supports real-time AI recognition and tracking control of drones in the air, and can be widely used in surveillance, agriculture, forestry and plant protection, environmental monitoring, logistics and transportation and many other popular fields.

Human, Vehicle, and Boat Recognition Multi-Target Monitoring

SIYI AI tracking module supports target recognition and tracking based on artificial intelligence technology, automatically recognize and record pedestrians, vehicles (including cars, trucks, and buses), and boats in the monitoring area, and support simultaneous monitoring of multiple targets.

Gimbal Camera Collaborative Anti-Lost Tracking

SIYI AI tracking module supports collaborative control with SIYI optical pods and gimbal cameras to achieve real-time tracking and capture of targets and can highlight the tracking target in the picture through real-time focus and zoom.

It supports the anti-lost function. During the tracking process, if the target is blocked or briefly leaves the monitoring screen, the AI tracking module can automatically recognize and continue tracking when it re-enters the monitoring screen.

Mini Size & Lightweight Abundant Features

Specifically optimized for drone application scenarios, the SIYI AI tracking module adopts a small size, lightweight, and low power consumption design. It also has Ethernet output and HDMI output video streams.

Interface & Pinouts

Image 011 - SIYI AI TRACKING MODULE USER MANUAL

Technical Specification

Compatible Optical Pods & Gimbal Cameras

ZT30 / ZT6 / ZR30 / ZR10 / A8 mini

Recognizable Object Types

Human

Auto Mobile (Car, Truck, Bus) Boat

Computing Power

4Tops @ INT8

Power Consumption

8 W

Working Voltage

11 ~ 25.2 V

3S ~ 6S

Video Stream Codec Format

H.264 / H.265

Dynamic Target Gimbal Collaboration

Lock Target Auto Zoom Center Target

Target Recognition / Locking Accuracy

95%

Working Temperature

-10 ~ 50 

Dimension

43.4*45.1*26.5 mm

Weight

60 g

Mark

Please format the SD card to FAT32 before the camera firmware upgrade.

Packing List

1 x SIYI AI Tracking Module

1 x SIYI Gimbal Power Cable (Power supply cable for SIYI gimbal)

1 x SIYI AI Tracking Module to SIYI Gimbal Ethernet Cable

(Connect SIYI AI tracking module’s Ethernet port to SIYI gimbal’s Ethernet port)

1 x SIYI AI Tracking Module to SIYI Link Cable

(Connect SIYI AI tracking module’s Ethernet port to SIYI MK15 / HM30 air unit’s Ethernet port)

1 x SIYI AI Tracking Module to SIYI Link Y Cable

(A Y cable that connects the SIYI AI tracking module with the SIYI MK15 / HM30 air unit for powering the AI tracking module, transferring video stream, and controlling signal)

Indicator Definition

There are two indicators on the SIYI AI tracking module to indicate the system’s working or abnormal status: power indicator and status indicator.

Image 013 - SIYI AI TRACKING MODULE USER MANUAL

Power Indicator

Solid Red: The module is powered normally.

Status Indicator

Solid Yellow: Under firmware upgrade.

Yellow Blinks: The camera is not connected.

Solid Green: The system is starting.

Green Blinks: The system is running normally.

Red-Yellow Blinks: Parameter resets successfully.

GET READY TO USE SIYI AI TRACKING MODULE
Typical Connection Diagram
ZT30

Image 021 - SIYI AI TRACKING MODULE USER MANUAL

ZT6

Image 022 - SIYI AI TRACKING MODULE USER MANUAL

ZR30

Image 023 - SIYI AI TRACKING MODULE USER MANUAL

ZR10

Image 024 - SIYI AI TRACKING MODULE USER MANUAL

A8mini

Image 025 - SIYI AI TRACKING MODULE USER MANUAL

SIYI AI tracking module supports target recognition and tracking. Recognizable target types are Human, Auto Mobile (Car, Truck, Bus), and Boat.

Function ON / OFF

1. Please refer to Chapter 2.1 in this manual to connect the SIYI AI tracking module with the SIYI gimbal and SIYI link.

2. Confirm if the gimbal camera’s firmware has been upgraded to be compatible with the SIYI AI tracking module.

3. Confirm if the SIYI FPV app has been upgraded to be compatible with the SIYI AI tracking module.

4. Run the SIYI FPV app, go to “Settings – Addresses”, and select “SIYI AI Camera”.

Image 026 - SIYI AI TRACKING MODULE USER MANUAL

5. Return to the main image, and touch the AI tracking function button to enable the function.

Image 028 - SIYI AI TRACKING MODULE USER MANUAL

6. Touch the button again to disable the function.

Mark

Using the SIYI AI tracking module with multiple-sensor optical pods, in the SIYI FPV app, the mainstream of the optical pod should be configured as a zoom camera.

Target Recognition

When the AI tracking module is enabled, and recognizable targets go in the image, they will be surrounded by white recognition boxes. A function is working normally.

Image 030 e1700465590568 - SIYI AI TRACKING MODULE USER MANUAL

Target Tracking

Touch the white recognition box in the image, the box turns blue, and the AI tracking function button turns green. The Gimbal camera starts to track the target.

Image 031 - SIYI AI TRACKING MODULE USER MANUAL

Mark

The zoom camera will zoom simultaneously during target tracking to keep the target displayed in the center of the image. And the zoom multiples will be displayed as well.

HOW TO CONFIGURE THE MODULE

SIYI AI tracking module can be configured through an SD card, and so does firmware upgrade.

Mark

It is suggested to format the SD card to FAT32 before the firmware upgrade.

It is suggested to insert the SD card into the AI tracking module and run it for a while, then you will see the files related to the module configuration.

Image 034 - SIYI AI TRACKING MODULE USER MANUAL

The two “.txt” files in the root category of the SD card are for checking and changing module configuration.

“curip.txt” for checking the current IP addresses. “setip.txt” for customers to change IP addresses.

IP Addresses
Check IP Addresses

Open the “curip.txt” file, you will see the current IP addresses and gateway of the AI tracking module.

Image 035 - SIYI AI TRACKING MODULE USER MANUAL

“192.168.144.60” is the factory default module IP address. “192.168.144.12” is the factory default module gateway.

Change IP Addresses

Open the “setip.txt” file, and input the IP addresses you need after “IP = ”.

Image 036 - SIYI AI TRACKING MODULE USER MANUAL

Image 037 - SIYI AI TRACKING MODULE USER MANUAL

Then insert the SD card to the module and power it. After three to five minutes,

the new IP addresses will be flashed into the module. Then we restart the module to finish changing IP addresses.

Mark

In the SIYI FPV app, the default IP address for “SIYI AI Camera” is “192.168.144.60”. After changing module IP addresses, it is necessary to manually input the relevant IP addresses in the SIYI FPV app to acquire video & data stream from the AI tracking module.

When you are using the SIYI AI tracking module with SIYI gimbals and SIYI links, please configure its IP addresses within “192.168.144.X” and avoid conflicting with their existing IP addresses. Please refer to the “Common IP Addresses” chapter in the SIYI link and SIYI gimbal manuals for details.

Client (Gimbal Camera) Addresses
Check Client Addresses

Open the “curip.txt” file, you will see the current client addresses and communication port of the AI tracking module.

Image 040 - SIYI AI TRACKING MODULE USER MANUAL

“192.168.144.25” is the current client address. “37256” is the client communication port.

Change Client Addresses

Open the “setip.txt” file, input the client addresses you need after “VideoAddress

= ”, input the communication port after “VideoPort = ”.

Image 041 - SIYI AI TRACKING MODULE USER MANUAL

Then insert the SD card to the module and power it. After three to five minutes, the new IP addresses will be flashed into the module. Then we restart the module to finish changing IP addresses.

Mark

The default IP address for SIYI cameras is “192.168.144.25”. If you have changed camera IP addresses, it is necessary to manually input the relevant client addresses for the SIYI AI tracking module to establish a video & data stream between the AI tracking module and the gimbal camera.

Firmware Upgrade
Check Firmware Version

Open the “curip.txt” file, you will see the current firmware version of the AI tracking module.

Image 043 - SIYI AI TRACKING MODULE USER MANUAL

Firmware Upgrade Steps

Before upgrading, it is necessary to prepare the tools, software, and firmware below.

SD / TF card

Mark

Customers should prepare the above tools.

SIYI AI Tracking Module Firmware

Mark

The above tools can be downloaded from the “Downloads” page on the SIYI official website.

Steps
  1. Save the module firmware’s “.bin” file to the SD / TF card’s root directory and do not change the file name.

Image 046 - SIYI AI TRACKING MODULE USER MANUAL

2. Insert the SD card with saved firmware into the SIYI AI tracking module and power it.

3. Wait for three to five minutes, camera firmware will be flashed automatically and disappear from the SD card.

4. Restart the module to make the configuration work.

Reset Module Configuration

You can reset the SIYI AI tracking module to the factory configuration by pressing the RST button for five seconds.

Common IP Addresses

SIYI AI Tracking Module’s Default IP Addresses: 192.168.144.60

SIYI Optical Pod / Gimbal Camera’s Default IP Addresses: 192.168.144.25 (NEW) SIYI Optical Pod / Gimbal Camera’s Default RTSP Addresses:

  • SIYI AI Camera: rtsp://192.168.144.60/video1
  • Main Stream: rtsp://192.168.144.25:8554/video1
  • Sub Stream: rtsp://192.168.144.25:8554/video2(NEW) SIYI FPV App’s Private Video Stream Protocol’s Addresses:
  • SIYI AI Camera: 192.168.144.60:37256
  • SIYI Camera 1 Main Stream: 192.168.144.25: 37256
  • SIYI Camera 1 Sub Stream: 192.168.144.25: 37255
  • SIYI Camera 2 Main Stream: 192.168.144.26: 37256
  • SIYI Camera 2 Sub Stream: 192.168.144.26: 37255
Mark

SIYI cameras were released after ZT30 (including ZT30) started to use the new addresses.

SIYI cameras released before ZT30 (including ZR30, A2 mini, A8 mini, ZR10, and R1M) are still using the old addresses.

5 SIYI FPV APP

SIYI FPV is an Android application developed by SIYI to configure many SIYI products for video display, camera stream settings, and communication link status monitoring.

Mark

This chapter is edited based on SIYI FPV App v2.5.15.679.

SIYI FPV App can be downloaded from the “Downloads” page on this official website (https://siyi.biz/en).

SIYI FPV App compatible SIYI devices
  • SIYI AI Tracking Module
  • ZT30 Four-Sensor Optical Pod
  • ZR30 4K AI 180X Hybrid Zoom Optical Pod
  • A2 mini Ultra-Wide-Angle FPV Gimbal
  • MK32 / MK32E Enterprise Handheld Ground Station
  • A8 mini AI Zoom Gimbal Camera
  • ZR10 2K 30X Hybrid Zoom Optical Pod
  • R1M HD Recording FPV Camera
  • Air Unit HDMI Input Converter
  • HM30 Full HD Image Transmission System
  • MK15 / MK15E Mini Handheld Ground Station
SIYI FPV App OSD Information Definition

Image 049 - SIYI AI TRACKING MODULE USER MANUAL

SIYI FPV Camera Function Icon Definition

Image 050 - SIYI AI TRACKING MODULE USER MANUAL

Settings

In the “Settings” page, you can select camera type with stream type, select or input video stream IP addresses, custom app interface, and switch video decoding type.

Image 051 - SIYI AI TRACKING MODULE USER MANUAL

About Settings

Camera IP: Select SIYI AI Camera, between SIYI Camera 1 and SIYI Camera 2, between main stream and substream, select or input video stream RTSP addresses, disable the image, or rotate the relevant image in 180 degrees.

Cross Sight: Enable/disable a cross sight in the center of the image.

Map: Enable/disable the map box over the left-bottom corner of the image. OSD Color: Customize the color of all OSD information.

Decoding Type: Switch between “Hardware Decoding” and “Software Decoding”. Please refer to your camera and your device to display video for the best decoding type.

Link Status

Display the link status directly over the FPV image.

Image 052 1 - SIYI AI TRACKING MODULE USER MANUAL

About Link Status

OSD: Enable/disable standard OSD information.

Mavlink OSD: Enable/disable Mavlink OSD information.

Speed Unit: Switch speed unit between meters per second and kilometer per hour. Longitude and Latitude: Enable/disable information.

Gimbal Camera

Configure the abundant functions of the SIYI optical pod and gimbal camera.

Image 053 1 - SIYI AI TRACKING MODULE USER MANUAL

Image 054 1 - SIYI AI TRACKING MODULE USER MANUAL

About Gimbal Camera

Boot Record: Enable/disable automatic video recording by SD card as soon as the gimbal camera is powered.

File Manager: Preview stored images in TF card. Format the TF card.

Laser Calibration: The target position in the camera image may need to be calibrated to match the accurate laser rangefinder orientation.

Full Image Thermometric: Enable/disable the full image temperature measurement

feature in the thermal imaging camera.

Synchronize Zoom: Enable/disable simultaneous zooming of the thermal camera and the zoom camera.

Main / Sub Stream: Configure the mainstream and the sub-stream separately for their camera source and parameters.

Image Mode: Select the video stream’s image type and camera source. Single image or split image. Zoom camera, wide-angle camera, or thermal imaging camera.

Stream Resolution: Decide to switch the output resolution of the current video stream or not according to the camera source. Max output resolution is Ultra HD (1080p).

Record Resolution: Decide to switch the recording resolution or not according to the camera source. The maximum record resolution is 4K.

Gimbal Working Mode: Switch the gimbal working mode among Lock Mode, Follow Mode, and FPV Mode.

  • Lock Mode: Horizontally, the gimbal does not follow when the aircraft rotates.
  • Follow Mode: Horizontally, the gimbal follows when the aircraft rotates.
  • FPV Mode: The Gimbal rotates simultaneously as the aircraft rolls to get an FPV view, and output images with enhanced stability.
  • AI Tracking Mode: When the gimbal is connected to the AI tracking module and the function is enabled, there will be only AI tracking mode displayed.Camera Firmware Version: Display the current camera firmware version. Gimbal Firmware Version: Display the current gimbal firmware version. Zoom Firmware Version: Display the current gimbal firmware version.
About SIYI FPV

Displays the software version of SIYI FPV and common contact information of SIYI Technology.

Image 055 1 - SIYI AI TRACKING MODULE USER MANUALSIYI FPV App Update Log

Date

2023-10-20

Version

2.5.15.679

Updates

  1.  New: AI recognition and tracking function control interface.
  2.  New (ZT30): Zoom & thermal camera simultaneous recording function control interface.
  3.  New: Add the AI tracking module to IP address settings.
  4.  Improve: Occasionally video stream does not recover when the link is disconnected under the SIYI camera protocol.

Date

2023-08-24

Version

2.5.15.660

Updates

  1.  New (ZT30): Laser calibration. Display laser ranging target’s coordinates.
  2.  New: Support TF format.
  3.  New (ZT30): Thermal color palette.
  4.  New: File manager to preview stored pictures in TF card.
  5.  Improve New icon indication for missing TF card.

Date

2023-07-31

Version

2.5.14.644

Updates

  1.  New: Status indication for successfully integrated flight controller attitude data.
  2.  New: Google Maps is supported.
  3.  Fix: The flight controller location was not accurate. New icons for flight controller location and device location.
  4.  New: Status indication for missing TF card.
SIYI FPV SDK

SIYI provides the SIYI FPV SDK to help professional Android application developers integrate the unique features of the SIYI FPV app into their own GCS.

Access Method
Add “fpvlib” to Your Project

Copy the “fpvlib.aar” file to the “libs” folder in your “module” like below:

Image 056 1 - SIYI AI TRACKING MODULE USER MANUALRevise the “build. gradle” file:

Image 057 1 - SIYI AI TRACKING MODULE USER MANUALConfigure “AndroidManifest” File

Add USB reading authorization to the “AndroidManifest” file in your “module” and configure the “intent-filter” file.

Image 058 1 - SIYI AI TRACKING MODULE USER MANUAL

Add FPV Display Function into Code
Add JNI Library

Like the example below, add the JNI library file into the “main” directory, then the “so” library file can be copied from the “demo” to your project directory.

Image 059 1 - SIYI AI TRACKING MODULE USER MANUAL

Add FPV Video Display to Code

Please pay attention to the below points for your code:

  • Firstly, use the static method “getInstances()” of “ConnectionManager” to get the “ConnectionManager” object. Then call the “ConnectionManager.checkConnectWithIntent()” method in the lifecycle method “onCreate()” and “onNewIntent()”.
  • Video stream should be displayed through “SurfaceView”. So, we create a “SurfaceView” object and need to call “ConntionManager.notifySurfaceCreate()” and “notifySurfaceDestroy” methods from “surface created()” and “surfaceDestroy()”

mSurfaceView.getHolder().addCallback(new SurfaceHolder.Callback() {

@Override

public void surfaceCreated(SurfaceHolder holder) { Logcat.d(TAG, “onSurfaceCreated…”); connection manager.notifySurfaceCreate(holder.get surface());

}

@Override

public void surface changed(SurfaceHolder holder, int format, int width

, int height) {

}

@Override

public void surfaceDestroyed(SurfaceHolder holder) { mConnectionManager.notifySurfaceDestroy(holder.getSurface());

}

});

  • Dual-Channel FPV Display: Dual-channel FPV display supports Ethernet connection only. It does not support AOA or USB connection. For dual-channel FPV display, we should configure the IP addresses first, then create two “SurfaceView” for image display. Whether the second video stream is required or not can be judged by the connection type through connection status. You can refer to “demo” for details.
  • When you quit the application, please do not forget to call the “UsbConnectionManager.release()” method. For more detail, please refer to the codes in “demo”.
Interface Instructions
ConnectionManager

Name

Description

getInstance(Context context)

Single case method for“ConnectionManager”

setWirelessUrl(String url1, String url2)

Set the addresses for the video stream.

checkConnectWithIntent(Intent intent)

Initial the connection.

notifySurfaceCreate(Surface surface)

Notify that the first “Surface” is created, the “Surface” is for video display.

notifySurfaceDestroy(Surface surface)

Notify that the first “Surface” is destroyed.

notifySecondSurfaceCreate(Surface surface)

Notify that the second “Surface” is created, the “Surface” is for video display.

 

notifySecondSurfaceDestroy(Surface surface)

Notify that the second “Surface” is destroyed.

 

setConnectionListener(ConnectionListen er listener)

Set a callback for the connection status.

setFrameListeners(FrameListener frameListener, FrameListener secondFrameListener)

Set a callback for a video stream.

getSDKVersion()

Request SDK version.

release()

Release SDK.

SettingsConfig

Name

Description

SettingsConfig.getInstance().initConfig( context)

Initialize the settings. This method must be called.

setLogEnable(boolean)

Set if print the log in the SDK. It is suggested to disable print in the “release” version.

setDecodeType(Context context, @IDecodeListener.DecodeType int decodeType)

Set decoding type. By default, it is hardware decoding.

setSupportWirelessConnection(Context context,

boolean support wireless)

Set it to support the Ethernet connection method.

setRectify(Context context, boolean rectify)

Set it to activate the video stream distortion correction function. The function is disabled by default and is only for the A2 mini FPV gimbal at this moment. It works only when the video stream addresses “RtspConstants.DEFAULT_TCP_VI DEO_URL” “SUB_TCP_VIDEO_URL”.

Attention

If distortion correction is activated, when you switch from SIYI camera addresses “RtspConstants.DEFAULT_TCP_VI DEO_URL” “SUB_TCP_VIDEO_URL” to RTSP

addresses, new surface objects should be imported. One way to do this is to remove “SurfaceView” and add a new “SurfaceView” through “addView”, then import the “Surface” object again in “SurfaceHolder.Callback”.

getCameraManager()

Request camera control objects. SYSDKCameraManager

SYSDKCameraManager

Name

Description

/**

      *Set Camera Resolution

*@param stream type:

*[CameraInfo.STREAM_MAIN], [CameraInfo.STREAM_SUB].

*@param resolution: [CAMERA_RESOLUTION_SD] 480p, [CAMERA_RESOLUTION_HD] 720p, [CAMERA_RESOLUTION_FHD] 1080p.

*[CAMERA_RESOLUTION_2K] 2K, [CAMERA_RESOLUTION_4K] 4K,

*/

fun setResolution(cameraIndex: Int, @CameraInfo.StreamType streamType: Int, @CameraResolution resolution: Int)

Set camera resolution.

SIYI FPV SDK Update Log

Version

2.5.15

Updates

  1. Fix the issue that the RTSP stream may blur.
  2. Add camera control interface.
  3. Fix some other known issues.

Mark:

It is necessary to update the “so” and “aar” files, which can be updated from the “aar_so” folder.

Version

2.5.14

Updates
  1. Fix some issues that cause abnormalities in the JNI library

(need to update “so” library).

  1. Fix some other known issues.

Mark:

It is necessary to update the “so” and “aar” file, which can be

updated from the “aar_so” folder.

Version

2.5.13

Updates
  1. Fix the issue that the video stream of some IP65 cameras may blur.
  2. Add to support ZT30 camera video stream.

Mark:

It is necessary to update the “so” and “aar” files, which can be updated from the “aar_so” folder.

Follow us World Drone Market on our YouTube to view more about the SIYI AI TRACKING MODULE.

Comments

0 Comments Add comment

Leave a comment