drivers/aic8800d80
1
0 Fork 0
mirror of https://github.com/shenmintao/aic8800d80.git synced 2026-11-10 16:49:17 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
67e2b6ad4a6620d43197826653ec4366b51bed86
aic8800d80/INSTALL_SCRIPT.md
T
Shen Mintao 67e2b6ad4a docs: complete Arch prerequisites and scope device setup notes 
Document matching kernel headers, pacman dependencies, repository checkout, mode-switch destination creation and MCU1 branch selection. Distinguish missing DKMS builds from stale module indexes and firmware-loader IDs from working interfaces. Correct the installer support claim and explain the NetworkManager connectivity penalty with its upstream reference.

Keeps the contributor-reported Lukton DQ-211 results scoped to that unit. Validation: all Bash examples parse, local links resolve, and commands were checked against the repository installer, Makefile, AUR packaging and upstream documentation. Follow-up corrections for #109; no Arch hardware test is claimed.

(cherry picked from commit 1b071be3e1)
2026-10-19 11:39:36 +08:00

1.8 KiB
Raw Blame History

Automated Installation Script

Overview

This automated installation script (install.sh) installs the AIC8800 Wi-Fi driver and firmware loader on Linux systems. Wi-Fi/Bluetooth combo adapters use the standard kernel btusb driver after firmware initialization. For USB device 368b:8d81, it also installs a device-scoped ACL bulk TX ZLP companion module without replacing the distribution's btusb.ko.

  • Automatic Secure Boot detection
  • Automatic dependency installation
  • Automatic driver compilation and installation
  • Automatic module loading on boot
  • Automatic cleanup of obsolete aic_btusb configuration
  • Automatic aic_zlp_quirk handling for the validated 368b:8d81 device
  • Wi-Fi-only and Wi-Fi/Bluetooth combo adapter support from the same branch
  • Comprehensive error handling
  • Colored output and logging
  • Compatible with Ubuntu, Debian, Fedora, Arch Linux, and derivatives (DKMS supported dkms.conf)

Usage

# Clone the repository and download the script, make the script executable
git clone https://github.com/shenmintao/aic8800d80.git && cd aic8800d80 && chmod +x install.sh

# Run the installation
sudo ./install.sh

On Arch Linux and derivatives, the installer uses the existing pacman package database. It does not refresh that database or upgrade the system. If pacman cannot download dependencies because the database is stale, run sudo pacman -Syu yourself, reboot if the kernel was updated, and rerun the installer with headers matching the running kernel.

For more information, please refer to the README.md file.



Diagnostic Build Script (Optional)

This script is used to diagnose build issues with the AIC8800D80 driver. Useful for identifying the root cause of the build failure.

# Make the script executable and run it
chmod +x diagnostic_build.sh && sudo ./diagnostic_build.sh
Reference in new issue View Git Blame Copy Permalink