dissector

Wireshark QMI Dissector

Analyze QMI packets of iPhone basebands in Wireshark.

Installation

1. Clone libqmi repository

git clone https://gitlab.freedesktop.org/mobile-broadband/libqmi.git

2. Generate the dissector with

# If you're using Python < 3.4, please install pathlib using `pip3 install pathlib`
python3 generate_lua.py

3. Copy the generated dissector build/qmi_dissector_gen.lua to the Wireshark plugin directory

• Unix-like systems: cp build/qmi_dissector_gen.lua ~/.local/lib/wireshark/plugins/
• Windows systems: cp build\qmi_dissector_gen.lua %APPDATA%\Wireshark\plugins

4. Configure the DLT_USER protocol: Open the Wireshark preferences -> Protocols -> DLT_USER -> Edit encapsulation table

Research

You can discover new QMI message identifiers using the tools in the research directory.

Development

To get familiar with the development of Lua Wireshark dissectors, I recommend the following resources:

• Mika's Wireshark Guide
  • Part 1
  • Part 2
  • Part 3
  • Part 4
• Wireshark Documentation
  • 9.2. Adding a basic dissector
  • 11. Wireshark’s Lua API Reference Manual
  • 11.3. Functions For New Protocols And Dissectors
  • 11.5. Obtaining Packet Information
  • 11.20. User DLTs protocol table

Contributors

Wireshark Dissector for Qualcomm MSM Interface (QMI) Protocol v0.3

Optimized for analyzing QMI packets captured from iPhones.

Copyright (c) 2022 Lukas Arnold [email protected]

Wireshark Dissector for Qualcomm MSM Interface (QMI) Protocol v0.2

Hosted on https://github.com/dnlplm/WiresharkQMIDissector

Copyright (c) 2017 Daniele Palmas [email protected]

Based on:

• Wireshark Dissector for Qualcomm MSM Interface (QMI) Protocol v0.1 Copyright (c) 2012 Ilya Voronin [email protected] https://gist.github.com/ivoronin/2641557

• Code Aurora Forum's BSD/GPL licensed code: http://www.codeaurora.org/contribute/projects/gobi/

• freedesktop.org libqmi https://www.freedesktop.org/wiki/Software/libqmi/