Tool

qc_debug_monitor

Python monitor by Dmytro Oleksiuk (Cr4sh) that reads debug messages from Qualcomm cellular-modem firmware in real time over the modem's DIAG serial port, on a rooted Android phone or a USB modem. It enables message reporting for chosen 16-bit subsystem IDs, prints or logs text messages with their firmware source file and line, and decodes terse messages, which carry only a 32-bit format-string hash and arguments, when given a hash database. A discovery mode lists the subsystem ID ranges a modem answers to, and logs can be split into one file per subsystem.

Targets: Firmware
Category: Firmware tools
Relationship: Foundation tool
Sources reviewed: 2026-10-27

Stars: 79
Last commit: 2020-11-01
Language: Python

GitHub data as of 2026-11-09

Copy as Markdown View JSON Cite

Requirements & limits

Prerequisites: Run the Python 2 script with pySerial and access to a serial device such as /dev/ttyUSB0; the README uses sudo. The repository has no tags or releases.
Prerequisites: A Qualcomm modem with an exposed DIAG serial port is required. The documented Quectel EC25 example uses an MDM9607; other devices may need subsystem ranges found with discovery mode.
Prerequisites: Terse-message decoding requires an external database of Qualcomm firmware debug-message hashes. The README gives no provenance or reuse terms for that database; without it, terse messages remain undecoded.
Testing evidence: The README describes example logs from an EC25 connected to an srsLTE eNodeB and labels subsystem descriptions as guesses. The repository contains no firmware images, and the project has no tests.
License: The repository has no license file or license statement.

Cite

BibTeX

@misc{qc-debug-monitor,
  title = {{qc\_debug\_monitor}},
  howpublished = {\url{https://github.com/Cr4sh/qc_debug_monitor}},
  url = {https://github.com/Cr4sh/qc_debug_monitor},
  urldate = {2026-10-27},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/qc-debug-monitor/}}
}

Plain text

qc_debug_monitor. https://github.com/Cr4sh/qc_debug_monitor (accessed 2026-10-27). Awesome REA entry: https://awesomerea.org/resources/qc-debug-monitor/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

README.MD GitHub · Cr4sh/qc_debug_monitor · Revision d4c2f80
README.MD#L44-L46 GitHub · Cr4sh/qc_debug_monitor · Revision d4c2f80
README.MD#L89-L93 GitHub · Cr4sh/qc_debug_monitor · Revision d4c2f80
qc_debug_monitor.py GitHub · Cr4sh/qc_debug_monitor · Revision d4c2f80
examples GitHub · Cr4sh/qc_debug_monitor · Revision d4c2f80