Skip to content

README.md

Latest commit

 

History

History
65 lines (48 loc) · 2.02 KB

README.md

File metadata and controls

65 lines (48 loc) · 2.02 KB

Quectel Linux USB Driver

Out-of-tree and in-kernel-patch drivers for Quectel cellular modems, organized by Linux kernel LTS version.

Quick Start

# 1. Find your kernel version
uname -r    # e.g. 5.15.0-100-generic

# 2. Checkout the matching branch
git clone https://github.com/bacnh85/Quectel_Linux_USB_Driver.git
cd Quectel_Linux_USB_Driver
git checkout v5.15    # use your major.minor version

# 3. Follow the README.md on that branch

Branches

Branch Kernel Quectel Devices Patch Size
v5.4 5.4.x LTS +30 products 59 lines
v5.15 5.15.x LTS +25 products 54 lines
v6.1 6.1.x LTS +21 products 44 lines
v6.6 6.6.x LTS +7 products 16 lines
v6.12 6.12.x Full mainline No patch needed

What's in Each Branch

All driver sources are upstream Linux kernel code enhanced with Quectel device IDs backported from kernel 6.12.

drivers/usb/serial/option.c     ← enhanced with all Quectel USB serial IDs
drivers/usb/serial/usb_wwan.c   ← upstream (no Quectel-specific changes)
drivers/usb/serial/usb-wwan.h   ← upstream header
drivers/net/usb/qmi_wwan.c      ← enhanced with all Quectel QMI IDs
patches/option.c.patch           ← diff: vanilla → enhanced (for in-kernel)
patches/qmi_wwan.c.patch         ← diff: vanilla → enhanced (for in-kernel)
Makefile                         ← out-of-tree module build

Two Build Methods

Method 1: Out-of-Tree (Recommended)

make && sudo make install
sudo modprobe option qmi_wwan

Method 2: In-Kernel Patch

cd /path/to/kernel-source
patch -p1 < /path/to/Quectel_Linux_USB_Driver/patches/option.c.patch

Supported Quectel Modules

2G/3G: UC15, UC20 4G LTE: EC20, EC21, EC25, EG91, EG95, BG96, BG95, AG35, EP06, EM12, EC200S, EC200T, EC200A, EC200U, EG912Y, EG916Q 5G NR: RM500Q, RM520N, RM500K, RM500U, RG650V, EM05G series, EM060K/EM061K series, EM160R-GL

License

GPL-2.0-only — same as the Linux kernel