または、手動で携帯電話のDiagポートを公開するように設定している場合（対応する手順は携帯電話のモデムやメーカーによって異なる場合があります。詳細は以下を参照してください）、またはモバイルブロードバンドドングルを接続している場合：```bash
qcsuper --usb-modem auto --wireshark-live

そして、ターミナルで `qcsuper` と入力するだけで QCSuper を実行できます。

開発版を特定のフォルダにインストールするには、ターミナルを開いて次のように入力します:```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

次に、これを実行して最新の安定版をインストールします：```bash
uv tool install qcsuper

あとはこれをターミナルに入力するだけです：```bash
qcsuper

ツールの開発に参加したい場合は、ソースをダウンロードしてから、ソースディレクトリを指す QCSuper へのシンボリックリンクを `~/.local/bin` に作成するには、以下のコマンドを使用できます:```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

コマンドプロンプトのまま、`cd` コマンドを使用して QCSuper を含むディレクトリに移動します。その後、コマンドを実行できます（オンラインインストーラーから Python 3 をインストールした場合は `py qcsuper.py` または `py3 qcsuper.py` で始まり、Windows ストアからインストールした場合は `python3.exe .\qcsuper.py` で始まります）。

上記のとおり、モードスイッチされたデバイス上の Diag ポートに対応するインターフェイスが QCSuper から見えるようにするために、スタートメニューにあるユーティリティを使用して `libusb-win32` フィルタを追加する必要がある場合があります（ADB ドライバが動作しており、デバイスが正しく root 化されている場合、`--adb` フラグを使用してツールを最初に実行したときに失敗すると、モードスイッチがトリガーされるはずです）。

<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/48811/e7aab43a3643cd941857febb8fcb8e2d7bf8c3638629a4e5591dc689afa48c07.png" alt="Mi スマートフォンの Diag ポートに libusb-win32 フィルタを追加するスクリーンショット">
</p>

## 対応プロトコル

QCSuper は、いくつかのモバイル無線プロトコルのキャプチャをサポートしています。これらのプロトコルは、プロトコルを識別できるようにする標準ヘッダー（UDP/IP にカプセル化される）である [GSMTAP ヘッダー](http://osmocom.org/projects/baseband/wiki/GSMTAP) の後に配置され、GSMTAP パケットは Wireshark で完全に分析可能な [PCAP ファイル](https://wiki.wireshark.org/Development/LibpcapFileFormat) に格納されます。

2G/3G/4G プロトコルはいくつかの「レイヤー」に分類できます。レイヤー1 はデジタル無線変調と多重化に関するもので、レイヤー2 は断片化や確認応答などの処理を担当し、レイヤー3 は本来のシグナリングまたはユーザーデータです。

QCSuper は、ほとんどの場合レイヤー3 でキャプチャできます。これは Wireshark での分析に最も実用的であり、Diag プロトコルがネイティブに提供するものだからです（ここにはいくつかの興味深い情報もあります）。

* 2G (GSM): レイヤー3 以上（RR/...）
* 2.5G (GPRS and EDGE): データの確認応答用のレイヤー2 以上（MAC-RLC/...）
* 3G (UMTS): レイヤー3 以上（RRC/...）
  * さらに、Wireshark は現時点で独自に処理できないため、SIBs（System Information Blocks、全ユーザーにブロードキャストされるデータ）を個別の GSMTAP フレームに再構築することをサポートしています: フラグ `--reassemble-sibs`
* 4G (LTE): レイヤー3 以上（RRC/...）
  * さらに、RRC パケット内に暗号化されて埋め込まれている NAS メッセージを復号し、追加のフレームに格納することをサポートしています: フラグ `--decrypt-nas`

デフォルトでは、デバイスが送信する IP トラフィックは含まれず、シグナリングフレームのみが表示されます。`--include-ip-traffic` オプションを使用すると、生成した IP トラフィックを含めることができます（IP は 2G/3G/4G におけるデータトラフィックのほぼレイヤー3 であり、ヘッダーが圧縮（ROHC）され、小さな PPP ヘッダーが含まれる場合があるという詳細があります）。

送信するデータトラフィックはシグナリングトラフィックとは異なるチャネルを使用します。このチャネルはシグナリングトラフィックを通じて設定されます。したがって、QCSuper はこのチャネルがどのように開始されるかに関するすべての詳細を表示するはずです。

## 使用上の注意

QCSuper を使用するには、1 つの入力（例: `--adb`（Android フォン）、`--usb-modem`）と 1 つ以上のモジュール（Wireshark を開くための `--wireshark-live`、トラフィックを PCAP ファイルに書き込むための `--pcap-dump`、デバイスに関する一般的な情報を取得するための `--info` など）を指定します。

入力できるコマンドの例:```bash
# Open Wireshark directly, using a rooted Android phone as an input,
# for compatible phones:
$ qcsuper --adb --wireshark-live

# ^ this command is equivalent to (prefer this when running as root):
$ qcsuper --adb --pcap-dump - | wireshark -k -i -

# Same, but dump to a PCAP file instead of opening Wireshark directly
$ qcsuper --adb --pcap-dump /tmp/my_pcap.pcap

以下は、QCSuperの現在の使用上の注意です：```
usage: qcsuper [-h] [--cli] [--efs-shell] [--efs-shell2] [-v] (--adb | --adb-wsl2 ADB_WSL2 | --tcp IP_ADDRESS:TCP_PORT | --usb-modem TTY_DEV | --dlf-read DLF_FILE |
               --json-geo-read JSON_FILE) [--info] [--pcap-dump PCAP_FILE] [--wireshark-live] [--memory-dump OUTPUT_DIR] [--dlf-dump DLF_FILE] [--json-geo-dump JSON_FILE]
               [--decoded-sibs-dump] [--reassemble-sibs] [--decrypt-nas] [--include-ip-traffic] [--start MEMORY_START] [--stop MEMORY_STOP]

A tool for communicating with the Qualcomm DIAG protocol (also called QCDM or DM).

options:
  -h, --help            show this help message and exit
  --cli                 Use a command prompt, allowing for interactive completion of commands.
  --efs-shell           Spawn an interactive shell to navigate within the embedded filesystem (EFS) of the baseband device.
  --efs-shell2          Spawn an interactive shell to navigate within the embedded filesystem (EFS) of the baseband device. Use the secondary filesystem known as "alternate".
  -v, --verbose         Add output for each received or sent Diag packet.

Input mode:
  Choose an one least input mode for DIAG data.

  --adb                 Use a rooted Android phone with USB debugging enabled as input (requires adb).
  --adb-wsl2 ADB_WSL2   Unix path to the Windows adb executable. Equivalent of --adb command but with WSL2/Windows interoperability.
  --tcp IP_ADDRESS:TCP_PORT
                        Connect to remote TCP service exposing DIAG interface.
  --usb-modem TTY_DEV   Use an USB modem exposing a DIAG pseudo-serial port through USB.
                        Possible syntaxes:
                          - "auto": Use the first device interface in the system found where the
                            following criteria is matched, by order of preference:
                            - bInterfaceClass=255/bInterfaceSubClass=255/bInterfaceProtocol=48/bNumEndpoints=2
                            - bInterfaceClass=255/bInterfaceSubClass=255/bInterfaceProtocol=255/bNumEndpoints=2
                          - usbserial or hso device name (Linux/macOS): "/dev/tty{USB,HS,other}{0-9}"
                          - COM port identifier (Windows): "COM{0-9}"
                          - "vid:pid[:cfg:intf]" (vendor ID/product ID/optional bConfigurationValue/optional
                            bInterfaceNumber) format in hexa: e.g. "05c6:9091" or "05c6:9091:1:0 (vid and pid
                            are four zero-padded hex digits, cfg and intf are canonical values from the USB
                            descriptor, or guessed using the criteria specified for "auto" above if not specified)
                          - "bus:addr[:cfg:intf]" (USB bus/device address/optional bConfigurationValue/optional
                            bInterfaceNumber) format in decimal: e.g "001:003" or "001:003:0:3" (bus and addr are
                            three zero-padded digits, cfg and intf are canonical values from the USB descriptor)
  --dlf-read DLF_FILE   Read a DLF file generated by QCSuper or QXDM, enabling interoperability with vendor software.
  --json-geo-read JSON_FILE
                        Read a JSON file generated using --json-geo-dump.

Modules:
  Modules writing to a file will append when it already exists, and consider it Gzipped if their name contains ".gz".

  --info                Read generic information about the baseband device.
  --pcap-dump PCAP_FILE
                        Generate a PCAP file containing GSMTAP frames for 2G/3G/4G, to be loaded using Wireshark.
  --wireshark-live      Same as --pcap-dump, but directly spawn a Wireshark instance.
  --memory-dump OUTPUT_DIR
                        Dump the memory of the device (may not or partially work with recent devices).
  --dlf-dump DLF_FILE   Generate a DLF file to be loaded using QCSuper or QXDM, with network protocols logging.
  --json-geo-dump JSON_FILE
                        Generate a JSON file containing both raw log frames and GPS coordinates, for further reprocessing. To be used in combination with --adb.
  --decoded-sibs-dump   Print decoded SIBs to stdout (experimental, requires pycrate).

PCAP generation options:
  To be used along with --pcap-dump or --wireshark-live.

  --reassemble-sibs     Include reassembled UMTS SIBs as supplementary frames, also embedded fragmented in RRC frames.
  --decrypt-nas         Include unencrypted LTE NAS as supplementary frames, also embedded ciphered in RRC frames.
  --include-ip-traffic  Include unframed IP traffic from the UE.

Memory dumping options:
  To be used along with --memory-dump.

  --start MEMORY_START  Offset at which to start to dump memory (hex number), by default 00000000.
  --stop MEMORY_STOP    Offset at which to stop to dump memory (hex number), by default ffffffff.

この出力に含まれる `001:076`（バスインデックス/デバイスインデックス識別子）と `05c6:9091`（ベンダーID/プロダクトID）の情報に注意してください。

この情報が得られたら、QCSuper で **`--usb-modem 05c6:9091` や `--usb-modem 001:076` のようなフラグを試すことができます**（ゼロ埋めに注意してください）。

これで判断がつかない場合は、`lsusb -v -d 05c6:9091` コマンドを使用できます。このコマンドは、対応する USB デバイスの USB 構成、インターフェース、エンドポイントを含む詳細な出力を生成するはずです：```
Bus 001 Device 027: ID 05c6:9091 Qualcomm, Inc. Intex Aqua Fish & Jolla C Diagnostic Mode
Device Descriptor:
  bLength                18
  bDescriptorType         1
  bcdUSB               2.01
  bDeviceClass            0 
  bDeviceSubClass         0 
  bDeviceProtocol         0 
  bMaxPacketSize0        64
  idVendor           0x05c6 Qualcomm, Inc.
  idProduct          0x9091 Intex Aqua Fish & Jolla C Diagnostic Mode
  bcdDevice            5.04
  iManufacturer           1 Xiaomi
  iProduct                2 Mi 11
  iSerial                 3 d94f4341
  bNumConfigurations      1
  Configuration Descriptor:
    bLength                 9
    bDescriptorType         2
    wTotalLength       0x0086
    bNumInterfaces          4
    bConfigurationValue     1
    iConfiguration          4 Default composition
    bmAttributes         0x80
      (Bus Powered)
    MaxPower              500mA
    Interface Descriptor:
      bLength                 9
      bDescriptorType         4
      bInterfaceNumber        0
      bAlternateSetting       0
      bNumEndpoints           2
      bInterfaceClass       255 Vendor Specific Class
      bInterfaceSubClass    255 Vendor Specific Subclass
      bInterfaceProtocol     48 
      iInterface              0 
[...]

## QCSuper を USB モデムで使う

`--usb-modem <device>` オプションを使うと、Diag ポートを公開している USB モデムで QCSuper を使用できます。ここで `<device>` は、Linux 上の疑似シリアルデバイス名（`/dev/ttyUSB0`、`/dev/ttyHS2` などの候補）または Windows 上の COM ポート名（`COM2`、`COM3` など）です。

多くのセットアップでは、このモードを使用するために QCSuper を root として実行する必要があることに注意してください。特にシリアルポートの競合を処理する場合が該当します。

`/dev` 配下のどのデバイスが Diag ポートを公開しているか分からない場合は、複数のデバイスを試す必要があるかもしれません。ModemManager デーモンを停止し（`sudo systemctl stop ModemManager`）、次のコマンドを使用して自動検出を試すことができます: `sudo ModemManager --debug 2>&1 | grep -i 'port is QCDM-capable'` その後 Ctrl-C を押します。

そもそも ModemManager などでデバイスを使用できない場合、そのデバイスが完全にセットアップされておらず、QCSuper でも動作しない可能性が高いことに注意してください。考えられる注意点は次のとおりです:

  * デバイスに対して適切な[モード切替](https://wiki.archlinux.org/index.php/USB_3G_Modem#Mode_switching)コマンドを適用していない。

  * 以前に別の事業者の SIM が挿入されていたデバイスを購入した場合、そのデバイスは SIM ロックされている可能性があります。以前の事業者のロック解除コードを PIN コードと同じようにデバイスに送信する必要があるかもしれません: `sudo mmcli -i 0 --pin=<your_unlock_code>`

Qualcomm ベースの USB デバイスがデフォルトで Diag ポートを公開しない場合、Diag ポートを有効にするために AT ポート経由で次のコマンドを入力する必要があるかもしれません:```
AT$QCDMG