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
- Blockbax project
- 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:
- Login to the OEM server.
- Go to “Connectors”.
- Click on “New”.
- Choose a “Name” and an optional “Description”.
- Select “Http Connector” as the “Connector Type”.
- 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/. - 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 reason0-position
: GPS location of the sensor0-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-152-device-status
: Device status flags6-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 CQ24-peak
: Peak G force. 1024 = 1G24-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.
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:
- Login to the OEM server.
- Go to “Devices”
- Select your device
- Go to “Parameters” -> “Edit System Parameters”
- Click on “+ Add Advanced Parameter”
- Choose Accelerometer Settings
- Configure according to your requirements
Now High-G peak and average events will be sent to Blockbax.