Skip to main content

UAV Core

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

目录​

  • 宏定义、枚举与结构体
    T_UAVUserInfo

  • 函数原型
    UAV_Core_Init
    UAV_Core_SetAlias
    UAV_Core_SetFirmwareVersion
    UAV_Core_ApplicationStart
    UAV_Core_DeInit

宏定义、枚举与结构体​

typedef struct T_UAVUserInfo​

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

说明：

  • 请确认Name、ID和Key等信息与开发者网站一致。更多信息请查看用户中心。
typedef struct {
    char appName[32]; /*!< Specifies autelrobotics SDK app name. This info can be obtained by logging in to the
                           developer website https://developer.autelrobotics.com/user/apps/#all. End with '\0'. */
    char appId[16]; /*!< Specifies autelrobotics SDK app ID. This info can be obtained by logging in to the
                         developer website https://developer.autelrobotics.com/user/apps/#all. */
    char appKey[32]; /*!< Specifies autelrobotics SDK app key. This info can be obtained by logging in to the
                          developer website https://developer.autelrobotics.com/user/apps/#all. */
    char appLicense[512]; /*!< Specifies autelrobotics SDK app license. This info can be obtained by logging in to the
                               developer website https://developer.autelrobotics.com/user/apps/#all. */
    char developerAccount[64]; /*!< Specifies autelrobotics SDK developer account email. This info can be obtained by
                                    logging in to the developer website https://developer.autelrobotics.com/user/apps/#all.
                                    Developer's account and other related information need to be able to correspond.
                                    End with '\0'. */
    char baudRate[7]; /*!< Specify the autel SDK to communicate the port rate.*/
} T_UAVUserInfo;

函数原型​

function UAV_Core_Init​

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

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

说明：

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

function UAV_Core_SetAlias​

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

    说明：

    • 仍然需要将从开发者网站获取的正确的 App 名称传递给 UAV_Core_Init() 接口。App 名称将用于绑定或验证。
    • 该函数在获得正确的无人机类型和 PSDK 适配器类型之前不会返回。该逻辑保证无人机和 PSDK 适配器在 PSDK 功能模块和用户程序运行前已经正常启动。该函数的一般执行时间为 2 - 4 秒。
T_UAVReturnCode UAV_Core_SetAlias(const char *productAlias);
  • 参数productAlias：指向产品别名字符串的指针，别名以 '\0' 结尾。 字符串的最大长度为 31。如果别名字符串的长度大于 31，别名字符串将被截断并传入。
  • 返回值 根据程序执行的情况输出对应的返回值，详情请参见：UAV 错误码。

function UAV_Core_SetFirmwareVersion​

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

    说明：

    • 负载固件版本会始终显示在负载设置界面上。
T_UAVReturnCode UAV_Core_SetFirmwareVersion(T_UAVFirmwareVersion version);
  • 参数version：设置的自定义的固件版本。
  • 返回值 根据程序执行的情况输出对应的返回值，详情请参见：UAV 错误码。

function UAV_Core_ApplicationStart​

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

    说明：

    • 该接口的调用位置需要特别注意，需要在所有模块初始化和注册接口后完成调用。
T_UAVReturnCode UAV_Core_ApplicationStart(void);
  • 参数none：
  • 返回值 根据程序执行的情况输出对应的返回值，详情请参见：UAV 错误码。

function UAV_Core_DeInit​

  • 功能： 以阻塞模式反初始化 Payload SDK Core
  • product： all。
T_UAVReturnCode UAV_Core_DeInit(void);
  • 参数none：
  • 返回值 根据程序执行的情况输出对应的返回值，详情请参见：UAV 错误码。