CalChip CONNECT Digital Matter DM-Link Tool User Guide

June 9, 2024
CalChip CONNECT

CalChip logo 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:

  1. The device must be powered on
  2. After use, disconnect all cables and power cycle the device to continue normal operation.

TOOL FEATURES

CalChip CONNECT Digital Matter DM-Link Tool - fig 3

  1. Tick these options to set the firmware on the device, and apply the parameters that are set below (6).
  2. This checkbox updates the modem’s internal profiles to support DNS on some NB-IoT networks (see here).
  3. This clears any system parameters that might have been set through OEM server.
  4. Each supported device has a separate Admin Parameters tab.
  5. Opens the serial list. A list of devices read by the tool and the result of the read/writes are shown here.
  6. 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:

  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 flashes

Results: CalChip CONNECT Digital Matter DM-Link Tool - fig
4The 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
support@calchipconnect.com
calchipconnect.com

References

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>

Related Manuals