CalChip CONNECT Digital Matter DM-Link Tool User Guide
- June 9, 2024
- CalChip CONNECT
Table of Contents
CONNECT Digital Matter DM-Link Tool
User Guide
DM-Link Tool Guide
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. It is important to use the J2 port – some DM devices have
two ports and the J2 port may be hidden underneath the serial sticker. 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.
Don’t push too hard, or you may damage the spring-loaded pins, or puncture the
backup battery on those devices that keep the battery underneath the circuit
board.
REBOOT YOUR DEVICE AFTER USING THIS TOOL
When using the tool:
- The device must be powered on
- After use, disconnect all cables and power cycle the device to continue normal operation.
TOOL FEATURES
- Tick these options to set the firmware on the device, and apply the parameters that are set below (6).
- This checkbox updates the modem’s internal profiles to support DNS on some NB-IoT networks (see here).
- This clears any system parameters that might have been set through OEM server.
- Each supported device has a separate Admin Parameters tab.
- Opens the serial list. A list of devices read by the tool and the result of the read/writes are shown here.
- Admin Parameters for each device. Expand the accordion to see further detail.
PROGRAMMING FIRMWARE
The Programming Tool comes loaded with FW for each device, and updates the
firmware automatically before setting the Admin Parameters. The bundled
firmware may not be the latest firmware, so using the tool will sometimes
result in a firmware downgrade.
Setting the firmware and Admin Parameters can be a useful debugging tool. If
incorrect settings were previously applied, a device should be able to
reconnect after this. If it is doesn’t there is likely a hardware fault.
To program the FW:
- Open the tool
- Tick the Program Firmware checkbox
- Power on the device
- Plug the adapter cable into the device and hold until the screen flashes
Results: 
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
- To increase the detail of future debug logs, go to Debug -> Enable Debug Logs in the menu.
- To read all existing logs, go to Debug -> Read Debug Logs in the menu.
- 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, as all available device history is read (even previously uploaded history).
- This is not the fastest process, but may help to determine why a device isn’t connecting when the online debug logs are unavailable
- There is a Save CSV option on the dialogue which appears with the logs. Use this to save a copy of the logs to send to our support team for further debugging.
Or watch our how-to video
SETTING THE MODEM PROFILES
As described in this article, the modem’s internal network profiles may need
to be updated to add support for DNS on certain NB-IoT networks. Checking the
Set Modem Profiles checkbox before inserting the adapter cable will cause the
tool to power up the device’s modem and update the profiles if required. This
adds a few seconds to the programming cycle, during which a dialog box
displays the progress.
You can take advantage of this to check the modem function when debugging
devices that are suspected faulty. If the modem is not responding, an error
message will be displayed during the modem profile check. If the device has a
stable power supply, and the modem is not currently attempting to update its
firmware, an error message during the profile check is a good indicator of
faulty hardware.
If the modem is busy trying to update its firmware, the profile update cannot
be run. You can restart the device and leave it on power for 30 minutes to
allow the firmware update to complete.
SENDING AT COMMANDS TO THE MODEM
The provisioning tool also allows a command line to be opened – and AT
commands sent directly to the modem.
To access – simply hit Ctrl + Alt + M with the provisioning tool open.
There is a Transfer File option at the top of the window which opens.
59 Steam Whistle Dr, Warminster,
PA 18974
[email protected]
calchipconnect.com