DJI Core

2024-04-02
暂无评分

PSDK Core相关功能的头文件为dji_core.h,本文档描述了dji_core.h 文件中结构体和函数原型的关键信息和使用方法。

目录

宏定义、枚举与结构体

T_DjiUserInfo

函数原型

DjiCore_Init
DjiCore_SetAlias
DjiCore_SetFirmwareVersion
DjiCore_SetSerialNumber
DjiCore_ApplicationStart
DjiCore_DeInit

宏定义、枚举与结构体

typedef struct T_DjiUserInfo

本结构体用于描述基于PSDK开发的负载的信息。

说明: 请确认Name、ID 和 Key等信息与开发者网站一致。更多信息请查看用户中心open in new window

typedef struct {
    char appName[32]; /*!< 指定 DJI SDK 应用名称。 该信息可通过登录开发者网站 https://developer.dji.com/user/apps/#all 获取。 以“\0”结尾。 */
    char appId[16]; /*!< 指定 DJI SDK 应用 ID。 该信息可通过登录开发者网站 https://developer.dji.com/user/apps/#all 获取。*/
    char appKey[32]; /*!< 指定 DJI SDK 应用密钥。 该信息可通过登录开发者网站 https://developer.dji.com/user/apps/#all 获取。 */
    char appLicense[512]; /*!< 指定 DJI SDK 应用证书. 该信息可通过登录开发者网站 https://developer.dji.com/user/apps/#all 获取。 */
    char developerAccount[64]; /*!< 指定 DJI SDK 开发者账号邮箱。 该信息可通过登录开发者网站 https://developer.dji.com/user/apps/#all 获取。 开发者账号等相关信息需要能够对应。 以“\0”结尾。 */
    char baudRate[7]; /*!< 指定 DJI SDK 通信串口波特率。*/
} T_DjiUserInfo;

函数原型

function DjiCore_Init

功能:初始化 Payload SDK 内核。 product:all

以阻塞模式初始化 Payload SDK 内核。

说明:

  • 这个接口的调用位置需要特别注意,需要在console/OSAL handler函数/HAL handler函数注册完成后调用。 同时,必须在调用其他功能模块接口开始时进行初始化。 您需要正确填写开发者信息,以确保初始化成功。 如需更多说明,请参阅教程“PSDK 初始化”。
  • 该函数在获得正确的飞行器类型和 PSDK 适配器类型之前不会返回。 该逻辑保证飞行器和PSDK适配器在PSDK功能模块和用户程序运行前已经正常启动。 该函数的一般执行时间为 2~4 秒。
T_DjiReturnCode DjiCore_Init(const T_DjiUserInfo *userInfo);
参数
userInfo: 指向 PSDK 应用程序信息的指针。
返回值
根据程序执行的情况输出对应的返回值,详情请参见:DjiErrorCode

function DjiCore_SetAlias

功能:为 DJI 应用或产品设置一个满足条件的别名。 product:all

别名将在 DJI Pilot 中显示(如果存在)。

说明:

  • 仍然需要将从 DJI SDK 开发者网站获取的正确的 DJI APP 名称传递给 DjiCore_Init() 接口。 DJI APP 名称将用于绑定或验证。
  • 别名会在一段时间后生效,最大值为1s。
T_DjiReturnCode DjiCore_SetAlias(const char *productAlias);
参数
productAlias: 指向产品别名字符串的指针,别名以 '\0' 结尾。 字符串的最大长度为 31。如果别名字符串的长度大于 31,别名字符串将被截断并传入。
返回值
根据程序执行的情况输出对应的返回值,详情请参见:DjiErrorCode

function DjiCore_SetFirmwareVersion

功能:为 DJI 应用或产品设置一个自定义的固件版本。 product:all

Note: 负载固件版本会始终显示在 DJI Pilot 负载设置界面上。

T_DjiReturnCode DjiCore_SetFirmwareVersion(T_DjiFirmwareVersion version);
参数
version:设置的自定义的固件版本
返回值
根据程序执行的情况输出对应的返回值,详情请参见:DjiErrorCode

function DjiCore_SetSerialNumber

功能:为 DJI 应用或产品设置一个自定义的序列号。 product:all

Note: 负载自定义序列号会始终显示在 DJI Pilot 负载设置界面上。

T_DjiReturnCode DjiCore_SetSerialNumber(const char *productSerialNumber);
参数
productSerialNumber:自定义的序列号,需要小于 32 字节
返回值
根据程序执行的情况输出对应的返回值,详情请参见:DjiErrorCode

function DjiCore_ApplicationStart

功能:通知 Payload SDK 核心应用程序启动。 product:all

说明: 该接口的调用位置需要特别注意,需要在所有模块初始化和注册接口后完成调用。

T_DjiReturnCode DjiCore_ApplicationStart(void);


返回值
根据程序执行的情况输出对应的返回值,详情请参见:DjiErrorCode

function DjiCore_DeInit

功能:以阻塞模式反初始化 Payload SDK Core product:all
T_DjiReturnCode DjiCore_DeInit(void);
参数
返回值
根据程序执行的情况输出对应的返回值,详情请参见:DjiErrorCode

若您对文档有意见或疑惑,点击可快速反馈,我们会与您联系。