Documentation

Integrations / Connection guides / Digital Matter

Digital Matter

Digital Matter offers a large portfolio of LPWAN, integration-ready and battery-powered asset tracking devices across a range of connectivity technologies. We integrate seamlessly with a variety of their sensors.

We tested this integration with the Oyster2-4G and G62-4G devices, however the integration should also work for other Digital Matter devices. It could be that these devices output additional metrics currently not supported by the integration. We are happy to extend our integration, just contact us.

Goal

The goal is to set up an integration between a Digital Matter tracking device and Blockbax.

Prerequisites
  1. Blockbax project
  2. Access to the OEM server
Steps to connect a device

To set up the integration between a Digital Matter device and Blockbax perform the following steps:

  1. Login to the OEM server.
  2. Go to “Connectors”.
  3. Click on “New”.
  4. Choose a “Name” and an optional “Description”.
  5. Select “Http Connector” as the “Connector Type”.
  6. In the “Url” field put this url: https://api.blockbax.com/v1/projects/<PROJECT_ID>/integrations/07dd96d7-875d-4e5f-ae21-e506a7b50ad7/measurements Note that your project ID can be found in the URL when you open your project in the web app, e.g. app.blockbax.com/projects/40edc099-7a41-4af3-9fa4-2fa4ac23a87a/.
  7. In the “Headers” field add a header with “name” Authorization and as the “value”, enter an Access Token.

Blockbax automatically maps data coming from the Digital Matter OEM server to ingestion IDs. Below is a list of available metrics by their external ID:

  • reason: Logging reason
  • 0-position: GPS location of the sensor
  • 0-speed: 2D ground speed [cm/s]
  • 0-speed-accuracy: Speed accuracy estimate [cm/s/10]
  • 0-2d-heading: 2D heading [deg/2]
  • 0-pdop: Position dilution of precision (PDOP)
  • 0-position-accuracy: Position accuracy estimate [m]
  • 2-digital-input: Digital inputs 0-31 (d0=IGN)
  • 2-digital-output: Digital outputs 0-15
  • 2-device-status: Device status flags
  • 6-internal-battery-voltage: Internal battery voltage [mV]
  • 6-external-voltage: External voltage [V ⋅ 100]
  • 6-internal-temperature: Temperature [°C ⋅ 100]
  • 6-gsm-signal-strength: Last known GSM CQ
  • 24-peak: Peak G force. 1024 = 1G
  • 24-average: Average absolute value of G force. 1024 = 1G

You can test if everything works by opening the Blockbax web app, creating a subject type with the previously mentioned metric external ID’s and a subject with the device serial number as the subject external ID.

Below you’ll find an example of a dashboard we created for a specific device after the setup was completed.

Digital Matter GPS tracker in Blockbax
Steps to set up high-G event detection

High-G is supported by Blockbax, but is not enabled by default on the Digital Matter device. To enable High-G event detection you will need to do the following:

  1. Login to the OEM server.
  2. Go to “Devices”
  3. Select your device
  4. Go to “Parameters” -> “Edit System Parameters”
  5. Click on “+ Add Advanced Parameter”
  6. Choose Accelerometer Settings
  7. Configure according to your requirements

Now High-G peak and average events will be sent to Blockbax.