mirror of
https://github.com/shenmintao/aic8800d80.git
synced 2026-09-26 17:44:16 +00:00
Unified Wi-Fi, Bluetooth, and ZLP branch test
This branch tests replacing the separate main and bluetooth branches with
one driver and installer. The Wi-Fi driver and firmware were already identical
on both branches. This test unifies their installer, migration, diagnostics,
packaging, and documentation, and adds the device-scoped ZLP fix from issue
#63 as a third DKMS module.
The expected architecture is:
aic_load_fwinitializes every supported adapter and uploads firmware.aic8800_fdrvhandles Wi-Fi.- A combo adapter exposes a Bluetooth HCI USB interface after initialization;
the standard Linux
btusbdriver binds through normal USB device matching. - A Wi-Fi-only adapter exposes no HCI interface and does not need
btusb. - The retired custom
aic_btusbmodule is never installed or used. - USB device
368b:8d81autoloadsaic_zlp_quirk, which addsURB_ZERO_PACKETonly to its Bluetooth ACL bulk OUT transfers. - The distribution's original
btusb.kois never replaced.
The installer deliberately does not force-load btusb and does not globally
unblock Bluetooth through rfkill.
Install
git fetch origin
git switch test/unified-wifi-bt-zlp
git pull --ff-only
sudo ./install.sh
sudo reboot
Test a Wi-Fi-only adapter
Confirm that:
- The Wi-Fi interface is created.
- Scanning, association, DHCP, and real traffic work.
- No
aic_btusbmodule is loaded. - The absence of
btusbor an HCI controller is treated as normal.
Test a Wi-Fi/Bluetooth combo adapter
Confirm that:
- Wi-Fi scanning, association, DHCP, and real traffic work.
aic_load_fwuploads the firmware before the HCI interface is used.- The Bluetooth USB interface is bound to the standard
btusbdriver. bluetoothctlcan power on, scan, pair, and exchange real traffic.- No
aic_btusbmodule, alias, soft dependency, or udev binding rule remains.
Test the 368b:8d81 ZLP path
In addition to the combo-adapter checks, confirm that:
aic_zlp_quirkloads automatically and systembtusbowns interfaces 0/1.hookreportsbtusb:alloc_bulk_urborusb_submit_urb.- The
injectionscounter increases during Bluetooth audio traffic. - AAC playback remains connected for at least one hour.
- Wi-Fi scan, association, and traffic remain unaffected during the test.
Collect results
git rev-parse --short HEAD
lsusb
lsusb -t
lsmod | grep -E 'aic|btusb|bluetooth'
iw dev
bluetoothctl list
cat /sys/module/aic_zlp_quirk/parameters/{hook,injections} 2>/dev/null || true
sudo ./diagnose_bt.sh | tee unified-wifi-bt-diagnostic.log
sudo journalctl -k -b --no-pager | tee unified-wifi-bt-kernel.log
Please attach both logs and identify whether the tested adapter is Wi-Fi-only or a combo device.
Roll back during testing
git switch main
git pull --ff-only
sudo ./install.sh
sudo reboot