蜂窝模组基础服务API接口定义 TAL在实现tkl_CellularSvcIntf_t接口后，需要调用tal_cellular_mds_register 把实现的对象注册到tkl中更多...

#include <tkl_init_cellular.h>

成员变量
OPERATE_RET(*	base_init )(TKL_CELL_INIT_PARAM_T *param)

OPERATE_RET(*	enable_sim_detect )(UINT8_T simid, BOOL_T enable)
	设置是否使能SIM检测功能更多...

OPERATE_RET(*	get_ability )(TKL_CELLULAR_ABILITY_E *ability)
	获取当前设备的通讯能力更多...

OPERATE_RET(*	get_cfun_mode )(UINT8_T sim_id, PINT_T cfun)
	获取蜂窝设备当前的通信功能设置更多...

INT8_T(*	get_default_simid )(VOID)
	获取默认的SIM ID 更多...

OPERATE_RET(*	get_iccid )(UINT8_T sim_id, CHAR_T iccid[20+1])
	获取SIM卡的ICCID 更多...

OPERATE_RET(*	get_imei )(UINT8_T sim_id, CHAR_T imei[15+1])
	获取SIM卡所在通道设备的IMEI号更多...

OPERATE_RET(*	get_imsi )(UINT8_T sim_id, CHAR_T imsi[15+1])
	获取SIM卡中的国际移动用户识别码更多...

OPERATE_RET(*	get_lbs )(UINT8_T simid, TKL_LBS_INFO_T *lbs, BOOL_T neighbour, INT_T timeout)
	当前LBS的基站信息(只支持LTE) 更多...

OPERATE_RET(*	get_rsrp )(UINT8_T sim_id, INT_T *rsrp)
	获取当前蜂窝设备的信号接收功率——单位dbm 更多...

OPERATE_RET(*	get_sinr )(UINT8_T sim_id, INT_T sinr, INT_T bit_error)
	获取当前蜂窝设备的信号噪声比更多...

OPERATE_RET(*	ioctl )(INT_T cmd, VOID *argv)
	平台提供一些特殊的能力接口更多...

OPERATE_RET(*	register_sim_state_notify )(UINT8_T sim_id, TKL_SIM_NOTIFY notify)
	注册SIM状态变化通知函数更多...

BOOL_T(*	rf_calibrated )(VOID)
	获取当前设备的射频校准状态更多...

OPERATE_RET(*	set_cfun_mode )(UINT8_T sim_id, INT_T cfun)
	设置蜂窝设备的通信功能模式更多...

OPERATE_RET(*	set_imei )(UINT8_T sim_id, CHAR_T imei[15+1])
	设置SIM卡所在通道设备的IMEI号更多...

OPERATE_RET(*	sim_get_status )(UINT8_T sim_id, UCHAR_T *state)
	获取SIM卡的状态更多...

OPERATE_RET(*	sim_hotplug_enable )(UINT8_T sim_id, BOOL_T enable)
	使能或禁止sim卡热拔插更多...

OPERATE_RET(*	switch_sim )(UINT8_T sim_id)
	切换当前使能的SIM卡。如果是双卡双待，或者单卡则不需要实现该接口更多...

详细描述

蜂窝模组基础服务API接口定义 TAL在实现tkl_CellularSvcIntf_t接口后，需要调用tal_cellular_mds_register 把实现的对象注册到tkl中

结构体成员变量说明

◆ enable_sim_detect

OPERATE_RET(* TKL_CELL_BASE_INTF_T::enable_sim_detect) (UINT8_T simid, BOOL_T enable)

设置是否使能SIM检测功能

参数

enable TRUE 使能，FALSE 禁止

返回: 0 成功其它失败

◆ get_ability

OPERATE_RET(* TKL_CELL_BASE_INTF_T::get_ability) (TKL_CELLULAR_ABILITY_E *ability)

获取当前设备的通讯能力

参数

ability @TKL_CELLULAR_ABILITY_E 类型

返回: 0 成功其它失败

◆ get_cfun_mode

OPERATE_RET(* TKL_CELL_BASE_INTF_T::get_cfun_mode) (UINT8_T sim_id, PINT_T cfun)

获取蜂窝设备当前的通信功能设置

参数

cfun 获取的通信功能

返回: 0 成功其它失败

◆ get_default_simid

INT8_T(* TKL_CELL_BASE_INTF_T::get_default_simid) (VOID)

获取默认的SIM ID

返回: 小于0失败，其他SIM ID

◆ get_iccid

OPERATE_RET(* TKL_CELL_BASE_INTF_T::get_iccid) (UINT8_T sim_id, CHAR_T iccid[20+1])

获取SIM卡的ICCID

参数

simid
ICCID识别码，为20字节的字符串

返回: 0 成功其它失败

◆ get_imei

OPERATE_RET(* TKL_CELL_BASE_INTF_T::get_imei) (UINT8_T sim_id, CHAR_T imei[15+1])

获取SIM卡所在通道设备的IMEI号

参数

simid
IMEI识别码，为15字节的字符串

返回: 0 成功其它失败

◆ get_imsi

OPERATE_RET(* TKL_CELL_BASE_INTF_T::get_imsi) (UINT8_T sim_id, CHAR_T imsi[15+1])

获取SIM卡中的国际移动用户识别码

参数

simid
imsi识别码，为15字节的字符串

返回: 0 成功其它失败

◆ get_lbs

OPERATE_RET(* TKL_CELL_BASE_INTF_T::get_lbs) (UINT8_T simid, TKL_LBS_INFO_T *lbs, BOOL_T neighbour, INT_T timeout)

当前LBS的基站信息(只支持LTE)

参数

simid
lbs	返回基站信息
neighbour	是否搜索临近基站信息
timeout	搜索临近基站信息超时时间(一般需要4秒左右)

返回: 0 成功其它失败

◆ get_rsrp

OPERATE_RET(* TKL_CELL_BASE_INTF_T::get_rsrp) (UINT8_T sim_id, INT_T *rsrp)

获取当前蜂窝设备的信号接收功率——单位dbm

参数

simid
rsrp	返回实际的信号强度(dbm)

返回: 0 成功其它失败

◆ get_sinr

OPERATE_RET(* TKL_CELL_BASE_INTF_T::get_sinr) (UINT8_T sim_id, INT_T *sinr, INT_T *bit_error)

获取当前蜂窝设备的信号噪声比

参数

simid
sinr	(0~31)

返回: 0 成功其它失败

◆ ioctl

OPERATE_RET(* TKL_CELL_BASE_INTF_T::ioctl) (INT_T cmd, VOID *argv)

平台提供一些特殊的能力接口

参数

cmd	参考CELL_IOCTRL_CMD
argv	平台自定义

返回: 0 成功其它失败

◆ register_sim_state_notify

OPERATE_RET(* TKL_CELL_BASE_INTF_T::register_sim_state_notify) (UINT8_T sim_id, TKL_SIM_NOTIFY notify)

注册SIM状态变化通知函数

参数

fun 状态变化通知函数

返回: 0 成功其它失败

◆ rf_calibrated

BOOL_T(* TKL_CELL_BASE_INTF_T::rf_calibrated) (VOID)

获取当前设备的射频校准状态

参数

return TRUE正常，FALSE异常

◆ set_cfun_mode

OPERATE_RET(* TKL_CELL_BASE_INTF_T::set_cfun_mode) (UINT8_T sim_id, INT_T cfun)

设置蜂窝设备的通信功能模式

参数

cfun	通信功能，取值含义如下： 1：全功能模式 4：飞行模式

返回: 0 成功其它失败

◆ set_imei

OPERATE_RET(* TKL_CELL_BASE_INTF_T::set_imei) (UINT8_T sim_id, CHAR_T imei[15+1])

设置SIM卡所在通道设备的IMEI号

参数

IMEI识别码，为15字节的字符串

返回: 0 成功其它失败

◆ sim_get_status

OPERATE_RET(* TKL_CELL_BASE_INTF_T::sim_get_status) (UINT8_T sim_id, UCHAR_T *state)

获取SIM卡的状态

参数

simId	sim卡ID
state	1：正常，0：异常

返回: 0 成功其它失败

◆ sim_hotplug_enable

OPERATE_RET(* TKL_CELL_BASE_INTF_T::sim_hotplug_enable) (UINT8_T sim_id, BOOL_T enable)

使能或禁止sim卡热拔插

参数

simId	sim卡ID
enable	TRUE 使能 FALSE 禁止

返回: 0 成功其它失败

◆ switch_sim

OPERATE_RET(* TKL_CELL_BASE_INTF_T::switch_sim) (UINT8_T sim_id)

切换当前使能的SIM卡。如果是双卡双待，或者单卡则不需要实现该接口

参数

simid SIM卡ID.(0~1)

返回: 0 成功其它失败

该结构体的文档由以下文件生成:

include/adapter/init/include/tkl_init_cellular.h