电源管理
PSDK 电源管理相关功能的头文件为dji_power_management.h
,本文档描述了dji_power_management.h
文件中结构体和函数原型的关键信息和使用方法。
目录
宏定义、枚举与结构体
E_DjiPowerManagementPinState
DjiWriteHighPowerApplyPinCallback
DjiPowerOffNotificationCallback函数原型
DjiPowerManagement_Init
DjiPowerManagement_ApplyHighPowerSync
DjiPowerManagement_RegWriteHighPowerApplyPinCallback
DjiPowerManagement_RegPowerOffNotificationCallback
宏定义、枚举与结构体
typedef enum E_DjiPowerManagementPinState
高功率引脚的状态
typedef enum {
DJI_POWER_MANAGEMENT_PIN_STATE_RESET = 0, 引脚为低电压
DJI_POWER_MANAGEMENT_PIN_STATE_SET = 1, 引脚为高电压
} E_DjiPowerManagementPinState;
typedef function DjiWriteHighPowerApplyPinCallback
功能:设置高功率引脚状态 | product:all |
设置高功率引脚状态的回调函数
typedef T_DjiReturnCode (*DjiWriteHighPowerApplyPinCallback)(E_DjiPowerManagementPinState pinState);
pinState:高功率引脚的状态
返回值
根据程序执行的情况输出对应的返回值,详情请参见:DjiErrorCode
typedef function DjiPowerOffNotificationCallback
功能:关机通知 | product:all |
通知负载设备无人机将要关机并获取负载设备关机准备状态的回调函数
说明: 为防止该函数阻塞PSDK 的主线程,导致出现程序响应缓慢、相机类负载设备断连及死循环等问题,请勿以阻塞的方式在回调函数中执行该函数。
typedef T_DjiReturnCode (*DjiPowerOffNotificationCallback)(bool *powerOffPreparationFlag);
powerOffPreparationFlag:指向用于存储关机准备状态的内存空间
返回值
根据程序执行的情况输出对应的返回值,详情请参见:DjiErrorCode
函数原型
function DjiPowerManagement_Init
功能:初始化电源管理模块 | product:all |
初始化电源管理模块,用户在使用电源管理功能前应调用该函数。
T_DjiReturnCode DjiPowerManagement_Init(void);
返回值
根据程序执行的情况输出对应的返回值,详情请参见:DjiErrorCode
function DjiPowerManagement_ApplyHighPowerSync
功能:在阻塞模式下从飞机施加高功率。 | product:all |
在应用之前,用户应该使用 DjiPowerManagement_RegWriteHighPowerApplyPinCallback() 函数注册回调函数,用于设置高功率应用引脚的电平状态。 施加大功率后,DJI 适配器的电源引脚将根据预定规格输出大功率。 该函数的最大执行时间略大于 600ms。
T_DjiReturnCode DjiPowerManagement_ApplyHighPowerSync(void);
返回值
根据程序执行的情况输出对应的返回值,详情请参见:DjiErrorCode
function DjiPowerManagement_RegWriteHighPowerApplyPinCallback
功能:用于设置高功率应用引脚的电平状态的注册回调函数 | product:all |
注册回调函数,用于设置高功率应用引脚的电平状态。 必须在应用高功率之前调用。
T_DjiReturnCode DjiPowerManagement_RegWriteHighPowerApplyPinCallback(DjiWriteHighPowerApplyPinCallback callback);
callback:指向回调函数的指针
返回值
根据程序执行的情况输出对应的返回值,详情请参见:DjiErrorCode
function DjiPowerManagement_RegPowerOffNotificationCallback
功能:用于通知payload飞机即将关机并获取payload是否准备好关机状态的注册回调函数 | product:all |
注册完成后,会在飞行器关机时以固定频率调用回调函数。 用户填写关机准备标志,一旦payload准备关机,回调函数将不会被调用。 在指定时间后,如果负载未准备好关机,飞行器将立即关机。 指定时间为 10s。
T_DjiReturnCode DjiPowerManagement_RegPowerOffNotificationCallback(DjiPowerOffNotificationCallback callback);
callback:指向回调函数的指针,用于通知飞机关机消息并获取有效载荷关机准备标志
返回值
根据程序执行的情况输出对应的返回值,详情请参见:DjiErrorCode