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

T-Box 短消息 More...

Data Structures

struct  tbox_sms_text_request_t
 文本短信发送请求。 More...
struct  tbox_sms_pdu_request_t
 PDU 短信发送请求。 More...
struct  tbox_sms_message_t
 收到的短消息。 More...

Macros

#define TBOX_RIL_SMS_ADDRESS_MAX   32U
 包含结尾 NUL 的短信地址容量
#define TBOX_RIL_SMS_TEXT_MAX   512U
 文本载荷最大字节数
#define TBOX_RIL_SMS_PDU_MAX   255U
 PDU 载荷最大字节数
#define TBOX_RIL_SMS_CENTER_MAX   32U
 包含结尾 NUL 的短信中心号码容量

Typedefs

typedef void(* tbox_sms_callback_t) (const tbox_sms_message_t *message, void *context)
 短消息接收回调。

Enumerations

enum  tbox_sms_format_t { TBOX_SMS_FORMAT_TEXT = 0 , TBOX_SMS_FORMAT_PDU = 1 }
 短消息格式。 More...
enum  tbox_sms_encoding_t { TBOX_SMS_ENCODING_7BIT = 0 , TBOX_SMS_ENCODING_8BIT = 1 , TBOX_SMS_ENCODING_UCS2 = 2 }
 文本编码。 More...
enum  tbox_sms_slot_t { TBOX_SMS_SLOT_1 = 0 , TBOX_SMS_SLOT_2 = 1 }
 SIM 卡槽。 More...
enum  tbox_sms_storage_t { TBOX_SMS_STORAGE_SIM = 0 , TBOX_SMS_STORAGE_NV = 1 , TBOX_SMS_STORAGE_DB = 2 , TBOX_SMS_STORAGE_NONE = 3 }
 短消息存储位置。 More...
enum  tbox_sms_mode_t { TBOX_SMS_MODE_CDMA = 0 , TBOX_SMS_MODE_GW = 1 }
 短消息网络模式。 More...

Functions

int tbox_sms_register_callback (tbox_sms_callback_t callback, void *context)
 注册短消息接收回调。
int tbox_sms_unregister_callback (void)
 注销短消息接收回调。
int tbox_sms_send_text (const tbox_sms_text_request_t *request)
 发送文本短信。
int tbox_sms_send_pdu (const tbox_sms_pdu_request_t *request)
 发送 PDU 短信。
int tbox_sms_delete (tbox_sms_storage_t storage, tbox_sms_mode_t mode, uint32_t storage_index)
 删除已存储的短信。
int tbox_sms_get_service_center (char *value, size_t *length)
 查询短信中心号码。
int tbox_sms_set_service_center (const char *value)
 设置短信中心号码。

Detailed Description

T-Box 短消息

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

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

Typedef Documentation

◆ tbox_sms_callback_t

typedef void(* tbox_sms_callback_t) (const tbox_sms_message_t *message, void *context)

短消息接收回调。

message 仅在回调期间有效。回调运行于 RIL 内部事件线程,应尽快返回,不得主动等待、 休眠或执行其他耗时操作;需要后续处理时,应复制消息并交由业务线程执行。

Parameters
message收到的短消息。
context注册回调时提供的上下文,可为 NULL。

Enumeration Type Documentation

◆ tbox_sms_encoding_t

文本编码。

Enumerator
TBOX_SMS_ENCODING_7BIT 

未打包 7 位字符

TBOX_SMS_ENCODING_8BIT 

8 位二进制

TBOX_SMS_ENCODING_UCS2 

大端 UCS-2

◆ tbox_sms_format_t

短消息格式。

Enumerator
TBOX_SMS_FORMAT_TEXT 

文本格式

TBOX_SMS_FORMAT_PDU 

原始 PDU 格式

◆ tbox_sms_mode_t

短消息网络模式。

Enumerator
TBOX_SMS_MODE_CDMA 

CDMA.

TBOX_SMS_MODE_GW 

GSM、WCDMA 或 LTE.

◆ tbox_sms_slot_t

SIM 卡槽。

Enumerator
TBOX_SMS_SLOT_1 

卡槽 1

TBOX_SMS_SLOT_2 

卡槽 2

◆ tbox_sms_storage_t

短消息存储位置。

Enumerator
TBOX_SMS_STORAGE_SIM 

SIM 卡存储

TBOX_SMS_STORAGE_NV 

模组非易失存储

TBOX_SMS_STORAGE_DB 

模组短信数据库

TBOX_SMS_STORAGE_NONE 

未存储,仅随接收指示传递

Function Documentation

◆ tbox_sms_delete()

int tbox_sms_delete ( tbox_sms_storage_t storage,
tbox_sms_mode_t mode,
uint32_t storage_index )

删除已存储的短信。

Parameters
storage存储位置。
mode网络模式。
storage_index存储条目索引。
Returns
TBOX_OK 成功,其他值失败。

◆ tbox_sms_get_service_center()

int tbox_sms_get_service_center ( char * value,
size_t * length )

查询短信中心号码。

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

Parameters
value输出 NUL 结尾的短信中心号码,可为 NULL。
length输入缓冲区长度,输出包含 NUL 的实际或所需长度。
Returns
TBOX_OK 成功,其他值失败。

◆ tbox_sms_register_callback()

int tbox_sms_register_callback ( tbox_sms_callback_t callback,
void * context )

注册短消息接收回调。

每个进程只允许注册一个回调。

Parameters
callback接收回调。
context回调上下文,可为 NULL。
Returns
TBOX_OK 成功,其他值失败。

◆ tbox_sms_send_pdu()

int tbox_sms_send_pdu ( const tbox_sms_pdu_request_t * request)

发送 PDU 短信。

Parameters
requestPDU 短信请求,仅在调用期间借用。
Returns
TBOX_OK 成功,其他值失败。

◆ tbox_sms_send_text()

int tbox_sms_send_text ( const tbox_sms_text_request_t * request)

发送文本短信。

Parameters
request文本短信请求,仅在调用期间借用。
Returns
TBOX_OK 成功,其他值失败。

◆ tbox_sms_set_service_center()

int tbox_sms_set_service_center ( const char * value)

设置短信中心号码。

Parameters
valueNUL 结尾的短信中心号码,仅在调用期间借用。
Returns
TBOX_OK 成功,其他值失败。

◆ tbox_sms_unregister_callback()

int tbox_sms_unregister_callback ( void )

注销短消息接收回调。

返回后不会再启动新的短消息回调。

Returns
TBOX_OK 成功,其他值失败。