This CDK is based on the Logica SMPP SDK.  Its main purpose is to allow developers to easily and quickly send Over-the-Air (OTA) Bookmarks through an SMSC Gateway.

The OTA specification is designed to send messages containing auto setup settings for mobile devices.  Not all mobile telephones support OTA messages. OTA is a standard developed by an Ericsson/Nokia partnership so that difficult or changing configurations could be sent and automatically processed by a mobile phone.  One kind of auto setup message is OTA Bookmarks, which basically instructs a mobile phone to add a specific bookmark to the phone's bookmark storage and be available to the user. The OTA specifies XML-oriented messaging, but XML messages can become quite large and they have to be converted to WBXML for transmission.

The CDK has example code for two use cases:

• Sending a plain text SMS.      
• Sending an OTA Bookmark SMS.

Contents:

• /doc - Documents (SMPP, OTA) and Logica example      
• /example - Source and Binary for the use of the CDK      
• /lib - Logica SMPP Library and SMPP simulator library      
• /tools - Logica SMPP Simulator.

The CDK consists of three classes built on top of the Logica API:

• LogicaSmscApiAccess – This class wraps all the functionality to send either SMS text messages or binary content.      
• The constructor requires an SMSC address and port along with authentication information. An additional parameter – a properties file that specifies the bulk of the communication settings – is mandatory. An example file is provided with the code, and in the Javadoc an explanation is available of the parameters. For more information consult the SMPP specification. A simple interactive example to send text SMS is included; see the Javadoc for details.      
• LogicaApiPduEventListener – This inner class implements the required listener for asynchronous connections.  Using the synchronous mode is recommended.      
• BookmarkBuilder – This class provides the interface to create and format bookmarks according to the OTA and WBXML specifications.  Currently, only one bookmark per message is supported.  This class can also fragment large datagrams into packets that can be processed by an SMSC gateway. A simple interactive and scripting example to send an OTA Bookmark is included; see the Javadoc for details.

The CDK connects to the SMSC in the interactive mode just before sending a message.  Client disconnection may be experienced if the SMSC connection timeout is set too short.

The client must be carefully configured – follow your SMSC gateway configuration. The properties file provided is for testing purposes but it should work without any major change. Refer to the SMPP specification when altering values.  All byte values are represented as base-10 signed integers.

Despite the limited availability of a live SMSC gateway the CDK has been tested successfully with bookmarks that don’t span over one packet.  Bookmarks having more than one packet (127 bytes) have not been tested against a live SMSC gateway, but behave favorably in the Logica SMSC Simulator.

Changes since last version (1.0):

• Now supports packet fragmenting for large bookmarks