1. PSDK 基础概念与定位
1.1 什么是 PSDK
大疆负载软件开发套件（Payload Software Development Kit，PSDK）是大疆为开发者提供的一套开发工具，用于在无人机上开发并集成自定义负载设备（如传感器、摄像头、机械臂等）。与 OSDK（Onboard SDK，机载端开发）和 MSDK（Mobile SDK，移动端开发）相比，PSDK 更侧重于硬件层面的深度集成。
- 适用平台：Linux、RTOS（Real-Time Operating System，实时操作系统）
- 硬件载体：SkyPort V2 / X-Port 连接无人机，通过开发板（如 Raspberry Pi、STM32）运行负载程序
- 开发语言：C/C++
1.2 PSDK 架构简介
PSDK 采用分层架构，自上而下包括应用层、核心功能层和硬件抽象层（Hardware Abstraction Layer，HAL）。开发者需要根据自己使用的硬件平台实现对应的 HAL 接口，以实现与飞控的通信及电源管理。
2. Linux 开发环境搭建
本章基于 Raspberry Pi + Linux 环境进行配置，参照 DJI 官方快速入门文档进行操作。
2.1 硬件准备
- 开发板：Raspberry Pi 4B（或 3B+，推荐 4GB 内存以上版本）
- 连接配件：SkyPort V2 或 X-Port 适配板
- 网络连接：同轴电缆、UART 串口线或依赖联网方式
- 存储卡：至少 32GB 的 TF 卡（刷写系统后剩余空间用于编译调试）
2.2 Linux 系统配置
- 刷写系统：使用 Raspberry Pi Imager 刷入 Raspberry Pi OS（推荐基于 Debian 的 Lite 版本）
- 初始化设置：
# 启动后更新软件源并升级系统sudoaptupdate&&sudoaptupgrade-y# 安装必要工具链sudoaptinstall-ybuild-essential cmakegitwget - 启用串口通信：编辑
/boot/config.txt，使能 UART 接口 - 网络配置：确保开发板与调试 PC 在同一网段，便于后续文件传输和远程调试
2.3 交叉编译工具链（可选）
若在 PC 端编译并将可执行文件传输到树莓派运行，需安装交叉编译工具链（如 arm-linux-gnueabihf-gcc）。本地编译则直接在树莓派上完成，省去交叉编译步骤。
3. PSDK 快速上手：官方 Demo 运行
3.1 下载 PSDK 源码
- 注册 DJI 开发者账号并创建应用，获取App ID和App Key
- 从 DJI Developer 下载中心 下载 PSDK 最新版本
- 将源码包传输至树莓派并解压：
unzipPayload-SDK-*.zipcdPayload-SDK
3.2 配置并编译 Demo
- 修改
samples/sample_c/platform/linux/common/osal/sample_config.h，填入 App ID 与 App Key - 根据硬件连接方式选择通信接口（如 UART），在配置文件中指定串口设备名（
/dev/ttyAMA0等） - 编译：
mkdirbuild&&cdbuild cmake..make-j4
3.3 连接无人机并运行
- 将树莓派通过 SkyPort / X-Port 连接至无人机，上电启动
- 运行编译好的 demo 可执行文件，通过日志确认 PSDK 初始化、飞控连接和订阅数据功能正常工作
4. RTOS 与 HAL 抽象层移植要点
4.1 操作系统适配
官方提供基于 Linux 和 FreeRTOS 的 HAL 模板。若使用 RTOS（如 STM32 系列），需要额外适配以下组件：
- 线程管理：创建并管理 PSDK 任务线程（psdk 主任务、数据订阅任务等）
- 互斥锁与信号量：保证多线程访问安全
- 定时器：提供毫秒级延时和周期性回调
4.2 关键 HAL 接口分析
包括但不限于：
- UART/串口收发：
PsdkPlatform_UartSend()/PsdkPlatform_UartRecv() - 网络通信：若使用 USB 虚拟网卡或网口与飞控通信，需实现相应网络层接口
- 电源管理：获取引脚供电状态、引脚电压等
这部分是很多开发者从 Linux 完整系统迁移到 RTOS 裸板时的核心难点，建议结合官方参考实现逐函数移植调试。
5. 探索模式与负载开发基础
5.1 探索模式（Pilot）
PSDK 提供“探索模式”，负载可在 Pilot App 中自定义界面并显示状态信息、接收用户交互。开发步骤包括：
- 在负载信息管理器中注册负载属性
- 使用控件组件（Widget）定义界面布局（按钮、列表、开关等）
- 绑定控件事件回调实现交互逻辑
5.2 订阅无人机数据
PSDK 允许订阅飞控的遥测数据，例如：
- 无人机姿态（四元数 / 欧拉角）
- GPS 坐标与高度
- 电池电量与电压
示例代码片段：
// 订阅四元数数据T_PsdkDataChannelHandle dataChannelHandle;PsdkDataChannel_Subscribe(DATA_CHANNEL_QUATERNION,QuaternionCallback,&dataChannelHandle);5.3 控制权获取
部分高级功能（如云台控制）需要请求控制权。PSDK 通过权限管理模块实现多源控制权切换，避免冲突。
6. 调试技巧与常见问题排查
6.1 日志输出与级别控制
- 利用
PsdkLogger_SetLevel()调节日志详细度 - 调试阶段建议开启 DEBUG 级别日志，可通过串口工具实时查看
6.2 常见连接失败问题
| 现象 | 可能原因 | 排查方向 |
|---|---|---|
| PSDK 初始化超时 | 串口未正确连接或波特率不匹配 | 检查/dev/ttyAMA0及其配置参数 |
| 飞控无响应 | App Key 与 App ID 不匹配 | 重新核对官方应用信息 |
| 硬件识别失败 | SkyPort/X-Port 未正确供电 | 测量引脚电压，确认硬件接线 |
7. 学习路线图与进阶方向
7.1 推荐学习阶段
- 第一阶段（入门）：在 Raspberry Pi 上跑通官方 Demo，理解代码结构
- 第二阶段（基础开发）：修改 Demo，实现自定义负载功能（如 GPIO 控制 LED）
- 第三阶段（深入 HAL）：尝试在 STM32 或其他 RTOS 平台移植 PSDK
- 第四阶段（应用集成）：开发自定义传感器驱动，并将数据回传至飞控或地面站
8. 总结
本文以 DJI PSDK 官方快速入门文档为依据，结合 Linux 环境下的 Raspberry Pi 平台，梳理了 PSDK 学习过程中的关键知识点，包括开发环境搭建、Demo 编译运行、HAL 移植、数据订阅及常见问题排查等。后续可在此基础上深入探索模式开发、多负载协同等功能模块。
