PowLu/BR_YKC
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

fix:更新注释等

Browse Source
This commit is contained in:
路淮
2026-05-21 12:19:01 +08:00
parent fd65e9c6a2
commit 8ee0849831
54 changed files with 1145 additions and 683 deletions
Download Patch File Download Diff File Expand all files Collapse all files

83
Core/User/Driver/drv_air724.c
View File

@@ -1,8 +1,11 @@
/**
* @file drv_air724.c
* @brief 4G模块(AIR724)驱动
* @details 提供通道连接/断开、设置服务器地址、查询SIM/信号/链路状态的接口，
* 以及统一解析4G模块上行响应帧的入口。
******************************************************************************
* @file User\Driver\drv_air724.c
* @author 路淮
* @version v0.1
* @date 2026-05-21
* @brief 4G模块(AIR724)驱动
******************************************************************************
*
* 协议：55 AA mainCmd subCmd [payload] AA 55
*
@@ -25,7 +28,15 @@
Air724_Info_t g_air724_info = {0};
/* ── 内部：构造并发送命令帧 ──────────────────────────── */
/**
* @brief send_cmd：发送命令帧函数
* @note none
* @param main_cmd 主命令 主命令字节
* @param sub_cmd 子命令 子命令字节
* @param payload 数据 数据指针
* @param payload_len 数据长度 数据长度
* @retval none
*/
static void drv_air724_send_cmd(uint8_t main_cmd, uint8_t sub_cmd,
const uint8_t *payload, uint16_t payload_len)
{
@@ -48,8 +59,14 @@ static void drv_air724_send_cmd(uint8_t main_cmd, uint8_t sub_cmd,
Air724_Message_Send(frame, idx);
}
/* ── 发送函数 ──────────────────────────────────────── */
/**
* @brief set_server：设置服务器函数
* @note none
* @param ip 服务器IP地址 字符串指针
* @param port 服务器端口 十进制整数
* @retval none
*/
void drv_air724_set_server(const char *ip, uint16_t port)
{
if (!ip) return;
@@ -66,16 +83,28 @@ void drv_air724_set_server(const char *ip, uint16_t port)
drv_air724_send_cmd(0x04, 0, payload, 3 + ip_len);
}
/**
* @brief connect_channel：连接通道函数
* @note none
* @param channel 通道号 通道-1-6
* @retval none
*/
void drv_air724_connect_channel(uint8_t channel)
{
if (channel < 1 || channel > AIR724_SOCKET_MAX) {
printf("4G: 通道 %d 无效\r\n", channel);
printf("4G: 通道 %d 无效 \r\n", channel);
return;
}
drv_air724_send_cmd(0x03, 0x01, &channel, 1);
printf("4G: 通道 %d 连接请求已发送\r\n", channel);
printf("4G: 通道 %d 连接请求已发送 \r\n", channel);
}
/**
* @brief disconnect_channel：断开通道函数
* @note none
* @param channel 通道号 通道-1-6
* @retval none
*/
void drv_air724_disconnect_channel(uint8_t channel)
{
if (channel < 1 || channel > AIR724_SOCKET_MAX) {
@@ -86,33 +115,59 @@ void drv_air724_disconnect_channel(uint8_t channel)
printf("4G: 通道 %d 断开请求已发送\r\n", channel);
}
/**
* @brief query_iccid：查询ICCID函数
* @note none
* @retval none
*/
void drv_air724_query_iccid(void)
{
drv_air724_send_cmd(0x05, 0x01, NULL, 0);
}
/**
* @brief query_imsi：查询IMSI函数
* @note none
* @retval none
*/
void drv_air724_query_imsi(void)
{
drv_air724_send_cmd(0x05, 0x02, NULL, 0);
}
/**
* @brief query_imei：查询IMEI函数
* @note none
* @retval none
*/
void drv_air724_query_imei(void)
{
drv_air724_send_cmd(0x05, 0x03, NULL, 0);
}
/**
* @brief query_signal：查询信号函数
* @note none
* @retval none
*/
void drv_air724_query_signal(void)
{
drv_air724_send_cmd(0x06, 0x00, NULL, 0);
}
/**
* @brief query_link_status：查询链路函数
* @note none
* @retval none
*/
void drv_air724_query_link_status(void)
{
drv_air724_send_cmd(0x07, 0x00, NULL, 0);
}
/* ── 统一解析入口 ───────────────────────────────────── */
/**
* @brief parse_response：解析响应帧函数
* @note none
* @param frame 响应帧 响应帧指针
* @param len 响应帧长度 响应帧长度
* @retval none
*/
void drv_air724_parse_response(const uint8_t *frame, uint16_t len)
{
if (!frame || len < 7) return;