CalAmp Vanguard 3000 User Manual

Also see for Vanguard 3000: Quick start guide Quick start guide

Contents

CalAmp Vanguard 3000 User Manual Manual pdf 116 page image

APPENDIX D — SMS INTERFACEThe Vanguard 3000 has the capability to receive and send SMS messages. This appendix describes how this feature isimplemented and can be used as a technical reference by system administrators and developers installing and usingVanguard 3000. The standard on which the Vanguard 3000 SMS interface is based is the NMEA (National MarineElectronics Association) 0183 Standard for Interfacing Marine Electronic Devices version 2.30 (March 1, 1998).Note: The current SMS implementation only supports 7-bit dada consisting of a subset of the standard ASCII characterset (160 characters, max.). Future versions may add raw binary 8-bit data (which also may limit message length to 140characters max.).SMS MESSAGE ROUTINGThe Vanguard 3000 may have more than one SMS client internally. Unlike IP, SMS messages are not easily routable.(Although SMS does have a UDH [user-data header], the Vanguard 3000 does not make use of this since it makes thesending of messages significantly more complex.)SMS Message Prefix, OutgoingOutgoing SMS messages are directed according to the phone number supplied by the client. The SMS Manager placesno restrictions on the contents of the outgoing message body, although a prefix scheme similar to the one used forincoming messages could be implemented if the Host application needs to receive SMS messages from multipleapplications.SMS Message Prefix, IncomingCalAmp’s SMS Manager makes use of message prefixes to route incoming messages to client applications. Each clientregisters a unique prefix string. The SMS Manager inspects all incoming messages to these prefixes and routes themessage to the appropriate client.For example, if the client registers “MY_CLIENT” and the host wishes to send a command “GETSTATUS,” it must be sentas follows:MY_CLIENTGETSTATUSNote that the client will receive the complete message including the prefix.If a client attempts to register a prefix that is already registered by another client, the request will be refused and anerror message will be returned.Note that a client may at any time re-register using another unique prefix string. In order to unregister, a client mustdisconnect from the SMS server.Blank PrefixA client may register a blank string as the prefix. The client will receive all messages with prefixes not matching any ofthe other registered client prefix strings. Note that as with a nonblank prefix, only one client may register a blankprefix.Vanguard 3000 Series Multicarrier Cellular Data Modem & IP Router PN 001-7300-100 Rev. B | Page 110