A terminal UI for configuring and monitoring the Mictrack MT710 GPS tracker over its USB config cable: a local, more complete alternative to https://config.mictrack.com.
┌─ MT710 Config Tool ──────────────────────────────┬─ Device log ────────┐
│ [Setup] [Device] [Reference] [Guide] [Batch] │ <CFG>:ETS,OK │
│ │ → RCONF │
│ Network · Working Mode (all 11) · Options │ MDL:MT710 │
│ Home zone (AP/GEO) · Danger zone │ SV:V2.1.8 │
├──────────────────────────────────────────────────┴─────────────────────┤
│ raw command: RCONF ▂ │
└───────────────────────────────────────────────────────────────────────┘
- Live serial console: verbatim device output (
<Trace>:debug chatter dimmed), timestamps, autoscroll pause, save-to-file, and a live activity ticker (↓bytes ↑bytes · last RX 4s ago) so a quiet device is never mistaken for a broken console. Note: the MT710 is silent on USB except when answering commands (reports go over the cellular link). That ticker is how you tell. - Connection status pill:
◌ DISCONNECTED/… CONNECTING/● CONNECTEDplus a clickable Connect (F2) button; a separate● ETSbadge tracks the config session (it ends on reboot orQTS). - Debug toggle: one-click
DBG: on/offbutton in the console header (sendsETS → DBG,x → QTS, state auto-detected from RCONF and reply echoes). Debug increases power use; toggle off when done. - Raw command bar: hardware-accurate validation (exact rules from
Mictrack's own web tool), ↑/↓ history, 30+ presets, auto-uppercase of
the keyword, confirm gate on
RESET, "force send" escape hatch. Every send attempt leaves a trace in the feed, including rejections (invalid, not connected, no ETS session). - Full command reference: every MT710 USB command with format, parameter ranges, defaults, expected replies, save semantics and per-command explanations merged from the official PDFs and the hardware-validated web tool, including every known documentation discrepancy, flagged inline.
- All 11 working modes (0–10 + LOCK) with contextual parameter inputs and power-behaviour notes; the web tool only exposes four.
- Setup forms (scrollable) populated automatically from the device's RCONF, with per-section include checkboxes and a review-before-send apply flow (MODE last, auto-REBOOT if needed, reboot watchdog).
- Batch runner: multi-command textarea, per-line validation preview,
import/export of web-tool-compatible
#-commented command files. - Device info: friendly RCONF grid with explanations + raw dump.
# with pip
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
# or with uv (what this repo currently uses; venv has no pip)
uv venv .venv
source .venv/bin/activate
uv pip install -e .
/mt710 # TUI (version chip sits in the console header)
mt710 --version # print version + resolved module path
mt710 --probe # scripted read-only check (ETS + RCONF)
mt710 --list-portsRequires Linux/macOS (or Windows) + a USB config cable
(Prolific/CH340/CP210x/FTDI are auto-detected). Your user needs access to
the serial port (uucp/dialout group on Linux).
| key | action |
|---|---|
F2 |
connect / disconnect (ETS wake + RCONF read) |
F5 |
re-read config (RCONF) |
F9 |
review & apply the Setup form |
c |
cycle serial port |
Enter (raw bar) |
validate + send raw command |
↑/↓ (raw bar) |
command history |
Ctrl+T/L/S |
timestamps / clear log / save log |
Console-header buttons: TS timestamps · Clear · Save ·
Pause/Follow autoscroll · DBG toggle debug output. All buttons are
clickable; everything also works keyboard-only.
- 921600 baud 8N1, DTR+RTS asserted on open.
- Commands are sent verbatim (no CR/LF terminator); replies are
\r\n-separated, prefixed<CFG>:, with no trailing newline (250 ms idle-flush reassembles them). ETSopens the config session (3 tries × 1.8 s); the session dies on reboot/boot-banner and is tracked passively.- Unknown or lowercase commands get no reply at all, hence the validator.
MODE/REBOOTsave + reboot,QTSsaves without rebooting,RESETwipes to factory defaults without rebooting; everything else needs an explicit save.
| topic | PDF says | tool uses |
|---|---|---|
MODE,1 interval |
60–600 s (one table) vs 10–600 s (others) | 10–600 s |
NWM,0,0,2 |
not documented | supported (confirmed on real MT710) |
LTP |
listed in web tool | flagged ignored (MT710 has no light sensor) |
XTRA,SCAN,SEARCH,AP,GEO |
missing from PDF USB table | supported |
GSEN |
PDF-only (SMS #999#) |
supported, T4=187 quirk noted |
RCONF,1..4 |
paged dumps (downlink only) | USB RCONF returns all |
python -m pytest156 cases: command validator matrix, RCONF parser (real PDF dump), transport chunk reassembly / idle-flush / blank-line burst rule, passive ETS/QTS session tracking. UI layout is additionally verified via Textual pilot runs that check the painted output at several terminal sizes.
Cat M1 & NB-IoT (2G fallback) tracker, IP68, 650 mAh (≈12 months at one report/day), GPS/WiFi/LBS positioning, Qualcomm Gen 8C GNSS, Nano SIM. Programmable over USB, SMS or platform downlink.
This is an independent, community tool, not affiliated with, endorsed by, or supported by Mictrack.
Documentation sources used to build it:
mictrack_mt710_docs/: official Mictrack PDFs (command lists + user manual), redistributed here for interoperability. Copyright Mictrack; see their site for originals.- The public web config tool (config.mictrack.com v1.2.32); its client-side JS was studied to extract hardware-validated validator rules and protocol timings.
- Live testing against a real MT710 (FW V2.1.8).
"Mictrack" and "MT710" are trademarks of Mictrack; LEDs, modes and firmware behaviour described here come from the vendor's own documents and may change with firmware updates; always verify against your own device (the tool's Reference tab documents every known discrepancy between sources).
Code and documentation in this repository are licensed under the
European Union Public Licence v. 1.2 (EUPL-1.2), except
mictrack_mt710_docs/ and assets/mt710-photo.jpg, which are
proprietary Mictrack material kept for interoperability/reference.