FALCOM MAMBOII User manual

THIS DOCUMENT IS AVAILABLE AT HTTP://WWW.FALCOM.DE/
MAMBOII
operating with firmware version 2.4.0
Configuration Command Set
User’s guide
Supports both GSM and TCP applications
Version: 1.1.0; Last Updated: 1 /09/2007; This document will be regularly updated.

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
Table of contents
INTRODUCTION ...................................................................................... 2
1.1 About this document .......................................................................................................12
1.1 Related documents ..........................................................................................................13
2 GENERAL ............................................................................................ 4
2.1 Features of the Firmware ................................................................................................14
2.2 The principle of firmware operation .............................................................................. 16
2.3 Internet and intranet applications setup with MAM OII ..............................................18
2.3.1 Internet based appli ations ...........................................................................................18
2.3.2 Intranet appli ations ..................................................................................................... 19
2.4 TCP/IP Overview .............................................................................................................. 19
2.5 IEEE 802.15.4 Overview ...................................................................................................19
3 COMMAND SYNTAX, PFAL COMMANDS AND SUPPORTED PARAMETERS– FOR
FALCOM MAMBOII .......................................................................... 20
3.1 PFAL Command syntax and response message structure .........................................20
3.1.1 Command syntax of PFAL ommands .........................................................................20
3.1.1.1 Command types <c_type> .............................................................................................................. 22
3.1.2 Aliases ..........................................................................................................................22
3.1.3 Using identifiers (optional) ............................................................................................23
3.1.4 Response ommand stru ture ......................................................................................23
3.2 PFAL Commands .............................................................................................................25
3.2.1 “Sys” ommand type .....................................................................................................31
3.2.1.1 “Security command index .............................................................................................................. 31
3.2.1.1.1 Sys.Se urity.Lo k,”password” – Sends a pasword to lo k your system ................................... 31
3.2.1.1.2 Sys.Se urity.Unlo k,”password” – Sends a pasword to unlo k your system ........................... 31
3.2.1.1.3 Sys.Se urity.RemoveLo k,”password” – Sends a password to remove lo king of your system
.................................................................................................................................................. 32
3.2.1.2 “RUpdate command index ............................................................................................................. 33
3.2.1.2.1 Sys.RUpdate.Init – Initializes remote upgrade ......................................................................... 33
3.2.1.2.2 Sys.RUpdate.DataMode,<msg_input> – Defines transfer hannel & ontinues upgrading ..... 34
3.2.1.2.2.1 Binary update commands ....................................................................................................35
3.2.1.2.2.2 List of binary commands ..................................................................................................... 35
3.2.1.2.3 Sys.RUpdate.Finish – Finishes Remote Update ...................................................................... 37
3.2.1.3 “Device command index ................................................................................................................ 38
3.2.1.3.1 Sys.Devi e.Reset – Resets the system ................................................................................... 38
3.2.1.3.2 Sys.Devi e.Update – Set the system into the update mode .................................................... 38
3.2.1.3.3 Sys.Devi e.Shutdown – Shutdown the system ........................................................................ 39
3.2.1.3.4 Sys.Devi e.Fa toryReset – Resets onfiguration to its default ................................................. 39
3.2.1.3.5 Sys.Devi e.Sleep=<type> – Puts the system into the sleep state ............................................ 39
3.2.1.3.6 Sys.Devi e.ClearAlarm – Clears existing alarms and restart the devi e ................................. 42
3.2.1.3.7 Sys.Devi e.ClearConfig – Clear existing onfiguration ............................................................. 42
3.2.1.3.8 Sys.Devi e.CfgUpdateMode – Prevents interferen es between old and new alarms .............. 42
3.2.1.4 “Timer command index .................................................................................................................. 44
3.2.1.4.1 Sys.Timer<index>.Configure=<mode>,<timeout> – Configures Timers ................................... 44
3.2.1.4.2 Sys.Timer<index>.Start=<timer_settings>– Starts/restarts Timers ...........................................45
3.2.1.4.3 Sys.Timer<index>.Stop– Stop running Timers ..........................................................................46
3.2.1.4.4 Sys.Timer<index>.Pause – Pauses (suspends) running Timers .............................................. 46
3.2.1.4.5 Sys.Timer<index>.Resume– Restarts the exe ution of paused timers .....................................47
3.2.1.4.6 Sys.Timer<index>.Arm– Arms initialized and disarmed timers ................................................. 47
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 2 of 271

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
3.2.1.4.7 Sys.Timer<index>.Disarm – Disarms initialized and armed Timers ..........................................47
3.2.1.4.8 Sys.Timer<index>.Erase – Erases Timer settings .................................................................... 48
3.2.1.4.9 Sys.Timer<index>.Save<storage_index>– Saves Timer state to Storage index ...................... 48
3.2.1.4.10 Sys.Timer<index>.Load<storage_index>– Loads Timers with Storage ontents ................... 49
3.2.1.4.11 Sys.Timer<index>.State – Reads Timer state .........................................................................49
3.2.1.5 “Trigger command index ................................................................................................................ 50
3.2.1.5.1 Sys.Trigger<index>.Set=<state_type> – A tivates/dea tivates system Triggers ......................50
3.2.1.5.2 Sys.Trigger<index>– Reads triggers state ................................................................................ 50
3.2.1.5.3 Sys.Trigger<index>.Save<storage_index>– Saves Trigger state to Storage index ..................51
3.2.1.5.4 Sys.Trigger<index>.Load<storage_index>– Load Triggers with Storage ontents ...................51
3.2.1.6 “Counter command index .............................................................................................................. 52
3.2.1.6.1 Sys.Counter<index>.Set=<value> – Sets Counters to a value ................................................. 52
3.2.1.6.2 Sys.Counter<index>.In rement=<in _value> – In rements Counter’s value ............................53
3.2.1.6.3 Sys.Counter<index>.De rement=<de _value> – Subtra ts Counter’s value ........................... 53
3.2.1.6.4 Sys.Counter<index>.State – Reads Counter’s state ................................................................ 54
3.2.1.6.5 Sys.Counter<index>.Save<storage_index>– Saves Counter’s state to Storage index ............ 54
3.2.1.6.6 Sys.Counter<index>.Load<storage_index>– Loads Counters with storage ontents ...............55
3.2.1.6.7 Sys.Counter<index>.Clear – Sets Counters to 0 ...................................................................... 55
3.2.1.7 “MACRO command index .............................................................................................................. 56
3.2.1.7.1 Sys.Ma ro<index>– A tivates onfigured Ma ros .................................................................... 56
3.2.1.8 “GSM command index ................................................................................................................... 57
3.2.1.8.1 Sys.GSM.Enable – Powers on the GSM engine ...................................................................... 57
3.2.1.8.2 Sys.GSM.Disable – Powers off the GSM engine ...................................................................... 57
3.2.1.8.3 Sys.GSM.Reset – Resets the GSM engine ..............................................................................57
3.2.1.9 “GPS command index .................................................................................................................... 58
3.2.1.9.1 Sys.GPS.Enable – Powers on the GPS engine ....................................................................... 58
3.2.1.9.2 Sys.GPS.Disable – Powers down the GPS engine .................................................................. 58
3.2.1.9.3 Sys.GPS.Reset – Resets the GPS engine ............................................................................... 58
3.2.1.10 “UserEvent command index ........................................................................................................ 59
3.2.1.10.1 Sys.UserEvent<index> – Creates a user-event for spe ifi appli ation requirements ............59
3.2.1.11 “BAT command index .................................................................................................................. 60
3.2.1.11.1 Sys.Bat.Voltage – Queries battery voltage .............................................................................60
3.2.1.11.2 Sys.Bat.ChargeState – Gets the urrent ba kup battery state ..............................................60
3.2.1.12 “BT command index ..................................................................................................................... 61
3.2.1.12.1 Sys.BT.Enable – Powers on the Bluetooth module ................................................................61
3.2.1.12.2 Sys.BT.Disable – Powers off the Bluetooth module .............................................................. 61
3.2.1.12.3 Sys.BT.Reset – Resets the Bluetooth hip ............................................................................. 62
3.2.1.13 “CPU command index ..................................................................................................................63
3.2.1.13.1 Sys.CPU.Reset – Resets the ARM7 ontroller and sets the devi e into the upgrade mode. . 63
3.2.1.14 “IEEE command index ................................................................................................................. 64
3.2.1.14.1 Sys.IEEE.Enable – Powers on the IEEE module ................................................................... 64
3.2.1.14.2 Sys.IEEE.Disable – Powers off the IEEE module ................................................................... 64
3.2.1.14.3 Sys.IEEE.Reset – Resets the IEEE module ............................................................................ 64
3.2.1.15 “DISPLAY command type ............................................................................................................ 65
3.2.1.15.1 Display.Show – Displays a spe ifi view on the MAMBOII's s reen ...................................... 65
3.2.1.15.2 Display.Dialog – Creates a full-s reen dialog box ................................................................... 66
3.2.1.15.3 Display.Alarm – Displays a spe ifi alarm image on the s reen ............................................ 67
3.2.2 “CNF” ommand type ...................................................................................................69
3.2.2.1 Cnf.Set,<parameter_name=value> - Sets up configuration settings for an application and overrides
default settings .......................................................................................................................... 69
3.2.2.2 Cnf.Get,<parameter_name> - Get configuration settings from device .......................................... 74
3.2.2.3 Cnf.Clear,<parameter_name> - Clears all settings in a parameter ................................................ 78
3.2.2.4 Cnf.ShowUser - Shows user specified settings .............................................................................. 79
3.2.2.5 Cnf.ShowDefault - Shows default settings ...................................................................................... 79
3.2.2.6 Cnf.Show - Shows all used parameters .......................................................................................... 80
3.2.2.7 Cnf.Search,<parameter_search> – Searches for a parameter name .............................................81
3.2.3 “IO” ommand type .......................................................................................................82
3.2.3.1 “Beep command index ................................................................................................................... 82
3.2.3.1.1 IO.Beep<index>=< onfig_type> – Generates beep tones ........................................................ 82
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 3 of 271

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
3.2.3.2 “Vibration command index ............................................................................................................. 83
3.2.3.2.1 IO.Vibration=< onfig_type> – Manages devi e vibrations ........................................................ 83
3.2.4 “GPS” ommand type ...................................................................................................84
3.2.4.1 “Nav command index ..................................................................................................................... 84
3.2.4.1.1 GPS.Nav.Position<buffer_index> – Gets the travelled distan e from a stored position ........... 84
3.2.4.1.2 GPS.Nav.Position<buffer_index>=<type> – Stores temporarily a GPS position ...................... 84
3.2.4.1.3 GPS.Nav.Position<buffer_index>=save<storage_index> – Moves GPS position data from buffer
to storage index ........................................................................................................................ 85
3.2.4.1.4 GPS.Nav.Position<buffer_index>=load<storage_index> – Loads GPS data from storage to
buffer index for temporarily use ................................................................................................ 86
3.2.4.1.5 GPS.Nav.Distan e – Gets the urrent travelled distan e from a start point ..............................86
3.2.4.1.6 GPS.Nav.Distan e=<value> – Sets/resets the distan e to a user value ...................................87
3.2.4.1.7 GPS.Nav.SaveLastValid – Saves the last valid position, if no GPS-fix valid ........................... 87
3.2.4.1.8 GPS.Nav.PowerSave=<on>,<onTime>,<lpTime> – Enables/Disables the low power mode ....88
3.2.4.2 “History command index ................................................................................................................ 89
3.2.4.2.1 GPS.History.Write,<flag>,<”text”> – Stores GPS data or user text in the history memory ...... 89
3.2.4.2.2 GPS.History.Clear– Clears the history memory ....................................................................... 90
3.2.4.2.3 GPS.History.GetStart– Shows the oldest date stored in the history memory .......................... 91
3.2.4.2.4 GPS.History.SetRead,<s_date>,<s_time>-,<e_date>,<e_time>– Sele ts the number of re ords
to be downloaded from the history memory ............................................................................ 91
3.2.4.2.5 GPS.History.Read – Downloads the sele ted history re ords in parts ..................................... 92
3.2.4.2.5.1 How to read the history records in textual format ................................................................93
3.2.4.2.5.2 Further notes for converting history data with special remark to data/event logging features
........................................................................................................................................... 95
3.2.4.2.6 GPS.History.Push – Downloads the sele ted history re ords at on e ......................................96
3.2.4.3 “Geofence command index ............................................................................................................98
3.2.4.3.1 GPS.Geofen e.Park.Set –A tivates a park area .......................................................................98
3.2.4.3.2 GPS.Geofen e.Park.Remove– Disables the a tivated park area ............................................. 98
3.2.4.3.3 GPS.Geofen e.GeoState,<geo_id> – Gets the state of a Geofen e ...................................... 100
3.2.4.3.4 GPS.Geofen e.AreaState,<area_id>– Gets the state of an Area ........................................... 100
3.2.5 “GSM” ommand type ................................................................................................ 101
3.2.5.1 “GSM general command indices ................................................................................................. 101
3.2.5.1.1 GSM.PIN=<”pin”> - Enters the PIN number of the used SIM ard ..........................................101
3.2.5.1.2 GSM.PUK=<”puk”>,<”pin”> - Enters the PUK and PIN numbers of the used SIM ard ..........101
3.2.5.1.3 GSM.IMEI – Gets the serial identifi ation number of the devi e ............................................. 101
3.2.5.1.4 GSM.SIMID – Get the ID of SIM Card ..................................................................................... 102
3.2.5.1.5 GSM.OwnNumber– Gets the urrent voi e all number of the devi e .................................... 102
3.2.5.1.6 GSM.Balan e– Gets the a ount information of the used prepaid SIM ard .......................... 102
3.2.5.2 “Voice Call command index ......................................................................................................... 103
3.2.5.2.1 GSM.Voi eCall.Dial,<“p_number“> - Makes a GSM voi e all .............................................. 103
3.2.5.2.2 GSM.Voi eCall.A ept - A epts an in oming voi e all ....................................................... 103
3.2.5.2.3 GSM.Voi eCall.Hangup – Hangs up an a tive voi e all ....................................................... 103
3.2.5.2.4 GSM.Voi eCall.Audio.Profile=<audio_index> – Sets the a tive audio profile .........................104
3.2.5.2.5 GSM.Voi eCall.Ringtone=<type>,<volume> - Sets the ring tone settings .............................. 104
3.2.5.2.6 GSM.Voi eCall.Volume.Speaker=<n_gain>,<volume>,<sidetone> - Sets or gets the
loudspeaker settings .............................................................................................................. 105
3.2.5.2.7 GSM.Voi eCall.Volume.Mi rophone=<gain>,<n_gain> - Sets or gets the mi rophone settings
................................................................................................................................................ 105
3.2.5.3 “SMS command index ................................................................................................................. 106
3.2.5.3.1 GSM.SMS.Send,<”p_number“>,<proto ols>,<”text”> - Sends an SMS message .................. 106
3.2.5.3.2 GSM.SMS.Inbox.State – Shows inbox SMS ........................................................................... 107
3.2.5.3.3 GSM.SMS.Inbox.Clear – Clears inbox SMS ........................................................................... 107
3.2.5.3.4 GSM.SMS.Outbox.State – Shows outbox SMS ..................................................................... 107
3.2.5.3.5 GSM.SMS.Outbox.Clear – Clears outbox SMS ..................................................................... 107
3.2.5.4 “Data Call command index .......................................................................................................... 108
3.2.5.4.1 GSM.DataCall.Send,<proto ols>,<”text”> - Transfers messages via an established data all 108
3.2.5.4.2 GSM.DataCall.A ept - A epts an in oming Data all ......................................................... 108
3.2.5.4.3 GSM.DataCall.Hangup – Hangs up an a tive voi e all ....................................................... 109
3.2.5.5 “GPRS command index ............................................................................................................... 109
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 4 of 271

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
3.2.5.5.1 GSM.GPRS.Conne t – Performs a GPRS atta h ................................................................... 109
3.2.5.5.2 GSM.GPRS.Dis onne t – Performs a GPRS deta h ..............................................................109
3.2.5.5.3 GSM.GPRS.State – Gets the GPRS status ............................................................................ 110
3.2.5.5.4 GSM.GPRS.Traffi =< omplete>,<in oming>,<outgoing> – Set or read a GPRS traffi ounter
................................................................................................................................................ 110
3.2.6 “TCP” ommand type ................................................................................................. 111
3.2.6.1 “TCP command index .................................................................................................................. 111
3.2.6.1.1 TCP.Client.Conne t - Performs a TCP onne tion to the server ............................................ 111
3.2.6.1.2 TCP.Client.Send,<proto ols>,<”text”> - Transfers a TCP pa ket to the onne ted server .....112
3.2.6.1.3 TCP.Client.State – Gets the status of the TCP onne tion ..................................................... 112
3.2.6.1.4 TCP.Client.Dis onne t - Dis onne ts from TCP server .......................................................... 113
3.2.6.2 “STORAGE command index ........................................................................................................114
3.2.6.2.1 TCP.Storage.Dispat h - Moves TCP storage ontents to outgoing TCP buffer ......................114
3.2.6.2.2 TCP.Storage.Clear – Clears TCP Storage .............................................................................. 114
3.2.6.2.3 TCP.Storage.AddProto ol,<proto ols>,<”text”> - Addes data to the TCP storage ................. 115
3.2.6.2.4 TCP.Storage.AddRe ord,<proto ol>,<”text”> - Appends a binary dataframe to the TCP storage
................................................................................................................................................ 116
3.2.6.3 “SMTP command index ............................................................................................................... 118
3.2.6.3.1 TCP.SMTP.Send,<email_address>,<proto ols>,<”text”> - Send an Email to the onne ted
remote server ......................................................................................................................... 118
3.2.7 “MSG” ommand type ................................................................................................ 120
3.2.7.1 “Send command index ................................................................................................................. 120
3.2.7.1.1 MSG.Send.Serial,<proto ols>,<”text”> - Redire ts ommand responses to the serial interfa e
(Bluetooth) .............................................................................................................................. 120
3.2.7.1.2 MSG.Send.RawSerial,<proto ols>,<”text”> - Redire ts ommand responses to the serial
interfa e in unformatted data stru ture ...................................................................................121
3.2.7.1.3 MSG.Send.CSD,<proto ols>,<”text”> - Redire ts ommand responses to CSD hannel. ..... 122
3.2.7.1.4 MSG.Send.TCP,<proto ols>,<”text”> - Redire ts ommand responses to TCP hannel .......123
3.2.7.2 “Mode command index ................................................................................................................ 125
3.2.7.2.1 MSG.Mode.Serial=<out_sys_messages>,<mode>- Defines the ommuni ation mode on serial
hannel .................................................................................................................................. 125
3.2.7.2.2 MSG.Mode.CSD=<out_sys_messages>,<mode> - Defines the ommuni ation mode on CSD
hannel ................................................................................................................................... 127
3.2.7.2.3 MSG.Mode.TCP=<out_sys_messages>,<mode> - Defines the ommuni ation mode on TCP
hannel ................................................................................................................................... 128
3.2.7.3 “Version command index ............................................................................................................. 130
3.2.7.3.1 MSG.Version.Complete - Gets all versions information of the target devi e .......................... 130
3.2.7.3.2 MSG.Version.Modules - Gets the modules versions of the target devi e ............................... 130
3.2.7.3.3 MSG.Version.InternalComm - Gets the internal ommuni ation version of the target devi e 130
3.2.7.3.4 MSG.Version.HardwareRev - Gets the hardware revision of the target devi e ...................... 131
3.2.7.3.5 MSG.Version.Hardware - Gets the hardware version of the target devi e ............................. 131
3.2.7.3.6 MSG.Version.Software - Gets the software version of the target devi e ................................ 131
3.2.7.3.7 MSG.Version.SoftwareID - Gets the firmware ID of the firmware ........................................... 131
3.2.7.4 “Info command index ................................................................................................................... 132
3.2.7.4.1 MSG.Info.ServerLogin – Gets login information that the devi e sends to the server ..............132
3.2.7.4.2 MSG.Info.Proto ol,<proto ols>,<”text”> - Transmits proto ol reports to the sender ...............132
3.2.7.4.3 MSG.Info.Time – Gets the urrent system time ...................................................................... 133
3.2.7.4.4 MSG.Info.Alarm,<alarm_index> - Shows the onfiguration of an alarm ................................. 134
3.2.7.5 “Channel command index ............................................................................................................ 135
3.2.7.5.1 MSG.Channel.SerialGSM – Channels all input ommands transmitted via serial port dire tly to
GSM engine ........................................................................................................................... 135
3.2.8 “IEEE” ommand type ................................................................................................ 136
3.2.8.1 “Keyfob command index .............................................................................................................. 136
3.2.8.1.1 IEEE.Keyfob<kf_div_index>.LED<lindex>=< onfig_type> – Configures LEDs on a Keyfob
devi e ..................................................................................................................................... 136
3.2.8.1.2 IEEE.Keyfob<kf_div_index>.Beep=< onfig_type> – Generates beep tones on a Keyfob devi e
................................................................................................................................................ 137
3.2.8.1.3 IEEE.Keyfob<kf_div_index>.Vibration=< onfig_type> – Generates vibration on a Keyfob devi e
................................................................................................................................................ 138
3.2.8.2 “IOBOX command index .............................................................................................................. 139
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 5 of 271

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
3.2.8.2.1 IEEE.IOBox<ib_div_index>.OUT<oindex>=< onfig_type> – Configures outputs of I/O-BOX 139
3.2.8.2.2 IEEE.IOBox<ib_div_index>.power=<power_mode> – Changes the operation mode of I/O-BOX
................................................................................................................................................ 139
3.2.8.2.3 IEEE.IOBox<ib_div_index>.bat.level - Gets battery harge state .......................................... 140
3.2.9 “BT” ommand type ....................................................................................................141
3.2.9.1 “Audio command index ................................................................................................................ 141
3.2.9.1.1 BT.Audio.Bound - Pairs Bluetooth audio devi es ...................................................................141
3.2.9.1.2 BT.Audio.Conne t - Pla es both Bluetooth devi es in the onne tion mode ........................141
3.2.9.1.3 BT.Audio.Dis onne t - Closes a urrently open audio onne tion .......................................142
3.2.10 Set or query devi e onfiguration settings ............................................................... 143
3.2.10.1 DEVICE parameters .................................................................................................................. 144
3.2.10.2 DEVICE.NAME ........................................................................................................................... 144
3.2.10.3 DEVICE.CMD.PFAL.EN ............................................................................................................ 144
3.2.10.4 DEVICE.COMM.SERIAL ........................................................................................................... 145
3.2.10.5 DEVICE.COMM.CSD ................................................................................................................. 147
3.2.10.6 DEVICE.COMM.TCP.CLIENT ................................................................................................... 148
3.2.10.7 DEVICE.IGNTIMEOUT ............................................................................................................... 149
3.2.10.8 DEVICE.BAT.MODE ................................................................................................................... 150
3.2.10.9 DEVICE.GPS.STARTUP ............................................................................................................ 151
3.2.10.10 DEVICE.GPS.AUTOCORRECT ............................................................................................... 151
3.2.10.11 DEVICE.GPS.CFG ................................................................................................................... 152
3.2.10.12 DEVICE.GPS.TIMEOUT ........................................................................................................... 152
3.2.10.13 DEVICE.GSM.STARTUP .......................................................................................................... 153
3.2.10.14 DEVICE.IEEE.STARTUP .......................................................................................................... 153
3.2.10.15 DEVICE.BT.STARTUP ............................................................................................................. 154
3.2.10.16 DEVICE.BT.LOCALNAME ........................................................................................................ 154
3.2.10.17 DEVICE.BT.AUDIOGW ............................................................................................................ 154
3.2.10.18 DEVICE.PFAL.SEND.FORMAT ............................................................................................... 155
3.2.11 DISP Parameter ....................................................................................................... 157
3.2.11.1 DISP.VIEW<index> ..................................................................................................................... 157
3.2.11.2 DISP.MENU<index> ................................................................................................................... 158
3.2.11.3 DISP.PHONE<index> ................................................................................................................. 160
3.2.11.4 DISP.COLOR<id> ....................................................................................................................... 160
3.2.11.5 DISP.FONT ................................................................................................................................. 161
3.2.11.6 DISP.MESSAGE<index> ............................................................................................................ 161
3.2.11.7 DISP.SAVER .............................................................................................................................. 161
3.2.11.8 DISP.TZ ...................................................................................................................................... 162
3.2.12 IEEE Parameter ........................................................................................................163
3.2.12.1 IEEE.PANID ................................................................................................................................ 163
3.2.12.2 IEEE.KEYFOB<cnf_kf_div_index> ............................................................................................. 163
3.2.12.3 IEEE.IOBOX<cnf_ib_div_index> ................................................................................................ 164
3.2.13 REPLACE parameter .............................................................................................. 166
3.2.13.1 REPLACE<index> ...................................................................................................................... 166
3.2.14 Optional Settings ...................................................................................................... 168
3.2.14.1 STORAGE<id> ........................................................................................................................... 168
3.2.14.2 SAVE.LASTVALID ...................................................................................................................... 168
3.2.14.3 USERTXT<text> ......................................................................................................................... 168
3.2.14.4 MACRO<index> .......................................................................................................................... 169
3.2.15 IO parameter ........................................................................................................... 170
3.2.15.1 IO.BEEP.ENABLE ...................................................................................................................... 170
3.2.16 MOTION parameter .................................................................................................171
3.2.16.1 MOTION.FILTER ........................................................................................................................ 171
3.2.17 ALIAS parameter ......................................................................................................172
3.2.17.1 ALIAS.<type> .............................................................................................................................. 172
3.2.18 DBG parameter ........................................................................................................ 172
3.2.18.1 DBG.EN ..................................................................................................................................... 172
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 6 of 271

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
3.2.19 PROT parameters .................................................................................................... 174
3.2.19.1 PROT.<message_id> ................................................................................................................ 174
3.2.19.2 PROT.START.BIN ..................................................................................................................... 175
3.2.20 GSM parameters ...................................................................................................... 176
3.2.20.1 GSM.PIN ..................................................................................................................................... 176
3.2.20.2 GSM.CALLID.EN ....................................................................................................................... 176
3.2.20.3 GSM.CALLTONE.ENABLE ........................................................................................................ 177
3.2.20.4 GSM.OPLOST.RESTART ......................................................................................................... 177
3.2.20.5 GSM.OPERATOR.BLACKLIST ................................................................................................. 178
3.2.20.6 GSM.OPERATOR.SELECTION ................................................................................................ 178
3.2.20.7 GSM.SMS.RESPONSE .............................................................................................................. 179
3.2.20.8 GSM.RINGTONE ........................................................................................................................ 180
3.2.20.9 GSM.PROFILE.AUDIO<prof_index> .......................................................................................... 180
3.2.20.10 GSM.PROFILE.CURRENTAUDIO ........................................................................................... 182
3.2.21 GPRS parameters ................................................................................................... 183
3.2.21.1 GPRS.APN ................................................................................................................................ 183
3.2.21.2 GPRS.AUTOSTART .................................................................................................................. 183
3.2.21.3 GPRS.QOSMIN ......................................................................................................................... 184
3.2.21.4 GPRS.QOS ................................................................................................................................ 186
3.2.21.5 GPRS.DIAL ................................................................................................................................ 188
3.2.21.6 GPRS.TIMEOUT ........................................................................................................................ 188
3.2.22 PPP parameters ....................................................................................................... 189
3.2.22.1 PPP.USERNAME ...................................................................................................................... 189
3.2.22.2 PPP.PASSWORD ...................................................................................................................... 189
3.2.22.3 PPP.AUTOPING ........................................................................................................................ 189
3.2.22.4 PPP.AUTH ................................................................................................................................. 190
3.2.23 TCP parameters ....................................................................................................... 191
3.2.23.1 TCP.CLIENT.CONNECT ............................................................................................................ 191
3.2.23.2 TCP.CLIENT.ALTERNATIVE ..................................................................................................... 192
3.2.23.3 TCP.CLIENT.PING .................................................................................................................... 193
3.2.23.4 TCP.CLIENT.TIMEOUT ............................................................................................................. 193
3.2.23.5 TCP.CLIENT.DNS.TIMEOUT .................................................................................................... 194
3.2.23.6 TCP.CLIENT.LOGIN .................................................................................................................. 194
3.2.23.7 TCP.STORAGE ......................................................................................................................... 195
3.2.23.8 TCP.CLIENT.SENDMODE ......................................................................................................... 195
3.2.23.9 TCP.SMTP.CONNECT ............................................................................................................... 196
3.2.23.10 TCP.SMTP.LOGIN .................................................................................................................... 196
3.2.23.11 TCP.SMTP.FROM .................................................................................................................... 197
3.2.24 GF parameter (Geofen es) ...................................................................................... 198
3.2.24.1 How to do Geofencing with the MAMBOII ................................................................................. 198
3.2.24.1.1 Determine the Zone’s Grid Coordinates ................................................................................ 198
3.2.24.2 Set up the Geofencing zones and areas .....................................................................................199
3.2.24.3 GF.CONFIG ............................................................................................................................... 200
3.2.24.4 GF.AREA<ID> ........................................................................................................................... 201
3.2.24.5 GF<id> ....................................................................................................................................... 201
3.2.25 AL<index> parameter (Alarm onfiguration) ............................................................ 206
3.2.25.1 AL<n>= <conditions>:<actions> -Set alarm configuration .......................................................... 207
3.2.25.1.1 Supported System Events and States ................................................................................... 212
3.2.25.1.1.1 Comparators used within Events/States ........................................................................ 212
3.2.25.1.1.2 Sys (System states and events) ...................................................................................... 213
3.2.25.1.1.2.1 Sys.eSerialData (SerialData states and events) .............................................................................213
3.2.25.1.1.2.2 Sys.Device (Device states and events) ..........................................................................................213
3.2.25.1.1.2.3 Sys.Timer (TIMER states and events) ............................................................................................214
3.2.25.1.1.2.4 Sys.Trigger (TRIGGER states and events) ....................................................................................214
3.2.25.1.1.2.5 Sys.Counter (COUNTER events and states) ..................................................................................215
3.2.25.1.1.2.6 Sys.BT (BLUETOOTH states and events) ......................................................................................216
3.2.25.1.1.2.7 BT.Audio (BLUETOOTH Audio states and events) ........................................................................216
3.2.25.1.1.2.8 Sys.GPS (GPS states and events) .................................................................................................216
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 7 of 271

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
3.2.25.1.1.2.9 Sys.GSM (GSM states and events) ................................................................................................217
3.2.25.1.1.2.10 Sys.Power (POWER states and events) ......................................................................................217
3.2.25.1.1.2.11 Sys.Bat (BATTERY states and events) ........................................................................................218
3.2.25.1.1.2.12 Sys.UserEvent (UserEvent states and events) .............................................................................218
3.2.25.1.1.3 DISPLAY (DISPLAY states and events) ......................................................................... 219
3.2.25.1.1.3.1 DISPLAY.DIALOG (DIALOG states and events) ............................................................................219
3.2.25.1.1.4 IO (IO states and events) ................................................................................................ 220
3.2.25.1.1.4.1 IO.Motion (Motion states and events) .............................................................................................220
3.2.25.1.1.4.2 IO.BTN (Button states and events) .................................................................................................220
3.2.25.1.1.5 GPS (GPS states and events) .........................................................................................221
3.2.25.1.1.5.1 GPS.Nav (Navigation states and events) .......................................................................................221
3.2.25.1.1.5.2 GPS.Time (GPS Time states and events) ......................................................................................222
3.2.25.1.1.5.3 GPS.History (History states and events) ........................................................................................223
3.2.25.1.1.5.4 GPS.Geofence (Geofence states and events) ...............................................................................224
3.2.25.1.1.5.5 GPS.Area (Area states and events) ................................................................................................225
3.2.25.1.1.6 GSM (GSM states and events) ....................................................................................... 226
3.2.25.1.1.6.1 GSM (GSM Operator states and events) ........................................................................................226
3.2.25.1.1.6.2 GSM.eCellChange (Cell states and events) ...................................................................................226
3.2.25.1.1.6.3 GSM.VoiceCall (Voice Call states and events) ...............................................................................227
3.2.25.1.1.6.4 GSM.SMS (SMS states and events) ...............................................................................................228
3.2.25.1.1.6.5 GSM.DataCall (Data Call states and events) .................................................................................229
3.2.25.1.1.6.6 GSM.GPRS (GPRS states and events) ..........................................................................................230
3.2.25.1.1.7 TCP (TCP states and events) ......................................................................................... 231
3.2.25.1.1.7.1 TCP.Client (TCP Client states and events) ....................................................................................231
3.2.25.1.1.7.2 TCP.SMTP (SMTP states and events) ...........................................................................................231
3.2.25.1.1.8 IEEE.KEYFOB (states and events) ................................................................................. 232
3.2.25.1.1.8.1 IEEE.KEYFOB<index>.State (KEYFOB states and events) .......................................................... 232
3.2.25.1.1.9 IEEE.IOBOX (states and events) .................................................................................... 232
3.2.25.1.1.9.1 IEEE.IOBOX<index>.State (IOBOX states and events) .................................................................232
3.2.25.1.1.9.2 IEEE.IOBOX<index>.IN (Input states and events) .........................................................................233
3.2.25.1.1.9.3 IEEE.IOBOX<index>.ANA (Analogue Input states and events) .....................................................233
4 HOW TO TEST THE FALCOM MAMBOII USING FIRMWARE 2.4.0 AND LATER .... 234
4.1 How to test the MAM OII-EVAL-KIT ............................................................................234
4.2 What kind of rules should be considered to prepare your applications with
MAM OII: ....................................................................................................................234
4.3 Test your MAM OII by creating a simple configuration ............................................235
4.3.1 Load the onfiguration into the MAMBOII devi e ......................................................236
4.3.2 Run the test ............................................................................................................... 237
4.3.3 How to onne t an I/O-BOX devi e to the MAMBOII .................................................238
4.3.4 How to onne t a Bluetooth audio headset to the MAMBOII ....................................238
4.4 TCP server communication ..........................................................................................240
4.4.1 Getting started with basis onfiguration (required for TCP/Internet appli ations, only)
.................................................................................................................................240
4.5 Using the MAM OII device as real-time navigation system ..................................... 241
5 HOW TO SEND SMS MESSAGE TO THE MAMBOII DEVICE ......................... 242
6 APPENDIX .......................................................................................... 243
6.1 How to update a new firmware into the MAM OII ......................................................243
6.2 Supported dynamic entries .......................................................................................... 243
6.3 Supported protocols ..................................................................................................... 245
6.4 Supported character sets ............................................................................................. 246
6.4.1 GSM alphabet tables and UCS2 hara ter values .....................................................247
6.5 NMEA messages transmitted/selected by/on MAM OII device ................................251
6.5.1 Des ription of NMEA output messages .....................................................................251
6.5.1.1 $GPGGA message ....................................................................................................................... 252
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 8 of 271

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
6.5.1.2 $GPRMC message ....................................................................................................................... 252
6.5.1.3 $GPGSV message ........................................................................................................................ 253
6.5.1.4 $GPGSA message ........................................................................................................................ 253
6.5.1.5 $GPVTG message ........................................................................................................................ 254
6.5.1.6 $GPGLL message ........................................................................................................................ 254
6.5.1.7 $GPIOP message ......................................................................................................................... 255
6.5.1.8 $GPGSM message ....................................................................................................................... 255
6.5.1.9 $GPAREA message ..................................................................................................................... 256
6.5.1.10 BIN protocol and its format ........................................................................................................ 256
6.6 How to convert the coordinates ...................................................................................257
6.7 Explanation of the History inary Data .......................................................................257
6.7.1 Maximum values & the time the history spa e will be used up ..................................257
6.8 MAM OII communication modes and their functionality ..........................................259
6.9 Default settings of the firmware version 2.4.0 ............................................................260
6.10 uttons and LEDs designation of the Keyfob corresponding to the firmware
version 2.4.0 ...............................................................................................................262
6.10.1 Pin designations for the 16-pin MOLEX and 8-pin onne tor of the I/O-BOX
orresponding to the firmware version 2.4.0 and later ...........................................263
6.11 MAM OII Configuration Examples ............................................................................ 264
6.11.1 Basi Configuration Examples ..................................................................................264
6.11.1.1 Alarm Syntax ............................................................................................................................... 264
6.11.1.2 History ......................................................................................................................................... 264
6.11.1.2.1 History entries based on the distan e .................................................................................. 264
6.11.1.3 Voice calls ................................................................................................................................... 264
6.11.1.3.1 A ept in oming voi e alls .................................................................................................. 264
6.11.1.3.2 Refuse voi e alls after the se ond ring ................................................................................264
6.11.1.4 CSD (Data calls) ......................................................................................................................... 265
6.11.1.4.1 A ept in oming data alls .................................................................................................... 265
6.11.1.4.2 Refuse data alls after the se ond ring ................................................................................. 265
6.11.1.5 SMS ............................................................................................................................................ 265
6.11.1.5.1 SMS responses for self defined ommands .......................................................................... 265
6.11.2 Advan ed Examples .................................................................................................265
6.11.3 Navigation speed ......................................................................................................265
6.11.3.1.1 Che k the over speed of the devi e ea h 5 se onds ............................................................ 265
6.11.3.2 Trigger ......................................................................................................................................... 265
6.11.3.2.1 Save and load important trigger states .................................................................................. 265
6.11.3.3 Counter ....................................................................................................................................... 266
6.11.3.3.1 Limit the number of automati ally sent SMS ......................................................................... 266
6.11.3.4 Actions based on distance ......................................................................................................... 266
6.11.3.4.1 Report a position ea h 1000 metres via SMS ....................................................................... 266
6.11.3.5 History for combined conditions .................................................................................................. 266
6.11.3.5.1 Time based history entries .................................................................................................... 267
6.11.3.5.2 Time and distan e based history entries ............................................................................... 267
6.11.3.6 TCP storage ................................................................................................................................ 267
6.11.3.6.1 Send spe ial devi e information to server periodi ally .........................................................267
6.11.4 Spe ial onsideration when using firmware features ............................................... 268
6.11.4.1 Using commands inside alarms .................................................................................................. 268
6.11.4.2 SMS send ................................................................................................................................... 269
6.11.4.3 CSD send .................................................................................................................................... 269
6.11.4.4 Storing information to non volatile memory .................................................................................269
6.12 ISP, GPRS configuration parameters of German service providers ...................... 269
6.13 Used abbreviations ......................................................................................................270
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 9 of 271

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
Version history:
Version Author Changes Change date
1.0.0 F. Beqiri - Initial version based on the firmware revision 2.4.0 29/05/2007
1.0.1 F. Beqiri - New firmware revision 2.4.3
- Corre ted the range of ring tones from 0..7 to ..32 and volume from 0..7 to 0..4 –
see hapter GSM.Voi eCall.Ringtone.
--Corre ted maximal speaker volume – see
GSM.Voi eCall.Volume.Speaker=<n_gain>,<volume>,<sidetone>.
- Added new ommand IO.Vibration=< onfig_type>.
- Added new on figuration parameter DISP.TZ - Converts from time-zone name to
lo al time.
13/09/2007
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 10 of 271