File Formats

A configuration file (CONFIG.TXT) can be used to configure a device for specific use cases. It lists AT-commands line by line. Please read the command reference for more details.

Data files contain both a device ID tag and a number in their name. The ID tag consists of the last four literals of the LoRaWAN DEVEUI. The number indicates device restarts. With every restart, the number is increased by one. In this way, data doesn't get overridden or appended unexpectedly.

Example directory listing: - ABCD_001.LOG - ABCD_001.POS - CONFIG.TXT

Generally, the following file types can be recorded by trackers:

Data Files
- .POS – CSV file. Position data and IMU averages
- .IMU – CSV file. Real-time IMU sample data
- The data files provide the full device ID (DEVEUI) in the first row of the file
Log Files
- .LOG – Text file. Provides valuable information for support

Position Data File

The .POS file contains the GPS position data of the device and some other metadata

Example .POS file snippet:

E6305F324C67969A

TIME RTC	TIME GPS	FIX TYPE	LAT	LONG	ALT	HDOP	VDOP	SATELLITES	TTF	UPTIME	TEMP MCU	AX MEAN	AX VAR	AY MEAN	AY VAR	AZ MEAN	AZ VAR	V BAT
UTC	UTC	ENUM	deg	deg	m				s	s	deg C	G	G2	G	G2	G	G2	V
ISO8601	ISO8601	int	float	float	float	float	float	int	int	float	float	float	float	float	float	float	float	float
20000101T000052Z	00000000T000000Z	0	0.000000	0.000000	0.000000	0.000000	0.000000	0	0	0.000000	0.000000	-0.150332	0.030555	-0.742760	0.003693	0.651593	0.023955	3.663000

This file can be imported into the Wonderland platform, as illustrated in the screenshot below: [image]

Time Information

Field	Unit	Datatype	Description
TIME RTC	UTC timestamp	ISO8601 or int	real-time clock timestamp in ISO8601 format or unix-time
TIME GPS	GPS timestamp	ISO8601 or int	real-time clock timestamp in ISO8601 format or unix-time

Positioning Data

Field	Unit	Datatype	Description
FIX TYPE	enum	int	GPS fix type (0: invalid, 1: GPS, 2: SBAS)
LAT	°	float	WGS84 latitude
LON	°	float	WGS84 longitude
ALT	m	float	WGS84 altitude
HDOP	1	float	horizontal dilution of precision
VDOP	1	float	vertical dilution of precision
SATELLITES	1	int	number of satellites in view
TTF	s	int	time to fix

System Metrics

Field	Unit	Datatype	Description
UPTIME	s	int	GPS activity time
TEMP MCU	°C	float	device temperature
V BAT	V	float	batery supply voltage

Accelerometer Statistics

Mean and variance values for X, Y, and Z axes (in G and G²). The device requires an IMU to provide this data type.

Field	Unit	Datatype	Description
AX MEAN	G	float	x acceleration mean
AX VAR	G²	float	x acceleration variance
AY MEAN	G	float	y acceleration mean
AY VAR	G²	float	y acceleration variance
AZ MEAN	G	float	x acceleration mean
AZ VAR	G²	float	z acceleration variance

Data Import on Wonderland

The position file can be imported into the Wonderland platform, as illustrated in the screenshot below: [image]

Realtime IMU Data File

This file records inertial measurement unit (IMU) sampling data and includes the following fields:

Field	Unit	Datatype	Description
TIME RTC	UTC timestamp	ISO8601 or int	real-time clock timestamp in ISO8601
format or unix-time
FIFO TIME	µs	int	High-resolution IMU sample timestamp
TEMP IMU	°C	int	Temperature of the inertial measurement unit
ACC X	G	float	Acceleration along the x axis
ACC Y	G	float	Acceleration along the y axis
ACC Z	G	float	Acceleration along the z axis
GYR X	G	float	Angular velocity around the x axis
GYR Y	G	float	Angular velocity around the y axis
GYR Z	G	float	Angular velocity around the z axis

Example .IMU file snippet:

E6305F324C67969A

## LOG Files (.LOG file)

The `.LOG` file provides debugging information throughout the deployment. It contains the configuration log and captures a complete device boot and lifecycle: configuration loading, LoRaWAN network joining, IMU initialization, and SD card data logging.

Example of the `.LOG` file:

AT Command : Configuration Property : Value

AT+TX_INTERVAL_SEC : normalTxInterval_seconds : 60 AT+TX_STANDBY_MIN : standbyTxInterval_minutes : 15 AT+PERIOD : measureInterval_minutes : 15 - : sendLastItemFirst : 1 AT+OP_MODE : measurementEnabled : 1 + : syncMesurementIntervalToHour : 0 - : ledDisabled : 0 - : enable_imu : 1 - : enable_sdcard : 1 - : enable_imu_log : 1 AT+SD_PERIOD_SEC : samplingInterval_seconds : 15 - : firmware_version : 0.1.0.ffff-devel AT+TPERIOD : terminatedMeasureInterval_minutes : 0, 0, 0 ```