Short Message Format - Siemens TC65 JAVA User Manual

TC65 JAVA User's Guide
Strictly confidential / Draft
9.4

Short Message Format

An OTAP control SM must be a Submit PDU with Class1, PID $7d and 8 bit encoding. As a
fallback for unusual network infrastructures the SM can also be of Class0 and/or PID $00.
The content of the SM consists of a set of keywords and parameter values. These
parameters might be distributed over several SMs. There is one single keyword to start the
OTAP procedure. For parameters that are repeated in several SMs only the last value sent is
valid. For example, an SM could look like this:
Install operation:
First SM: OTAP_IMPNG
PWD:secret
JADURL:http://www.greatcompany.com/coolapps/mega.jad
APPDIR:a:/work/appdir
HTTPUSER:user
HTTPPWD:anothersecret
Second SM: OTAP_IMPNG
PWD:secret
BEARER:gprs
APNORNUM:access.to-thenet.net
NETUSER:nobody
NETPWD:nothing
DNS:192.168.1.2
START:install
Delete operation:
OTAP_IMP1.0
PWD:secret
APPDIR:a:/work/appdir
START:delete
The first line is required: it is used to identify an OTAP SM. All other lines are optional and
their order is insignificant, each line is terminated with an LF: '\n' even the last one. The
keywords, in capital letters, are case sensitive. A colon separates the keywords from their
values.
The values of APPDIR, BEARER and START are used internally and have to be lower case.
The password (PWD) is case sensitive. The case sensitivity of the other parameter values
depends on the server application or the network. It is likely that not all parameters can be
sent in one SM. They can be distributed over several SMs. Of course, every SM needs to
contain the identifying first line and the PWD parameter, if necessary. The OTAP is started
when the keyword START, possibly with a parameter, is contained in the SM and the
parameter set is valid for the requested operation. It always ends with a reboot, either when
the operation is completed, an error occurred, or the safety timer expired. This also means all
parameters previously set by SM are gone.
Apart from the first and the last line in this example, these are the parameters described in
the previous section. Possible parameters for the START keyword are: "install", "delete" or
nothing. In the last case, an install operation is done by default.
The network does not guarantee the order of SMs. So when using multiple SMs to start a
TC65 JAVA User's Guide_V01 Page 42 of 69
s
11.03.2005