Digital Matter Falcon

Digital Matter Falcon is a feature-rich GPS tracker with inputs/outputs and Wi-Fi positioning. The device features LTE-M / NB-IoT connectivity, 3 x AA batteries (up to 7 years battery life),1 analog input, 2 digital inputs, 1 switched ground digital output, I²C (inter-IC communications) interface (commonly used in sensor modules), IP67-compliant casing, and more.

Make your Digital Matter Falcon devices a part of any infrastructure by connecting them via flespi telematics hub. Manage the device settings using flespi device management platform. Learn how to configure Digital Matter Falcon with flespi.

Protocol: digital-matter Manufacturer: Digital Matter Change log: digital-matter

Usage specifics

Parameters (108)

Settings (11)

Commands (3)

AI Assistant

Here’s the like of JSON you get

{
    "ident": "352625333222111",
    "position.altitude": 273.61,
    "position.hdop": 0.7,
    "position.latitude": 49.069782,
    "position.longitude": 28.632826,
    "position.satellites": 18,
    "server.timestamp": 1650636570.426424,
    "timestamp": 1650636570.426424,
    "device.type.id": "Digital Matter Falcon",
    "channel.id": 1111,
    "protocol.id": "digital-matter"
    "engine.ignition.status": true
    ...
}

How to consume this nice JSON

The easiest way is to make a REST API request like this

curl -X GET  --header 'Authorization: FlespiToken XXX' 'https://flespi.io/gw/devices/<device id>/messages'

Explore REST API Show more ways to consume data How to connect my Digital Matter Falcon to flespi

How to send commands to Digital Matter Falcon?

You can send a specific command. Show all commands

You can use pre-defined settings to send instructions more conveniently. Show all settings

You can also

Modify messages

Add or remove parameters, inject data from LBS and reverse-geocoding services, etc.

Learn what plugins can do

Aggregate data

Determine trips and stops, catch events, detect geofence ins/outs, and more.

Learn about flespi analytics capabilities

Name

Type

Unit

Description

Sources

accelerometer.wakeup.number

number

Count of the device has woken up due to the accelerometer experiencing movement

Message type 0x04 with Field ID 21

ain

number

volts

Voltage on the analog input

Message type 0x04 with Field ID 6,
Message type 0x04 with Field ID 7

avg.acceleration

number

Average accelerometer value

Message type 0x04 with Field ID 24

battery.capacity.used

number

Battery Capacity Used

Message type 0x04 with Field ID 21

battery.capacity.used.initial

number

Battery Capacity Used Initial

Message type 0x04 with Field ID 21

battery.level

number

percentage

Internal battery level

Message type 0x04 with Field ID 21,
Message type 0x04 with Field ID 6,
Message type 0x04 with Field ID 7

battery.voltage

number

volts

Internal battery voltage

Message type 0x04 with Field ID 21,
Message type 0x04 with Field ID 6,
Message type 0x04 with Field ID 7

battery.voltage.initial

number

volts

The initial voltage of the device's battery when it is first inserted

Message type 0x04 with Field ID 21

ble.beacons

array

Array with all detected BLE beacons data objects. Each object contain list of associated parameters sent by appropriate beacon. Standard parameter names used: *id* - beacon identification string. Usually it is beacon's UUID or MAC-address *local_name* - Beacons's Local Name *rssi* - BLE signal level. Units = dBm *battery.voltage* - Beacon's battery voltage. Units = volts *battery.level* - Beacon's battery level. Units = percentage *temperature* - Beacon's temperature. Units = celsius

Message type 0x04 with Field ID 29,
Message type 0x04 with Field ID 30

ble.failures.count

number

BLE failures counter

Message type 0x04 with Field ID 21

ble.scans.count

number

BLE scans counter

Message type 0x04 with Field ID 21

ble.uptime

number

BLE uptime counter

Message type 0x04 with Field ID 21

channel.id

number

ID of channel that received a message

counter.rx.range

number

Received power range from the device

Message type 0x04 with Field ID 21

counter.tx.power

number

Transmit power since battery were inserted

Message type 0x04 with Field ID 21

counter.uploads

number

The number of successful data uploads since the battery were inserted

Message type 0x04 with Field ID 21

counter.uploads.failed

number

The number of failed data uploads since the battery were inserted

Message type 0x04 with Field ID 21

counter.uploads.failed.time

number

seconds

counted time of failed upload attempts to the endpoint

Message type 0x04 with Field ID 21

counter.uploads.time

number

seconds

The counted time for uploading the data to the endpoint

Message type 0x04 with Field ID 21

debug.info

string

Debug event description

Message type 0x04 with Field ID 1

debug.level

string

Debug event level

Message type 0x04 with Field ID 1

debug.module.id

number

Debug event module id

Message type 0x04 with Field ID 1

device.firmware.version

string

Firmware revision

device.id

number

ID of device that received a message

device.name

string

Name of device that received a message

device.run.time

number

seconds

Device run time

Message type 0x04 with Field ID 27,
Message type 0x04 with Field ID 27 with Field ID 12

device.serial.number

string

Device serial number

device.state.bitmask

number

Device state bitmask

Message type 0x04 with Field ID 2

device.temperature

number

celsius

Temperature of device

Message type 0x04 with Field ID 6,
Message type 0x04 with Field ID 7

device.temperature.max

number

celsius

Max temperature value since the device has been started

Message type 0x04 with Field ID 21

device.type.id

number

ID of device type of device that received a message

device.uptime

number

seconds

Time in seconds since last device power on

Message type 0x04 with Field ID 21

din

number

Digital inputs bitmask

Message type 0x04 with Field ID 2

dout

number

Digital outputs bitmask

Message type 0x04 with Field ID 2

engine.ignition.status

boolean

Engine ignition or ACC status

Message type 0x04 with Field ID 2

event.enum

number

Protocol-specific event code

Message type 0x04 with Field ID 1

external.battery.voltage

number

volts

External battery voltage

Message type 0x04 with Field ID 6,
Message type 0x04 with Field ID 7

external.powersource.status

boolean

External power source connection status

Message type 0x04 with Field ID 2

gnss.average.failed.fix.duration

number

seconds

Average Failed GPS Fix Time

Message type 0x04 with Field ID 21

gnss.average.fix.duration

number

seconds

Average Successful GPS Fix Time

Message type 0x04 with Field ID 21

gnss.average.refresh.time

number

seconds

Average GPS Freshen Time

Message type 0x04 with Field ID 21

gnss.position.fixes

number

The number of successful positions that the device has validated since the battery were inserted

Message type 0x04 with Field ID 21

gnss.position.fixes.failed

number

The number of failed positions since the battery were inserted

Message type 0x04 with Field ID 21

gnss.position.fixes.failed.time

number

seconds

Accumulated time spent trying to get the a GPS fixes, but failed

Message type 0x04 with Field ID 21

gnss.position.fixes.time

number

seconds

Accumulated time spent getting the successful GPS fixes

Message type 0x04 with Field ID 21

gnss.refresh.attempts

number

Count of the device has tried to refresh the GPS position

Message type 0x04 with Field ID 21

gnss.refresh.duration

number

seconds

Time spent doing a refresh the GPS position

Message type 0x04 with Field ID 21

gnss.sniffing.data.hex

string

This data field contains the results of a GNSS scan by the device

Message type 0x04 with Field ID 32

gsm.arfcn

number

Absolute radio-frequency channel number of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)

Message type 0x04 with Field ID 33

gsm.cellid

number

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) base station ID

Message type 0x04 with Field ID 28,
Message type 0x04 with Field ID 33,
Message type 0x04 with Field ID 36

gsm.cellid.physical

number

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) physical base station ID

Message type 0x04 with Field ID 36

gsm.cell.type

string

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) physical base station type

Message type 0x04 with Field ID 36

gsm.earfcn

number

E-UTRA absolute radio-frequency channel number of the Mobile network (LTE)

Message type 0x04 with Field ID 36

gsm.lac

number

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) location area code

Message type 0x04 with Field ID 28,
Message type 0x04 with Field ID 33,
Message type 0x04 with Field ID 36

gsm.mcc

number

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) country code

Message type 0x04 with Field ID 28,
Message type 0x04 with Field ID 33,
Message type 0x04 with Field ID 36

gsm.mnc

number

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) code

Message type 0x04 with Field ID 28,
Message type 0x04 with Field ID 33,
Message type 0x04 with Field ID 36

gsm.network.status

boolean

Registration status in the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)

Message type 0x04 with Field ID 2

gsm.network.type

string

The type of the Mobile network the device is currently registered to

Message type 0x04 with Field ID 36

gsm.network.type.enum

number

GSM Network type. 0: CAT-M1 cell towers, 1: NB-IoT cell towers

Message type 0x04 with Field ID 33

gsm.pcid

number

Physical layer Cell ID in the Mobile network (LTE and NR)

Message type 0x04 with Field ID 33

gsm.signal.quality

number

The quality (bit error rate) of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...) signal

Message type 0x04 with Field ID 6,
Message type 0x04 with Field ID 7

gsm.sim.iccid

string

Integrated Circuit Card Id of SIM card of the Mobile network (GSM, 3G, 4G, LTE, 5G, ...)

gsm.timing.advance

number

Mobile network (GSM, 3G, 4G, LTE, 5G, ...) timing advance

Message type 0x04 with Field ID 33,
Message type 0x04 with Field ID 36

gsm.timing.difference

number

GSM timing difference

Message type 0x04 with Field ID 33,
Message type 0x04 with Field ID 36

hardware.version

string

Hardware version

ibutton.code

string

Hexadecimal code of connected iButton

Message type 0x04 with Field ID 3

ident

string

Device unique identifier like serial number, IMEI, etc

jostle.position.fixes

number

Count of position updates due to Jostle based Tracking (accelerometer based instead of movement based)

Message type 0x04 with Field ID 21

jostle.position.fixes.uploads

number

Count of uploads due to Jostle based Tracking (accelerometer based instead of movement based)

Message type 0x04 with Field ID 21

loaded.battery.voltage

number

volts

Loaded battery voltage

Message type 0x04 with Field ID 6,
Message type 0x04 with Field ID 7

max.acceleration

number

Maximum accelerometer value

Message type 0x04 with Field ID 24

max.acceleration.duration

number

seconds

Peak G force

Message type 0x04 with Field ID 24

network.signal.rspq

number

dbm

Reference Signal Received Quality

Message type 0x04 with Field ID 33,
Message type 0x04 with Field ID 36

network.signal.rsrp

number

dbm

LTE reference signal received power (RSRP)

Message type 0x04 with Field ID 33,
Message type 0x04 with Field ID 36

peer

string

IP:port from which device connecting to the channel

pin.4.digit

string

4 digit PIN

Message type 0x04 with Field ID 3

pin.5.digit

string

5 digit PIN

Message type 0x04 with Field ID 3

position.accuracy

number

meters

Position data accuracy in meters

Message type 0x04 with Field ID 0

position.altitude

number

meters

Altitude value for position

Message type 0x04 with Field ID 0

position.direction

number

degrees

Heading angle at position detection moment

Message type 0x04 with Field ID 0

position.fix.type

number

GNSS fix type enum (0 = "not fixed", 1 = "2D", 2 = "3D", null = "unknown")

Message type 0x04 with Field ID 0

position.latitude

number

degrees

Latitude coordinate value

Message type 0x04 with Field ID 0

position.longitude

number

degrees

Longitude coordinate value

Message type 0x04 with Field ID 0

position.pdop

number

Position dilution of precision

Message type 0x04 with Field ID 0

position.speed

number

km/h

Instant speed at position detection moment

Message type 0x04 with Field ID 0

position.timestamp

number

seconds

Timestamp when coordinates where calculated

Message type 0x04 with Field ID 0

position.valid

boolean

Is position information accurate and valid for given timestamp

Message type 0x04 with Field ID 0

protocol.id

number

ID of protocol

record.seqnum

number

Registered record sequence number

Message type 0x04

report.reason

number

Transmission reason code

Message type 0x04

rfid.code

string

Hexadecimal code of connected RFID

Message type 0x04 with Field ID 3

rtc.timestamp

number

seconds

RTC (real-time clock, device time) timestamp

Message type 0x04

server.timestamp

number

seconds

Timestamp when server received a message

tamper.alarm

boolean

Tamper alarm event

Message type 0x04 with Field ID 2

timestamp

number

seconds

Message timestamp

Message type 0x04

trip.average.wakeup.number

number

Average Wakeups Per Trip

Message type 0x04 with Field ID 21

trip.duration

number

seconds

Trip duration

Message type 0x04 with Field ID 26

trip.id

number

Trip ID increasing every engine-ON event

Message type 0x04 with Field ID 21

trip.mileage

number

Distance driven since engine start

Message type 0x04 with Field ID 26

trip.movement.trim.duration

number

seconds

Movement trip trimming amount

Message type 0x04 with Field ID 15

trip.state.enum

number

Trip status

Message type 0x04 with Field ID 15

trip.status

boolean

Trip status, true if trip started, false - if stopped

Message type 0x04 with Field ID 2

vehicle.odometer

number

Vehicle mileage in base units configured in device (km, miles, 100m etc)

Message type 0x04 with Field ID 27

wifi.channel

number

WiFi channel number

Message type 0x04 with Field ID 25

wifi.failed.scans

number

Count of failed Wi-Fi scans

Message type 0x04 with Field ID 21

wifi.mac.address

string

WiFi MAC address

Message type 0x04 with Field ID 25

wifi.signal.strength

number

WiFi signal strength, RSSI

Message type 0x04 with Field ID 25

wifi.successful.scans

number

Count of successful Wi-Fi scans

Message type 0x04 with Field ID 21

Title

Name

Description

Properties

Upload accident data partition

accident_data

Switches the device between normal and recovery modes, with a timeout parameter that reverts it to NORMAL mode after a set period during recovery

partition: Partition control

Request configuration from OEM

config_oem

Connect to the OEM for config after disconnecting from server.

Delete all System Parameters

delete_all_system_parameters

This message deletes all system parameters from the system

Immobilise

immobilise

Change state of any immobiliser outputs.

value: immobiliser

Modem Reset

modem_reset

Quickly resets the modem, enabling firmware updates and network deregistration, useful for always-connected devices

Set Odometer

odometer

Set the onboard device odometer

value: Odometer value

Set Operational Mode

operational_mode

Switches the device between normal and recovery modes, with a timeout parameter that reverts it to NORMAL mode after a set period during recovery

mode: Mode

time: Time after which the mode should be cancelled

Remote Reset

remote_reset

Resets the unit post-"Deliver Async Message Response," ignoring previous connect commands by forcing a server disconnect and immediate device reset

Set Run Hours

run_hours

Set the onboard device run hours

value: Run hours value

Send message

send_message

Send a message to the device

message: Message text

Set and enable SIM PIN

sim_pin

This message sets and enables the SIM PIN. The new PIN is built into the device at production and is available on the OEM Server Admin Interface. The old PIN is assumed to be disabled. The old PIN is required when setting the new PIN, so the old PIN is specified by the sender and sent down in the async request.

pin: SIM PIN

Title

Name

Description

Properties

Custom async command

custom

Send custom async command to device

cmd_body: Async Message Body

cmd_type: Async Message Type

Delete a System Parameter

delete_system_parameter