SMS

Provides functions to send, read, delete, cancel the SMS messages.

An application can use vm_gsm_sms_send() to send a SMS message, or use the use vm_gsm_sms_cancel_send() to cancel a pending message to be sent. It can also reads a SMS message by calling vm_gsm_sms_read_message(), and delete a message with vm_gsm_sms_delete_message(). It can delete all messages from a specific message inbox by calling vm_gsm_sms_delete_message_list().

An application can get the SMS Center Address through the vm_gsm_sms_get_center_address() asynchronously via a callback, or through the vm_gsm_sms_get_center_address_sync() synchronously.

N/A

Function	Description
vm_gsm_sms_add_message	Saves a new message to SMS Storage. If the caller specifies those parameters (Status, Address, Content, SIM Card, Storage Type, Profile element), they will be used. Otherwise, it will use the default values (If the parameters are in the SMS setting, it will use them as default). The Callback Action Data Struct is vm_gsm_sms_save_message_callback_t.
vm_gsm_sms_cancel_send	Cancels sending SMS. The function can be used only after vm_gsm_sms_send() has been invoked and it returns TRUE, and before the corresponding callback is invoked. Otherwise, calling this function is invalid.
vm_gsm_sms_clear_interrupt_event_handler	Clears the interrupt handler for the specified event type.
vm_gsm_sms_delete_message	Deletes an existing message as specified by message ID. The Callback Action Data Structure is vm_gsm_sms_delete_message_callback_t;
vm_gsm_sms_delete_message_list	Deletes all the existing messages in the specified message box, e.g. Inbox, Outbox, etc. The Callback Action Data Structure is vm_gsm_sms_delete_message_list_callback_t;
vm_gsm_sms_get_box_size	Gets number of the messages in a box list
vm_gsm_sms_get_center_address	Asynchronously gets center address of the SIM for SMS, which is a phone number.
vm_gsm_sms_get_center_address_sync	Synchronously gets center address of the SIM for SMS, which is a phone number.
vm_gsm_sms_get_message_id	Gets the message ID of the message in the box, as specified by message_index.
vm_gsm_sms_get_message_id_list	Gets the message ID list of the messages on the device through the query. The query attributes are specified in query_data. The message ID list is obtained through the callback, vm_gsm_sms_callback(), which takes vm_gsm_sms_callback_t with vm_gsm_sms_query_message_callback_t as action_data that contains the result of the query.
vm_gsm_sms_is_sms_ready	Checks if the SMS message is ready.
vm_gsm_sms_read_message	Reads message data, including message status, number, content and other attributes (Storage Type, SIM Card, Profile element, etc.) specified by the flag. The buffer to save the content should be provided by the caller. The Callback Action Data Structure is vm_gsm_sms_read_message_data_callback_t;
vm_gsm_sms_send	Sends SMS
vm_gsm_sms_set_interrupt_event_handler	Sets the interrupt handler for the specified event type.

Macros

Macro	Description
VM_GSM_SMS_MAX_ADDRESS_LENGTH	The maximum length of SMS message address.
VM_GSM_SMS_MESSAGE_CONTENT_LENGTH	The maximum length of SMS message content.

Structs, Records, Enums

Struct, Record, Enum	Description
VM_GSM_SMS_ACTION	SMS Action Type.
vm_gsm_sms_add_message_t	Add Message Data Structure.
VM_GSM_SMS_BOX	SMS Box type.
vm_gsm_sms_callback_t	SMS Operation Callback Data Structure.
VM_GSM_SMS_CAUSE	SMS Cause.
VM_GSM_SMS_CLASS	Message Class Type.
VM_GSM_SMS_DCS	SMS DCS(Data Coding Scheme).
vm_gsm_sms_delete_message_callback_t	Delete Message - Callback Data Structure.
vm_gsm_sms_delete_message_list_callback_t	Delete Message List - Callback Data Structure.
VM_GSM_SMS_EVENT_ID	SMS new message event type.
vm_gsm_sms_event_new_sms_t	Message New SMS Interrupt Event - Callback Data Structure.
vm_gsm_sms_event_ready_t	SMS ready message struct
vm_gsm_sms_event_t	SMS Event Structure.
VM_GSM_SMS_FOLDER	Message Folder type.
vm_gsm_sms_get_center_address_callback_t	Gets SMS center number - Callback Data Structure
VM_GSM_SMS_MTI	Message Type Indication.
VM_GSM_SMS_NETWORK_FLAG	Network type.
vm_gsm_sms_new_message_t	New Message Data Structure.
VM_GSM_SMS_ORDER	SMS Sorting Order.
VM_GSM_SMS_PARAMETER	SMS Parameter Flag.
VM_GSM_SMS_PROTOCOL_IDENTIFIER	Protocol Identifier
vm_gsm_sms_query_message_callback_t	Query Message - Callback Data Structure.
vm_gsm_sms_query_t	Query Data Structure.
vm_gsm_sms_read_message_data_callback_t	Read Message - Callback Data Structure.
vm_gsm_sms_read_message_data_t	Message Data Structure.
VM_GSM_SMS_RESULT	SMS request results.
vm_gsm_sms_save_message_callback_t	Add Message - Callback Data Structure.
VM_GSM_SMS_SEND_RESULT	The results of SMS send.
VM_GSM_SMS_SIM	SIM Card Type
VM_GSM_SMS_SORT	SMS Sort Type.
VM_GSM_SMS_STATUS	Message Status.
VM_GSM_SMS_STORAGE	Message Storage Type
VM_GSM_SMS_VALIDITY_PERIOD	Validity period.

Types

Type	Description
vm_gsm_sms_callback	SMS operation callback function.
vm_gsm_sms_event_callback	SMS event callback function.

Links

Topics, Functions, Macros, Structs, Records, Enums, Types

Created with a commercial version of

Doc-O-Matic. In order to make this message disappear you need to register this software. If you have problems registering this software please contact us at

support@toolsfactory.com.