Debug Tools使用教程

为帮助开发者快速调试无人机功能，Autel提供Debug Tools工具，可以对无人机硬件模块进行参数访问和行为控制等接口进行调试。

启动Debug Tools(SDK Demo), 进入主界面，如下图所示：

主要包括以下部分：

• Key/Value：演示无人机支持的所有Key的使用
• NetMeshSettings： 组网相关流程，接口调用演示
• Virtual Stick：演示如何使用虚拟摇杆
• Media Files: 演示如何使用媒体文件功能，如文件上传、下载、查询、删除等
• Multi-Video Decoding：演示如何使用多视频解码功能
• LiveStreaming：演示如何使用RTMP进行推流
• RtspServer：演示如何使用RTSP进行推流
• GB28181 Publisher：演示如何使用GB28181协议进行推流
• Scenario Testing：测试遥控器配对；遥控器校准、指南针校准、云台校准；照片、视频录制等场景测试
• RTK：RTM切换及授权相关测试页面
• Device log：演示如何获取设备日志
• Device OTA：演示如何对设备进行OTA升级

Key/Value

概述

KeyManager类提供了一组方法来访问硬件模块的参数和控制硬件模块的行为。通过KeyTools类提供的createKey方法创建AutelKey实例。然后通过KeyManager发起Key的Set、Get、Action、Listen或Report，来完成对无人机硬件模块的控制。

通过Key/Value调试模块，可以快速的对无人机硬件模块的参数和行为进行设置和读取。

界面说明

进入Key/Value页面，如下图所示：

1. 左侧为Key List，显示当前选择的模块支持的所有Key的列表(默认为相机模块)，可以翻页查找，也可以直接搜索查找。
2. Camera为当前选择的调试模块，可以点击切换其他模块。
3. Single Test 单项测试和批量测试模式切换，如何切换到批量测试，则点击④就会执行左侧列表所有Key值得测试
4. 代表每个Key的操作，GET/SET为Key值获取和设置，LISTEN可以监听Key值得变化，ACTION 可以执行某一个动作，如拍照等，REPORT 代表可以通过该Key上报信息
5. 中间部分则是操作过程的日志和结果输出窗口，右下角Clear All按钮则可以清空显示日志

测试说明

Get方法

例如：获取相机录像保存数量，在Key List中查找并选中视觉相机录像保存数量，由于CameraStatus只支持Get和Set，右侧Listen、执行、Report会灰化不可点，点击按钮Get，下方会展示CameraRecordNumber的参数打印。

下图为Get方法调用成功，打印结果的截图：

Set方法

例如：设置录像开关，在Key List中查找并选中CameraRecordEnable，由于CameraRecordEnable只支持Get、Set，右侧的Listen、Action、Report会灰化不可点，点击按钮Set进行参数设置，下方会展示CameraRecordEnable的请求成功或失败的打印结果

Set方法输入窗口：

执行结果显示：

Listen方法

例如：获取相机状态，在Key List中查找并选中CameraStatus，由于CameraStatus只支持监听，右侧的Get、Set、Action、Report会灰化不可点，点击按钮Listen，下方就会展示CameraStatus的参数打印。同时Listen按钮会变成UnListen，点击UnListen可取消监听，停止参数打印。

下图为Listen成功，打印数据的截图：

Action方法

例如：重置相机，在Key List中查找并选中CameraReset，由于CameraReset只支持Action，右侧的Get、Set、Listen、Report会灰化不可点，点击按钮Action，下方会展示CameraReset的请求成功或失败的打印结果

下图为调用CameraReset成功，打印结果的截图：

Report方法

Report方法不常用，主要用于上报消息，比如通用参数中的设置可飞区及附近国家码，如下图所示：

其他模块的Key测试方法同上，

Media Files

进入Media Files页面，可以看到，该功能支持任务文件和媒体文件的管理测试 下面演示多媒体文件的功能，任务文件的功能类似。

• Get Media List: 查询媒体文件列表，输入参数如下：

  count：需要查询多少个文件 offset：起始位置 storageType: 存储位置，EMMC - 机载闪存；SD - SD卡 orderType: 排序方式，NORMAL - 顺序；REVERSE - 倒叙 type: 文件类型，MEDIA_ALL - 全部文件；MEDIA_VIDEO - 视频文件；MEDIA-PHOTO - 图片文件

  查询结果如下：

• Delete Media File: 删除视频或者图片文件 index: 前面查询结果中的index

Multi-Video Decoding

该模块主要是测试变焦/红外相机是否正常，点击Multi-Video Decoding项进入界面，如下图所示，如果变焦和红外视频能正常显示，则表示正常。

LiveStreaming

LiveStreaming项主要用来测试RTMP推流功能：

1. 进入LiveStreaming页面，检查视频是否正常，
2. 填写RTMP推流地址，然后再点击START按钮开始推流，如下图所示：

注意：该功能需要自己搭建RTMP服务器，推流后就可以再改RTMP服务器上查看视频流的情况

RtspServer

RtspServer功能与LiveStreaming类似，主要是用来测试RTSP推流功能的：

1. 进入RtspServer页面，检查视频是否正常，
2. 填写RTSP推流地址，然后再点击START按钮开始推流，如下图所示：tools_rtsp_push

注意：该功能需要自己搭建RTSP服务器，推流后就可以再改RTSP服务器上查看视频流的情况

Scenario Testing

Scenario Testing是针对某些特定功能和场景进行测试，包含的测试场景如下图所示：

• Remote Controller Pairing: 测试遥控器与飞机配对 点击START PAIRING开始进行配对，直到出现绿色的"Pairing Success"，代表配对成功

• Remote Controller Calibration: 遥控器校准 点击START CALIBRATION开始校准，此时遥控器会发出急促的滴滴声，左右摇杆分别往上、下、左、右和左下，右下，右上，左上八个方向拨，并保持1秒以上，直到滴一声，代表这个方向校准完成。同样的，分别把左右两个滚轮往两个方向打满，直到滴一声，完成这个方向的校准。所有方向完成校准后，会自动结束校准流程。

• IMU Calibration: IMU校准 点击START IMU CALIBRATION, 跟随图中的指示操作，对IMU进行校准

• Compass Calibration: 指北针校准 点击START COMPASS CALIBRATION，跟随图中指示操作，对指北针进行校准

• Gimbal Calibration: 云台校准 点击START CALIBRATION开始进行云台校准，直到出现绿色的"Gimbal Calibration Success"，代表校准成功

• Photograph: 拍照 点击START TAKING PICTURES进行拍照，结果如下：

• Videography: 录像 点击START VIDEO RECORDING进行录像，点击END RECORD结束录像