# AGA01

**Repository Path**: gdu-sdk/aga01

## Basic Information

- **Project Name**: AGA01
- **Description**: AGA01通用转接盒是适配普宙载荷的硬件转接模块，通过开放协议与机械接口把专用接口转为行业标准接口，实现载荷与客户自研无人机适配。
该技术方案直接通过转接盒的标准化接口快速完成无人机与载荷的物理连接与数据交互，无需从零开发载荷硬件接口、通信协议及驱动适配层，从而显著降低研发周期与成本投入，加速客户自研无人机系统的整体开发进度，能支持可见光/红外等多种挂载，适于需快速集成高性能载荷的行业应用场景。
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 7
- **Forks**: 1
- **Created**: 2025-09-04
- **Last Updated**: 2026-02-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 云台产品/通用转接盒 使用说明

## 1 快速入门

### 1.1 设备供电

**推荐使用 `24V3A` 直流电源，支持`13V~51V`宽压**

![alt text](images/image.png)

电源接口规格：2Pin，间距5mm，XT30PW-M公头

![alt text](images/README.1757041530299.png)

配套电源线：单头XT30UD-F接头，18AWG线长300mm。

### 1.2 视频流网口接线

> **注意：网口仅用于传输视频流，无法传输云台控制指令**

![alt text](images/README.1757041571846.png)

硬件规格：4PIN，间距1.25mm，JNLK-WF1252040102，协议支持：rtsp

![alt text](images/README.1757041599574.png)

![alt text](images/README.1757043839553.jpg)

使用4PIN转网口线连接到PC，将PC网口IP改为`145.192.1.200`

### 1.3 云台控制串口接线

![alt text](images/README.1757043397214.png)

转接盒 RX <-> TX USB-TTL

转接盒 TX <-> RX USB-TTL

转接盒 GND <-> GND USB-TTL

按上图接线将串口线接到调试用的TTL-USB上，然后查到PC机的USB口，装好对应驱动

将转接盒开关拨到 `3` ，表示切换到 `UART` 通信模式

![alt text](images/README.1757322290765.png)

### 1.4 使用上位机工具进行设备调试

（1）请先下载上位机调试工具，[点击下载上位机调试工具](#switchingBoxDownload)

（2）设置上位机工具串口、网络视频流配置

![alt text](images/README.1757044183272.png)

![alt text](images/README.1757044357633.png)

（3）视频流切换

以微型四光云台PQL02为例，支持的显示模式包括：

* 红外模式，可设置配色模式
* 广角模式
* 变焦可见光，可设置相机变倍
* 分屏模式，可见光和红外同时显示

![alt text](images/README.1757059643238.png)

切换展示模式

![alt text](images/README.1757059784249.png)

云台控制、变倍控制

（4）协议接口调试

进入右上角`单步调试`

![alt text](images/README.1757059873305.png)

在界面上找到对应功能，填好后下发指令

![alt text](images/README.1757060099075.png)

左上角可以看到命令下发后状态

![alt text](images/README.1757060384282.png)

点击右上角`串口调试`可以实时查看上位机工具收发的串口命令

![alt text](images/README.1757060442859.png)

详细通信协议说明：[点击下载转接盒通信协议3.8](#AGA01-Protocol)

（5）基本参数设置

* 修改云台默认IP

进入 单步调试 -> 通用部分 -> 可见光相机IP地址设置

![alt text](images/README.1757060579492.png)

> 注意：
> 
> 出厂默认IP：`145.192.1.20`
> 
> 出厂默认子网掩码：`255.255.255.0`

* 设置串口波特率

![alt text](images/README.1757060643165.png)

> 注意：出厂默认波特率：`230400`

详细说明见：[云台转接盒对接说明](#AGA01-doc)、[云台转接盒用户手册](#AGA01-manal)  

### 1.5 云台授时

云台不具备主动授时功能，需要外部下发指令完成授时。

授时指令 `0x2405`：

![alt text](images/README.1764723328955.png)

![alt text](images/README.1764723335238.jpg)

上位机工具在连上设备后会主动下发授时指令。

### 1.6 FTP远程获取飞机成果

通过FTP获取协议获取，相机应用程序版本号要 >= 1.38.89

![alt text](images/README.1766565954408.png)

FTP服务器地址：145.192.1.20（如果已修改云台ip，那么用修改后的地址）
端口：21
账户：pzftp 
密码：pz123456
照片、视频路径：/SD/DCIM

### 1.7 升级相机程序

1. 将固件包 `PQL02-1.38.89.1016.bin` 文件拷贝到SD卡根目录

   ![alt text](images/README.1766566148697.png)

2. 将SD插入云台后上电，云台在上电后会自动检测根目录固件包，然后执行升级
3. 等待约2分钟后，云台升级完毕，使用上位机工具获取相机版本号

   ![alt text](images/README.1766565954408.png)

### 1.8 跟踪功能演示

[点击下载：跟踪功能演示.mp4](微型四光云台-PQL02/跟踪功能演示02.mp4)

## 2 常见问题

[FAQ.md](FAQ.md)

## 3 相关资料及工具下载

* <a id="switchingBoxDownload">上位机工具SwitchingBox</a> [点击下载](云台通用转接盒-AGA01/转接盒上位机软件-SwitchingBox_20250313.rar)
* <a id="AGA01-doc">云台转接盒对接说明</a> [点击下载](云台通用转接盒-AGA01/云台转接盒对接说明.pdf)
* <a id="AGA01-manal">云台转接盒用户手册</a> [点击下载](云台通用转接盒-AGA01/AGA01云台通用转接盒3.0用户手册-电子版.pdf)
* <a id="AGA01-Protocol">转接盒通信协议3.8</a> [点击下载](云台通用转接盒-AGA01/AGA01通讯协议3.8(2).pdf)
* <a id="PWG01-manal">PWG01智能五光吊舱技术规格书</a> [点击下载](云台通用转接盒-AGA01/PWG01_智能五光吊舱技术规格书.pdf)
* <a id="PQL02-follow">PQL02相机跟踪功能使用说明</a> [点击下载](微型四光云台-PQL02/跟踪使用说明.pdf)