OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
network medium common DISPUTE

Switch a Realtek USB Wi-Fi dongle out of CD-ROM mode

omarchyarchendeavouroscachyosmanjarorealtekusbdesktop
CORRECTED An auditor found the fix wrong or incomplete and rewrote it. · checked against Omarchy omarchy 4.0.4-1 on 2026-10-05
AUDIT NOTE

The fix holds. I extracted the current usb_modeswitch package (2.6.2.20251207): /usr/lib/udev/rules.d/40-usb_modeswitch.rules matches 0bda:1a2b and /usr/share/usb_modeswitch/0bda:1a2b uses StandardEject, which -K performs, so the manual command is right. usb_modeswitch is not in quattro install/omarchy-base.packages and not installed here. BBS 312196 (Ugreen AX900, 0bda:1a2b switching to 0bda:b851, RTL8851BU, solved by usb_modeswitch plus a different USB port) supports the fix. The symptom was wrong. The kernel's drivers/usb/storage/unusual_devs.h carries US_FL_IGNORE_DEVICE for 0bda:1a2b "otherwise usb_modeswitch may fail to switch", and the thread's dmesg shows usb-storage ... device ignored with nothing in Dolphin, so no Driver CD drive appears in the file manager. The brand and chip list (TP-Link, Edimax, RTL8811CU) is in none of the sources, and the thread's own answer is that the lsusb name is misleading because many Realtek adapters share the ID. Symptom and cause rewritten. linux-hardware.org did not load from here, so it was left in place unverified.

The cause above was rewritten on 2026-10-05 to match this note; the fix was corrected by the audit itself.

Symptom

A new USB Wi-Fi adapter (the cited case is a Ugreen AX900) does nothing when plugged in. No new interface appears in ip link or nmcli device, and no drive appears in the file manager either. lsusb shows it as:


ID 0bda:1a2b Realtek Semiconductor Corp. RTL8188GU 802.11n WLAN Adapter (Driver CDROM Mode)

and sudo dmesg shows idVendor=0bda, idProduct=1a2b followed by usb-storage ... device ignored. The RTL8188GU name is misleading: many different Realtek adapters use this same ID in their CD-ROM mode.

Cause

These dongles enumerate first as a virtual CD-ROM carrying Windows drivers, under the shared ID 0bda:1a2b. They only reappear as a network device with their real USB ID (for example 0bda:b851 for the RTL8851BU in the Ugreen AX900) after a mode-switch command. The kernel deliberately ignores this ID in usb-storage so that the switch can happen, which is why no drive shows up. The switch itself comes from usb_modeswitch, whose udev rule 40-usb_modeswitch.rules matches 0bda:1a2b and ejects it. Omarchy 4 does not install usb_modeswitch, and a minimal Arch install does not either.

Fix

Install the mode switcher, which ships the udev rule that switches the stick on insertion:


sudo pacman -S --needed usb_modeswitch

Unplug and re-plug the dongle, then check its ID has changed:


lsusb | grep -i 0bda
ip link
nmcli device

To switch it by hand without re-plugging:


sudo usb_modeswitch -KW -v 0bda -p 1a2b

If the stick switches but then freezes or drops, try another USB port before chasing drivers. In the cited thread, the port was the remaining cause.

Verify

lsusb no longer shows 0bda:1a2b but the adapter's Wi-Fi ID. nmcli device lists a new wifi device. nmcli device wifi list ifname <new iface> shows networks.

Sources

usb-wifi-dongle-stuck-in-cdrom-mode