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

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
Cautions
Information furnished herein by FALCOM is accurate and reliable. Howe er, no
responsibility is assumed for its use.
Please, read carefully the safety precautions.
If you ha e any technical questions regarding this document or the product
described in it, please contact your endor.
General information about FALCOM and its range of products are a ailable at
the following Internet address: http://www.fal om.de/
Trademarks
Some mentioned products are registered trademarks of their respecti e
companies.
Copyright
This document is copyrighted by FALCOM WIRELESS COMMUNICATIONS GmbH with
all rights reser ed. No part of this documentation may be produced in any form
without the prior written permission of FALCOM WIRELESS COMMUNICATIONS GmbH.
FALCOM WIRELESS COMMUNICATIONS GmbH.
No patent liability is assumed with respect to the use of the information contained
herein.
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 11 of 271

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
1 INTRODUCTION
THIS IS PRELIMINARY DOCUMENTATION AND IS SUBJECT TO CHANGE.
This document represents the description of the firmware ersion 2.4.0 and later and
the supported Configuration Command Set for the FALCOM MAMBOII as well.
FALCOM firmware has been de eloped to accommodate a wide ariety of
applications, but it is often necessary to change firmware parameters in order to
customize de ices for customer applications.
Before using the MAMBOII or upgrading to a new firmware ersion, please, read the
latest product information, see related documents item [ ].
Table of Contents (TOC) or PDF bookmarks above will help you locate the chapter/section you
need.
Square brackets denote optional settings that may be specified or not.
1.1 About this document
Due to the large size of this document and its huge information, it has been separated
into 6 chapters. Each chapter includes a brief description to help you find the needed
information quickly. Throughout the document uses the hypertext links (shown in blue
text) enabling to na igate the chapters/sections or set parameter description.
The document is separated into the following chapters:
•Chapter 2 “General presents the firmware’s basic benefits, lists key features
and describes the principle of its operation. iguratively are represented the
general system requirements for each access method. It also provides a brief
overview of the TCP/IP protocol.
•Chapter 3 „Command syntax, PFAL Commands and supported parameters– for FALCOM
M represents the structure of input commands which can be directly
transmitted to the MAMBOII unit via Bluetooth, TCP connection and SMS.
Commands are executed (as an action), when the set conditions are met. A
detailed description of the P AL commands and supported parameters is also
given. Default values and example commands are listed after each
command description. It also includes the steps for creation of applications,
how to specify the alarms on the MAMBOII device and the configuration
possibilities by using a range of events, states and actions. Each category of
events and states is described separately. The differences between Events
and States are also given. It also describes, how many possible combinations
can be made, what happens when raised events and states are called by an
application.
•Chapter 4, “How to test the Falcom MAMBOII using firmware 2.4. describes how to
transfer the input messages, how to test and evaluate the MAMBOII Unit. How
to load a simple configuration into the MAMBOII, how to connect a Keyfob /
I/O- OX / luetooth headset to the MAMBOII, how to set the LEDs when events
occur and how to configure the Buttons to release alarms/actions when
notifications are needed. It also describes how to communicate remotely
(online) with the MAMBOII device via a TCP-server.
•Chapter 5 „How to send SMS message to the MAMBOII device presents how SMS
messages can be sent to the MAMBOII device. More precisely, how to
configure the MAMBOII device via SMS.
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 12 of 271

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
•Chapter 6 “Appendix represents the supported character set, the default
setting of the released firmware, the supported output protocols (NMEA and
other messages) and alarm configuration examples etc.
1.1 Related documents
Some others PDF documents such as FCC appro al, application notes, Certificate of
Conformity R&TTE etc. are also a ailable on the Web at: http://www.fal om.de/ in the
published download area.
In addition to this document, the following files comprise the full set of FALCOM
MAMBOII product manuals:
NR PDF file name Description
[1] MAMBO_II_hardware_manual.pdf Contains information about the hardware features and te hni al
details.
[2] MAMBO_II_getting_started.pdf Contains an introdu tion how to get started with MAMBOII devi e,
how do the software and hardware operate, fa tory preloaded
onfiguration settings.
[3] MAMBO_II_software_update.pdf Contains information how to upgrade the MAMBOII devi e to a new
firmware version lo ally via Bluetooth.
[4] AppNotes_Transform_history_data.pdf Contains information of how to transform history data that are being
transmitted from MAMBOII via TCP onne tion.
[5] AppNote_Remote_update.pdf Contains information of how to upgrade the MAMBOII devi e to a
new firmware revision remotely via TCP.
These PDF files are viewable and printable from Adobe Reader. If you do not have the Adobe Reader
installed, you can download it from http://www.adobe.com .
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 13 of 271

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
2 GENERA
The MAMBOII operating with firmware ersion 2.4.0 and later (using eCos operating
system) offers a speedy de elopment of system solutions within the fields of:
•leet management with GPS-location
•vehicle security
•Web based client-server applications (built-in TCP-IP and PPP stack internet
capable protocols)
•Real-time navigation
•and many others …
2.1 Features of the Firmware
The internal operating firmware (using eCos operating system) of MAMBOII unit is a
fundamental component, which in combination with the excellent hardware
performance makes the MAMBOII de ice to be the best application where the
personal security and fleet management today are required. It is an application
designed to be deployed in the field of fleet management and specifically designed and
developed for personal tracking and security.
The firmware 2.4.x offers a range of benefits:
Advanced to work in different modes (GSM and GPRS/TCP, Bluetooth, WLAN
communications),
Allows full Internet access over GPRS,
Advantages in terms of cost and speed, with low costs option for Web- based client-
server applications (always on-line - pay only for the data you send or receive),
Remote configuration and communication over GSM and TCP, more specifically; SMS
message or TCP packet generation, voice & data calls,
Remote firmware upgrades (it is implemented, but it is not tested yet),
Supports up to four different power saving features (four different sleep modes),
Automatically switching between GSM and TCP working modes,
Automatically connecting/disconnecting to/from the remote services (GPRS network &
/TCP server),
Buffers all GPS positions* in case the TCP connection drops out,
Operator re-selection when the GSM cell offers no GPRS services
(GSM.OPERATOR.SELECTION parameter configuration-dependent).
Redirects commands and messages from one communication channel to another
one,
Tracks down the initialization/execution of firmware, monitors runtime errors from
different communication interfaces (Locally, GSM and TCP),
Locates vehicle position by GPS (collects information from vehicle and transfers it to
the control center both on demand and at regular intervals via SMS and TCP for
vehicle tracking and recovery)
Locates and tracks vehicles equipped with MAMBOII on-line using WebMap from
Internet,
Controls the speed of vehicle
In a short time interval individual or multiple units can be tracked at any time or
location,
Supports simple to complex alarm settings,
Supports vibration alert when receiving a call,
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 14 of 271

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
Supports up to 32 different beep tones,
Controls up to 6 IEEE devices (KeyFob & I/O-BOX) and handles all events that are
fired on such devices.
Provides GPS data for real-time navigation via Bluetooth wireless communication,
Designed to transfer a high-quality audio stream wirelessly (provides the Bluetooth Audio
Gateway Service to support the Bluetooth Headset and the Hands-Free-wirelessly receiving
and placing GSM voice calls.
Flexible system configuration (up to 100 flexible and various alarms with logical AND
[&] or OR [?] conjunction possible),
Supports a wide range of states and events for a global set of your alarm system,
Supports a wide range of actions to be executed in case the events raise and states
change,
Alarms can be executed directly from the MAMBOII's display.
Supports detecting of the button changes in different interval of time,
Up to 20 TIMERs available - TIMERs properties and their configuration methods affect
the functionality to activate events handler and execute actions at regular interval,
Up to 20 TRIGGERs implemented to execute and start various actions to a particular
time,
Up to 20 COUNTER implemented to limit the number of actions executed
automatically,
Up to 20 MACROs enabling execution of up to 50 alarms/commands at once.
Up to 10 user predefined events intended for other alarm execution.
History function (records, stores GPS position data in the on-board FLASH memory
and replays vehicle activity, route verification),
Supports downloading of all or a part of the history stored data via TCP or Bluetooth,
Supports clearing of all history stored records,
Geo-fencing functionality, setup to 100 Geofencing zones within up to 32 areas with
inside/outside features (reporting when pre-defined geo-fence zones are entered/left,
a specific route is deviated off or a country is left; territory management, route
verification, arrival/departure notification, prohibited locations, unauthorized
movement, and more).
*) The firmware contains a TCP buffer. Thus the GPS position data can be internally stored in
case the connection to the ser ices will be dropped out (e.g. bad GSM co erage). Once
the connection is re-established, the stored data will be sent directly to the used remote
ser er. Following a short o er iew, how many packets (data) can internally be buffered:
binary RMC: approx. 800 (packets)
RMC+GPIO: approx. 400 (packets)
GGA,GSA,GSV,RMC,GLL,VTG,GPIO,GSM: approx. 80 (packets)
All aforementioned feature e ents can be controlled and GPS position can be
recei ed by means of any GSM phone or any workstation, which has access to the
used remote ser er. You can easily perform configuration and feature changes either
ia Bluetooth connection or ia a TCP-connection.
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 15 of 271

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
2.2 The principle of firmware operation
The integration of the MAMBOII operating with firmware ersion 2.4.0 in the field
mentioned in chapter 2, page 14, requires the following elements:
1. MAMBOII Unit(s)
2. A SIM card for Voice and/or DATA and /or GPRS
3. GPRS settings (provided by your provider)
4. TCP settings (from the setup Web Server in your network)
5. Remote Server (the setup Server for Web applications)
6. User (Personal Computer connected to the remote Server)
The illustration below represents the interfaces that the MAMBOII uses to access the
Remote Ser er ia GPRS Network. In addition, it shows that TCP communication enables
the MAMBOII de ice to be monitored/tracked online from your PC ia the Internet
ser ices.
Figure : Interfa es that the firmware uses to a ess the Remote Server via GPRS Network
The principle of system operation is ery simple. Each object is equipped with a
MAMBOII de ice, which consists of:
•an integrated GPS-receiver with internal active antenna for reception of signals
from GPS satellite system,
•a GSM/GPRS-modem with internal antenna for transmission of these GPS data by
radio.
•A Bluetooth transceiver with internal antenna to enable wireless data
connectivity to a PC, PDA, Mobile phone etc. for sending/receiving the GPS data
and input commands.
•A Bluetooth Audio Gateway to enable wireless audio connectivity to a Bluetooth
headset.
The GPS recei er uses the satellites data to calculate the exact position of the ehicle
(object) fitted with MAMBOII unit. The GPS data recei ed from the MAMBOII unit can be
transferred through the GPRS network (IP-based) and the Internet to your remote ser er
for online purposes. A user-de eloped program installed on the remote ser er, can help
you to connect to the ehicles equipped with MAMBOII units.
For such purposes, at first the MAMBOII de ice must be locally configured (with the help
of any terminal program or ALCOM Workbench software – a developed program to
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 16 of 271

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
help you configure and evaluate ALCOM devices). All MAMBOII de ices are pre-
configured to work with the default settings. So all default settings must be changed
and adapted to your application conditions (including: GPRS settings of your provider,
the remote server settings and the PIN of the used SIM card - see chapter 3.2.2.1 in this
manual). When the configuration of the MAMBOII is done, it tries to register itself into the
GSM network. Once it is successfully registered into the GSM network, it can start
automatically to establish a GPRS connection (depending on the GPRS configuration –
see chapter 3.2.21 ) and by means of TCP settings (see chapter 3.2.23) a TCP
connection to the remote ser er.
Once the MAMBOII is attached to the GPRS network o er the Basis Station, temporary a
dynamic IP-address will be allocated by the MAMBOII de ice from the GPRS network.
With the help of the IP-address that constantly changes, the GPRS network enables
MAMBOII de ice to perform a TCP connection to the used remote ser er (to the
specified IP address and Port number). By means of these IP addresses as object
identifiers, all MAMBOII de ice can be direct configured from the remote ser er.
Such online applications enable you tracking and monitoring in a short time se eral 100
ehicles (objects) equipped with a MAMBOII de ice.
Furthermore, the data transmitted from MAMBOII de ice is recei ed in real time. The
MAMBOII de ice can be programmed so that the ehicle location and additional
information will be recei ed not only ia a TCP ser er, but also ia SMS.
The operating firmware 2.4.0 and later offers a rich set of e ents, states and commands
that you can use to customize high-performance web solutions. The solution
architecture aries with the type of application you decide to create.
Depending on the configuration settings that is loaded on the de ice, the MAMBOII is
capable of using up to three different system solutions:
GSM This system solution supports SMS, Voice call and Data call. Using only these
features you are able a speedy development of communication services,
which do not require GPRS and TCP configurations. The configuration of both
services (GPRS/TCP) can be in such case disabled. To control your MAMBOII
device you can send via SMS all commands given in this document. Also via
SMS you will be notified when an alarm is triggered in the MAMBOII device. To
use SMS services, users need a subscription to a mobile network that supports
it, and the use of SMS must be enabled for that user. The user needs to have
a phone number for the MAMBOII device or a SMS server to send a short
message to, or receive a message from. On the SMS server side, you can
install several solutions to enable receiving of SMS messages or forwarding
them to other systems. inally, the user also needs a mobile phone that
supports SMS and knowledge of how to send or read a short message
(command or responses).
GPRS/Internet The MAMBOII device supports TCP/IP application, an Internet based
application that allows access via the World Wide Web (www). Since the
Internet is just a medium for computers to "talk" to each other, it enables you
to track, message or monitor the MAMBOII units at almost any PC in any
location around the world (see figure above). The presence of the remote
server is an essential prerequisite, which is needed to log in the MAMBOII units
to the used remote server. A computer (PC client) connected to the Internet
with the pre-installed standard web browser is also necessary (see chapter
2.3, page 18). To be able to monitor and control such systems solutions both
GSM and GPRS/TCP configuration settings have to be done. MAMBOII is able
to contact you via E-mail – in this case you have to configure SMTP services,
too.
Real-Time Navigation MAMBOII is also a high-capacity navigation system, which
connects your Bluetooth™-enabled device with the performance of an
intelligent and dynamic destination guidance. The Bluetooth feature for
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 17 of 271

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
MAMBOII supports a communication technology that allows devices within a
10-meter proximity to communicate with each other without physical cables.
MAMBOII in communication with your installed GPS Mapping software on the
Bluetooth™-enabled device points you the way comfortably and reliably
from the current location A to your desired destination B. In this way you
always stay for longer distances on the optimal course, arrive your destination
point comfortable and ease.
2.3 Internet and intranet applications setup with MAMBOII
2.3.1 Internet based applications
To control and monitor the MAMBOII de ice, as well as to set and poll configuration
remotely from your client PC o er Internet, user de eloped programs must be
a ailable. A client PC requests a ser er PC to perform actions. Since the Internet is just a
medium for computers to "talk" to each other, it enables you to perform applications. If
such an Internet solution is required to perform your applications, you can write a simple
chat program in a programming language to exchange text messages between a
client and ser er. You might be familiar with such programs as they are often used in
on-line chat rooms. You will write two programs (one running on the client PC, the other
on the ser er PC) resulting in a teletype-like application; you and a friend can type
messages to each other o er the Internet. Understanding how these two programs
work might help you in de eloping programs to control hardware de ices o er the
Internet. The FALCOM Company does not pro ide for users any source code for such
applications.
Figure 2: Internet appli ations setup with MAMBOII
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 18 of 271

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
2.3.2 Intranet applications
Figure below represents the client PC and ser er PC communication. Howe er, to
exchange text messages (TCP packets) between ser er and MAMBOII de ice a
program de eloped by the user must be a ailable and already installed on the remote
ser er. The user sends a request to the remote ser er ia the client PC. The user-
de eloped program installed on the remote ser er recei es the message from the
client PC and automatically sends it in the correct format to the connected MAMBOII
de ice. The MAMBOII de ice responses the remote ser er. The remote ser er returns the
requested information back to the client PC with help of the installed program. The
FALCOM does not pro ide any source code for such programs.
Figure 3: Intranet appli ations setup with MAMBOII
2.4 TCP/IP Overview
The MAMBOII represents o er TCP/IP stack contained in the firmware 2.4.0 a kind of
serial communication.
TCP (Transmission Control Protocol) is the most widely used transport protocol for non-
real-time Internet applications like www, e-mail. It pro ides a connection-oriented end-
to-end ser ice ensuring the reliable transfer of data.
As with all other communication protocols, TCP/IP is composed of following layers:
IP is responsible for moving packet of data from node to node. IP forwards
each packet based on a four-byte destination address (the IP number). IP
operates on gateway machines that move data from department to
organization to region and then around the world.
TCP is responsible for verifying the correct delivery of data from client to server.
Data can be lost in the intermediate network. TCP adds support to detect
errors or lost data and to trigger retransmission until the data is correctly
and completely received.
PORT is a name given to the package of subroutines that provide access to
TCP/IP on most system.
2.5 IEEE 802.15.4 Overview
IEEE 802.14.4 is an industry standard set of specifications for WLANs de eloped by the
Institute of Electrical and Electronics Engineers (IEEE). IEEE 802.14.4 defines the physical
layer and media access control (MAC) sub-layer for wireless communications.
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 19 of 271

CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
VERSION 1.0.0
3 COMMAND SYNTAX, PFA COMMANDS AND
SUPPORTED PARAMETERS– FOR FA COM
MAMBOII
3.1 PFA Command syntax and response message structure
3.1.1 Command syntax of PFA commands
The input messages pro ided in the next section can be sent to the target de ice
locally ia Bluetooth connection with the help of any terminal program, remotely ia
SMS or remotely ia a TCP connection with the help of a remote ser er.
Each PFAL message containing the command <cmd> is distinguished as alone caption.
Within a chapter you will find a table di ided in two rows.
•The first row indicates the Command syntax, which could not be sent to the
device in that form. Within the Command syntax there are invalid characters
such as “< , “> and assigned name, which are used to show the Command
syntax, only.
•The second row shows the example(s) how the message(s) can be sent to the
MAMBOII device. The set parameters in those examples depend on the user
conditions. All examples can be modified and adapted to the user
requirements.
The PFAL messages ha e the following formats, and in one of these formats the
MAMBOII de ice will accept the user sent messages:
Header Command Parameter Checksum End Sequence
$PFAL < md> <parameter> <*CKSUM> <CR><LF>
$PFAL < md> <parameter> none <CR><LF>
PFAL < md> <parameter> <*CKSUM> <CR><LF>
PFAL < md> <parameter> none <CR><LF>
Table : PFAL ommand syntaxes.
[$]*PFAL The [$]PFAL is message header.
<cmd> The <cmd> determines the command(s) to be specified/executed. To
specify/execute a <cmd> command, throughout the document are used
so-called <c_type> (type) and <c_index> (index) and <c_subindex>
(subindex). Other to say, a command type is sorted by an index, while the
command index may be limited by a subindex (only if the index supports
any subindex). The index changes according to the user-specified
command type, while the subindex changes according to the user-
specified command type and index. The command type, index and
subindex are separated by dots [“.” character]. The command index may
include a alue; in this case no subindex is supported. Also the subindex
may include a alue. According to this explanation, the impro ed syntax to
specify the <cmd> command is:
<c_type>.<c_index>.<c_subindex> or
<c_type>.<c_index>=<value or
<c_type>.<c_index>.<c_subindex>=<value>
Combining the <cmd> commands on the same input message line is now
allowed. If more then one <cmd> command is set on the same command
line, they should be separated by semi-colon “;”. The double quotes ha e
to be omitted when you enter the semi-colon. Note that, the maximal
This confidential document is a property of FALCOM and may not be copied or circulated without pre ious permission.
Page 20 of 271