Telematics Guru Mobile Release Notes

Published January 26th, 2023 by Matthew Clark-Massera

2.33.0 (iOS and Android): 11 June 2024 Enhancements: Support for viewing asset speed telemetry Support for immobilisation with expiry on support devices Fixes: Minor improvements to stability 2.32.0 (iOS and Android): 17 April 2024 Enhancements: Support for BLE Driver ID Maintenance: Improved de-clustering at max zoom Fixes: Fixed issue where recove

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    

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

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

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

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

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

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

Inactivity Monitoring/Timer [Oyster 3 LoRaWAN]

Published February 2nd, 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

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

Welcome to the Device Manager API

Published December 4th, 2024 by Matthew Clark-Massera

Before you start: Device Manager is our cloud-based Device Management Platform that provides visibility and control over your Digital Matter devices and ensures that they continue to perform at their best for longer. Before you work with the API - we recommend familiarising yourself with Device Manager and the User Interface. For this, see Welcome t

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

G62 Cellular 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 v2.15 / 3.15 Bugfix for runtime incrementation v2.13 / 3.13 Improved run hour incrementation v2.12 / 3.12 Reduced the risk of the 4G modem entering an unrecoverable fault state v2.11 / 3.11 Fix for repeated "Modem turn off failed" issue v2.10

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

Yabby Cellular Wi-Fi - Product Change Notifications

Published January 31st, 2023 by Matthew Clark-Massera

2020.10.27 - UVLO Firmware Change

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

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

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

SensorData - SDI12 Setup

Published January 27th, 2023 by Matthew Clark-Massera

Configuration Tool -> SDI-12 Specification relationship The following configuration options for SDI-12 Measurements are available (currently up to 5 measurements are available). Each measurement is completely separate, and may read from either the same physical sensor, or different ones. The measurements, types, counts, etc are difficult to under

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

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

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

Zilch RFID reader setup

Published January 26th, 2023 by Matthew Clark-Massera

Custom TTL RFID reader integration.  Wiring RFID Reader Wire Connect to Red - VCC/12V 12V power. It has been observed that the Purple Sys Rail out (~4.5V) on the Dart3 is able to power the reader.To use this connect to Purple on Dart3, Pin3 Black - GND Dart3 GND Green - TX Dart3 Pin 4 - Green - RX White - RX Dart3 Pin 10 - Brown - TX See DART3 12-wi

Safety Instructions

Published January 22nd, 2025 by Matthew Clark-Massera

General Safety Information Only use the device for its intended purpose and in accordance with the device specific certifications. Comply with all local regulations and guidelines. Keep away from children. Do not disassemble, repair, or attempt to modify the device. Avoid storage and/or use within explosive environments. Use within specified environ

Remora2 - Product Change Notifications

Published February 2nd, 2023 by Matthew Clark-Massera

2020.10.27 - UVLO Firmware Change

TG Mobile App Overview Documents

Published January 26th, 2023 by Matthew Clark-Massera

A white label ready Telematics Guru Overview document can be found in the link below. Dropbox - Telematics Guru These provide an overview of capabilities found in the Mobile App and the TG web portal.Similar, Destination Despatch Overview which includes Mobile App features can be found here - Destination Dispatching 

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

Yabby Cellular Default IO Mappings

Published January 31st, 2023 by Matthew Clark-Massera

The Digital and Analogue mappings for the Yabby are explained below. Please note the minor differences between Telematics Guru mappings and what is received in the raw data. Telematics Guru manipulates the raw data. Telematics Guru On Telematics Guru, the defaults are shown graphically below. For the Analogue Mappings, the analogue number is on the

Hawk - Configure T9602 Temperature Probe

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 T9602 is an IP67 rated Temperature + Humidity Sensor which can be used with the Hawk for temp+hum monitoring applications 3rd Party Sensor The T9602 is a 3rd Part

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

(FAQ) Upload Delay (Latency) after a network error

Published January 27th, 2023 by Matthew Clark-Massera

This article applies to cellular devices. How long will it take the device to upload after a network error? The Digital Matter cellular devices will store records in their non-volatile flash memory, meaning that if there is a network error, records will not be lost. After the network starts to work again (back in coverage, network error passes, etc)

Fox3 Device on Telematics Guru

Published January 8th, 2025 by Matthew Clark-Massera

Telematics Guru can accept data from the FOX3 series of GPS trackers by Lantronics.  Receive location, trips, ignition state, temperature monitoring, as well as virtual odometer and run-hours. Check and see if there are any FOX3 units in your fleets and integrate them! In order to connect a Fox3 device with TG.  Contact your original provider for in

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

TG Region Specific Details

Published January 26th, 2023 by Matthew Clark-Massera

As of mid-2018, TG is hosted in a number of regional data centers. This improves performance and scalability. The following TG features must be targeted at the right region: Website access: normally a partner's URL will direct them to the correct server. If they are used to accessing telematics.guru, they may no longer be able to login. Mobile App a

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

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

Boat Tracking with Battery Powered Devices

Published January 27th, 2023 by Matthew Clark-Massera

All DM devices revolve around the concept of "trip". For battery powered devices, trip detection works in one of two modes: GPS Movement Based Trip Detection.If some small movement occurs, the device is woken up by accelerometer activity. It then periodically checks GPS for movement. If the device has moved more than the trip start threshold (250m d

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

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

Oyster Cellular Firmware Release Note

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 v1.10 Added GPS satellite count and signal strength filter for higher position certainty Made the Wake Filter for Jostle Based Trips and Recovery Mode configurable Added new GPS and upload timeout options for Recovery Mode v1.9 Reduced inrush

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

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

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

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

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

Technical Drawing - [G120]

Published January 31st, 2023 by Matthew Clark-Massera

Please see attached G120 housing drawing - providing external dimensions G120 Housing Dimensions.pdf

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

Yabby Cellular GPS - Product Change Notifications

Published January 31st, 2023 by Matthew Clark-Massera

2020.10.27 - UVLO Firmware Change

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

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

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

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

Geo-Fence Bulk Import

Published January 27th, 2023 by Matthew Clark-Massera

Geo-Fences can be copied between organisations, imported in bulk via KML, or generated in bulk via CSV.  Copy between Organisations To import geo-fences from another organisation within Telematics Guru.  Go to Admin >> Geo-fences Select Import From Organisation Select the organisation you wish to copy geo-fences from Select the geo-fences you

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

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

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

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

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 - 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

Default I/O Mappings - Barra Range

Published February 28th, 2024 by Matthew Clark-Massera

Here are the Default I/O Mappings for the Barra range of devices: Barra Core Barra Edge Barra GPS  You can change some of these mappings on Device Manager however, our default settings have been designed to prevent the need for making changes.  This mapping can be very handy to identify and debug issues, and when integrating the device data.  For ex

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

Yabby Edge LoRaWAN - Improved GNSS Performance

Published January 31st, 2023 by Matthew Clark-Massera

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 Semtech have worked together to now release a new version of firmware that improves the GNSS performance and is updatable via DMLink Cable on the Yabby Edge LoRaWAN Performance Improvement The Yabby Edge

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

Oyster Sigfox - Common Integration Pitfalls

Published January 27th, 2023 by Matthew Clark-Massera

Here is a list of common pitfalls encountered when integrating the Oyster Sigfox into a 3rd party system. Other message types are not handled. The Oyster mostly sends message type 0 (position data). However, it does periodically send Device Profiling Stats (message type 2). These other message types must be interpreted separately and specifically, o

Dart3-2G 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.12 Cell Tower Scan option to show MNC and MCC as analogues v1.11 Appropriate modem response to denied registration v1.10 Bugfix for runtime incrementation v1.9 Improved run hour incrementation v1.8 Allow digital inputs to be configured as a

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

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

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

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

Introducing the Dart3

Published January 25th, 2023 by Matthew Clark-Massera

The Dart3 is our robust and affordable vehicle tracking device with inputs/outputs, remote immobilization for fleet management, driver ID, driver safety and behavior monitoring, theft recovery, and more Key Features: High-precision GNSS tracking device Wired or Optional OBDII or cigarette lighter power harness available for plug-and-play installatio

Oyster Sigfox Battery Curves

Published January 27th, 2023 by Matthew Clark-Massera

The Oyster Sigfox reports its battery voltage in each update message. Since it supports both Alkaline and Lithium battery chemistries, this value indicates a different remaining capacity depending on what type of batteries are installed. Some typical discharge curves are shown below. The traces are taken from test units in the RCZ1 (Europe / South A

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

Telematics Guru FAQs

Published January 26th, 2023 by Matthew Clark-Massera

How do I set up a new customer? Each new entity/customer should be set up as a new organisation. Each organisation is it's own collection of users, assets, geofences etc. So set up each new client as an organisation to keep them grouped separately to your other clients.See Getting Started - Telematics Guru     Can I give users access to only some se

Hawk Dimensions

Published January 26th, 2023 by Matthew Clark-Massera

Hawk/Hawk Lite PCB LiPo Housing 2D Housing

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

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

SIM Cards and Data Usage - [Dart3]

Published January 26th, 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

G62 - Analogue input serial range (Deprecated)

Published January 27th, 2023 by Matthew Clark-Massera

The initial run of G62s was originally produced with an Analogue Input. This is why a parameter exists for this function in OEM - to ensure backwards compatibility.  All G62s with serials below 267555 (not inclusive) have an Analogue input All serials 267555 and above do not have an analogue input For devices with the input, the green wire is a shar

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

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. 

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

Sigfox - Periodic Only Updates

Published January 27th, 2023 by Matthew Clark-Massera

The default settings for the Oyster Sigfox device are for trip-based tracking. A common question is: "how do I disable trip tracking, for periodic only updates?" The answer is to set the Trip End Time parameter to 0 (zero). This will disable movement trips. To set this, either use the Config App: Or, in Telematics Guru, under Admin->Sigfox Downli

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

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

Integrating Tags

Published January 27th, 2023 by Matthew Clark-Massera

Can you integrate Custom Bluetooth® Tags? If you require a tag to be integrated into Telematics Guru or require a complex device integration, then contact your local Digital Matter representative. However if you simply want to test a device on OEM, or want to integrate a device onto a platform other than Telematics Guru, then you can integrate the t

User Audit Log Report

Published August 21st, 2023 by Matthew Clark-Massera

The User Audit Log Report The Partner User Audit Log Report displays a history of actions performed by Telematics Guru users.  This helps to: Maintain security compliance Aid in troubleshooting (track changes to an alert setup)  Improve governance Provide evidence in legal proceedings if required Running the Report In order to view/run the report, 

Initial Provisioning- [G120]

Published January 31st, 2023 by Matthew Clark-Massera

This guide is intended for to assist new users to get the G120 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 the SIM and installing the device in the asset, so the device picks up new settings once it gets online.

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

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

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

Storing LiPo Batteries - Bolt2

Published January 25th, 2023 by Matthew Clark-Massera

The Bolt2 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 thei

G62 - Technical Drawing

Published January 27th, 2023 by Matthew Clark-Massera

Please find attached the technical drawings for the G62 housing.  Blueprint - G62.pdf

Create Device on Sigfox Backend

Published January 27th, 2023 by Matthew Clark-Massera

Once the Device Type is created (explained here), you can add individual devices. This is straight forward: Login to your https://backend.sigfox.com account. Make sure the Device Type is setup. Click on Device in the top menu. Click New. Choose a group, if applicable. Fill in the various fields: Identifier is the Sigfox ID shown on the Oyster label.

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

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

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

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

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

Yabby Edge LoRaWAN- Device management and Almanac Downloads

Published January 31st, 2023 by Matthew Clark-Massera

Unlike the full featured GPS receivers in most devices, the LR1110 module in the Yabby Edge lowers the total fix energy by relying on cloud based post-processing for the position calculation. This allows it to skip the power-hungry ephemeris download portion of the GPS fix process. However, not having the ephemeris makes it harder to locate the GPS

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

Oyster Cellular Battery Capacity Estimate

Published February 1st, 2023 by Matthew Clark-Massera

It is useful to estimate the remaining capacity of the Oyster Cellular batteries. The nature of the Lithium AA batteries (LiFeS2) recommend for the Oyster requires a capacity estimate to be made based on sampling the battery voltage after at least 3 hours at a low current. The Oyster attempts to sample the battery voltage at a low current, and the h

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

IoT Devices - Analogue Input

Published January 27th, 2023 by Matthew Clark-Massera

The SensorData and SensorNode have analogue inputs available - consult the Datasheet for the number available and input range.  Outputs on the device can be enabled just before sampling, to power external sensors. Sampling occurs over roughly 100 ms, in which multiple readings are taking, and the average is calculated to be sent over the network. Th

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

Release Notes - Oyster3-4G

Published January 31st, 2023 by Matthew Clark-Massera

Subscribe To Updates Subscribe to our technical newsletter to be notified of bug fixes info-level and firmware updates 1.17/2.17 Ability to set Digital Input to indicate High-G event. 1.16/2.16 Added support for hardware revision 3 Stability improvements 1.15 Connection timeout update Memory Optimizations 1.14 Parameter introduced to allow GPS fix o

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

Dart Battery MSDS

Published January 26th, 2023 by Matthew Clark-Massera

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

G100 Default Input Mappings

Published January 31st, 2023 by Matthew Clark-Massera

The following digital inputs are mapped by default for the G100 (though they can be remapped elsewhere), it is important to keep these in mind to avoid clashes when setting up other inputs. 0 - Ignition 1 - Digital Input 1: Physical Digital input 1 is mapped by default 2 - Digital Input 2: Physical Digital input 2 is mapped by default 3 - Digital In

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

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

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

[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

Oyster3 - Battery Voltage Discharge Curves

Published February 1st, 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

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

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

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

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

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

Sigfox - How to Change Settings?

Published January 27th, 2023 by Matthew Clark-Massera

The Oyster Sigfox device's settings control how it behaves. Device settings are often called "parameters". The settings on an Oyster Sigfox device can be changed in two ways. All of the settings are accessible from both methods: Over the Air using a Sigfox downlink message Using a configuration cable For a discussion of the available settings and th

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

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

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

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

Oyster Rugged - Technical Drawing

Published February 1st, 2023 by Matthew Clark-Massera

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

Falcon & Eagle - Temperature Sensor Setup

Published January 27th, 2023 by Matthew Clark-Massera

The Falcon & Eagle devices support a range of sensors through their I2C bus. In this article, configuration of the DM temperature sensor will be demonstrated. First, verify you have wired the DM temperature sensor correctly by consulting the sensor pinout. Note the address of the sensor by assessing the wiring configuration of the green wire. Ne

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

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

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

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

Screw Sizes and Recommended Torque

Published January 27th, 2023 by Matthew Clark-Massera

The table below details the recommended screw sizes and torque for Digital Matter device housings. Guides on how to properly seal devices can be found under the specific device's getting started guide. Device Screw Size Recommended Torque Barra Core/Edge/GPS 2.5mm x 8mm 0.7 Nm Eagle 3.5mm x 12mm 0.7 Nm Falcon 3.5mm x 12mm 0.7 Nm G62 3.5mm x 20mm 0.7

G62 Harness Definition

Published January 27th, 2023 by Matthew Clark-Massera

See attached  G62 Wiring Harness Definition.pdf

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

Technical Drawing - Barra Range

Published April 29th, 2024 by Matthew Clark-Massera

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

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

Exporting Telematics Guru Data

Published January 26th, 2023 by Matthew Clark-Massera

Some users may wish to make use of device data stored in Telematics Guru in other systems. Telematics Guru offers some data export functionality.  If data is required in another system on a regular basis, these options should be used instead: Multi-Connector: Send the data to TG + another platform simultaneously. Alert Notifications through WebHooks

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

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

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

Radio Equipment Directive DoC

Published February 1st, 2023 by Matthew Clark-Massera

The DoC is attached. For more information, contact support@digitalmatter.com DoC Oyster.pdf

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

Oysters - Technical Drawing

Published February 1st, 2023 by Matthew Clark-Massera

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

Zilch RFID reader setup-copy-478

Published April 18th, 2023 by Matthew Clark-Massera

Custom TTL RFID reader integration.  Wiring RFID Reader Wire Connect to Red - VCC/12V 12V power. It has been observed that the Purple Sys Rail out (~4.5V) on the Dart3 is able to power the reader.To use this connect to Purple on Dart3, Pin3 Black - GND Dart3 GND Green - TX Dart3 Pin 4 - Green - RX White - RX Dart3 Pin 10 - Brown - TX See DART3 12-wi

Battery Level Status Report (TG)

Published January 27th, 2023 by Matthew Clark-Massera

Telematics Guru offers Battery Level Status Reports, which can be scheduled to give an overview of devices with low batteries - to help manage battery changes in a timely and convenient fashion.  There are two reports available. Both operate in a similar fashion - they simply apply to different groups of assets.  Partner Battery Level Status Report

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

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  

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

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

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

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

Oyster2 Tip Detection

Published February 1st, 2023 by Matthew Clark-Massera

Overview The Oyster2 supports detecting and counting 'tip' events, and keeping track of rotations. The feature functions in the same manner as the Remora2, but with improved measuring ability since the accelerometer is roughly centred in the device housing.  This feature is available on firmware version 2.12/3.12 and above. Device Orientation  The d

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

Yabby Edge - Default I/O Mappings

Published February 2nd, 2023 by Matthew Clark-Massera

Here are the Default I/O Mappings for Digital Matter's Yabby 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 mayb

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

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

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

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

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

Telematics Guru Status Page

Published July 9th, 2024 by Matthew Clark-Massera

The Telematics Guru status page is an essential resource for Digital Matter partners, providing real-time updates on the status and performance of Telematics Guru systems.  Partners can subscribed to notifications, in order to be informed of any planned system maintenance, outages, and any other technical difficulties.  Should a user be unable to ac

Setting up a Yabby Edge LoRaWAN device via ChirpStack

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

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

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

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

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,

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

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

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

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

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

Oyster Edge - Tracking Modes

Published February 1st, 2023 by Matthew Clark-Massera

Tracking Modes  1. Movement (Accelerometer) Based - Default In this mode, the device starts/ends trips based on accelerometer movement.  Accelerometer wakes the unit By default, a wake filter is applied. The filter only starts a trip when it has seen 1 second’s worth of above-threshold movement in a 4 second period, or repeated short movements over

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

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-

G70 Technical Drawing

Published January 27th, 2023 by Matthew Clark-Massera

See attached technical drawing showing outer dimensions of the G70 housing. Dimensions are unchanged from the G62. If spare screws are required, the supplied screws are 3.5mm x 20mm screws from Bossard Blueprint - G70.pdf

Yabby3 - Default I/O Mappings

Published January 31st, 2023 by Matthew Clark-Massera

Here are the Default I/O Mappings for Digital Matter's Yabby3 GPS 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

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

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

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)

Falcon 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 v2.22 / 3.22 Reduced the risk of the 4G modem entering an unrecoverable fault state v2.21 / 3.21 Improved jostle-based tracking in Turn-by-Turn tracking mode v2.20 / 3.20 SHT20 Sensor Integration   v2.19 / 3.19 Add jostle-tracking to Turn-by-T

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

Tracking Modes - [Yabby Edge Cellular]

Published February 2nd, 2023 by Matthew Clark-Massera

The Yabby Edge can be configured to operate in one of two modes 1. Movement (Accelerometer) Based - Default In this mode, the device starts/ends trips based on accelerometer movement.  Accelerometer wakes the unit By default, a wake filter is applied. The filter only starts a trip when it has seen 1 second’s worth of above-threshold movement in a 4

Choosing an Iridium Data Package

Published January 31st, 2023 by Matthew Clark-Massera

Digital Matter offer Iridium Data bundles for devices using the Telematics Guru platform. The package you need depends on your requirements, and the amount of time the asset will spend out of coverage.  3KB this for light compliance, where tracking outside mobile coverage is essential for safety etc, approx 150 messages per month, for vehicles that

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

Bluetooth Scanning - [Oyster Edge]

Published February 1st, 2023 by Matthew Clark-Massera

The Oyster Edge has a 5.2 Bluetooth® Low Energy (BLE) module. This enables a large number of flexible solutions to be implemented using the Oyster Edge + 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® Fir

Server Logs - GetDatedServerLog

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”.

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

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

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

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

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

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

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

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 -

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

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,

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

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

Scheduled Maintenance Reminders (SMR)

Published January 26th, 2023 by Matthew Clark-Massera

What are Scheduled Maintenance Reminders? Telematics Guru automatically calculates run hour and odometer estimates for each asset based on incoming device data. The Scheduled Maintenance Reminder (SMR) module allows jobs and maintenance schedules to be created for assets using this information. SMRs are particularly useful for large fleets that are

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

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

Oyster2 - Product Change Notifications

Published February 1st, 2023 by Matthew Clark-Massera

2020.10.27 - UVLO Firmware Change

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

G100 Battery MSDS

Published January 31st, 2023 by Matthew Clark-Massera

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

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

Hard-Wired Devices - Alert on unauthorized (keyless) movement

Published January 27th, 2023 by Matthew Clark-Massera

To prevent theft, users are usually after Alerts when their vehicle leaves their premises - this is done by alerting when the vehicle is  Outside a Geofence Ignition is on/high - Key turned to ignition. Movement is detected This is usually works for for big vehicles such as cars.  However, for small vehicles like motorbikes and scooters that can eas

Introducing the G70

Published January 27th, 2023 by Matthew Clark-Massera

The G70 is a rugged, IP68 and IK08 rated robust vehicle, trailer or heavy equipment tracking device with inputs/outputs, remote immobilization for fleet management, equipment monitoring, driver ID, theft recovery, and more. Key Features: High-precision GNSS tracking device 1 x Ignition Digital Input, 3 x Digital Inputs, 1 x Analog Input, 1 x Switche

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

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

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

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 

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,

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

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

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

Yabby Livestock Housing Technical Drawing

Published January 31st, 2023 by Matthew Clark-Massera

See attached drawing for the housing, including dimensions of the strap slot.  Use a strap slightly smaller than these dimensions.  Yabby Collar Drawing v1.pdf (204 KB)  

Hard-Wired Devices: Overview of Operation + Logging Parameters

Published January 26th, 2023 by Matthew Clark-Massera

Applies to: Device Firmware Version Bolt2-4G  All Versions Dart3-2G, Dart3-4G, Dart3-4G-BLE, Dart3-Global-BLE All Versions G120-2G and G120-4G All Versions G150-Global All Versions. See additional configurations for v1.5+ G70-2G, G70-4G, G70-4G-BLE All Versions Trip Tracking Modes Our devices revolve around the concept of a 'Trip' for tracking. Ther

Technical Drawing - Oyster3

Published January 31st, 2023 by Matthew Clark-Massera

See attached Oyster3 housing drawing - providing external dimensions. If spare screws are required, the ones supplied are 3.5mm x 12mm screws from Bossard Oyster3 - Technical Drawing.pdf

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

DART3 12-wire Harness Definition

Published January 25th, 2023 by Matthew Clark-Massera

The Dart3 comes with a 12 wire, 650mm long harness 15mm is pre-stripped on the input (red), ground (black), and the ignition (white) wires. Wire gauge is 0.35mm² Harness Diagram: Wire Definition: Pin  Colour Function 1   +VIN / BATT (8-36V) 2   GROUND 3*   VOUT 4*   Driver ID 2TTL RX / Wiegand D0 / Digital Input 3 5   DIGITAL INPUT 1 (48V max) 6   A

Oyster Edge - Certifications List

Published February 1st, 2023 by Matthew Clark-Massera

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

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

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

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

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

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

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

Call the Current Driver from the App

Published January 26th, 2023 by Matthew Clark-Massera

The TG app allows for the ability to call the current driver of an asset direct from the app. Against any asset, we can see the current driver. So if there is a problem related to this asset, it's convenient to be able to click the 3 dots and ring the driver.  To configure, we need to have the Driver's phone number entered in the system. So to set u

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

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

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

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

Hard Wired Devices: Disable Movement Trips

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 G70-2G and G70-4G All Versions All Hard Wired devices have 3 methods of trip detection Ignition based (based on white ignition line being wired in) Movement Based (GPS movement) Run Detect (Based on changes in external volta

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

Oyster Cellular 3G Datasheet

Published February 1st, 2023 by Matthew Clark-Massera

Please view the last version of the Oyster 3G Datasheet. No more revisions will be made as this product has been deprecated and replaced with the Oyster2. 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 3

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

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

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

Input Monitor

Published January 26th, 2023 by Matthew Clark-Massera

Applies to: Device Firmware Version Dart3-2G, Dart3-4G, Dart3-4G Bluetooth® and Dart3 Global Bluetooth® All Versions G120-2G and G120-4G 2.2+ G70-2G, G70-4G and G70-4G Bluetooth® All Versions The input monitor allows a digital output to be set, or a buzzer to be sounded, based on the state of device digital inputs, and a speed threshold.  Examples o

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

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

Changing Oyster Sigfox Parameters: Implementing the Downlink Payloads

Published January 27th, 2023 by Matthew Clark-Massera

Firstly, read this discussion on the options for changing Oyster Sigfox parameters. Parameters can simply be thought of as settings. If you are implementing the protocol and wish to change parameters via the Sigfox Downlink, then read on. You will need to look at this document, which specifies the contents of the downlink payload to change parameter

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

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,

Configure DS18B20 Temp Probe with Hawk

Published January 27th, 2023 by Matthew Clark-Massera

The Hawk Ag-Tech1, Agtech2 and RS-1 plug in I/O cards have a 1-wire interface. This can be used to read a DS18B20 temperature sensor.  DS18B20 Details Datasheet - Maxim Integrated Full probe assemblies Core Electronics Altronics Wiring The relevant I/Os for the DS18B20 - using the Ag-Tech1 plug-in board on the Hawk are: Function Agtech1 Agtech2 RS1

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

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

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

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

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

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

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

Hawk - Battery Life Estimator

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

Yabby Cellular GPS & WiFi - Getting Started

Published January 31st, 2023 by Matthew Clark-Massera

The Yabby is a super compact, rugged GPS tracking device that has been designed for tracking bags, tool boxes, containers, trailers, skip bins, Animals and other assets where long battery life and small form factor is required. This getting started guide is only for the cellular version. The cellular version comes in 2G or LTE Cat-M1/Nb-IoT and uses

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

Initial Provisioning [Oyster Edge]

Published February 1st, 2023 by Matthew Clark-Massera

This guide is intended to assist new users in getting an Oyster 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 w

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),

View Server Logs

Published January 25th, 2023 by Matthew Clark-Massera

Viewing Server Logs shows the last interaction with the server. This can be a useful debugging tool. This shows all of the logs for the day of the last connection. Logs are highly summarized. If no logs are shown, the device may not have connected, or connected a long time ago. 3rd Party Direct Users Please note that Server Logs can not be viewed on

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

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

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

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

Decoding the Oyster Sigfox Payload: Examples

Published January 27th, 2023 by Matthew Clark-Massera

Click this link to check out the Oyster Sigfox on the Digital Matter Website . We will expand this article with more examples in time. Please refer to this article for the message specifications. These are just examples. Decode a GPS Data Record (Type 0) Here is an example payload, as sent from the Sigfox backend to your server. It fills the 12 byte

Edit Asset Details from the App

Published November 24th, 2023 by Matthew Clark-Massera

Asset details can be edited via the mobile app.  Your browser does not support HTML5 video.  

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

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

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

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

Upload Timeouts - Network Registration Strategy

Published February 1st, 2023 by Matthew Clark-Massera

Applies to (Cat-M1/NB-IOT device range): Device Firmware Version Barra GPS All Versions Barra Edge  All Versions Oyster3 4G All Versions Oyster3 4G Bluetooth All Versions Oyster Edge 4G All Versions Yabby3 All Versions Yabby Edge 1.12+ Remora3 All Versions Hawk Pro/Hawk Lite All Versions For information specific to our global range, see Network Sett

"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

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

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,

G70 - Default I/O Mappings

Published January 27th, 2023 by Matthew Clark-Massera

Here are the Default I/O Mappings for Digital Matter's G70 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 avoid

G120 Bluetooth Firmware Release Notes

Published January 31st, 2023 by Matthew Clark-Massera

v2.6 Added support for G120 Hardware Revision 3 v2.5 Integrated ELA tags as individual tags. Allows mapping temperature and humidity values to analogs using the BLE ELA RHT/T parameters v2.4 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. (on

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

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

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

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

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

Dart Harness Definition

Published January 26th, 2023 by Matthew Clark-Massera

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

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

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

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

Two-Factor Authentication - [TG]

Published January 26th, 2023 by Matthew Clark-Massera

Two-Factor Authentication (2FA) - also referred to as Multi-factor Authentication (MFA) is an easy way to significantly increase the security of your account, and prevent it from being compromised.  See why it is important here: Microsoft | What is multi-factor authentication? Digital Matter strongly recommend that partners enable 2FA on their user

JDLink - Telematics Guru

Published January 27th, 2023 by Matthew Clark-Massera

John Deere/JDLink devices are integrated with Telematics Guru. JDLink is the connection that enables automatic data flow between connected machines and the owner's John Deere Operations Center account.  John Deere Devices make use of the ISO 15143-3 (AEMP 2.0) data standard. Other machine types integrations are planned in future. Contact support if

Oyster Sigfox Getting Started Guide

Published January 27th, 2023 by Matthew Clark-Massera

How to get started with the Oyster Sigfox

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

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

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

Getting a Sigfox device online

Published January 27th, 2023 by Matthew Clark-Massera

We sometimes find customers frustrated with getting the Oyster Sigfox device online for the first time. This is why, and how you can avoid frustration. Why is it not connecting? There are a few reasons: Most often, it is because the device cannot get a GPS fix. On initial start up (batteries inserted), the device must get a GPS fix before it sends a

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

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

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

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

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

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

G70 - 3 Wire Install

Published January 27th, 2023 by Matthew Clark-Massera

The G70 is supplied with a 10-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. Wiring Description: Connect Red on the G70 harness to the vehicle battery (8-33V). Connect Black to chassis ground Connect White - to an ignition sour

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

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

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

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,

Updating Device Firmware in Device Manager

Published January 25th, 2023 by Matthew Clark-Massera

What Is Device Firmware? When it comes to Internet of Things hardware, the firmware installed on a given device is similar to the operating system on a notebook computer. Just as iOS or Windows tell the computer how to interpret input information from the mouse and keyboard, so too does device firmware instruct an IoT device how to coordinate its GN

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

Firmware Release Notes - Barra Edge

Published October 10th, 2023 by Matthew Clark-Massera

1.9 Magnetic Activation Mode improvements 1.8 Activation Mode upload on Power on Reset removed. 1.7 Device Manager EU Server whitelisted 1.6 Maximum input of Wakeup Threshold in Accelerometer Settings increased from 0.5G to 2G 1.5 Temperature monitoring module with thresholds added Modem timeout bug fix Removed assisted scan followed by an autonomou

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

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

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

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

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)

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

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

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

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

The Eagle - Soil Moisture Probe Setup

Published January 27th, 2023 by Matthew Clark-Massera

The Eagle is a battery-powered device 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. In this example, we are using the Eagle and an SDI-12 soil moisture probe to monitor the soil moisture by taking a periodic read

Yabby Edge Cellular 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.   1.29 Fix for Location Scan multiplier issue 1.28 Added support for Location Scan Multiplier 1.27 Added optional security enhancement for disabling of provisioning tool device access (NB: this cannot be disabled once enabled) 1.26 Added supp

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

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

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

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

Immobiliser Install - Asset starts after valid Driver ID Scan

Published April 18th, 2023 by Matthew Clark-Massera

Applies to: Device Firmware Version Dart3-2G, Dart3-4G, Dart3-4G-BLE and Dart3-Global-BLE All Versions G70-2G, G70-4G and G70-4G-BLE All Versions G120-2G and G120-4G All Versions G150-Global All Versions Concept The wired devices have a switched ground output. See wiring below for each device type. The SW GND can be wired to a relay, to control the

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

LiPo battery storage [G120]

Published January 31st, 2023 by Matthew Clark-Massera

The G120 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

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

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

Sim Cards + Data Usage - Oyster Edge

Published February 1st, 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

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

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

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

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

Tenet Ultrasonic Fuel Sensor

Published January 31st, 2023 by Matthew Clark-Massera

Applies To Device Firmware version G120 2.12 and above G150-Global All Firmware versions The Tenet Ultrasonic Fuel Sensor supports integration with both the G120 and G150 devices via RS232. This allows for enhanced compatibility and flexibility in fuel monitoring setups. - the fuel level and temperature can be reported to the server in specified Ana

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

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

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

Sigfox - missed GPS updates! Why?

Published January 27th, 2023 by Matthew Clark-Massera

Question: I'm frustrated by some of the missing updates from my Oyster Sigfox device. Why are they not coming through? Is the device not working? Answer: Sigfox devices need to be thought of differently to normal cellular tracking devices. It is good that you are noting the differences and limitations of the technology. The short answer is: Sigfox O

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

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

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.

SPOT Devices in Telematics Guru

Published January 27th, 2023 by Matthew Clark-Massera

Telematics Guru can accept data from SPOT Devices, such as a SPOT Gen3 or Gen4 SPOT devices send their data to either the Pivotel Services Gateway (typical in Australia) or the GlobalStar Platform.  Integration Point your device to: http://<device-region>.telematics.guru:8084 Text The device region in the URL is important to target the correct

Technical Drawing - [Dart3]

Published January 26th, 2023 by Matthew Clark-Massera

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

Initial Provisioning - [G70]

Published January 27th, 2023 by Matthew Clark-Massera

This guide is intended to assist new users in getting a G70 tracker 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 onl

Remora2 - Technical Drawing

Published February 2nd, 2023 by Matthew Clark-Massera

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

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

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

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

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

LoRaWAN® Overview

Published January 27th, 2023 by Matthew Clark-Massera

See the attached run down on LoRaWAN network architecture.  

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.

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

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

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

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

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

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)

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

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

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

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

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 - 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

Guppy - Technical Drawing

Published January 27th, 2023 by Matthew Clark-Massera

Please find attached the technical drawings for the Guppy housing.

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

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

Guppy LoRaWAN® - Configuration and Usage Guide

Published January 31st, 2023 by Matthew Clark-Massera

The Guppy 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

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

G100 - Getting Started

Published January 31st, 2023 by Matthew Clark-Massera

The G100 is a compact 2G or 3G GPS tracking device to cater for the most demanding applications. The stand out feature of the G100 is the FlexiCard slot. This allows for the most flexible expansion options in the industry – including an Iridium satellite modem, Wi-Fi and other interface options. The G100’s compact housing contains the GPS and cellul

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

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

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

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 Helium

Published January 27th, 2023 by Matthew Clark-Massera

The Helium Network is the largest, public LPWAN in the United States, and enables long range, low power, bi-directional communication for any LoRaWAN compatible device. The Helium Network is open and permissionless, and requires no up-front payments, contracts or commitments to use. Devices pay Helium Hotspot owners and other Helium Network Operator

The Asset Analogue Report

Published January 26th, 2023 by Matthew Clark-Massera

Our devices make use of Analogues to store various values. All devices use the following 4 analogues: Analogue 1 - Battery Voltage (internal back up battery for hard-wired devices, or the primary cells for battery powered devices) Analogue 2 - External Voltage (hard wired units) Analogue 3 - Internal Temp Analogue 4 - Cellular Signal CSQ (Strength)

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

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

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 - 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

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

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

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.

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

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

SensorNode Configuration App

Published January 27th, 2023 by Matthew Clark-Massera

Download the SensorNode config app here: https://www.oemserver.com/tools/SensorNodeLoRaWAN/ConfigTool/setup.exe

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

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

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

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

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

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". 

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      

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.

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

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

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

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

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

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.

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

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’

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

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,

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

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.

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® 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)

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  

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

Yabby 3 LoRaWAN® Battery Life Estimate Calculator

Published January 31st, 2023 by Matthew Clark-Massera

See the attached spreadsheet to help estimate the battery life of an Yabby 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.   Click to Download the Yabby3 LoRaWAN Battery Life Calculator Excel File  

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

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.

Battery Life Estimates [Yabby3]

Published January 31st, 2023 by Matthew Clark-Massera

The Yabby3 boasts 'Deploy-once' battery life with up to 10+ years on only 3 x AAA 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

Yabby 3 LoRaWAN® Firmware Release Notes

Published January 31st, 2023 by Matthew Clark-Massera

v1.1 First release

Eagle - Product Change Notifications

Published January 27th, 2023 by Matthew Clark-Massera

2020.10.27 - UVLO Firmware Change

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

Oyster Standard -> Rugged Housing Adapter Drawing

Published February 1st, 2023 by Matthew Clark-Massera

See attached technical drawing for an Adapter Plate for the Oyster. If a custom mount has been designed for the Oyster white polycarbonate housing, this adapter plate will allow a Rugged Housing to be fitted to the same mount. OysterAdapterPlate.pdf

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

Falcon - Product Change Notifications

Published January 27th, 2023 by Matthew Clark-Massera

2020.10.27 - UVLO Firmware Change

Garmin inReach SE+

Published January 27th, 2023 by Matthew Clark-Massera

Telematics Guru can receive data from Garmin inReach SE+. The inReach SE+ is a handheld Iridium satellite communicator. Not all device functionality is integrated with Telematics Guru. Only the current location + I/Os are integrated to provide a location and some alerting functionality within TG.  This can allow users to track both their personnel a

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

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

Checklists - QR Code Generation and Scanning

Published January 27th, 2023 by Matthew Clark-Massera

Checklists can be configured such that an asset and/or project selection is required.  i.e. - We have completed a Vehicle Prestart on Truck ABC 123, for a specific project.  Telematics Guru can generate data to create QR Codes for a checklist. The QR code can be attached to an asset, and then if a user scans this QR code from within the TG app, the

Driver ID Options

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 G150-Global All Versions Our wired devices support a variety of Driver ID options to provide driver behaviour monitoring, access control and log-booking solutions. If a worksite already has a specific reader or card

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

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

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 

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

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”

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

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

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

CSV Device Info Export

Published January 25th, 2023 by Matthew Clark-Massera

The information in the OEM Admin Interface can be exported into a CSV file. This is data such as Device Serial Number, IMEI, SIM Serial (ICCID) etc. OEM To get an export, do the following: Login to www.oemserver.com Got to the Devices view. Use searching and filtering to limit the view to devices you are interested in. Use the selection tickboxes or

Telematics Guru - Asset Addresses

Published January 26th, 2023 by Matthew Clark-Massera

In Telematics Guru, the address of an asset is shown on the live view as part of its Status. The Status verbs can be changed here Address information is also contained in trip reports (i.e. trip list reports) If one of the locations is a Geofence, the Geofence name will be displayed instead. This can be disabled per-geofence by ticking this box (may

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

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      

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

Dart/Dart2 - Technical Drawing

Published January 26th, 2023 by Matthew Clark-Massera

Please find attached the technical drawings for the Dart & Dart2 housing.  DART.pdf

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

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

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

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.

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 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

Remora 2 Bluetooth Firmware Release Notes

Published February 2nd, 2023 by Matthew Clark-Massera

v2.7 Integrated ELA Frames: ID, ANG, MOV, MAG, T & RHT Fixed issue with large tag lists not showing all tags v2.6 Update to support Technoton Fuel Sensor payload change v2.5 Fixed CUB TPMS pressure readings when above 638kPA v2.4 Tag lost logs are now optional in "stationary" mode v2.3 Added Cub Tyre Pressure Sensor Added Technoton Fuel Sensor M

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

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,

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

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

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

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

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

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

Set up SMS Alerts

Published January 26th, 2023 by Matthew Clark-Massera

Alerts can be sent via TG to a user's mobile number. Please contact your Digital Matter representative for pricing information.  To set up for SMS alerts:  Go to Admin -> Organisations Edit the organisation you wish to set up SMS for, and set the SMS provider: TG - Default SMS (Clickatell)  TG - Default SMS (SA only) for South African users. (Cli

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

Telematics Guru Release Notes

Published January 26th, 2023 by Matthew Clark-Massera

Information around TG updates and new features are sent out to partners via our mailing list- click here to Sign Up November and December 2024 New Features You can now filter the Live View by the in-trip status of your assets. This is useful if you want to see at a glance which of your vehicles are still active after-hours, or which vehicles near th

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

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

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

Telematics Guru White Labelling

Published January 26th, 2023 by Matthew Clark-Massera

Digital Matter provides a complete 'business in a box' solution, providing: Devices A back-end device management platform -  Device Manager A front-end tracking platform - Telematics Guru Telematics Guru allows for a number of in built, and custom white labelling options, to allow resellers to make the product their own and apply their own branding.

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 /

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

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

G100 Datasheet

Published January 31st, 2023 by Matthew Clark-Massera

Please view the last version of the G100 3G datasheet below. There will be no more revisions as this product has been deprecated and replaced by the G120. 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 3

Device Product IDs

Published July 8th, 2024 by Matthew Clark-Massera

Integrators may need to know Digital Matter device Product IDs.  The Product ID is sent by the device to the server - which identifies the device type.  A list is given in the table below. Should any be missing below, Device ID’s can also be found in the “Product” column of the device table in Device Manager.  For example, below shows 79.2 – 79 = th

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

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

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

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

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) -

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

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

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

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

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

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

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

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

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

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

Hawk - Digital Input Battery Life Effects

Published January 27th, 2023 by Matthew Clark-Massera

Hawk Technical Specifications can be found here There is 1 x Digital Input on the Hawk baseboard, with the below spec Configurable pull up/pull down 0-40V DC input range On/Off thresholds On >2V Off <1 V Can be used for pulse counting (max 40Hz) The Digital Input can be used to monitor a switching input (i.e. door open/closed, pump on/off), or

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

Finding Iridium IMEIs vs Device Serials

Published January 26th, 2023 by Matthew Clark-Massera

When an Iridium device is used - the Iridium IMEI is entered against the Asset when creating the asset.However the main way devices are referred to in Telematics Guru is by their serial. So we need to have a way to link the DM device serial and the Iridium IMEI.  This can help track down which device may be using a lot of Iridium data so the setting

Dart Wiring Diagrams

Published January 26th, 2023 by Matthew Clark-Massera

For a discussion on setting up driver ID or immobilisation methods with the Dart2, see the Dart2 article here 1. Immobilisation using Telematics Guru 2. Immobilisation without scanning Driver ID 3. Dart with iButton wiring 4. 3 Wire install.

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

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 Sigfox Default IO Mappings

Published January 27th, 2023 by Matthew Clark-Massera

This article explains the default IO mappings for an Oyster Sigfox device on Telematics Guru (TG).  Note that this is specific to Telematics Guru. Other front end systems may represent the data differently. Each GPS position record logged by the device is sent immediately on the Sigfox network. If it is received by a Sigfox base station and correctl

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

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

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

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 (

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

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

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.

G70-4G-Bluetooth Release Notes

Published June 18th, 2024 by Matthew Clark-Massera

Device Firmware 1.3 Bluetooth Driver ID V1 Support Implemented 1.2 Fixed analog mapping not clearing INT16 analogs properly when tag is lost Support for additional hardware revision   Bluetooth Module Firmware 2.1 Fixing wakeup pin issue for hardware revision 2 (product ID 115.2)    

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

Configure Buzzing on Excessive Tilt - G70

Published January 27th, 2023 by Matthew Clark-Massera

Most Digital Matter devices are fitted with a 3D accelerometer. Our hard-wired range of devices make use of the accelerometer for harsh event detection, accident detection, and monitoring activity, trips and idling. Accident Detection functionality allows for a Roll Threshold to be set. Once this is exceeded an accident is logged and uploaded to the

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

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 

Tracking Parameters - Barra GPS

Published February 28th, 2024 by Matthew Clark-Massera

By default, the Barra GPS is set up for GPS-based movement tracking and uses a uBlox Max-M10 GNSS module. 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 upload every 12 hours   In Trip (on the move): Upload + Location on trip start (3) In Trip L

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

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

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

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

Oyster Edge Cellular - Location Scanning Parameters

Published February 1st, 2023 by Matthew Clark-Massera

The Oyster 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 t

Finding Deleted Device on Sigfox Back-end

Published January 27th, 2023 by Matthew Clark-Massera

Back-end users can delete devices if they are in either the Off Contract or the No Token status. Under the Devices tab you will find in the left menu a feature called Deleted Devices. Here you will be able to find the devices you have deleted, and their current PAC for when you need to re-register them. Device history Device history will be deleted

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

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

Hawk - GA Weather Station + DS18B20 Temp Probe

Published January 27th, 2023 by Matthew Clark-Massera

This example shows how the Hawk can be configured to read data from the GA Weather Station (over RS485) and DS18B20 Temperature Probe (over 1-Wire). For the application, you will need Hawk RS-1 card GA Weather Station (3rd party sensor - not sold by Digital Matter) DS18B20 Temp Probe (3rd party sensor - not sold by Digital Matter). For information o

LED Behaviour

Published January 31st, 2023 by Matthew Clark-Massera

Battery powered devices will flash the LED in the following ways: Behaviour Information Off If the LED is not on at all, it is likely that the battery is flat, or that the device is asleep. From power-on-reset, the LED flashes for duration of start-up connect, fix, connect. Or until 10 min have passed. After a power-on-reset of the device, the LED w

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

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

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.  

Proof of Service - Renting Assets

Published January 27th, 2023 by Matthew Clark-Massera

If you have a device attached to a hired Asset/Vehicle/etc and need to supply usage statistics such as distance/run hours for a specific period there are a few methods that you can implement to save, categorise and export the information. This article covers a few ways to get key information and reports from TG for 'proof of service' such as: Time v

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

Area Coverage Reports

Published January 26th, 2023 by Matthew Clark-Massera

The Area Coverage reports allow users to estimate the area that has been ploughed/sprayed/mowed etc by an asset.  The area is calculated simply by: Coverage Area = Trip Distance * Coverage Multiplier.  The coverage multiplier would be the length of our mower/spray arm - so if we travelled 100m down a field with a 5m boom, then we've covered 500m2. 

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

Dart2 Product Change Notifications (PCNs)

Published January 26th, 2023 by Matthew Clark-Massera

2020.10.26 - New Production Firmware 2.7

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

FAQs - Barra GPS

Published February 28th, 2024 by Matthew Clark-Massera

How long will the batteries last on my Barra GPS The short answer: Up to 8 years at 1 daily update. Around 2 - 6 years generally with other configurations and applications.         The 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 t

Hawk On-Board Control - Turn on Pump when tank level is too low

Published January 27th, 2023 by Matthew Clark-Massera

The Hawk is able to interface with a wide variety of sensors to report on data such as tank level. The data may be used for analysis or importantly generating actions.  This example shows how the Hawk can be configured to turn on a pump if the tank level gets too low.  1. Application Description The MaxBotix MB7040 I²C Ultrasonic Range Sensoris used

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

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

SensorData LoRaWAN® - LoRaWAN® Setup

Published January 31st, 2023 by Matthew Clark-Massera

The SensorData LoRaWAN usually connects using Over The Air Activation (OTAA). When provisioning to a LoRaWAN 1.0 network, the following are required: DevEUI: Hard coded on devices. Can be read using the configuration app, or from a label printed on the device. JoinEUI / AppEUI: A 16 digit code. Uses either the default value (70-B3-D5-70-50-00-00-02

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

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