p1sec/qcsuperQCSuper ist ein Tool zur Kommunikation mit Smartphones und Modems auf Qualcomm-Basis, das unter anderem das Erfassen roher 2G/3G/4G-Funkrahmen ermöglicht.
QCSuper ist ein Tool, das mit Qualcomm-basierten Telefonen und Modems kommuniziert und es ermöglicht, rohe 2G/3G/4G- (und bei bestimmten Modellen 5G-) Funkrahmen zu erfassen, unter anderem.
Es ermöglicht Ihnen, PCAP-Erfassungen zu generieren – entweder mit einem gerooteten Android-Telefon, einem USB-Dongle oder einer vorhandenen Erfassung in einem anderen Format.
Nachdem Sie es installiert haben, können Sie Ihr gerootetes Telefon per USB anschließen, und die Verwendung mit einem kompatiblen Gerät ist so einfach wie:```bash qcsuper --adb --wireshark-live
Oder, wenn du manuell das Freigeben eines Diag-Ports über dein Telefon aktiviert hast (das entsprechende Verfahren kann je nach Telefonmodem und Hersteller variieren, siehe unten für weitere Erklärungen), oder wenn du einen Mobilfunk-Dongle angeschlossen hast:```bash
qcsuper --usb-modem auto --wireshark-live
Es verwendet das Qualcomm-Diag-Protokoll, auch QCDM oder DM (Diagnostic Monitor) genannt, um mit dem Baseband deines Telefons zu kommunizieren.
Du bist bereit zu melden, ob dein Gerät funktioniert oder nicht? Du kannst ein Github-Issue eröffnen.
Anhänge:
Blogbeitrag/Demo: Vorstellung von QCSuper: Ein Tool zum Erfassen deines 2G/3G/4G-Funkverkehrs auf Qualcomm-basierten Telefonen
Weitere Dokumentation:
QCSuper wurde zuletzt auf Ubuntu LTS 22.04+ getestet und entwickelt und wurde auch unter Windows 11 verwendet. Es hängt von einigen Python-Modulen ab. Für eine bessere Kompatibilität wird die Verwendung von Linux empfohlen.
Zur Verwendung muss dein Telefon gerootet sein oder einen Diag-Dienstport über USB bereitstellen. Um die Kompatibilität mit deinem Telefon zu prüfen, suche das Modell des Telefons auf einer Website wie GSMArena und prüfe, ob es einen Qualcomm-Prozessor hat.
Um PCAP-Dateien zu öffnen, die von QCSuper erzeugt wurden, kannst du jede Wireshark-2.x- bis 4.x-Version für 2G/3G-Frames verwenden, aber du benötigst mindestens Wireshark 2.5.x für 4G-Frames (und 2.6.x für einzelne NAS-Nachrichten, die aus 4G-Frames entschlüsselt wurden). Ubuntu bietet derzeit einen ausreichend aktuellen Build für alle Versionen.
Das Dekodieren von 5G-Frames wurde unter Wireshark 3.6.x und höher getestet und erfolgt durch die automatische Installation eines Wireshark-Lua-Plugins (in %APPDATA%\Wireshark\plugins unter Windows oder in ~/.local/lib/wireshark/plugins unter Linux und macOS), was durch Setzen der Umgebungsvariable DONT_INSTALL_WIRESHARK_PLUGIN=1 vermieden werden kann, falls du dies umgehen möchtest.
Um die stabile Version von QCSuper systemweit von PyPI zu installieren, kannst du diese Befehle ausführen:```bash
sudo apt install python3-pip wireshark
sudo pip3 install --upgrade qcsuper --break-system-packages
Danach kannst du einfach `qcsuper` in deinem Terminal eingeben, um QCSuper auszuführen.
Um die Entwicklungsversion in einem bestimmten Ordner zu installieren, öffne ein Terminal und gib Folgendes ein:```bash
# Download QCSuper
git clone https://github.com/P1sec/qcsuper
cd qcsuper
# Install dependencies
sudo apt install python3-pip wireshark
sudo pip3 install --upgrade . --break-system-packages
Führen Sie dann QCSuper aus dem Verzeichnis qcsuper/ aus, indem Sie den Befehl ./qcsuper.py im Terminal verwenden.
Unter Linux können Sie QCSuper mit dem Paketmanager uv installieren, der eine moderne Alternative zu PIP ist.
Führen Sie zuerst einen der folgenden Befehle in Ihrem Terminal aus, um uv zu installieren:```bash
sudo snap install --classic astral-uv # On Ubuntu
sudo dnf install -y uv # On Fedora
sudo pacman -S uv # On Archlinux, Manjaro
curl -LsSf https://astral.sh/uv/install.sh | sh # On Debian and others
Führen Sie dann Folgendes aus, um die neueste stabile Version zu installieren:```bash
uv tool install qcsuper
Alternativ können Sie die neueste Entwicklungsversion mit folgendem Befehl installieren:```bash uv tool install git+https://github.com/P1sec/qcsuper
Du kannst das dann einfach in dein Terminal eingeben:```bash
qcsuper
Wenn Sie qcsuper jedoch als root ausführen müssen, zum Beispiel weil Sie Daten von einem Modemgerät lesen, ist qcsuper bei Verwendung von uv mit sudo möglicherweise nicht in $PATH, sodass möglicherweise so etwas erforderlich ist wie:```bash
sudo env "PATH=$PATH" qcsuper
Wenn Sie an der Entwicklung des Tools teilnehmen möchten, können Sie diese Befehle verwenden, um den Quellcode herunterzuladen und dann symbolische Links zu QCSuper in `~/.local/bin` in das Quellverzeichnis zu erstellen:```bash
git clone https://github.com/P1sec/qcsuper
cd qcsuper
uv sync # Create .venv in the current directory
uv tool install -e . # Create symlinks into ~/.local/bin
QCSuper kann unter Windows ausgeführt werden, aber Sie sollten zuvor sicherstellen, dass die ADB-Eingabeaufforderung von Google auf Ihrem Rechner mit Ihrem Gerät korrekt funktioniert, und Sie sollten außerdem manuell libusb-win32-Filter erstellen (über das Dienstprogramm, das nach der Installation im Startmenü verfügbar ist), falls Ihr Gerät sich direkt über pseudo-serielles USB mit dem Diag-Port verbinden muss.
(Bitte beachten Sie, dass sich bei einem Moduswechsel Ihres Geräts die zugehörige USB-PID/VID ändern kann und es erforderlich sein kann, die Treiberzuordnungen im libusb-win32-Filtererstellungsprogramm – und/oder je nach Fall im Windows-Geräte-Manager – erneut vorzunehmen)
Unter Windows müssen Sie möglicherweise (zusätzlich zu den Google-ADB-Kerneltreibern) die USB-Treiber Ihres Telefons für Ihr Telefonmodell herunterladen und installieren (dies kann generische Qualcomm-USB-Treiber einschließen). Bitte suchen Sie bei Google nach Ihrem Telefonmodell + „USB-Treiber" oder „ADB-Treiber" für Anweisungen.
Dann müssen Sie sicherstellen, dass Sie Ihr Gerät mit adb erreichen können. Eine Anleitung zum Herunterladen und Einrichten von adb finden Sie hier. Der Befehl adb.exe shell (oder welchen ausführbaren Pfad Sie auch verwenden, eine Kopie der ADB-Ausführungsdatei befindet sich im Ordner qcsuper/inputs/external/adb von QCSuper) muss eine Eingabeaufforderung anzeigen, um fortzufahren.
Folgen Sie dann diesen Links (das Tool wurde zuletzt unter Windows 11 getestet – es ist nicht garantiert, dass es unter Windows 7 funktioniert), um Folgendes zu tun: