|
T-Box Basic dev
|
T-Box 短消息 More...
Data Structures | |
| struct | tbox_sms_text_request_t |
| 文本短信发送请求。 More... | |
| struct | tbox_sms_pdu_request_t |
| PDU 短信发送请求。 More... | |
| 收到的短消息。 More... | |
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) |
| 设置短信中心号码。 | |
T-Box 短消息
接口均为线程安全的同步调用,调用前需通过
| typedef void(* tbox_sms_callback_t) (const tbox_sms_message_t *message, void *context) |
短消息接收回调。
message 仅在回调期间有效。回调运行于 RIL 内部事件线程,应尽快返回,不得主动等待、 休眠或执行其他耗时操作;需要后续处理时,应复制消息并交由业务线程执行。
| message | 收到的短消息。 |
| context | 注册回调时提供的上下文,可为 NULL。 |
| enum tbox_sms_encoding_t |
| enum tbox_sms_format_t |
| enum tbox_sms_mode_t |
| enum tbox_sms_slot_t |
| enum tbox_sms_storage_t |
| int tbox_sms_delete | ( | tbox_sms_storage_t | storage, |
| tbox_sms_mode_t | mode, | ||
| uint32_t | storage_index ) |
删除已存储的短信。
| storage | 存储位置。 |
| mode | 网络模式。 |
| storage_index | 存储条目索引。 |
| int tbox_sms_get_service_center | ( | char * | value, |
| size_t * | length ) |
查询短信中心号码。
当 value 为 NULL 时,仅返回所需长度。
| value | 输出 NUL 结尾的短信中心号码,可为 NULL。 |
| length | 输入缓冲区长度,输出包含 NUL 的实际或所需长度。 |
| int tbox_sms_register_callback | ( | tbox_sms_callback_t | callback, |
| void * | context ) |
注册短消息接收回调。
每个进程只允许注册一个回调。
| callback | 接收回调。 |
| context | 回调上下文,可为 NULL。 |
| int tbox_sms_send_pdu | ( | const tbox_sms_pdu_request_t * | request | ) |
发送 PDU 短信。
| request | PDU 短信请求,仅在调用期间借用。 |
| int tbox_sms_send_text | ( | const tbox_sms_text_request_t * | request | ) |
发送文本短信。
| request | 文本短信请求,仅在调用期间借用。 |
| int tbox_sms_set_service_center | ( | const char * | value | ) |
设置短信中心号码。
| value | NUL 结尾的短信中心号码,仅在调用期间借用。 |
| int tbox_sms_unregister_callback | ( | void | ) |
注销短消息接收回调。
返回后不会再启动新的短消息回调。