Dragino Logger Configuration Guide

This guide covers two methods for configuring Dragino cellular devices with the sentek profile:

1. Automated — using the cellularConfig.py Python script
2. Manual — using the macOS app BLEDeviceInfo / BluetoothDeviceInfo

Before you begin, have the following ready:

• The device's IMEI (this is the BLE advertised name)
• The device's PIN (the AT+PIN password value)
• The APN string for your cellular carrier

Method 1: Using cellularConfig.py¶

Prerequisites¶

• Python 3 installed
• The bleak Bluetooth library installed:

  pip install bleak
  

• Bluetooth enabled on your computer
• The Dragino device powered on and in Bluetooth advertising mode

Running the Script¶

python3 cellularConfig.py --imei <IMEI> --pw <PIN> --apn <APN>

The --config flag defaults to sentek and does not need to be specified.

What the Script Does¶

1. Scans for BLE devices and looks for one whose name matches the IMEI.
2. Connects to the device via BLE.
3. Waits for the "Network Information" startup message from the device.
4. Sends the PIN/password if one was provided (non-zero).
5. Sends AT+GNSST=10 and AT+CMDEAR=1,10 (twice) to clear existing commands and prepare the device.
6. Waits for the "NB module power-off successful." message, then sends the full configuration sequence (APN, all AT commands, and the CLIENT ID).
7. Sends AT+CFG to finalize and waits 15 seconds.
8. Prints "Configuration Complete!" and disconnects.

If the device is not found, the script retries up to 10 times with 5-second waits between attempts.

Method 2: Using BLEDeviceInfo / BluetoothDeviceInfo (macOS App) or Dragino Device.tool (Android App)¶

Connecting¶

1. Open the BLEDeviceInfo app (or Dragino Device.tool app).
2. Scan for devices and connect to the one matching your device's IMEI. If on the Dragino Device.tool app, you will need to also click the dial button to get to the screen in which you can send commands.
3. Switch to the Bluetooth characteristic FFE1 to send and receive commands (only for BLEDeviceInfo app). This is the UART-like characteristic the Dragino uses for AT command communication. Commands sent on any other characteristic will not work.

Command Sequence¶

After connecting and selecting FFE1, wait for the device to send its startup messages. You should see a "Network Information" message appear in the received data before proceeding.

Step 1 — Send Password¶

If the device has a PIN set, send the PIN followed by a carriage return and newline:

<PIN>

Wait approximately 5 seconds for acknowledgment.

Step 2 — Prepare the Device¶

Send the following commands in order:

AT+GNSST=10

Wait to see 'OK', then:

AT+CMDEAR=1,10

Wait to see 'OK', then send the same command again:

AT+CMDEAR=1,10

Wait for the message "NB module power-off successful." to appear in the received data before continuing.

Step 3 — Send APN¶

AT+APN=<APN>

Replace <APN> with your APN string (e.g. 10569.mcs).

Step 4 — Send Configuration Commands¶

Send each command one at a time, waiting approximately 3 seconds between each. Each command must end with a carriage return and newline (\r\n). In BLEDeviceInfo, ensure your line ending settings are configured appropriately or append them manually.

Use the command set that matches your attached probe:

Option 1: Sentek Drill & Drop Probe Commands¶

Important: For AT+SERVADDR=3.130.231.188,1883, send this command twice with a 3-second wait between sends.

Option 2: Martbox 2-Sensor Temperature Probe Commands¶

Note: AT+TDC=1200000 sets a 20-minute transmit interval (value is in milliseconds, used by LoRaWAN devices).

Step 5 — Send CLIENT ID¶

AT+CLIENT=<LAST5>

Replace <LAST5> with the last 5 digits of the device's IMEI. Wait ~3 seconds.

Step 6 — Finalize Configuration¶

AT+CFG

Wait approximately 15 seconds for the device to process and confirm.

Verifying Configuration¶

After AT+CFG is sent, the device should echo back its full configuration. Confirm that the following fields match what was sent:

• SERVADDR — 3.130.231.188,1883
• PUBTOPIC — iris_readings
• SUBTOPIC — iris_commands
• CLIENT — last 5 digits of the IMEI
• APN — your APN string
• All COMMAND and DATACUT entries