TBOX_RIL_DATA

T-Box 蜂窝数据网络状态 More...

Enumerations
enum	tbox_data_probe_status_t { TBOX_DATA_PROBE_UNKNOWN = 0 , TBOX_DATA_PROBE_REACHABLE , TBOX_DATA_PROBE_UNREACHABLE , TBOX_DATA_PROBE_UNAVAILABLE }
	网络探测状态 More...
enum	tbox_data_state_t {   TBOX_DATA_STATE_DISABLED = 0 , TBOX_DATA_STATE_WAITING , TBOX_DATA_STATE_CONNECTING , TBOX_DATA_STATE_CONNECTED ,   TBOX_DATA_STATE_RECOVERING , TBOX_DATA_STATE_DISCONNECTING }
	APN 数据链路运行状态 More...

Functions
int	tbox_data_get_state (uint8_t apn_index, tbox_data_state_t *state)
	查询指定 APN 的当前数据链路运行状态。
int	tbox_data_get_probe_status (uint8_t apn_index, tbox_data_probe_status_t *status)
	查询指定 APN 的最新网络探测状态。
int	tbox_data_get_enabled (uint8_t apn_index, bool *enabled)
	查询指定 APN 的期望启用状态。
int	tbox_data_set_enabled (uint8_t apn_index, bool enabled)
	设置指定 APN 的期望启用状态。
int	tbox_data_get_probe_enabled (uint8_t apn_index, bool *enabled)
	查询指定 APN 的自动网络探测期望状态。
int	tbox_data_set_probe_enabled (uint8_t apn_index, bool enabled)
	设置指定 APN 的自动网络探测期望状态。

Detailed Description

T-Box 蜂窝数据网络状态

接口均为线程安全的同步调用，调用前需通过

See also

tbox_ril_init() 初始化；远端调用最多等待 2 秒。

Enumeration Type Documentation

tbox_data_probe_status_t

enum tbox_data_probe_status_t

网络探测状态

Enumerator
TBOX_DATA_PROBE_UNKNOWN	尚未获得有效探测结果
TBOX_DATA_PROBE_REACHABLE	至少一个探测目标可达
TBOX_DATA_PROBE_UNREACHABLE	已执行探测，但所有目标均不可达
TBOX_DATA_PROBE_UNAVAILABLE	当前无法执行探测

tbox_data_state_t

enum tbox_data_state_t

APN 数据链路运行状态

Enumerator
TBOX_DATA_STATE_DISABLED	APN 已禁用
TBOX_DATA_STATE_WAITING	等待拨号条件或调度
TBOX_DATA_STATE_CONNECTING	正在建立数据链路
TBOX_DATA_STATE_CONNECTED	数据链路已连接
TBOX_DATA_STATE_RECOVERING	正在执行网络恢复
TBOX_DATA_STATE_DISCONNECTING	正在断开数据链路

Function Documentation

tbox_data_get_enabled()

int tbox_data_get_enabled	(	uint8_t	apn_index,
		bool *	enabled )

查询指定 APN 的期望启用状态。

Parameters

apn_index

APN 配置索引，或

See also

TBOX_DATA_DEFAULT_ROUTE_APN。

Parameters

enabled

输出期望启用状态。

Returns

TBOX_OK 成功，其他值失败。

tbox_data_get_probe_enabled()

int tbox_data_get_probe_enabled	(	uint8_t	apn_index,
		bool *	enabled )

查询指定 APN 的自动网络探测期望状态。

Parameters

apn_index

APN 配置索引，或

See also

TBOX_DATA_DEFAULT_ROUTE_APN。

Parameters

enabled

输出自动网络探测期望状态。

Returns

TBOX_OK 成功，其他值失败。

tbox_data_get_probe_status()

int tbox_data_get_probe_status	(	uint8_t	apn_index,
		tbox_data_probe_status_t *	status )

查询指定 APN 的最新网络探测状态。

本接口返回 rild 缓存的最近一次有效结果，不会同步发起网络探测。 调用前需先通过

See also

tbox_ril_init() 初始化 RIL 客户端。

Parameters

apn_index

APN 配置索引，或

See also

TBOX_DATA_DEFAULT_ROUTE_APN。

Parameters

status

输出网络探测状态。

Returns

TBOX_OK 成功，其他值失败。

tbox_data_get_state()

int tbox_data_get_state	(	uint8_t	apn_index,
		tbox_data_state_t *	state )

查询指定 APN 的当前数据链路运行状态。

TBOX_DATA_STATE_CONNECTED 仅表示数据链路已建立； 是否可访问外部网络需结合

See also

tbox_data_get_probe_status() 判断。

Parameters

apn_index

APN 配置索引，或

See also

TBOX_DATA_DEFAULT_ROUTE_APN。

Parameters

state

输出数据链路运行状态。

Returns

TBOX_OK 成功，其他值失败。

tbox_data_set_enabled()

int tbox_data_set_enabled	(	uint8_t	apn_index,
		bool	enabled )

设置指定 APN 的期望启用状态。

启用后由 rild 负责拨号和恢复；关闭后由 rild 停止恢复并断开已有链路。 本状态仅在 rild 当前运行期间有效，rild 重启后恢复为 APN 的 auto_dial 配置。

Parameters

apn_index	APN 配置索引。
enabled	期望启用状态。

Returns

TBOX_OK 成功，其他值失败。

tbox_data_set_probe_enabled()

int tbox_data_set_probe_enabled	(	uint8_t	apn_index,
		bool	enabled )

设置指定 APN 的自动网络探测期望状态。

关闭后不再发起新的网络探测，不影响拨号和链路断开后的自动恢复。 本状态仅在 rild 当前运行期间有效，rild 重启后恢复为启用。

Parameters

apn_index	APN 配置索引。
enabled	自动网络探测期望状态。

Returns

TBOX_OK 成功，其他值失败。