T-Box Basic dev
Loading...
Searching...
No Matches
TBOX_RADIO

T-Box 无线网络 More...

Data Structures

struct  tbox_radio_registration_status_t
 分业务注册状态。 More...

Macros

#define TBOX_RIL_OPERATOR_NAME_MAX   64U
 包含结尾 NUL 的运营商名称容量
#define TBOX_RADIO_NETWORK_GSM   ((tbox_radio_network_mask_t)(1U << 0))
 GSM 网络
#define TBOX_RADIO_NETWORK_WCDMA   ((tbox_radio_network_mask_t)(1U << 1))
 WCDMA 网络
#define TBOX_RADIO_NETWORK_LTE   ((tbox_radio_network_mask_t)(1U << 2))
 LTE 网络
#define TBOX_RADIO_NETWORK_NR   ((tbox_radio_network_mask_t)(1U << 3))
 NR 网络
#define TBOX_RADIO_NETWORK_CDMA   ((tbox_radio_network_mask_t)(1U << 4))
 CDMA 网络
#define TBOX_RADIO_NETWORK_EVDO   ((tbox_radio_network_mask_t)(1U << 5))
 EVDO 网络
#define TBOX_RADIO_NETWORK_TDSCDMA   ((tbox_radio_network_mask_t)(1U << 6))
 TD-SCDMA 网络

Typedefs

typedef uint32_t tbox_radio_network_mask_t
 首选网络制式位掩码类型

Enumerations

enum  tbox_radio_tech_t {
  TBOX_RADIO_TECH_UNKNOWN = 0 , TBOX_RADIO_TECH_GSM = 1 , TBOX_RADIO_TECH_WCDMA = 2 , TBOX_RADIO_TECH_LTE = 3 ,
  TBOX_RADIO_TECH_NR = 4
}
 无线接入技术。 More...
enum  tbox_radio_registration_t {
  TBOX_RADIO_REG_UNKNOWN = 0 , TBOX_RADIO_REG_NOT_REGISTERED = 1 , TBOX_RADIO_REG_SEARCHING = 2 , TBOX_RADIO_REG_HOME = 3 ,
  TBOX_RADIO_REG_ROAMING = 4 , TBOX_RADIO_REG_DENIED = 5
}
 网络注册状态。 More...
enum  tbox_radio_ims_status_t { TBOX_RADIO_IMS_NOT_REGISTERED = 0 , TBOX_RADIO_IMS_REGISTERED = 1 }
 IMS 注册状态。 More...
enum  tbox_radio_rf_mode_t { TBOX_RADIO_RF_OFF = 0 , TBOX_RADIO_RF_ON = 1 , TBOX_RADIO_RF_FLIGHT = 4 }
 射频工作模式。 More...

Functions

int tbox_radio_get_registration (tbox_radio_registration_status_t *status, size_t *length)
 查询语音和数据注册状态。
int tbox_radio_get_signal (uint8_t *rssi)
 查询当前网络的等效 GSM RSSI。
int tbox_radio_get_ims_status (tbox_radio_ims_status_t *status)
 查询 IMS 注册状态。
int tbox_radio_get_operator_name (char *value, size_t *length)
 查询运营商名称。
int tbox_radio_set_preferred_network (tbox_radio_network_mask_t networks)
 设置首选网络制式。
int tbox_radio_get_preferred_network (tbox_radio_network_mask_t *networks)
 查询首选网络制式。
int tbox_radio_set_ims_enabled (bool enabled)
 设置 IMS 开关。
int tbox_radio_set_rf_mode (tbox_radio_rf_mode_t mode)
 设置射频工作模式。
int tbox_radio_get_rf_mode (tbox_radio_rf_mode_t *mode)
 查询射频工作模式。

Detailed Description

T-Box 无线网络

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

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

Enumeration Type Documentation

◆ tbox_radio_ims_status_t

enum tbox_radio_ims_status_t

IMS 注册状态。

Enumerator
TBOX_RADIO_IMS_NOT_REGISTERED 

未注册

TBOX_RADIO_IMS_REGISTERED 

已注册

◆ tbox_radio_registration_t

enum tbox_radio_registration_t

网络注册状态。

Enumerator
TBOX_RADIO_REG_UNKNOWN 

未知

TBOX_RADIO_REG_NOT_REGISTERED 

未注册且未搜索

TBOX_RADIO_REG_SEARCHING 

正在搜索

TBOX_RADIO_REG_HOME 

已注册到归属网

TBOX_RADIO_REG_ROAMING 

已漫游注册

TBOX_RADIO_REG_DENIED 

注册被拒绝

◆ tbox_radio_rf_mode_t

enum tbox_radio_rf_mode_t

射频工作模式。

Enumerator
TBOX_RADIO_RF_OFF 

射频关闭，对应 AT+CFUN=0

TBOX_RADIO_RF_ON 

射频开启，对应 AT+CFUN=1

TBOX_RADIO_RF_FLIGHT 

飞行模式，对应 AT+CFUN=4

◆ tbox_radio_tech_t

enum tbox_radio_tech_t

无线接入技术。

Enumerator
TBOX_RADIO_TECH_UNKNOWN 

未知或尚未注册

TBOX_RADIO_TECH_GSM 

GSM.

TBOX_RADIO_TECH_WCDMA 

WCDMA.

TBOX_RADIO_TECH_LTE 

LTE.

TBOX_RADIO_TECH_NR 

5G NR

Function Documentation

◆ tbox_radio_get_ims_status()

int tbox_radio_get_ims_status ( tbox_radio_ims_status_t * status)

查询 IMS 注册状态。

Parameters
status输出 IMS 注册状态。
Returns
TBOX_OK 成功，其他值失败。

◆ tbox_radio_get_operator_name()

int tbox_radio_get_operator_name ( char * value,
size_t * length )

查询运营商名称。

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

Parameters
value输出 NUL 结尾的运营商名称，可为 NULL。
length输入缓冲区长度，输出包含 NUL 的实际或所需长度。
Returns
TBOX_OK 成功，其他值失败。

◆ tbox_radio_get_preferred_network()

int tbox_radio_get_preferred_network ( tbox_radio_network_mask_t * networks)

查询首选网络制式。

Parameters
networks输出网络制式位组合。
Returns
TBOX_OK 成功，其他值失败。

◆ tbox_radio_get_registration()

int tbox_radio_get_registration ( tbox_radio_registration_status_t * status,
size_t * length )

查询语音和数据注册状态。

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

Parameters
status输出注册状态，可为 NULL。
length输入缓冲区长度，输出实际或所需长度。
Returns
TBOX_OK 成功，其他值失败。

◆ tbox_radio_get_rf_mode()

int tbox_radio_get_rf_mode ( tbox_radio_rf_mode_t * mode)

查询射频工作模式。

Parameters
mode输出射频工作模式。
Returns
TBOX_OK 成功，其他值失败。

◆ tbox_radio_get_signal()

int tbox_radio_get_signal ( uint8_t * rssi)

查询当前网络的等效 GSM RSSI。

输出采用 AT+CSQ 的 GSM RSSI 编码，0 至 31 表示由弱到强，99 表示未知或不可检测。

Parameters
rssi输出 GSM RSSI 编码。
Returns
TBOX_OK 成功，其他值失败。

◆ tbox_radio_set_ims_enabled()

int tbox_radio_set_ims_enabled ( bool enabled)

设置 IMS 开关。

Parameters
enabledtrue 启用，false 关闭。
Returns
TBOX_OK 成功，其他值失败。

◆ tbox_radio_set_preferred_network()

int tbox_radio_set_preferred_network ( tbox_radio_network_mask_t networks)

设置首选网络制式。

Parameters
networks非零的网络制式位组合。
Returns
TBOX_OK 成功，其他值失败。

◆ tbox_radio_set_rf_mode()

int tbox_radio_set_rf_mode ( tbox_radio_rf_mode_t mode)

设置射频工作模式。

Parameters
mode射频工作模式。
Returns
TBOX_OK 成功，其他值失败。