User manual

MPTP | MPTP commands 75
The appearance of the message is normally accompanied by playing the message reception tone and
using lights and vibration as set in the receiving terminal; however, these default settings can be
overridden by the Forced tone, Forced volume, Forced vibration and Forced lights parameters in the
message. Moreover, the tone and other effects taking place at the time of reception can be repeated later
to make sure that the user of the receiving terminal notices the message. This is done by setting the
Reminder interval.
The message will remain visible until it is dismissed by acknowledging with a button by short press (short
press and key up will clear). END/Hang up/RED or number key button of the device or until it is replaced
by another message. It will not be stored anywhere, but if there is any other event before the user
acknowledges the message it will be resumed after other UI events, e.g. incoming call.
The parameter called ’Forced effects’ should appear after part number. Having value 0 means that no
forced effects shall be used and there will be no recurring reminders; the command format would then
continue with message text directly after part number. Having value 1 means that all effects and the
reminder should be present as in the concept.
Sending empty message string will clear the display and end the OSM event in the device.
Command format
Command
Part number
Forced effects
Forced tone
Forced volume
Forced vibration
Forced lights
Reminder interval
Message
4 1 5 1 1 1 1…3 1 1 1 1 1 1 1 1…5 1 0…139
?OSM_01/01_ _ - _ - _ 1 _ 1 _ 60 _ Fire – evacuate
The command-specific fields of the command are as follows:
Field Description Range
Forced
effects
This field defines if the Forced Effects are
used or not.
0= do not use forced settings ( defaults will
be used)
1= forced effects are used ( all fields must
be defined )
0-1
Forced
tone
Tone played upon arrival of the message.
- Use default message
reception tone.
0 Do not use a tone.
1…999 Use tone with given number.
-, 0…999
Forced volume Volume at which the tone is played.
- Use default message
reception volume.
0…5 Use volume at given level,
with 0 signifying silent
operation.
-, 0…5