GPS Modem Troubleshooting Report

The modem was in a valid QMI-capable USB composition, but the Linux serial driver option claimed USB interface 1-6:1.8. That interface needed to be claimed by qmi_wwan so that cdc_wdm could create /dev/cdc-wdm0.

When option owned interface 8, the system still had serial-style modem behavior, but it lacked the QMI control device.

The correct binding is:

If 0 -> option
If 2 -> option
If 3 -> option
If 8 -> qmi_wwan

The incorrect binding was:

If 0 -> option
If 2 -> option
If 3 -> option
If 8 -> option

A legacy configuration file existed:

/etc/modprobe.d/sierra-em7305.conf:options option vendor=0x1199 product=0x9041

This produced kernel messages such as:

option: unknown parameter 'vendor' ignored
option: unknown parameter 'product' ignored

Those parameters are not valid for the option driver on this system. The file was at minimum noisy and misleading, and it was part of the configuration path that caused confusion around option binding.

The file was disabled by renaming it:

sudo mv /etc/modprobe.d/sierra-em7305.conf /etc/modprobe.d/sierra-em7305.conf.disabled

The qmi_wwan module did know about this modem/interface:

alias: usb:v1199p9041d*dc*dsc*dp*ic*isc*ip*in0A*
alias: usb:v1199p9041d*dc*dsc*dp*ic*isc*ip*in08*

However, after disabling the bad options option vendor/product configuration, the serial interfaces did not bind automatically. Adding the USB ID dynamically to the option1 usb-serial driver restored the serial ports:

echo 1199 9041 | sudo tee /sys/bus/usb-serial/drivers/option1/new_id

This allowed option to claim interfaces 0, 2, and 3 while leaving interface 8 with qmi_wwan.

1. Why did GPS/QMI commands fail?

   Because /dev/cdc-wdm0 was missing, so qmicli could not open the modem control device.

2. Why was /dev/cdc-wdm0 missing?

   Because qmi_wwan did not bind to the modem's QMI interface, so cdc_wdm did not create the WDM character device.

3. Why did qmi_wwan not bind?

   Because USB interface 1-6:1.8, which should have been handled by qmi_wwan, was already claimed by the option serial driver.

4. Why did option claim the QMI interface?

   The system had legacy/custom Sierra modem configuration involving the option driver, including an invalid /etc/modprobe.d/sierra-em7305.conf file. The serial driver was loading/binding too broadly or too early relative to qmi_wwan.

5. Why was this not caught earlier?

   The modem still partially worked as a serial USB device, so the failure appeared as a GPS/QMI problem rather than a USB driver binding problem. The absence of /dev/cdc-wdm0 was the visible symptom, but the underlying issue was only clear after inspecting lsusb -t and seeing interface 8 bound to the wrong driver.

The bad state was identified with:

lsusb -t

Bad state:

If 8, Driver=option

Good state:

If 8, Driver=qmi_wwan

The option driver was temporarily blocked to allow qmi_wwan to claim interface 8 first:

sudo tee /etc/modprobe.d/disable-option-temporarily.conf >/dev/null <<'EOF'
blacklist option
install option /bin/false
EOF

The modem was then rebound and the QMI modules were loaded:

sudo sh -c 'echo 1-6 > /sys/bus/usb/drivers/usb/unbind'
sudo rmmod option 2>/dev/null || true
sudo rmmod usb_wwan 2>/dev/null || true
sudo modprobe cdc_wdm
sudo modprobe qmi_wwan
sudo sh -c 'echo 1-6 > /sys/bus/usb/drivers/usb/bind'

This restored /dev/cdc-wdm0.

Successful dmesg evidence:

qmi_wwan 1-6:1.8: cdc-wdm0: USB WDM device
qmi_wwan 1-6:1.8 wwan0: register 'qmi_wwan' at usb-0000:00:14.0-6, WWAN/QMI device
qmi_wwan 1-6:1.8 wwp0s20u6i8: renamed from wwan0

After /dev/cdc-wdm0 returned, qmicli confirmed the modem model:

sudo qmicli -p -d /dev/cdc-wdm0 --dms-get-model

Output:

[/dev/cdc-wdm0] Device model retrieved:
        Model: 'EM7355'

The USB composition was confirmed:

sudo qmicli -p -d /dev/cdc-wdm0 --dms-swi-get-usb-composition

Output:

[/dev/cdc-wdm0] Successfully retrieved USB compositions:
            USB composition 1: HIP, DM, NMEA, AT, MDM1, MS
        [*] USB composition 6: DM, NMEA, AT, QMI
            USB composition 7: DM, NMEA, AT, RMNET1, RMNET2, RMNET3
            USB composition 8: DM, NMEA, AT, MBIM
            USB composition 9: MBIM
            USB composition 10: NMEA, MBIM
            USB composition 11: DM, MBIM
            USB composition 12: DM, NMEA, MBIM
            USB composition 14: Dual configuration: USB composition 6 and USB composition 9
            USB composition 19: Dual configuration: USB composition 7 and USB composition 9

No USB composition change was needed. Composition 6 was correct for QMI + AT/NMEA usage.

After qmi_wwan owned interface 8, the serial ID was added dynamically to the option1 usb-serial driver:

echo 1199 9041 | sudo tee /sys/bus/usb-serial/drivers/option1/new_id

This restored the serial ports while keeping QMI intact.

Working state before reboot:

|__ Port 006: Dev 005, If 0, Class=Vendor Specific Class, Driver=option, 480M
|__ Port 006: Dev 005, If 2, Class=Vendor Specific Class, Driver=option, 480M
|__ Port 006: Dev 005, If 3, Class=Vendor Specific Class, Driver=option, 480M
|__ Port 006: Dev 005, If 8, Class=Vendor Specific Class, Driver=qmi_wwan, 480M

Devices restored:

/dev/ttyUSB0
/dev/ttyUSB1
/dev/ttyUSB2
/dev/cdc-wdm0

The bad legacy file was disabled:

sudo mv /etc/modprobe.d/sierra-em7305.conf /etc/modprobe.d/sierra-em7305.conf.disabled 2>/dev/null || true

A QMI-first soft dependency was created:

sudo tee /etc/modprobe.d/em7355-qmi-first.conf >/dev/null <<'EOF'
softdep option pre: qmi_wwan cdc_wdm
EOF

A udev rule was created to add the modem USB ID to the option1 usb-serial driver:

sudo tee /etc/udev/rules.d/99-em7355-option-serial.rules >/dev/null <<'EOF'
ACTION=="add", SUBSYSTEM=="usb", ATTR{idVendor}=="1199", ATTR{idProduct}=="9041", RUN+="/bin/sh -c 'modprobe option; echo 1199 9041 > /sys/bus/usb-serial/drivers/option1/new_id 2>/dev/null || true'"
EOF

Rules/initramfs were refreshed:

sudo udevadm control --reload-rules
sudo update-initramfs -u 2>/dev/null || true

After reboot, the system showed the desired layout:

|__ Port 006: Dev 004, If 0, Class=Vendor Specific Class, Driver=option, 480M
|__ Port 006: Dev 004, If 2, Class=Vendor Specific Class, Driver=option, 480M
|__ Port 006: Dev 004, If 3, Class=Vendor Specific Class, Driver=option, 480M
|__ Port 006: Dev 004, If 8, Class=Vendor Specific Class, Driver=qmi_wwan, 480M

Device nodes existed:

crw------- 1 root root    180, 0 Jun 28 00:16 /dev/cdc-wdm0
crw-rw---- 1 root dialout 188, 0 Jun 28 00:16 /dev/ttyUSB0
crw-rw---- 1 root dialout 188, 1 Jun 28 00:16 /dev/ttyUSB1
crw-rw---- 1 root dialout 188, 2 Jun 28 00:16 /dev/ttyUSB2

qmicli validation succeeded:

sudo qmicli -p -d /dev/cdc-wdm0 --dms-get-model

Output:

[/dev/cdc-wdm0] Device model retrieved:
        Model: 'EM7355'

If 0 -> option
If 2 -> option
If 3 -> option
If 8 -> qmi_wwan

/dev/cdc-wdm0
/dev/ttyUSB0
/dev/ttyUSB1
/dev/ttyUSB2

USB composition 6: DM, NMEA, AT, QMI

Because the active composition is QMI, use plain QMI commands:

sudo qmicli -p -d /dev/cdc-wdm0 --dms-get-model
sudo qmicli -p -d /dev/cdc-wdm0 --dms-swi-get-usb-composition

Do not use --device-open-mbim unless the modem is intentionally switched to an MBIM composition such as composition 8, 9, 10, 11, 12, 14, or 19.

• [X] Confirmed modem was detected on USB as 1199:9041.
• [X] Confirmed qmi_wwan supports 1199:9041 interface 8 and 10.
• [X] Identified incorrect driver binding: interface 8 bound to option.
• [X] Temporarily blocked option to allow qmi_wwan to claim interface 8.
• [X] Restored /dev/cdc-wdm0.
• [X] Confirmed modem model as EM7355.
• [X] Confirmed active USB composition 6: DM, NMEA, AT, QMI.
• [X] Disabled invalid legacy modprobe configuration.
• [X] Restored serial ports using option1/new_id.
• [X] Added persistent QMI-first rule and udev serial binding rule.
• [X] Rebooted and confirmed working state.

• [ ]

  Save a backup copy of these files:

  sudo cp /etc/modprobe.d/em7355-qmi-first.conf ~/em7355-qmi-first.conf.backup
  sudo cp /etc/udev/rules.d/99-em7355-option-serial.rules ~/99-em7355-option-serial.rules.backup
  

• [ ]

  After future kernel or OS updates, verify the driver layout:

  lsusb -t
  ls -l /dev/cdc-wdm*
  ls -l /dev/ttyUSB*
  sudo qmicli -p -d /dev/cdc-wdm0 --dms-get-model
  

• [ ] If GPS scripts depend on fixed ttyUSB numbers, consider adding udev symlinks for stable names such as /dev/gps-nmea and /dev/modem-at.
• [ ] Update any scripts that use --device-open-mbim unless the modem is deliberately switched to MBIM. Current composition 6 should use plain QMI.
• [ ] Keep sierra-em7305.conf.disabled for reference temporarily, then delete it after several successful reboots/updates.

If 8, Driver=qmi_wwan
/dev/cdc-wdm0 exists
/dev/ttyUSB0-2 exist

If 8, Driver=option
/dev/cdc-wdm0 missing

Use this only if /dev/cdc-wdm0 disappears again because interface 8 is stolen by option.

# Temporarily stop option from holding the QMI interface.
sudo sh -c 'echo 1-6:1.8 > /sys/bus/usb/drivers/option/unbind' 2>/dev/null || true

# Ensure QMI support is loaded.
sudo modprobe cdc_wdm
sudo modprobe qmi_wwan

# Bind interface 8 to qmi_wwan.
sudo sh -c 'echo 1-6:1.8 > /sys/bus/usb/drivers/qmi_wwan/bind'

# Restore serial interfaces if needed.
sudo modprobe option
echo 1199 9041 | sudo tee /sys/bus/usb-serial/drivers/option1/new_id

/etc/modprobe.d/em7355-qmi-first.conf:

softdep option pre: qmi_wwan cdc_wdm

/etc/udev/rules.d/99-em7355-option-serial.rules:

ACTION=="add", SUBSYSTEM=="usb", ATTR{idVendor}=="1199", ATTR{idProduct}=="9041", RUN+="/bin/sh -c 'modprobe option; echo 1199 9041 > /sys/bus/usb-serial/drivers/option1/new_id 2>/dev/null || true'"