はじめに

Orange Pi PC Plusを、Wake on LANや遠隔管理用の常時稼働ノードにしようと思いました。

そこでUSB Wi-Fiを追加するために買ったのが、

TP-Link Archer TX1U Nano/A

です。

Amazon上では「Wi-Fi 6 / 287Mbps / Bluetoothなし」の小型USB無線LAN子機。

普通なら、

USBに挿す
↓
Wi-Fiが出る
↓
終わり

だと思うじゃないですか。

終わりませんでした。

今回の実機では、Linuxから見ると中身がAICSemi系で、最終的に AIC8800DC として扱う必要がありました。

しかも途中で、

pid:0x3625 vid:0x0110 unsupport

からの

Unable to handle kernel NULL pointer dereference

まで踏みました。

同じUSB子機やAIC8800系で詰まった人向けに、実際に何が起きたかを残しておきます。

この記事は2026年9月8日に実際に作業したログを元にしています。
Armbianやドライバ側は更新されるため、将来そのまま通る保証はありません。

環境

項目	内容
SBC	Orange Pi PC Plus
OS	Armbian
SoC系統	Allwinner sun8i
最終Kernel	`6.18.49-current-sunxi`
USB Wi-Fi	TP-Link Archer TX1U Nano/A
商品仕様	Wi-Fi 6 / 287Mbps / Bluetoothなし
Linux上のチップ	AICSemi AIC8800DC

最初の `lsusb`

まずUSB子機を挿して、

lsusb

を確認しました。

最初に出てきたのは、Wi-Fiデバイスっぽいものではなく、

a69c:5721 AICSemi AIC MSC

でした。

MSC？

MSC は Mass Storage Class 系のモードです。

つまりこの時点では、

「USB Wi-Fi子機を挿したのに、まだWi-Fi側のUSBデバイスとして立ち上がっていない」

状態でした。

ここでかなり時間を使いました。

`usb_modeswitch` で切り替える

usb-modeswitch を入れます。

sudo apt update
sudo apt install -y usb-modeswitch

そして、

sudo usb_modeswitch -K -v a69c -p 5721

を実行。

再び、

lsusb

すると、

3625:0110 AICSemi AIC8800DC

へ変わりました。

これでようやく、

AIC8800DC用のドライバを探す

という正しいスタートラインに立てました。

ここでの教訓

製品名が

TP-Link Archer TX1U Nano

だからといって、Linuxでその文字列だけを検索するのでは足りないことがあります。

今回かなり役立ったのは、

a69c:5721
3625:0110
AICSemi
AIC8800DC

という実際のUSB IDとチップ名でした。

次の罠: Kernelとheadersが違う

外部ドライバをビルドしようとしたところ、別の問題がありました。

途中の環境では、

実行中:
6.12.63-current-sunxi

に対して、

headers:
6.18.49-current-sunxi

という状態になっていました。

これはまずい。

確認には、

uname -r
ls -l /lib/modules/$(uname -r)/build
dpkg -l | grep linux-headers

を使いました。

最終的には再起動して、

6.18.49-current-sunxi

へ統一。

外部moduleをビルドするときは、最初にここを見た方がいいです。

ドライバを入れれば終わり……ではなかった

AIC8800系Linux Driverをいくつか試しました。

途中では ronnyf/AIC8800-Linux-Driver 系も試しています。

USB ID 3625:0110 を認識させるため、USB device tableに、

{USB_DEVICE_AND_INTERFACE_INFO(0x3625, 0x0110, 0xff, 0xff, 0xff)},

を追加してビルドする方法も試しました。

module自体はロードされ、

lsmod | grep aic

で、

aic8800_fdrv
cfg80211
aic_load_fw

まで見えるようになりました。

一見すると良さそうです。

しかし lsusb -t を見ると正常にbindされていない。

そして dmesg には、

AICWFDBG(LOGERROR) aicwf_usb_probe pid:0x3625 vid:0x0110 unsupport

が出ていました。

そしてKernel Oops

さらにその直後、

Unable to handle kernel NULL pointer dereference at virtual address 00000000
Internal error: Oops: 5 [#1] SMP THUMB2

まで発生。

ログ上では、

aicwf_usb_free_urb
aicwf_usb_deinit
aicwf_usb_probe

周辺がスタックに出ていました。

この時点で、

USB IDを追加してprobeに入ればOK

ではないことが分かります。

AIC8800系には複数の派生があり、PID・chip mapping・firmwareの組み合わせが合っている必要があるようです。

少なくとも今回の個体では、PIDだけ通す方法では正常動作しませんでした。

一歩進んだ: AIC8800DCとして認識

別のドライバ構成では、かなり先まで進みました。

dmesg に、

Product: AIC8800DC
AICWFDBG(LOGINFO) aicwf_usb_chipmatch USE AIC8800DC
AICWFDBG(LOGINFO) aicwf_parse_usb endpoints = 4
AICWFDBG(LOGINFO) Aic high speed USB device detected

が出現。

さらに、

chip_id=7, chip_sub_id=1

まで読めています。

firmwareも、

/lib/firmware/aic8800DC/fmacfw_patch_8800dc_u02.bin
/lib/firmware/aic8800DC/fmacfw_patch_tbl_8800dc_u02.bin
/lib/firmware/aic8800DC/fmacfw_calib_8800dc_u02.bin

からロードされました。

「来た！」と思ったんですが……

`start app fail: -110`

次はこれ。

Start app: 00130009, 4
start app fail: -110
dpd calib fail: -110
err_lmac_reqs
aicwf_rwnx_usb_platform_init err -1

最終的にはprobe失敗。

ここで分かったのは、

USB認識
↓
chip判定
↓
firmwareファイル読込

まで成功しても、

まだWi-Fiが使えるとは限らない

ということです。

ドライバ沼、深い。

最終的に使った `aic8800d80`

最終盤では、

~/aic8800d80/drivers/aic8800

で作業しました。

cd ~/aic8800d80/drivers/aic8800
make

ビルド中、

Skipping BTF generation ... due to unavailability of vmlinux

という表示も出ましたが、今回の環境ではmoduleのビルド自体は完了しました。

続いて、

sudo make install
sudo depmod -a

を実行。

make install により、現在のKernel

6.18.49-current-sunxi

向けのmoduleとして、

aic_load_fw.ko
aic8800_fdrv.ko

などが /lib/modules/.../ 以下へ配置されました。

moduleを確認

lsmod | grep aic

確認できたのは、

aic8800_fdrv
cfg80211
aic_load_fw

です。

必要なら手動で、

sudo modprobe aic_load_fw
sudo modprobe aic8800_fdrv

します。

ただし自動でロードされている場合は不要です。

`lsmod` だけで安心しない

今回かなり大事だったのがこれ。

lsusb
lsusb -t

です。

lsmod にドライバ名があっても、

そのUSBデバイスへ実際にbindされているとは限りません。

あわせて、

iw dev
ip link
rfkill list
nmcli device status

まで確認した方がいいです。

Wi-Fiへ接続する

最終的なSSID入力操作そのものは保存していた端末ログに残っていなかったため、ここだけ再現用の標準手順です。

nmtui

sudo nmtui

Activate a connection からSSIDを選択。

または nmcli なら、

sudo nmcli device wifi connect "<SSID>" password "<PASSWORD>"

確認:

nmcli device status
ip addr
ip route

疎通:

ping -c 3 1.1.1.1
ping -c 3 google.com

そして再起動後も、

sudo reboot

からの、

lsusb
lsusb -t
lsmod | grep aic
iw dev
nmcli device status

で復帰することを確認します。

今回の流れをまとめる

ざっくりこうでした。

Archer TX1U Nano/Aを挿す
        ↓
a69c:5721 AIC MSC
        ↓
usb_modeswitch
        ↓
3625:0110 AIC8800DC
        ↓
Kernel / headers不一致に気付く
        ↓
6.18.49-current-sunxiへ揃える
        ↓
AIC8800系ドライバを試す
        ↓
3625:0110 unsupport
        ↓
USB ID追加
        ↓
Kernel Oops
        ↓
別構成でAIC8800DC認識
        ↓
firmwareロード
        ↓
start app fail: -110
        ↓
aic8800d80をビルド・インストール
        ↓
Wi-Fi利用可能

同じ症状の人が最初に見るべきもの

個人的には、次の順番で見た方が早いと思います。

uname -r
lsusb
lsusb -t
lsmod | grep aic
iw dev
rfkill list
dmesg | grep -Ei 'aic|firmware|usb|wlan'

特に、

a69c:5721
3625:0110

のどちらで見えているかは重要です。

今後

このOrange Piは、単にWi-Fiを使うためではなく、

iPhone / 外出先
       ↓
   Tailscale
       ↓
 Orange Pi
       ↓
Wake on LAN
       ↓
メインPC / サーバ

という構成の中継ノードにする予定です。

WOLのためだけにルーターへUDPポートを直接開けるのではなく、TailscaleでOrange Piへ入り、LAN内へMagic Packetを送る構成にします。

Orange Pi自体の電源を落とせば、その遠隔経路も止められるので、管理上も分かりやすい構成になります。

次はTailscaleとWOLを設定していきます。

補足

この記事は実際の会話履歴と2026-09-08に保存した端末ログを元に再構成しました。

保存ログで確認できた事実と、記事として再現するための一般的な接続手順を分けています。

特に最終SSID接続時の nmcli / nmtui 操作だけは完全な端末ログが残っていなかったため、その部分は標準的な手順を書いています