How it Works
FALCOM
Loading...
MAMBOII
User Manual
271 pgs3.55 Mb0
Table of contents
Loading...

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: 13/09/2007; This document will be regularly updated.
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
Table of contents
1 INTRODUCTION ...................................................................................... 12
1.1 About this document .......................................................................................................12
1.1 Related documents ..........................................................................................................13
2 GENERAL ............................................................................................ 14
2.1 Features of the Firmware ................................................................................................14
2.2 The principle of firmware operation .............................................................................. 16
2.3 Internet and intranet applications setup with MAMBOII ..............................................18
2.3.1 Internet based applications ...........................................................................................18
2.3.2 Intranet applications ..................................................................................................... 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 commands .........................................................................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 command structure ......................................................................................23
3.2 PFAL Commands .............................................................................................................25
3.2.1 “Sys” command type .....................................................................................................31
3.2.1.1 “Security” command index .............................................................................................................. 31
3.2.1.1.1 Sys.Security.Lock,”password” – Sends a pasword to lock your system ................................... 31
3.2.1.1.2 Sys.Security.Unlock,”password” – Sends a pasword to unlock your system ........................... 31
3.2.1.1.3 Sys.Security.RemoveLock,”password” – Sends a password to remove locking 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 channel & continues 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.Device.Reset – Resets the system ................................................................................... 38
3.2.1.3.2 Sys.Device.Update – Set the system into the update mode .................................................... 38
3.2.1.3.3 Sys.Device.Shutdown – Shutdown the system ........................................................................ 39
3.2.1.3.4 Sys.Device.FactoryReset – Resets configuration to its default ................................................. 39
3.2.1.3.5 Sys.Device.Sleep=<type> – Puts the system into the sleep state ............................................ 39
3.2.1.3.6 Sys.Device.ClearAlarm – Clears existing alarms and restart the device ................................. 42
3.2.1.3.7 Sys.Device.ClearConfig – Clear existing configuration ............................................................. 42
3.2.1.3.8 Sys.Device.CfgUpdateMode – Prevents interferences 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 execution 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 previous permission.
Page 2 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
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 contents ................... 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> – Activates/deactivates 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 contents ...................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>.Increment=<inc_value> – Increments Counter’s value ............................53
3.2.1.6.3 Sys.Counter<index>.Decrement=<dec_value> – Subtracts 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 contents ...............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.Macro<index>– Activates configured Macros .................................................................... 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 specific application 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 current backup 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 chip ............................................................................. 62
3.2.1.13 “CPU” command index .................................................................................................................. 63
3.2.1.13.1 Sys.CPU.Reset – Resets the ARM7 controller and sets the device 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 specific view on the MAMBOII's screen ...................................... 65
3.2.1.15.2 Display.Dialog – Creates a full-screen dialog box ................................................................... 66
3.2.1.15.3 Display.Alarm – Displays a specific alarm image on the screen ............................................ 67
3.2.2 “CNF” command 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” command type .......................................................................................................82
3.2.3.1 “Beep” command index ................................................................................................................... 82
3.2.3.1.1 IO.Beep<index>=<config_type> – Generates beep tones ........................................................ 82
This confidential document is a property of FALCOM and may not be copied or circulated without previous permission.
Page 3 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
3.2.3.2 “Vibration” command index ............................................................................................................. 83
3.2.3.2.1 IO.Vibration=<config_type> – Manages device vibrations ........................................................ 83
3.2.4 “GPS” command type ...................................................................................................84
3.2.4.1 “Nav” command index ..................................................................................................................... 84
3.2.4.1.1 GPS.Nav.Position<buffer_index> – Gets the travelled distance 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.Distance – Gets the current travelled distance from a start point ..............................86
3.2.4.1.6 GPS.Nav.Distance=<value> – Sets/resets the distance 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>– Selects the number of records
to be downloaded from the history memory ............................................................................ 91
3.2.4.2.5 GPS.History.Read – Downloads the selected history records 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 selected history records at once ...................................... 96
3.2.4.3 “Geofence” command index ............................................................................................................ 98
3.2.4.3.1 GPS.Geofence.Park.Set –Activates a park area .......................................................................98
3.2.4.3.2 GPS.Geofence.Park.Remove– Disables the activated park area ............................................. 98
3.2.4.3.3 GPS.Geofence.GeoState,<geo_id> – Gets the state of a Geofence ...................................... 100
3.2.4.3.4 GPS.Geofence.AreaState,<area_id>– Gets the state of an Area ........................................... 100
3.2.5 “GSM” command 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 card .......................................... 101
3.2.5.1.2 GSM.PUK=<”puk”>,<”pin”> - Enters the PUK and PIN numbers of the used SIM card ..........101
3.2.5.1.3 GSM.IMEI – Gets the serial identification number of the device ............................................. 101
3.2.5.1.4 GSM.SIMID – Get the ID of SIM Card ..................................................................................... 102
3.2.5.1.5 GSM.OwnNumber– Gets the current voice call number of the device .................................... 102
3.2.5.1.6 GSM.Balance– Gets the account information of the used prepaid SIM card .......................... 102
3.2.5.2 “Voice Call” command index ......................................................................................................... 103
3.2.5.2.1 GSM.VoiceCall.Dial,<“p_number“> - Makes a GSM voice call .............................................. 103
3.2.5.2.2 GSM.VoiceCall.Accept - Accepts an incoming voice call ....................................................... 103
3.2.5.2.3 GSM.VoiceCall.Hangup – Hangs up an active voice call ....................................................... 103
3.2.5.2.4 GSM.VoiceCall.Audio.Profile=<audio_index> – Sets the active audio profile .........................104
3.2.5.2.5 GSM.VoiceCall.Ringtone=<type>,<volume> - Sets the ring tone settings .............................. 104
3.2.5.2.6 GSM.VoiceCall.Volume.Speaker=<n_gain>,<volume>,<sidetone> - Sets or gets the
loudspeaker settings .............................................................................................................. 105
3.2.5.2.7 GSM.VoiceCall.Volume.Microphone=<gain>,<n_gain> - Sets or gets the microphone settings
................................................................................................................................................ 105
3.2.5.3 “SMS” command index ................................................................................................................. 106
3.2.5.3.1 GSM.SMS.Send,<”p_number“>,<protocols>,<”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,<protocols>,<”text”> - Transfers messages via an established data call 108
3.2.5.4.2 GSM.DataCall.Accept - Accepts an incoming Data call ......................................................... 108
3.2.5.4.3 GSM.DataCall.Hangup – Hangs up an active voice call ....................................................... 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 previous permission.
Page 4 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
3.2.5.5.1 GSM.GPRS.Connect – Performs a GPRS attach ................................................................... 109
3.2.5.5.2 GSM.GPRS.Disconnect – Performs a GPRS detach ..............................................................109
3.2.5.5.3 GSM.GPRS.State – Gets the GPRS status ............................................................................ 110
3.2.5.5.4 GSM.GPRS.Traffic=<complete>,<incoming>,<outgoing> – Set or read a GPRS traffic counter
................................................................................................................................................ 110
3.2.6 “TCP” command type ................................................................................................. 111
3.2.6.1 “TCP” command index .................................................................................................................. 111
3.2.6.1.1 TCP.Client.Connect - Performs a TCP connection to the server ............................................ 111
3.2.6.1.2 TCP.Client.Send,<protocols>,<”text”> - Transfers a TCP packet to the connected server .....112
3.2.6.1.3 TCP.Client.State – Gets the status of the TCP connection ..................................................... 112
3.2.6.1.4 TCP.Client.Disconnect - Disconnects from TCP server .......................................................... 113
3.2.6.2 “STORAGE” command index ........................................................................................................ 114
3.2.6.2.1 TCP.Storage.Dispatch - Moves TCP storage contents to outgoing TCP buffer ...................... 114
3.2.6.2.2 TCP.Storage.Clear – Clears TCP Storage .............................................................................. 114
3.2.6.2.3 TCP.Storage.AddProtocol,<protocols>,<”text”> - Addes data to the TCP storage ................. 115
3.2.6.2.4 TCP.Storage.AddRecord,<protocol>,<”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>,<protocols>,<”text”> - Send an Email to the connected
remote server ......................................................................................................................... 118
3.2.7 “MSG” command type ................................................................................................ 120
3.2.7.1 “Send” command index ................................................................................................................. 120
3.2.7.1.1 MSG.Send.Serial,<protocols>,<”text”> - Redirects command responses to the serial interface
(Bluetooth) .............................................................................................................................. 120
3.2.7.1.2 MSG.Send.RawSerial,<protocols>,<”text”> - Redirects command responses to the serial
interface in unformatted data structure ...................................................................................121
3.2.7.1.3 MSG.Send.CSD,<protocols>,<”text”> - Redirects command responses to CSD channel. ..... 122
3.2.7.1.4 MSG.Send.TCP,<protocols>,<”text”> - Redirects command responses to TCP channel ....... 123
3.2.7.2 “Mode” command index ................................................................................................................ 125
3.2.7.2.1 MSG.Mode.Serial=<out_sys_messages>,<mode>- Defines the communication mode on serial
channel .................................................................................................................................. 125
3.2.7.2.2 MSG.Mode.CSD=<out_sys_messages>,<mode> - Defines the communication mode on CSD
channel ................................................................................................................................... 127
3.2.7.2.3 MSG.Mode.TCP=<out_sys_messages>,<mode> - Defines the communication mode on TCP
channel ................................................................................................................................... 128
3.2.7.3 “Version” command index ............................................................................................................. 130
3.2.7.3.1 MSG.Version.Complete - Gets all versions information of the target device .......................... 130
3.2.7.3.2 MSG.Version.Modules - Gets the modules versions of the target device ............................... 130
3.2.7.3.3 MSG.Version.InternalComm - Gets the internal communication version of the target device 130
3.2.7.3.4 MSG.Version.HardwareRev - Gets the hardware revision of the target device ...................... 131
3.2.7.3.5 MSG.Version.Hardware - Gets the hardware version of the target device ............................. 131
3.2.7.3.6 MSG.Version.Software - Gets the software version of the target device ................................ 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 device sends to the server .............. 132
3.2.7.4.2 MSG.Info.Protocol,<protocols>,<”text”> - Transmits protocol reports to the sender ............... 132
3.2.7.4.3 MSG.Info.Time – Gets the current system time ...................................................................... 133
3.2.7.4.4 MSG.Info.Alarm,<alarm_index> - Shows the configuration of an alarm ................................. 134
3.2.7.5 “Channel” command index ............................................................................................................ 135
3.2.7.5.1 MSG.Channel.SerialGSM – Channels all input commands transmitted via serial port directly to
GSM engine ........................................................................................................................... 135
3.2.8 “IEEE” command type ................................................................................................ 136
3.2.8.1 “Keyfob” command index .............................................................................................................. 136
3.2.8.1.1 IEEE.Keyfob<kf_div_index>.LED<lindex>=<config_type> – Configures LEDs on a Keyfob
device ..................................................................................................................................... 136
3.2.8.1.2 IEEE.Keyfob<kf_div_index>.Beep=<config_type> – Generates beep tones on a Keyfob device
................................................................................................................................................ 137
3.2.8.1.3 IEEE.Keyfob<kf_div_index>.Vibration=<config_type> – Generates vibration on a Keyfob device
................................................................................................................................................ 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 previous permission.
Page 5 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
3.2.8.2.1 IEEE.IOBox<ib_div_index>.OUT<oindex>=<config_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 charge state .......................................... 140
3.2.9 “BT” command type ....................................................................................................141
3.2.9.1 “Audio” command index ................................................................................................................ 141
3.2.9.1.1 BT.Audio.Bound - Pairs Bluetooth audio devices ...................................................................141
3.2.9.1.2 BT.Audio.Connect - Places both Bluetooth devices in the connection mode ........................141
3.2.9.1.3 BT.Audio.Disconnect - Closes a currently open audio connection .......................................142
3.2.10 Set or query device configuration 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 previous permission.
Page 6 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
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 (Geofences) ...................................................................................... 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 configuration) ............................................................ 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 previous permission.
Page 7 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
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 MAMBOII-EVAL-KIT ............................................................................234
4.2 What kind of rules should be considered to prepare your applications with
MAMBOII: ....................................................................................................................234
4.3 Test your MAMBOII by creating a simple configuration ............................................235
4.3.1 Load the configuration into the MAMBOII device ......................................................236
4.3.2 Run the test ............................................................................................................... 237
4.3.3 How to connect an I/O-BOX device to the MAMBOII .................................................238
4.3.4 How to connect a Bluetooth audio headset to the MAMBOII .................................... 238
4.4 TCP server communication ..........................................................................................240
4.4.1 Getting started with basis configuration (required for TCP/Internet applications, only)
.................................................................................................................................240
4.5 Using the MAMBOII 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 MAMBOII ......................................................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 character values .....................................................247
6.5 NMEA messages transmitted/selected by/on MAMBOII device ................................251
6.5.1 Description 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 previous permission.
Page 8 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
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 Binary Data .......................................................................257
6.7.1 Maximum values & the time the history space will be used up .................................. 257
6.8 MAMBOII communication modes and their functionality ..........................................259
6.9 Default settings of the firmware version 2.4.0 ............................................................260
6.10 Buttons 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 connector of the I/O-BOX
corresponding to the firmware version 2.4.0 and later ...........................................263
6.11 MAMBOII Configuration Examples ............................................................................ 264
6.11.1 Basic 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 distance .................................................................................. 264
6.11.1.3 Voice calls ................................................................................................................................... 264
6.11.1.3.1 Accept incoming voice calls .................................................................................................. 264
6.11.1.3.2 Refuse voice calls after the second ring ................................................................................264
6.11.1.4 CSD (Data calls) ......................................................................................................................... 265
6.11.1.4.1 Accept incoming data calls .................................................................................................... 265
6.11.1.4.2 Refuse data calls after the second ring ................................................................................. 265
6.11.1.5 SMS ............................................................................................................................................ 265
6.11.1.5.1 SMS responses for self defined commands .......................................................................... 265
6.11.2 Advanced Examples .................................................................................................265
6.11.3 Navigation speed ......................................................................................................265
6.11.3.1.1 Check the over speed of the device each 5 seconds ............................................................ 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 automatically sent SMS ......................................................................... 266
6.11.3.4 Actions based on distance ......................................................................................................... 266
6.11.3.4.1 Report a position each 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 distance based history entries ............................................................................... 267
6.11.3.6 TCP storage ................................................................................................................................ 267
6.11.3.6.1 Send special device information to server periodically .........................................................267
6.11.4 Special consideration 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 previous permission.
Page 9 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
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
- Corrected the range of ring tones from 0..7 to 1..32 and volume from 0..7 to 0..4 – see chapter GSM.VoiceCall.Ringtone.
--Corrected maximal speaker volume – see
GSM.VoiceCall.Volume.Speaker=<n_gain>,<volume>,<sidetone>.
- Added new command IO.Vibration=<config_type>.
- Added new con figuration parameter DISP.TZ - Converts from time-zone name to
local time.
13/09/2007
This confidential document is a property of FALCOM and may not be copied or circulated without previous permission.
Page 10 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
Cautions
Information furnished herein by FALCOM is accurate and reliable. However, no responsibility is assumed for its use.
Please, read carefully the safety precautions. If you have any technical questions regarding this document or the product
described in it, please contact your vendor. General information about FALCOM and its range of products are available at
the following Internet address: http://www.falcom.de/
Trademarks
Some mentioned products are registered trademarks of their respective companies.
Copyright
This document is copyrighted by FALCOM WIRELESS COMMUNICATIONS GmbH with all rights reserved. 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 previous permission.
Page 11 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -

1 INTRODUCTION

THIS IS PRELIMINARY DOCUMENTATION AND IS SUBJECT TO CHANGE.
This document represents the description of the firmware version 2.4.0 and later and the supported Configuration Command Set for the FALCOM MAMBOII as well.
FALCOM firmware has been developed to accommodate a wide variety of applications, but it is often necessary to change firmware parameters in order to customize devices for customer applications.
Before using the MAMBOII or upgrading to a new firmware version, please, read the latest product information, see related documents item [1].
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 navigate 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. Figuratively 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 PFAL 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-BOX / Bluetooth 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 previous permission.
Page 12 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
• 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 approval, application notes, Certificate of Conformity R&TTE etc. are also available on the Web at: http://www.falcom.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 technical
details.
[2] MAMBO_II_getting_started.pdf Contains an introduction how to get started with MAMBOII device,
how do the software and hardware operate, factory preloaded configuration settings.
[3] MAMBO_II_software_update.pdf Contains information how to upgrade the MAMBOII device to a new
firmware version locally via Bluetooth.
[4] AppNotes_Transform_history_data.pdf Contains information of how to transform history data that are being
transmitted from MAMBOII via TCP connection.
[5] AppNote_Remote_update.pdf Contains information of how to upgrade the MAMBOII device 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 previous permission.
Page 13 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -

2 GENERAL

The MAMBOII operating with firmware version 2.4.0 and later (using eCos operating system) offers a speedy development of system solutions within the fields of:
• Fleet 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 device 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 vehicleIn 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 previous permission.
Page 14 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
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 services will be dropped out (e.g. bad GSM coverage). Once the connection is re-established, the stored data will be sent directly to the used remote server. Following a short overview, how many packets (data) can internally be buffered:
binary RMC: approx. 1800 (packets) RMC+GPIO: approx. 400 (packets) GGA,GSA,GSV,RMC,GLL,VTG,GPIO,GSM: approx. 80 (packets)
All aforementioned feature events can be controlled and GPS position can be received by means of any GSM phone or any workstation, which has access to the used remote server. You can easily perform configuration and feature changes either via Bluetooth connection or via a TCP-connection.
This confidential document is a property of FALCOM and may not be copied or circulated without previous permission.
Page 15 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -

2.2 The principle of firmware operation

The integration of the MAMBOII operating with firmware version 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 Server via GPRS Network. In addition, it shows that TCP communication enables the MAMBOII device to be monitored/tracked online from your PC via the Internet services.
Figure 1: Interfaces that the firmware uses to access the Remote Server via GPRS Network
The principle of system operation is very simple. Each object is equipped with a MAMBOII device, 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 receiver uses the satellites data to calculate the exact position of the vehicle (object) fitted with MAMBOII unit. The GPS data received from the MAMBOII unit can be transferred through the GPRS network (IP-based) and the Internet to your remote server for online purposes. A user-developed program installed on the remote server, can help you to connect to the vehicles equipped with MAMBOII units.
For such purposes, at first the MAMBOII device must be locally configured (with the help
of any terminal program or FALCOM Workbench software – a developed program to
This confidential document is a property of FALCOM and may not be copied or circulated without previous permission.
Page 16 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
help you configure and evaluate FALCOM devices). All MAMBOII devices 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 server.
Once the MAMBOII is attached to the GPRS network over the Basis Station, temporary a dynamic IP-address will be allocated by the MAMBOII device from the GPRS network. With the help of the IP-address that constantly changes, the GPRS network enables MAMBOII device to perform a TCP connection to the used remote server (to the specified IP address and Port number). By means of these IP addresses as object identifiers, all MAMBOII device can be direct configured from the remote server.
Such online applications enable you tracking and monitoring in a short time several 100 vehicles (objects) equipped with a MAMBOII device.
Furthermore, the data transmitted from MAMBOII device is received in real time. The MAMBOII device can be programmed so that the vehicle location and additional information will be received not only via a TCP server, but also via SMS.
The operating firmware 2.4.0 and later offers a rich set of events, states and commands that you can use to customize high-performance web solutions. The solution architecture varies with the type of application you decide to create.
Depending on the configuration settings that is loaded on the device, 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. Finally, 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 previous permission.
Page 17 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
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 device, as well as to set and poll configuration remotely from your client PC over Internet, user developed programs must be available. A client PC requests a server 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 server. 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 server PC) resulting in a teletype-like application; you and a friend can type messages to each other over the Internet. Understanding how these two programs work might help you in developing programs to control hardware devices over the Internet. The FALCOM Company does not provide for users any source code for such applications.
Figure 2: Internet applications setup with MAMBOII
This confidential document is a property of FALCOM and may not be copied or circulated without previous permission.
Page 18 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -

2.3.2 Intranet applications

Figure below represents the client PC and server PC communication. However, to exchange text messages (TCP packets) between server and MAMBOII device a program developed by the user must be available and already installed on the remote server. The user sends a request to the remote server via the client PC. The user­developed program installed on the remote server receives the message from the client PC and automatically sends it in the correct format to the connected MAMBOII device. The MAMBOII device responses the remote server. The remote server returns the requested information back to the client PC with help of the installed program. The FALCOM does not provide any source code for such programs.
Figure 3: Intranet applications setup with MAMBOII

2.4 TCP/IP Overview

The MAMBOII represents over 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 provides a connection-oriented end­to-end service 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 developed 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 previous permission.
Page 19 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
3 COMMAND SYNTAX, PFAL COMMANDS AND
SUPPORTED PARAMETERS– FOR FALCOM MAMBOII

3.1 PFAL Command syntax and response message structure

3.1.1 Command syntax of PFAL commands

The input messages provided in the next section can be sent to the target device locally via Bluetooth connection with the help of any terminal program, remotely via SMS or remotely via a TCP connection with the help of a remote server.
Each PFAL message containing the command <cmd> is distinguished as alone caption. Within a chapter you will find a table divided 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 have the following formats, and in one of these formats the MAMBOII device will accept the user sent messages:
Header Command Parameter Checksum End Sequence
$PFAL <cmd> <parameter> <*CKSUM> <CR><LF> $PFAL <cmd> <parameter> none <CR><LF> PFAL <cmd> <parameter> <*CKSUM> <CR><LF> PFAL <cmd> <parameter> none <CR><LF>
Table 1: PFAL command 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 value; in this case no subindex is supported. Also the subindex may include a value. According to this explanation, the improved 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 have 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 previous permission.
Page 20 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
length of <cmd> commands is limited to 1500 characters. The common syntax in this case is:
<cmd_1>;<cmd_2>;<cmd_3>….<cmd_n>
<parameter> The <parameter> can contain different valid parameters supported
by the MAMBOII firmware. In some PFAL commands the <parameter> entry is omitted. However, the specified parameter depends on the defined <cmd> command. Some parameters do not require any value, so it will be left empty. According to this explanation, the improved syntax to specify the
<parameter> is:
<parameter>=<value>
[<*CKSUM>]* If the checksum <*CKSUM> is used, it consists of an asterisk “*”
character (without double quotes) followed by two hex values. In order to calculate the Checksum, use your own application. Below a small source code written in Visual Basic:
//***************************************** Public Sub CheckSum(field As String) If field = “” then CS = “*” CS = 0 For i = 1 to Len(field) CS = CS Xor Asc(Mid$(field, i, 1)) Next CS = Hex(CS) If Len(CS) =1 then CS = “0” & CS CS = “*” & CS END SUB //*****************************************
Therefore, the string over which the checksum has to be calculated is:
field = PFAL,<cmd>,<parameter>
excluding “$”character. The “CS” variable in the CheckSum procedure must be declared as a global variable.
[<CRLF>]** Carriage Return plus Line Feed (ASCII CODE #13#10 (without any spaces) -
hexadecimal: 0x0D 0x0A)
According to the explanations above, the improved syntax to specify a PFAL command is:
$PFAL,<c_type>.<c_index>.<c_subindex>,<parameter>=<value><*CKSUM><CR><LF>
or
$PFAL,<c_type>.<c_index>.<c_subindex>,<parameter>=<value><CR><LF>
or
PFAL,<c_type>.<c_index>.<c_subindex>,<parameter>=<value><*CKSUM><CR><LF>
or
PFAL,<c_type>.<c_index>.<c_subindex>,<parameter>=<value><CR><LF>
For example:
1) $PFAL,SYS.Device.Reset*31<CR><LF>
2) $PFAL,Sys.Trigger5<CR><LF>
3) $PFAL,IO.Beep3=hpulse,1000 <CR><LF>
4) $PFAL,IO.Vibration=hpulse,5000;MSG.Send.Serial,0,”Phone is vibrating“<CR><LF>
5) $PFAL,Sys.Timer0.Start=single,5000<CR><LF>
6) $PFAL,Cnf.Set,DEVICE.NAME=”myMAMBOII”<CR><LF>
7) $PFAL,Cnf.Set,AL0=IO.BTN.e0=short:IO.Beep3=hpulse,1000<CR><LF>
*
Optional
This confidential document is a property of FALCOM and may not be copied or circulated without previous permission.
Page 21 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
The example 6 above signifies that the device name is specified to “myMAMBOII”. The example 7 above signifies that the MAMBO II will beep, when left button (BTN0) is
short-pressed.
3.1.1.1 Command types <c_type>
It is used to separate the huge amount of commands to different types. Currently the following command types are available.
<c_type> Definition
Sys
Accomplishes a predefined set of system tasks such as: System management tasks, including:
- Reset,
- Shutdown/power management etc.
Initialization/interruption of system processes, including:
- Timers,
- Counters etc.
Cnf
The operating firmware provides parameters that can be set/changed or read. Based on the parameter-settings some events will be occurred.
IO
Accomplishes a predefined set of system peripheral commands allowing access to the LEDs, Beep tones generation and Vibrating alerts.
GPS
Accomplishes a predefined set of GPS tasks including navigation, history logging and geo-fences and areas.
GSM
Accomplishes a predefined set of GSM tasks including SMS, voice and data calls, GPRS services etc.
TCP
Accomplishes a predefined set of TCP connection tasks including connecting disconnecting and sending of TCP packets to the predefined address of remote server etc.
MSG
Accomplishes a predefined set of output messages (GPS protocols) allowing information to be transmitted across the serial interface, CSD network or Internet (TCP).
IEEE
Accomplishes a predefined set of IEEE tasks on the device as well as provides parameters to connect the IEEE devices (Keyfob + I/O-BOX) to the MAMBOII.
Table 2: Supported command types <c_type>.

3.1.2 Aliases

This PFAL command specifies the alias names for all available <c_type>, <c_index>, <c_subindex>.
Following aliases are defined as default:
Sys is the alias name of System Cfg is the alias name of Config
if an alias has been specified, it can be freely used instead of the original word (or number). To specify alias names, please refer to the chapter 3.2.17.1 page 172.
Notes
• To avoid misinterpretation about using alias names, please assure that no
equal or very similar aliases are used inside the same command type/index.
• Also avoid starting of alias with numbers as they might be misinterpreted as
original index numbers.
This confidential document is a property of FALCOM and may not be copied or circulated without previous permission.
Page 22 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -

3.1.3 Using identifiers (optional)

Syntax1
-$PFAL:id<idtxt>,<commands>*<CS><CRLF>
Syntax2
-$PFAL:id<idtxt>,<commands><CRLF>
Syntax3
-PFAL:id<idtxt>,<commands>*<CS><CRLF>
Syntax4
-PFAL:id<idtxt>,<commands><CRLF>
Table 3: Identifier syntaxes
<idtxt> It can specify an optional text, which may not contain a comma (,).
The specified case sensitive text will be sent back within the corresponding PFAL response.
<commands> one or more device commands (see „command structure“ for
details)
<CS> The NMEA Checksum (see description of the checksum in chapter
3.1.1)
<CRLF> Carriage Return Line Feed (ASCII CODE 13 10 (without any spaces) -
hexadecimal: 0x0D 0x0A)

3.1.4 Response command structure

A configuration report is presented in text format, which includes the parameters listed in the table below.
Types of response message:
Respond message type if a PFAL command contains just one command.
Responses structure
Example $PFAL,Cnf.Set,DEVICE.NAME=myMAMBOII<CRLF>
Read commands
$<cmd><CR><LF> $report of executed parameter<CR><LF> $SUCCESS or $ERROR<CR><LF> $<end>
Example 1
$<Cnf.Get> $NAME=my MAMBOII $SUCCESS $<end>
Execution commands
$<cmd><CR><LF> $ report of executed parameter<CR><LF> $SUCCESS or $ERROR<CR><LF> $<end>
Example 2
$<Cnf.Set> $NAME written to flash $SUCCESS $<end>
Respond message type if a PFAL command contains several commands.
Responses structure
Example $PFAL,Sys.Trigger0;Sys.Trigger5<CRLF>
Read commands
$<Sys.Trigger0><CR><LF> $Trigger0=high<CR><LF> $<Sys.Trigger5><CR><LF> $Trigger5=low<CR><LF> $SUCCESS<CR><LF> $<end><CR><LF>
Respond message type if identifiers are used.
Responses structure
This confidential document is a property of FALCOM and may not be copied or circulated without previous permission.
Page 23 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
Example PFAL:id001,Sys.Trigger0<CRLF>
Read commands
$<Sys.Trigger0><CR><LF> $Trigger0=high <CR><LF> $SUCCESS<CR><LF> $<end:001><CR><LF>
Table 4: Response messages structure.
Note
• In case the first command fails (i.e. used wrong syntax or it cannot be
correctly executed), the execution stops at this command and system will respond an error.
• If identifiers are submitted within PFAL commands, they will be sent back
inside the PFAL responses.
This confidential document is a property of FALCOM and may not be copied or circulated without previous permission.
Page 24 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -

3.2 PFAL Commands

The following table provides a complete list of the PFAL commands used to manage/administrate different parts of an application built on the MAMBOII system.
Please note that, the PFAL commands listed in the table below could not be sent to the target device in that form. Information about each command can be found on the respective reference chapter and page. Use the hypertext links (shown in blue text) to navigate the chapter/sections. Each chapter describes the tasks each command performs, how command settings can be defined etc.
Please note that, only straight double quotation marks (" ") should be used within PFAL commands, configuration parameters, etc. As this documentation has been created using Microsoft Word, some straight quotation marks might have been transformed to the right and left smart (curly) quotation marks, which won't be accepted by the device.
PFAL COMMAND SET MEANING Chapter
System commands
$PFAL,Sys.Security.Lock,”password” Locks the system 3.2.1.1.1
$PFAL,Sys.Security.Unlock,”password” Unlocks the system 3.2.1.1.2
$PFAL,Sys.Security.RemoveLock,”password” Removes the system lock 3.2.1.1.3
$PFAL,Sys.RUpdate.Init Selects the sectors to be updated 3.2.1.2.1
$PFAL,Sys.RUpdate.DataMode Selects the blocks within sectors to be updated 3.2.1.2.2
$PFAL,Sys.RUpdate.Finish
Blocks sending of PFAL commands through the selected communication mode
3.2.1.2.3
$PFAL,Sys.Device.Reset Resets the system 3.2.1.3.1
$PFAL,Sys.Device.Update Resets the system into the update mode. 3.2.1.3.2
$PFAL,Sys.Device.Shutdown Shuts down the system 3.2.1.3.3
$PFAL,Sys.Device.FactoryReset Resets the user configuration to default settings. 3.2.1.3.4
$PFAL,Sys.Device.Sleep=<value>
Sets the system into the sleep mode until one of the set signals detected
3.2.1.3.5
$PFAL,Sys.Device.ClearAlarm
Clears the user alarm settings and restarts the system
3.2.1.3.6
$PFAL,Sys.Device.ClearConfig
Clears the user configuration settings and restarts the system
3.2.1.3.7
$PFAL,Sys.Device.CfgUpdateMode
Enters the system into a special configuration update mode to change the alarm configurations.
3.2.1.3.8
$PFAL,Sys.Timer<index>.Configure=<mode>,<timeout> Configures a system timer 3.2.1.4.1
$PFAL,Sys.Timer<index>.Start=<timer_settings> Starts/restarts a system timer 3.2.1.4.2
$PFAL,Sys.Timer<index>.Stop Stops a running timer 3.2.1.4.3
$PFAL,Sys.Timer<index>.Pause Pauses (suspends) a running timer 3.2.1.4.4
$PFAL,Sys.Timer<index>.Resume Restarts the execution of a paused timer 3.2.1.4.5
This confidential document is a property of FALCOM and may not be copied or circulated without previous permission.
Page 25 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
PFAL COMMAND SET MEANING Chapter
$PFAL,Sys.Timer<index>.Arm Arms an initialized and disarmed timer 3.2.1.4.6
$PFAL,Sys.Timer<index>.Disarm Disarms an initialized and armed timer 3.2.1.4.7
$PFAL,Sys.Timer<index>.Erase Erases the configuration of a timer 3.2.1.4.8
$PFAL,Sys.Timer<index>.Save<storage_index> Saves a timer state to a storage index 3.2.1.4.9
$PFAL,Sys.Timer<index>.Load<storage_index> Loads the saved timer state from a storage index 3.2.1.4.10
$PFAL,Sys.Timer<index>.State Reads the state of a used timer 3.2.1.4.11
$PFAL,Sys.Trigger<index>=<state_type> Activates/deactivates a system trigger 3.2.1.5.1
$PFAL,Sys.Trigger<index> Retrieves the current trigger state 3.2.1.5.2
$PFAL,Sys.Trigger<index>.Save<storage_index> Saves the state of trigger to a storage index 3.2.1.5.3
$PFAL,Sys.Trigger<index>.Load<storage_index> Loads a saved trigger from a storage index 3.2.1.5.4
$PFAL,Sys.Counter<index>.Set=<value> Sets the value of a counter 3.2.1.6.1
$PFAL,Sys.Counter<index>.Increment=<inc_value> Increments the value of a counter 3.2.1.6.2
$PFAL,Sys.Counter<index>.Decrement=<dec_value> Decrements the value of a counter 3.2.1.6.3
$PFAL,Sys. Counter<index>.State Retrieves the state of a used counter 3.2.1.6.4
$PFAL,Sys.Counter<index>.Save<storage_index> Saves the state of the counter to a storage index 3.2.1.6.5
$PFAL,Sys.Counter<index>.Load<storage_index> Loads a saved counter from a storage index 3.2.1.6.6
$PFAL,Sys. Counter<index>.Clear Sets a specified counter to 0 3.2.1.6.7
$PFAL,Sys.Macro<index> Activates a configured macro 3.2.1.7.1
$PFAL,Sys.GSM.Enable Powers on the GSM engine 3.2.1.8.1
$PFAL,Sys.GSM.Disable Powers off the GSM engine 3.2.1.8.2
$PFAL,Sys.GSM.Reset Resets the GSM engine 3.2.1.8.3
$PFAL,Sys.GPS.Enable Powers on the GPS engine 3.2.1.9.1
$PFAL,Sys.GPS.Disable Powers off the GPS engine 3.2.1.9.2
$PFAL,Sys.GPS.Reset Resets the GPS engine 3.2.1.9.3
$PFAL,Sys.UserEvent<index>
Creates a user-event for specific application requirements
3.2.1.10.1
$PFAL,Sys.Bat.Voltage Queries the battery voltage. 3.2.1.11.1
$PFAL,Sys.Bat.ChargeState
Query whether the internal battery is currently charging.
3.2.1.11.2
$PFAL,Sys.BT.Enable Powers on Bluetooth module 3.2.1.12.1
$PFAL,Sys.BT.Disable Powers off Bluetooth module 3.2.1.12.2
$PFAL,Sys.BT.Reset Resets Bluetooth module 3.2.1.12.3
This confidential document is a property of FALCOM and may not be copied or circulated without previous permission.
Page 26 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
PFAL COMMAND SET MEANING Chapter
$PFAL,Sys.CPU.Reset
Resets main controller and set system into the firmware update mode.
3.2.1.13.1
$PFAL,Sys.IEEE.Enable Powers on IEEE module 3.2.1.14.1
$PFAL,Sys.IEEE.Disable Powers off IEEE module 3.2.1.14.2
$PFAL,Sys.IEEE.Reset Resets IEEE module. 3.2.1.14.3
DISPLAY commands
$PFAL,Display.Show=<view>
Shows a specific view on the screen. 3.2.1.15.1
$PFAL,Display.Dialog=<id>,<”caption”>,<icon>,<tim
eout>,<”left-option”>,<”right-option”>,<”text”>
Creates and displays a dialog box on the screen. 3.2.1.15.2
$PFAL,Display.Alarm=<image>,<timeout>,<”text”>
Displays a specific alarm icon on the screen 3.2.1.15.3
CNF Configuration commands
$PFAL,Cnf.Set,<parameter_name=value> Sets up or changes device configuration settings 3.2.2.1
$PFAL,Cnf.Get,<parameter_name>
Retrieves configuration settings of the set parameter name
3.2.2.2
$PFAL,Cnf.Clear,<parameter_name>
Clears the configuration settings of the set parameter name
3.2.2.3
$PFAL,Cnf.ShowUser Retrieves user settings 3.2.2.4
$PFAL,Cnf.ShowDefault Retrieves default settings 3.2.2.5
$PFAL,Cnf.Show Retrieves settings of all used parameters 3.2.2.6
$PFAL,Cnf.Search,<parameter_name> Searches for a parameter name (text type) 3.2.2.7
IO commands
$PFAL,IO.Beep<index>=<config_type> Generates beep tones 3.2.3.1.1
$PFAL,IO.Vibration=<config_type> Manages device vibrations 3.2.3.2.1
GPS commands
$PFAL,GPS.Nav.Position<buffer_index>
Retrieves the distance of the device from a stored location
3.2.4.1.1
$PFAL,GPS.Nav.Position<buffer_index>=<type> Saves temporarily a device location 3.2.4.1.2
$PFAL,GPS.Nav.Position<buffer_index>=save<storage_in
dex>
Moves the GPS data from the buffer and stores it to a storage index
3.2.4.1.3
$PFAL,GPS.Nav.Position<buffer_index>=load<storage_ind
ex>
Loads the GPS data from storage to buffer index for temporarily use
3.2.4.1.4
$PFAL,GPS.Nav.Distance Retrieves the distance from a start point 3.2.4.1.5
$PFAL,GPS.Nav.Distance=<value> Sets/resets the distance to a user defined value 3.2.4.1.6
$PFAL,GPS.Nav.SaveLastValid Saves last valid position. 3.2.4.1.7
$PFAL,GPS.Nav.PowerSave=<on>,<onTime>,<lpTime>
Enables/Disables the low power mode of GPS receiver.
3.2.4.1.8
$PFAL,GPS.History.Write,<add_prot_to_memory>,<”text”>
Records a GPS position data into the history memory
3.2.4.2.1
This confidential document is a property of FALCOM and may not be copied or circulated without previous permission.
Page 27 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
PFAL COMMAND SET MEANING Chapter
$PFAL,GPS.History.Clear Clears the history memory space 3.2.4.2.2
$PFAL,GPS.History.GetStart
Retrieves the oldest date stored in the history memory
3.2.4.2.3
$PFAL,GPS.History.SetRead,<s_date>,<s_time>­<e_date>,<e_time>
Selects the number of records from the history memory to be downloaded
3.2.4.2.4
$PFAL,GPS.History.Read
Downloads the selected records from the history memory
3.2.4.2.5
$PFAL,GPS.History.Push Downloads the selected history records at once 3.2.4.2.6
$PFAL,GPS.Geofence.Park.Set
Places/activates a virtual circular fence around vehicle (Park area)
3.2.4.3.1
$PFAL,GPS.Geofence.Park.Remove Disables an activated park area 3.2.4.3.2
$PFAL,GPS.Geofence.GeoState,<geo_id> Retrieves the state of a defined geo-fence 3.2.4.3.3
$PFAL,GPS.Geofence.AreaState,<area_id> Retrieves the state of a defined area 3.2.4.3.4
GSM commands
$PFAL,GSM.PIN=<”pin”> Enters the PIN number of the used SIM card 3.2.5.1.1
$PFAL,GSM.PUK=<”puk”>,<”pin”> Enters the PUK and PIN numbers 3.2.5.1.2
$PFAL,GSM.IMEI
Retrieves the serial identification number of the product
3.2.5.1.3
$PFAL,GSM.SIMID Retrieves the ID of SIM Card 3.2.5.1.4
$PFAL,GSM.OwnNumber Retrieves the caller's phone number 3.2.5.1.5
$PFAL,GSM.Balance
Retrieves the account information of the used SIM card
3.2.5.1.6
$PFAL,GSM.VoiceCall.Dial,< “p_number“> Performs a GSM Voice call 3.2.5.2.1
$PFAL,GSM.VoiceCall.Accept Accepts an incoming voice call 3.2.5.2.2
$PFAL,GSM.VoiceCall.Hangup Hangs-up an active voice call 3.2.5.2.3
$PFAL,GSM.VoiceCall.Audio.Profile=<audio_index> Sets the active audio profile 3.2.5.2.4
$PFAL,GSM.VoiceCall.Ringtone=<type>,<volume> Sets or retrieves the ring tone settings 3.2.5.2.5
$PFAL,GSM.VoiceCall.Volume.Speaker=<n_gain>,<volume >,<sidetone>
Sets or retrieves the loudspeaker settings 3.2.5.2.6
$PFAL,GSM.VoiceCall.Volume.Microphone=<gain>,<n_gai
n>
Sets or retrieves the microphone settings 3.2.5.2.7
$PFAL,GSM.SMS.Send,<”p_number“>,<protocols>,<”text”> Sends a SMS to the defined phone number 3.2.5.3.1
$PFAL,GSM.SMS.Inbox.State Retrieves all inbox SMS messages 3.2.5.3.2
$PFAL,GSM.SMS.Inbox.Clear
Clears all inbox SMS messages (SMS memory for incoming messages)
3.2.5.3.3
$PFAL,GSM.SMS.Outbox.State Retrieves all outbox SMS messages 3.2.5.3.4
$PFAL,GSM.SMS.Outbox.Clear
Clears all outbox SMS messages (SMS memory for outgoing messages)
3.2.5.3.5
This confidential document is a property of FALCOM and may not be copied or circulated without previous permission.
Page 28 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
PFAL COMMAND SET MEANING Chapter
$PFAL,GSM.DataCall.Sent,<protocols>,<”text”>
Sends messages to a GSM modem via an established data call
3.2.5.4.1
$PFAL,GSM.DataCall.Accept Accepts an incoming Data call 3.2.5.4.2
$PFAL,GSM.DataCall.Hangup Hangs-up an active voice call 3.2.5.4.3
$PFAL,GSM.GPRS.Connect Performs a GPRS attach 3.2.5.5.1
$PFAL,GSM.GPRS.Disconnect Performs a GPRS detach 3.2.5.5.2
$PFAL,GSM.GPRS.State Retrieves the GPRS state 3.2.5.5.3
$PFAL,GSM.GPRS.Traffic=<complete>,<incoming>,<outgoi
ng>
Sets or retrieves the GPRS traffic counter 3.2.5.5.4
TCP commands
$PFAL,TCP.Client.Connect Performs a TCP connection to the remote server 3.2.6.1.1
$PFAL,TCP.Client.Send,<protocols>,<”text”>
Sends a TCP packet to the connected remote server
3.2.6.1.2
$PFAL,TCP.Client.State Retrieves the TCP connection state 3.2.6.1.3
$PFAL,TCP.Client.Disconnect
Performs a TCP Disconnection from the connected server
3.2.6.1.4
$PFAL,TCP.Storage.Dispatch
Moves the currently stored information inside the TCP storage to the outgoing TCP buffer
3.2.6.2.1
$PFAL,TCP.Storage.Clear Clears the contents of the created TCP storage 3.2.6.2.2
$PFAL,TCP.Storage.AddProtocol,<protocol>,<”text”>
Writes the specified protocols and/or user text to the TCP storage
3.2.6.2.3
$PFAL,TCP.Storage.AddRecord,<protocol>,<”text”> Appends a binary dataframe to TCP storage 3.2.6.2.4
Communication/ Messaging commands
$PFAL,MSG.Send.Serial,<protocols>,<”text”>
Outputs the selected protocols + additional system information to the serial interface in formatted data structure.
3.2.7.1.1
$PFAL,MSG.Send.RawSerial,<protocols>,<”text”>
Redirects command responses to the serial interface in unformatted data structure
3.2.7.1.2
$PFAL,MSG.Send.CSD,<protocols>,<”text”>
Transmits the selected protocols + additional system information to the connected GSM modem via an established data call.
3.2.7.1.3
$PFAL,MSG.Send.TCP,<protocols>,<”text”>
Transmits the selected protocols + additional system information to the connected TCP server
3.2.7.1.4
$PFAL,MSG.Mode.Serial=<out_sys_messages>,<mode>
Retrieves or forwards the in/out system messages to the selected destination
3.2.7.2.1
$PFAL,MSG.Mode.CSD=<out_sys_messages>,<mode>
Retrieves or forwards the in/out system messages to the selected destination
3.2.7.2.2
$PFAL,MSG.Mode.TCP=<out_sys_messages>,<mode>
Retrieves or forwards the in/out system messages to the selected destination
3.2.7.2.3
$PFAL,MSG.Version.Complete Retrieves all version information of the target device 3.2.7.3.1
$PFAL,MSG.Version.Modules Retrieves the modules versions of the target device 3.2.7.3.2
$PFAL,MSG.Version.InternalComm
Retrieves the internal communication version of the target device
3.2.7.3.3
This confidential document is a property of FALCOM and may not be copied or circulated without previous permission.
Page 29 of 271
CONFIGURATION COMMAND SET - FIRMWARE REVISION 2.4.0_BETA -
PFAL COMMAND SET MEANING Chapter
$PFAL,MSG.Version.HardwareRev Retrieves the hardware revision of the PCB 3.2.7.3.4
$PFAL,MSG.Version.Hardware Retrieves the hardware version of the target device 3.2.7.3.5
$PFAL,MSG.Version.Software Retrieves the software version of the target device 3.2.7.3.6
$PFAL,MSG.Version.SoftwareID Retrieves the software ID 3.2.7.3.7
$PFAL,MSG.Info.ServerLogin Identifies the device to the FALCOM’s Server 3.2.7.4.1
$PFAL,MSG.Info.Protocol,<protocols>,<”text”> Transmits the selected protocols to the sender 3.2.7.4.2
$PFAL,MSG.Info.Time Retrieves the current system time 3.2.7.4.3
$PFAL,MSG.Info.Alarm,<alarm_index> Transmits the selected alarm to the sender 3.2.7.4.4
$PFAL,MSG.Channel.SerialGSM
Channels messages from serial port directly to GSM engine
3.2.7.5.1
IEEE commands
$PFAL,IEEE.Keyfob<kf_div_index>.LED<lindex>=<config_t
ype>
Sets and controls LED blinking to a Keyfob 3.2.8.1.1
$PFAL,IEEE.Keyfob<kf_div_index>.Beep=<config_type>
Sets and controls the Beep tones to be generated on a Keyfob.
3.2.8.1.2
$PFAL,IEEE.Keyfob<kf_div_index>.Vibration=<config_type >
Sets the type of vibration alert on a Keyfob 3.2.8.1.3
$PFAL,IEEE.IOBox<ib_div_index>.OUT<oindex>=<config_t
ype>
Configures the outputs on an I/O-BOX 3.2.8.2.1
$PFAL,IEEE.IOBox<ib_div_index>.power=<power_mode> Set the operation mode on an I/O-BOX 3.2.8.2.2
$PFAL,IEEE.IOBox<ib_div_index>.bat.level Gets battery charge state 3.2.8.2.3
Bluetooth-Audio commands
$PFAL,BT.Audio.Bound Pairs Bluetooth audio devices 3.2.9.1.1
$PFAL,BT.Audio.Connect
Places both Bluetooth devices in the connection mod
3.2.9.1.2
$PFAL,BT.Audio.Disconnect Closes a currently open audio connection 3.2.9.1.3
Table 5: Complete list of PFAL commands.
This confidential document is a property of FALCOM and may not be copied or circulated without previous permission.
Page 30 of 271
Loading...
+ 241 hidden pages
Buy Points How it Works FAQ Contact Us Questions and Suggestions Privacy Policy Cookie Policy Terms of Use