TBOX_RIL_CORE

T-Box RIL 客户端核心 More...

Macros
#define	TBOX_RIL_VERSION_MAX   128U
	包含结尾 NUL 的模组版本字符串容量
#define	TBOX_RIL_IMEI_MAX   16U
	包含结尾 NUL 的 IMEI 容量
#define	TBOX_RIL_SV_MAX   3U
	包含结尾 NUL 的 IMEI 软件版本号容量
#define	TBOX_RIL_CAP_RADIO   ((tbox_ril_capability_t)(UINT32_C(1) << 0))
	支持无线网络接口
#define	TBOX_RIL_CAP_SIM   ((tbox_ril_capability_t)(UINT32_C(1) << 1))
	支持 SIM 接口
#define	TBOX_RIL_CAP_SMS   ((tbox_ril_capability_t)(UINT32_C(1) << 2))
	支持短消息接口
#define	TBOX_RIL_CAP_DATA   ((tbox_ril_capability_t)(UINT32_C(1) << 3))
	支持蜂窝数据业务接口
#define	TBOX_RIL_CAP_VOICE   ((tbox_ril_capability_t)(UINT32_C(1) << 4))
	支持语音接口
#define	TBOX_RIL_CAP_ECALL   ((tbox_ril_capability_t)(UINT32_C(1) << 5))
	支持 eCall 接口

Typedefs
typedef uint32_t	tbox_ril_capability_t
	RIL 后端能力位掩码类型

Functions
int	tbox_ril_init (void)
	初始化 RIL 客户端。
int	tbox_ril_deinit (void)
	释放 RIL 客户端资源。
int	tbox_ril_get_capabilities (tbox_ril_capability_t *capabilities, size_t *length)
	查询当前模组后端能力。
int	tbox_ril_get_version (char *value, size_t *length)
	查询模组版本。
int	tbox_ril_get_imei (char *value, size_t *length)
	查询模组 IMEI。
int	tbox_ril_get_sv (char *value, size_t *length)
	查询模组 IMEI 软件版本号（SV）。

Detailed Description

T-Box RIL 客户端核心

初始化成功后，除业务回调文档另有说明外，RIL 公共接口可由多个线程并发调用。 同步调用最多等待远端响应 2 秒。

Function Documentation

tbox_ril_deinit()

int tbox_ril_deinit

(

void

)

释放 RIL 客户端资源。

等待正在执行的同步调用和业务回调结束。不得在 SMS 或 voice 回调线程内调用。 重复或并发反初始化会串行化，未初始化时直接成功。

Returns

TBOX_OK 成功，其他值失败。

tbox_ril_get_capabilities()

int tbox_ril_get_capabilities	(	tbox_ril_capability_t *	capabilities,
		size_t *	length )

查询当前模组后端能力。

当 capabilities 为 NULL 时，仅返回所需长度。

Parameters

capabilities	输出能力位掩码，可为 NULL。
length	输入缓冲区长度，输出实际或所需长度。

Returns

TBOX_OK 成功，其他值失败。

tbox_ril_get_imei()

int tbox_ril_get_imei	(	char *	value,
		size_t *	length )

查询模组 IMEI。

当 value 为 NULL 时，仅返回所需长度。

Parameters

value	输出 NUL 结尾的 IMEI，可为 NULL。
length	输入缓冲区长度，输出包含 NUL 的实际或所需长度。

Returns

TBOX_OK 成功，其他值失败。

tbox_ril_get_sv()

int tbox_ril_get_sv	(	char *	value,
		size_t *	length )

查询模组 IMEI 软件版本号（SV）。

当 value 为 NULL 时，仅返回所需长度。

Parameters

value	输出 NUL 结尾的 SV，可为 NULL。
length	输入缓冲区长度，输出包含 NUL 的实际或所需长度。

Returns

TBOX_OK 成功，其他值失败。

tbox_ril_get_version()

int tbox_ril_get_version	(	char *	value,
		size_t *	length )

查询模组版本。

当 value 为 NULL 时，仅返回所需长度。

Parameters

value	输出 NUL 结尾的版本字符串，可为 NULL。
length	输入缓冲区长度，输出包含 NUL 的实际或所需长度。

Returns

TBOX_OK 成功，其他值失败。

tbox_ril_init()

int tbox_ril_init

(

void

)

初始化 RIL 客户端。

本函数内部连接 system bus。重复或并发初始化会串行化，已初始化时直接成功。

Returns

TBOX_OK 成功，其他值失败。