Use the shared ERROR-only defaults for Wi-Fi and the loader. Keep one diagnostic section covering INFO summaries, DEBUG patch entries and packet dumps, runtime masks, startup options, and restoration to the default.
The integrated source builds all three modules against Linux 6.17 headers.
From review (shenmintao/aic8800d80#115): the default log keeps enough to read a first bug report.
- The patch table: each entry at LOGDEBUG, as before this series' first change; one line at LOGINFO (the default)
with the file and the number of entries written; a failure at LOGERROR, as before.
- 4-address frames dropped by a build without CONFIG_SUPPORT_4ADDR: counted per device and said at LOGINFO, the
first at once and then at most once a minute; each frame and its dump at LOGDEBUG, by aicwf_dbg_level, in place
of dev_dbg() and print_hex_dump_debug(), which need dynamic debug or DEBUG and were compiled out otherwise.
- The README says how to turn the detail on and off, at run time and before the driver loads (the patch table is
written when the adapter starts).
Link issue #110 and keep the report scoped to the tested device, matched legacy driver/firmware, standard btusb and reported reboot/reconnection checks.
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.
Add INSTALL_ARCH.md covering installation on Arch-based distributions,
validated on a Lukton DQ-211 (AIC8800D80, Pandora 88M80 clone) under
CachyOS with kernels 7.2.0-1-cachyos and 6.18.42-1-cachyos-lts.
The notes cover the AUR/DKMS path, the manual build path, and two gotchas
that are not documented for these distros:
- the AUR package ships aic.rules but not /etc/usb_modeswitch.d/1111:1111,
so the mode switch silently does nothing without it;
- the DKMS modules live under updates/dkms/ and need depmod -a before
modprobe aic8800_fdrv can find them.
Also document that aic_load_fw already carries the usb:vA69Cp8D80d* alias,
so no modules-load.d entry is required, plus NetworkManager route-metric
notes for preferring the dongle over the onboard radio.
README: link the new notes from the Installation Steps section.
Co-authored-by: CommandCodeBot <noreply@commandcode.ai>
Copy src/LICENSE verbatim from radxa-pkg/aic8800 commit
969601fd69b5c33f965558c9e90633067733e8c1 and document its provenance.
Upstream copyright metadata assigns GPL-2 to driver sources and the
same license to driver patches; GPL-3+ applies to Radxa packaging.
Refs #101.
Validation: byte-for-byte upstream license comparison and git diff --check.
27af5ad added the CFG80211_VERSION make variable for OpenWrt builds that
use a newer mac80211 backport than the target kernel, but it is only
described in a Makefile comment. Document how to pass it from an OpenWrt
package Makefile, link the notes from the installation steps, and add
the build script and the kernel/backports combinations verified for
issue #94.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Shen Mintao