6.3 Installing your own SIM card and replacing the internal battery ..................................................... 23
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 1 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
- Added explanation of the sample configuration – see chapter 5
- Extended the contents of promotion kit – added CA27, CA76 and CA123
- Added new items in the PROMOTION-KIT:
3) 8 hours free technical support
- Added basic configuration settings when using your SIM card and TCP server -
see chapter 5.3
Version history:
This table provides a summary of the document revisions.
Version Author Changes Modified
1.0.7 F. Beqiri - Extended the contents of promotion kit – added CA27, CA76 and CA123 05/09/2018
1.0.6 F. Beqiri
1.0.5 F. Beqiri
1) USB to serial converter with extension cable
2) External antenna (ANT-11 for FOX3 only and ANT-12 for FOX3-3G
and ANT-14 for FOX3-4G device)
12/21/2017
06/23/2015
1.0.4 F. Beqiri
1.0.3 F. Beqiri - Added figure 14 in chapter 5.3 06/04/2015
1.0.2 F. Beqiri - Changed: STARTER-KIT to PROMOTION-KIT 06/03/2015
1.0.1 F. Beqiri - Updated: chapters 2.2 and 5.1. 06/02/2015
1.0.0 F. Beqiri - Initial version. 02/12/2015
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
06/05/2015
Page 2 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
Cautions
The information furnished herein by FALCOM is believed to be 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 GmbH with all rights reserved. No part of this documentation
may be reproduced in any form without the prior written permission of FALCOM GmbH.
FALCOM GmbH
No liability (incl. patent liability) is assumed with respect to the use of the information contained herein.
Note
Because our products are being continuously improved, specifications and information given in this
document are subject to change by FALCOM without notice.
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 3 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
1 ABOUT THIS DOCUMENT
This document provides information about the FOX3-2G/3G/4G/-4G PROMOTION-KIT giving customers the
possibility to easily and quickly evaluate the product and all its functionality.
This document was written assuming the user has basic computer knowledge, and is familiar with the
Windows operating environment.
1.1 Audience
This document is intended for system integrator and application developers.
1.2 How this document is organized
This guide consists of following chapters:
• Chapter 2, “Overview” gives an overview of the PROMOTION-KIT and describes its contents.
• Chapter 3, “Getting started” provides installation instructions of the PROMOTION-KIT and testing its
functionality.
• Chapter 4, “Control-Box” provides an overview of the control-box and describes how to use it.
• Chapter5, “A detailed explanation of the sample configuration” provides information about the
configuration preloaded at the factory. It shows the functionality of each alarm configuration and the
description of each configuration parameter settings.
• Chapter 6, “Appendix” provides information how the firmware operates and information about the
included installation cables. Here is also explained how to operate with your own SIM card and how to
login the FOX3-2G/3G/4G device to your own remote server.
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 4 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
2 OVERVIEW
This PROMOTION-KIT provides all the necessary hardware, software, and documentation to easily and
quickly evaluate the performance of your FOX3-2G/3G/4G device. The FOX3-2G/3G/4G device is shipped
pre-configured allowing system integrators and developers to test the factory-preloaded configuration and
see how the FOX3-2G/3G/4G device works. Once the device is powered up, it connects automatically to the
FALCOM D2Sphere server which supports two-way communication interface between server and device
and lets you track all activities of the device, pull and change the factory-preloaded device configuration.
You don’t need anything else to get started with PROMOTION-KIT. Only an internet enabled computer (PC
client) with a pre-installed standard web browser is required. After you log in to the D2Sphere server, the
exact location and other information transmitted from the device will be displayed on the map.
2.1 Scope of delivery
PROMOTION-KIT consists of 1 outer box with 3 small boxes inside. Before you start up the PROMOTIONKIT, make sure that your package includes the following items listed in table 1 below. If any item is missing
or damaged, please contact your vendor immediately..
In addition to the D8 interface, the IOBOX-CAN device offers several flexible features such as CAN-Bus
interface and programmable inputs and outputs for almost every application within the automobile
industry. For more details, please refer to the chapter 3.1, and download the document
“FOX3_3G_4G_HardwareManual.pdf” from our website.
Figure 1: PROMOTION-KIT delivery package.
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 5 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
Article name
QTY
Description
FOX3-2G/3G/4G (BOX)
FOX3 or FOX3-3G unit, pre-configured with access to the FALCOM D2Sphere server. The device is
IGN-Switch or a high signal on IGN-pin.
Battery
1
1000 mAh rechargeable battery (already inserted and connected to the FOX3-2G/3G/4G/-4G)
All PREMIUM-FEATURES are activated by the factory. For details how to use them refer to the
corresponding Application Notes listed in chapter 2.2
Prepaid SIM card. Service fee includes 10MB of data transfer and 3 months access to the FALCOM
server for evaluation purposes.
Depending on which Promotion Kit you ordered, one of the following external antennas will be
More details: http://www.falcom.de/products/accessories/antennas/
Instruction sheet
1
Necessary information how to get started with FALCOM AVL devices.
Contains log-in data to access the online documentation on the FALCOM website and FALCOM
server for evaluation purposes.
Support
-
8 hours free technical support.
FOX3-2G/3G/4G-CONTROL-BOX
To test the functions of the FOX3-2G/3G/4G device and allows connection to your PC for
evaluation purposes.
This cable allows a serial connection through the USB port of the PC to the serial port of the control
box.
CA27
1
Main port service and power connection cable
Installation cable for FOX3-2G/3G/4G with interface to the RFID-Reader or JAZZ2. This cable allows
to install your FOX3-2G/3G/4G to the vehicle.
This cable allows testing of the available pins on the accessory port of the FOX3-2G/3G/4G (e.g. 1Wire bus). It has a 4pin connector for connecting to a RFID-Reader or JAZZ2 device.
CA76
1
Accessory port service cable with 2x3pin connector to DB9 female socket with a length of 1.0 m
CA123
1
2x4pin connector to OBDII cable with separated IGN-wire. Cable length of 1.5 m
POWER-SUPPLY-BOX
Power Suppy
1
Type FW7238/12 incl. UK/US/AU/EU adaptor
FOX3 unit 1
placed in the IGN-Sleep mode prior to being shipped from the factory and can be woken up via
PREMIUM-FEATURES -
SIM-Card 1
D2Sphere
ANT-11 /
ANT-12 /
ANT-14 /
Info-Sheet 1
Control-Box 1
USB to SERIAL 1
CA31 1
CA69 1
part of your kit:
ANT-11 : Quad Band GSM+GPS combination antenna for FOX3 only.
1
ANT-12 : Penta Band GSM/WCDMA combination antenna for FOX3-3G.
ANT-14 : GSM/UMTS/WCDMA/LTE and GNSS combined antennas for FOX3-4G.
D2Sphere
Table 1: The list of items included in the PROMOTION-KIT.
2.2 Related documents
In addition to this document, the following files comprise the full set of FOX3-2G/3G/4G product manuals
and can be downloaded from the FALCOM web site (protected area). Downloading documents from the
FALCOM website:
1. Open your installed browser and enter https://www.falcom.de/distributor-login/?origin=4
2. Log-in using the logging data (Username & Password) available in the Info Sheet delivered with the
PROMOTION-KIT
3. Go to "Support" and select "AVL (FOX3, STEPPIII,.....)" from the "Documentation" selection box
4. This will list the supporting documents for all FALCOM AVL devices. Please, download just the
documents listed in the table below.
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 6 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
NR
PDF file name
Description
Contains the description of the internal firmware and the supported
Configuration Command Set for the FALCOM AVL devices.
[2]
FOX3_hardware_manual.pdf
Contains information about the hardware of the FOX3 device.
NR
PDF file name
Description
[3]
AppNotes_AVL_IO.pdf
Contains information about the use of the IOs on FALCOM AVL devices
[4]
AppNote_CAN_FMS_CAN_OBDII_Howto.pdf
Contains information about the use of the CAN-BUS interface
Contains information about the AES128 data encryption on FALCOM
AVL devices
Contains information about the using of ECO-DRIVE-GPS on FALCOM
AVL devices
Contains information about the indexed history on FALCOM AVL
devices
Contains information about the conversation of the history data stored
in a FALCOM AVL device
Contains information of how to upgrade FALCOM AVL devices to a new
firmware revision remotely via TCP
Describes how to connect a bar code scanner to a STEPPII, STEPPIII,
data.
This document provides all the necessary information to allow your
FALCOM product to be properly and safely installed
This document provides all the necessary information how to connect a
RFID reader to your FALCOM product and work with it
This document provides all the necessary information how to connect
1-Wire sensors to your FALCOM product and work with them.
FALCOM D2Sphere-fleet documents
This document provides all the necessary information how to get started
and work with FALCOM
-fleet server application/frontend.
[1] AVL_PFAL_Configuration_Command_Set.pdf
Downloading documents from the FALCOM website:
1. Open your browser and enter "https://www.falcom.de/support/documentation/application-notes/”
2. This will list the application notes for all FALCOM AVL devices. Please, download just the application
notes listed in the table below.
Table 2:Documents for download from the FALCOM website (protected area)
[5] AppNotes_AES_TCP.pdf
[6] AppNotes_ECO-DRIVE-GPS.pdf
[7] AppNotes_INDEXED_HISTORY.pdf
[8] AppNotes_Transform_history_data.pdf
[9] AppNote_Remote_update.pdf
[10] AppNotes_connecting_a_bar_code_scanner.pdf
BOLERO-LT, FOX3-2G/3G/4G etc. and store or transmit the scanned
[11] AppNotes_AVL_Installation_Guide.pdf
[12] AVL_AppNote_RFID_Howto.pdf
[13] AppNotes_1-Wire-Guide.pdf
[14] t4y_fleet_UsersGuide.pdf
Table 3:Documents for free download from the FALCOM website
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.
D2Sphere
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 7 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
3 GETTING STARTED
3.1 PROMOTION-KIT hardware set up
This chapter explains how to connect and set-up the PROMOTION-KIT.
Installing the PROMOTION-KIT in five steps:
1. Unpack the PROMOTION-KIT.
2. Connect the FOX3 unit to the control-box, PC and apply power.
3. Charge the internal battery of the FOX3-2G/3G/4G and power up the device.
4. Install the FALCOM Workbench software and start the evaluation of the FOX3-2G/3G/4G device
5. Access the online documentation from the FALCOM website using the login data available in the info
sheet supplied with PROMOTION-KIT.
3.1.1 Unpacking the PROMOTION-KIT
Unpack the contents as shown in the figure below. There are no external antennas included in the
PROMOTION-KIT, as the FOX3-2G/3G/4G has also internal GSM/GPS antennas.
Figure 2: Boxes inside the PROMOTION-KIT.
Figure 3: PROMOTION-KIT contents.
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 8 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
3.1.2 Connecting FOX3-2G/3G/4G to the control-box
1. Before starting initial operation, switch all switches on the Control-Box to "OFF" (factory default
setting).
2. Plug in the 8pin double row connector (1a) of cable (1) to the 8pin main port on the FOX3-2G/3G/4G
device. To unplug, press the "lever" on the back of this connector (1a) and pull it out.
3. Plug in the 6pin double row connector (1b) of cable (1) to the 6pin accessory port on FOX3-2G/3G/4G.
To unplug this connector press the "lever" on the back of this connector (1b) and pull it out.
Figure 4: Connecting PROMOTION-KIT to FOX3-2G/3G/4G and PC
4. Now, unpack the power supply from the box and plug it into the left input socket on the control-box
marked "INPUT 12.0V … 32.0V”. Then plug the AC adapter into the wall socket of your 220V electric
mains (to access British/American wall socket use the included UK/US adaptor accordingly).
5. Even the FOX3-2G/3G/4G series devices provide two serial ports (except LITE models which have only
one serial port), the control-box offers only one serial port for the communication with them. That
means if you would like to connect and test a third-party-product to a FOX3-2G/3G/4G series device
you have to use the second serial port (the serial port [RX,TX,GND] on the 6pin connector) instead of
the first serial port which is available on the control-box. That means, please do not reconfigure the
first serial port, except when you have already a self-made serial cable for the second port (accessory
port).
3.1.3 Charge the internal battery and power up the device
The internal battery in the device may be shipped with a minimal charge and will need to be fully charged
before use.
To charge the internal battery, follow the steps below:
1. After connecting the AC adapter to the Control-Box and into the wall socket, apply power to the
control box and FOX3-2G/3G/4G device by turning just the “+IN” switch to “ON” position.
Figure 5: Overview of the control-box top panel (+IN = ON)
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 9 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
3. Depending on the battery charge state, the charging time may by different but usually it takes 3-4
hours to fully charge the internal battery.
4. After the battery is fully charged, unpack the USB to serial converter and the USB extension cable.
Remove the USB cover on the converter and connect the USB cable to the converter (1), see figure
below. Plug the serial port of the converter to the COM port of the control box (2). Finally, plug the
other end of the cable into a free USB port on your PC (3). This cable is used for communication
between the FOX3-2G/3G/4G and Workbench software for sending and receiving data as well as to
change the configuration stored in the FOX3/3G device.
Figure 6: Connecting the converter with the USB cable
5. Finally, power up the FOX3-2G/3G/4G device by turning the “IGN”-switch to "ON" position.
Figure 7: Overview of the control-box top panel (IGN = ON)
“+IN” It supplies power to the control box and FOX3-2G/3G/4G.
“IGN” It turns on the FOX3-2G/3G/4G (wakes it up from the IGN sleep mode).
6. If you want to use the FOX3-2G/3G/4G with external antenna, remove first power from the device,
unpack the supplied antenna and connect both ends of the antenna to the same colours of FAKRA
connectors on the FOX3/3G and power up the device again.
Figure 8:Connecting the external antenna
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 10 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
3.1.4 Installing the FALCOM Workbench software and start evaluation
System requirements for Workbench software
(a) PC with 700 megahertz or higher processor Intel Pentium II or compatible processor recommended,
(b) 512 megabytes (MB) of RAM or higher recommended (512MB minimum supported; may limit
performance and some features),
(c) 90 megabytes (MB) of available hard disk space (recommended 2 gigabytes),
(d) Keyboard and Mouse.
To be able to test your device with factory preloaded configuration or to change this configuration, you
need to install the Workbench evaluation software. Go to the link below and download it:
An install shield will guide you through the installation. An integrated online help can be found after the
installation completes.
Figure 9:FALCOM Workbench software.
1. After completing the installation, start the Workbench.exe by double-clicking on it. Open a new COM
Port from the Toolbar (1), on the COM Port view (2) choose the Port where FOX3-2G/3G/4G is
connected (go to Device Manager > Ports > USB Serial Port (COMxx), where xx is the COM port to use),
define the port settings (115200 bps, 8 Data bits, No Parity bit, 1 Stop bit, None Flow control) and
finally, click the connect (play) icon (2.1) to open that COM Port. You can also get an online help in
HTML format if you click "Help" button on the upper-right corner.
2. Open a new Console from the Toolbar (3), click on the Console1 (4), then go to Connection view and
click on COMPort (5).
3. Open a new Editor from the Toolbar (6), click on the Editor1 (7), then go to Connection view and click
on Console1 (8).
4. To send commands to the FOX3-2G/3G/4G device, type them on the Editor (9) and then click on Start
sending configuration (10) or double click with left mouse each configuration line on the Editor (9)
individually.
5. To see all events generated by the FOX3-2G/3G/4G device, either open a new console “Console2” or
on the Console1 (4), click “Add” (11), type the text “GPEVENT” on input field (12), finally click the
button (13 )“Filter incoming”. A description how to operate with the Control-Box is given in chapter 4.
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 11 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
3.1.5 Accessing online documentation
References to the online documentation are listed in chapter 2.2, Related documents.
How to send the data to a TCP-Server or SMS messages to a phone number/SMS server and how to
reconfigure the loaded configuration on the device, refer to the Related Documents [1]. A description of
how the firmware on the FOX3-2G/3G/4G works is given in chapter 5.1.
3.2 Customer Support
Users of the PROMOTION-KITS can receive assistance up to 8 hours through technical support team.
Contact our technical support through our web site at: http://www.falcom.de/support/support-form/
3.3 FALCOM D2Sphere server-frontend
The D2Sphere-fleet is a web-based tracking application that provides users with an easy-to-use interface
from where you can remotely monitor and view the location of the FALCOM AVL devices in real-time.
D2Sphere also allows to view the device history, device-generated event, view reports, manage geofences,
pull and change the factory-preloaded device configuration. After the FOX3-2G/3G/4G is successfully
powered up, open a web browser (IE or Firefox) and follow the registration process as given on the
enclosed slip of paper called „Info-Sheet“.
3.4 How the sample configuration works?
Once the FOX3-2G/3G/4G device is powered up, it tries automatically to register to the GSM network,
attach to the GPRS network and finally connect to the FALCOM D2Sphere server using the factory-
preloaded configuration. The connection state of the GPRS and TCP services will be shown by the
generated events GSM.GPRS.eConnected and TCP.Client.eConnected telling you that the device is
connected to the GPRS/TCP server. These events are displayed on the Terminal in the Workbench. The
device GPS location is shown on the D2Sphere frontend server after log-in. For more details about the
D2Sphere server refer to the Related Documents [14].
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 12 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
Item
Description
INPUT (12V – 32V)
1.1 A
Item
Description
LED (+IN)
Lights when the +IN-switch is turned to ON.
LED (IGN)
Lights when the IGN-switch is turned to ON.
+IN - switch
This two-way-switch enables or disables power to the connected FOX3-2G/3G/4G unit. (To enable
power to the device, the Current- switch must be set to “ON“)
IGN - switch
This two-way-switch wakes up the FOX3-2G/3G/4G device from IGN-sleep mode and sets the IGN-pin
of the FOX3-2G/3G/4G to High or Low signal level for using the rising edge and falling edge events.
IO - switches
These pins have dual functions. All are controlled by the internal firmware of FOX3-2G/3G/4G.
general purpose input/output pin. For more details please refer to the Related Documents[2].
4 CONTROL-BOX - HARDWARE DESCRIPTION
This chapter gives you some information about the operation of the control box. It allows you to exercise
the function of all inputs and outputs on the FOX3-2G/3G/4G device without the need to add any other
external component to them.
The components on the control-box can be identified from the figures below showing the front, top, and
the rear panels.
4.1 Front panel overview
Figure 10: Front panel of the control-box.
A description of each of the items on the front panel is provided in Table 4.
Input power supply for control-box and FOX3-2G/3G/4G device with
Table 4: Front panel overview.
4.2 Top panel overview
Figure 11: Top panel of the control-box.
A description of each of the items on the top panel is provided in Table 5.
Therefore, the user must define whether to use them as analog or digital pins. The configured digital
pins can be inputs or outputs while the analog pins can only be inputs. Their function is controlled
with commands with $PFAL,IO0[1,2].Config=DI,1,10 or $PFAL,IO0[1,2].Config=AI,1,10 by changing
the electrical behaviour of the reference pin to digital or analogue input (DI = Digital input; AI =
Analogue input). These three-way switches (from IO/1 to IO/3) allow operation of the IOs either as
digital/analogue inputs or digital outputs. More details how to test these IOs, are given below. Please note that, due to the the PROMOTION-KIT comes with all PREMIUM-FEATURE activated, the
IO2 and IO3 are activated for using the "CAN-INTERFACE". Only IO/1 remains free and can be used as
fuse protected.
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 13 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
Item
Description
Testing IOs as digital
When the reference IO (e.g: IO/1) is configured as digital input with "$PFAL,IO0.Config=DI,2,10", the
Testing IOs as analogue
When the reference IO (e.g: IO/1) is configured as analogue input with "$PFAL,IO0.Config=AI,2,10,
➒
➒
" position. This position has a
switch on an LED (e.g. IO/3) when the voltage on the IO/3 is higher than e.g. 5.0 V. To test it,
Send the configuration
" from the
➒
Testing IOs as digital
When the reference IO (e.g: IO/1) is supposed to be used as digital output, there is no configuration
Item
Description
Serial port 0
Via your own RS-232 cable you can connect the PROMOTION-KIT to a PC and evaluate the connected FOX32G/3G/4G device.
inputs:
FOX3-2G/3G/4G device will generate a rising edge event "IO.e0=redge" and set the state of the IO/1
to high "IO.s0=high", if:
•the position of the IO/1-Switch changes from "Digital IN - Low" to "Digital IN - High".
and will generate a falling edge event "IO.e0=fedge" and sets its state to low "IO.s0=low", if:
•the position of the IO/1-Switch changes from "Digital IN - High" to "Digital IN -Low".
inputs:
you have to calibrate first this IO the low and high voltages. To do it, perform the following steps (e.g.
IO/1):
1. Switch the IO/1-Switch (IO/1) to "Digital IN - Low" position.
2. Send the command “$PFAL,IO0.Calibrate,offset=0" from the WorkbenchEditor
Fig. 8) to FOX3-2G/3G/4G.
3. Switch the IO/1-Switch (IO/1) to "Digital IN - High" position.
4. Send the command “$PFAL,IO0.Calibrate,gain=15" from the WorkbenchEditor
8) to FOX3-2G/3G/4G.
5. Switch the IO/1-Switch (IO/1) to "Digital OUT / analogue IN
fixed voltage of approx. 6V.
Now, you can configure an alarm (e.g. $PFAL,CNF.Set,AL31=Sys.Timer.e0&IO.s0>6.0:IO6.Set=high) to
perform the steps below:
6.
"$PFAL,CNF.Set,AL31=Sys.Timer.e0&IO.s2>5.0:IO13.Set=hpulse,5000
WorkbenchEditor ➒ (see Fig. 8) to FOX3-2G/3G/4G.
7. Switch the IO/1-Switch (IO/1) to "Digital OUT / analogue IN" position.
8. Send the command "$PFAL,Sys.Timer0.Start=single,1000" from the WorkbenchEditor
(see Fig. 8) to FOX3-2G/3G/4G
After the timer expires (1 second has passed), the red LED on the FOX3-2G/3G/4G (front side, next
to the 6pin accessory port) goes ON for 5 seconds and then turns OFF. For more details about the
LED on the FOX3-2G/3G/4G, refer to the Related Documents [2].
(see
(see Fig.
outputs:
Table 5:Components on the top panel of the control-box and their functionality
to be done in the firmware. To test it, perform the steps below:
1. Remove the available configuration for the IO/1 with "$PFAL,IO0.Config="
2. Switch the IO/1-Switch to the "Digital OUT / analogue IN" position
3. Send the command "$PFAL,IO4.Set=high" to set it to High
4. Send the command "$PFAL,IO5.Set=low" to set it to Low
4.3 Rear panel overview
Figure 12: Rear panel of the control-box.
A description of each of the items on the rear panel is provided in Table 6.
Table 6: Item description on the rear panel of the control-box.
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 14 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
AL2: Before the device goes in sleep mode, it saves both its position from GPS.Nav.Position0 to memory
slot zero and the last valid position in the corresponding configuration parameter.
AL12: Each time the predefined angle (course) is exceeded and the speed is > 2m/s, then the device
sends a TCP packet to the server including the GPRMC protocol AND the user text ‘HEAD’.
AL13: Each time the Ignition is turned ON (IO.e8=redge), the device starts Timer3 with a single timer
event that occurs once, after 2000 of milliseconds (2 sec.) and stops running the Timer4.
AL14: When the single Timer3 runs out and the status of the Ignition is still high, then the device sends a
TCP packet to the server including the GPRMC protocol, the user text <sfal.trip.start> and also it saves
5 A DETAILED EXPLANATION OF THE SAMPLE CONFIGURATION
In the table below you find a detailed description of the configuration preloaded in the device shipped with
promotion kit. To call this configuration use either the command $PFAL,Cnf.Show or use the button “Read current device configuration” from the Editor of the Workbench software. See chapter 3.1.4, Fig. 9.
with repeat timer events that occur every time a 20000, 5000 and 2000 of milliseconds elapses. These
timer events will be used later in other alarms to start or stop actions (PFAL commands).
E.g. Timer0 event (Sys.Timer.e0) is used in AL9 to save GPS position data every 20 sec. in the history if
like: displaced distance is > 50m and GPS fix is valid
GPS.Nav.Position0 and starts a Timer3 with a single timer event that occurs once, after 100000 of
protocol and the user text <sfal.event text='shutdown'>, telling the server D2Sphere its current location
meters, the GPS is corrected and the speed is > 2m/s, then the device sets the new position to current
corrected and the speed is > 2m/s, then the device sets the new position to current position and sends a
the new position to current position AND it saves the position in the History (Data logging) with the user
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 15 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
Functions
Configuration alarms and their descriptions.
the user text in the history (data logging) with the user text <sfal.trip.start>.
AL15: When the Ignition is turned OFF (IO.e8=fedge), the device starts Timer4 with a single timer event
that occurs once, after 2000 of milliseconds (2 sec.) and stops running the Timer3.
AL7: When the FOX3 turns on or wakes up on its internal backup battery and the external power is below
9VDC, the red LED (IO13) starts flashing 200msON/200msOFF.
the server including the GPRMC protocol, the user text <sfal.trip.stop> and the driven distance in meters
&(NavDist). It also saves the user text in the history (data logging) with the user text <sfal.trip.stop>, the
driven distance in meters and starts Timer5 with a single timer event that occurs once, after 60000 of
milliseconds (60 sec.).
//If another unit of the driven distance is needed, then replace &(NavDist) with the corresponding
&(NavDist.km)
sleep mode with the wakeup parameter IGN. The wakeup parameter ‘IGN’ means, the device will wake
&(NavDist.miles)
orange LED (IO11) either blinking (AL19, AL27) or turns it ON (AL18, AL27) depending if the device has a
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 16 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
Functions
Configuration alarms and their descriptions.
detached from that services but it still has a valid GSM operator, the green LED (IO12) will blink fast.
AL23, 24: Once the device is connected to TCP server, the green LED (IO12) goes ON and when it is
Configuration
$PFAL,CNF.Set,DEVICE.BAT.CHARGEMODE=eco
Starts charging if the voltage of the internal battery drops to less than 3.9V and terminates charging
when the battery is full-charged.
$PFAL,CNF.Set,DEVICE.BAT.MODE=auto
Automatically switching between external power and internal battery power source depending on the
power source currently available. External DC power supply has priority, if it is higher than 8 V.
$PFAL,CNF.Set,DEVICE.COMM.SERIAL0=cmd,7F
The serial port 0 is set into the command operation mode with protocols and events output enabled.
$PFAL,CNF.Set,DEVICE.COMM.TCP.CLIENT=cmd,60
The serial port 0 is set into the command operation mode without protocols and events output enabled
Enables filtering of GPS auto correction to calculate a valid GPS fix using maximal allowed PDO of 5.0,
and maximal acceleration of 50 m/s.
$PFAL,CNF.Set,DEVICE.GPS.CFG=4
At least 4 satellites must be in use to consider a GPS fix as valid.
$PFAL,CNF.Set,DEVICE.GPS.HEADING=25
Heading tolerance is set to 25 degrees. Each time this angle is exceeded, the event
GPS.Nav.eChangeHeading occurs, and the driving direction resets to zero.
$PFAL,CNF.Set,DEVICE.GPS.TIMEOUT=1,30
Restarts the GPS receiver to do a new search for visible GPS satellites, if within this time no valid fix is
available.
The syntax of the PFAL messages is defined to start each line with the character ‘$’, followed by the user
$<end>. These settings can be changed based on your server requirements.
$PFAL,CNF.Set,PPP.PASSWORD=blau
Required string (password) for the Chap and Pap authentication methods over PPPP to attach the device
into the GPRS network. This setting is provider-dependant.
$PFAL,CNF.Set,PPP.USERNAME=blau
Required string (username) for the Chap and Pap authentication methods over PPPP to attach the device
into the GPRS network. This setting is provider-dependant.
$PFAL,CNF.Set,GPRS.APN=Public4.m2minternet.com
APN (Access Point Name) name that your network operator has provided to you to connect the device to
the GPRS/Internet. This setting is operator or provider dependant.
parameters
disconnects from that server but it still has a valid GSM operator, the green LED (IO12) will blink slower
than when it detaches from GPRS services.
maximal speed limit of 58 m/s, maximal allowed distance error of 50, drop count incorrect position of 10
text and terminated by a NMEA compatible checksum and <CRLF>. The complete message(s) end(s) with
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 17 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
Functions
Configuration alarms and their descriptions.
$PFAL,CNF.Set,GPRS.AUTOSTART=1
Enables automatic attachments to the GPRS network. If the GPRS network connection gets lost, it tries to
reconnect automatically as soon as the network is available again.
$PFAL,CNF.Set,GPRS.DIAL=ATD*99***1#
The V.250 'D' (Dial) command causes the device to enter the V.250 online data state.
$PFAL,CNF.Set,GPRS.QOS=0,0,0,0,0
Quality of Service Profile used when the device sends an Activate PDP Context Request message to the
GPRS network.
$PFAL,CNF.Set,GPRS.QOSMIN=0,0,0,0,0
Minimum acceptable profile checked by the device against the negotiated profile returned in the
Activate PDP Context Accept message.
$PFAL,CNF.Set,GPRS.TIMEOUT=1,600000
Detaches the device from GPRS network if no TCP communication available within the timeout.
$PFAL,CNF.Set,GSM.BALANCE.DIAL=*100#
GSM dial number for retrieving balance information
$PFAL,CNF.Set,GSM.OPLOST.RESTART=1,1200000,8
Reinitializes the GSM engine periodically until a GSM operator is found.
$PFAL,CNF.Set,PROT.3DP=0
3DP protocol (motion sensor data) is deactivated
$PFAL,CNF.Set,PROT.AREA=0
AREA protocol (area states) is deactivated
$PFAL,CNF.Set,PROT.BIN=0
BIN protocol (FALCOM) is deactivated
$PFAL,CNF.Set,PROT.GGA=0
GGA protocol is deactivated
$PFAL,CNF.Set,PROT.GLL=0
GLL protocol is deactivated
$PFAL,CNF.Set,PROT.GSA=0
GSA protocol is deactivated
$PFAL,CNF.Set,PROT.GSM=1
GSM protocol is activated
$PFAL,CNF.Set,PROT.GSV=0
GSV protocol is deactivated
$PFAL,CNF.Set,PROT.IOP=1
IOP protocol is activated
$PFAL,CNF.Set,PROT.RMC=1
RMC protocol is activated
$PFAL,CNF.Set,PROT.START.BIN=$!
BIN protocol starts with ‘$!’.
$PFAL,CNF.Set,PROT.VTG=0
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 18 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
Enables the connection to the remote server and specifies the IP address and the Port number of the TCP
server to connect to.
$PFAL,CNF.Set,TCP.CLIENT.DNS.TIMEOUT=86400
The length of time (in seconds) to keep the DNS cache valid.
$PFAL,CNF.Set,TCP.CLIENT.LOGIN=1
Sends the login data automatically to the remote server after requesting the TCP server for establishing a
connection.
$PFAL,CNF.Set,TCP.CLIENT.PING=1,240000
Activates sending of pings and specifies the amount of time, in milliseconds, on which a ping will be sent
to the remote server.
$PFAL,CNF.Set,TCP.CLIENT.SENDMODE=2
Safe and non-volatile transmission mode.
$PFAL,CNF.Set,TCP.CLIENT.TIMEOUT=300000,30000
Period of time in milliseconds that the device will wait for a response and between two connection
attempts when TCP connection fails.
$PFAL,CNF.Set,GSM.PIN=1111
Enters/saves the PIN code of the SIM card inserted into the device..
$PFAL,GSM.Band=auto
The GSM band to be used by the device is set to ‘auto’. The device registers to that frequency band
currently available. Refer to the PFAL command set for the supported settings.
Factory settings
It consists of configuration settings preloaded at the factory during the manufacturing of FOX3 series
referring to your application (see chapter for more details
Add-ons*
The Promotion Kit is shipped with some sample functions. To extend its functionality, you can refer to the
(define reference GPS points along a specific route where the vehicle should track. Alerts when
devices. The user has the possibility of personalizing this configuration and with the help of
$PFAL,Sys.Device.FactoryReset command it is possible to overwrite the User Settings with the Factory
Settings. After reseting the device to factory settings, the device must be configured in order to operate
setting file „AddOns.conf“ and modify it according to your needs. Please contact support (see chapter 3.2)
for more details about the file „AddOns.conf“.
eCodrive(This feature includes instant and results for driving activities and driver behaviors such as: TripStart /
TripStop / Harsh-Brake / Harsh-Acceleration / Harsh-Turn) - refer to the
Tam per ing Detection of GPS antenna (unplugged / plugged / cut) – Refer to the PFAL command set manual.
Waypoints
Tilting (> 45°) and crash detection (1 x Tilt alert every 15 sec.)
1Wire (iButton + Temp. Sensors)
Supported iButton: DS1402D-DR8+ Blue Dot Receptor iButton Reader Cable with DS1982 iButton and
Supported 1Wire Temp.Sensor: DS18(B)20 (MAXIM). Refer to the
CAN-OBDII (read out some of the supported OBDII raw values). Refer to the
HINT: The user text (in quotation marks “ ”) started with “sfal” indicates an event on our D2Sphere serve. This event text is only
supported on our server, use other text formats for your own server.
CAN-FMS (read out some of the supported FMS parameters). Refer to the
exiting/entering that route)
DS1921 iButton (MAXIM).
Related documents [6]
Related documents [13]
Related documents [4]
Related documents [4]
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 19 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
6 APPENDIX
6.1 How does the FOX3-2G/3G/4G firmware operate?
FOX3-2G/3G/4G device can be easily integrated into a variety of new applications. It contains independentcustomized software that provides even greater performance and flexibility for its users and system
integrators to develop high-performance applications. The concept of the device is based on a simple
implementation for a wide range of applications with low costs and high flexibility. The software enables
you to configure, to track, control and monitor the FOX3-2G/3G/4G device via SMS, as well as allows you
set and poll the configuration remotely over Internet from the remote server. The software comprises a set
of word-like commands termed “PFAL”. Each of these causes the system FOX3-2G/3G/4G either to take a
particular action or to read or set a particular configuration. The software provides the basic configuration
settings needed when the system starts up and is used as starting points for the creation of user
applications. The development of user applications is based on the advanced event-handling features
provided by the operating software. The exact point at which you configure the FOX3-2G/3G/4G unit
depends on your application you want to develop. Events are triggered automatically at system run-time
and manually when the inputs change.
A part of events triggered at system run-time can be:
Geo-fence violations (in/out)
Changes to analog inputs (signal exceeds the range)
Over speed detection (exceeding the speed limits)
Specific distance reached (distance reached event)
Towing detection (park events)
Moving/acceleration detection and many many other features.
A part of events triggered manually can be:
Changes on digital or analog inputs (car' door open/close events, ignition on/off events)
FOX3-2G/3G/4G executes actions in response to an event or state(s) or in any combination. FOX32G/3G/4G can also execute direct actions immediately after the user sends a command (via SMS, TCP, RS-
232) to the device. When an event is triggered, the alarms related to that event are automatically sent
either over GSM (SMS, Data call) and/or via TCP, or internally used to switch On/Off something in remote
e.g. activating a Buzzer.
A part of alarms that can be executed can be:
Message generation (route verification arrival/departure notification via SMS/TCP)
Activation of outputs in a number of ways (activate a buzzer)
Data logging activation (stores the data inside the device)
Handling of incoming messages of any type (Activation on SMS text type
Vehicle doors Lock & Unlock
Vehicle engine starter Disable and Enable
Handling of Timers, Triggers and Counters, and many others
Above are listed just a few software features and for a full view of the set of events, states, alarms,
configurations and their functionalities refer to the Related Documents [1].
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 20 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
There are two installation cables (CA31 and CA69) included in the PROMOTION-KIT. The CA31 is used to
install your FOX3-2G/3G/4G device in a vehicle and additionally to interface FALCOM RFID reader or 3
rd
party products with RS-232 interface via the 4-pin UCOM connector. This cable has an 8pin double row
connector that connects to the FOX3-2G/3G/4G and a 4pin double row connector that connects to one of
the FALCOM accessories or 3
The CA69 is used to test 1-wire interface using your own 1-wire temperature sensors and 3
with RS-232 interface via the 4-pin UCOM connector. Table 7 and Table 8 provide a reference to the colour
codes of these cables. More details about the in-vehicle installation refer to the Related Documents [11].
HINT: When connecting the CA31 to the vehicle wiring, for security reason firstly connect the ground pin to
rd
party products.
rd
party products
the negative pole of the vehicle battery and then the +IN pin to the positive pole. When using a switch
between FOX3-2G/3G/4G and external power source, first turn OFF the switch during the installation and
then turn ON after completing the installation.
The CA27 is used as service cable, which connects to the 8pin main port of one of the FOX3-2G/3G/4G
series device, your PC/Laptop COM port and to the cigarette lighter socket of a vehicle to apply power to
the device. To (re)configure the device install the Workben software.
The CA76 is used as service cable if the 8pin main port or 1
st
serial port of one of the FOX3-2G/3G/4G series
device cann’t be accessed. It connects to the 6pin accessory port and your PC/Laptop COM port. To
(re)configure the device install the Workben software.
The CA123 is used to connect the device to the CAN OBDII connector of your vehicle and apply poer to the
device from this OBDII connector.This cable has also a separate wire which needs to be connected to the
ignition sense of your vehicle for using the Ignition-Sleep mode and trip starts and stops.
Figure 13:Supplied cables (a reference to the colours and pinout is provided in Table 7and Table 8)
The pin function and the colour codes of the CA31 is listed in table below:
RED +IN Input Power supply input.
BLUE IGN Input
and used for trip START and STOP reports
+IN
HIGH≥+10.8 .. +32.0 V DC; LOW = 0V
YELLOW I/O2 Input/Output
GREEN I/O3 Input/Output
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Software configurable pins. They can
operate either as input or output. They have
dual functions as analog or digital inputs.
Page 21 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
4pin UCOM Connector
PURPLE
RxA_0
Input
Serial Port 0 - Receive data
V24, ±12 V
BLACK
TxA_0
Output
Serial Port 0 - Transmit data
V24, ±12 V
RED
+IN
Input
Power supply input.
=+IN
BROWN
GND - Ground.
0V
COLOUR
NAME
DIRECTION
DESCRIPTION
LEVEL
Open end wires
1-Wire master interface for Driver ID,
temperature and humidity sensors.
BROWN
GND - Ground Reference.
0 V
PURPLE
RxA_1
Input
Serial Port 1 - Receive data.
V24, ±12 V
BLACK
TxA_1
Output
Serial Port 1- Transmit data
V24, ±12 V
YELLOW
SCL
Output
I2C bus interface - Serial Clock line
-
GREEN
SDA
Input /Output
I2C bus interface - Serial Data line
-
4pin UCOM Connector
PURPLE
RxA_1
Input
Serial Port 1 - Receive data
V24, ±12 V
BLACK
TxA_1
Output
Serial Port 1- Transmit data
V24, ±12 V
V
= + 10.8 ... + 32.0 V
Imax ≤ 1.5 A
BROWN
GND - Ground.
0V
Table 7: PIN function of the CA31 cable
The pin function and the colour codes of the CA69 is listed in table below:
PINK 1-Wire Input /Output
RED +IN Input Power supply input.
Table 8:Pinout of the CA69 cable
V
= + 2.8 .. +5.0 V
OUT
+IN
The pinout of this cable CA76 is listed in table below:
2x3 MICROFIT DB9 female Description
RX RX Receive data
TX TX Transmit data
GND GND Ground
Table 9:Pinout of the CA76 cable
The pinout of this cable CA123 (OBDII 4Pin Cable) is listed in table below:
2x4 MICROFIT OBDII connector Description
2 5 GND
6 6 CAN_High
5 14 CAN_Low
1 16 V+
3 NC IGN as separate wire
Table 10:Pinout of the CA123 cable
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 22 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
$PFAL,Cnf.Set,GPRS.APN=internet.t-d1.de (enter your provider's APN)
$PFAL,Cnf.Set,PPP.PASSWORD=gprs (if your provider requires)
Settings required for a GPRS attachment
$PFAL,Cnf.Set,TCP.CLIENT.CONNECT=1,2222.222.222.222,1111 (enter your IP and Port)
Settings required for a TCP connection.
1111 - is the TCP port number of the TCP server to be connected;
$PFAL,CNF.Set,TCP.CLIENT.LOGIN=1
Sends the login data automatically to the remote server after requesting the TCP server for
establishing a connection.
$PFAL,Cnf.Set,GPRS.AUTOSTART=1 (default = 0)
Activate GPRS autostart to reconnect automatically when GPRS network connection gets lost.
$PFAL,Cnf.Set,DEVICE.PIN=1111 (enter the PIN of the used SIM card)
Enter the SIM PIN to register the FOX3 device into the GSM network:
Where: 1111 - is the PIN of the inserted SIM card.
6.3 Installing your own SIM card and replacing the internal battery
To insert your own SIM card into the FOX3-2G/3G/4G' SIM holder and replace the internal battery by a new
one, follow the steps represented in figure below:
Figure 14:Inserting you SIM card and replacing the battery by a new one
For more details refer to the Related Documents [2].
When using your own SIM card and another TCP server, the following table shows the basic configuration
settings that should be done in the FOX3 device to register the device in the GSM network and enable
internet connection to your TCP-Server. These configuration settings should be done locally via serial port
connection. After inserting your SIM card and powering up the device, send the following commands
(marked in red) from WorkbenchEditor
$PFAL,Cnf.Set,GPRS.QOS=3,4,3,0,0
SETUP
SETUP
SETUP
$PFAL,Cnf.Set,GPRS.QOSMIN=0,0,0,0,0
$PFAL,Cnf.Set,PPP.USERNAME=t-d1 (if your provider requires)
Where: 2222.222.222.222 - is the IP-address of the TCP server to be connected;
➒ (see Fig. 8) to the FOX3-2G/3G/4G.
SETUP
Table 11:Adapt device configuration settings to your application conditions (mandatory settings).
This confidential document is a property of FALCOM GmbH and may not be copied or circulated without previous permission.
Page 23 of 25
FOX3-2G/3G/4G/-4G-PROMOTION-KIT Getting Started Version 1.0.7
After establishing TCP connection with your remote server, the following ServerLogin data is
automatically sent to your remote server. For more details refer to the Related Documents [1].
$<MSG.Info.ServerLogin>
$<end>
FOX3-2G/3G/4G/-4G
LOGIN DATA TO YOUR
SERVER
Table 12:Login data sent automatically from the FOX3-2G/3G/4G to your remote server when the device starts up.