SmsService

The Sms Service is the main component used for sending text messages. The service consists of a Transport object. The Transport object is used to send an Sms text message. The Transport object can be changed via altering the 'Transport Type' Property. By default the SerialSmsTransport object is used.

All text messages are queued under the Sms Service. If there are any text messages queued when the station shuts down, they will be sent when the station next starts up.

Properties

Enabled: Enables or disables the Sms service. If this is set to 'false', no text messages will be sent.
Transport Type: Change the Transport object used to send text messages.
Transport: This object is used by the service to send text messages.
Monitor: The ping monitor for the service. This can be used to disable the ping request or set its frequency.
Signal Strength: The current signal strength of the GSM modem. There is no strict signal strength limit for sending a text message as this varies from provider to provider. Typically 30% or greater should be ok for sending a text message.
Max Queue Size: The maximum size of the Sms message queue.
Queue Size: The current size of the queue.
Process Queue Retry Interval: The retry interval for checking for messages to be sent.
Max Sendable Per Day: The maximum number of messages that can be sent in one day.
Number Sent Today: The total number of messages sent today. This number gets reset to zero at midnight everyday and whenever the station is started.
Last Message Sent Time: A timestamp of the last message sent
Use Escape Characters: When this Property is set to 'true', some foriegn characters (mostly European) will be subsituted for those from the GSM character set.
Read Messages Interval: The interval for checking for unread text messages on the GSM device.

Actions

Ping: Ping the GSM modem to ensure it is connected. This will also try to update the signal strength if the ping succeeds.
Send: Send a text message!
Clear Queue: Clear the queue of all text messages waiting to be sent.
Process Queue: The queue is polled every minute or when a new message is added. Once polled, all messages in the queue will be attempt to be sent. Once a message has been sent, it will be cleared from the queue. This action sends any text messages within the queue.
Reset Number Sent Today: Reset the number of messages sent today. Please note the number of messages sent will get reset automatically at midnight everyday and whenever the station is started.
Read Messages: Reads the unread text messages from the GSM device.

Topics

Received: Fires every time a new unread text message is found on the GSM modem. If you are a developer, this is the hook for processing unread messages from the GSM device.