一、硬件安装

将 Realtek RTL8821CE 802.11ac PCIe 无线网卡（Wi-Fi 模块）安装在栗子派昇腾310B 开发板右上角的 M.2 接口中。

二、上传并加载驱动

2.1 上传驱动到板端

将附件提供的 8821ce.ko 驱动通过 scp / WinSCP / U 盘任一方式上传到设备任意位置，然后在驱动所在目录执行以下命令，创建驱动存放目录并拷贝过去：

mkdir -p /lib/modules/$(uname -r)/extra
cp 8821ce.ko /lib/modules/$(uname -r)/extra/

2.2 加载驱动

insmod /lib/modules/$(uname -r)/extra/8821ce.ko

确认无报错输出，即加载成功。

2.3 确认 wlan0 网卡出现

ifconfig -a

查看输出中是否出现 wlan0 网卡。

三、解除射频软锁（关键步骤，务必执行）

8821CE 上电默认处于 soft-blocked（软锁） 状态，必须先解除软锁并把接口拉起来，否则无法联网。

3.1 查看软锁状态

for d in /sys/class/rfkill/rfkill*; do
  echo "$d type=$(cat $d/type) soft=$(cat $d/soft) hard=$(cat $d/hard)"
done

3.2 解除 RF-kill 软锁

echo 0 > /sys/class/rfkill/rfkill*/soft

3.3 拉起 wlan0 网卡接口

ifconfig wlan0 up

若 ifconfig wlan0 up 报 SIOCSIFFLAGS: Operation not possible due to RF-kill，说明软锁没解开——先回 3.1 确认 hard=0，再重新执行 3.2 解锁。

四、连接 WiFi（命令行 nmcli）

4.1 扫描热点

nmcli dev wifi list

成功后会列出周围热点的 SSID。

4.2 连接热点

nmcli dev wifi connect "你的SSID" password "密码"

将 你的SSID 替换为热点名称，密码 替换为热点密码。

4.3 验证联网

ifconfig wlan0                 # 查看 wlan0 是否拿到 inet 地址
ping -c 3 -I wlan0 223.5.5.5   # 强制走 wlan0 验证外网连通

五、LXQt 桌面图形化配置

1. 先完成上文「二、上传并加载驱动」与「三、解除射频软锁」步骤，确保ifconfig -a中出现wlan0且可以被 UP。

2. 右键点击桌面右下角的网口图标，弹出界面会显示周围热点 SSID。

3. 单击要连接的热点，在弹出的窗口中输入该热点密码即可完成连接。

六、注意事项与常见坑点

1. RF-kill 软锁是最大坑：8821CE 上电默认 soft-blocked，不解除就ifconfig wlan0 up会报Operation not possible due to RF-kill，务必先执行第三节的解锁命令。

2. 驱动需与内核版本匹配：8821ce.ko由附件提供，须放入/lib/modules/$(uname -r)/extra/目录（$(uname -r)会自动展开为当前内核版本）；若insmod报错，先确认驱动与内核版本一致。

3. 网卡接口名：以ifconfig -a实际输出为准，正常为wlan0；若不同请替换对应命令中的接口名。

---

总结

栗子派昇腾310B 无线联网的完整链路是：M.2 装入 RTL8821CE → 上传并 insmod 驱动 → 确认 wlan0 出现 → 解除 RF-kill 软锁并 ifconfig wlan0 up → nmcli 连接热点 → 验证拿到 inet 并 ping 通外网。其中「解除软锁」一步最容易遗漏，是 8821CE 能正常联网的关键前提；图形化桌面方式也需先完成驱动加载与软锁解除。