一键配置Profile¶
Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.
功能概述¶
一键配置Profile功能内置了三大运营商（中国移动、中国联通、中国电信）的基础拨号配置模板，同时支持用户根据实际需求进行自定义配置，旨在简化数据拨号参数的配置流程。
一键配置Profile API¶
头文件¶
easy_datacall_profile.h
函数概览¶
函数 |
说明 |
|---|---|
qapp_easy_datacall_prof_tpl_set_config() |
配置指定索引的Profile模板参数 |
qapp_easy_datacall_prof_tpl_get_config() |
读取指定索引的Profile模板参数 |
qapp_easy_datacall_prof_tpl_write() |
将Profile模板写入指定SIM卡的指定PDP上下文 |
qapp_easy_datacall_prof_tpl_read() |
从指定SIM卡的指定PDP上下文读取已配置的Profile模板索引 |
函数详解¶
qapp_easy_datacall_prof_tpl_set_config¶
功能描述：
配置指定索引的Profile模板参数，将传入的PDP上下文、鉴权信息写入目标模板。函数原型
qosa_uint32_t qapp_easy_datacall_prof_tpl_set_config(const qapp_easy_datacall_prof_param_t *tpl, qapp_easy_datacall_prof_tpl_e tpl_idx);
参数说明
参数名 |
输入/输出 |
类型 |
说明 |
|---|---|---|---|
tpl |
输入 |
const qapp_easy_datacall_prof_param_t * |
待写入的Profile模板参数；详见 qapp_easy_datacall_prof_param_t |
tpl_idx |
输入 |
qapp_easy_datacall_prof_tpl_e |
待配置的模板索引；详见 qapp_easy_datacall_prof_tpl_e |
返回值说明
0：函数执行成功
1：函数执行失败
其他值详见 qapp_easy_datacall_prof_tpl_error_e
qapp_easy_datacall_prof_tpl_get_config¶
功能描述
读取指定索引的Profile模板参数，将模板中存储的PDP上下文及鉴权参数输出到目标结构体。函数原型
qosa_uint32_t qapp_easy_datacall_prof_tpl_get_config(qapp_easy_datacall_prof_param_t *tpl, qapp_easy_datacall_prof_tpl_e tpl_idx);
参数说明
参数名 |
输入/输出 |
类型 |
说明 |
|---|---|---|---|
tpl |
输出 |
qapp_easy_datacall_prof_param_t * |
读取到的Profile模板参数；详见 qapp_easy_datacall_prof_param_t |
tpl_idx |
输入 |
qapp_easy_datacall_prof_tpl_e |
待读取的模板索引；详见 qapp_easy_datacall_prof_tpl_e |
返回值说明
0：函数执行成功
1：函数执行失败
其他值详见 qapp_easy_datacall_prof_tpl_error_e
qapp_easy_datacall_prof_tpl_write¶
功能描述
将Profile模板写入指定SIM卡的指定PDP上下文，后续拨号可直接复用这套模板参数。函数原型
qosa_uint32_t qapp_easy_datacall_prof_tpl_write(qosa_uint8_t simid, qosa_uint8_t pdpid, qapp_easy_datacall_prof_tpl_e tpl_idx);
参数说明
参数名 |
输入/输出 |
类型 |
说明 |
|---|---|---|---|
simid |
输入 |
qosa_uint8_t |
SIM ID |
pdpid |
输入 |
qosa_uint8_t |
PDP上下文ID |
tpl_idx |
输入 |
qapp_easy_datacall_prof_tpl_e |
待写入的模板索引；详见 qapp_easy_datacall_prof_tpl_e |
返回值说明
0：函数执行成功
1：函数执行失败
其他值详见 qapp_easy_datacall_prof_tpl_error_e
qapp_easy_datacall_prof_tpl_read¶
功能描述
从指定SIM卡的指定PDP上下文读取已配置的Profile模板索引。函数原型
qosa_uint32_t qapp_easy_datacall_prof_tpl_read(qosa_uint8_t simid, qosa_uint8_t pdpid, qapp_easy_datacall_prof_tpl_e *tpl_idx);
参数说明
参数名 |
输入/输出 |
类型 |
说明 |
|---|---|---|---|
simid |
输入 |
qosa_uint8_t |
SIM ID |
pdpid |
输入 |
qosa_uint8_t |
PDP上下文ID |
tpl_idx |
输出 |
qapp_easy_datacall_prof_tpl_e |
读取到的模板索引；详见 qapp_easy_datacall_prof_tpl_e |
返回值说明
0：函数执行成功
1：函数执行失败
3：配置模板与参数不匹配
其他值详见 qapp_easy_datacall_prof_tpl_error_e
结构体定义¶
qapp_easy_datacall_prof_param_t¶
Profile模板参数结构体定义如下：
typedef struct
{
qosa_pdp_context_t pdp;
qosa_pdp_auth_context_t auth;
} qapp_easy_datacall_prof_param_t;
参数 |
类型 |
说明 |
|---|---|---|
pdp |
qosa_pdp_context_t |
PDP上下文参数；详见 qosa_pdp_context_t |
auth |
qosa_pdp_auth_context_t |
PDP认证参数；详见 qosa_pdp_auth_context_t |
枚举类型定义¶
qapp_easy_datacall_prof_tpl_error_e¶
Profile配置结果码枚举定义如下：
typedef enum
{
QAPP_EASY_DATACALL_PROF_TPL_SUCCESS = QOSA_OK,
QAPP_EASY_DATACALL_PROF_TPL_EXECUTE_ERR = 1,
QAPP_EASY_DATACALL_PROF_TPL_NO_MEMORY,
QAPP_EASY_DATACALL_PROF_TPL_MISMATCH,
} qapp_easy_datacall_prof_tpl_error_e;
成员 |
说明 |
|---|---|
QAPP_EASY_DATACALL_PROF_TPL_SUCCESS |
函数执行成功 |
QAPP_EASY_DATACALL_PROF_TPL_EXECUTE_ERR |
函数执行失败 |
QAPP_EASY_DATACALL_PROF_TPL_NO_MEMORY |
内存分配失败 |
QAPP_EASY_DATACALL_PROF_TPL_MISMATCH |
配置模板与参数不匹配 |
qapp_easy_datacall_prof_tpl_e¶
模板索引枚举定义如下：
typedef enum
{
QAPP_EASY_DATACALL_PROF_TPL_INTERNAL_NONE = -1,
QAPP_EASY_DATACALL_PROF_TPL_INTERNAL_DEFAULT = 0,
QAPP_EASY_DATACALL_PROF_TPL_INTERNAL_CMNET_IPV4V6,
QAPP_EASY_DATACALL_PROF_TPL_INTERNAL_UNINET_IPV4V6,
QAPP_EASY_DATACALL_PROF_TPL_INTERNAL_CTNET_IPV4V6,
QAPP_EASY_DATACALL_PROF_TPL_INTERNAL_MAX,
QAPP_EASY_DATACALL_PROF_TPL_USER_0 = QAPP_EASY_DATACALL_PROF_TPL_INTERNAL_MAX,
QAPP_EASY_DATACALL_PROF_TPL_USER_1,
QAPP_EASY_DATACALL_PROF_TPL_USER_2,
QAPP_EASY_DATACALL_PROF_TPL_MAX,
} qapp_easy_datacall_prof_tpl_e;
成员 |
说明 |
|---|---|
QAPP_EASY_DATACALL_PROF_TPL_INTERNAL_NONE |
无效模板 |
QAPP_EASY_DATACALL_PROF_TPL_INTERNAL_DEFAULT |
默认通用模板（只读） |
QAPP_EASY_DATACALL_PROF_TPL_INTERNAL_CMNET_IPV4V6 |
中国移动CMNET IPv4 + IPv6模板（只读） |
QAPP_EASY_DATACALL_PROF_TPL_INTERNAL_UNINET_IPV4V6 |
中国联通UNINET IPv4 + IPv6内置模板（只读） |
QAPP_EASY_DATACALL_PROF_TPL_INTERNAL_CTNET_IPV4V6 |
中国电信CTNET IPv4 + IPv6内置模板（只读） |
QAPP_EASY_DATACALL_PROF_TPL_INTERNAL_MAX |
内置模板数量上限（分界值） |
QAPP_EASY_DATACALL_PROF_TPL_USER_0 |
用户自定义模板0，支持读写修改 |
QAPP_EASY_DATACALL_PROF_TPL_USER_1 |
用户自定义模板1，支持读写修改 |
QAPP_EASY_DATACALL_PROF_TPL_USER_2 |
用户自定义模板2，支持读写修改 |
QAPP_EASY_DATACALL_PROF_TPL_MAX |
所有模板总数上限（内置 + 用户自定义） |
应用逻辑流程图¶
