Initial import of NFC GNSS SDK project

2026-09-15 16:10:12 +08:00
commit 2746cc3d4e
3070 changed files with 892062 additions and 0 deletions
@@ -0,0 +1,129 @@
+
+/**  
+  @file
+  ql_at.h
+
+  @brief
+  This file provides the definitions for at functions, and declares the 
+  common functions.
+
+*/
+/*============================================================================
+  Copyright (c) 2017 Quectel Wireless Solution, Co., Ltd.  All Rights Reserved.
+  Quectel Wireless Solution Proprietary and Confidential.
+ =============================================================================*/
+/*===========================================================================
+
+                        EDIT HISTORY FOR MODULE
+
+This section contains comments describing changes made to the module.
+Notice that changes are listed in reverse chronological order.
+
+
+WHEN        WHO            WHAT, WHERE, WHY
+----------  ------------   ----------------------------------------------------
+11/03/2020  Nebula.li      create
+=============================================================================*/
+
+#ifndef __QL_AT_H__
+#define __QL_AT_H__
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+typedef enum QL_AT_RESP_STATUS_ENUM{
+	QL_AT_RESP_OK = 0,
+	QL_AT_RESP_ERROR,
+	QL_AT_RESP_CME_ERROR,
+	QL_AT_RESP_CMS_ERROR,
+	QL_AT_RESP_INVALID_PARAM,
+	QL_AT_RESP_TIME_OUT,
+	QL_AT_RESP_SYS_ERROR,
+}QL_AT_RESP_STATUS_E;
+
+typedef void(*ql_atcmd_asyc_cb)(QL_AT_RESP_STATUS_E errno,char * buffer,unsigned int len);
+QL_AT_RESP_STATUS_E ql_atcmd_send_sync(char *cmd,char *resp,int resp_len,char *include_str,int time_out);
+QL_AT_RESP_STATUS_E ql_atcmd_send_sync_by_simid (char *cmd,char *resp,int resp_len,char *include_str,int time_out, unsigned short simid);
+
+/***********************************************************************
+ *
+ * Name:   ql_atcmd_asyc_cb    
+ *
+ * Description: 于ql_atcmd_async_init中注册的回调函数
+ *
+ * Parameters:  errno:	接口返回结果，参考枚举QL_AT_RESP_STATUS_E
+ *              buffer:	AT指令执行返回结果，即urc内容
+ *				len:	AT指令执行返回结果的长度
+ *
+ * Notes:    1.此回调在ql_atcmd_async_init中注册，在收到AT的返回结果后被执行，从
+ *		 而上报给app端，此回调中请不要使用过大的数组等变量，因为这个回调的栈是在
+ *		 ql_atcmd_async_init中第二个参数创建的一个AT结果处理task内，栈大小为指定
+ *		 的stack_size，所以回调中请注意不要造成栈溢出;
+ *		     2.此回调中不要执行过多耗时操作，以防止阻塞接收AT处理结果的流程,导致
+ *		 下一次AT回调不及时等问题。
+ *
+ ***********************************************************************/
+typedef void(*ql_atcmd_asyc_cb)(QL_AT_RESP_STATUS_E errno,char * buffer,unsigned int len);
+
+
+/***********************************************************************
+ *
+ * Name:   ql_atcmd_send_async    
+ *
+ * Description: 发送AT指令，不会阻塞当前线程
+ *
+ * Parameters:  data：at字符串
+ *              len： at字符串长度
+ * Returns: 0: SUCCESS
+ *
+ * Notes:
+ *
+ ***********************************************************************/
+QL_AT_RESP_STATUS_E ql_atcmd_send_async(char *data , unsigned int len);
+/***********************************************************************
+ *
+ * Name:   ql_atcmd_send_async    
+ *
+ * Description: 删除异步at运行环境
+ *
+ * Parameters:  VOID
+ *              
+ * Returns: 0 :SUCCESS
+ *
+ * Notes:
+ *
+ ***********************************************************************/
+
+int ql_atcmd_async_close(void);
+/***********************************************************************
+ *
+ * Name:   ql_atcmd_send_async    
+ *
+ * Description: 初始化异步at
+ *
+ * Parameters: stack_ptr：  异步at运行栈起始地址可以为NULL;
+ *             stack_size： 运行栈大小
+ *             cb：用户回调函数
+ * Returns:    0：success
+ *
+ * Notes:
+ *
+ ***********************************************************************/
+int ql_atcmd_async_init(void *stack_ptr,unsigned int stack_size,ql_atcmd_asyc_cb cb);
+
+
+
+
+
+int ql_atcmd_get_line_num(char *result);
+int ql_atcmd_get_para_num_one_line(char *result,int line_index);
+int ql_atcmd_get_para_value_str(char *result,int line_index,int para_index, char *para_value,int para_value_len);
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif
+