Add usb-modeswitch config for RTL8188GU CDROM mode bypass

RTL8188GU WiFi adapter (0bda:1a2b) ships in CDROM mode on initial connection.
Install usb-modeswitch package and config to automatically switch to network
mode on boot.

Required for 2.4GHz AP to function when using D-Link DWA-171 or similar
RTL8188GU-based adapters.
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
This commit is contained in:
2026-09-19 10:06:16 -04:00
parent f564886a4a
commit f5b29630ae
2 changed files with 12 additions and 0 deletions
+10
View File
@@ -0,0 +1,10 @@
# usb-modeswitch config for Realtek RTL8188GU USB WiFi adapter
# Device appears as CDROM (mass storage) on initial connection; this switches it to network mode
# Vendor and product ID
TargetVendor=0x0bda
TargetProduct=0x1a2b
# Switch command: reset EEPROM to normal mode
StandardEject=1
MessageContent="525243580a00000000000000000000000000000000"
+2
View File
@@ -57,6 +57,7 @@ REQUIRED_PACKAGES=(
python3-gps python3-gps
python3-bleak python3-bleak
modemmanager modemmanager
usb-modeswitch
) )
OPTIONAL_PACKAGES=( OPTIONAL_PACKAGES=(
rsync rsync
@@ -144,6 +145,7 @@ install -D -m0644 ap/nftables.conf /etc/nftables.conf
install -D -m0644 ap/regdomain.service /etc/systemd/system/regdomain.service install -D -m0644 ap/regdomain.service /etc/systemd/system/regdomain.service
install -D -m0644 ap/van-br0-setup.service /etc/systemd/system/van-br0-setup.service install -D -m0644 ap/van-br0-setup.service /etc/systemd/system/van-br0-setup.service
install -D -m0644 ap/80-regdomain.rules /etc/udev/rules.d/80-regdomain.rules install -D -m0644 ap/80-regdomain.rules /etc/udev/rules.d/80-regdomain.rules
install -D -m0644 ap/rtl8188gu-modeswitch.conf /etc/usb-modeswitch.d/0bda:1a2b
install -D -m0644 ap/rtw89.conf /etc/modprobe.d/rtw89.conf install -D -m0644 ap/rtw89.conf /etc/modprobe.d/rtw89.conf
install -D -m0644 ap/99-van-router.conf /etc/sysctl.d/99-van-router.conf install -D -m0644 ap/99-van-router.conf /etc/sysctl.d/99-van-router.conf