All DM devices require the correct APN to be set so that they can connect on the network. 

A list of APNs is stored in device FW, and in the majority of cases, the device will detect the network of the SIM card it is using and select the right APN from this list. 

On 2G and 3G devices, if the APN is not on the list, the device can be sent an SMS to set the APN. Even if the APN is not yet set, the SMS can still be received and applied.

On 4G Cat-M1 and Nb-IoT, this is not the case. An SMS cannot be received if the device isn't on the network - so configuring APNs and other connectivity settings is not so simple. To assist with this, we have developed a wired tool to enable parameters to be set on the device using a cable and app - and also read some debug information from the device to shed light on why a device may not be connecting. 

Tool Download

Download the tool HERE

The tool requires Windows 7 or above. 

Cable and Adapter

Contact your Digital Matter Branch to purchase a programming cable and adapter. 

The cable consists of a USB connector (for PC) and JTAG connector (for DM device)

Connecting the Cable to the Device.

The JTAG connector has 9 pins. 

The 3 longer pins go through through holes in the device PCB, and help hold the cable in place.  

The other 6 make contact with test pads on the board. 

To connect the tag to the PCB, locate the debug port on the device.

The 6 gold pads correspond to the 6 short pins on the cable, and the 3 holes the 3 long pins. 

NB - some devices have more than 1 debug port (i.e. some have an additional port for the BLE Module). If the tool is not running, try the other port.

The device must be powered before you connect.

Tool Features

1. Tick these options to set the firmware on the device, and apply the parameters that are set below (3)

2. Each currently supported device

3. Admin Parameters for each device. Expand the accordion to see further detail

4. Opens the serial list. A list of devices read by the tool and the result of the read/writes are shown here. 

Programming Firmware

The Programming Tool comes loaded with FW for each device. 

At this stage, it does not automatically update the device to the latest version of FW available in OEM. This may be implemented in future. 

However setting parameters to default and reflashing the FW can be a useful debugging tool. 

If incorrect settings are applied, a device should reconnect after this. If it is doesn't there is likely a hardware fault. 

To program the FW:

1. Open the tool

2. Tick the Program Firmware checkbox

3. Power on the device

4. Plug the adapter cable into the device and hold until the screen changes. 


The screen should flash blue, and the device's serial number, hardware revision, and FW revision should be shown. If the firmware needs to be updated, a progress bar will pop up during the update.

Programming Parameters

For parameters, the process is the same. 

Simply enter your desired parameters, check the Set Parameters checkbox, power on device and hold in cable.

Note that you can't edit the parameters while the Set Parameters checkbox is checked.

In the Serial List dialog, a device will show as Synced once its parameters match the desired parameters.

Accessing Debug Logs from Device

In the menu, go to Debug -> Device Debug Log.

The debug window will open. Then you can hold the cable into the device.

A status bar will appear showing the progress of the debug download. The cable cannot be disconnected during this time. 

This may take 1-2 minutes per device. 

This is not the fastest process but helps to determine as to why a device isn't connecting. Since when devices won't connect, they can't send debug information to the server.