新增静态库及配置
This commit is contained in:
LokLiang
19
components/lib/CMakeLists.txt
Normal file
19
components/lib/CMakeLists.txt
Normal file
@@ -0,0 +1,19 @@
|
||||
list(APPEND incs ".")
|
||||
list(APPEND incs "../system/include")
|
||||
list(APPEND incs "../system/source")
|
||||
list(APPEND incs "../../app")
|
||||
|
||||
list(APPEND srcs "lib_shell.c")
|
||||
|
||||
idf_component_register(
|
||||
INCLUDE_DIRS ${incs}
|
||||
SRCS ${srcs}
|
||||
)
|
||||
|
||||
if(CONFIG_IDF_TARGET_ESP32S3)
|
||||
target_link_libraries(${COMPONENT_TARGET} INTERFACE "${CMAKE_CURRENT_LIST_DIR}/spbelib_s3.a")
|
||||
elseif(CONFIG_IDF_TARGET_ESP32C2)
|
||||
target_link_libraries(${COMPONENT_TARGET} INTERFACE "${CMAKE_CURRENT_LIST_DIR}/spbelib_c2.a")
|
||||
else(CONFIG_IDF_TARGET_ESP32C3)
|
||||
target_link_libraries(${COMPONENT_TARGET} INTERFACE "${CMAKE_CURRENT_LIST_DIR}/spbelib_c3.a")
|
||||
endif()
|
||||
317
components/lib/lib_shell.c
Normal file
317
components/lib/lib_shell.c
Normal file
@@ -0,0 +1,317 @@
|
||||
#include "lib_shell.h"
|
||||
#include "shell/sh.h"
|
||||
#include "shell/sh_vset.h"
|
||||
#include "spbelib_interface.h"
|
||||
#include "config/app_config.h"
|
||||
|
||||
#include <string.h>
|
||||
|
||||
#undef CONFIG_SYS_LOG_LEVEL
|
||||
#define CONFIG_SYS_LOG_LEVEL SYS_LOG_LEVEL_INF
|
||||
#include "sys_log.h"
|
||||
|
||||
static void _print_event(void);
|
||||
SH_CMD_FN(_set_adapter_fcport_off); // set adapter fcport-off
|
||||
SH_CMD_FN(_set_adapter_fcport_uart); // set adapter fcport-uart
|
||||
SH_CMD_FN(_set_adapter_fcport_otg); // set adapter fcport-otg
|
||||
SH_CMD_FN(_set_adapter_rf_off); // set adapter rf-off
|
||||
SH_CMD_FN(_set_adapter_rf_ble); // set adapter rf-ble
|
||||
SH_CMD_FN(_set_adapter_rf_ap); // set adapter rf-ap
|
||||
SH_CMD_FN(_set_adapter_rf_sta); // set adapter rf-sta
|
||||
SH_CMD_FN(_set_ble_name); // set ble name <...>
|
||||
SH_CMD_FN(_set_ble_passwd); // set ble passwd <...>
|
||||
SH_CMD_FN(_set_wifi_ap_ssid); // set wifi ap-ssid <...>
|
||||
SH_CMD_FN(_set_wifi_ap_passwd); // set wifi ap-passwd <...>
|
||||
SH_CMD_FN(_set_wifi_sta_ssid); // set wifi sta-ssid <...>
|
||||
SH_CMD_FN(_set_wifi_sta_passwd); // set wifi sta-passwd <...>
|
||||
SH_CMD_FN(_get_adapter_rf_status); // get adapter adapter rf-status
|
||||
SH_CMD_FN(_get_ble_name); // get ble name
|
||||
SH_CMD_FN(_get_ble_passwd); // get ble passwd
|
||||
SH_CMD_FN(_get_wifi_ap_ssid); // get wifi ap-ssid
|
||||
SH_CMD_FN(_get_wifi_ap_passwd); // get wifi ap-passwd
|
||||
SH_CMD_FN(_get_wifi_sta_ssid); // get wifi sta-ssid
|
||||
SH_CMD_FN(_get_wifi_sta_passwd); // get wifi sta-passwd
|
||||
|
||||
SH_DEF_SUB_CMD(
|
||||
_sub_set_adapter,
|
||||
SH_SETUP_CMD("fcport-off", "关闭飞控数据接口", _set_adapter_fcport_off, NULL), // set adapter fcport-off
|
||||
SH_SETUP_CMD("fcport-uart", "使用 UART 连接飞控", _set_adapter_fcport_uart, NULL), // set adapter fcport-uart
|
||||
SH_SETUP_CMD("fcport-otg", "使用 OTG 连接飞控", _set_adapter_fcport_otg, NULL), // set adapter fcport-otg
|
||||
|
||||
SH_SETUP_CMD("rf-off", "关闭无线功能", _set_adapter_rf_off, NULL), // set adapter rf-off
|
||||
SH_SETUP_CMD("rf-ble", "打开蓝牙功能", _set_adapter_rf_ble, NULL), // set adapter rf-ble
|
||||
SH_SETUP_CMD("rf-ap", "打开 AP 功能", _set_adapter_rf_ap, NULL), // set adapter rf-ap
|
||||
SH_SETUP_CMD("rf-sta", "打开 STA 功能", _set_adapter_rf_sta, NULL), // set adapter rf-sta
|
||||
);
|
||||
|
||||
SH_DEF_SUB_CMD(
|
||||
_sub_set_opt,
|
||||
SH_SETUP_CMD("adapter", "设置小黄砖功能", NULL, _sub_set_adapter), // set adapter <...>
|
||||
);
|
||||
|
||||
SH_DEF_SUB_CMD(
|
||||
_sub_set_ble,
|
||||
SH_SETUP_CMD("name", "设置 BLE 设备名， 1 到 19 个字符", _set_ble_name, NULL), // set ble name <...>
|
||||
SH_SETUP_CMD("passwd", "设置 BLE 透传密码， 0 到 12 个字符", _set_ble_passwd, NULL), // set ble passwd <...>
|
||||
);
|
||||
SH_DEF_SUB_CMD(
|
||||
_sub_set_wifi,
|
||||
SH_SETUP_CMD("ap-ssid", "参数", _set_wifi_ap_ssid, NULL), // set wifi ap-ssid <...>
|
||||
SH_SETUP_CMD("ap-passwd", "参数", _set_wifi_ap_passwd, NULL), // set wifi ap-passwd <...>
|
||||
SH_SETUP_CMD("sta-ssid", "参数", _set_wifi_sta_ssid, NULL), // set wifi sta-ssid <...>
|
||||
SH_SETUP_CMD("sta-passwd", "参数", _set_wifi_sta_passwd, NULL), // set wifi sta-passwd <...>
|
||||
);
|
||||
|
||||
SH_DEF_SUB_CMD(
|
||||
_sub_set_param,
|
||||
SH_SETUP_CMD("ble", "参数", NULL, _sub_set_ble), // set ble <...>
|
||||
SH_SETUP_CMD("wifi", "参数", NULL, _sub_set_wifi), // set wifi <...>
|
||||
);
|
||||
|
||||
SH_DEF_SUB_CMD(
|
||||
_sub_get_adapter,
|
||||
SH_SETUP_CMD("rf-status", "查询小黄砖射频状态", _get_adapter_rf_status, NULL), // get adapter rf-status
|
||||
);
|
||||
|
||||
SH_DEF_SUB_CMD(
|
||||
_sub_get_ble,
|
||||
SH_SETUP_CMD("name", "打印 BLE 设备名", _get_ble_name, NULL), // get ble name
|
||||
SH_SETUP_CMD("passwd", "打印 BLE 透传密码", _get_ble_passwd, NULL), // get ble passwd
|
||||
);
|
||||
|
||||
SH_DEF_SUB_CMD(
|
||||
_sub_get_wifi,
|
||||
SH_SETUP_CMD("ap-ssid", "参数", _get_wifi_ap_ssid, NULL), // get wifi ap-ssid
|
||||
SH_SETUP_CMD("ap-passwd", "参数", _get_wifi_ap_passwd, NULL), // get wifi ap-passwd
|
||||
SH_SETUP_CMD("sta-ssid", "参数", _get_wifi_sta_ssid, NULL), // get wifi sta-ssid
|
||||
SH_SETUP_CMD("sta-passwd", "参数", _get_wifi_sta_passwd, NULL), // get wifi sta-passwd
|
||||
);
|
||||
|
||||
SH_DEF_SUB_CMD(
|
||||
_sub_get,
|
||||
SH_SETUP_CMD("adapter", "打印当前射频状态", NULL, _sub_get_adapter), // get adapter <...>
|
||||
SH_SETUP_CMD("ble", "参数", NULL, _sub_get_ble), // get ble <...>
|
||||
SH_SETUP_CMD("wifi", "参数", NULL, _sub_get_wifi), // get wifi <...>
|
||||
);
|
||||
|
||||
SH_DEF_CMD(
|
||||
_register_cmd,
|
||||
SH_SETUP_CMD("set", "执行控制动作", NULL, _sub_set_opt), // set <...>
|
||||
SH_SETUP_CMD("set", "执行参数设置", NULL, _sub_set_param), // set <...>
|
||||
SH_SETUP_CMD("get", "获取状态", NULL, _sub_get), // get <...>
|
||||
);
|
||||
|
||||
void lib_shell_register(void)
|
||||
{
|
||||
SYS_LOG_INF("Register notify event");
|
||||
sblib_regist_notify_event(_print_event);
|
||||
_print_event();
|
||||
sh_register_cmd(&_register_cmd);
|
||||
}
|
||||
|
||||
SH_CMD_FN(_set_adapter_fcport_off)
|
||||
{
|
||||
return sblib_control(LIB_CONTROL_FCPORT_OFF);
|
||||
}
|
||||
SH_CMD_FN(_set_adapter_fcport_uart)
|
||||
{
|
||||
return sblib_control(LIB_CONTROL_FCPORT_UART);
|
||||
}
|
||||
SH_CMD_FN(_set_adapter_fcport_otg)
|
||||
{
|
||||
return sblib_control(LIB_CONTROL_FCPORT_OTG);
|
||||
}
|
||||
|
||||
SH_CMD_FN(_set_adapter_rf_off)
|
||||
{
|
||||
return sblib_control(LIB_CONTROL_RF_OFF);
|
||||
}
|
||||
SH_CMD_FN(_set_adapter_rf_ble)
|
||||
{
|
||||
return sblib_control(LIB_CONTROL_RF_BLE);
|
||||
}
|
||||
SH_CMD_FN(_set_adapter_rf_ap)
|
||||
{
|
||||
return sblib_control(LIB_CONTROL_RF_AP);
|
||||
}
|
||||
SH_CMD_FN(_set_adapter_rf_sta)
|
||||
{
|
||||
return sblib_control(LIB_CONTROL_RF_STA);
|
||||
}
|
||||
|
||||
SH_CMD_FN(_set_ble_name)
|
||||
{
|
||||
int len = 0;
|
||||
int ret = -1;
|
||||
if (argc > 0)
|
||||
{
|
||||
len = strlen(argv[0]);
|
||||
}
|
||||
|
||||
ret = app_cfg_set_device_name_ble(argv[0], len);
|
||||
if (ret == 0)
|
||||
{
|
||||
sblib_send_event(LIB_EVENT_BLE_NAME_SET, 0, NULL);
|
||||
}
|
||||
return ret;
|
||||
}
|
||||
|
||||
SH_CMD_FN(_set_ble_passwd)
|
||||
{
|
||||
int len = 0;
|
||||
int ret = -1;
|
||||
if (argc > 0)
|
||||
{
|
||||
len = strlen(argv[0]);
|
||||
}
|
||||
|
||||
ret = app_cfg_set_psPassword(argv[0], len);
|
||||
if (ret == 0)
|
||||
{
|
||||
sblib_send_event(LIB_EVENT_BLE_PASSWD_SET, 0, NULL);
|
||||
}
|
||||
return ret;
|
||||
}
|
||||
|
||||
SH_CMD_FN(_set_wifi_ap_ssid)
|
||||
{
|
||||
int ret = app_cfg_set_wifi_ap_ssid(argv[0]);
|
||||
if (ret == 0)
|
||||
{
|
||||
sblib_send_event(LIB_EVENT_WIFI_AP_SSID_SET, 0, NULL);
|
||||
}
|
||||
return ret;
|
||||
}
|
||||
|
||||
SH_CMD_FN(_set_wifi_ap_passwd)
|
||||
{
|
||||
int ret = app_cfg_set_wifi_ap_password(argv[0]);
|
||||
if (ret == 0)
|
||||
{
|
||||
sblib_send_event(LIB_EVENT_WIFI_AP_PASSWD_SET, 0, NULL);
|
||||
}
|
||||
return ret;
|
||||
}
|
||||
|
||||
SH_CMD_FN(_set_wifi_sta_ssid)
|
||||
{
|
||||
int ret = app_cfg_set_wifi_sta_ssid(argv[0]);
|
||||
if (ret == 0)
|
||||
{
|
||||
sblib_send_event(LIB_EVENT_WIFI_STA_SSID_SET, 0, NULL);
|
||||
}
|
||||
return ret;
|
||||
}
|
||||
|
||||
SH_CMD_FN(_set_wifi_sta_passwd)
|
||||
{
|
||||
int ret = app_cfg_set_wifi_sta_password(argv[0]);
|
||||
if (ret == 0)
|
||||
{
|
||||
sblib_send_event(LIB_EVENT_WIFI_STA_PASSWD_SET, 0, NULL);
|
||||
}
|
||||
return ret;
|
||||
}
|
||||
|
||||
SH_CMD_FN(_get_adapter_rf_status)
|
||||
{
|
||||
static const char *const rf_mode_tab[] = {
|
||||
[DATA_BRIDGE_RF_MODE_OFF] = "无线已关闭",
|
||||
[DATA_BRIDGE_RF_MODE_BLE] = "蓝牙模式",
|
||||
[DATA_BRIDGE_RF_MODE_WIFI_AP] = "AP 模式",
|
||||
[DATA_BRIDGE_RF_MODE_WIFI_STA] = "STA 模式",
|
||||
};
|
||||
sh_echo(sh_hdl, "当前射频状态：%s\r\n", rf_mode_tab[g_cfg_app->rf_mode]);
|
||||
return 0;
|
||||
}
|
||||
|
||||
SH_CMD_FN(_get_ble_name)
|
||||
{
|
||||
char ble_name[__ARRAY_SIZE(g_cfg_app->device_name_ble) + 1] = {0};
|
||||
memcpy(ble_name, g_cfg_app->device_name_ble, sizeof(g_cfg_app->device_name_ble));
|
||||
sh_echo(sh_hdl, "%s\r\n", ble_name);
|
||||
return 0;
|
||||
}
|
||||
SH_CMD_FN(_get_ble_passwd)
|
||||
{
|
||||
char passwd[__ARRAY_SIZE(g_cfg_app->psPassword) + 1] = {0};
|
||||
memcpy(passwd, g_cfg_app->psPassword, sizeof(g_cfg_app->psPassword));
|
||||
sh_echo(sh_hdl, "%s\r\n", passwd);
|
||||
return 0;
|
||||
}
|
||||
|
||||
SH_CMD_FN(_get_wifi_ap_ssid)
|
||||
{
|
||||
sh_echo(sh_hdl, "%s\r\n", g_cfg_app->app_config_wifi_para.wifi_ap_ssid);
|
||||
return 0;
|
||||
}
|
||||
SH_CMD_FN(_get_wifi_ap_passwd)
|
||||
{
|
||||
sh_echo(sh_hdl, "%s\r\n", g_cfg_app->app_config_wifi_para.wifi_ap_password);
|
||||
return 0;
|
||||
}
|
||||
SH_CMD_FN(_get_wifi_sta_ssid)
|
||||
{
|
||||
sh_echo(sh_hdl, "%s\r\n", g_cfg_app->app_config_wifi_para.wifi_sta_ssid);
|
||||
return 0;
|
||||
}
|
||||
SH_CMD_FN(_get_wifi_sta_passwd)
|
||||
{
|
||||
sh_echo(sh_hdl, "%s\r\n", g_cfg_app->app_config_wifi_para.wifi_sta_password);
|
||||
return 0;
|
||||
}
|
||||
|
||||
static void _print_event(void)
|
||||
{
|
||||
lib_event_t event;
|
||||
|
||||
do
|
||||
{
|
||||
static const char *const type_tab[] = {
|
||||
[LIB_EVENT_NONE] = "未新事件",
|
||||
|
||||
[LIB_EVENT_FC_PORT_OFF] = "飞控数据接口关闭",
|
||||
[LIB_EVENT_FC_PORT_UART] = "飞控数据接口为 UART",
|
||||
[LIB_EVENT_FC_PORT_OTG] = "飞控数据接口为 OTG",
|
||||
|
||||
[LIB_EVENT_USBH_NO_START] = "USBH 接口未启动",
|
||||
[LIB_EVENT_USBH_CDC] = "USBH 接口已连接 CDC 设备",
|
||||
[LIB_EVENT_USBH_DFU] = "USBH 接口已连接 DFU 设备",
|
||||
[LIB_EVENT_USBH_MSC] = "USBH 接口已连接 MSC 设备",
|
||||
[LIB_EVENT_USBH_UNKNOW_DEVICE] = "USBH 接口已连接未知设备",
|
||||
|
||||
[LIB_EVENT_RF_OFF] = "射频已关闭",
|
||||
[LIB_EVENT_RF_CHANGE_MODE] = "已准备好切换模式",
|
||||
[LIB_EVENT_RF_BLE_IDLE] = "当前为 BLE 模式，未有设备连接",
|
||||
[LIB_EVENT_RF_BLE_CONNECTED] = "当前为 BLE 模式，已连接",
|
||||
[LIB_EVENT_RF_AP_IDLE] = "当前为 AP 模式，未有设备连接",
|
||||
[LIB_EVENT_RF_AP_CONNECTED] = "当前为 AP 模式，已连接",
|
||||
[LIB_EVENT_RF_STA_IDLE] = "当前为 STA 模式，未连接到 AP",
|
||||
[LIB_EVENT_RF_STA_CONNECTED] = "当前为 STA 模式，已连接",
|
||||
[LIB_EVENT_BLE_NAME_SET] = "BLE 名称已设置",
|
||||
[LIB_EVENT_BLE_PASSWD_SET] = "BLE 密码已设置",
|
||||
[LIB_EVENT_WIFI_AP_SSID_SET] = "WIFI AP SSID 已设置",
|
||||
[LIB_EVENT_WIFI_AP_PASSWD_SET] = "WIFI AP 密码已设置",
|
||||
[LIB_EVENT_WIFI_STA_SSID_SET] = "WIFI STA SSID 已设置",
|
||||
[LIB_EVENT_WIFI_STA_PASSWD_SET] = "WIFI STA 密码已设置",
|
||||
};
|
||||
event = sblib_get_event();
|
||||
if (event.type != LIB_EVENT_NONE)
|
||||
{
|
||||
if (event.type < __ARRAY_SIZE(type_tab) && type_tab[event.type] != NULL)
|
||||
{
|
||||
SYS_LOG_INF("******** Event: %s ********", type_tab[event.type]);
|
||||
}
|
||||
else
|
||||
{
|
||||
SYS_LOG_WRN("******** Unknown event: %d ********", event.type);
|
||||
}
|
||||
|
||||
if (event.len > 0)
|
||||
{
|
||||
SYS_LOG_DUMP(event.data, event.len, 0, 0);
|
||||
}
|
||||
}
|
||||
|
||||
} while (event.type != LIB_EVENT_NONE);
|
||||
}
|
||||
14
components/lib/lib_shell.h
Normal file
14
components/lib/lib_shell.h
Normal file
@@ -0,0 +1,14 @@
|
||||
/**
|
||||
* @file lib_shell.h
|
||||
* @author your name (you@domain.com)
|
||||
* @brief 通过 shell 演示和操作 spbelib.a 的功能
|
||||
* @version 0.1
|
||||
* @date 2025-04-07
|
||||
*
|
||||
* @copyright Copyright (c) 2025
|
||||
*
|
||||
*/
|
||||
|
||||
#pragma once
|
||||
|
||||
void lib_shell_register(void);
|
||||
194
components/lib/spbelib_interface.h
Normal file
194
components/lib/spbelib_interface.h
Normal file
@@ -0,0 +1,194 @@
|
||||
/**
|
||||
* @file spbelib_interface.h
|
||||
* @author LokLiang
|
||||
* @brief 无线调参功能接口
|
||||
* @version 0.1
|
||||
* @date 2025-03-14
|
||||
*
|
||||
* @copyright Copyright (c) 2025
|
||||
*
|
||||
*/
|
||||
|
||||
#pragma once
|
||||
|
||||
#include "sys_types.h"
|
||||
|
||||
typedef enum
|
||||
{
|
||||
SBLIB_INIT_WIRE_TUNE = 0, // 初始化为无线调参功能
|
||||
SBLIB_INIT_ADAPTER, // 初始化为 静态库 功能
|
||||
} sblib_init_t;
|
||||
|
||||
/**
|
||||
* @brief 初始化功能库。
|
||||
*/
|
||||
void sblib_init(sblib_init_t init_type);
|
||||
|
||||
/*************************************************************************************************/
|
||||
/**** 事件操作部分 ********************************************************************************/
|
||||
/*************************************************************************************************/
|
||||
|
||||
/**
|
||||
* @brief 注册事件回调函数。
|
||||
* 当有关于静态库功能的事件发生或接收到数据时，调用回调函数。
|
||||
* 由 lib_notify_event() 和 sblib_notify_datastream() 函数调用。
|
||||
*/
|
||||
typedef void (*lib_notify_cb)(void);
|
||||
|
||||
typedef enum __packed // 静态库功能控制命令
|
||||
{
|
||||
LIB_CONTROL_FCPORT_OFF, // 关闭飞控数据接口
|
||||
LIB_CONTROL_FCPORT_UART, // 使用 UART 连接飞控
|
||||
LIB_CONTROL_FCPORT_OTG, // 使用 OTG 连接飞控
|
||||
|
||||
LIB_CONTROL_RF_OFF, // 关闭射频连接
|
||||
LIB_CONTROL_RF_BLE, // 打开 BLE
|
||||
LIB_CONTROL_RF_AP, // 打开 WIFI(AP)
|
||||
LIB_CONTROL_RF_STA, // 打开 WIFI(STA)
|
||||
} lib_control_t;
|
||||
|
||||
typedef enum __packed // 通知的事件类型
|
||||
{
|
||||
LIB_EVENT_NONE = 0,
|
||||
|
||||
LIB_EVENT_FC_PORT_OFF, // 飞控数据接口关闭。参数：无
|
||||
LIB_EVENT_FC_PORT_UART, // 飞控数据接口为串口。参数：无
|
||||
LIB_EVENT_FC_PORT_OTG, // 飞控数据接口为 USBH。参数：无
|
||||
|
||||
LIB_EVENT_USBH_NO_START, // USBH 接口未启动。参数：无
|
||||
LIB_EVENT_USBH_CDC, // USBH 接口已连接 CDC 设备。参数：无
|
||||
LIB_EVENT_USBH_DFU, // USBH 接口已连接 DFU 设备。参数：无
|
||||
LIB_EVENT_USBH_MSC, // USBH 接口已连接 MSC 设备。参数：无
|
||||
LIB_EVENT_USBH_UNKNOW_DEVICE, // USBH 接口已连接未知设备。参数：无
|
||||
|
||||
LIB_EVENT_RF_OFF, // 无线连接已关闭。参数：无
|
||||
LIB_EVENT_RF_CHANGE_MODE, // 提示模式切换已就绪。参数：无
|
||||
LIB_EVENT_RF_BLE_IDLE, // 蓝牙模式未连接。参数：无
|
||||
LIB_EVENT_RF_BLE_CONNECTED, // 蓝牙模式已连接。参数：无
|
||||
LIB_EVENT_RF_AP_IDLE, // WIFI AP 模式未连接。参数：无
|
||||
LIB_EVENT_RF_AP_CONNECTED, // WIFI AP 模式已连接。参数：无
|
||||
LIB_EVENT_RF_STA_IDLE, // WIFI STA 模式未连接。参数：无
|
||||
LIB_EVENT_RF_STA_CONNECTED, // WIFI STA 模式已连接。参数：已连接设备的 MAC 地址
|
||||
|
||||
LIB_EVENT_BLE_NAME_SET, // BLE 名称已设置。参数：无
|
||||
LIB_EVENT_BLE_PASSWD_SET, // BLE 密码已设置。参数：无
|
||||
LIB_EVENT_WIFI_AP_SSID_SET, // WIFI AP SSID 已设置。参数：无
|
||||
LIB_EVENT_WIFI_AP_PASSWD_SET, // WIFI AP 密码已设置。参数：无
|
||||
LIB_EVENT_WIFI_STA_SSID_SET, // WIFI STA SSID 已设置。参数：无
|
||||
LIB_EVENT_WIFI_STA_PASSWD_SET, // WIFI STA 密码已设置。参数：无
|
||||
|
||||
LIB_EVENT_MAX
|
||||
} lib_event_type_t;
|
||||
|
||||
typedef struct // 静态库通知的事件数据
|
||||
{
|
||||
lib_event_type_t type; // 事件类型
|
||||
uint8_t len; // data[] 有效数据长度
|
||||
uint8_t data[6]; // 事件数据
|
||||
} lib_event_t;
|
||||
|
||||
/**
|
||||
* @brief 执行对静态库功能的控制。
|
||||
*
|
||||
* @param control 控制命令
|
||||
* @retval 0 表示成功； -1 表示失败。
|
||||
*/
|
||||
int sblib_control(lib_control_t control);
|
||||
|
||||
/**
|
||||
* @brief 注册事件回调函数。
|
||||
* 当有关于静态库的新事件发生时，将调用指定的回调函数以通知上层应用。
|
||||
* 内部可缓存的记录数为 32 个。
|
||||
* 使用 sblib_get_event() 可读取这些记录，读取后会清除记录。
|
||||
*
|
||||
* @param cb 指定的回调函数。建议在回调函数中执行发送信号的操作。
|
||||
*/
|
||||
void sblib_regist_notify_event(lib_notify_cb cb);
|
||||
|
||||
/**
|
||||
* @brief 获取静态库的事件。线程和中断可用。
|
||||
*
|
||||
* @return lib_event_t
|
||||
*/
|
||||
lib_event_t sblib_get_event(void);
|
||||
|
||||
/**
|
||||
* @brief 发送通知。
|
||||
* 通知信息保存到内部队列中，长度为 32。
|
||||
* 每次发送通知时，由 sblib_regist_notify_event() 注册的回调函数会被调用。
|
||||
* @param type 事件类型
|
||||
* @param len 事件数据长度。范围 0..6。如果取值大于最大值时，事件数据被截断。
|
||||
* @param data 事件数据
|
||||
*/
|
||||
void sblib_send_event(lib_event_type_t type, uint8_t len, const uint8_t data[]);
|
||||
|
||||
/*************************************************************************************************/
|
||||
/**** 通过无线接口与 APP 通讯部分 ******************************************************************/
|
||||
/*************************************************************************************************/
|
||||
|
||||
/**
|
||||
* @brief 当无线接口接收到 APP 数据时的回调函数。
|
||||
* @param port 收到的端口号，这个号码与注册时的 port 一致。
|
||||
* @param cmd 收到的命令代号，这个号码与注册时的 cmd 一致。
|
||||
* @param payload 收到的数据指针，指向数据的内存地址。
|
||||
* @param size 收到的数据长度。
|
||||
*/
|
||||
typedef void (*cmd_func_cb)(uint8_t port, uint8_t cmd, const void *payload, uint16_t size);
|
||||
|
||||
typedef enum
|
||||
{
|
||||
SBLIB_CMD_PORT_DEBUG = 0, // 保留的端口，用于 debug 等
|
||||
SBLIB_CMD_PORT_ADAPTER, // 无线调参扩展命令集
|
||||
SBLIB_CMD_PORT_FINDTAG, // 寻机命令集
|
||||
SBLIB_CMD_PORT_JOYSTICK, // 遥控器命令集
|
||||
SBLIB_CMD_PORT_ELRS, // 接收机命令集
|
||||
} sblib_cmd_port_t;
|
||||
|
||||
typedef struct // 注册命令的结构体
|
||||
{
|
||||
uint8_t cmd; // 命令代号
|
||||
cmd_func_cb cb; // 命令处理函数
|
||||
} sblib_cmd_t;
|
||||
|
||||
typedef enum // 返回的发送状态
|
||||
{
|
||||
SBLIB_SEND_STATUS_OK = 0, // 当前等发送数据已缓存到待发送区中，数据将会被发送
|
||||
SBLIB_SEND_STATUS_NO_SPACE, // 当前没有缓存空间，数据不会被处理
|
||||
SBLIB_SEND_STATUS_NO_CONNECT, // 当前没有连接，数据不会被处理
|
||||
} sblib_cmd_send_status_t;
|
||||
|
||||
/**
|
||||
* @brief 注册一个通过无线接口接收 APP 数据的外部命令集。
|
||||
* 当收到 APP 发出的命令和数据时，会调 cmd_struct 中对应的 port 和 cmd 的函数。
|
||||
* 回调过程中允许调用 sblib_send_event() 向 APP 发送数据。
|
||||
* 注意：回调函数附带的参数不会被缓存，并且必须尽快处理，如果需要缓存需要自行处理。
|
||||
*
|
||||
* @param port 端口号。一个端口号对应一个应用的命令集合标识，具体序号由收发双方的应用层协商，一旦确定后，不能更改。收发双向都使用同一个端口号。
|
||||
* @param cmd_struct 指向一个命令集合的结构体数组。这个命令集合与参数 port 绑定。当收到 APP 发出的命令时，会调 cmd_struct 中对应的 port 和 cmd 的函数。
|
||||
* @param struct_size 命令集结构体大小。使用 sizeof() 计算。
|
||||
* @retval 0 成功
|
||||
* @retval -1 失败：内置预设的命令集已满，无法注册新的命令集。
|
||||
*/
|
||||
int sblib_register_cmd(sblib_cmd_port_t port, const sblib_cmd_t *cmd_struct, uint32_t struct_size);
|
||||
|
||||
/**
|
||||
* @brief 通过无线接口发送数据到 APP。
|
||||
* 发送的数据会被缓存到待发送区中，当收到 APP 的回应时缓存会被自动清除，通过 sblib_get_cmd_sned_buf() 函数可以获取当前未被成功发送的数据包的数量。
|
||||
*
|
||||
* @param port 端口号。一个端口号对应一个应用的命令集合标识，具体序号由收发双方的应用层协商，一旦确定后，不能更改。收发双向都使用同一个端口号。
|
||||
* @param cmd 命令代号。命令代号由收发双方的应用层协商，一旦确定后，不能更改。
|
||||
* @param data 数据指针。指向要发送的数据的内存地址。指向的内存地址的数据会被复制到缓存区中，发送结束后会被自动释放。
|
||||
* @param length 数据长度。长度任意，建议最大为 1460 字节
|
||||
* @return
|
||||
* SBLIB_SEND_STATUS_OK 当前等发送数据已缓存到待发送区中，数据将会被发送
|
||||
* SBLIB_SEND_STATUS_NO_SPACE 当前没有缓存空间，数据不会被处理
|
||||
* SBLIB_SEND_STATUS_NO_CONNECT 当前没有连接，数据不会被处理
|
||||
*/
|
||||
sblib_cmd_send_status_t sblib_cmd_send(sblib_cmd_port_t port, uint8_t cmd, const void *data, uint16_t length);
|
||||
|
||||
/**
|
||||
* @brief 获取当前已缓存但未发送成功的数据包的数量。
|
||||
*
|
||||
* @return uint32_t 未发送完成的数据包的数量
|
||||
*/
|
||||
uint32_t sblib_get_cmd_sned_buf(void);
|
||||
BIN
components/lib/spbelib_s3.a
Normal file
BIN
components/lib/spbelib_s3.a
Normal file
Binary file not shown.
Reference in New Issue
Block a user