Page 1
ZT30 User Manual v1.0 ZT30 FOUR-SENSOR OPTICAL POD 4K AI THERMAL RANGEFINDER USER MANUAL V1.0 May 2023 2022 SIYI Technology Copyright...
Page 2
HDR and starlight night vision extend the application scenarios to both day and night. In a word, ZT30 optical pod is a rare and good payload for multi-rotors, VTOLs, and robotics.
Page 3
ZT30 User Manual v1.0 SIYI User Group - Facebook SIYI Official Store (https://shop.siyi.biz) SIYI Official AliExpress Store (https://siyi.aliexpress.com) SIYI YouTube Channel (https://www.youtube.com/c/SIYITech) 2022 SIYI Technology Copyright...
2.2 Connection and Power ........................... 18 3 GIMBAL CONTROL ............................19 3.1 Control Gimbal Camera from SIYI FPV App or SIYI QGC App on SIYI Handheld Ground Station 19 3.1.1 Preparation ............................19 3.1.2 Gimbal Pitch and Yaw Rotation ...................... 21 3.1.3 Zoom and Focus ..........................
Page 5
ZT30 User Manual v1.0 3.3.5 SDK CRC16 Code ........................... 39 3.3.6 Advanced Guide for SIYI Gimbal SDK Integration ............... 41 3.4 Control SIYI Gimbal Camera in SIYI QGC Windows Software through HM30 Image Transmission System ................................45 3.4.1 Preparation ............................45 3.4.2 Gimbal Pitch and Yaw Rotation ......................
SIYI Technology is not obliged to any of the damage, loss, or injury. It is prohibited to use SIYI products for military purpose. Users under 14 years’ old should follow an...
Disassembling or modification to the system is prohibited without permission from its manufacturer, SIYI Technology. Storage / Carrying / Recycling When your SIYI product is left unused, or you are bringing it outdoors, or the product life has expired, please do read the below precautions. CAUTION Always place your SIYI products at places where babies or kids do not reach.
High Resolution Thermal Imaging Full-Screen / Point-Anywhere Temperature Measuring ZT30 four-sensor optical pod carries a 640 x 512 resolution thermal imaging sensor of 19 mm focal length and 30 fps frame rate. Vision is wide and far. Video is smooth and clear. Quick and accurate reactions can be taken as long as abnormal heat source is detected where temperature can be measured by touching on infrared images.
Page 10
Silky movement, smooth zoom, distant scenery, now within reach. *The images recorded by ZT30 will have GPS location information and time attributes. Infrared Zoom Thermal camera supports 2x digital zoom and accurately controls more picture details.
Page 11
The operator can quickly obtain valuable information by comparing the details of the picture. Video Split-Screen ZT30 can split screen for video streams from any two sensors freely and the third sensor can be streamed in the floating window simultaneously. Starlight Night Vision The ultra-sensitive starlight CMOS keep images bright in low light environment.
Page 12
*Developing on SIYI SDK through Ethernet UDP or UART can control SIYI optical pods by protocol and acquire relevant data. *The Mavlink protocol control for SIYI optical pods is in development and will be supported by upgrade later. Gimbal Motion Mode...
Page 13
Gimbal rotates simultaneously as aircraft rolls to get FPV view, and output enhanced stable images. High Accuracy and High Collaboration Control Algorithms During development stage of ZT30, SIYI has made multiple breakthroughs in control algorithms and stabilization algorithms. IMU Calibration Algorithms...
Page 14
ZT30 User Manual v1.0 High-Precision FOC Motor Control Algorithms Control the current components of the motor to control torque and magnetic field respectively, thereby achieving decoupling control of the brushless motor and greatly reducing picture jitter.
Page 20
ZT30 User Manual v1.0 Horizontal: 88° Video Recording 2K (2560 x 1440) @ 30 fps Resolution Still Photo Resolution 2K (2560 x 1440) Laser Rangefinder Range 5 ~ 1200 m Wavelength Range 900 ~ 908 nm Resolution 0.1 m ±1 m (3 ~ 100 m) Ranging Accuracy ±1 + L*0.25% m, L=Length (100 ~ 600 m)
SIYI gimbal, another goes to flight controller) 1 x 3 in 1 Control Cable (A universal cable for ZT30, ZR30, and A8 mini, it connects SIYI gimbal’s control signal port with SIYI link and controller, including UART control input, S.Bus input and output)
ZT30 User Manual v1.0 1.5 Indicator Definition The status indicator on SIYI gimbal uses three different colors and different blinking frequencies to indicate the system’s working or abnormal status. Solid Green: Normally working. Slow Green Blinks: S.Bus signal input is normal.
2 GET READY TO USE ZT30 2.1 Installation Screw Holes’ Position and Distance Mark The specs of the screws for fixing the four tube screws are M.25*8 mm. Quantity: 4. Welcome to contact SIYI to get the SIYI Gimbal 3D Model for pre-installation.
ZT30 User Manual v1.0 2.2 Connection and Power SIYI optical pod and gimbal camera can be powered in many ways. If you plan to carry SIYI gimbal by your plane and the plane may roll in a wide margin, then please use connect SIYI gimbal’s power port directly by a 3S to 6S power battery,...
3.1 Control Gimbal Camera from SIYI FPV App or SIYI QGC App on SIYI Handheld Ground Station Gimbal connects to air unit directly to control gimbal rotation, gimbal functions, and video display in SIYI FPV app or SIYI QGC app when the air unit is communicating with the ground station. 3.1.1 Preparation It is necessary to prepare the tools, firmware, and software below before controlling gimbal camera in this way.
Page 26
SIYI FPV App Steps 1. Power air unit and bind it with ground station. 2. Use SIYI Gimbal to SIYI Link Cable to connect the air unit’s Ethernet port with the gimbal quick release board’s Ethernet port. 3. Update SIYI FPV app to the latest.
SIYI QGC App Steps 1. Power air unit and bind it with ground station. 2. Use SIYI Gimbal to SIYI Link Cable to connect the air unit’s Ethernet port with the gimbal quick release board’s Ethernet port. 3. Run SIYI QGC app, go to “Comm Links – Video Settings”, and select “RTSP Video Stream”...
Tap touchscreen, zoom camera will focus automatically. 3.1.4 Take pictures and Record Video While SIYI FPV App or SIYI QGC app is running, Touch “Photo” icon once on to take a picture. Touch “Record” icon to start video recording. Touch “Recording” icon to stop video recording.
SIYI gimbal camera) ⚫ ZT30 Optical Pod Mark Above products can be purchased from SIYI directly or from SIYI authorized dealers. ⚫ SIYI Gimbal to SIYI Link Cable ⚫ 3 in 1 Control Cable (For ZT30, ZR30, and A8 mini) ⚫...
Page 30
Steps 1. Power MK15 air unit and bind it with MK15 remote controller. 2. Use SIYI Gimbal to SIYI Link Cable to connect MK15 air unit’s Ethernet port with gimbal quick release board’s Ethernet port. 3. Wire the 3 in 1 Control Cable with the MK15 / HM30 Air Unit S.Bus Y Cable.
3.2.2 Gimbal Pitch and Yaw Rotation (Taking an example of MK15 Dials) Below are suggested MK15 channel mapping settings for testing, customers are free to assign MK15 channel mappings as required through SIYI TX app. ⚫ Channel 7 = Left Dial (Reversed)
ZT30 User Manual v1.0 ⚫ Channel 12 = Button D In SIYI PC Assistant, map “Yaw” function to channel 7 and “Pitch” to channel 8, “Center” to channel 12. Then, if you operate the left dial on MK15 remote controller, gimbal will rotate on yaw axis.
⚫ Channel 9 = Button A ⚫ Channel 10 = Button B In SIYI PC Assistant, map “Photo” function to channel 9 and “Record” to channel Then, if you press button A on MK15 remote controller, camera will take a picture.
ZT30 User Manual v1.0 3.3 UART / UDP Control (through SDK) SIYI gimbal camera provides control protocol for all customers. Please refer to the below guide for secondary development based on SIYI gimbal camera. 3.3.1 SDK Protocol Format Field Index...
Page 35
(zoom_multiple / 10, accurate to one decimal point) Mark: 1. Auto focus command is only available for optical zoom gimbal cameras like ZT30, ZR30, and ZR10 at this moment. 2. Under this command, A8 mini can only do manual zoom and cannot do auto focus.
Page 36
Success and return to 1 t_ask Mark: 1. Absolute zoom command is only available for optical zoom gimbal cameras like ZT30, ZR30, and ZR10 at this moment. 2. Under this command, A8 mini can only do absolute zoom and cannot do auto focus.
Page 37
ZT30 User Manual v1.0 -100~0~100: Negative and positive represent two directions, higher or lower the number is away int8_t turn_yaw from 0, faster the rotation speed is. Send 0 when released from control command and gimbal stops rotation. int8_t turn_pitch...
Page 38
ZT30 User Manual v1.0 HDMI output OFF CVBS output ON Function Feedback Information CMD_ID:0x0B------Function Feedback Information Send data format Data Type Data Name Description ACK data format 0: Success 1: Fail to take a photo (Please check if TF card is inserted)
Page 39
⚫ A8 mini: -90.0 ~ 25.0 degree ⚫ ZR10 / ZR30 / ZT30: Same with A8 mini Mark: 1. The accuracy of the control angle is in one decimal place. Eg: Set yaw as 60.5 degrees, the command number should be set as 605.
Page 40
7: Single Image (Main: Thermal. Sub: Zoom) 8: Single Image (Main: Thermal. Sub: Wide Angle) Mark: Acquire camera image type command is only available for ZT30 at this moment. Set Camera Image Type CMD_ID:0x11------Set Camera Image Type Send data format...
Page 41
X coordinate of the point uint16_t Y coordinate of the point Mark: Read temperature of a point command is only available for ZT30 at this moment. Read Temperature of a Box on Screen CMD_ID:0x13------Read Temperature of a Box on Screen...
Page 42
Under digital zoom, the temperature measuring range should refer to the box responded by the camera. 2. Read temperature of a box command is only available for ZT30 at this moment. Read Temperature of the Full Screen...
Y coordinate of the min temperature uint16_t temp_min_x in the full screen Mark: Read temperature of the full screen is only available for ZT30 at this moment. Read Range from Laser Rangefinder CMD_ID:0x15------Read Range from Laser Rangefinder Send data format...
Page 44
ZT30 User Manual v1.0 Absolute Zoom (4.5X) 55 66 01 02 00 01 00 0F 04 05 60 BB Acquire the Max Zoom Value 55 66 01 00 00 00 00 16 B2 A6 Manual Focus 1 55 66 01 01 00 00 00 06 01 de 31...
Turn Off both CVBS and HDMI Output (Only available on A8 mini, restart to take effect) 55 66 01 01 00 00 00 0c 08 3c 4f Read Range from Laser Rangefinder (Low byte in the front, high byte in the back, available on ZT30) 55 66 01 00 00 00 00 15 D1 96 3.3.5 SDK CRC16 Code...
Before using the guide, please do read the chapter 3.3.1 to 3.3.5 of the user manual. This guide is using UDP protocol: 1. Go to chapter 3.3.4 of this manual for SIYI Gimbal Camera SDK Communication Code Examples and fill your required examples to “send_buff” following the below format in hexadecimal.
Page 48
ZT30 User Manual v1.0 6. Print the received data in hexadecimal and do not revise. 7. Following the above steps, compile and run the SDK and you will see the printed data below, which means data can be sent and received normally. At this moment, please observe if the gimbal camera executes the relevant actions.
Page 49
ZT30 User Manual v1.0 int main(int argc, char *argv[]) int sockfd; int ret, i, recv_len; struct sockaddr_in send_addr, recv_addr; unsigned char send_buf[] = {0x55,0x66,0x01,0x01,0x00,0x00,0x00,0x08,0x01,0xd1,0x12}; // Frame protocol of the relevant functions in hexadecimal unsigned char recv_buf[RECV_BUUF_SIZE] = {0}; /* Create UDP Socket...
Page 50
ZT30 User Manual v1.0 Receive the responding data from gimbal camera descriptor of “sockfd” socket sockfd: recv_buf: head address in RAM of the responding data RECV_BUUF_SIZE: size of the buffer, which is the length of the max data to receive receiving mark, usually it is 0 (struct sockaddr *)&recv_addr:...
3.4 Control SIYI Gimbal Camera in SIYI QGC Windows Software through HM30 Image Transmission System Gimbal camera connects to air unit directly to control gimbal rotation, gimbal functions, and video display in SIYI QGC Windows software when the air unit is communicating with the ground unit. 3.4.1 Preparation It is necessary to prepare tools, firmware, and software below before controlling gimbal camera in this way.
Page 52
Steps 1. Power air unit and bind it with ground unit. 2. Use SIYI Gimbal to SIYI Link Cable to connect the air unit’s Ethernet port with the gimbal quick release board’s Ethernet port. 3. Then use HM30 Ground Unit LAN to RJ45 cable to connect the ground unit’s LAN port with the computer’s RJ45 port.
ZT30 User Manual v1.0 5. Run SIYI QGC Windows software, go to “Comm Links – Video Settings”, and select “RTSP Video Stream” for “Source”, then enter the default RTSP addresses of SIYI gimbal camera, video stream will display. Gimbal motion and camera functions can be controlled by mouse in QGroundControl.
Farther you hold it from the center of the screen, faster the gimbal rotates. 3.4.3 Zoom and Focus While SIYI QGC Windows software is running, Clicking “Zoom in” or “Zoom out” icon on can control the zoom camera, up to 180X hybrid zoom.
⚫ Ardupilot Flight Controller (v4.3.1 and above firmware) ⚫ ZT30 Optical Pod Mark Above products can be purchased from SIYI directly or from SIYI authorized dealers. ⚫ SIYI Gimbal to Ardupilot Flight Controller UART Cable Mark Above tools should be made by customers.
Page 56
ZT30 User Manual v1.0 ⚫ SIYI QGC Windows Software Mark Above software can be downloaded from relevant product page on SIYI official website. Steps 1. Power SIYI gimbal camera and Ardupilot flight controller. 2. Connect gimbal camera’s UART port to Ardupilot flight controller’s UART port and make sure they are communicating with each other.
Page 57
⚫ MNT1_RC_RATE to 90 (deg/s) to control speed of gimbal when using RC targetting ⚫ CAN1_TYPE to 4 (Mount / SIYI) to allow control of the camera ⚫ RC6_OPTION = 213 (“Mount Pitch”) to control the gimbal’s pitch angle with RC channel 6 ⚫...
3. Choose “SIYI Camera 1 Main Stream” for Video 1 in IP addresses settings. 4.2 Dual Camera & Split Image Dual Camera & Split Image means that SIYI FPV app shows the split image from two cameras in the main window. The suggested setup is below.
3. Choose “SIYI Camera 1 Main Stream” for Video 1 in IP addresses settings. 4.3 Dual Camera & Main / Sub Window Image Dual Camera & Main / Sub Window Image means that SIYI FPV app shows the video streams from two cameras in both the main window and the sub window.
Gimbal camera can connect to the air unit directly, then video will be displayed in SIYI FPV app or SIYI QGC app or other app that are compatible with SIYI link and SIYI gimbal camera when the air unit is communicating with the ground station.
Page 61
Above software can be downloaded from relevant product page on SIYI official website. SIYI FPV App Steps 1. Power air unit and bind it with ground unit. 2. Use SIYI Gimbal to SIYI Link Cable to connect the air unit’s Ethernet port with the gimbal quick release board’s Ethernet port.
SIYI QGC App Steps 1. Power air unit and bind it with ground unit. 2. Use SIYI Gimbal to SIYI Link Cable to connect the air unit’s Ethernet port with the gimbal quick release board’s Ethernet port. 3. Run SIYI QGC app, go to “Comm Links – Video Settings”, and select “RTSP Video Stream”...
It is necessary to prepare the tools, firmware, and software below before outputting video stream in this way. ⚫ ZT30 Four-Sensor Optical Pod Mark Above products can be purchased from SIYI directly or from SIYI authorized dealers. ⚫ SIYI Gimbal Ethernet to RJ45 Cable Mark Above tools come with product package.
Page 64
Steps 1. Power gimbal camera. 2. Use SIYI Gimbal Ethernet to RJ45 Cable to connect the gimbal quick release board’s Ethernet port to Windows device’s RJ45 port. If your computer does not come with RJ45 port, it is suggested to use an RJ45 to USB converter.
Steps 1. Power the air unit of the third-party link and bind it with the ground unit. 2. Use the video cable to connect SIYI gimbal camera’s Ethernet port and the third-party link’s Ethernet port. 3. Open RTSP video player and input SIYI gimbal camera’s default RTSP addresses, if connection is successful, video will display normally.
2. Check Camera IP addresses and RTSP addresses. 3. If you are using SIYI FPV app, check the connection status, app version, video stream settings. 4. If you are using SIYI handheld ground stations, check the Ethernet switch in Android system.
ZT30 User Manual v1.0 4.10.1 Video Output to Android Device 1. Input SIYI gimbal’s default IP addresses “192.168.144.25” in the “Ping Tools” app and check if the network communication is successful. If the tool responds, then check if the RTSP address in the application / software is correct.
ZT30 User Manual v1.0 if the video cable between the camera and the link’s air unit is good, and if the voltage input is in normal range. 4.10.2 Video Output to Windows Device 1. Use the “Win + R” key combo to wake up the “Run” program and input the command “cmd”.
ZT30 User Manual v1.0 2. Input SIYI gimbal camera’s default IP addresses “192.168.144.25” and press the “Enter” key to check if the communication is successful. If it is, please check the RTSP addresses in the software or try to switch to another software.
Page 70
ZT30 User Manual v1.0 Mark SIYI gimbal cameras released after ZT30 (including ZT30) start to use the new addresses.
Mark This chapter is edited based on SIYI FPV App v2.5.12.572. SIYI FPV App can be download from the relevant product pages on SIYI official website. SIYI FPV App compatible SIYI devices. ⚫ ZT30 Four-Sensor Optical Pod ⚫ ZR30 4K AI 180X Hybrid Zoom Optical Pod ⚫...
Page 72
ZT30 User Manual v1.0 SIYI FPV App OSD Information Definition SIYI FPV Camera Function Icon Definition...
IP addresses, custom app interface, and switch video decoding type. About Settings Camera IP: Select between SIYI Camera 1 and SIYI Camera 2, between main stream and sub stream, select or input video stream RTSP addresses, disable image, or rotate the relevant image in 180 degrees.
ZT30 User Manual v1.0 5.2 Link Status Display the link status directly over the FPV image. About Link Status OSD: Enable / disable standard OSD information. Mavlink OSD: Enable / disable Mavlink OSD information. Speed Unit: Switch speed unit between meter per seconds and kilometer per hour.
ZT30 User Manual v1.0 5.3 Gimbal Camera Configure the abundant functions of SIYI optical pod and gimbal camera. About Gimbal Camera Boot Record: Enable / disable automatic video recording by SD card as soon as gimbal camera is powered. AI Tracking: Enable / disable the AI identification and tracking feature in the zoom camera.
Page 76
ZT30 User Manual v1.0 the zoom camera. Main / Sub Stream: Configure the main stream 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.
ZT30 User Manual v1.0 6 Firmware Upgrade and Configuration SIYI PC Assistant is a Windows software developed by SIYI to configure many SIYI products for configuration, firmware update, and calibration. Mark The manual is edited based on SIYI PC Assistant v1.3.4.
Page 79
1. Install “SIYI PC Assistant” on your Windows device. 2. Use the USB-C to USB-A cable to connect Windows device’s USB-A port to gimbal camera’s USB-C port. 3. Run “SIYI PC Assistant” and switch to “Upload” page to check gimbal camera’s current firmware version.
Page 80
ZT30 User Manual v1.0 4. If the firmware is not latest, then click the “Select File” button in the “Gimbal” to import the latest firmware. And click “Upgrade” and wait till it is “100%” finished. Mark Before updating any firmware, gimbal camera should be powered.
ZT30 User Manual v1.0 6.2 Camera Firmware Update The camera firmware of SIYI gimbal camera should be upgraded by SD card. Before upgrading, it is necessary to prepare the tools, software, and firmware below. ⚫ Micro-SD Card (Class10, FAT32) Mark Customers should prepare the above tools.
Page 82
1. Save camera firmware’s “.bin” file to the SD card’s root directory and do not change the file name. 2. Restart gimbal camera and wait for 3 to 5 minutes. Camera firmware will be flashed automatically. 3. Run SIYI FPV app or SIYI PC Assistant software to check if camera firmware is updated successfully.
ZT30 User Manual v1.0 6.3 Gimbal Camera Configuration SIYI gimbal camera can be connected to SIYI PC Assistant for channel settings and camera settings. 6.3.1 Channel Configuration The “Channel Config” menu under “Gimbal Config” menu can assign the below gimbal camera functions to up to 16 channels and an idle channel (disabled).
Page 84
ZT30 User Manual v1.0 ⚫ Zoom: Control camera for optical zoom and digital zoom. ⚫ Manual Focus: Adjust zoom camera focal length for manual focus. ⚫ Yaw: Control gimbal rotation on yaw axis. ⚫ Pitch: Control gimbal rotation on pitch axis.
ZT30 User Manual v1.0 6.3.2 Camera Configuration The “Gimbal Config” menu also supports abundant and core features of SIYI gimbal camera, such as, checking camera firmware version, modifying camera IP addresses, selecting camera source for main / sub stream and video recording, switching camera resolution or zoom mode, enabling / disabling thermal camera’s...
Page 86
ZT30 User Manual v1.0 IMU Calibration IMU calibration can keep the inertial measuring unit’s accuracy and reliability. Steps 1. Click “Check”, gimbal camera will power off automatically. Meanwhile, please follow the message box and place the gimbal camera on a flat surface and make sure that the IMU is static.
Page 87
ZT30 User Manual v1.0 3. If IMU is working normally, there will be a message box to indicate “not necessary to calibrate”. 4. If IMU is not working normally, there will be a message box to indicate “calibration is necessary”.
Page 88
ZT30 User Manual v1.0 8. After a few seconds, IMU calibration will be finished. IMU Constant Temperature Calibration Specially designed for using gimbals in scenarios with big difference in temperature to avoid the situation that gimbal behaves abnormally because IMU cannot reach constant temperature normally and fast when the environment temperature is far from IMU constant temperature.
Page 89
ZT30 User Manual v1.0 the error model. Hexahedral calibration can keep the accelerator’s accuracy and reliability.
⚫ Product Defect ⚫ Product Damage SIYI products under the two situations can be sent back to SIYI for repairing. Defect products with valid warranty can be repaired for free. Defect products without valid warranty or damaged products should be charged of repair fees after...
It is requested beyond seven (7) calendar days of receiving a product. A product sent to SIYI for Return & Refund Service does not include all original accessories, attachments or packaging, or any item is not in new or like-new condition, i.e., with cracks, dents, or scratches.
Damage is caused to the product by uncontrollable external factors, including fire, floods, high winds, or lightning strikes. A product is not delivered to SIYI within seven (7) calendar days after Return & Refund Service confirmation is sent from SIYI.
Page 93
Damage is caused by uncontrollable external factors, including fires, floods, high winds, or lightning strikes. Received product has not been sent back to SIYI seven (7) calendar days after replacement confirmation from SIYI. Proof of damage during transit issued by the carrier cannot be provided.
Charges may apply for services not covered by this Limited Warranty. Please contact SIYI for information specific to your location. Please note that the warranty service is only available in the respective SIYI service regions where you purchased your SIYI product.
Page 95
ZT30 User Manual v1.0 Damage caused by non-authorized service provider. Damage caused by unauthorized modification of circuits and mismatch or misuse of the battery and charger. Damage caused by operation in bad weather (i.e., strong winds, rain, sand/dust storms, etc.) Damage caused by operating the product in an environment with electromagnetic interference (i.e., in mining areas or close to radio transmission towers, high-...
Need help?
Do you have a question about the ZT30 and is the answer not in the manual?
Questions and answers