Home | Downloads | Support | Newsletter | Documentation | Search
 
Documentation
Home
Downloads
Support
Documentation
Related Links

WAP Configuration OTA Messages

The gateway supports OTA documents containing "Browser settings" or "Browser bookmarks", compatible with the Nokia/Ericsson "Over The Air Settings Specification", with support up to v7.0.

This specification can be downloaded from the developer area of either the Nokia or Ericsson web sites.

Three approaches are provided for sending WAP Configuration OTA messages:

  1. The “web menu” interface of the gateway provides a menu based interface for specifying WAP configuration settings.
  2. URL parameters can be passed to the gateway to dynamically define WAP configuration settings.

  3. Manually create an OTA document based on the Nokia/Ericsson specification, and store this document in the “OTA” subdirectory of the gateway installation, or POST the document to the gateway via the web interface.

The “web menu” interface is defined in the help section titled “Web Menu Interface”. The other approaches are defined below.

WAP Configuration OTA – URL Parameters

Using the WAP Configuration OTA URL parameters requires a good understanding of the Nokia/Ericsson OTA Specification. This document specifies the mapping of gateway URL parameters to OTA setting parameters. The value provided for the gateway URL parameter is applied to the corresponding OTA setting parameter. Please refer to the Nokia/Ericsson specification for documentation of the OTA setting parameters.

OTA_BEARER – maps to TYPE=ADDRESS, PARM NAME=BEARER

OTA_PPP_AUTHTYPE – maps to TYPE=ADDRESS, PARM NAME=PPP_AUTHTYPE

OTA_PPP_AUTHNAME – maps to TYPE=ADDRESS, PARM NAME=PPP_AUTHNAME

OTA_PPP_AUTHSECRET – maps to TYPE=ADDRESS, PARM NAME=PPP_AUTHSECRET

OTA_PPP_LOGINTYPE – maps to TYPE=ADDRESS, PARM NAME=PPP_LOGINTYPE

OTA_PROXY – maps to TYPE=ADDRESS, PARM NAME=PROXY

OTA_PROXY_TYPE – maps to TYPE=ADDRESS, PARM NAME=PROXY_TYPE

OTA_PROXY_AUTHNAME – maps to TYPE=ADDRESS, PARM NAME=PROXY_AUTHNAME

OTA_PROXY_AUTHSECRET – maps to TYPE=ADDRESS, PARM NAME=PROXY_AUTHSECRET

OTA_PROXY_LOGINTYPE – maps to TYPE=ADDRESS, PARM NAME=PROXY_LOGINTYPE

OTA_PORT – maps to TYPE=ADDRESS, PARM NAME=PORT

OTA_CSD_DIALSTRING – maps to TYPE=ADDRESS, PARM NAME=CSD_DIALSTRING

OTA_CSD_CALLTYPE – maps to TYPE=ADDRESS, PARM NAME=CSD_CALLTYPE

OTA_CSD_CALLSPEED – maps to TYPE=ADDRESS, PARM NAME=CSD_CALLSPEED

OTA_ISP_NAME – maps to TYPE=ADDRESS, PARM NAME=ISP_NAME

OTA_SMS_SMSC_ADDRESS – maps to TYPE=ADDRESS, PARM NAME=SMS_SMSC_ADDRESS

OTA_USSD_SERVICE_TYPE – maps to TYPE=ADDRESS, PARM NAME=USSD_SERVICE_TYPE

OTA_GPRS_ACCESSPOINTNAME – maps to TYPE=ADDRESS, PARM NAME=GPRS_ACCESSPOINTNAME

OTA_URL – maps to TYPE=URL

OTA_MMSURL – maps to TYPE=MMSURL

OTA_NAME – maps to TYPE=NAME, PARM NAME=NAME

OTA_BOOKMARK_NAME – maps to TYPE=BOOKMARK, PARM NAME=NAME

OTA_BOOKMARK_URL – maps to TYPE=BOOKMARK, PARM NAME=URL

OTA_ID – maps to TYPE=ID, PARM NAME=NAME


Note that the “Send WAP OTA Settings” implementation in the gateway “web menu” interface uses this URL interface to submit OTA setting parameters. Viewing the source HTML for the corresponding “web menu” interface pages may provide an improved understanding of this URL interface.

WAP Configuration OTA – OTA Documents

It is also possible to provide OTA configurations by creating one or more OTA documents that contain settings compatible with the Nokia/Ericsson specification.

OTA documents should be created in the OTA subdirectory of the gateway installation, and given a file extension of “.OTA”.

Once an OTA document has been created, to send an OTA "Browser settings" file to a mobile phone, use the following URL format:

http://127.0.0.1:8800/?PhoneNumber=xxxxxxxx&OTA=filename

The "OTA" parameter specifies the name of a file located in the OTA subdirectory of the gateway with a file extension of ".OTA". For example, in the above sample URL, the gateway would attempt to locate a file named "filename.OTA" in the OTA gateway subdirectory.

To send an OTA "Browser bookmarks" file to a mobile phone, use the following URL format:

http://127.0.0.1:8800/?PhoneNumber=xxxxxxxx&OTABookmark=filename

The "OTABookmark" parameter uses the same format as the "OTA" parameter when sending "Browser settings", except that it expects the browser bookmark settings file to have a file extension of “.BM”.

An example OTA "Browser settings" file is shown below, for additional information, please refer to the Nokia/Ericsson "Over The Air Settings Specification".


GSM/CSD Settings Example

<?xml version="1.0" encoding="UTF-8"?>

<CHARACTERISTIC-LIST>

<CHARACTERISTIC TYPE="ADDRESS">

<PARM NAME="BEARER" VALUE="GSM/CSD"/>
<PARM NAME="PROXY" VALUE="12.34.56.78"/>
<PARM NAME="CSD_DIALSTRING" VALUE="+12135551212"/>
<PARM NAME="PPP_AUTHTYPE" VALUE="PAP"/>

</CHARACTERISTIC>

<CHARACTERISTIC TYPE="URL" VALUE="http://mobileinternet.ericsson.com"/>

<CHARACTERISTIC TYPE="NAME">

<PARM NAME="NAME" VALUE="Mobile Internet"/>

</CHARACTERISTIC>

<CHARACTERISTIC TYPE="BOOKMARK">

<PARM NAME="NAME" VALUE="Mobile Internet"/>
<PARM NAME="URL" VALUE="http://mobileinternet.ericsson.com"/>

</CHARACTERISTIC>
</CHARACTERISTIC-LIST>

It is also possible to send OTA messages without creating an OTA document on the gateway by submitting an HTTP POST request to the gateway with the content of the POST message being an OTA “Browser Settings” file. It is not possible to submit such a request via a standard web browser, instead this request must be submitted programmatically. Submit the POST to a URL of:

http://127.0.0.1:8800/?PhoneNumber=xxxxxxxx&OTA=POST

When submitting an OTA request in this manner, the HTTP POST request must include a “Content-Length:” header.

For a complete list of URL parameters, please refer to the section “URL Parameters for Sending Messages”.



Return to Now SMS/MMS Gateway Help