/* * ota_prov_attr.h: binary encoded XML tag constants for the OTA provisioning * * In order to make handsets accept browser settings sent over the air, the * settings must be provided in a binary encoded XML document with a specific * MIME-type depending on the setting type. The settings must be pushed over * SMS to a predefined WDP (Wireless Datagram Protocol) port (49999) as a WSP * (Wirless Session Protocol) connection less unsecure push. Handsets able to * receive settings over the air must always listen on this port. *  * Two setting MIME-types are defined: * *  - application/x-wap-prov.browser-settings *  - application/x-wap-prov.browser-bookmarks * * Description of the XML DTD (Document Type Definition): * *   <!ELEMENT CHARACTERISTIC-LIST(CHARACTERISTIC)+> *   <!ELEMENT CHARACTERISTIC(PARM*)> *   <!ATTLIST CHARACTERISTIC *     TYPE     CDATA       #REQUIRED *     VALUE    CDATA       #IMPLIED *   > *   <!ELEMENT PARM EMPTY> *   <!ATTLIST PARM *     NAME     CDATA       #REQUIRED *     VALUE    CDATA       #REQUIRED *   > * * Simple example of a XML document: * *   <?xml version="1.0"?> *   <!DOCTYPE CHARACTERISTIC-LIST SYSTEM "/DTD/characteristic_list.xml"> *   <CHARACTERISTIC-LIST> *      <CHARACTERISTIC TYPE="ADDRESS"> *          <PARM NAME="BEARER" VALUE="GSM/CSD"/> *          <PARM NAME="PROXY" VALUE="10.11.12.13"/> *          <PARM NAME="CSD_DIALSTRING" VALUE="013456789"/> *          <PARM NAME="PPP_AUTHTYPE" VALUE="PAP"/> *          <PARM NAME="PPP_AUTHNAME" VALUE="wapusr"/> *          <PARM NAME="PPP_AUTHSECRET" VALUE"thepasswd"/> *      </CHARACTERISTIC> *      <CHARACTERISTIC TYPE="NAME"> *          <PARM NAME="NAME" VALUE="Our company's WAP settings"/> *      </CHARACTERISTIC> *      <CHARACTERISTIC TYPE="URL" VALUE="http://wap.company.com"/> *      <CHARACTERISTIC TYPE="MMSURL" VALUE="http://mms.company.com"/> *      <CHARACTERISTIC TYPE="BOOKMARK"> *          <PARM NAME="NAME" VALUE="Our company's WAP site"/> *          <PARM NAME="URL" VALUE="http://wap.company.com"/> *      </CHARACTERISTIC> *   </CHARACTERISTIC-LIST> * * (based upon the Nokia Over The Air Settings Specification) * * initial re-engineered code by Yann Muller - 3G Lab, 2000. * fixed to support official specs by Stipe Tolj - Wapme Systems AG, 2001. * extensive inline documentation by Stipe Tolj - Wapme Systems AG, 2001. */ /*  * The XML document which is build in smsbox.c:smsbox_req_sendota() is  * binary encoded according to WBXML with the following global tokens  */#define WBXML_TOK_END_STR_I             0x00#define WBXML_TOK_END                   0x01#define WBXML_TOK_STR_I                 0x03/******************************************************************** * Description of the single XML tag tokens */#define WBXML_TOK_CHARACTERISTIC_LIST   0x05/* * This element groups the browser settings into logical different types: * ADDRESS, BOOKMARK, URL, MMSURL, NAME and ID. */#define WBXML_TOK_CHARACTERISTIC        0x06/* * The PARM element is used to provide the actual value for the individual * settings parameters within each CHARACTERISTIC element. */#define WBXML_TOK_PARM                  0x07/* * Tokens representing the NAME or VALUE tags  */#define WBXML_TOK_NAME                  0x10#define WBXML_TOK_VALUE                 0x11/********************************************************************  * CHARACTERISTIC elements with TYPE=ADDRESS  *  * Characteristics elements with the TYPE=ADDRESS attribute embrace settings * concerning a particular bearer, e.g. GSM/SMS or GSM/CSD. Several address * settings can be provided in one document. However, for each bearer, only * the address settings listed first will be used. The type of the bearer is * specified by a PARM attribute and depending on the bearer additional PARM * elements are required or optional. * * Example: * *      <CHARACTERISTIC TYPE="ADDRESS"> *          <PARM NAME="BEARER" VALUE="GSM/CSD"/> *          <PARM NAME="PROXY" VALUE="10.11.12.13"/> *          <PARM NAME="CSD_DIALSTRING" VALUE="013456789"/> *          <PARM NAME="PPP_AUTHTYPE" VALUE="PAP"/> *          <PARM NAME="PPP_AUTHNAME" VALUE="wapusr"/> *          <PARM NAME="PPP_AUTHSECRET" VALUE"thepasswd"/> *      </CHARACTERISTIC> */#define WBXML_TOK_TYPE_ADDRESS          0x06/* * The PARM element with NAME=BEARER attribute is used to identify the bearer * to be used for a specific setting set. VALUE can be assigned following: * *   VALUE -> [*GSM_CSD*|GSM_SMS|GSM_USSD|IS136_CSD|GPRS] */#define WBXML_TOK_NAME_BEARER           0x12#define WBXML_TOK_VALUE_GSM_CSD         0x45#define WBXML_TOK_VALUE_GSM_SMS         0x46#define WBXML_TOK_VALUE_GSM_USSD        0x47#define WBXML_TOK_VALUE_IS136_CSD       0x48#define WBXML_TOK_VALUE_GPRS            0x49/* * The PARM element with NAME=PROXY attribute is used to identify the IP * address of the WAP proxy in case of CSD and the service number in case of * SMS. In case of USSD the PROXY can be either an IP address or an MSISDN * number. This is indicated in the PROXY_TYPE PARM element. VALUE can be  * assigned following: * *   VALUE -> proxy(using inline string) */#define WBXML_TOK_NAME_PROXY            0x13/* * The PARM element with NAME=PORT attribute specifies whether connection less * or connection oriented connections should be used. VALUE can be assigned * following: * *   VALUE -> [*9200*|9201|9202|9203] * * Use 9200 (or 9202) for connection less connections and 9201 (or 9203) for * connection oriented connections. Port numbers 9202 and 9203 enable secure * connections (by means of WTLS), whereas port numbers 9200 and 9201 disable * secure connections. */#define WBXML_TOK_NAME_PORT             0x14#define WBXML_TOK_VALUE_PORT_9200       0x60#define WBXML_TOK_VALUE_PORT_9201       0x61#define WBXML_TOK_VALUE_PORT_9202       0x62#define WBXML_TOK_VALUE_PORT_9203       0x63/* * The PARM element with the NAME=PROXY_TYPE attribute is used to identify  * the format of the PROXY PARM element. VALUE can be assigned following: * *   VALUE -> [*MSISDN_NO*|IPV4] */#define WBXML_TOK_NAME_PROXY_TYPE       0x16#define WBXML_TOK_VALUE_MSISDN_NO       0x76#define WBXML_TOK_VALUE_IPV4            0x77/* * The PARM elements with the NAME=PROXY_AUTHNAME and NAME=PROXY_AUTHSECRET * attributes indicates the login name and password to be used for gateway  * required authentication. Support of this PARM elements is manufacturer  * specific. VALUEs can be assigned following: * *   VALUE -> login name(using inline string) *   VALUE -> password(using inline string) */#define WBXML_TOK_NAME_PROXY_AUTHNAME       0x18#define WBXML_TOK_NAME_PROXY_AUTHSECRET     0x19/* * The PARM element with the NAME=PROXY_LOGINTYPE attribute specifies whether * an automatic or manual login should be performed at the proxy. VALUE can * be assigned following: * *   VALUE -> [AUTOMATIC|MANUAL] * * Using the MANUAL logintype the user will be prompted for username and  * password when a browse session is started. Using the AUTOMATIC logintype * the user will be NOT prompted for username and password when a browse * session is started, but a static name and password from the WAP settingset * will be used. */#define WBXML_TOK_NAME_PROXY_LOGINTYPE      0x1E#define WBXML_TOK_VALUE_AUTOMATIC           0x64#define WBXML_TOK_VALUE_MANUAL              0x65/* * The PARM element with the NAME=PPP_AUTHTYPE attribute indicates which  * protocol to use for user authentication. VALUE can be assigned following: * *   VALUE -> [*PAP*|CHAP|MS_CHAP] * * PAP is short for Password Authentication Protocol, a type of authentication * which uses clear-text passwords and is the least sophisticated  * authentication protocol, and CHAP stands for Challenge Handshake  * Authentication Protocol, a protocol used to negotiate the most secure form * of encrypted authentication supported by both server and client. MS_CHAP * (Microsoft(tm)-CHAP) is similar to the CHAP protocol, but is using an  * encryption scheme that is alternative to the one used for CHAP. */#define WBXML_TOK_NAME_PPP_AUTHTYPE         0x22#define WBXML_TOK_VALUE_AUTH_PAP            0x70#define WBXML_TOK_VALUE_AUTH_CHAP           0x71#define WBXML_TOK_VALUE_AUTH_MS_CHAP        0x78/* * The PARM elements with the NAME=PPP_AUTHNAME and NAME=PPP_AUTHSECRET * attributes indicate the login name and password to be used. VALUEs can be  * assigned following: * *   VALUE -> login name(using inline string) *   VALUE -> password(using inline string) * * Maximum length of login name is 32 bytes. * Maximum length of password is 20 bytes. */#define WBXML_TOK_NAME_PPP_AUTHNAME         0x23#define WBXML_TOK_NAME_PPP_AUTHSECRET       0x24/*