34
Operation
TFX INSTALLATION AND OPERATION MANUAL
6046279-001 March 2020
Table 34: Geofence definition
Variable
Function
G
EOFEN C E
- M
ODE
0 = Geofence disabled
1 = Geofence enabled, circle center and radius
defined
2 = Geofence enabled, circle center, current
position, and defined radius
3 = Geofence enabled, rectangle
G
EOFEN C E
- C
OOR DINATE
1
> L
ONGITU DE
Longitude for center of the circle or first corner
of the rectangle
G
EOFEN C E
- C
OOR DINATE
1
> L
ATITU DE
Latitude for center of the circle or first corner
of the rectangle
G
EOFEN C E
- C
OOR DINATE
2
> L
ONGITU DE
/ R
A DIUS
Circle radius in meters or longitude for the
second corner of the rectangle
G
EOFEN C E
- C
OOR DINATE
2
> L
ATITU DE
Latitude for the second corner of the rectangle.
GEOFENCE STATUS
With the geofence status, you can trigger an event
internally. The geofence status is updated every 2 seconds.
Every time the geofence status changes, the time is written
to a variable.
The variables belong to the object dictionary group
D
EVI CE
V
ARIA B LES
.
Table 35: Geofence status
Variable
Function
G
EOFEN C E
STATUS
00 = device is outside the fence
01 = device is inside the fence
FF = status unknown (e.g. because
no position data is available)
G
EOFEN C E
- S
TATUS
C
HANGE
UT C
T
IME
Time of geofence-status change
Geofence status
For detailed information on creating objects, see chapter
Creating object dictionary groups and objects.
5.7 Configuring and reading off variables using
the Data platform
You can send special files to the device via the Data
platform to configure or read off variables.
In the following, the files and their structure are described.
NOTICE
Restrictions apply to the file names. See chapter File
transfer restrictions.
OBW FILE
The OBW file (*.obw) writes a value to a variable.
The file has the following structure:
> The line starts with a colon (:).
> Object index (e.g. 0x5353)
> Comma (,)
> Sub-index (e.g. 0x00)
> Comma (,)
> Value to be written to the variable. All number values
(signed / unsigned-integer variables 8 … 32 bits, float 32
bits). The format for floating-point values is “123.45”. You
can use decimal or hexadecimal formats.
NOTICE
Do not use commas (,) or semicolons (;) when
transferring texts.
> Semicolon (;)
> Comment
> End of line <CR><LF>
Several lines can be written in one file. The lines can have
comments. A comment is preceded by a semicolon (;).
Example:
: 0x5353, 0x00, 0; Set File Transfer mode
NOTICE
Function restriction due to faulty OBW file.
It is necessary to check the OBW file.
•
Use a local device with CAN access to test the OBW file
before transmitting it to a remote device.
OBR FILE
OBR files (*.obr) are used to read out a value from a
variable. The device transmits the answer as an OBC file.
The file has the following structure:
> The line starts with a colon (:).
> Object index (e.g. 0x3333)
> Comma (,)
> Sub-Index (e.g. 0x38)
> Semicolon (;)
> Comment
> End of line <CR><LF>
Several lines can be written in one file. The lines can have
comments. A comment is preceded by a semicolon (;).
Example:
: 0x3333, 0x38; Read last error state
OBC FILE
The OBC file (*.obc) is transferred by the device as a
response to the instruction of an OBR file. The file name is
identical to the file name in the OBR file.