はじめに
Qualcommモデム搭載、root化済みのAndroidスマートフォン単体でQMDLファイルを取得する方法を記載します。
QMDLファイルの解析にはQualcomm公式ツールのQXDMが必要です。
(LTE/5GについてはOSSツールのSCATでポストプロセス可能)
本記事の内容は個人の趣味・検証に基づいた技術メモです。設定の変更やコマンドの実行はご自身の責任で行ってください。動作不具合や保証対象外となった場合でも当方は責任を負いません。
手順
環境
- moto g53y 5G (XT2335-4) (root化済)
- Debian 13 (ADB導入済み)
準備
まず、必要なコマンドが利用可能かどうかを調べておきます。
penang:/ # which diag_mdlog
/vendor/bin/diag_mdlog
penang:/ # which diag_mdlog-wrap
/vendor/bin/diag_mdlog-wrap
Termuxからのroot環境の場合、/vendor/binへのPATHが通っていないことがあるため、ADBのシェルから実行することをおすすめします。
(QMDLファイルの取得自体はTermuxからのroot環境でも可能)
1. マスクファイルを準備する
全ての項目について記録すると、QMDLファイルが肥大化してしまうため、マスクファイルを指定して必要な項目のみを記録するようにします。
(QXDMがある場合はカスタマイズしたマスクファイルを作成できますが、今回は予めベンダーが作成したマスクファイルを使用します。)
マスクファイルを検索します。
penang:/ # find / -name "*.cfg"
例:
penang:/ # ls -1 /vendor/etc/diag_mdlog/
4G_5G_Throughput_light_V1.cfg
ADSP-sensor.cfg
Bluetooth-WLAN-coex_V01.cfg
Bluetooth_V1.cfg
Bluetooth_split_audio_V1.cfg
Connection_Issues_V15_with_RF_and_tuner_log.cfg
Connection_Issues_V16.cfg
DIAG_WLAN_Modem_AS.cfg
DIAG_WLAN_Modem_no_AS.cfg
...
2. 引数を準備する
diag_mdlogに渡す引数を用意します。デフォルトの引数は/vendor/etc/diag_mdlog/default.optsにあるようです。
penang:/ # cat /vendor/etc/diag_mdlog/default.opts
--filemsm=/vendor/etc/diag_mdlog/Connection_Issues_V16.cfg --output=/data/vendor/diag_mdlog/logs --optimized --qmdl2_v2 --size=50 --number=9
引数をカスタマイズしたい場合は、/data/vendor/diag_mdlog/user3.optsに引数を書き込みます。
penang:/ # echo "--filemsm=/data/local/tmp/customized-mask.cfg --optimized --qmdl2_v2 --size=50 --number=9" > /data/vendor/diag_mdlog/user3.opts
penang:/ # chown log:log /data/vendor/diag_mdlog/user3.opts
penang:/ # chmod 664 /data/vendor/diag_mdlog/user3.opts
引数一覧
penang:/ # diag_mdlog --help
diag_mdlog: MOT - Enter main()
diag_mdlog: command = h
Usage for diag_mdlog:
-a --hdlcdisable: Disbale hdlc encoding
-b --nonrealtime: Have peripherals buffer data and send data in non-real-time
-c --cleanmask: Send mask cleanup to modem at exit
-d --disablecon: Disable console messages
-e --enablelock: Run using wake lock to keep APPS processor on
-f, --filemsm: mask file name for MSM
-g, --userpd: bitmask for userpd interested
-h, --help: usage help
-j, --proc: Proc mask to be selected for logging
-k, --kill: kill existing instance of diag_mdlog
-l, --filelist: name of file containing list of mask files
-m, --filemdm: mask file name for MDM
-n, --number: maximum file number
-o, --output: output directory name
-p, --peripheral: bit mask for the peripherals interested
-q, --qdss: peripheral bit mask for qdss logging
-r --renamefiles: Rename dir/file names to time when closed
-s, --size: maximum file size in MB
-t, --configure peripheral tx mode: 0 - Streaming Mode 1- Threshold Mode 2- Circualr Buffering Mode
-u, --qmdl2_v2: Guid-diagid mapping in qmdl2 header
--sync: send multicast log every x seconds
-w, --wait: waiting for directory
-x, --peripheral id: bit mask for the peripherals interested
-b --optimized: Optimized to conserve battery
e.g. diag_mdlog -f <mask_file name> -o <output dir> -s <size in bytes> -c
- デフォルトの引数を使用したい場合は、
/data/vendor/diag_mdlog/user3.optsを削除します。 -
/data/vendor/diag_mdlog/user3.opts→/vendor/etc/diag_mdlog/default.optsの順に参照されるようです。
3. 記録を開始する
diag_mdlogを直接実行することもできるのですが、パーミッションやソケットの作成で失敗しやすいので、initサービス経由で実行します。
propertyを特定します。
penang:/ # getprop | grep diag
...
[init.svc.vendor.diag_mdlog]: [stopped]
...
[persist.vendor.sys.diag_mdlog.on]: [0]
...
記録を開始します。
penang:/ # setprop persist.vendor.sys.diag_mdlog.on 1
penang:/ # getprop init.svc.vendor.diag_mdlog
running
問題がなければ、/data/vendor/diag_mdlog/logs/にQMDLファイルが生成されます。
penang:/ # ls -lh /data/vendor/diag_mdlog/logs/
total 10M
-rw-r----- 1 shell shell 0 2026-10-24 14:07 ***.qdb
-rw-r----- 1 log log 10M 2026-10-24 14:11 diag_log_20261024_1410531792818653347.qmdl2
SELinuxのトラブルシューティング
うまく行かない場合は、SELinuxを一時的にPermissiveモードにしてから、もう一度setprop ...を実行してみてください。
penang:/ # setenforce 0
penang:/ # getenforce
Permissive
記録を停止します。
penang:/ # setprop persist.vendor.sys.diag_mdlog.on 0
penang:/ # getprop init.svc.vendor.diag_mdlog
stopped
4. 任意のツールで分析する
取得したQMDLファイルを手元のマシンに移動し(adb pull等)、QXDMやSCATなどのツールでポストプロセスします。
SCATの例:
hoge@debian:~$ scat -t qc -d ./diag_log_20261024_1410531792818653347.qmdl2 --pcap-file ./diag.pcap