Applies to:

Our devices offer 2 x different digital output options. These are:

• Switched Ground Output
  • Most common and widely used for most applications
• Switched Power Out
  • Can be used for some specialist applications

Switched Ground Outputs

Switched ground outputs provide a path to ground when 'on' (i.e. allow a path for current, closing the circuit) and are high impedance when off (breaking the circuit). This is an example of a low-side switch.

When the SWGND is Active is a GND.

When SWGND is Inactive→It is an open circuit.

The function of the digital output can be set in system parameters. Functions include:

Setting the function dictates what controls the output. I.e. if we set the output up with the function as Immobiliser  - the digital output will control an immobiliser if wired correctly.

If we set it up as a Buzzer - this output will pulse on/off when buzzing should happen (e.g. if no driver ID is scanned) -so that if it is connected to a buzzer we will hear the buzz.

The active level setting depends on the function. This can be used to invert the output. LED's and Buzzers should generally be Active High and Immobilisers Active Low.

Switched Power Out

When this output is ON, a voltage is supplied - it ranges from 3-12V depending on the device model. So, this could be connected to the positive terminal of such a peripheral.

Parameters are the same as for Switched Ground outputs. Set the function to determine what causes the output to turn on or off.

Remote Switching via the Server

Digital Outputs can be used for remote switching. e.g. to turn on or off a pump or lighting tower. 

One example is how a vehicle can be immobilised by sending a command from the server - which is covered here Driver ID & Immobilisation Methods with Powered Devices. Telematics Guru has an 'immobilise' button, which causes a message to be sent down to the device to turn any outputs set up with the function "Immobiliser" on or off. This same message can be sent from a 3rd party server using the OEM WebAPI - contact DM support for documentation. 

Any outputs set up with the function "Digital Output" can similarly be controlled by sending a different message to control outputs. 

Remote Switching Latency

It is important to note that all of our devices (even hard-wired vehicle trackers) will sleep during periods of inactivity. For example, using the default tracking parameters for our powered devices; heartbeats happen hourly when the ignition is off while the asset is stationary. Between heartbeats, the device will sleep and the cellular modem will be off. 

This means that a command sent down to the device will not be received until the next heartbeat, when the device next connects. 

If we require low latency output switching, to improve upon this, we can set this parameter under the upload settings, available on hard-wired devices. 

This will cause the device to attempt to remain connected to the network all the time. In practice, generally, the network will kill the connection after 5-10 minutes. So the device additionally needs to be set to upload often enough to keep the connection alive. This can be done by setting the heartbeat interval to a sufficiently short window (may require some experimenting) 

This will allow commands to toggle outputs to be received by the device within 60 seconds in most cases. It should be noted that this functionality was not designed with live control applications in mind. 

Controlling Digital Outputs from Telematics Guru

Note: this only applies to the G120, the G150 Global and the Hawk. To see information about the Hawk's digital output configuration, please see Hawk - Control Output from Server.

It is useful to be able to easily and remotely activate and deactivate a digital output, and this is usually done via the immobilise button on Telematics Guru. However, the G120 and G150 Global have two physical digital outputs, while only one can be used for immobilisation, and the Hawk IoT Datalogger does not have the firmware for immobilisation. Thus, we have the ability to enable and disable Digital Outputs from Telematics Guru to allow for these outputs to still be easily usable. 

Examples of usage can include:

• Using one digital output on the G150 Global for immobilisation, while using the second for opening and closing a release mechanism of a door ad-hoc
• Using the digital output on the Hawk to be able to on a pump ad-hoc. See Hawk On-Board Control - Turn on Pump when tank level is too low for more general information on this example use case.

Usage Guide

Before getting started, you will need to configure the Digital Output to the function Digital Output. From there, we can set it up on Telematics Guru.

You will first need to ensure you have the Digital Output set in the I/O Mappings of the asset, as per below:

Ensure the I/O number corresponds to the physical Digital Output you are configuring, as per Device Manager and the G150 Harness Definition/G120 Harness Definition. The event type option allows to trigger a configured event based on the activity of the output.

For the Hawk:

• 3v3 - Digout 0
• Vboost - Digout 1
• SWGND- Digout 2

From there, you will be able to configure the Digital Output from Telematics Guru from the below button:

Which prompts the following pop-up:

Please note that if you try to configure a device without a digital output setup, you will receive the following message: