Unlocked vs Locked Devices

Published January 25th, 2023 by Matthew Clark-Massera

The final integration option as presented in the article on  choosing integration strategy allows for devices to bypasses the OEM Server which allows the device to connect to a system other than OEM. Once a device is unlocked - it cannot be used with a connector to send data as per options 2 or 3 of the integration strategies. .  Devices that are co

Delayed Uploads on Hard-Wired Devices

Published January 25th, 2023 by Matthew Clark-Massera

Apart from general connectivity issues (such as limited coverage and network congestion) causing upload delays, certain events like frequent input switching (see example below) can cause delays in transmission. A good example that often worries partners is experiencing delays when the External power (VExt) input quickly changes between multiple stat

Turn on Debug Logging

Published January 25th, 2023 by Matthew Clark-Massera

Devices hold debug verbosity settings. This controls how many debug records are logged. The setting can specify 4 different levels for a number of device modules (GPS, GSM, Accelerometer, etc). The 4 levels are: Info: maximum information; highest data usage; only use this level if you are debugging a problem (eg. movement threshold crossed; starting

Hawk Introduction and Concepts

Published January 26th, 2023 by Matthew Clark-Massera

The Hawk is a rugged and robust IoT datalogger for a wide range of sensor and condition monitoring applications.  Hawk Introduction Your browser does not support HTML5 video. The Hawk Lite vs the Hawk Pro The Hawk Lite is a version of the Hawk Pro that is compatible with low-voltage Alkaline batteries, as opposed to the high-energy LTCs and recharge

Guppy Tilt - Small Changes from Vertical

Published January 31st, 2023 by Matthew Clark-Massera

The tilt reporting feature in the Guppy, as of firmware v1.9, is explained in the Guppy Configuration and Usage Guide. Here are some examples illustrating small changes from vertical/straight up. This could be useful for checking an electrical box is still mounted correctly on a pole. Straight up: Starting in the straight up, or vertical, position.

Guppy LoRaWAN® Configuration Application

Published January 31st, 2023 by Matthew Clark-Massera

Please download and install the Windows application from here: https://www.oemserver.com/tools/GuppyLoRaWAN/ConfigTool/setup.exe

Oyster LoRaWAN® Battery Recommendations

Published January 31st, 2023 by Matthew Clark-Massera

The Oyster LoRaWAN device will run on 1.5V AA batteries. The maximum input voltage is 5.5V. The battery holder places the batteries in series, so the cell voltages add. This implies: LTC 3.7V batteries cannot be used. This will result in a total voltage that will damage the product. 1.5V AA Lithium Iron Disulphide batteries are recommended. An examp

SensorData LoRaWAN® Payload Examples

Published January 31st, 2023 by Matthew Clark-Massera

This article works through some example payloads sent by the SensorData LoRaWAN. Example 1: Soil Moisture and Temperature Port: 128. Payload: 05786477654682155A595E6061 This decodes to: 128 - Data field ID (SDI-12 Measurement 1) 05 - Soil Moisture, 5 data points 78 (120) = 55% 64 (100) = 45% 77 (119) = 54.5% 65 (101) = 45.5% 46 (70) = 30% 82 (130) -

Oyster2 - Getting Started

Published February 1st, 2023 by Matthew Clark-Massera

The Oyster2 is a compact, rugged GPS tracking device that has been designed for tracking containers, trailers, skip bins, and other assets where super-long battery life is required without sacrificing the frequency of updates and performance. This getting started guide is only for the Oyster2 cellular version which comes in 2G or 4G Cat-M1/Nb-IoT. T

Forward LoRaWAN (non-Edge) device data to Telematics Guru via TTN (v3)

Published January 27th, 2023 by Matthew Clark-Massera

This guide covers how to configure TTN to forward Digital Matter LoRaWAN® device data to Telematics Guru.  NB: For DM 'Edge' devices like the Yabby Edge, there is a different process - see Setting up a Yabby Edge LoRaWAN Device via TTN (v3) 1. Add an HTTP Integration to Telematics Guru Select your application, then click Integrations, then Webhooks 

Teltonika Device Setup

Published January 27th, 2023 by Matthew Clark-Massera

Telematics Guru supports reading data from Teltonika Devices Codes 8, 8E and 16 are supported, check with Teltonika which code your specific device uses Not all device types are tested. Test thoroughly before committing to a large deployment. The below device types have been reported working by our partners: FM1120 FMC130 FMC125 FMB920  Not all data

LoRaWAN Integration - Telematics Guru

Published January 27th, 2023 by Matthew Clark-Massera

Networks Currently Supported by TG The list below are the current networks that Digital Matter has integrated into Telematics Guru.  Helium Connecting to Telematics Guru over Helium (non-Edge) Setting up a Yabby Edge LoRaWAN Device via Helium The Things Network Forward LoRaWAN (non-Edge) device data to Telematics Guru via TTN (v3) Setting up a Yabby

Decoding the Yabby 3 LoRaWAN® Uplink

Published January 31st, 2023 by Matthew Clark-Massera

You can find the full payload specification here and decoder below, and the uplink decoder below. Yabby 3 LoRaWAN Uplink Decoder This decoder is written in Java Script and may be freely used as example code. To inspect the code in a different tab, open this link and inspect the Java Script source. Usually this is done with F12 in your browser.  ifra

Integration with the Azure IoT Hub

Published January 25th, 2023 by Matthew Clark-Massera

Our  Choosing an Integration Strategy  article covers the different ways to receive device data.Some users wish to make use of the Azure IoT Hub to receive data.The OEM Server supports this via the use of the HTTP Connector (option 3 in the integration strategy article) Set Up Users can configure data to be sent to their IoT Hub instance via our Azu

The Location Engine - Key Concepts

Published January 31st, 2023 by Matthew Clark-Massera

Digital Matter provides its OEM Server Device Management platform as a web-based platform solution for partners to manage devices over-the-air (OTA).  Digital Matter has developed the Location Engine (LE) as a module of OEM Server to perform server-side processing of device data for devices that use alternative low-power techniques, like the ‘Edge’

Oyster3 LoRaWAN® Network Server Integrations

Published February 2nd, 2023 by Matthew Clark-Massera

Telematics Guru supports multiple LoRaWAN Network Server integrations. This guide lists the integration options. Please see the links for a detailed guide on how to setup the Oyster3 LoRaWAN on the respective LoRaWAN network platforms.  The Things Network v3 Actility Helium Senet Hiber MachineQ As an example, please use the below Device URL (Machine

Setting up Direct to 3rd Party Server messaging on devices

Published January 25th, 2023 by Matthew Clark-Massera

Proceed with Caution! OEM Server provides several key functions (like GNSS aiding data downloads to devices) which are critical to device performance. See Direct to 3rd Party Server integration - Considerations to make sure you are aware of the implications   Our devices have flexible integration options to suit a variety of requirements. You contro

Bluetooth® Getting Started - Tags & Scanning

Published January 27th, 2023 by Matthew Clark-Massera

Visit our website for a quick explanation of the use of Bluetooth® in our device range and the applications that it enables. In regards to Bluetooth® firmware and devices, it is critical that you upgrade to the latest firmware version and the latest Bluetooth® version. Later releases of device firmware may not be compatible with all versions of Blue

Admin Actions FAQs

Published January 26th, 2023 by Matthew Clark-Massera

Can a client create other user logins for their organisation? Yes, if their account if set up with permission to create new users. this permission can be found in Admin >> Users >> Edit and under the permission tab. (shown below) How do you reset a password? There are three ways to reset a password; changing your password while logged in

Duration Condition for Alerts

Published January 26th, 2023 by Matthew Clark-Massera

DM has released a "Duration" condition for alerts. Below is an example of an alert set up to monitor if a door is open for over 10 minutes. A reed switch is connected to the digital input on the device for monitoring. There are some caveats to this alert, as Alerts are driven by the device Telemetry, and when a new record comes in, it is processed t

Oyster 3 LoRaWAN® Firmware Release Notes

Published February 2nd, 2023 by Matthew Clark-Massera

v1.5 Improved accelerometer robustness v1.4 Corrected battery self-discharge calculation scaling, which was 33% too high Corrected battery level reported by MAC command, which showed 33% too much remaining capacity Corrected battery low indication on LTC batteries, which triggered too late Optimized battery life when trip-tracking while the network

Oyster3 - FAQ

Published January 31st, 2023 by Matthew Clark-Massera

How long will the batteries last on my Oyster3-4G (LTE-M/NB-IoT)? Short answer: Up to 10 years at 1 daily update. Around 3.5 - 7 years generally with other configurations and applications.         Long (more accurate) answer: It depends on many things, see  here  for details along with a battery life calculator.      How do I change the update rate?

Yabby LoRaWAN® Config Cable

Published January 31st, 2023 by Matthew Clark-Massera

The Yabby LoRaWAN device is configured with a USB cable and a special Tag-Connect adapter. Be sure to plug the Tag-Connect adapter pins into the Yabby PCB where it says "UART1". The USB part of the cable is the same as the config cable for the Guppy and Oyster LoRaWAN. The specification for that cable is here. It is an FTDI USB-TTL 3.3V cable. Due t

Decoding The Oyster Sigfox Payload - Javascript example code

Published January 27th, 2023 by Matthew Clark-Massera

Click this link to check out the Oyster Sigfox on the Digital Matter Website . Below is some code that will allow you to parse the body of the Sigfox message. e.g. parseSigFox('10b67dcc0006efda3d9816c2') Note: All the code is also in the attached js file. To start off with, you would need to decipher which message is being transmitted by looking at

IoT Devices - Schedules

Published January 27th, 2023 by Matthew Clark-Massera

Out of the box, the SensorData/SensorNode is not configured to take any readings, and must be first configured by setting up schedules. Currently, there can be up to 5 different schedules, each with 4 items, which represent a single data source (analog input reading, GPS position, battery voltage, etc). Each schedule is completely independent, but i

Shipping of DM Devices and Batteries

Published January 27th, 2023 by Matthew Clark-Massera

Some partners may want to ship devices to their customers with batteries and SIM cards inserted. This reduces the chance of end users mishandling the devices, or not provisioning the devices correctly. It can help to ensure devices will be working correctly when they are received - rather than relying on the correct process being followed.  This art

Disabling Devices

Published January 27th, 2023 by Matthew Clark-Massera

Sometimes, users wish to completely disable/deactivate a device. i.e. - they want to install it in an asset, and only 'turn on' the tracking (and subscription cost) some time later. In general it's best to simply install a device at the time we wish to start using it. Disabling a device is not as simple as it may seem. Our devices are embedded devic

Tamper Detect on the Remora

Published February 2nd, 2023 by Matthew Clark-Massera

The Remora range features Magnetic Tamper Detection. This allows the device to wirelessly detect that it has been detached from the asset. The device works with a magnet that should be firmly glued to the asset. The Remora is fitted over the magnet, aligned with the circular recess in the housing. The device detects the magnetic field. If the field

Remora2 - Getting Started

Published February 2nd, 2023 by Matthew Clark-Massera

The Remora, redesigned and supercharged! The Remora2 is an IP67 rated, rugged 4G Cat-M1/Nb-IoT GPS device designed for tracking non-powered assets where super-long battery life is required without sacrificing the frequency of updates and accuracy performance. digitalmatter.com See the product page on our website for more specifications. Datasheet &a

Eagle Bluetooth Firmware Release Notes

Published January 27th, 2023 by Matthew Clark-Massera

v2.3 - Fixed issue with large tag lists not showing all tags - Fixed ELA ID appearing as an ELA MOV tag type v2.2 - Integrated ELA Frames: ID, ANG, MOV MAG, T & RHT. - Individual tag update logs can now be enabled. These logs are triggered when certain tag data changes. (only for ELA tags MOV & MAG) v2.1 - Fixed issue where tag expiry time w

Dart3 FAQ

Published January 26th, 2023 by Matthew Clark-Massera

How do I install the device?  How the device is ultimately installed is dependant on the application. E.g. Are inputs to monitor duress buttons/PTOs etc required? Is driver ID/Immobilisation required See the following guides. Elements of each may be required for your specific application 3-Wire Install - [Dart3] Monitor a PTO/Fuel Pump - Dart3 Set U

Driver Fatigue Monitoring

Published January 26th, 2023 by Matthew Clark-Massera

Device Firmware Version Dart3-2G, Dart3-4G, Dart3-4G Bluetooth®, Dart3 Global Bluetooth® All Versions G120-2G and G120-4G All Versions G150-Global All Versions G70-2G, G70-4G, G70-4G Bluetooth® All Versions Hard-wired devices have the capability to buzz and/or set a digital output after a period of time in trip. Overview When a trip starts, the warn

Telematics Guru - ALR Guide

Published January 26th, 2023 by Matthew Clark-Massera

Telematics Guru ALR (Asset Location and Recovery) is a simplified version of Telematics Guru providing tracking essentials at an excellent price point. It is intuitive, easy to use and has been carefully designed to deliver the information you need when you need it. Note If this is your first-time using Telematics Guru, please make sure you read the

Why was my Alert delayed?

Published January 26th, 2023 by Matthew Clark-Massera

It is important to understand how Alerts operate. Alerts are handled by Telematics Guru, and not the device. They do not impact the device operation, or force uploads. (Devices can be configured to upload on certain conditions via OEM server however)  For an alert email or SMS to be sent, the device data must be received by Telematics Guru, which th

Checklists in Telematics Guru

Published January 27th, 2023 by Matthew Clark-Massera

The Telematics Guru App supports completing checklists. The app and TG system can be used to easily collect, store and review checklist data - replacing paper checklists. This saves effort and resources in collecting and filing paper checklists - a huge task for many businesses! If you have not used the checklist functionality before, you might not

Mounting and Installation - [Remora3]

Published January 31st, 2023 by Matthew Clark-Massera

The Remora3 can be mounted on the asset to be tracked using screws, bolts, cable ties, magnets, or industrial adhesives. When choosing a mounting point, you have two competing goals: To minimize the chances of the device being accidentally crushed, dislodged or discovered by a thief To maximize the GPS and mobile reception and provide adequate venti

Trip Region Report

Published January 26th, 2023 by Matthew Clark-Massera

Telematics Guru has a report titled "Trip Region Report". The report will break it down to record the mileage that the device has travelled per region. This is beneficial for IFTA reporting in the US to provide mileage per each state the asset has travelled but can be used for other regions as well.  Devices will need to be in TG-Pro as the address

Falcon Cellular - Configuring Wi-Fi Lookups

Published January 27th, 2023 by Matthew Clark-Massera

The Falcon is the first product to offer a hybrid of GPS and Wi-Fi location acquisition. As a result, it is important to ensure the device is configured to provide the latest location data in a way which accommodates your intended integration strategy. Location Data The Falcon will always send the most recently obtained location data. Should you hav

DM Digital Input to MyGeotab Aux Mappings

Published January 25th, 2023 by Matthew Clark-Massera

The Digital Matter devices use Digital Inputs to show physical inputs (ignition, input 1, etc) and statuses (battery low, external power low etc). The MyGeotab 3rd party API allows these inputs and statuses to be mapped to Auxiliaries. There are 8 Auxiliaries available. This describes those mappings: Input or Status Name Digital Matter Location Mapp

Changing the Update Rate - [Yabby3]

Published January 31st, 2023 by Matthew Clark-Massera

The Yabby3 has different configurable tracking modes to best fit a variety of applications. Additionally, if an asset is stolen, the unit can be put into Recovery Mode, where the unit will live-track with an increased update rate for a configured time period, to aid in asset recovery.  The below recordings show how to quickly and easily configure th

Initial Provisioning- Remora3

Published January 31st, 2023 by Matthew Clark-Massera

This guide is intended to assist new users in getting the Remora3 online for the first time. Once you have some experience with the device, this process may change slightly. E.g. you may wish to queue firmware and parameter updates before inserting a SIM and batteries - so that the device picks up new settings once it gets online. 1. In the Box The

Remora2 - Product Change Notifications

Published February 2nd, 2023 by Matthew Clark-Massera

2020.10.27 - UVLO Firmware Change

Technical Drawing - Barra Range

Published April 29th, 2024 by Matthew Clark-Massera

See attached Barra housing drawing - providing external dimensions. Barra Screw Housing.pdf

Initial Provisioning - Oyster3

Published January 31st, 2023 by Matthew Clark-Massera

This guide is intended to assist new users in getting an Oyster3 online for the first time. Once you have some experience with the device, this process may change slightly. e.g you may wish to queue firmware and parameter updates before inserting a SIM and batteries - so that the device picks up new settings once it gets online. In the Box You will

Telematics Guru Telemetry - Getting Started

Published January 26th, 2023 by Matthew Clark-Massera

Telemetry Status Flags are represented in the left most 8 bits 31 30 29 28 27 26 25 24 Recovery Mode Active Tamper Alert (Remoras) External Power Enabled Shunting power from battery Connected to GSM External Power Good Internal Battery good Trip Status Digital Inputs of the device are represented in the remaining 24 bits, Bits 0, 6 and 6 are commonl

Yabby3 - FAQ

Published January 31st, 2023 by Matthew Clark-Massera

How long will the batteries last? Short answer: Up to 10 years at 1 daily update. Around 1.5 - 3 years generally with other configurations and applications.     Long (more accurate) answer: It depends on many things, see here for details along with a battery life calculator.      How do I change the update rate? See  How to change the Update Rate -

Default Tracking Parameters - [Remora3]

Published January 31st, 2023 by Matthew Clark-Massera

By default, the Remora3 is setup for GPS-based movement tracking. The following default settings apply: Update Rate: Out of Trip (stationary): 12 hour heartbeats. This is a GPS point and an upload every 12 hours. In Trip (on the move): Upload on trip start. GPS points every 2 minutes Upload every 30 minutes End a trip after 5 minutes of no movement

SigfoxInvalid PAC Code

Published January 27th, 2023 by Matthew Clark-Massera

When adding a device to the Sigfox back end, the PAC code is used as a security precaution. The knowledge of both the Sigfox ID and PAC code goes some way to verify that the device is in the possession of the person adding it to the back end. Sigfox ID: a 6 to 8 character hexadecimal number. Eg. SIGFOX ID: 21F657 PAC Code: a 16 character hexadecimal

Configuring Forwarders

Published January 31st, 2023 by Matthew Clark-Massera

What are Forwarders? Forwarders are a construct within Device Manager for routing enriched location data from Edge devices to its final destination in an IoT software platform. Edge devices must first send raw data to Device Manager, which then sends it onwards to the Location Engine using a Connector. Once processed within the Location Engine, a Fo

TG - Asset Billing, Admin and Billing Reports

Published January 26th, 2023 by Matthew Clark-Massera

Asset Billing It is important for partners to note that billing is according to Active Assets. An asset will be billed under the following conditions: An asset is active in an organisation, for any length of time, in a given month (i.e. not disabled)  AND it has a serial number AND it has connected at least once after adding to the manage assets pag

Connectivity - LTE-M vs NB-IoT, Coverage, Providers and Roaming

Published January 24th, 2023 by Matthew Clark-Massera

Many countries and network operators globally have rolled out or are in the process of rolling out LTE-M/NB-IoT networks.  We refer to LTE-M, but it is often also called Cat-M1 NB-IoT is sometimes called NB1 LTE-M/NB-IoT networks fall under the umbrella of 4G/5G - they are formally recognised under each category. 3G/4G/5G etc. refers to a 'generatio

Which Countries Offer Speed Lookup in TelematicsGuru?

Published January 26th, 2023 by Matthew Clark-Massera

When using the TG-Pro asset subscription you can expect speed data from the below countries: Albania Andorra Angola Australia Austria Bahrain Belgium Botswana Brunei Darussalam Bulgaria Burundi Cabo Verde Canada Croatia Cyprus Czechia Denmark Egypt Estonia Finland France Germany Ghana Gibraltar Greece Hungary India Iceland India Indonesia Ireland (R

Times in the DM Protocol

Published January 25th, 2023 by Matthew Clark-Massera

This article gives some useful information about how times are sent in the Digital Matter cellular device protocol. For more detail on the protocol, request the integration documents from your local Digital Matter support contact. Format Times are sent as a count in seconds since midnight (00:00:00) 1 January 2013. This can be considered the Digital

First Start - Barra GPS

Published April 29th, 2024 by Matthew Clark-Massera

Let's assist you in getting a Barra GPS online for the first time. In the Box You will get a compact box containing the Barra. The 8 housing screws will be in a small packet inside the housing. The image below depicts a Barra GPS device. Screw Type: 2.5mm x 8mm Pozi-Pan Head Screws   Provisioning Process Electrostatic Discharge (ESD) Warning The com

Bolt OBDII Firmware Release Notes

Published January 25th, 2023 by Matthew Clark-Massera

Subscribe To Updates Subscribe to our technical newsletter to be notified of bug fixes and firmware updates v2.9/3.9 Bugfix for runtime incrementation v2.8/3.8 Improved run hour incrementation v2.7/3.7 Fix for repeated "Modem turn off failed" issue v2.6/3.6 Added the option to disable the supression of GPS wander for heartbeats The GPS fix timestamp

Troubleshooting Short Battery Life

Published February 1st, 2023 by Matthew Clark-Massera

Sometimes, we get shorter battery life than originally expected from a device.  It is important to set up low battery alerts on devices to be warned ahead of batteries going flat, so they can be changed. Possible reasons for unexpected battery drain include: Single cell battery failure Most batteries have a failure rate of close to or under 1%, whic

Bolt2 Firmware Release Notes

Published January 25th, 2023 by Matthew Clark-Massera

Subscribe To Updates Subscribe to our technical newsletter to be notified of bug fixes and firmware updates v1.21 (Big update!)  SDK and Modem Library Updates We can now reset the modem core separately from the application core to recover from modem faults. This allows for faster/better recovery when the modem freezes Numerous fixes and improvements

Falcon - Wiring in DM I2C Sensors

Published January 27th, 2023 by Matthew Clark-Massera

This guide is to be read in conjunction with the DM Temperature Sensor Datasheet. Digital Matter manufacture and supply a Temperature/Humidity (Ambient) I2C Sensor, and an I2C Temperature Probe. Check the above data sheet for specifications.   Ambient Sensor (Temperature and Humidity Sensor)  I2C Temperature Probe Connecting the Sensors Please note,

Remora2 - Technical Drawing

Published February 2nd, 2023 by Matthew Clark-Massera

Please find attached the technical drawings for the Remora2 housing. Remora 2.pdf

Setting up a Yabby Edge LoRaWAN Device via TTN (v3) and TTI

Published January 31st, 2023 by Matthew Clark-Massera

1. Setup your Yabby Edge LoRaWAN devices using the LoRaWAN Provisioning Tool The LoRaWAN provisioning tool can be downloaded here.Please see Yabby Edge LoRaWAN - configuration and Usage. Note: It is important to configure the Region and Scanning parameters. 2. Setup your Yabby Edge LoRaWAN devices on TTN/TTI Please see this article for more informat

Turn By Turn Tracking - [Remora3]

Published February 2nd, 2023 by Matthew Clark-Massera

Turn by Turn tracking allows the user to track an asset more accurately when in a trip. The GPS is left on in this mode to get regular fixes. This feature will log a record if the heading changes, the speed changes or based on the distance or time interval; whichever comes first. Please Note Turn by Turn tracking needs to be enabled under the Basic

External Power Removed Alerts

Published January 25th, 2023 by Matthew Clark-Massera

Applies to: Device Firmware Version Bolt2-4G All Versions Dart3-2G and Dart3-4G All Versions G120-2G and G120-4G All Versions G150-Global All Versions G70-2G, G70-4G, G70-4G-BLE All Versions Hard-wired devices use a back up Li-Po batteries to provide power for a while after a power disconnect. This provides enough time for the device to send an aler

Hawk - Battery Life Estimates

Published January 26th, 2023 by Matthew Clark-Massera

When assessing if the Hawk is fit for purpose for a particular application - a battery life estimate is invaluable. However, it can be hard to make accurate predictions given the vast array of configurations and sensors that can be fitted to the Hawk. Different sensors will have different power draws, warm-up times and sampling times which make esti

Example Payload

Published January 25th, 2023 by Matthew Clark-Massera

{ "SerNo": 173340, //Serial Number of Device "IMEI": "35275309167XXXX", //IMEI of device "ICCID": "8961018500229963XXXX", //ICCID of SIM card "ProdId": 75, //Product ID of DM device "FW": "75.2.2.2", "Records": [ { "SeqNo": 31070, //Unique Sequence number "Reason": 11, //Log reason - See log reasons.pdf "DateUTC": "2019-09-20 00:44:18", //Date of Re

Asset Health Tracking

Published January 26th, 2023 by Matthew Clark-Massera

Asset Health gives status summary information at a glance, and allows you to investigate and address unhealthy assets. Organisations and Users need to have Asset Health permissions enabled to be able to use this feature. The Organisation must have Asset Health Enabled under functionality. Go to Admin > Organisations and edit the organisation you

Device Certifications

Published November 20th, 2023 by Matthew Clark-Massera

The below table outlines key test reports and regulatory/network certifications achieved by our device range. If you require a copy of a specific reports, contact our support team.  Devices OYSTER Devices Regions Oyster-Edge-4G Certificates USA & Canada FCC & ISED Prop65 European Union CE RoHS REACH United Kingdom UKCA Australia & New Ze

LiPo Battery Storage [Dart3]

Published January 26th, 2023 by Matthew Clark-Massera

The Dart3 comes fitted with a 200mAh, Lithium Polymer (LiPo) internal back up battery. This allows for External Power Removed Alerts if the device is unplugged, and for the device to track for some time after being unplugged LiPo batteries are commonly used as they are light weight and compact.  Over time and use, batteries degrade, such that their

Oyster Edge - Default I/O Mappings

Published February 1st, 2023 by Matthew Clark-Massera

Here are the Default I/O Mappings for Digital Matter's Oyster Edge tracker. You can change some of these mappings on OEM server - we do not recommend changing these unless you know what you are doing.These mapping can be very handy to identify and debug issues.  For example, if the device is connecting to the server/platform intermittently, this may

Minew Tag Packet Structure

Published January 27th, 2023 by Matthew Clark-Massera

In the list of user integrated tags are the Minew tag and Minew S1 tags. Minew Tags are capable of sending different packet formats such as iBeacon, Eddystone UID,  Eddystone URL, Telemetry, Temperature and Humidity. The Minew tag type that is implemented is a basic tag for Minew devices therefore it will read in the first three bytes shown in the S

2G/3G APN - how do I set the APN on my device to get it on the network?

Published January 25th, 2023 by Matthew Clark-Massera

In order for a cellular based device to be able to connect in to the server it needs to be able to connect via the cellular network. Devices need a working SIM card, and need a working APN. Digital Matter devices use "Auto-APN" to figure out APN settings for networks and APNs that we know about. If you are using a new network or a private APN then y

Bolt2 FAQ

Published January 25th, 2023 by Matthew Clark-Massera

What OBDII engine/fault codes does the Bolt read? None! The Bolt is an OBD device in that it simply easily plugs directly into the OBDII port - this is a zero-install option and is convenient. It only draws power from the OBDII port.      There are 14 pins on an OBDII adapter, but only 2 (Vin and GND) are connected to the actual PCB circuitry on the

Configuring 4-20mA sensor readings on the Hawk

Published January 26th, 2023 by Matthew Clark-Massera

The 4-20mA interface is common for industrial sensors. Such sensors output an amperage between 4mA and 20mA proportional to the signal (pressure, temperature, moisture, vibration) they are measuring.  Wiring To properly use a 4-20mA sensor with the Hawk, you need to wire it sensor into: A 4-20mA input on the Hawk card. The Vboost or 3v3 Switch Power

Advanced Scanning Parameters

Published January 27th, 2023 by Matthew Clark-Massera

When scanning for Bluetooth® devices there are many options to consider. Should the device actively or passively scan? What technology should be used? These options affect the power usage, what tags are found and what data is retrieved from said tags. The device can be configured using the following parameter tab: Use Active Scanning - If this is se

Remora3G - Technical Drawing

Published February 2nd, 2023 by Matthew Clark-Massera

Please find attached the technical drawings for the Remora housing. Remora Housing Technical Drawing.PDF

Choosing an Integration Strategy

Published January 25th, 2023 by Matthew Clark-Massera

What is Integration? Device Manager is simply a management and configuration platform, your customers will not be able to use their devices to track shipments, prevent theft, or monitor usage without sharing device data into another system. As a result, Device Manager has been built to easily on-send data in a variety of formats, but with the except

Remora3 - Tracking Modes

Published January 31st, 2023 by Matthew Clark-Massera

The Remora3 operates in a similar way to its predecessor model, the Remora2.  Default Parameters - Out of the box, the device will: Heartbeat every 12 hours Log a position every 2 min, and upload every 30 min while in trip.  The Sony GPS module used in the Remora3 has two operation modes Performance: The default mode of operation. The GPS works slig

Data Capturing on Device Manager

Published January 25th, 2023 by Matthew Clark-Massera

Device Manager is normally a conduit for device data to front-end systems such as Telematics Guru. You can set up a data capture by activating the function on Device Manager before the data sent through to TG or a Third Party platform. Remember that this setting is applied to new connections. So if a device is currently connected and data capture is

Oyster Cellular Battery Life Estimate Calculator

Published February 1st, 2023 by Matthew Clark-Massera

See attached spreadsheet for a calculator to determine rough estimates for battery life for the Oyster Cellular.  Note the average time to GPS fix varies with the logging period - more frequent logs means that the GPS module is downloading fresh aiding data, and stays 'hot', so it will more easily acquire a subsequent fix.  In general around 60s for

Battery Life Estimates - Oyster3

Published January 31st, 2023 by Matthew Clark-Massera

The Oyster3 boats 'Deploy-once' battery life with up to 10+ years on only 3 x AA user-replaceable batteries. Battery life is dependent on a host of features, yet this article will help you make predictions. Critical Settings for super-long battery life In order to maximize battery life, some key parameters should be applied for maximum battery life.

Setup Checklist for Installation

Published January 27th, 2023 by Matthew Clark-Massera

Checklists can be used to capture device installation on an ad-hoc basis. For full detail on Checklists and configuration, see Checklists in Telematics Guru. Below is an example of how a checklist can be created to report installation of a device on an asset. There are 2 elements to this: Checklists can be captured via the mobile app On the web inte

Measuring 4-20mA Current Loop Signals with an Analog Input

Published January 27th, 2023 by Matthew Clark-Massera

To measure a 4-20mA current signal, a resistor should be wired inline to the low side of the power to the device (possibly supplied by the device itself), and analog in be wired to the high side of the resistor (see diagram). Selection of the value of resistance is a trade off between measurement precision, and the input voltage range of the device

Oyster Sigfox Firmware Release Notes

Published January 27th, 2023 by Matthew Clark-Massera

v1.8 - Upgraded to new config tool v1.7 - Added Extended GPS Data uplink (3), which includes position accuracy v1.6 - Fixed bug that could in rare circumstances cause missed trips until the next heartbeat - Fixed enforcement of 20s minimum hop time in US region - Fixed a hardware errata that caused occasional reboots on a very small number of device

Dart2 FAQ

Published January 26th, 2023 by Matthew Clark-Massera

How do I install the device? See Wired Device Installation Guide     Do I need to install in-line fuses? No, the device has internal protections including a self-resetting thermal fuse. The Dart2 is load-dump and short circuit protected and tested - so that it can withstand the harsh electrical environments of vehicle installations.      Does the Da

Get Notified! - Sign up for device technical updates

Published January 25th, 2023 by Matthew Clark-Massera

Please add your details to our technical email list so that you can receive the technical notifications that you need, like new firmware releases and bug fixes etc. Click here to sign up to Technical News

DC-DC Step Down Converters

Published January 27th, 2023 by Matthew Clark-Massera

Occasionally we want to install a device or peripheral in an asset - and the only available voltage source is higher than the maximum input voltage of our device.  Input Voltage Range Devices 5-16V Eagle, Falcon 8-36V Dart2, G62, G62 LoRa 8-45V G120 We can use a DC-DC converter to drop the voltage down to a suitable level. All DC-DC converters will

Battery Low/Critical CSV Export in Device Manager

Published January 25th, 2023 by Matthew Clark-Massera

Device Manager has a reports tab where users can select the Battery Status report. This allows the user the ability to run a low battery report on command. To run the report the user would select the Reports tab and then select Battery Status (CSV). For Telematics Guru users, there is an equivalent report that can be run and scheduled from within TG

Upgrading the Sigfox Config App

Published January 27th, 2023 by Matthew Clark-Massera

The latest version of the Config App will automatically check for updates each time you start it, so long as you are connected to the internet. If you had previously installed an older version of the application, you may see a message like this when installing the new version for the first time: In this case, you must first uninstall the old version

Hawk Upload Settings

Published January 26th, 2023 by Matthew Clark-Massera

The Hawk allows for fine grained control of the Registration Strategy and network registration/upload timeouts - in order to best handle device connectivity and increase battery life. Registration Strategy: sets the registration strategy (Auto, Balanced, Low Power, Ultra Low Power). Lower power modes will give up faster in weak signal conditions. Th

Dart 3G Datasheet

Published January 26th, 2023 by Matthew Clark-Massera

Please view the last version of the Dart 3G datasheet below. No further copies will be made as this product has been deprecated and replaced by the Dart2. The White label version for resellers is available as a power point below. To remove the Digital Matter Logo, edit the 'Slide Master'.  E.g. under 'View > Slide Master' in Microsoft Powerpoint

LoRaWAN® Frequency Plans And Class

Published January 27th, 2023 by Matthew Clark-Massera

The Digital Matter devices currently support the following LoRaWAN™ frequency plans. The Regional Parameter Specification version number from the LoRa Alliance is given in brackets. Europe 868 MHz (1.0.2B/3A + 1.1B) India 865 MHz (1.0.2B/3A + 1.1B) Russia 864 MHz (1.0.3A + 1.1B) US 915 MHz (1.0.2B/3A + 1.1B) AS 923 MHz, Asia (1.0.2B + 1.1B) / (1.0.3

Yabby LoRaWAN® Firmware Release Notes

Published January 31st, 2023 by Matthew Clark-Massera

v2.8 - Support for AS923-4 region - Optimise uplink transmission intervals when both GPS Multiplier and trip tracking are enabled v2.7 - Optimise uplink transmission intervals when GPS Multiplier is not enabled v2.6 -Added GPS Multiplier support v2.5- Fixed spurious reset indications in ABP 1.0 FCnt reset support,which could cause loss of downlink c

Yabby LoRaWAN® Integration

Published January 31st, 2023 by Matthew Clark-Massera

The attached document describes all of the uplink and downlink message requirements for working with a Yabby LoRaWAN device. The downlink messages are not required for a simple implementation.

SensorNode LoRaWAN® - Configuration and Usage Guide

Published January 27th, 2023 by Matthew Clark-Massera

The SensorNode provides a number of configurable parameters, to allow its behavior to be tailored to specific applications. Factors affecting the configuration you might choose include: How many messages per day your network will allow How often you intend to change the batteries, and the type of batteries in use How good the GPS reception is in you

Decoding the Yabby LoRaWAN® Payload

Published January 31st, 2023 by Matthew Clark-Massera

You can find the full payload specification here and the example decoder below. Yabby LoRaWAN Uplink Decoder iframe generator  

Yabby LoRaWAN® - LED Behaviour

Published January 31st, 2023 by Matthew Clark-Massera

In the release build of the Yabby LoRaWAN, the LED is operational from reset until the first sleep. Thereafter, it is disabled for power saving reasons. After reset the following will be observed: A single 1 second flash on reset. An additional 10 seconds of the LED on, if a brownout is suspected. This happens if the total battery voltage is sampled

Device Flash Memory Storage

Published July 9th, 2024 by Matthew Clark-Massera

Our cellular device range features on-board flash memory.  The flash memory is used to store device parameters, firmware and other data such as on-board geo-fence data or driver lists.  If a device travels out of coverage, records will be stored on the device and uploaded upon return to coverage.  In the table below the total record count is given.

Oyster Edge - Sealing the Device

Published February 1st, 2023 by Matthew Clark-Massera

The Oyster Edge has an IP68 and IK07 rated housing. The device must be sealed carefully to achieve the IP68 rating. Ensure that the clear silicon seal is in good condition, is lying flat, and is not fouled by any plastic debris or other material. Close the housing, and gently squeeze it shut. Foam on the lid will compress against the batteries, hold

Accelerometer Wakeup Thresholds

Published February 1st, 2023 by Matthew Clark-Massera

Our battery-powered devices have 4 tracking modes, depending on the device.  GPS Movement Based Tracking Accelerometer (Jostle) Based Movement Tracking Periodic Tracking Turn-by-Turn (Remora3 - See Turn By Turn Tracking - [Remora3]) See Battery Powered Tracking Modes for full details. For modes 1, 2 and 4- the accelerometer is used to wake the devic

Yabby GPS Firmware Release Notes

Published January 31st, 2023 by Matthew Clark-Massera

Subscribe To Updates Subscribe to our technical newsletter to be notified of bug fixes and firmware updates v2.21 / 3.21 Recovery Mode Flag Fix v2.20 / 3.20 Fix for repeated "Modem turn off failed" issue v2.19 / 3.19 Added cell tower fallback v2.18 / 3.18 GPS aiding data fix v2.17 / 3.17 Improvements to low battery behaviour v2.16 / 3.16 Latest APN

WNK8010 Pressure Sensor

Published January 31st, 2023 by Matthew Clark-Massera

The WNK8010-TT pressure sensor has been integrated for use with the Falcon. Specifically this sensor is integrated but others of this family should work as their I2C protocol is the same.  To configure the Falcon to record readings from this sensor - the following parameter tab must be set up. This tells us that the pressure value will be written to

Yabby Edge LoRaWAN® - Configuration and Usage Guide

Published January 31st, 2023 by Matthew Clark-Massera

The Yabby Edge LoRaWAN provides a number of configurable parameters, to allow its behavior to be tailored to specific applications. Factors affecting the configuration you might choose include: How many messages per day your network will allow How often you intend to change the batteries, and the type of batteries in use How detailed a bread-crumb t

Getting Started - Trips

Published January 26th, 2023 by Matthew Clark-Massera

Digital Matter tracking devices cater for a number of different ways to start a trip. Input 0 (bit 0) is the IGNITION input and Telematics Guru uses this to work out if the a device is in a trip.      System Parameters Types of Trips Trip Based V Non Trip Asset Defaults Set to Periodic Only System Parameters  Movement Trips (Pictured - Dart2 Paramet

G120 & G150 Iridium Data Setup on TG

Published January 31st, 2023 by Matthew Clark-Massera

The G120 & G150 can be connected via cable to an Iridium Edge Module. This will provide a 'fallback' connectivity option when out of cellular coverage.  When in cellular coverage, the G120/G150 operates as normal, recording and uploading regular live tracking data Data is uploaded via the cellular network to OEM Server and then passed on to Tele

Setting up a Yabby Edge LoRaWAN Device via Everynet

Published January 31st, 2023 by Matthew Clark-Massera

1. Setup your Yabby Edge LoRaWAN devices using the LoRaWAN Provisioning Tool The LoRaWAN provisioning tool can be downloaded here.Please see Yabby Edge LoRaWAN - Configuration and Usage. Note: It is important to configure the Region and Scanning parameters. 2. Setup the API Credentials on OEM Navigate to the 'Manage' dropdown on OEM and click on 'AP

Roaming SIM Cards - Battery Life Impact

Published January 25th, 2023 by Matthew Clark-Massera

Where does the energy go in uploading data? Our latest range of cellular devices use the Nordic nrf9160 cellular modem.  Specs from this modem: Operates on all major global LTE-M and NB-IoT bands LTE-M (Cat-M1): B1, B2, B3, B4, B5, B8, B12, B13, B14, B17, B18, B19, B20, B25, B26, B28, B66 NB-IoT (Cat-NB1/NB2): B1, B2, B3, B4, B5, B8, B12, B13, B17,

Connect an External Cellular Antenna

Published January 26th, 2023 by Matthew Clark-Massera

The Hawk Pro and Hawk Lite PCBs come with internal cellular and GPS antennas. This makes deployment quick and easy.  Some users on the edge of cellular coverage may wish to fit an external cellular antenna to increase sensitivity.  Certifications Hawk device certifications have all been done with the internal antenna. They will not be valid should y

Asset State Configuration

Published January 26th, 2023 by Matthew Clark-Massera

Asset State Configurations can be used to have assets change colours in the Live View and Trip History view according to different digital input combinations or "states". State changes will also be recorded in the asset timeline/event log, and the Asset State - Detail and Asset State - Summary reports.  Simple example with PTO mapped below. For exam

Terminate (Un-provision) a Device

Published January 25th, 2023 by Matthew Clark-Massera

The MyGeotab system bills for active devices. In order to avoid being billed for devices that are no longer active, the device must be terminated in MyGeotab. Please terminate the device in the MyAdmin user interface. There is no interface in the OEM Server to do this yet. Note: If a device re-connects after termination, billing will resume. It is t

Dart2 Firmware Release Notes

Published January 26th, 2023 by Matthew Clark-Massera

 Subscribe To Updates Subscribe to our technical newsletter to be notified of bug fixes and firmware updates.  v2.17/3.17 Bugfix for runtime incrementation v2.16 / 3.16 Improved run hour incrementation v2.15 / 3.15 Added option for driver ID to temporarily override server-initiated immobilisation Invalid driver debugEvent level set to Severe v2.14 /

Remora 2 Firmware Release Notes

Published February 2nd, 2023 by Matthew Clark-Massera

Subscribe To Updates Subscribe to our technical newsletter to be notified of bug fixes and firmware updates Versions below require BLE version 2.4 and newer for new features. Supports all 2.X v2.23/3.23 Added support for battery low flag reset via stats reset async message  v2.22/3.22 Added support for stats reset via async message  v2.21/3.21 Added

Battery Life Estimates - Oyster Edge

Published February 1st, 2023 by Matthew Clark-Massera

The Oyster Edge uses advanced low-power location-solving techniques to provide exceptional battery life - allowing 'deploy once' operation. The batteries will not need to be changed for an assets useful life! This cuts down on cost, effort, and potential issues.  How does it save power? "Traditional" devices with on-board GPS modules will wake when

Battery Capacity Estimate and Low Battery Flag

Published February 2nd, 2023 by Matthew Clark-Massera

This article discusses how to accurately predict battery life and manage + monitor the battery level of devices in the field. While we have put in significant effort to make this as user-friendly as possible, it is a complex topic, so this article is worth reading in detail. Introduction Predicting the battery life of Lithium batteries is quite diff

Digital Matter SMS App

Published January 25th, 2023 by Matthew Clark-Massera

The Digital Matter SMS App allows you to send the following SMS commands to multiple units. It aims to make it more convenient for resellers to send SMS commands to their devices. To use the SMS app you will need an Clickatell API account with credits. To create an account follow this link. The app is for Windows only. Download the exe attached to t

Oyster3 - Default I/O mappings

Published January 31st, 2023 by Matthew Clark-Massera

Here are the Default I/O Mappings for Digital Matter's Oyster 3 tracker. You can change some of these mappings on OEM server - we do not recommend changing these unless you know what you are doing. These mapping can be very handy to identify and debug issues.  For example, if the device is connecting to the server/platform intermittently, this maybe

Integration - Common Issues

Published January 25th, 2023 by Matthew Clark-Massera

Why am I getting the date as 1/1/13? Time on Digital Matter devices is given as seconds since 01/01/2013. Before a device is powered on, it has no Real Time Clock (RTC) value. Once it comes online it will get a timestamp from the GPS or from the server. So if your device has had a hard reset - and not yet got a new GPS fix - the time sent in Field 0

Asset Bulk Update

Published January 26th, 2023 by Matthew Clark-Massera

There are multiple configuration options for assets.  Often when setting up system features, a similar configuration needs to be set for each asset, or even 1 single change may need to be made to all assets. Asset Bulk Update makes this management easily.  To make asset updates in bulk, go to Assets -> Manage Assets.  The Bulk Update button will

Oyster Sigfox Default Settings

Published January 27th, 2023 by Matthew Clark-Massera

The settings that an Oyster Sigfox ships with are chosen for a good out-of-box demo experience. When optimizing your solution, you may want to change them to achieve greater battery life. The default settings are shown below.  Out of Trip: 24 hour heartbeats - attempt to a GPS fix and send it on the Sigfox network every 24 hours. In Trip: Trips star

Partner Feedback Form

Published January 26th, 2023 by Matthew Clark-Massera

A feedback form is available in Telematics Guru, in order to collect feedback from end users and partners.  It can be found on the dashboard, or from within the account menu.  The form is enabled, but partners can disable it. To do so: Admin → Organisation Manage → Partner Settings Uncheck "Allow User Feedback" The User Feedback Report allows partne

Alert on Live View/Signal Duress - Telematics Guru

Published January 26th, 2023 by Matthew Clark-Massera

Telematics Guru allows you to set up events marked to signal duress which allows the live screen to play a sound and notify users of a duress condition. This is typically used for Duress Buttons, but any alert can have the duress condition set up. With this in place, a user on the live page would receive a notification on this page. i.e. if we wish,

G62 Harness Definition

Published January 27th, 2023 by Matthew Clark-Massera

See attached  G62 Wiring Harness Definition.pdf

Dart2 - Getting Started

Published January 26th, 2023 by Matthew Clark-Massera

The Dart 2 is the new version of the Dart and is also a compact, economical and feature rich 2G or 4G tracking device. It is designed to provide extremely cost effective tracking with all the quality and support of a Digital Matter product. It includes the latest GPS and cellular technology to give excellent performance at an entry level price.  dig

Troubleshooting - Devices Not Connecting

Published January 27th, 2023 by Matthew Clark-Massera

Troubleshooting your device The main reasons a DM device is not performing correctly often come down to one of the following reasons Flat batteries Cellular reception or network coverage Platform setup SIM card issues Device issue This article covers how to troubleshoot issues, by checking and eliminating each of these items to isolate the root caus

Azure-IOT Hub Helper

Published January 25th, 2023 by Matthew Clark-Massera

Introduction Azure’s IoT Hub offers highly secure and reliable data transfer between devices and cloud hosted software applications. Digital Matter’s OEM Server can output device data in a JSON format, over HTTP. OEM Server provides the ideal service to convert raw device data into JSON, and when matched with Azure’s IoT Hub, it is the ideal solutio

4G Network - Device Behaviour Effects on Verizon

Published January 25th, 2023 by Matthew Clark-Massera

In order for devices to be certified, some networks require that devices conform to specifications that restrict the devices' upload behaviour. This article outlines the restrictions that are enforced by the device if using certain networks.  Verizon (USA) To use the Verizon network, the device must have the "4G Network" admin parameter tab, with th

How do I know if my devices are 2G, 3G or 4G?

Published January 25th, 2023 by Matthew Clark-Massera

With 3G network shutdowns looming in many countries, including  Australia in June 2024 , partners may want to find the following information about their devices.  Which of my devices are 2G, 3G or 4G? How many 3G devices do I have and which customers have them? This information can be obtained from the OEM Server or Telematics Guru interface.  Produ

G70 Harness Definition

Published January 27th, 2023 by Matthew Clark-Massera

The G70 comes with a 1m long, 10 wire harness.  15 mm is pre stripped on the loose ends of the input (red), ground (black) and the ignition (white) wires. 24 AWG Wire Definition PIN  COLOUR FUNCTION 1 RED   VIN 2 BLACK   GROUND 3 WHITE   IGNITION 4 BLUE   DIGITAL INPUT 1 5 PINK or ORANGE**     DIGITAL INPUT 2 6 BROWN   DRIVER ID 1  (iButton Data / W

Battery Powered - Tracking Parameters

Published January 31st, 2023 by Matthew Clark-Massera

Applies To  Device Firmware Version Oyster3 All versions Yabby3 All versions Remora3 All versions Barra GPS All versions By default, the above devices are setup for GPS-based movement tracking. The following default settings apply: (1) Heartbeat Upload Period 720 min: When out of trip (stationary): 12 hour heartbeats. This is a GPS point and an uplo

View Forwarder Logs

Published January 31st, 2023 by Matthew Clark-Massera

Unlike our 'traditional' range of GPS devices, the "Edge" range of devices use Forwarders to send data to an end point (or end points).  Details on setting up a Forwarder can be found here - Forward Edge Device Data to my Endpoint (Cellular). See details on the Location Engine here - The Location Engine - Key Concepts Important points: The Location

G100 Firmware Release Notes

Published January 31st, 2023 by Matthew Clark-Massera

Subscribe To Updates Subscribe to our technical newsletter to be notified of bug fixes and firmware updates  v1.27  Fixed issue preventing device from loading all downloaded geofences  v1.26  Improved reliability of geofence synchronisation via Telematics Guru  v1.25  Added accident async message v1.24 Added input monitor   v1.23  Added driver fatig

G70-2G Release Notes

Published January 27th, 2023 by Matthew Clark-Massera

Subscribe To Updates Subscribe to our technical newsletter to be notified of bug fixes and firmware updates 1.13 Bugfix for runtime incrementation 1.12 Improved run hour incrementation 1.11 Added Analogue Threshold support 1.10 Allow digital inputs to be configured as active low Ensure that pulse counters are mapped to the correct analogues 1.9 Enab

Recovery Mode

Published February 1st, 2023 by Matthew Clark-Massera

Applies to:  Device Firmware Barra Edge, Barra GPS All versions Yabby Edge and Yabby3 All versions Oyster Edge, Oyster3 4G, Oyster3 2G, Oyster3 Bluetooth and Oyster3 Global All versions Remora3 4G and Remora3 Global All versions Recovery mode can be used to help recover a stolen asset.  When set, a device reports more frequently and begins 'live tra

G120 Harness Definition

Published January 31st, 2023 by Matthew Clark-Massera

Voltage Information Pin Number Description Voltage Range Pin 21 (Violet), or Pin 21 (Orange) RS232 IN (Rx) ± 5V Pin 22 (Black/White) or Pin 22 (Brown) RS232 OUT (Tx) ± 5V Pin 24 (Red) Power IN 8-45V DC Pin 11 (Yellow) SWGND N/A Pin 20 (Black) GND N/A

SIM Cards and Data Usage - [Remora3]

Published January 31st, 2023 by Matthew Clark-Massera

Disclaimer This article is intended to assist partners in selecting between LTE-M/NB-IoT, determining costings, and choosing SIM providers. Advice is general and partners should conduct their own testing and make an informed decision. It should be noted that Digital Matter supply devices globally, but have offices based in the US, South Africa and A

Dart3 Firmware Release Notes

Published January 26th, 2023 by Matthew Clark-Massera

Subscribe To Updates Subscribe to our technical newsletter to be notified of bug fixes and firmware updates v1.17 Support setting GPS position via async message Allow updates to Modem Firmware v1.3.5 v1.16 Fix for immobilization control  v1.13 Added support for remote override for driver ID immobilisation  Added support to activate immobiliser with

Iridium Troubleshooting

Published January 31st, 2023 by Matthew Clark-Massera

If your Iridium connection is not working properly, there are usually a few clues that point towards an issue. You can tell an Iridium device is not failing over when in the telemetry you see large >30min (setting dependent) transmission delays, but then when you switch to Iridium records there are none being logged. In Telematics Guru, to view C

G62 - Getting Started

Published January 27th, 2023 by Matthew Clark-Massera

The G62 is a compact 4G GPS tracking device with a variety of inputs and outputs to cater for the most demanding applications.  The 4G modem allows for operation on both Cat-M1 and NB-IoT networks. Its rugged housing is IP67 rated to withstand the harshest environments, without sacrificing tracking and communications performance. With the internal G

Battery Life Estimates - [Remora3]

Published January 31st, 2023 by Matthew Clark-Massera

The Remora3 boasts 'Deploy-once' battery life with up to 10+ years on only 2 x D Cell user-replaceable batteries. Battery life is dependent on a host of features, yet this article will help you make predictions. Critical Settings for super-long battery life In order to maximize battery life, some key parameters should be applied for maximum battery

Eagle - FAQ

Published January 27th, 2023 by Matthew Clark-Massera

How many I2C temperature (or other) probes can I connect to the Eagle? The Eagle has an I2C interface, which is used to interface to sensors. The I2C interface is a 'shared bus' protocol. So you can hook up many sensors at once. However the way we can read from multiple sensors is that each has a unique address. Addresses are in the range 0-127 (0x0

Hard Wired Devices: Idle Monitoring

Published January 26th, 2023 by Matthew Clark-Massera

Applies to: Device Firmware Version Bolt2-4G  All Versions Dart3-2G and Dart3-4G All Versions G120-2G and G120-4G All Versions G150-Global All Versions G70-2G and G70-4G All Versions Driver Behavior is an important safety and cost saving measure. Driver behavior alerts and reports help with Safety and Compliance, and enable you to get the most from

Falcon & Eagle Cellular - Configuring Task Schedules

Published January 27th, 2023 by Matthew Clark-Massera

The Falcon & Eagle makes it easy to run tasks at regular intervals. This is made possible with the Task Schedule feature. Core components of a Task Schedule: There are 2 components which must be configured for a task schedule to operate. These are: Period: The task schedule requires an interval at which to run the task. Item: The task schedule r

ABP 1.1 Support

Published January 27th, 2023 by Matthew Clark-Massera

LoRaWAN devices have 2 ways of joining the network, OTAA or ABP.  In general, unless you have specific requirements, OTAA is easiest, well supported, and recommended by Digital Matter.  Some issues have been discovered with ABP on LoRaWAN 1.1.DM view 1.1 as currently 'experimental'. There are some known issues and the spec is not regularly updated b

Why Aren't I Receiving my Email/SMS Alerts or Reports?

Published January 26th, 2023 by Matthew Clark-Massera

In some rare cases, notifications (email, SMS, app) stop being received by the user.  Typically, it is for one of the following reasons: The alert/report we are expecting to receive was not actually generated by TG in the first place, so there was no notification to send Organisation Notification Send Limit has been reached Caught in user's mailbox

Bolt2 - Getting Started

Published January 25th, 2023 by Matthew Clark-Massera

The Bolt is our compact, plug and play OBDII tracking device.  The Bolt was previously available in 2 variants: 2G 4G LTE-M/NB-IoT It has now been replaced with the Bolt2, available in a cellular LTE-M/NB-IoT version only.In terms of usage and functionality, the major difference is that the Bolt2 comes with an internal back-up battery, which allows

Telematics Guru - History Views

Published January 26th, 2023 by Matthew Clark-Massera

The Data that is recorded by Telematics Guru can be viewed in several different ways. These views are separated into seven different ways of displaying data and are accessible from the dashboard or the History drop down. Overview Video Trip History Map View This view displays the selected day's trips chronologically, displaying information on start

Remora3 - Update GNSS Firmware

Published September 26th, 2023 by Matthew Clark-Massera

The Remora3 makes use of the Sony CXD5612 GNSS module to provide a location from GPS, GLONASS, Galileo and Beidou satellite constellations.  Sony periodically release firmware updates to the module to improve performance.  Through testing, Digital Matter have obvserved significant improvements when upgrading from version 0.90 to 0.122.  Some early R

Yabby Edge - Disabling WiFi or Cellular Lookups

Published February 2nd, 2023 by Matthew Clark-Massera

The typical location accuracy of the Yabby Edge is: ~ 5m-80m for a GNSS location~10m-100m for a WiFi location - depends on how many Access Points are in range~250m - 1km for a Cell Tower Location - depends on how many cell towers are nearby This is a bit less accurate than a device with on-board GNSS like the Oyster3 or Yabby3 - however the Edge ran

Connecting a Solar Panel

Published January 26th, 2023 by Matthew Clark-Massera

The Hawk Pro can be fitted with a 3500mAh LiPo rechargeable battery. Hawk Lite The Hawk Lite does not have an internal rechargeable battery and therefore is NOT compatible with external solar power.   For permanent installations, aggressive sampling/upload rates, or when using power-hungry sensors - a solar panel can be connected to the Hawk Pro.  D

Transported Trips - Prevent towing incrementing Run hours and Odometer

Published January 27th, 2023 by Matthew Clark-Massera

Digital Matter tracking devices cater for a number of different ways to start a trip. When a device is in trip, it's "Trip Status Flag" will be set in the digital inputs (separate to bit 0). Telematics Guru and other software platforms can utitlise this to aid in determining when a device is in a trip. Input 0 (bit 0) is the IGNITION input and Telem

Hawk - Upload when outside desired sensor range

Published January 27th, 2023 by Matthew Clark-Massera

For some applications, like temperature monitoring, we may only 'care' when the temperature is outside an allowable range.  We can configure the Hawk to maximise battery life by setting it to sample the temperature frequently, upload infrequently, but force an upload if any of the temp samples is outside our allowable range. This means we still get

Falcon - Battery Capacity Estimate and Low Battery Flag

Published January 27th, 2023 by Matthew Clark-Massera

Please see our Battery Capacity article for the Oyster2, Remora2 and Falcon here

Events vs Alerts

Published January 26th, 2023 by Matthew Clark-Massera

In Telematics Guru, Events and Alerts are similar, but different. In general they operate in much the same way, and are linked. Alerts An Alert Condition is a statement about device information that results in the Alert either being "Active" or not. Alerts will be triggered based on their settings, and can be used to send SMS and Email notifications

Fair Usage Policy

Published January 26th, 2023 by Matthew Clark-Massera

This Fair Usage Policy document details what Digital Matter considers acceptable usage of its Telematics Guru and OEM Server software. Digital Matter may withhold service based on this policy. Digital Matter will endeavour to accommodate and support all clients.   Record Limits: The logging period should not be faster than 30 seconds, averaged over

Iridium Hybrid Devices in TG - Alerts, Reports and caveats

Published January 31st, 2023 by Matthew Clark-Massera

The G120 & G150 provide the ability to connect an external Iridium Edge modem - for out of coverage fail-over tracking. It is important to understand what can be done with this solution, and the limitations of what information and functionality is available when the unit sends data via Iridium.  Iridium Hybrid technology It is important to note

How much data do DM Devices use?

Published January 25th, 2023 by Matthew Clark-Massera

Disclaimer This article is intended to assist partners in selecting between LTE-M/NB-IoT, determining costings, and choosing SIM providers. Advice is general and partners should conduct their own testing and make an informed decision. It should be noted that Digital Matter supply devices globally, but have offices based in the US, The Netherlands, S

Device Battery Suggestions

Published January 31st, 2023 by Matthew Clark-Massera

A note on batteries Digital Matter’s battery powered devices offer world-leading performance resulting in excellent  battery life subject to two things – using the products appropriately and ensuring the appropriate batteries are utilised. It should be noted however that, as with any battery powered device, the ultimate performance and battery life

Oyster Sigfox Integration (Complete Protocol)

Published January 27th, 2023 by Matthew Clark-Massera

Click this link to check out the Oyster Sigfox on the Digital Matter Website . The attached document describes all of the uplink and downlink message requirements for working with an Oyster Sigfox device. The downlink messages are not required for a simple implementation. Oyster SF Integration 1.4.pdf (211 KB)

Falcon - FAQ

Published January 27th, 2023 by Matthew Clark-Massera

How many temperature (or other) probes can I connect to the Falcon? The Falcon has an I2C interface, which is used to interface to sensors. The I2C interface is a 'shared bus' protocol. So you can hook up many sensors at once. However the way we can read from multiple sensors is that each has a unique address. Addresses are in the range 0-127 (0x00

Oyster Edge Cellular - FAQ

Published February 1st, 2023 by Matthew Clark-Massera

How does the device get a position? The Oyster Edge 'scans' for GNSS and WiFi signals. It then sends this data up to the server, along with Cell Tower information from the connection.         This data is sent to our Location Engine for processing, which resolves a position from the raw data.         It is done this way as: It is much lower energy t

DM LoRaWAN™ Default Application EUI's (AppEUI)

Published January 27th, 2023 by Matthew Clark-Massera

This table provides the Default Application EUIs for Digital Matter's various LoRaWAN enabled products. These App EUIs are the defaults, and can be reconfigured with the configuration app and cables. Device Default App EUI Oyster based on LoRaWAN Technology 70B3D57050000000 Guppy based on LoRaWAN Technology 70B3D57050000001 SensorData based on LoRaW

Oyster Edge Release Notes

Published February 1st, 2023 by Matthew Clark-Massera

1.21 Fix for Location Scan multiplier issue 1.20 Allow High-G event logging above 8G 1.17 Fixed high sleep current issue which could occur when using Bluetooth to scan 7+ tags Fixed Bluetooth Response Timeout issue Added logging control for empty and populated BLE tags 1.15 Support for Universal Bluetooth Sensor Integration Fixed ELA RHT/T analog ma

Setting up Secondary Run Hours

Published January 27th, 2023 by Matthew Clark-Massera

Telematics Guru can keep track of secondary run hours. For a description of primary run hours and odo readings, click here. Enable Secondary Run Hours Functionality In order to make use of Secondary Run Hour functionality, this must be enabled on the organisation.  Secondary run hour functionality is intended to track hours from a digital input or o

G120 Wiring Diagrams

Published January 31st, 2023 by Matthew Clark-Massera

For a discussion on setting up driver ID or immobilisation methods with the G120, see the G120 article here Wiring for Immobilisation using RFID 125KHz Driver ID Wiring for Immobilisation using iButton Wiring for Immobilisation via ASYNC message from Telematics Guru or 3rd party Server

Configuring Analog Thresholds on the Falcon and Eagle

Published January 27th, 2023 by Matthew Clark-Massera

The Falcon and Eagle are often used for sensor monitoring. Sensor values are stored in device analog data fields. Generally, sampling a sensor does not use very much energy in comparison to uploading data. So in many applications, we may sample many data points, and upload in batches. For example, read the temp every 10 minutes, and update every 2 h

Edge Device - Location Scanning and Lookup Parameters

Published January 31st, 2023 by Matthew Clark-Massera

See below video for an overview of how the device and Location Engine resolve a position, along with the key parameters which control the process. 

Falcon - Temperature Readings in Telematics Guru

Published January 27th, 2023 by Matthew Clark-Massera

The Falcon Cellular is a super-smart, battery-powered tracking device in a rugged IP67 housing - in particular designed for asset location with temperature monitoring. This article will take you through the steps to read and report the I2C sensor readings. digitalmatter.com You can view the datasheet and read more about the falcon on our site! Getti

BLE Tag Filtering

Published January 27th, 2023 by Matthew Clark-Massera

Digital Matter devices filter out the tags you require from background Bluetooth® noise, but sometimes this isn't enough - especially when dealing with iBeacon and Eddystone tags. It can be easy for the scanner to log tags from other companies, using more data than necessary. The iBeacon UUID and Eddystone Namespace IDs are designed to solve this pr

G120 Firmware Release Notes

Published January 31st, 2023 by Matthew Clark-Massera

Subscribe To Updates Subscribe to our technical newsletter to be notified of bug fixes and firmware updates Versions below require BLE version 2.5 and newer for new features. v2.31 Appropriate modem response to denied registration v2.30 Temp fix for BGM220 continuous scanning, reset bgm once per day v2.29 Bugfix for runtime incrementation v2.28 Adde

Eagle and Falcon - Estimating Battery Life

Published January 27th, 2023 by Matthew Clark-Massera

All about battery life! For a full discussion on battery life estimates, and monitoring your device battery levels to ensure timely replacement, see this article:  Battery Life, Battery Capacity Estimate & Low Battery Flag The Eagle and Falcon are both highly flexible devices, with a variety of inputs. Just some of the applications/functions whi

Changing the Update Rate - [Remora3]

Published January 31st, 2023 by Matthew Clark-Massera

The Remora3 has different configurable tracking modes to best fit a variety of applications. Additionally, if an asset is stolen, the unit can be put into Recovery Mode, where the unit will live-track with an increased update rate for a configured time period, to aid in asset recovery.  The below recordings show how to quickly and easily configure t

Location Engine Scanning Parameters and Lookups [Yabby Edge]

Published February 2nd, 2023 by Matthew Clark-Massera

The Yabby Edge requires the use of our Location Engine to resolve/process GNSS, Wi-Fi and Cell Tower information in to standard location data (longitude and latitude coordinates). Here's everything you need to know about Location Engine and how you can configure the different lookups. And some information on Lookup billing. Location Engine : Digital

Troubleshooting Hard Wired Device - Not Connecting

Published January 25th, 2023 by Matthew Clark-Massera

Applies to: The main reasons a cellular device would not be connecting as scheduled are as follows: External power and/or internal battery issue Cellular reception or network coverage Platform setup SIM card issues Device issue This article covers how to troubleshoot issues, by checking and eliminating each of these items to isolate the root cause o

Introducing the Oyster3

Published January 31st, 2023 by Matthew Clark-Massera

The Oyster3 is the next generation of our best-selling Oyster series. It is an ultra-rugged GPS asset tracking device featuring 10+ years of battery life (5x battery life of Oyster2).  Key Features: Deploy-once battery life with up to 10+ years on only 3 x AA user-replaceable batteries Powered by off-the-shelf Lithium or Lithium Thionyl Chloride (LT

TG - Utilisation

Published January 26th, 2023 by Matthew Clark-Massera

Tracking utilisation is a key reason that telematics devices are installed across fleets. Rather than being an expense, tracking devices and software can easily generate an ROI. The data gathered can be analysed to improve efficiency, workflows and reduce waste. Our devices, and the reports in Telematics Guru can provide key insights and answer ques

Modem Firmware Version in OEM Server

Published January 25th, 2023 by Matthew Clark-Massera

This Article Refers to Legacy Content This article contains screenshots and references to OEM Server (oemserver.com), which was our device management platform until the release of Device Manager in 2024. Please see the article below for the Device Manager version of this article: Updating Modem Firmware in Device Manager For more details, see Device

Position data - from Sigfox and from the Device

Published January 27th, 2023 by Matthew Clark-Massera

Oyster Sigfox devices have a GPS, and will generally provide very accurate positions. This data is recorded in the "data" payload. It is often confused with what is sent by the Sigfox network - "lat" and "lng" in the callback. For example, consider this callback content: { "device":"214E64", "time":1513918420, "duplicate":false, "snr":10.94, "statio

Falcon Cellular - Turn by Turn Tracking

Published January 27th, 2023 by Matthew Clark-Massera

Turn by Turn tracking allows the user to track an asset more accurately when in a trip. This new feature will log a record if the heading changes, the speed changes or based on the distance or time interval; whichever comes first.  Please Note Turn by Turn tracking is only supported on the new Falcon revision, i.e product version 74.3 / 74.4   Turn

Yabby Edge Celluar - FAQ

Published February 2nd, 2023 by Matthew Clark-Massera

How does the device get a position? The Yabby Edge 'scans' for GNSS and WiFi signals. It then sends this data up to the server, along with Cell Tower information from the connection.         This data is sent to our Location Engine for processing, which resolves a position from the raw data.         It is done this way as: It is much lower energy th

Device Statistics

Published February 1st, 2023 by Matthew Clark-Massera

The Device Statistics (also known as Device Profile Counters) report long term, low frequency counters for performance monitoring and prediction. This is commonly used on battery powered devices.   What do the counters tell us? Counters will allow you to monitor the performance of each device, such as voltage, GPS fix time, upload time, etc. If cert

Device Manager Billing

Published January 25th, 2023 by Matthew Clark-Massera

A device will attract a Device Manager fee under the following conditions: It has a connector set to send data to a 3rd party platform (not null)  It connects in during the month more than 8 times (this allows for some limited testing without attracting a charge) If the device is set to send data via a connector to Telematics Guru, there is no separ

G150 - Connect an External Cellular Antenna

Published January 22nd, 2024 by Matthew Clark-Massera

NB: Supported in FW 1.8+ The G150 comes fitted with internal cellular and GPS antennas. This makes deployment quick and easy.  Some users on the edge of cellular coverage may wish to fit an external cellular antenna to increase sensitivity.  Certifications G150 device certifications have all been done with the internal antenna. They will not be vali

Oyster Edge - Mounting and Installation

Published February 1st, 2023 by Matthew Clark-Massera

The Oyster Edge can be mounted on the asset to be tracked using screws, bolts, cable ties, magnets, or industrial adhesives. When choosing a mounting point, you have two competing goals: To minimise the chances of the device being accidentally crushed, dislodged or discovered by a thief. To maximise GNSS scanning and mobile reception and provide ade

Changing the Update Rate - Oyster3

Published January 31st, 2023 by Matthew Clark-Massera

Applies to: Oyster3-4G, Oyster3-4G-Bluetooth, Oyster3-2G The Oyster3 has different configurable tracking modes to best fit a variety of applications. Additionally, if an asset is stolen, the unit can be put into Recovery Mode, where the unit will live-track with an increased update rate for a configured time period, to aid in asset recovery.  The be

On-Device Odometer on the Remora3

Published July 18th, 2023 by Matthew Clark-Massera

The Remora3 LTE-M/NB-IoT and Remora3 Global have the capability to accumulate run hours and odometer readings on board. The devices work out these values and send accumulated values to the server.  Many platforms calculate this server-side based on device data (including Telematics Guru), so it is not always necessary to configure this feature in or

Test/Provisioning Equipment for Partners

Published January 27th, 2023 by Matthew Clark-Massera

It is handy for partners to have a few tools available to assist with provisioning and debugging devices. They are detailed below.  Bench Top Power Supply Extremely useful for powering on our powered devices, setting their ignition on etc.  0-24V is more than enough range. (Our powered devices will work fine on 8V) It can be handy to have a model wh

Hyperlink on Asset Live View Popup

Published January 26th, 2023 by Matthew Clark-Massera

A hyperlink and title can be added against an asset, to be displayed on the Live View pop-up dialogue on the TG Website.  A title is given to the link which will display on mouse over Use Cases: Some assets may have a dashcam installed with it's own video feed (and site to view the feed) this can be 'linked' to the asset via this feature. Clicking o

Yabby Edge LoRaWAN - Certifications List

Published January 31st, 2023 by Matthew Clark-Massera

The list below covers the certifications which the Yabby Edge LoRaWAN has.  To view the specific test reports, see Certifications - [Yabby Edge LoRaWAN]  (A login is required to view this page - Contact Support and we can provide access) EMC Certification EMC (Electromagnetic Compatibility) testing ensures that the Yabby Edge LoRaWAN doesn't emit ex

Bluetooth® Long Range

Published January 27th, 2023 by Matthew Clark-Massera

Bluetooth 5 introduced two new technologies, one for extending the range of Bluetooth® at the expense of data rate (LE Coded - henceforth referenced as "long range") and one for increasing the data rate at the expense of range (LE 2M). These are supplement to the standard Bluetooth® technology (LE 1M). Theoretically, Bluetooth® long range devices co

Movement Detection with No GPS Locations [Yabby3]

Published January 31st, 2023 by Matthew Clark-Massera

One application of interest for battery powered devices are door open/close alerts. To track things like unauthorised access to a room, building or container (perhaps with precious cargo inside). In such applications, where there is no available power source, we require a battery powered device like the Yabby3. Accelerometer Activity on the Yabby3-

How To Guide: Geo-Fences

Published January 27th, 2023 by Matthew Clark-Massera

Geo-Fences can be utilised in several ways that enable you to track asset details such as time spent inside/outside of, distance or hours travelled inside of specific locations. You can also use Geo-Fences to manually set speed limits for areas, and update location-based data to a custom string. Setting up a Geo-Fence Creating a Geo-Fence from the L

Setting up a Yabby Edge LoRaWAN Device via Helium

Published January 31st, 2023 by Matthew Clark-Massera

Known Limitations/Issues There are currently some limitations/issues on the network server end for this integration. The Yabby Edge LoRaWAN relies quite heavily on downlinks in order for the Location Engine to be able to send key positional and timing information down to the device. Due to network lag, if you are outside of America, downlinks usuall

Hawk - Configure Pulse Count

Published January 27th, 2023 by Matthew Clark-Massera

The Hawk can be configured to count pulses on digital inputs - for example to monitor a tipping rain gauge. The fastest pulses the Hawk can count are approximately 40 Hz.Ensure testing is performed on faster pulse rates to ensure they can be reliably counted. Pulse counting will cause additional battery drain (compared to device sleeping) so needs t

Oyster2 Cellular Battery Life Estimate Calculator

Published February 1st, 2023 by Matthew Clark-Massera

Use the attached spreadsheet for to determine  rough estimates  for battery life for the Oyster Cellular. The results cannot be guaranteed.  Note the option to select battery chemistry: LiFeS2 vs LTC Note the average time to GPS fix varies with the logging period - more frequent logs means that the GPS module is downloading fresh aiding data, and st

Initial Provisioning - [Dart3]

Published January 25th, 2023 by Matthew Clark-Massera

This guide is intended to assist new users in getting an Dart3 online for the first time. Once you have some experience with the device, this process may change slightly. e.g you may wish to queue firmware and parameter updates before inserting a SIM and doing the install in a vehicle - so that the device picks up new settings once it gets online.  

Connectivity Settings Fallback

Published January 25th, 2023 by Matthew Clark-Massera

In December 2019, we released our Connectivity Settings Fallback Feature,  On 4G networks, a device is unable to receive an SMS unless it is already connected to the network. This makes changing parameters, setting APNs and other functions difficult to do remotely, as if a device cannot connect settings cannot be applied via OEM.  If a device in the

Troubleshooting - Battery Problems

Published January 27th, 2023 by Matthew Clark-Massera

Possible reasons for unexpected battery drain include: Single-cell battery failure Most batteries have a failure rate of close to or under 1%, which varies by brand and type Battery age may adversely affect their performance.  High and extremely low temperatures or extreme vibration can greatly increase the failure rate Activating Recovery Mode acci

View Device Logs

Published January 25th, 2023 by Matthew Clark-Massera

This allows you to inspect data logged by the device. Please note: Debug records are always captured and shown. The debug log level controls how many debug logs are recorded. Please see the article here for more details. Device data logs are normally forwarded and not recorded. To see the process to enable the capture of the records, please see the

Fuel Monitoring in Telematics Guru

Published January 26th, 2023 by Matthew Clark-Massera

Telematics Guru can support fuel monitoring functionality. It should be noted that the overall reliability and usefulness of the data ultimately relies on the ability of any connected fuel sensor to provide accurate readings. Fuel in tanks sloshes about - and some sensors report readings regularly, which without smoothing can become unreliable. Gett

Oyster Edge - Changing the Update Rate

Published February 1st, 2023 by Matthew Clark-Massera

The Oyster Edge has different configurable tracking modes to best fit a variety of applications. Additionally, if an asset is stolen, the unit can be put into Recovery Mode, where the unit will live-track with an increased update rate for a configured time period, to aid in asset recovery.  The below recordings show how to quickly and easily configu

Eagle - Technical Drawing

Published January 27th, 2023 by Matthew Clark-Massera

Please find attached the technical drawings for the Eagle housing.  The Eagle uses Digital Matter's "Flexi" housing - which is also used by the SensorData Eagle Housing Drawing.pdf (184 KB)

Dart Harness Definition

Published January 26th, 2023 by Matthew Clark-Massera

Remora3G Datasheet

Published February 2nd, 2023 by Matthew Clark-Massera

Please view the last Datasheet for the Remora 3GE. There will be no more revisions as this product has been deprecated and replaced with the Remora2The White label version for resellers is available as a power point below. To remove the Digital Matter Logo, edit the 'Slide Master'. E.g. under 'View > Slide Master' in Microsoft Powerpoint 365 Remo

Introducing Telematics Guru

Published January 26th, 2023 by Matthew Clark-Massera

Telematics Guru (TG) is a full-featured Telematics software for end-users.  This article will introduce some of the TG basics. The following articles will go into more detail.  Ensure you check out all the sub-folders of this TG knowledge-base to view all of the many features of TG! If you need any assistance, have a query about a feature, or have a

G70-4G Firmware Release Notes

Published January 27th, 2023 by Matthew Clark-Massera

Subscribe To Updates Subscribe to our technical newsletter to be notified of bug fixes and firmware updates 1.17 On Board Run Hours for Digital Inputs added 1.16 After-Hours Immobilization added 1.15 Immobilisation Patch 1.14 Ability to control buzzing independently from overspeed logging. 1.12/1.13 Fix for immobilisation control 1.11 Added support

Supported Sensors and Inputs

Published January 31st, 2023 by Matthew Clark-Massera

Our devices offer a number of different inputs including: Digital Inputs Analogue (0-30V) inputs 4-20mA Bluetooth® I2C 1-wire SDI-12 RS232 RS485  These interfaces allow for a wide variety of various sensors to be connected to devices for applications such as: Tank Level Monitoring Fuel Level Monitoring Temperature Monitoring and Cold Chain Door+Gate

Can the device flatten a vehicle battery? - Bolt2

Published January 25th, 2023 by Matthew Clark-Massera

In rare cases, end users have reported a flat vehicle battery a while after installing a device like the Bolt2. Based on the Bolt2's current draw, the Bolt2 is not to blame.  The numbers: Bolt2 current draw from a 12V power supply, with the battery plugged in.  The average current while charging the battery is 38mA (note, this is worst case, the bat

Location Engine Billing

Published January 31st, 2023 by Matthew Clark-Massera

The Location Engine cloud infrastructure is a critical part of the 'Edge' range of devices - handling a variety of tasks key to the overall device performance. Edge devices send 'raw' GNSS, WiFi, and Cell Tower data - which the Location Engine resolves into lat/long positions. In order to achieve this data is sent to a variety of lookup providers. T

Update nrf9160 Modem Firmware

Published January 25th, 2023 by Matthew Clark-Massera

This Article Refers to Legacy Content This article contains screenshots and references to OEM Server (oemserver.com), which was our device management platform until the release of Device Manager in 2024. Please see the article below for the Device Manager version of this article: Updating Modem Firmware in Device Manager For more details, see Device

Digital Matter’s Returns Policy (“RMA”)

Published August 22nd, 2023 by Matthew Clark-Massera

Unless specifically agreed, in writing, to the contrary, Digital Matter only offers a “carry in repair or replace” warranty against manufacturing defects (“ Manufacturer’s Warranty ”). You are referred to the article setting out what the Manufacturer’s Warranty includes and excludes. RMA Procedure  In the event that you believe that there is a defec

Oyster Sigfox: In Trip vs. Out Of Trip

Published January 27th, 2023 by Matthew Clark-Massera

The Oyster Sigfox device has 2 main states, in-trip or out-of-trip. The device behaves differently in the two states. The configurable parameters mentioned below, and many more, are explained here. What qualifies as a trip? The Oyster Sigfox device uses the accelerometer to decide on its trip status. Accelerometer movement will start a trip, and kee

Digital Inputs Introduction

Published January 26th, 2023 by Matthew Clark-Massera

Applies to: Device Firmware Version Dart3-2G, Dart2-4G, Dart3-4G, Dart3-4G Bluetooth® and Dart3 Global Bluetooth® All Versions G120-2G and G120-4G All Versions G150-Global All Versions G70-2G, G70-4G and G70-4G Bluetooth® All Versions Hawk 4G (see Hawk Digital Inputs) All Versions The wired devices have both an Ignition Digital Input along with Digi

Auto-APN feature (2G/3G Devices)

Published January 25th, 2023 by Matthew Clark-Massera

2G/3G Device Specific Note this feature applies to our 2G and 3G devices only. Digital Matter Cellular devices have an Auto-APN feature that can make the SIM card experience "plug and play". Auto APN is activated when the Admin Parameters are blank. This is the default state for the devices.  It is recommended that once your have your device online

Bluetooth Supported Sensors

Published January 27th, 2023 by Matthew Clark-Massera

Our Bluetooth® Gateway devices are able to read a wide variety of 3rd Party Tags and sensors given there are many on the market to fit a variety of needs and use cases. Which Tags Can be read by Digital Matter gateways? It is possible for us to quickly integrate tags that 'beacon'. Beaconing refers to the fact that the tag will simply periodically b

Bolt + Bolt 2- Assembly and Installation Guide

Published January 25th, 2023 by Matthew Clark-Massera

This article applies to both the Bolt and Bolt2 digitalmatter.com Read more about the Bolt on our site! Assembly Guide The Bolt comes with a snap-shut plastic housing. This housing, once shut is very hard to open without damaging the housing or maybe even the Printed Circuit Board (PCB) part of the device. The only notable difference between the Bol

Sealing the Device [Remora3]

Published January 31st, 2023 by Matthew Clark-Massera

The Remora3 has and IP68 and IK07 rated housing. The device must be sealed carefully to achieve the IP-68 rating. Ensure that the clear silicon seal is in good condition, is lying flat, and is not fouled by any plastic debris or other material. Close the housing, and gently squeeze it shut. Foam on the lid will compress against the batteries, holdin

SIM Providers: LTE-M/Nb-IoT + Roaming, and Setup

Published January 24th, 2023 by Matthew Clark-Massera

To get online with our 4G LTE-M/NB-IoT devices, you will require a SIM card that operates on these networks. Often multiple terms are used for the same network - e.g. Cat-M1 and LTE-M are used interchangeably. Ensure you read Connectivity - LTE-M vs NB-IoT, Coverage, Providers and Roaming as an overview of all the key concepts of LTE-M/NB-IoT.  Trac

Oyster3 LoRaWAN - Certifications List

Published February 2nd, 2023 by Matthew Clark-Massera

The list below covers the certifications which the Oyster3 LoRaWAN has.  To view the specific test reports, see Certifications - [Oyster3 LoRaWAN]  (A login is required to view this page - Contact Support and we can provide access) EMC Certification EMC (Electromagnetic Compatibility) testing ensures that the Oyster3 LoRaWAN doesn't emit excessive a

Magnetic Activation Mode and Tamper Detect on the Barra

Published September 28th, 2023 by Matthew Clark-Massera

The Barra Range of devices features a Hall Effect Sensor, and includes a magnet.  A Hall Effect sensor can detect the presence of a magnetic field. So the device can detect whether the small magnet shown below is within the housing recess or not.   This enables 2 key features/modes - Activation Mode and Tamper Detection Activation Mode While the mag

On Device Odometer and Run Hours

Published January 25th, 2023 by Matthew Clark-Massera

Applies to: Device Firmware Version Bolt2-4G  All Versions Dart3-2G and Dart3-4G All Versions G120-2G and G120-4G All Versions G150-Global All Versions G70-2G and G70-4G/Bluetooth® All Versions Remora3 For the Remora3, see Remora3 On Device Odometer The above devices have the capability to accumulate run hours and odometer readings on-board. The dev

RAG Report

Published January 26th, 2023 by Matthew Clark-Massera

Telematics Guru has a RAG (Red, Amber, Green) Report.  Example Output The report shows the following information Speeding events (based on speed bands configured) - see Speed Monitoring in Telematics Guru Total Trip Duration (minutes) % of this trip time spent speeding # Harsh acceleration events # Harsh braking events # Harsh Driving events Total k

SMS Commands

Published January 25th, 2023 by Matthew Clark-Massera

Overview For the vast majority of SIM cards and networks globally, Digital Matter devices will automatically connect to the network once a valid SIM card is inserted and the device is powered on. For devices with private APNs or other specific requirements configuring the APN may be required to get online. For our 2G and global range this can be don

Oyster Edge Improved GNSS Performance

Published February 1st, 2023 by Matthew Clark-Massera

In case you missed it On top of the below improvements, the Location Engine (server side) also makes use of 'Combo-Scan' functionality to improve location accuracy. See Edge Device GNSS 'Combo Scan'   Overview The Oyster Edge makes use of the Semtech LR1110 Integrated Circuit to scan for GNSS satellites and Wi-Fi access points. Digital Matter and Se

Decode Cellular Uplink Payload using your Browser

Published January 25th, 2023 by Matthew Clark-Massera

Paste a message payload into the message box below. The payload should include the sync chars and message header. You can obtain the full payload specification by contacting support. Launch the Decoder This decoder is written in Java Script and may be freely used as example code. To inspect the code, after opening the above link - inspect the Java S

Wired Sensing Mode

Published January 27th, 2023 by Matthew Clark-Massera

This mode draws a lot more power than other modes and is not recommended for battery powered applications. It should only be used when the device is hard wired.  This feature is currently available on the following products: Eagle: FW 2.10/3.10 and higher. Falcon: Hardware revisions 74.3 and 74.4 - Firmware 2.17/3.17 and above.  Some applications re

Bolt Label Dimensions

Published January 25th, 2023 by Matthew Clark-Massera

Resellers may wish to print their own labels/stickers for the Bolt. Dimensions are as per the attached image. 

Hawk - Configure Analogue Input Readings

Published January 26th, 2023 by Matthew Clark-Massera

Many industrial sensors. Such sensors output a voltage proportional to the signal (pressure, temperature, moisture, vibration) they are measuring.  i.e. 0V for 0°C and 10V for 100°C.  Benefits Low Cost No integration required - any analogue sensor that fits within the range of the device it is connected to can be read Readily available Drawbacks Som

Getting Started - Inviting Users

Published January 26th, 2023 by Matthew Clark-Massera

How to Set up a User in Telematics Guru Navigate to Admin >> Users in Telematic Guru and select 'Invite User' You will be presented with a dialogue: Email addresses of users to invite - you can invite up to 20 at once Base their permissions, report access and asset access on a pre-built template (these are templates loaded in the system) Or ba

Fuel Level Monitoring - Reading Technoton DUT-E S7 and Escort Probes

Published January 27th, 2023 by Matthew Clark-Massera

We have integrated 2 different Fuel Probes into our device FW, such that they can be read by our BLE gateway devices the G120, G150, Remora2, Remora3, Oyster3-4G-BLE and Eagle. This enables fuel level monitoring solutions to be provided! While it is possible on all the aforementioned devices, the G120 and G150 are best suited. It can be hard-wired i

Remora2 FAQ

Published February 2nd, 2023 by Matthew Clark-Massera

How do I change the update rate? See  How to change the update rate on the Oyster2, Remora2 and Yabby             The Remora2 has 3 tracking modes, discussed here -  Battery Powered Devices - Overview of Operations              The tracking modes are: "Standard" GPS Tracking. Movement based tracking. The update rate is increased when on the move (as

4G APN - How do I set the APN to connect to the network?

Published January 25th, 2023 by Matthew Clark-Massera

Cellular based devices need a working SIM card and a working APN to connect to the network. Typically when using 4G technologies such as Cat-M1 and NB-IoT the network automatically sets the correct APN and no user input is required. However, this is not the case for all networks and APNs. An autoAPN list is used by the device for the networks that n

Destination Dispatching

Published January 27th, 2023 by Matthew Clark-Massera

Destination Dispatching allows managers to quickly dispatch drivers to an address. For example, if you manage a fleet of ambulances or security vehicles, the "manager" is able to choose and dispatch a driver that has logged on for duty, and is nearest to the requested address. Introduction Video: Overview Brochure Download Here TG Live Required User

Speed Monitoring on the Remora3

Published July 24th, 2023 by Matthew Clark-Massera

The Remora3 has an onboard speeding parameter which allows a maximum speed Threshold (km/h) to be stored on the device.  While configured for Turn By Turn Tracking - when the device is on the move it leaves its GPS module on, logging fixes constantly at 1Hz (second by second).  The parameters available on the Speeding tab define what action is taken

Movement Trips - Assumed Start Point Range

Published January 27th, 2023 by Matthew Clark-Massera

Our battery-powered and hard-wired devices can detect trips based on GPS movement. Once a trip is detected the device will upload more frequently, and report that it is in trip to the server.  One of the available parameters for movement trips is the Assumed Start Point Range. Default of 10,000m for battery-powered devices, and 2000m for hard-wired.

DM Link Wired Provisioning Tool

Published January 25th, 2023 by Matthew Clark-Massera

Warning! A new universal DM-Link has been produced and should be used moving forward. The old ULINK2 cable should NOT be used with any newer generation devices! The higher voltage supplied by the ULINK2 can damage the newer devices.   All DM devices require the correct APN to be set so that they can connect on the network. A list of APNs is stored i

Default Tracking Parameters - [Yabby Edge Cellular]

Published February 2nd, 2023 by Matthew Clark-Massera

By default, the Yabby Edge is setup for movement-based tracking. The following default settings apply: Update Rate: Out of Trip (stationary): 12 hour heartbeats. This is a position and an upload every 12 hours. In Trip (on the move): Upload on movement detection. Location scans every 3 minutes. Upload every 30 minutes. End a trip after 5 minutes of

A Guide to SIM Cards, ICCIDs and Reports

Published January 25th, 2023 by Matthew Clark-Massera

A SIM card is a small, portable memory chip that connects devices to a mobile network. One of the key identifiers printed on most SIM cards is the ICCID (Integrated Circuit Card Identification Number), a unique 18-22 digit number usually found on the back of the card. No two SIM cards share the same ICCID, making it a globally unique serial number t

How to Use the Installer Page

Published January 25th, 2023 by Matthew Clark-Massera

Devices using Direct Integration mode. This installer page is not useful/suitable for devices using the Direct integration mode - as no device data passes through our servers. Using this page can be misleading as fields like 'Last GPS update' will not be current/updated.   This Article refers to the https://devicemanager.digitalmatter.com/installer

Customize Reports

Published January 26th, 2023 by Matthew Clark-Massera

Telematics Guru allows the customisation of reports, with certain limits. The underlying data available in the report is fixed, but the way it is shown can be customised. This usually means that you need to find an existing report that provides the data that you require. From there, you can customise that report to show what you need. If you require

View Live Server Logs in the Debug Terminal

Published January 25th, 2023 by Matthew Clark-Massera

This useful debugging feature shows the device/server interaction in real-time. It is more verbose than the logs visible here Note This is not available for devices that are on third-party direct mode.   Click on Details (yellow) for the device in question: Go to the Debug Terminal tab. Select the server to be "ALL". Then view the updates live as th

Technical Drawing - [Dart3]

Published January 26th, 2023 by Matthew Clark-Massera

See attached Dart housing drawing - providing external dimensions DART.pdf

Speed Monitoring in Telematics Guru

Published January 26th, 2023 by Matthew Clark-Massera

Speed monitoring allows fleet managers to specify speed limits and monitor compliance with those limits. This is different to "On-Device Speeding" function, and that can be viewed here. The asset should be assigned to the TG-Pro billing plan.       Speed Limits Speed Profiles Speed Monitoring Full Example Speed in Telemetry Troubleshooting Here is o

Digital Matter’s Manufacturer’s Warranty

Published January 27th, 2023 by Matthew Clark-Massera

Digital Matter’s Manufacturer’s Warranty (“Manufacturer’s Warranty”)   Unless specifically agreed, in writing, to the contrary Digital Matter only offers a “carry in repair or replace” warranty in respect of manufacturing defects on its devices.   Summary Digital Matter's Manufacturer’s Warranty is valid for a period of 24 months (2 years) (“Warrant

G120 -Getting Started

Published January 31st, 2023 by Matthew Clark-Massera

The G120 is a compact 2G or 4G Cat-M1/Nb-IoT GPS tracking device with a variety of inputs and outputs to cater for the most demanding applications.  With the internal GPS and cellular antennas installation is a breeze. The internal backup battery provides alerts and tracking operations even when external power (8-45V) is removed. The G120 is equippe

Issues with Firmware Updates

Published January 25th, 2023 by Matthew Clark-Massera

Sometimes a device will appear as if it is 'stuck' in a FW update. However this is rarely the case. OEM will have an indication that a FW update is due like so: In most cases once a device connects in, it will download and apply the update, and then this column is cleared.  The process by which FW updates are applied is: FW update is actioned in OEM

Device Ports

Published January 25th, 2023 by Matthew Clark-Massera

When setting up your devices to connect to the OEM server we currently work on a product per port basis. Please refer to the table below when setting up your device. Please refer to this article for additional information on APN firewall requirements. Region Server Address International s0.oemserver.com International s2.oemserver.com Current Product

Tip Detection and Rotation Counting

Published February 1st, 2023 by Matthew Clark-Massera

Supported Devices: It is best to update firmware to the latest versions which bring new features and performance improvements.  Device Firmware Version Notes Oyster3 4G All Versions Concurrent High-G Event + Tip Detection available in 1.7+ Oyster3 4G Bluetooth All Versions   Oyster Edge 4G All Versions Concurrent High-G Event + Tip Detection availab

Getting Started - Alerts

Published January 26th, 2023 by Matthew Clark-Massera

Introduction to Alerts The Telematics Guru Alerts system allows you to send notifications on one or a set of criteria, or record specific occurrences into events to report on. The most common alerts that all organisations should look at setting up are detailed in this article. This is not an exhaustive list by any means, but is just to give an idea

How long will my back-up battery last? - [G120]

Published January 31st, 2023 by Matthew Clark-Massera

The G120 has a 1100mAh internal back-up battery. This allows for external power removed alerts to be sent immediately if the unit is unplugged or dislodged, and tracking to continue for some time. G120 with Iridium Edge Satellite Module Please note that the G120's back up battery will not be able to power up the Iridium Edge Satellite Modem (used fo

MLX90614 Infrared Thermometer

Published January 31st, 2023 by Matthew Clark-Massera

The Falcon, Eagle, SensorNode LoRaWAN, and SensorData LoRaWAN support the MLX90614 Infrared temperature sensor (single pixel I2C sensor). For the complete list see Supported Sensors and Inputs.  For information on this sensor, visit: https://www.melexis.com/en/product/MLX90614/Digital-Plug-Play-Infrared-Thermometer-TO-Can  DM devices which have inte

Provision a MyGeotab Device on OEM Server

Published January 25th, 2023 by Matthew Clark-Massera

For a device to work on MyGeotab, it must be provisioned on the MyGeotab platform first. Follow these steps: Login to www,oemserver.com. Contact Digital Matter support if you do not have an account. Search for the device(s) in question.  Select the devices using the tick box. Go to Device Operations -> Set Geotab Serial (Provision Device).  If yo

What is GPS Aiding Data?

Published January 27th, 2023 by Matthew Clark-Massera

Our latest range of cellular devices make use of GPS Aiding data  (or Almanac data for our Edge devices), to dramatically improve the performance of their GPS - speeding up fix times, and increasing battery life. Only available to devices on Device Manager (OEM)  Our GPS Aiding Data comes through Device Manager. There will be performance implication

PPM Calculator

Published January 26th, 2023 by Matthew Clark-Massera

This Calculator applies to the TG - Pay Per Message (PPM) plan for 'low use' assets that do not send many records. Note: a 'Message' corresponds to each individual record, or a line of Telemetry in Telematics Guru (Assets -> Telemetry). Some devices may log GPS points while moving, and upload in batches (e.g. the Oyster2). Note it is the number o

Alert Notifications through WebHooks

Published January 26th, 2023 by Matthew Clark-Massera

What are WebHooks? WebHooks are a way that one application can send a message to another.So when something happens in one app - it triggers a WebHook to send some data to another - and the other app can use this data and perform other actions if necessary. It is an example of a 'push' message as based on an event, Telematics Guru will push some data

Hawk and Card - Firmware Release Notes

Published January 26th, 2023 by Matthew Clark-Massera

For details on how to update FW, please see: How to Update Card and baseboard FW Hawk Pro Baseboard 1.9 Support for 5 actions per task Increased the maximum number of registers to 40 for the Modbus Action (Registers mapped to Analogs 21+ will not show on TG). Fixed timeout race condition on boot that could render device bricked until hard reset Fixe

Telematics Guru - Alert Configuration Examples

Published January 26th, 2023 by Matthew Clark-Massera

Alerts in Telematics Guru enables users to be notified when certain conditions for an asset is met. This article covers some of the common alert configurations. Low Battery Alert All Devices , wired and battery powered, have a 'battery good flag' - which is mapped to Digital Input 25 in Telematics Guru. You can use the Alert Wizard to create a Low B

SIM Cards and Data Usage - [G120]

Published January 31st, 2023 by Matthew Clark-Massera

Disclaimer This article is intended to assist partners in selecting between LTE-M/NB-IoT, determining costings, and choosing SIM providers. Advice is general and partners should conduct their own testing and make an informed decision. It should be noted that Digital Matter supply devices globally, but have offices based in the US, South Africa and A

Yabby Cellular Wi-Fi - Product Change Notifications

Published January 31st, 2023 by Matthew Clark-Massera

2020.10.27 - UVLO Firmware Change

Harsh Driving on Telematics Guru

Published January 26th, 2023 by Matthew Clark-Massera

Harsh driving logs are created by devices and sent to Telematics Guru (TG). TG can create events based on these logs. The events can be used for reporting. To get started, ensure your device is setup correctly, with the right firmware and system parameters. Ensure that the harsh driving thresholds are tailored to the type of vehicle. These settings

Connect an External Buzzer/LED

Published January 26th, 2023 by Matthew Clark-Massera

The Dart3, G70 and G120 can be set to sound buzzers based on various conditions such as: A trip starting, but no driver ID has been scanned - to remind drivers to tag on. This is configured on the Driver ID parameter tab, see Immobiliser Install - Asset starts after valid Driver ID Scan Digital Inputs being active/inactive. This is configured on the

Yabby Cellular GPS - Product Change Notifications

Published January 31st, 2023 by Matthew Clark-Massera

2020.10.27 - UVLO Firmware Change

SDI-12 samples

Published January 27th, 2023 by Matthew Clark-Massera

One probe: {"SeqNo": 47858,"Reason": 22,"DateUTC": "2020-03-12 03:49:22","Fields": [  {"DevAddr": 48,"DevId": "13CAMPBELLCLIM50501VUE-500001123","FType": 4}, {"MType": 0,"Ms": [0,0,0,30,207900,30,22800,610,101390],"FType": 5}]} Two Probes https://support.digitalmatter.com/a/tickets/7146 SDI12Sensordata. DeviceAddress: 0, DeviceId: 13EP100GL-08 01181

Creating New Users in Device Manager

Published January 12th, 2024 by Matthew Clark-Massera

Creating New Users Device Manager lets you create and manage user accounts, so you can provide access to your team member to configure and manage devices.  Additionally, it allows partners to conduct periodic access reviews to ensure access rights remain current in the event of staff changes.  In order to manage accounts, your user account requires

SensorData/SensorNode Integration (Sigfox and LoRaWAN)

Published January 31st, 2023 by Matthew Clark-Massera

Use this document for the details of the payloads sent by the SensorData and SensorNode devices. The formats apply to both the Sigfox and LoRaWAN versions of the devices. The integration document is attached below.

Since Committed/Since Connected and Troubleshooting

Published January 25th, 2023 by Matthew Clark-Massera

The OEM Server Getting Started briefly discusses the difference between Since Connected and Since Committed, as viewed in the device grid. If everything is working as normal, these times will line up.  Connections, Uploads, Firmware & Parameter Updates. For context, it is useful to know how a typical data upload is handled.  The device decides t

Inactivity Monitoring/Timer - Battery Powered Devices

Published February 1st, 2023 by Matthew Clark-Massera

Applies to: Device Firmware Barra Edge All versions Barra GPS All versions Yabby Edge and Yabby3 All versions Oyster Edge, Oyster3 4G, Oyster3 Bluetooth and Oyster3 Global All versions Remora3 4G and Remora3 Global All versions The Inactivity Timer is a simple timer that starts when a device ends it's trip. Once the configured time period has elapse

Provisioning for Telematics Guru on the Sigfox Backend

Published January 27th, 2023 by Matthew Clark-Massera

If you have registered Oysters on a private Sigfox account, and wish to connect them to Telematics Guru, you need to configure your Sigfox account to forward the data. This is done by adding a callback to the device type that you are using for your Oysters. First, log in to your private Sigfox account at backend.sigfox.com. Locate the device type th

BigSmall Byte

Published January 25th, 2023 by Matthew Clark-Massera

For example: 10000001 would be 1 hour 00000001 would be 1 minute The bigsmall byte is a way of storing two alternate units in one byte (like minutes and hours for example). The most significant bit of the byte is used to determine whether the data is in “big units” or “small units”. So with the minutes and hours example, if the most significant bit

Can I give OEM Server access to a customer?

Published January 25th, 2023 by Matthew Clark-Massera

This Article Refers to Legacy Content This article contains screenshots and references to OEM Server (oemserver.com), which was our device management platform until the release of Device Manager in 2024. Please see the article below for the Device Manager version of this article: Creating and Assigning Device Groups For more details, see Device Mana

Cellular Reception Troubleshooting

Published January 27th, 2023 by Matthew Clark-Massera

Typically we will notice a device is having trouble connecting due to delayed (or non-existent) updates. We can also spot this via the Device Statistics, which can be found on the Device Details page on Device Manager. When checking Device Details on Device Manager, many failed uploads are a key giveaway that the device is in poor cell strength. Dig

Improve corner tracking on hard-wired devices

Published January 27th, 2023 by Matthew Clark-Massera

While in a trip, our powered devices will log according to the following set of default parameters: This means a log will occur if: 1-minute passes (log at least every 60 sec) The asset travels over 500m The device experiences a 10-degree heading change over the course of 150 metres. The heading change log means that the trips plotted by the device

Hawk Baseboard and IO Card Details

Published January 26th, 2023 by Matthew Clark-Massera

The Hawk is sold in components. Each IO card has 9 available Input/Outputs. This allows for a variety of sensor-monitoring applications and input combinations to be catered for on the same device. Additionally, if you have a specific set of inputs to monitor, we can manufacture a new IO card to cater for your requirements (MOQs apply). Please Note W

TG App - Managing Trips and Logbooking

Published January 26th, 2023 by Matthew Clark-Massera

The Telematics Guru app allows for a convenient way for business and drivers to keep electronic log books. A user can be set up so that in the app, they will be able to see a list of their trips. "Their" trips are any trips where they were the driver. Using the app is quite simple and self explanatory (or so we hope!) - along with the setup. However

Setting Connectors

Published January 25th, 2023 by Matthew Clark-Massera

Setting Connectors This article assumes that you have already read and understood Creating Connectors such that you have created a Connector of your very own and now wish to use it to transmit device data. Please click here to read that article.   Setting a Connector within Device View When on the Device View page for a device, simply remain on the

Accident Detection and Reconstruction + Accident Data Exports

Published January 25th, 2023 by Matthew Clark-Massera

Applies to: Device Firmware Version Bolt2-4G  All Versions Dart3-2G and Dart3-4G All Versions G120-2G and G120-4G All Versions G70-2G and G70-4G All Versions G150 Global v1.5+ Important Warning Although the system is developed using verification from field data, national crash tests and data published in research, detecting accidents can be an ill-p

Eagle Battery Recommendations

Published January 27th, 2023 by Matthew Clark-Massera

The Eagle has multiple power options: Line Power (4-16V input range) 4 x C cell Batteries - either: Alkaline Lithium Thionyl Chloride (LTC) The Eagle's default mAh are calculated for Alkaline cells (7000mAh) if the Voltage is under 8V, otherwise calculated for LTC batteries at 6000mAh. The battery good flag is set to 0 when 5950mAh is used with Alka

High Resolution Product Images

Published February 17th, 2023 by Matthew Clark-Massera

Click the links per product to download high-resolution product images for use in marketing or other materials.  BarraGPS/Edge/Core   New photos added October 2024 Bolt/2    Dart G120 G150/Hawk    G62 / G70 Manta  New photos added November 2024 Oyster   New photos added October 2024 Remora  New photos added October 2024 Yabby   New photos added Octo

3-Wire Install - [Dart3]

Published January 26th, 2023 by Matthew Clark-Massera

The Dart3 is supplied with a 12-wire harness. The harness contains pins for various I/Os. For many installs, where we simply are looking for 'standard' vehicle tracking, we only need to connect 3-wires. For quick plug-and-play installs, there are additional Dart3 harness options (OBDII harness, Cig Lighter harness) - or the Bolt2 is a good option. T

High-G Event Detection

Published January 23rd, 2023 by Matthew Clark-Massera

Supported Devices Barra Family Device Firmware Version Notes Barra GPS All - Barra Core All - Barra Edge All -     Oyster Family Device Firmware Version Notes Oyster3 2G + Oyster3 4G All - Oyster3 2G + Oyster3 4G All Oyster3-4G Digital Input Mapping available in v1.17/v2.17+ Oyster3 Global All - Oyster3 Bluetooth 4G All Multi-Axis High-G available i

Single Sign on in Device Manager

Published March 5th, 2024 by Matthew Clark-Massera

The following steps outline how to configure OpenID Connect with Device Manager to enable Single Sign-On authentication with Microsoft Entra ID. In the Azure Portal, navigate to Microsoft Entra ID      Navigate to App Registrations   Create a new app registration     Give the application a Name and set the Supported Account Types to “Single Tenant”

Direct to 3rd Party Server Integration - Considerations

Published January 25th, 2023 by Matthew Clark-Massera

Device Manager (formerly OEM Server) is an important component of Digital Matter’s offering and allows partners to manage their devices over-the-air. By using Device Manager, we are best able to assist and support you and your devices.  If you are looking to configure your devices to use Direct to 3rd Party Server Mode to avoid any small ongoing mon

Location Engine Lookup Settings

Published January 31st, 2023 by Matthew Clark-Massera

Edge Device Overview Check out the 'Edge' range of devices on our website.  See  Indoor/Outdoor GPS Edge Range , and download an overview  HERE The 'Edge' range of devices relies on our  Location Engine  in order to resolve raw 'scan' data into positions (lat/long). Obtaining a location is complex, but we can think of it happening in two key stages,

Device Firmware Not Updating

Published January 25th, 2023 by Matthew Clark-Massera

The device firmware update process is as below: User sets the desired firmware in the UI (Device Operations  →  Set Firmware) Then, when the device next connects in: Device sends Hello message to OEM Device uploads data End server responds with the commit response, to say data has been successfully received. Device does a 'slot check' and syncs up a

Packet Size on LoRa Networks - Structure of Network Pricing

Published January 27th, 2023 by Matthew Clark-Massera

There are several ways network providers could calculate packet size from a device causing differences in pricing structure. Depending on the pay structure, some networks might round to the nearest whole number It’s also possible to charge for the entire on-air packet, which is a suggestive 24 bytes long Packets starts with a preamble and hardware l

Getting Started - SensorNode Bluetooth®

Published January 27th, 2023 by Matthew Clark-Massera

This guide covers set up the SensorNode Bluetooth® and reading the data via a DM Gateway device (Eagle, Remora2, G120, G150). The device has multiple inputs, all of which it will sample and transmit the values/status via Bluetooth. The available inputs are: An I2C Interface for use with up to 2 x DM Temp Probes and 1 x Temperature/Humidity Sensor si

Introducing the Yabby Edge LoRaWAN®

Published January 31st, 2023 by Matthew Clark-Massera

The Yabby Edge for LoRaWAN® is our ultra-rugged and compact Indoor/Outdoor battery-powered asset tracker. It features cloud-based location solving for over 10+ years of battery life.  Key Features GNSS, Wi-Fi AP MAC Address Scanning, and LoRaWAN® geolocation for indoor/outdoor asset management Deploy-once battery life with up to 10+ years on only 2

Yabby LoraWAN® - Configuration and Usage Guide

Published January 31st, 2023 by Matthew Clark-Massera

The Yabby LoRaWAN provides a number of configurable parameters, to allow its behavior to be tailored to specific applications. Factors affecting the configuration you might choose include: How many messages per day your network will allow How often you intend to change the batteries, and the type of batteries in use How detailed a bread-crumb trail

Route Deviation

Published January 27th, 2023 by Matthew Clark-Massera

Route deviation allows you to determine whether an asset has followed a predetermined route. In TG, you can define a route on the map, which is converted to a Geo-fence that covers the area of the route. Creating a Geo-Fence Around a Route You will need to have the Geo-fence Manage permission to access this functionality. In order to create a Geo-fe

Integrating BLE Tags from ELA Innovations

Published January 27th, 2023 by Matthew Clark-Massera

ELA Innovations have a wide range of Bluetooth tags, suited to a variety of applications. ELA Tags have been integrated into both Digital Matter device firmware and our in-house IoT platform - Telematics Guru, so that they can be used with our BLE product line-up.  Digital Matter's GPS trackers and ELA Innovation's BLE sensors can be used to improve

SensorData Sigfox Firmware Release Notes

Published January 27th, 2023 by Matthew Clark-Massera

v1.7 - Added downlink for digital input alert queuing - Added downlinks for 3.3V output switching on schedules - Ensured zero-second power on delays will always produce at least a short pulse of power - Ensured reported pulse counts won't roll back on power loss - Eliminated dead-time to allow higher frequency pulse counting - Optimized for low powe

Partner's own SMS Gateway

Published January 26th, 2023 by Matthew Clark-Massera

It is possible to link a partner's Clickatell or Twilio account to Telematics Guru.  The partner can then pay for the cost of the SMS' directly. The first step is to obtain a Clickatell or Twilio account and supply Digital Matter the details. Our support team can create an “SMS Provider” on your account - which can be set against an organisation in

Driver Management in TG

Published December 14th, 2023 by Matthew Clark-Massera

Drivers can be added within Telematics Guru for several purposes: To link a Driver Name to an Driver ID tag or other identifier When a driver scans their tag on a device + compatible Driver ID reader - the driver name is shown against the trip and against the live view pop-up.  Resources: Driver ID Options Driver ID + Immobilisation Set Up For use w

G62 LoRaWAN® Integration Document

Published January 31st, 2023 by Matthew Clark-Massera

The attached document describes all of the uplink and downlink messages used by the G62 LoRaWAN. The downlink messages are not required for a simple implementation. G62 LoRaWAN Integration Document G62 LoRaWan Integration Payload Examples: 

Default I/O Mappings [G120]

Published January 31st, 2023 by Matthew Clark-Massera

Here are the Default I/O Mappings for Digital Matter's G120 tracker. You can change some of these mappings on OEM server - we do not recommend changing these unless you know what you are doing. Additionally, some firmware features provide their 'result' as a Digital Input flag - i.e. Idling flag. It is important when configuring these inputs to avoi

Yabby 3 LoRaWAN® Configuration and Usage Guide

Published January 31st, 2023 by Matthew Clark-Massera

The Yabby 3 LoRaWAN provides a number of configurable parameters, to allow its behavior to be tailored to specific applications. Factors affecting the configuration you might choose include: How many messages per day your network will allow How often you intend to change the batteries, and the type of batteries in use How detailed a bread-crumb trai

ELA T/ELA RHT Tags in Telematics Guru (Cold Chain)

Published January 26th, 2023 by Matthew Clark-Massera

ELA T  and  ELA RHT  Bluetooth® tags can be integrated with our range of BLE Gateway devices.  In the APAC region, they can be purchased from M2M Connectivity. Our BLE gateway devices can be set to scan for all tags within range and keep a list in memory. This list is uploaded to the server periodically. Tags are then displayed on the Tag Map in Tel

Setting up a Yabby Edge LoRaWAN Device via Actility (ThingPark Wireless and ThingPark Enterprise)

Published January 31st, 2023 by Matthew Clark-Massera

Check your Actility Version Actility provide two different LoRaWAN products ThingPark Wireless: This platform powers large scale public LoRaWAN networks ThingPark Enterprise: This is the solution for deploying dedicated private LoRaWAN networks   1. Setup your Yabby Edge LoRaWAN devices using the LoRaWAN Provisioning Tool The LoRaWAN provisioning to

Yabby 3 LoRaWAN® LED Behaviour

Published January 31st, 2023 by Matthew Clark-Massera

The Yabby 3 LoRaWAN operates its LED from reset (due to battery insertion or downlink) until the end of the next uplink cycle. Thereafter, it is disabled to save power. After reset the following will be observed: A single 50 ms startup flash. A 4 second solid battery test indication. An additional 10 seconds solid if a brownout is detected. After wh

Battery Life Estimates - Barra GPS

Published February 28th, 2024 by Matthew Clark-Massera

Battery Life Estimates:  The Barra GPS boasts a 'Deploy-once' battery life with up to 8+ years on only 2 x AA user-replaceable batteries. Battery life is dependent on a host of features, this article will help you make predictions. Estimate Calculator: The battery life estimate calculator can aid in estimating battery life.  Battery Life Estimate Ca

Digital Matter LoRaWAN® stack join schedule

Published January 27th, 2023 by Matthew Clark-Massera

Digital Matter devices, based on LoRaWAN™ technology, will attempt to join a LoRaWAN network. The join is attempted when they are set to Over The Air Activation (OTAA), which is the default setup. The join requires an exchange of messages, initiated by the device, to the network, to do a key exchange and establish the keys for the subsequent communi

Sending Sigfox and LoRaWAN® Downlinks

Published January 27th, 2023 by Matthew Clark-Massera

To configure LoRaWAN and Sigfox devices over the air, a configuration messages can be sent to the devices by sending a downlink request to them in Telematics Guru.  Below are the simple steps to send a downlink message to LoRaWAN and Sigfox devices.  Sending LoRaWAN Downlink in Telematics Guru.  Log into your Organization on TG Admin -> LoRaWAN d

"Edge" vs 'Traditional' GPS Devices

Published February 2nd, 2023 by Matthew Clark-Massera

Digital Matter supply an industry leading range of battery powered devices. Check out the entire range here. Industry-leading performance is about optimising several key areas: Price Performance - i.e. the accuracy and reliability of data Power - super long battery life Selecting the right device for the application is critical in ensuring the best

Encoding the Yabby 3 LoRaWAN® Downlink

Published January 31st, 2023 by Matthew Clark-Massera

You can find the full payload specification here, and a downlink encoder below. Yabby 3 LoRaWAN Downlink Encoder This encoder is written in Java Script and may be freely used as example code. To inspect the code, open this link and inspect the Java Script source. Usually this is done with F12 in your browser.  iframe generator  

Tags in Telematics Guru

Published January 26th, 2023 by Matthew Clark-Massera

Getting BLE Data into Telematics Guru To unlock the power of BLE tags for sensor data and asset location you will need to first set up a Bluetooth gateway device in Device Manager. Once complete, the flow of data from the tag to Telematics Guru is as follows: 1 → BLE beacon/tag/sensor 2 → Digital Matter Bluetooth® gateway device 3 → Gateway device t

Yabby 3 LoRaWAN® Provisioning Tool

Published January 31st, 2023 by Matthew Clark-Massera

The Yabby 3 LoRaWAN is configured using a DMLink adapter, and this LoRaWAN Provisioning Tool. For a detailed description of the tool and parameters, please consult the Yabby 3 LoRaWAN® Configuration and Usage Guide.

Bluetooth® Tag Alerts on Telematics Guru

Published January 26th, 2023 by Matthew Clark-Massera

Our Digital Matter Bluetooth Gateways, such as the Remora3, Oyster Edge, G120 and G150 log which tags have been updated, lost or found. Telematics Guru now supports Tag Alerts - Lost and Found as well as alerting on Tag Data .  Your organisation requires the "Tags" permission in order to configure Bluetooth Tag Alerts. Setting up Bluetooth Tag Alert

LoRaWAN® Devices - External Power

Published January 27th, 2023 by Matthew Clark-Massera

The SensorData LoRaWAN, SensorData Sigfox and SensorNode LoRaWAN devices can all be powered externally.  WARNING: do NOT use these products with batteries AND external power. It is either batteries OR external power. WARNING: maximum input voltage is 6V. Take care not to exceed this.  Specifications: 4-6V input voltage. 5V USB supplies will work. Do

Which LoRaWAN® Spec does DM comply with?

Published January 27th, 2023 by Matthew Clark-Massera

The Oyster supports the LoRaWAN 1.0.2, 1.0.3, and 1.1 specifications. Please note however that at this time (Mar 2019), most network servers do not have complete or correct 1.1 support, and there is no official LoRaWAN 1.1 certification process, so the 1.1 protocol is essentially still experimental across the industry.

Dart Firmware Release Notes

Published January 26th, 2023 by Matthew Clark-Massera

Subscribe To Updates Subscribe to our technical newsletter to be notified of bug fixes and firmware updates Dart Application Firmware - this applies to the original Dart, and not Dart2. v1.21 Added an async message request for uploading accident data. v1.20 Added onboard odometer/run hours v1.19 Obtain and save cell tower information in debug logs w

G62 LoRaWAN® Digital Output Functionality

Published January 31st, 2023 by Matthew Clark-Massera

The green wire on the G62 LoRaWAN harness is a digital output, of a switched to ground type. The output has 2 states: Disabled - The output is of high impedance (no connection) Enabled - The output is connected to ground (black wire on the harness) A common use would be to control a relay, which could in turn be used to control a higher power (or is

Configure Bluetooth® Scanning - [Remora3]

Published January 31st, 2023 by Matthew Clark-Massera

The Remora3 has a 5.2 Bluetooth® Low Energy (BLE) module. This enables a large number of flexible solutions to be implemented using the Remora3 + 3rd party BLE Tags or Sensors.  See Bluetooth Asset Tracking for an overview. This guide covers how to configure the device to scan periodically for BLE Tags and sensors. Setting the Bluetooth® Firmware If

Yabby 3 LoRaWAN® Firmware Release Notes

Published January 31st, 2023 by Matthew Clark-Massera

v1.1 First release

LoRaWAN® Overview

Published January 27th, 2023 by Matthew Clark-Massera

See the attached run down on LoRaWAN network architecture.  

G62 LoRaWAN® Configuration and Usage Guide

Published January 31st, 2023 by Matthew Clark-Massera

Click this link to check out the G62 LoRaWAN on the Digital Matter Website. The G62 LoRaWAN provides a number of configurable parameters, to allow its behavior to be tailored to specific applications. Factors affecting the configuration you might choose include: How many messages per day your network will allow What external devices need monitoring

G62 LoRaWAN® Wiring Harness Diagram

Published January 31st, 2023 by Matthew Clark-Massera

The G62 LoRaWAN has two digital inputs, and one analog input. This can be used to notify the current state of an external device, or alert when certain inputs change. These can be set up in the configuration app.

G62 LoRaWAN® Internal LED Behaviour

Published January 31st, 2023 by Matthew Clark-Massera

One short flash and one longer flash Reset indication Rapid short flashes for 10 seconds Invalid configuration detected at startup (use config app to set region) Short flash, once per second Heartbeat or movement check in progress Medium flash, once per second Trip in progress Up to ten long flashes in two seconds Transmission failed due to interfer

G62 LoRaWAN® On-Board Odometer

Published January 31st, 2023 by Matthew Clark-Massera

The G62 LoRaWAN® keeps an on-board odometer and run-time accumulator. Given the potential for uplinks to not be received on the server, uploading a count provides a robust solution.  The run hours and odometer are accumulated when the device is in trip - and the value is uploaded every 24 hrs by default. How to configure this period, and information

Active vs Passive Bluetooth® Scanning

Published January 27th, 2023 by Matthew Clark-Massera

Bluetooth® scans can either be passive or active. When passively scanning, a device will only listen to Bluetooth® devices, quietly collecting data about its surroundings. Active scanners respond to every device they hear from, asking if they have more data to send. The devices then respond with any "scan response" data they have been configured to

Yabby Edge LoRaWAN® Release Notes

Published January 31st, 2023 by Matthew Clark-Massera

Subscribe To Updates Subscribe to our technical newsletter to be notified of bug fixes and firmware updates v1.5 Fixed 'Random Tx Delay' parameter, which was fixed at 3 seconds Added Inactivity Monitoring functionality Updated to LR1110 version 3.7, with updated GNSS and WiFi scanning Improved low signal GNSS performance v1.4 Increase device statist

Panic/Duress Alert on Telematics Guru

Published January 26th, 2023 by Matthew Clark-Massera

This article explains how to setup the alert on TG. Before you Start. Remember to check that the internal back up battery is plugged in Make sure the hardware is setup correctly. Please see the Install and Setup a Duress button guide   Simple Alert Steps Step 1: Setup the IO Mapping Go to Assets->Manage Assets Click on the asset link to bring up

G62 LoRaWAN® Firmware Release Notes

Published January 31st, 2023 by Matthew Clark-Massera

Subscribe To Updates Subscribe to our technical newsletter to be notified of bug fixes and firmware updates v2.5 Improved run hour incrementation v2.4 Added support for Galileo GNSS Added support for the AS923-4 region Added accurate timestamps for uplinks 1 and 3 v2.3 Fixed spurious reset indications in ABP 1.0 FCnt reset support, which could cause

Guppy Bluetooth® - Getting Started

Published January 27th, 2023 by Matthew Clark-Massera

Introduction  The Guppy is a compact, rugged Bluetooth® tag perfect for low-cost monitoring of assets. The Guppy Bluetooth® integrates with other Digital Matter devices that support Bluetooth®, or they can be used with your own Bluetooth® mobile applications. Guppy Bluetooth® Tag Read more about this on our site! In the Box  You will receive a Guppy

Guppy Bluetooth® Remaining Battery Capacity Estimate

Published January 27th, 2023 by Matthew Clark-Massera

The Guppy Bluetooth® will report battery voltage as part of its payload.  This can be used to make some rough estimates of the remaining battery capacity - based on knowledge of LiFeSO2 battery chemistry.  Voltage Range Capacity Estimate 3.20 – 3.5 V 40% + remaining 3.10 – 3.20 V 25 – 40 % remaining 3.00 – 3.10 V 10 – 25% remaining 2.80 – 3.00 V 0 –

Choosing Bluetooth® Scan Length

Published January 27th, 2023 by Matthew Clark-Massera

When choosing the scan length for your Bluetooth® device you are balancing the power usage and accuracy. If the scan is too short you may miss nearby tags but if it is too long you are wasting power. Finding the Balance The first thing you must consider is how often your Bluetooth® tags advertise their data. This is called the "advertisement interva

Setting up Stationary Bluetooth® Gateways

Published January 27th, 2023 by Matthew Clark-Massera

Our range of Bluetooth® enabled gateway devices and tags allow for a variety of low-cost asset tracking solutions. See - Bluetooth Tracker | Bluetooth® GPS Asset Tracking Devices A key use-case is inventory and asset management across multiple sites.  Gateway devices are placed in warehouses, installed in delivery vehicles Bluetooth tags are placed

RUC Monkey

Published March 15th, 2024 by Matthew Clark-Massera

Telematics Guru supports integrating RUC Monkey head units.  In order to receive the data, RUC Monkey must configure the head unit to push device data via Webhook to Telematics Guru servers, in a custom ‘TG specific’ format.  Road User Charge (RUC) For details about RUC in New Zealand, see https://www.nzta.govt.nz/vehicles/road-user-charges/  Charge

Troubleshooting - Devices using excessive Data

Published January 25th, 2023 by Matthew Clark-Massera

How much data do DM devices use? This is dependant on settings, and how often the device will move if we are set up for movement-based tracking, but we have the following rules of thumb: Battery powered devices - typically 1-3MB per month Hard-wired vehicle trackers - typically 3-8MB per month.  Excessive data usage and troubleshooting Sometimes, we

Asset Billing Plans - TG-PPM,Classic,PRO

Published January 26th, 2023 by Matthew Clark-Massera

Telematics Guru provides different billing plans to suit different asset utilization requirements. This provides a great way to get the great features of Telematics Guru, but at a price point that suits the type of asset. To get more information about the cost of each plan, please contact your sales representative.  TG-Classic This is the default pl

G120 & G150 Iridium Set Up and Operation

Published January 31st, 2023 by Matthew Clark-Massera

G120 or G150 Quick Start Guide This article is intended as a complete guide to the available Iridium System parameters, and also to describe how the Iridium connection operates on the G120 or G150. For a cheat sheet to quickly get up and running, see the G120 & G150 Iridium Quick Start Guide.   Introduction The G120 and G150 have the option of b

Commonly Seen Device Logs/Errors

Published January 25th, 2023 by Matthew Clark-Massera

This article shows a list of commonly seen debug log messages sent by devices. They can be viewed here - View Device Logs. By default, "Severe" logs are recorded by the device and uploaded to the server.  Not every log indicates a problem, sometimes it is just an event that we feel is useful to record. An example would be a few logs showing connecti

Decoding the Guppy LoRaWAN® Payload

Published January 31st, 2023 by Matthew Clark-Massera

You can find the full payload specification and example decoder here. The decoder below is written in Java Script and may be freely used as example code. To inspect the code, open this link and inspect the Java Script source. Usually this is done with F12 in your browser. Note that the "xyz" elements of the output are derived from the inclinationDeg

Connecting the Guppy to Telematics Guru over Actility

Published January 31st, 2023 by Matthew Clark-Massera

The process for connecting the Guppy to TG via Actility is the same as per the Oyster, aside from the destination URL. See here: Oyster - Connecting to TG over Actility Configure your application server, AS routing profile and device to have names relevant to the Guppy. When adding a route (Step 5 of the Oyster Guide) use the URL specific to your re

Guppy LoRaWAN®- Tilt / Static Angle Output Examples

Published January 31st, 2023 by Matthew Clark-Massera

The tilt reporting feature in the Guppy, as of firmware v1.9, is explained in the Guppy Configuration and Usage Guide. Here are a few pictures and examples to help you understand how the feature works. This article deals with some static setups, and what angles they result in. Static setup 1:  In this setup, "down" on the Guppy aligns well with grav

Guppy Configuration Guide

Published January 27th, 2023 by Matthew Clark-Massera

The Guppy can be configured either using your own app, or a Bluetooth® scanning app available for Android or iPhone. When using a freely available scanning app the process for changing the device parameters is as follows: Commence a BLE scan on the app Search for your Guppy. It will be named GPX, where X is the device serial number. For example, a G

Guppy - Technical Drawing

Published January 27th, 2023 by Matthew Clark-Massera

Please find attached the technical drawings for the Guppy housing.

Guppy LoRaWAN® Python Payload Decoder

Published January 31st, 2023 by Matthew Clark-Massera

See attached Python Decoder for the Guppy Payload.  Acknowledgements: This decoder was written by Biswajit Sahu Disclaimer: As this was not produced by Digital Matter we cannot offer support for this decoder.  GuppyDecoder.py (4.12 KB)

Guppy LoRaWAN® Firmware Release Notes

Published January 31st, 2023 by Matthew Clark-Massera

v2.3 - Added 1.0.2rB version of region US915 - Changes to test mode for LCTT compatibility - Fixed empty uplink on port 8 at startup - Added AS923-2/3 from final RP002-1.0.1 - Updated serial port commands for volume production - Fixed spurious reset indications in ABP 1.0 FCnt reset support, which could cause loss of downlink connectivity until the

Yabby WiFi Location Billing on TG (TG Wifi Lookup Fees)

Published January 31st, 2023 by Matthew Clark-Massera

The Yabby WiFi devices uses WiFi to scan for access points and records the MAC address and signal strength plus some other info, and sends this list up to the server. For Yabby WiFi units on Telematics Guru we then take this information and translate this into a location estimate. As a Google Enterprise customer we have access to the Google API to d

Guppy - Reporting Tamper

Published January 31st, 2023 by Matthew Clark-Massera

A popular use case for the Guppy is detecting movement and identifying tampering or unauthorized usage. This article provides some guidelines for Guppy setup to achieve this. The high level points are: Device configuration: disable the wake filter. How to pick up movement: using the "in trip" flag Why is there a delay? 1. Device Configuration The ke

Multi-Layer Geo-Fences

Published January 27th, 2023 by Matthew Clark-Massera

When you need to monitor speed off established roads, for example; Farmland or Off-Road vehicle routes, you can use Geo-Fences to establish and track speeds in vehicles. In this Example, we'll walk through creating a Multi-layer Geo-Fence to track different speed levels in the same area. Geo-Fences work in a fashion where if multiple Geo-fences exis

Why are digital input changes not showing on the server straight away?

Published January 27th, 2023 by Matthew Clark-Massera

Currently for all devices, a change on a physical digital input will create a log entry on the device, but it will not be uploaded until its next scheduled upload (either the start of a trip, or a heartbeat).  To make the device upload on the change of a digital input, add the specific input to the system parameters page (if it hasn't been already),

Schedule the Devices Not Connecting Report

Published January 26th, 2023 by Matthew Clark-Massera

The Devices Not Connecting Report serves as a useful device 'Health Check', and can identify device issues quickly. The report can be scheduled to run, and only send an email if there are devices not connecting.  To do so, follow the steps below: Go to Reports -> Scheduled Reports Click New Select the Devices Not Connecting Report Select the Part

SIM Cards and Data Usage - Barra Edge

Published April 29th, 2024 by Matthew Clark-Massera

Disclaimer This article is intended to assist partners in selecting between LTE-M/NB-IoT, determining costings, and choosing SIM providers. Advice is general and partners should conduct their own testing and make an informed decision. It should be noted that Digital Matter supply devices globally, but have offices based in the US, South Africa and A

Remora3G - Getting Started

Published February 2nd, 2023 by Matthew Clark-Massera

The Remora is a low-profile, rugged 2G or 3G (NextG) GPS tracking device that has been designed for tracking containers, trailers, skip bins, and other assets where super long battery life is required without sacrificing the frequency of updates and performance.\ In The Box You'll get a compact box containing the Remora. The 10 housing screws will b

Oysters - Technical Drawing

Published February 1st, 2023 by Matthew Clark-Massera

Please find attached the technical drawings for the Oyster housings. Blueprint - Oyster.pdf

Hawk - Configure MLX90614 Temperature Sensor

Published January 27th, 2023 by Matthew Clark-Massera

Related Articles Please ensure to also read the below for full details on configuring Tasks and I²C Sensors for the Hawk Hawk Operation - Task Schedules Configure I²C Sensor Readings   The MLX90614 is an infrared thermometer which can be used for non-contact temperature measurements. 3rd Party Sensor As this is a 3rd Party sensor - the advice given

Connecting to Telematics Guru over Senet

Published January 27th, 2023 by Matthew Clark-Massera

Senet is a LoRaWAN network software provider. They are based in the USA, but run networks around the world. Telematics Guru now supports Oyster LoRaWAN data from Senet. For now, it is uplink only integration. Future support may include: OTA configuration changes via downlinks. The Yabby device will also be supported, with a minor change to the URL e

Hawk - Configure DM Ambient (Temp+Hum Sensor)

Published January 26th, 2023 by Matthew Clark-Massera

Related Articles Please ensure to also read the below for full details on configuring Tasks and I²C Sensors for the Hawk Hawk Operation - Task Schedules Configure I²C Sensor Readings   DM have limited remaining stock of our Ambient (Temp + Humidity) Sensor. It can be connected to the Hawk Wiring Ambient Sensor Wire Agtech1 Bluetooth+ Red  (3V3) Hawk

Using Integration Documents to Create a Downlink String

Published January 27th, 2023 by Matthew Clark-Massera

A downlink string is a combination of Hex values that triggers the configuration of a device OTA. The downlink string should be sent to the device to effect changes in parameter settings. Here's an example of a downlink string created with Reference to section 7.2.3 of the SensorData/SensorNode Sigfox LoRa Integration document.  The table below show

Hawk - Configure WNK8010TT Pressure Sensor

Published January 27th, 2023 by Matthew Clark-Massera

Related Articles Please ensure to also read the below for full details on configuring Tasks and I²C Sensors for the Hawk Hawk Operation - Task Schedules Configure I²C Sensor Readings   The WNK8010-TT sensor is a pressure sensor commonly used for tank level measurements.  The WNK8010-TT has been integrated and tested specifcially - but other sensors

Setting up a Yabby Edge LoRaWAN Device via Senet

Published January 31st, 2023 by Matthew Clark-Massera

1. Setup your Yabby Edge LoRaWAN devices using the LoRaWAN Provisioning Tool The LoRaWAN provisioning tool can be downloaded here.Please see Yabby Edge LoRaWAN - Configuration and Usage. Note: It is important to configure the Region and Scanning parameters. 2. Setup the API Credentials on OEM Navigate to the 'Manage' dropdown on OEM and click on 'AP

DNS Troubleshooting on 4G

Published January 25th, 2023 by Matthew Clark-Massera

If your 4G device is showing as registered to the network on your sim portal, but you can't get it to connect to www.oemserver.com, there are two likely causes: If you are using a custom APN, your APN's firewall settings might need to be adjusted. Please contact your network for help with this. If you are using a normal APN with full internet connec

Use Telematics Guru to Generate LoRaWAN® Downlinks

Published January 31st, 2023 by Matthew Clark-Massera

Our LoRaWAN® device range can have some parameters configured over the air via downlink. The downlinks are detailed in the Integration document for each device.  For those using Telematics Guru, LoRaWAN downlinks strings can be generated from the UI. The user will need the LoRaWAN View and LoRaWAN Manage permissions to view the options presented bel

Oyster LoRaWAN® Battery Life Estimate Calculator

Published January 31st, 2023 by Matthew Clark-Massera

See attached spreadsheet to help estimate the battery life of an Oyster LoRaWAN Note There are many factors that determine how long batteries will last, do not take this calculator as a guarantee, it is only meant as a guide.   Oyster LoRaWAN Battery Life Estimates.xlsx      

Decoding the Oyster 3 LoRaWAN® Uplink

Published February 2nd, 2023 by Matthew Clark-Massera

You can find the full payload specification here and uplink decoder below. This decoder is written in Java Script and may be freely used as example code. To inspect the code, open this link and inspect the Java Script source. Usually this is done with F12 in your browser.  iframe generator    

Connecting to Telematics Guru over Actility

Published January 27th, 2023 by Matthew Clark-Massera

Actility is a LoRaWAN network software provider. Actility is a popular choice for large scale public networks.  Telematics Guru supports Oyster LoRaWAN & G62 LoRaWAN data from Actility. For now, it is an uplink only integration. 1. Get access to ThingPark Device Manager Each network has a separate instance of device manager. This is commonly fou

Connecting to Telematics Guru over MachineQ

Published January 27th, 2023 by Matthew Clark-Massera

Sign up for a MQcentral account MachineQ is backed by Comcast to make it simple to build, connect and deploy LoRaWAN solutions.Browse to MQcentral front page, and click 'Sign Up'. Follow the prompts, and complete the email verification step. 2. Open MQcentral The portal is where you register your devices and create the HTTP integration to Telematics

Oyster LoRaWAN® - Adjusting GPS Fix Settings

Published January 31st, 2023 by Matthew Clark-Massera

The Oyster provides a number of settings to control the minimum requirements for an acceptable GPS fix. Each of the settings mentioned in this article are more comprehensively described here. Devices are shipped with relatively loose requirements for a fix - shown below. This generally speeds up fixes and allows fixes in adverse conditions. Simply p

Connecting to Telematics Guru over Hiber Mission Control

Published January 27th, 2023 by Matthew Clark-Massera

Hiber provides the world’s first infrastructure-independent global LPWAN for high-density LPWAN sensor setups, as well as time-sensitive applications that require real-time monitoring in rural areas. Hiber provides an end to end solution for asset tracking, cattle tracking and bulk storage monitoring applications. This is achieved by combining the H

The HTTP/HTTPS Connector

Published January 25th, 2023 by Matthew Clark-Massera

Please see our article Choosing an Integration Strategy for a discussion on the various integration options with our devices.  This article outlines the function and features of the HTTP/HTTPS JSON connector and how they can be used in integrating our devices into a 3rd party platform. Contact our support team for integration documents containing th

Setup devices on The Things Network (v3)

Published January 27th, 2023 by Matthew Clark-Massera

The Things Network is a global, community driven LoRaWAN network, that is free to use and has a great web interface. It is ideal for trialing our LoRaWAN devices, using either your own gateways, or community gateways in your area. Every gateway connected to TTN routes traffic from both your own devices and public devices, so the network coverage can

Oyster 3 LoRaWAN® Integration

Published February 2nd, 2023 by Matthew Clark-Massera

The attached document describes all of the uplink and downlink message requirements for working with an Oyster 3 LoRaWAN device. The downlink messages are not required for a simple implementation. Oyster 3 LoRaWAN Integration 1.3.pdf

Decoding the Oyster LoRaWAN® Payload

Published January 31st, 2023 by Matthew Clark-Massera

You can find the full payload specification here and uplink decoder below.   Oyster LoRaWAN Uplink Decoder This decoder is written in Java Script and may be freely used as example code. To inspect the code, open this link and inspect the Java Script source. Usually this is done with F12 in your browser.  iframe generator  

Oyster LoRaWAN® - LED Behaviour

Published January 31st, 2023 by Matthew Clark-Massera

In the release build of the Oyster LoRaWAN, the LED is operational from reset until the first sleep. Thereafter, it is disabled for power saving reasons. After reset the following will be observed: A single 1 second flash on reset. An additional 10 seconds of the LED on if a brownout is detected. After which the device will sleep for 3 hours before

Oyster 3 LoRaWAN® Battery Life Estimate Calculator

Published February 2nd, 2023 by Matthew Clark-Massera

See attached spreadsheet to help estimate the battery life of an Oyster 3 LoRaWAN Note There are many factors that determine how long batteries will last, do not take this calculator as a guarantee, it is only meant as a guide.   Oyster LoRaWAN 3 Battery Life V2.xlsx

Oyster LoRaWAN® Config App

Published January 31st, 2023 by Matthew Clark-Massera

https://www.oemserver.com/tools/OysterLoRaWAN/ConfigTool/setup.exe Should you wish to revert all setting to the default values, use these steps: Hover over this area (shown with 1) of the tool to find the ... (3 dots) Click to get the context menu, and select "Reset desired to default"

Yabby LoRaWAN® Config App

Published January 31st, 2023 by Matthew Clark-Massera

Download the Yabby LoRaWAN Config App here: https://www.oemserver.com/tools/YabbyLoRaWAN/ConfigTool/setup.exe The Configuration and Usage Guide explains the application and how to connect your computer to the Yabby. In short, you will need a Yabby Config Adapter, which plugs into the Yabby PCB near the label "UART1". 

Oyster LoRaWAN® - Configuration and Usage Guide

Published January 31st, 2023 by Matthew Clark-Massera

Click this link to check out the Oyster LoRaWAN on the Digital Matter Website. The Oyster LoRaWAN provides a number of configurable parameters, to allow its behavior to be tailored to specific applications. Factors affecting the configuration you might choose include: How many messages per day your network will allow How often you intend to change t

Guppy Input Voltage Range

Published January 31st, 2023 by Matthew Clark-Massera

The Guppy input voltage range, for 2 x AAA batteries in series, is 2.4 to 3.6V. 2 x AAA batteries in series is achieved with the standard battery holder. This implies: 1.5V AAA batteries must be used. 3.7V LTC batteries  cannot  be used. 1.5V Lithium Iron Disulphide batteries are ideal. Examples of these are the Energizer Ultimate AAA. These have go

Oyster 3 LoRaWAN® LED Behaviour

Published February 2nd, 2023 by Matthew Clark-Massera

The Oyster 3 LoRaWAN operates its LED from reset (due to battery insertion or downlink) until the end of the next uplink cycle. Thereafter, it is disabled to save power. After reset the following will be observed: A single 50 ms startup flash. A 4 second solid battery test indication. An additional 10 seconds solid if a brownout is detected. After w

Encoding the Oyster 3 LoRaWAN® Downlink

Published February 2nd, 2023 by Matthew Clark-Massera

You can find the full payload specification here and downlink encoder below. This encoder is written in Java Script and may be freely used as example code. To inspect the code, open this link and inspect the Java Script source. Usually this is done with F12 in your browser.  iframe generator  

Oyster 3 LoRaWAN® Configuration and Usage Guide

Published February 2nd, 2023 by Matthew Clark-Massera

Click this link to check out the Oyster 3 LoRaWAN on the Digital Matter Website. The Oyster 3 LoRaWAN provides a number of configurable parameters, to allow its behavior to be tailored to specific applications. Factors affecting the configuration you might choose include: How many messages per day your network will allow How often you intend to chan

Remora3G Firmware Release Notes

Published February 2nd, 2023 by Matthew Clark-Massera

As new versions of firmware are released, the release notes will be updated below. Subscribe to our technical newsletter to be notified of bug fixes and firmware updates. v1.41 Fixed low voltage behaviour for older devices v1.40 Added an AutoAPN entry. v1.39 Improved low battery voltage behaviour v1.38 Completed third party server support Added geof

Setting the Network Profile - LTE-M/NB-IoT devices

Published January 25th, 2023 by Matthew Clark-Massera

Set your Network Profile Our devices have a clever 'Autonet' firmware feature which will allow them to get on-air automatically, without applying special settings just to get online. However once you are online, it is recommended that you use our OEM Server interface to apply the correct settings for consistent and reliable performance, In order for

Mounting and Installation - Oyster3

Published January 31st, 2023 by Matthew Clark-Massera

The Oyster3 can be mounted on the asset to be tracked using screws, bolts, cable ties, magnetsor industrial adhesives. When choosing a mounting point, you have two competing goals: To minimise the chances of the device being accidentally crushed, dislodged or discovered by a thief.  To maximise the GPS and mobile reception and provide adequate venti

Oyster Cellular - Getting Started

Published February 1st, 2023 by Matthew Clark-Massera

The Oyster is a compact, rugged GPS tracking device that has been designed for tracking containers, trailers, skip bins, and other assets where super-long battery life is required without sacrificing the frequency of updates and performance. This getting started guide is only for the cellular version. The Oyster is also available with other low powe

How long will my back-up battery last? - Bolt2

Published January 25th, 2023 by Matthew Clark-Massera

The Bolt2 has an internal back-up battery. This allows for external power removed alerts to be sent immediately if the unit is unplugged or dislodged, and tracking to continue for some time.  When stationary, the device turns on the GPS periodically to get updated satellite information, speeding up subsequent fix acquisition. It will also heartbeat

Yabby Cellular Wifi Battery Estimate Calculator

Published January 31st, 2023 by Matthew Clark-Massera

See attached spreadsheet for a calculator to determine rough estimates for battery life for the Yabby Wifi.  Note There are many factors that determine how long batteries will last, do not take this calculator as a guarantee, it is only meant as a guide.     Yabby WIFI Battery Life Calculator Download

Setup For Pivotel Smartone devices

Published January 27th, 2023 by Matthew Clark-Massera

Telematics Guru can accept data from Pivotel SmartOne Devices.  To send data to Telematics Guru: Ask Pivotel to point your Smartone device to  http://<device-region>.telematics.guru:8080 Text When entering the device serial into Telematics Guru, please enter the entire serial, including any hyphens. The device region in the URL is important to

Simulating the Oyster 3 LoRaWAN® Uplink

Published February 2nd, 2023 by Matthew Clark-Massera

This tool allows you to construct synthetic uplink payloads to use for integration testing. If you're looking for a way to decode uplinks from a real device, try the uplink decoder here. You can find the full payload specification here.  

Monitoring Door Open/Close

Published January 27th, 2023 by Matthew Clark-Massera

Often the 'status' of a door, window, gate or other needs to be remotely monitored. This is to track things like unauthorised access to a room, building or container (perhaps with precious cargo inside). Our devices have the ability to do this via multiple methods: Connecting a reed switch to one of the digital inputs (most reliable, recommended met

Telematics Guru Third Party Device API

Published January 27th, 2023 by Matthew Clark-Massera

Telematics Guru supports a number of 3rd Party Device Types directly, such as Teltonika, Calamp and SPOT devices. Such devices can be configured as an asset and the Device Type selected from a dropdown. The specific payloads sent from these devices will be recognised by Telematics Guru and processed. However there is a 3rd Party Device API, to allow

Parameter Templates in Device Manager

Published January 25th, 2023 by Matthew Clark-Massera

Introduction to Parameter Templates Parameter templates are a collection of settings that can be applied en masse to a set of similar devices. You can have either Admin Parameter templates that consist of connectivity settings, or System Parameter templates that consist of settings that control how the device operates. Once a template is created, it

SensorData LoRaWAN® Firmware Release Notes

Published January 31st, 2023 by Matthew Clark-Massera

v2.3 - Added 1.0.2rB version of region US915 - Changes to test mode for LCTT compatibility - Fixed empty uplink on port 8 at startup - Added AS923-2/3 from final RP002-1.0.1 - Updated serial port commands for volume production - Fixed spurious reset indications in ABP 1.0 FCnt reset support, which could cause loss of downlink connectivity until the

Run Hour/ODO Discrepancies in TG

Published January 26th, 2023 by Matthew Clark-Massera

Run Hour and Odometer estimates for an asset are displayed in Telematics Guru in the following places. On the Odo/Hours Page On the Manage Assets Grid In the Maintenance Schedules view On the Live View (web and app) In Run Hours Reports How these readings are calculated is discussed here: Run Hours + Odometer in TG Run Hours Total Length of all trip

Live View - Telematics Guru

Published January 26th, 2023 by Matthew Clark-Massera

Introduction The Live View The Live View in Telematics Guru can be useful to see an instant representation of where your assets are and in what state they are currently in. Live View Refresh Rate The live view refreshes every 15 seconds and to reduce server load, browsers that have been idle for 4.5 minutes will suspend these automatic updates. You

Oyster LoRaWAN® Integration

Published January 31st, 2023 by Matthew Clark-Massera

The attached document describes all of the uplink and downlink message requirements for working with an Oyster LoRaWAN device. The downlink messages are not required for a simple implementation. Oyster LoRaWAN Integration 1.9.pdf (342 KB)

Decode SensorNode/SensorData LoRaWAN® Uplink Payload using your Browser

Published January 31st, 2023 by Matthew Clark-Massera

You can find the full payload specification here. We also provide worked examples, and a TTN decoder. This decoder is written in Java Script and may be freely used as example code. To inspect the code, open this link and inspect the Java Script source. Usually this is done with F12 in your browser. SensorNode/SensorData LoRaWAN Uplink Decoder Sensor

RS232 Passthrough Mode

Published January 31st, 2023 by Matthew Clark-Massera

The G120 & G150 are capable of acting as an intermediate between a server and an RS232 serial-connected device, passing along data received via an async message from the server, and logging data that is received via RS232 from the third-party device. This flexible feature is best utilised with a custom-built server that can interpret the data fr

SensorData - SDI-12

Published January 31st, 2023 by Matthew Clark-Massera

SDI-12 is a low data rate protocol designed for agricultural and scientific sensors (SDI-12 website). Each sensor can have an address between 0 and 9 (inclusive), and allows for up to 10 different 'measurements'. Each of these measurements can actually return a number of different values. For example, a soil moisture probe may have a soil moisture a

SensorNode Payload Decoding Examples

Published January 31st, 2023 by Matthew Clark-Massera

This article gives some examples of how to decode data from the SensorNode LoRaWAN. Temperature Readings Consider this example data from an Actility LoRaWAN backend: POST //SaveData.ashx?LrnDevEui=70B3D57050000DC4&LrnFPort=41&LrnInfos=TWA_100006667.21976.AS-1-1637 HTTP/1.1 Content-Length: 630 Content-Type: application/json Accept: */* Host:

SensorData LoRaWAN® - Configuration App

Published January 31st, 2023 by Matthew Clark-Massera

Download the app here:  https://www.oemserver.com/tools/SensorDataLoRaWAN/ConfigTool/setup.exe Notes : The app is for Windows only It automatically updates to the latest version before launching If the SensorData LoRaWAN device is asleep, it cannot detect that the cable has been plugged in. It must be woken up. To wake it, you can either hold the bu

SensorData LoRaWAN® - Configuration and Usage Guide

Published January 31st, 2023 by Matthew Clark-Massera

The SensorData provides a number of configurable parameters, to allow its behavior to be tailored to specific applications. Factors affecting the configuration you might choose include: How many messages per day your network will allow How often you intend to change the batteries, and the type of batteries in use How good the GPS reception is in you

SensorData/SensorNode Overview of Operation

Published January 27th, 2023 by Matthew Clark-Massera

Due to the low power/low data bandwidth nature of the device, the timing of samples is grouped into 'schedules'. Each schedule can have up to 4 items, for example; Battery voltage, SDI12 reading or GPS Position (see integration documentation for full list). These are all sampled together at the period defined in the schedules parameters, after which

Connecting the SensorNode to the Config App

Published January 27th, 2023 by Matthew Clark-Massera

The SensorNode only detects the config cable at power on (inserting batteries).  Batteries may need to be removed for a good 30-60s before it resets.  An indication that it has reset is that the LED comes on when the batteries are reinserted.  The LED flashes a few times, and then stays on while the app is talking to the SensorNode. If the App is cl

Hawk Installation - Testing Sensor Readings

Published January 26th, 2023 by Matthew Clark-Massera

Once the Hawk is installed in the field - we generally want to record and upload all sensor measurements - to check that our sensors are installed correctly and we have the right parameters applied. There are a few ways to achieve an 'on-demand' reading.  1. Device Startup Behaviour On startup, the Hawk Pro and Lite will run all tasks.  If the task

Oyster 3 LoRaWAN® Provisioning Tool

Published February 2nd, 2023 by Matthew Clark-Massera

The Oyster 3 LoRaWAN is configured using a DMLink adapter, and this LoRaWAN Provisioning Tool. For a detailed description of the tool and parameters, please consult the Oyster 3 LoRaWAN® Configuration and Usage Guide.

SensorData - Wiring up I2C Sensors

Published January 31st, 2023 by Matthew Clark-Massera

The SensorData and SensorNode support I2C peripherals, such as Digital Matter Temperature Probes, and Temperature/Humidity Sensors The SensorData and SensorNode expose 4 screw terminals for I2C, these are marked on the board.  3.3V: provides power to the sensor at 3.3V SDA: I2C data line. SCL: I2C clock line. GND: ground connection to the sensor. Be

Introduction to the Guppy LoRaWAN®

Published January 31st, 2023 by Matthew Clark-Massera

This article is meant to be an introduction to the Guppy LoRaWAN device. At a high level, the article discusses what it is and how to use it. You're going to want to read the datasheet too. Click this link to check out the Guppy LoRaWAN on the Digital Matter Website. What is the Guppy? It is a compact battery-powered “tag” that monitors Asset Locati

SensorNode LoRaWAN® Firmware Release Notes

Published January 27th, 2023 by Matthew Clark-Massera

v2.7 - Added AS923-4 region support for Israel v2.6 - Updated serial port commands for volume production - Fixed spurious reset indications in ABP 1.0 FCnt reset support, which could cause loss of downlink connectivity until the next rejoin v2.5 - Added 1.0.2rB version of region US915 - Added region AS923-2 from draft RP002-1.0.1 - Changes to test m

SensorNode: Wiring up a DM Temp/RH sensor

Published January 27th, 2023 by Matthew Clark-Massera

DM produces I2C temperature and relative humidity (RH) sensors. These are also known as "ambient sensors". These can be connected to the SensorNode to read temperature and/or RH at regular intervals. DM Temp/RH sensors use the following wiring colours: Red = Positive - connect to 3.3V Brown = Clock - connect to SCL Green = Data - connect to SDA Blac

Do I have to use the Location Engine with my Edge Devices?

Published January 31st, 2023 by Matthew Clark-Massera

Our Traditional devices ( "Edge" vs 'Traditional' GPS Devices ) like the Yabby3 and Oyster3 have full GPS modules and can compute GPS coordinates on board - this enables these devices to be used with all our integration methods - TCP via OEM server, HTTPS JSON via OEM server and Direct TCP. See here for more info on our Integration Methods Choosing

SensorNode - Digital Input Setup

Published January 27th, 2023 by Matthew Clark-Massera

General Setup The SensorNode has 2 digital inputs. These are general purpose on off inputs. They have configurable pull up/down resistors, to allow them to work with open drain style interfaces. The inputs will read as 'on' when driven above ~3.3 V, and 'off' when below ~0.8 V. The threshold voltages vary slightly depending on the pull up/down confi

Decode SensorData Sigfox Uplink Payload using your Browser

Published January 31st, 2023 by Matthew Clark-Massera

SensorNode/SensorData Sigfox Uplink Decoder This decoder is written in Java Script and may be freely used as example code. To inspect the code, open this link and inspect the Java Script source. Usually this is done with F12 in your browser. iframe generator      

SensorNode LoRaWAN® - Wiring up a DM Temperature sensor

Published January 27th, 2023 by Matthew Clark-Massera

DM produces I2C temperature probes. These can be connected to the SensorNode to read temperature at regular intervals. DM temperature probes use the following wiring colours: Red = Positive - connect to 3.3V Brown = Clock - connect to SCL Orange = Data - connect to SDA Black = Ground - connect to GND New DM Temp Sensor: In 2018 we introduced a new t

Simulating the Yabby 3 LoRaWAN® Uplink

Published January 31st, 2023 by Matthew Clark-Massera

This tool allows you to construct synthetic uplink payloads to use for integration testing. If you're looking for a way to decode uplinks from a real device, try the uplink decoder here. You can find the full payload specification here. Yabby 3 LoRaWAN Uplink Encoder Port: 1 Hex: 000e270700fd4314410fb4 Base64: AA4nBwD9QxRBD7Q= {latitude: 12.0 / 1e-7

Stationary Applications Requiring No Location [Yabby Edge]

Published February 2nd, 2023 by Matthew Clark-Massera

In certain stationary use cases, like tip detection, location updates may not be required. Clients can save money on lookup charges by configuring the settings below. Do note that currently there is no elegant way to achieve this, however this can be achieved with a few simple steps (a workaround). 1. Set System Parameters > Geolocation (Adv.) &g

IoT Devices - Digital Inputs

Published January 27th, 2023 by Matthew Clark-Massera

Digital inputs are available on the SensorData and SensorNode. These can be used to monitor the state of external devices or switches, or to count pulses - from a rain gauge, for example. The inputs have a maximum input of 48V, and anything about 2.5V or above is considered 'on'.  Hardware Capabilities SensorData LoRaWAN: 2 x DI on new stock. Only 1

SIM Cards and Data Usage [Yabby3]

Published January 31st, 2023 by Matthew Clark-Massera

Disclaimer This article is intended to assist partners in selecting between LTE-M/NB-IoT, determining costings, and choosing SIM providers. Advice is general and partners should conduct their own testing and make an informed decision. It should be noted that Digital Matter supply devices globally, but have offices based in the US, South Africa and A

Sealing the Device - Oyster3

Published January 31st, 2023 by Matthew Clark-Massera

The Oyster3 has an IP68 and IK07 rated housing. The device must be sealed carefully to achieve the IP68 rating. Ensure that the clear silicon seal is in good condition, is lying flat, and is not fouled by any plastic debris or other material. Close the housing, and gently squeeze it shut. Foam on the lid will compress against the batteries, holding

Sealing the Device [Yabby Edge]

Published February 2nd, 2023 by Matthew Clark-Massera

The Yabby Edge has an IP68 and IK06 rated housing. The device must be sealed carefully to achieve the IP68 rating. It is difficult to provide an exact torque figure with which to tighten screws. This is because upon first sealing the device, the screws cut threads into the nylon glass housing. So on the first assembly, the screws may be quite stiff.

G120 & G150 Iridium Quick Start Guide

Published January 31st, 2023 by Matthew Clark-Massera

Below are the minimum steps needed to set up a G120/G150 Iridium device. For iridium hardware requirements, please refer to this article, Iridium hardware requirements for the G120 and the G150. For a complete, detailed guide of the G120/G150 Iridium and how it works, see G120 & G150 Iridium Set Up and Operation.  Required Components: G120/G150

Speed Monitoring

Published January 26th, 2023 by Matthew Clark-Massera

Applies To Device Firmware Versions Dart3 2G, Dart3 4G and Dart3-Global All FW versions G70 2G and G70 4G All FW versions Additional logging options available in 1.14+ G120 2G and G120 4G All FW versions G150-Global All FW versions Remora3 4G 1.6+ see speed monitoring on the Remora3 for details on configuration for this device The Dart3, G70, G120,

Mounting and Installation [Yabby3]

Published January 31st, 2023 by Matthew Clark-Massera

The Yabby3 can be mounted on the asset to be tracked using screws, bolts, cable ties, magnets, or industrial adhesives. When choosing a mounting point, you have two competing goals: To minimize the chances of the device being accidentally crushed, dislodged or discovered by a thief To maximize the GPS and mobile reception and provide adequate ventil

Inactivity Monitoring/Timer [Yabby Edge LoRaWAN]

Published January 31st, 2023 by Matthew Clark-Massera

The Inactivity Timer is a simple timer that starts when a device ends it's trip. Once the configured time period has elapsed, a specified digital input is set to '1' - and the device can be set to upload immediately if required.  Some applications include: As an operations tool, to track churn, demurrage, or otherwise underutilised assets. For examp

Initial Provisioning [Yabby3]

Published January 31st, 2023 by Matthew Clark-Massera

This guide is intended to assist new users in getting an Yabby3 online for the first time. Once you have some experience with the device, this process may change slightly. e.g. you may wish to queue firmware and parameter updates before inserting a SIM and batteries - so that the device picks up new settings once it gets online. In the Box You will

Changing the Update Rate - [Yabby Edge Cellular]

Published February 2nd, 2023 by Matthew Clark-Massera

The Yabby Edge has different configurable tracking modes to best fit a variety of applications. Additionally, if an asset is stolen, the unit can be put into Recovery Mode, where the unit will live-track with an increased update rate for a configured time period, to aid in asset recovery.  The below recordings show how to quickly and easily configur

CalAmp Support

Published January 27th, 2023 by Matthew Clark-Massera

Telematics Guru (TG) now has a basic implementation of the CalAmp’s LM Direct protocol.  It is not possible to configure the device via TG.  CalAmp Hardware Setup: The device must use UDP Send messages to your TG server, port 8995. Server URLs for your region shown below It is important that the device be set to send messages in chronological sequen

Mounting and Installation [Yabby Edge Cellular]

Published February 2nd, 2023 by Matthew Clark-Massera

The Yabby Edge can be mounted onto an asset to be tracked using screws, bolts, cable ties, magnets, or industrial adhesives.  Additionally the multiple housing options (standard, collar and snap-together) offer many mounting alternatives.  When choosing a mounting point, you have two competing goals To minimise the chances of the device being accide

Hawk - Configure DM Temp Probe (Deprecated)

Published January 26th, 2023 by Matthew Clark-Massera

Related Articles Please ensure to also read the below for full details on configuring Tasks and I²C Sensors for the Hawk Hawk Operation - Task Schedules Configure I²C Sensor Readings   The DM Temperature Sensor is no longer manufactured by DM. If you have one on hand to use with the Hawk, setup is as below. Wiring Sensor Wire Agtech1 Bluetooth+ Red 

Third Party Device Support in Telematics Guru

Published January 27th, 2023 by Matthew Clark-Massera

Telematics Guru supports a number of 3rd party (non-DM) device types and BLE tags. While our range is extensive, there may be specific niche devices best served by a 3rd party device - or in some cases a user may wish to use an existing fleet of devices on TG. Supported Device List The current list of integrated devices in TG can be viewed by headin

Scheduled Maintenance Reminders (SMR)

Published January 26th, 2023 by Matthew Clark-Massera

Telematics Guru automatically calculates run hour and odometer estimates based on incoming device data. The Scheduled Maintenance Reminder (SMR) module allows jobs and maintenance schedules to be created for assets using this information.  Schedule Types Jobs can be run based on the following schedules: Odometer E.g. service the asset every 10 000km

Guppy LoRaWAN® Integration

Published January 31st, 2023 by Matthew Clark-Massera

The attached document describes all of the uplink and downlink message requirements for working with a Guppy LoRaWAN device. The downlink messages are not required for a simple implementation without after-hours support. Download: Guppy LoRaWAN 1.6

Dingtek Cement Drum Sensor

Published January 31st, 2023 by Matthew Clark-Massera

The G120 (firmware 2.9 and above) supports the use of the Dingtek DZ300 cement drum sensor. The sensor measures the RPM and direction of barrel rotation. When connected to a G120 via the RS232 port - the RPM is reported to the server in Analogue 11, with positive or negative values to indicate direction.  Wiring The sensor must be powered, and also

Hawk - Configure Action on Digital Input Change

Published January 27th, 2023 by Matthew Clark-Massera

The Hawk and I/O cards have Digital Inputs available.  Hawk Digital Input 1 Digital Input on the Baseboard Mapped to Hawk Digital Input 1 the Hawk data Configured under Digital Input 1 parameters Ag-Tech 1 has a digital input Uses I/O 7 on baseboard mapped to Hawk Digital Input 8 in the Hawk data Configured on the AgTech1 Card and Card Digital Input

Asset Expense Tracking - Getting Started

Published January 26th, 2023 by Matthew Clark-Massera

TG Asset Expense Tracking – Getting Started Introduction "Asset Expense Tracking" allows users to: Add expenses linked to an asset, with references to drivers, projects and departments if the organisation functionality permits. View captured expenses online. Report on captured expenses. Before you start: In order to use the Asset Expenses platform o

How long will my back-up battery last? - [Dart3]

Published January 26th, 2023 by Matthew Clark-Massera

The Dart3-4G has a 200mAh internal backup battery, while the Dart3-2G has an 850mAH internal backup battery. This allows for external power removed alerts to be sent immediately if the unit is unplugged or dislodged, and tracking to continue for some time.  When stationary, the device turns on the GPS periodically to get updated satellite informatio

Connect 1-Wire Keypad to a Wired Device

Published April 18th, 2023 by Matthew Clark-Massera

  Applies to: Device Firmware Version Dart3-2G and Dart3-4G All Versions G120-2G and G120-4G All Versions G70-2G and G70-4G All Versions 1-wire iButton keypads can be connected to a DM device. This provides an option for where a keypad is required instead of a swipe fob/access card. Some organisations prefer this as cards/fobs do not need to be dist

Default Tracking Parameters - [Yabby3]

Published January 31st, 2023 by Matthew Clark-Massera

By default, the Yabby3 is setup for GPS-based movement tracking. The following default settings apply: Update Rate: Out of Trip (stationary): 12 hour heartbeats. This is a GPS point and an upload every 12 hours. In Trip (on the move): Upload on trip start. GPS points every 2 minutes Upload every 30 minutes End a trip after 5 minutes of no movement (

Digital Matter I2C Temperature Probe Pinout

Published January 31st, 2023 by Matthew Clark-Massera

Several of our devices have an I2C interface, for connecting sensors. For a list of currently supported sensors, see Supported Sensors and Inputs. Sensors need to be integrated into device firmware before they can be used - but this is typically not a difficult process. Speak to us if you have specific requirements.  We manufacture a 2m long tempera

Using Tip Detection for Tamper Detection [Yabby Edge]

Published February 2nd, 2023 by Matthew Clark-Massera

Unlike our Remora 2/3 battery powered tracker, the Yabby Edge does not have the magnetic tamper detection feature - where an alert is set out when a magnet detaches from the Remora. It maybe tempting to use Tip Detection feature as a replacement. Unfortunately, we do not recommend using tip detection is not a viable solution to detect tamper events.

Hawk - SDI-12 Probe + MLX90614 Temp Sensor Application Example

Published January 27th, 2023 by Matthew Clark-Massera

This article details the wiring and parameter setup for connecting an Enviropro SDI-12 probe and MLX90614 IR Temperature sensor to the Hawk. In this example: a temperature reading is logged every 5 min from the MLX90614 an SDI-12 reading is logged every 60 min batches of readings are uploaded every 60 min together Further information: Be sure to als

Maintenance Lists

Published January 26th, 2023 by Matthew Clark-Massera

Telematics Guru supports Scheduled Maintenance Reminders (SMR), where Odometer and Run Hour estimates are used in order to schedule regularly occurring jobs, i.e. every 10 000km, 500 hours, or 3 months. This allows assets to be effectively maintained and preventative maintenance carried out.  Additionally, a history of all jobs completed is recorded

Location Engine Scanning Parameters and Lookups [Oyster Edge]

Published February 1st, 2023 by Matthew Clark-Massera

The Oyster Edge requires the use of our Location Engine to resolve/process GNSS, Wi-Fi and Cell Tower information in to standard location data (longitude and latitude coordinates). Here's everything you need to know about Location Engine and how you can configure the different lookups. And some information on Lookup billing. Location Engine : Digita

Creating Assets in Telematics Guru

Published January 26th, 2023 by Matthew Clark-Massera

To monitor or track an asset, it must be created on Telematics Guru. You can either create a single asset, duplicate an asset from an existing one, or Bulk import a csv of prepared assets. Creating a single Asset Login to Telematics Guru.  If you are mapped to multiple organisations, be sure to select or switch to the organisation you wish to create

2G/3G Multi-APN setup in Admin Parameters

Published January 25th, 2023 by Matthew Clark-Massera

2G/3G Only Note that this feature is only applicable to 2G and 3G devices   Digital Matter Cellular Devices have a number of ways to allow you to work with APNs. While the Auto-APN feature can be thought of as a way to get up and running quickly (plug and play), Multi-APN is a way to fix your APN settings and work with multiple roaming networks. Aut

Linking Documents to Pre-Start Checklists

Published January 27th, 2023 by Matthew Clark-Massera

Documents are able to uploaded to Telematics Guru, and linked to Checklists.  The document is able to be viewed on mobile as part of a checklist This supports uploading and viewing documents such as JHAs (Job Hazard Assessment) Equipment Operation Manauls Other regulatory documents This allows all required documentation to be easily accessed when us

G70 - FAQ

Published January 27th, 2023 by Matthew Clark-Massera

How do I install the device? See G70 - 3 Wire Install     Do I need to install in-line fuses? No, the device has internal protections including a self-resetting thermal fuse. The G70 is load-dump and short circuit protected and tested - so that it can withstand the harsh electrical environments of vehicle installations.      Does the G70 do Driver I

Yabby 3 LoRaWAN® Integration

Published January 31st, 2023 by Matthew Clark-Massera

The attached document describes all of the uplink and downlink message requirements for working with an Yabby 3 LoRaWAN device. The downlink messages are not required for a simple implementation. Yabby 3 LoRaWAN Integration    

Eagle and Falcon - External Voltage Disconnects

Published January 27th, 2023 by Matthew Clark-Massera

The Eagle and Falcon can be powered via Battery or External Power and/or Batteries.  The options are: 5-16V external power only (i.e. just hard wire to power) Battery power only Eagle: 4 x C Cells in the included battery holder  Falcon: 3 x AAA in the attached battery holder  Both - whichever is the higher voltage will be used.  For the last option,

Custom APN setup requirements

Published January 25th, 2023 by Matthew Clark-Massera

Clients commonly have custom APNs for their SIM cards. Here is a list of requirements for using a custom APN with a DM device: Enable Mobile Terminated SMS: to get the APN settings onto the device, a configuration SMS is needed. This will get the device "on air". The #*,APN,name,username,password SMS is the one you need. Later, once the APN is prove

Hawk FAQ

Published January 26th, 2023 by Matthew Clark-Massera

See the Hawk product page and technical specs on our website for full device details https://www.digitalmatter.cothe m/devices/hawk/  Some FAQ below: Hawk Pro vs Hawk Lite The Hawk Pro is the new name of the original Hawk PCB. The Hawk Lite is a new PCB option for the Hawk IoT Datalogger. The Hawk Lite is compatible with lower energy, lower cost bat

Default Tracking Parameters [G120]

Published January 31st, 2023 by Matthew Clark-Massera

Below is how a G120 operates out of the box Stationary - Hourly Heartbeats The device will log a heartbeat record, connect to the server and refresh its GPS data every 60 minutes. Trip Tracking - Wired and Emulated ignition - The G120 will start a trip if either the Ignition wire is pulled high, i.e, over 5v is applied to the ignition wire, or Movem

GPS Jamming and Interference Detection

Published January 26th, 2023 by Matthew Clark-Massera

Applies to: Device Bolt2-4G Dart3-2G and Dart3-4G/Bluetooth G120-2G and G120-4G G150-Global G70-2G and G70-4G/Bluetooth™ Our wired devices support GPS Jamming and GPS interference detection. The available parameters are split into 2 tabs in Device Manager:  GPS Jamming (Adv)  GPS Jamming IOs (Adv)   GPS Jamming (Adv) For 4G Devices, the GPS Jamming 

Yabby GPS FAQ

Published January 31st, 2023 by Matthew Clark-Massera

How long will the batteries last? Short answer: Up to 3 years at 1 daily update. Around 6-18 months generally with other configurations and applications. Long (more accurate) answer: It depends on many things, see here for details along with a battery life calculator. The Yabby GPS is similar in design to our other devices, the Remora2 and Oyster2,

Falcon Cellular - Battery Recommendations and Estimates

Published January 27th, 2023 by Matthew Clark-Massera

Please see the attached spreadsheet for a calculator to determine rough estimates for battery life for the Falcon Cellular.  Battery Life, Battery Capacity and the Battery Good Flag Please read out discussion paper on battery life and capacities for DM Devices The Falcon Cellular has multiple power options: Line Power (5-16V input range) 3 x AA Batt

Yabby3 - Tracking Modes

Published January 31st, 2023 by Matthew Clark-Massera

The Yabby3 operates in a similar way to the Oyster3. Default Parameters - Out of the box, the device will: Heartbeat every 12 hours Log a position every 2 min, and upload every 30 min while in trip.  The Sony GPS module used in the Yabby3 has two operation modes Performance: The default mode of operation. The GPS works slightly harder to get a fix,

Custom Map Overlays in TG

Published January 26th, 2023 by Matthew Clark-Massera

Telematics Guru can support Custom Map Overlays.  Map overlays will be displayed on the following views: TG Web Live View Trip History Map View Asset Daily Coverage Map TG App Live View Overlays are disabled by default, and must be enabled on the Settings page within the app Often users such as mine sites wish to be able to overlay aerial images, or

Telematics Guru - Update Asset Project From Destination Geofences

Published January 27th, 2023 by Matthew Clark-Massera

Against an asset in Telematics Guru, we have an option under the Advanced Tab: Update Asset Project from Destination Geofences. The function of this feature is described in the blue tooltip when we mouse-over.  What does it do? When our assets make trips, if they end a trip in a geofence, the project at that point will be changed to the Geofence's p

Yabby Edge - Upload Settings - Early Cellular Registration AbortYabby Edge - Upload Settings - Early Cellular Registration Abort

Published February 2nd, 2023 by Matthew Clark-Massera

Applicable to next-gen devices using the Nordic NRF9160 modem A failed upload uses up to 20 times the power of a successful upload. This is because a failed upload scans the bands for 3 minutes (registration timeout), while a successful upload is typically done within 5 – 10 seconds. A failed upload is just a complete waste of energy! Since we spend

Stationary Applications Requiring No Location [Oyster Edge]

Published February 1st, 2023 by Matthew Clark-Massera

In certain stationary use cases, like temperature sensing using Bluetooth probes or tip detection, location updates may not be required. Clients can save money on lookup charges by configuring the settings below. Do note that currently there is no elegant way to achieve this, however this can be achieved with a few simple steps (a workaround). 1. Se

Oyster2 Firmware Release Notes

Published February 1st, 2023 by Matthew Clark-Massera

Subscribe To Updates Subscribe to our technical newsletter to be notified of bug fixes and firmware updates v2.23 / 3.23 Added support for stats reset via async message v2.22 / 3.22 Trip Trimming Support v2.21 / 3.21 Fix for repeated "Modem turn off failed" issue v2.20 / 3.20 Added support for Oyster2 4G variant v2.19 / 3.19 Device statistics fix v2

Monitor a PTO/Fuel Pump

Published January 26th, 2023 by Matthew Clark-Massera

Applies to: Device Firmware Version Dart3-2G and Dart3-4G All Versions G120-2G and G120-4G All Versions G70-2G and G70-4G All Versions The wired devices have Digital Inputs that can be used to monitor a secondary bit of equipment on an asset, i.e. sprayer, fuel pump, PTO. In most cases, we wire and configure the input in the same way as our dedicate

Configure I²C Sensor Readings

Published January 26th, 2023 by Matthew Clark-Massera

The I²C interface is commonly used for connecting sensors to data-logging devices like the Hawks. I²C Sensors use 3 lines Power (typically 3V3, but sometimes 5V) SDA (Serial Data Line) - data is transmitted over this line SCL (Serial Clock) - Clock signal I²C is a multi-controller/multi-target interface - meaning multiple sensors can be connected to

Create a New Organisation

Published January 26th, 2023 by Matthew Clark-Massera

Partners and Organisations In Telematics Guru Organisations are used in Telematics Guru to separate different end clients. You can have many organisations under one company, where end users usually log into an organisation to view their assets. Organisations need to be set up and structured by the account with partner level permissions. Partner (You

Push Notifications in the TG App

Published January 26th, 2023 by Matthew Clark-Massera

Telematics Guru users have the ability to receive push notifications via the mobile app. This eliminates the need for SMS message notifications and the associated costs. It also enables tablets with a data connection to receive alerts.  Configuration 1. Enable Push Notification Provider on Organisation This should be the case by default. It can be c

Falcon Cellular - How to setup analogue sampling

Published January 27th, 2023 by Matthew Clark-Massera

This article explains how to setup the Falcon Cellular device for analogue sampling. We will consider an analogue sensor that can be powered by the 3.3V output from the Falcon. Other sensor types may need a larger voltage. Consider using the battery voltage and switched ground to power these. This is not covered below. Wiring: Ground pin of the sens

4G Battery Powered Device Behaviour Effects - EMnify (multi-IMSI sims)

Published January 25th, 2023 by Matthew Clark-Massera

In order for our battery powered devices (including Edge devices) to roam on EMnify multi-IMSI sims they require that devices conform to certain specifications. That includes a minimum network registration timeout to allow for IMSI switching. This article outlines the settings that need to be applied to the device if using EMnify.  To use the EMnify

Hawk - Connecting GA Weather Station

Published January 27th, 2023 by Matthew Clark-Massera

Related Articles Please ensure to also read the below for full details on configuring Tasks for the Hawk Hawk Operation - Task Schedules   3rd Party Sensor The GA Weather Station is a 3rd Party sensor - the advice given below is general. Specific guidance on installation and usage should be obtained directly from the manufacturer. The instructions b

Connecting the MLX90640 Infrared Camera

Published January 31st, 2023 by Matthew Clark-Massera

The MLX9060 I2C infrared camera can be directly connected to the Eagle I2C port as shown below: However, for proper low noise performance, a 100 nF and a 10 uF decoupling capacitor are required. They should be as close to the sensor pins as possible. If you don't want to create a PCB breakout board for this purpose, it is possible to carefully solde

Telematics Guru - Alert Token Definitions

Published January 26th, 2023 by Matthew Clark-Massera

Message Tokens are keywords that can be added to messages and are replaced by the appropriate, relevant text when the actual message is sent. For example: Adding the token {Event.Latitude} will result in the message containing the latitude of where the event occurred. The tokens are not always available in every instance. The message sending service

"Edge" vs 'Traditional' GPS Devices [Oyster Edge]

Published February 1st, 2023 by Matthew Clark-Massera

Here are the differences between our Edge and Non-Edge (Tradtional) Devices - "Edge" vs 'Traditional' GPS Devices : Digital Matter Support 

My Shipments - Download Shipment Details (IMEIs, serials, keys, etc)

Published January 25th, 2023 by Matthew Clark-Massera

OEM has a 'My Shipments' tab where users are able to see shipments to their Distributor / Vendor / Client. The user is also able to download their shipping reports pertaining to their shipments. Note The user is required to have a 'MyShipments' permission enabled.   Shipments can be searched by 'Shipment Id' or 'Order'. Summary Report The Summary sh

G100 Harness definition V1

Published January 31st, 2023 by Matthew Clark-Massera

G100 Harness definition V1

Harsh Driving Event Setup

Published January 25th, 2023 by Matthew Clark-Massera

Applies to: Device Firmware Version Bolt2-4G  All Versions Dart3-2G and Dart3-4G All Versions G120-2G and G120-4G All Versions G150-Global All Versions G70-2G and G70-4G All Versions The above hard-wired devices can log the below accelerometer based harsh driving events: Harsh Acceleration Harsh Braking Harsh Cornering Installation and Auto-Orientat

Sentrius Laird BT510 Multi-Sensor

Published January 27th, 2023 by Matthew Clark-Massera

Our Bluetooth® gateway devices support the reading of generic tag data (see Integrating Tags and 3rd Party Bluetooth® Tag Support) without needing special firmware modification per tag. This means various 3rd party tags can be quickly and easily made to work with our devices. An example of this is the Laird BT510 this is a Bluetooth® 5, long-range m

Setting up a Yabby Edge LoRaWAN Device via LoRIot

Published January 31st, 2023 by Matthew Clark-Massera

1. Setup your Yabby Edge LoRaWAN devices using the LoRaWAN Provisioning Tool The LoRaWAN provisioning tool can be downloaded here.Please see Yabby Edge LoRaWAN - configuration and Usage. Note: It is important to configure the Region and Scanning parameters. 2. Enable Uplink/Downlink data There are two principle objectives: Allow Loriot to send data

Analogue Input (Advanced)

Published January 26th, 2023 by Matthew Clark-Massera

Advanced System Parameters: Analogue Input Applicability: Device Analogue Input Range Analogue Input Pin Dart3-2G, Dart3-4G, Dart3-4G Bluetooth®, Dart3 Global Bluetooth® 0-40V 12-way harness, this is the Orange/White wire, pin 6 G120-2G and G120-4G 0-30V 24-Wire harness, this is the Orange/White wire, pin 1 G70-2G, G70-4G, G70-4G Bluetooth® 0-40V 10

G100 Battery MSDS

Published January 31st, 2023 by Matthew Clark-Massera

See attached LP603449-PCM-NTC-LD MSDS - G100.pdf

Sealing the Device [Yabby3]

Published January 31st, 2023 by Matthew Clark-Massera

The Yabby3 has an IP68 and IK06 rated housing. The device must be sealed carefully to achieve the IP68 rating. Ensure that the clear silicon seal is in good condition, is lying flat, and is not fouled by any plastic debris or other material. Close the housing, and gently squeeze it shut. Foam on the lid will compress against the batteries, holding t

Yabby Edge Cellular - Location Scanning Parameters

Published February 2nd, 2023 by Matthew Clark-Massera

The Yabby Edge Cellular determines its location differently to traditional GPS devices. In order to get a position, the following occurs: The device scans for GNSS and Wi-Fi signals. This is satellite data (time delay and sat number) - along with nearby Wi-Fi access points        This article covers the settings for these scans. This data is sent to

Connecting a DM iButton Reader

Published January 26th, 2023 by Matthew Clark-Massera

Supported Devices Dart3-2G and Dart3-4G G120-2G and G120-4G G150-Global G70-2G and G70-4G             Digital Matter can supply an iButton reader and tags for use with the above devices.  The Digital Matter iButton Reader has the following wire colours: Wire Color Function Red iButton Signal Line Black Ground Green Green LED   (with 1000 ohm resisto

Battery Voltage Discharge Curves [Yabby 3]

Published January 31st, 2023 by Matthew Clark-Massera

Measuring battery voltage is more complicated than it sounds. Exactly when and how a battery is measured will influence the results. The results will be different if you measure the voltage loaded or with no load. This is why if testing batteries we recommend using a battery tester that applies a load before taking a measurement instead of simply a

G62 FAQ

Published January 27th, 2023 by Matthew Clark-Massera

How do I install the device? See Wired Device Installation Guide     Do I need to install in-line fuses? No, the device has internal protections including a self-resetting thermal fuse. The G62 is load-dump and short circuit protected and tested - so that it can withstand the harsh electrical environments of vehicle installations.      Does the G62

Oyster Sigfox Config App

Published January 27th, 2023 by Matthew Clark-Massera

As discussed in this article, the Windows config application with the USB adapter cable is one of two options for changing settings and updating firmware on the Oyster Sigfox device. This article gives more detail on how to install and use the application. Before you start: You will need: An Oyster Config Adapter from Digital Matter. This is a USB t

Battery Life Estimates - Yabby Edge

Published February 2nd, 2023 by Matthew Clark-Massera

The Yabby Edge uses advanced low-power location-solving techniques to provide exceptional battery life - allowing 'deploy once' operation. The batteries will not need to be changed for an assets useful life! This cuts down on cost, effort, and potential issues.    How does it save power? "Traditional" devices with on-board GPS modules will wake when

SIM Cards and Data Usage - Oyster3

Published January 31st, 2023 by Matthew Clark-Massera

Disclaimer This article is intended to assist partners in selecting between LTE-M/NB-IoT, determining costings, and choosing SIM providers. Advice is general and partners should conduct their own testing and make an informed decision. It should be noted that Digital Matter supply devices globally, but have offices based in the US, South Africa and A

Falcon - Getting Started

Published January 27th, 2023 by Matthew Clark-Massera

The Falcon Cellular is a super-smart, battery-powered tracking device in a rugged IP67 housing - in particular designed for asset location with temperature monitoring. digitalmatter.com Read more about this on our site! Datasheet & High Resolution Images  Falcon Downloads View the latest tech-specs and high resolution device images for the Falco

How do I Activate a Movement Alert?

Published January 26th, 2023 by Matthew Clark-Massera

Movement Alert is a one-touch feature to allow the user to set an "anchor" to the asset so that it will notify the user when it next moves. It is ideal for trailers, recreational equipment, horse floats, boats, motorbikes, dollies, equipment, and even vehicles where the user is concerned about theft of an asset when leaving it temporarily at a locat

Technical Drawing - [Yabby3]

Published January 31st, 2023 by Matthew Clark-Massera

See attached Yabby3 housing drawing - providing external dimensions. If spare screws are required, the ones supplied are 2.5mm x 8mm screws from Bossard Yabby Housing Drawing  

How long will my back-up battery last? - [G70]

Published January 27th, 2023 by Matthew Clark-Massera

The G70 has a 1100mAh internal back-up battery. This allows for external power removed alerts to be sent immediately if the unit is unplugged or dislodged, and tracking to continue for some time.  When stationary, the device turns on the GPS periodically to get updated satellite information, speeding up subsequent fix acquisition. It will also heart

Time and Attendance in Telematics Guru

Published January 26th, 2023 by Matthew Clark-Massera

Telematics Guru features a "Time and Attendance" module. This module was originally developed for use with the DM Console - a now deprecated product. The console allowed operators to enter codes to log on/off for work.  Now, the TG Mobile app supports  Checklists  - so the app can capture when an employee logs on or off - along with a bunch of other

Geofence Downloads to Device

Published January 27th, 2023 by Matthew Clark-Massera

Geofences can be downloaded directly from the server onto supported devices, allowing for a wide range of applications, including: Setting custom speed limits on private property, such as a mine site, and triggering a buzzer when the driver exceeds the limit. Turning on a vehicle's emergency lights in a specific area. Disabling cellular communicatio

Yabby Wi-Fi FAQ

Published January 31st, 2023 by Matthew Clark-Massera

How long will the batteries last? Up to 6 years with once daily updates. For a battery calculator, see Battery Life, Battery Capacity Estimate & Low Battery Flag     How do I change the update rate? See How to change the update rate on the Oyster2, Remora2 and Yabby     What are the default tracking settings? Out of Trip - 12 Hour UpdatesThen wh

Connect Hikvision Keypad

Published January 26th, 2023 by Matthew Clark-Massera

This article shows configuration steps to enable a Hikvision keypad to be read by the below list of devices. Consult the keypad manufacturer for detailed technical information. Supported Devices Dart3 (2G and 4G) G70 (2G and 4G) G120 (2G and 4G)  G150 Global Product information Hikvision DSK1107 Web Page User Manual Australian Supplier - Security Wh

Eagle: SDI-12 configuration and compatibility

Published January 27th, 2023 by Matthew Clark-Massera

The SDI-12 interface is a low data rate protocol designed for agricultural and scientific sensors (SDI-12 Website). A soil moisture probe will often have multiple sensors along its length. Each sensor can have an address between 0 and 9 (inclusive), and allows for up to 10 different 'measurements'. Each of these measurements can actually return a nu

SIM Cards and Data Usage - [Yabby Edge Cellular]

Published February 2nd, 2023 by Matthew Clark-Massera

Disclaimer This article is intended to assist partners in selecting between LTE-M/NB-IoT, determining costings, and choosing SIM providers. Advice is general and partners should conduct their own testing and make an informed decision. It should be noted that Digital Matter supply devices globally, but have offices based in the US, South Africa and A

Run Hours + Odometer in TG

Published January 26th, 2023 by Matthew Clark-Massera

Run Hours + Odometer in Telematics Guru Telematics Guru can calculate run hour and odometer estimates based on device data. It does this in the following way: Run Hour Calculation The time for which an asset's 'Ignition' input is active is added up by the system to provide the result. By default, for DM devices this is Digital Input 0.  If you are u

Yabby Edge Improved GNSS Performance

Published February 2nd, 2023 by Matthew Clark-Massera

In case you missed it On top of the below improvements, the Location Engine (server side) also makes use of 'Combo-Scan' fuctionality to improve location accuracy. See Edge Device GNSS 'Combo Scan'   Overview The Yabby Edge makes use of the Semtech LR1110 Integrated Circuit to scan for GNSS satellites and Wi-Fi access points. Digital Matter and Semt

Yabby3-4G Release Notes

Published January 31st, 2023 by Matthew Clark-Massera

1.14 Allow updates to MFW 1.3.4 Enabled multi-cell tower scan - requires Modem Firmware Update version 1.3.4 1.12 Connection timeout change 1.11 Parameter introduced to allow  GPS fix on device heartbeat to be disabled. Support for Modem Firmware Update to 1.3.3 Added support for stats reset via async message v1.10  (Big update!) SDK and Modem Libra

LiPo battery storage [G70]

Published January 27th, 2023 by Matthew Clark-Massera

The G70 comes fitted with a 1100mAh, Lithium Polymer (LiPo) internal back up battery. This allows for External Power Removed Alerts if the device is unplugged, and for the device to track for some time after being unplugged LiPo batteries are commonly used as they are light weight and compact.  Over time and use, batteries degrade, such that their o

TG - Password Policy

Published January 26th, 2023 by Matthew Clark-Massera

Telematics Guru enables a password policy to be set either across the entire partner account, or on a per-organisation basis. The policy enforces the minimum password complexity (i.e. min length, letters, numbers and symbols) as well as setting an expiry time after which password must be changed.  To set the password policy, simply edit the organisa

Troubleshooting - No GPS Fix

Published January 26th, 2023 by Matthew Clark-Massera

Most issues with obtaining fixes are the result of a signal issue: The device is temporarily in an area of limited/no GPS signal, like a basement The device is installed such that the signal is blocked: Buried deep in an asset, around lots of metal GPS antenna poorly orientated, facing down towards the ground In general, (1) will resolve itself once

Digital Matter I2C Temperature Sensor Datasheet

Published January 31st, 2023 by Matthew Clark-Massera

For specifications and a downloadable PDF datasheet, see our website: https://www.digitalmatter.com/our-devices/peripherals/ Temp/Hum Sensor: Download Temp/Hum Datasheet Temperature Probe: Download I2C Datasheet  White label versions can be found HERE

SIM Cards and Data Usage - Barra GPS

Published February 28th, 2024 by Matthew Clark-Massera

  Disclaimer This article is intended to assist partners in selecting between LTE-M/NB-IoT, determining costings, and choosing SIM providers. Advice is general and partners should conduct their own testing and make an informed decision. It should be noted that Digital Matter supplies devices globally but has offices based in the US, South Africa, an

Hawk - Control Output from Server

Published January 27th, 2023 by Matthew Clark-Massera

The Hawk has various digital outputs available, based upon which plug in I/O card is used. Switched Ground 3V3 output VBoost Output (can be configured to 5V or 12V) See Hawk Baseboard + Plug in Cards - Wiring+Pin Out All 3 outputs can be controlled from the server. However the Hawk also has the ability to configure a variety of on-board control opti

Initial Provisioning [Yabby Edge]

Published February 2nd, 2023 by Matthew Clark-Massera

This guide is intended to assist new users in getting an Yabby Edge online for the first time. Once you have some experience with the device, this process may change slightly. e.g you may wish to queue firmware and parameter updates before inserting a SIM and batteries - so that the device picks up new settings once it gets online. In the Box You wi

Points of Interest and Distance Order Markers

Published January 26th, 2023 by Matthew Clark-Massera

Points of Interest and Distance Order Markers are available on the live view in Telematics Guru, and help to quickly identify the answers to questions like "Which of my assets is nearest to this place/point?" - and make the map easier to view at a glance.  Some use cases that Points of Interest have been used for include: A security company offers s

The Asset Utilisation Report

Published January 26th, 2023 by Matthew Clark-Massera

The Asset Utilisation is designed to classify assets as 'Utilised' if they have the following conditions: Time spent IN TRIP OUTSIDE a specific GEOFENCE BY selected assets WITHIN a declared time period.  This is useful for fleet management and tracking depot usage, or time spent outside a particular area. For example, we may consider assets well uti

How often are Sigfox Downlinks requested?

Published January 27th, 2023 by Matthew Clark-Massera

The Oyster Sigfox device can receive configuration changes via the Sigfox Downlink mechanism. Usually the device only sends uplinks, but the downlink is a way to get data from the server down to the device. In the Sigfox system, the device must request a downlink. The number of downlinks available is limited by the Sigfox plan. Downlinks are relativ

Hawk Operation - Task Schedules

Published January 26th, 2023 by Matthew Clark-Massera

The Hawk's operation centres around the concept of a "Task" - which is a selection of actions, performed on a schedule, or in response to an event (like a Digital Input Change or Analogue threshold). Up to Four tasks can be configured, with up to 5 actions each.  If we don't configure a task, the Hawk by default will do nothing but heartbeat once da

Plug and Play Options for Wired Devices

Published January 27th, 2023 by Matthew Clark-Massera

There are scenarios where a plug and play option is preferable, such as rented assets, or temporary testing.  The Bolt2 is a plug and play tracker which simply plugs into the OBDII port and can even be easily hidden with a Y-splitter cable For other device types, there are other options. Digital Matter supply OBDII and Cigarette Lighter Harness opti

[HAWK] - Configure SDI-12 Readings

Published January 27th, 2023 by Matthew Clark-Massera

The SDI-12 interface is a low data rate protocol designed for agricultural and scientific sensors ( SDI-12 Website ). A soil moisture probe will often have multiple sensors along its length. Each sensor can have an address between 0 and 9 (inclusive), and allows for up to 10 different 'measurements'. Each of these measurements can actually return a

SIM Cards and Data Usage - [G70]

Published January 27th, 2023 by Matthew Clark-Massera

Disclaimer This article is intended to assist partners in selecting between LTE-M/NB-IoT, determining costings, and choosing SIM providers. Advice is general and partners should conduct their own testing and make an informed decision. It should be noted that Digital Matter supply devices globally, but have offices based in the US, South Africa and A

Default I/O Mappings [Dart3]

Published January 26th, 2023 by Matthew Clark-Massera

Here are the Default I/O Mappings for Digital Matter's Dart 3 tracker. You can change some of these mappings on OEM server - we do not recommend changing these unless you know what you are doing. Additionally, some firmware features provide their 'result' as a Digital Input flag - i.e. Idling flag. It is important when configuring these inputs to av

Device Manager FAQ

Published December 15th, 2023 by Matthew Clark-Massera

What is Device Manager? Device Manager is the evolution of our Device Management platform OEM Server. It is your all-in-one solution for managing your devices! Featuring: Streamlined Device Management: Simplify device integration, updates, and configuration, saving time and resources. Effortless Over-The-Air Updates: Maximize device performance and

Edge Device GNSS 'Combo Scan'

Published January 31st, 2023 by Matthew Clark-Massera

In case you missed it Make sure to update your device firmware to the latest version to take advantage of on-device GNSS scanning performance improvements. See Yabby Edge Improved GNSS Performance   1. Overview The Yabby Edge & Oyster Edge makes use of the Semtech LR1110 Integrated Circuit to scan for GNSS satellites and Wi-Fi access points. Dig

User Support Permissions + Access to Multiple Organisations

Published January 26th, 2023 by Matthew Clark-Massera

How does user asset and organisation access work? The TG Getting Started Guide covers the structure of organisations and user accounts. The hierarchy is,  Partner Account (the reseller/tracking company) Organisations (each customer - i.e. a brick laying company with 40 assets they are tracking) So when a reseller signs up a new customer, they create

Device Manager - What IP addresses should I allow through my firewall?

Published January 25th, 2023 by Matthew Clark-Massera

Below are the IP addresses used by Device Manager (OEM Server).  Integrators (or even network operators) may need to white list the IPs shown under "Device Data from OEM server to Software Platforms" to ensure that data can make it through their firewall.   US EU Traffic Type  DNS Entry IP Address DNS Entry IP Address Device to OEM Server (Incoming

DM Profiling Counters to MyGeotab 3rd Party API Mappings

Published January 25th, 2023 by Matthew Clark-Massera

The Digital Matter battery powered devices record Profiling Counters to allow the performance of the devices to be monitored.  The MyGeotab 3rd party API allows these counters to be send to MyGeotab. This describes those mappings: Counter Name Checkmate Code Unit Battery Voltage Code 5 millivolts Battery Percentage Code 9 battery percentage x 100 Su

Eagle - Wiring up a DM Temperature Sensor

Published January 27th, 2023 by Matthew Clark-Massera

This guide is to be read in conjunction with the DM Temperature Sensor Datasheet. Digital Matter manufacture and supply a Temperature/Humidity (Ambient) I2C Sensor, and an I2C Temperature Probe. Check the above data sheet for specifications. Ambient Sensor (Temperature and Humidity Sensor)  I2C Temperature Probe Connecting the Sensors Please note, W

Eagle - Getting Started

Published January 27th, 2023 by Matthew Clark-Massera

The Eagle is a battery-powered data logger that provides GPS asset tracking while catering for an impressive array of inputs and outputs and different sensor interfaces. It comes in either 2G or 4G LTE Cat-M1 / NB-IoT versions. digitalmatter.com See the product page for more specifications. Datasheet & High Resolution Images  Eagle Downloads Vie

4G Network Settings

Published January 25th, 2023 by Matthew Clark-Massera

WARNING: If you misconfigure the 4G Network settings, the device will NOT be able to connect to OEM and will NOT receive SMS commands. Once connectivity is lost, the only way to restore it is by physically retrieving the device and reconfiguring it using a wired Provisioning Tool.   While 4G devices offer better network coverage and longer battery l

G62 Wiring Diagrams

Published January 27th, 2023 by Matthew Clark-Massera

For a discussion on setting up driver ID or immobilisation methods with the G62, see the article here 1. Wiring diagram for immobilisation with Driver ID The configuration shown is for use with system parameters - DRIVER ID: Immobilise On no Driver ID, and the OUTPUT set to Immobiliser and Active Low. 2. Wiring Diagram for Telematics Guru ASYNC immo

OEM Server Misc

Published January 25th, 2023 by Matthew Clark-Massera

One developer hack, is that when you are on the device detail page you can open the developer tools (F12) and type the following command in the console “GetDatedServerLog('7 July 2019')” this will print out the devices log on a date other than the “Last Connected Date”.

G120 Webinar FAQ

Published January 31st, 2023 by Matthew Clark-Massera

What shape Geofences can be stored on the device? Rectangles, Polygons or Freehand?  Polygons - for more information see Geofence Downloads to Device How is Driver ID validation done, on the device, or in the cloud/on the server? This is done on a device level. If it was done in the cloud, and the device was out of coverage, you would not be able to

Hawk - GPS Settings

Published January 26th, 2023 by Matthew Clark-Massera

The Hawk has on-board GPS for scheduled location updates. This can help with locating the install location - it reduces the overhead of needing to log where each and every Hawk is installed for a deployment - instead we can simply run the GPS to obtain this information quickly.  The Hawk parameters available allow for fine-grained control of the GPS

Dart Battery MSDS

Published January 26th, 2023 by Matthew Clark-Massera

See Attached LP502040-PCM-NTC-LD MSDS - Dart.pdf

Oyster2 - FAQ

Published February 1st, 2023 by Matthew Clark-Massera

How long will the batteries last? Short answer: Up to 7 years at 1 daily update. Around 1-3 years generally with other configurations and applications.          Long (more accurate) answer: It depends on many things, see  here  for details along with a battery life calculator.      How do I change the update rate? See  How to change the update rate

Geo-Fence Bulk Import

Published January 27th, 2023 by Matthew Clark-Massera

There are 2 ways to import geofences in bulk to an organisation. Copy from Organisation to Organisation To import geo-fences from another organisation within Telematics Guru.  Go to Admin >> Geofences Select Import From Organisation Select the organisation you wish to copy Geofences from Select the Geofences you wish to import via the checkbox

Eagle - Firmware Release Notes

Published January 27th, 2023 by Matthew Clark-Massera

Subscribe To Updates Subscribe to our technical newsletter to be notified of bug fixes and firmware updates. Versions below require BLE version 2.0 and newer for new features. Supports all 2.X. v2.20 Added support for a 3rd Task in parameters. Fixed issue with synced tasks running twice when device time gets updated. v2.19 Fixed GA Station (RS485) c