一、适用环境

• 开发板：正点原子 / 韦东山 IMX6ULL Pro
• WiFi 网卡：wlan1（以 ifconfig -a 实际显示为准）
• 示例 WiFi：Xiaomi 14
• 示例密码：12345678
• 执行终端：开发板串口终端（root 用户），非 Ubuntu

---

二、一次性初始配置（仅第一次执行）

步骤 1：禁用系统自动网络管理（避免冲突）

mv /etc/init.d/S45network-manager /root
reboot

执行后开发板会重启，重启完成后重新登录 root。

---

三、完整 WiFi 连接步骤

步骤 2：启动 WiFi 网卡

ifconfig wlan1 up

步骤 3：扫描附近 WiFi 热点

iw dev wlan1 scan | grep SSID

出现目标 WiFi 名称（Xiaomi 14）即为扫描成功。

步骤 4：生成 WiFi 配置文件

wpa_passphrase "Xiaomi 14" "12345678" > /etc/wpa_supplicant.conf

步骤 5：连接 WiFi

wpa_supplicant -B -i wlan1 -c /etc/wpa_supplicant.conf

等待串口打印：

wlan1: link becomes ready

表示 WiFi 链路已成功连接。

步骤 6：查看 WiFi 连接状态

iw wlan1 link

显示已连接、对应 SSID 信息即为正常。

步骤 7：动态获取 IP 地址

udhcpc -i wlan1

• 正常情况：获取到 192.168.x.x 内网 IP
• 异常情况：一直打印 sending discover 无响应，使用下方静态 IP 兜底方案

步骤 8：网络连通性测试

ping www.baidu.com

---

四、静态 IP 兜底方案（DHCP 无法获取 IP 时使用）

适用于手机热点不分配 IP 的场景（小米 /iPhone 热点常见）：

# 设置静态 IP
ifconfig wlan1 192.168.43.100 netmask 255.255.255.0

# 设置默认网关
route add default gw 192.168.43.1 wlan1

# 设置 DNS（解决域名无法解析）
echo "nameserver 114.114.114.114" > /etc/resolv.conf

配置完成后重新执行 ping 测试。

---

五、开发板重启后快速重连 WiFi

每次断电重启后，只需执行以下两条命令即可重新联网：

wpa_supplicant -B -i wlan1 -c /etc/wpa_supplicant.conf
udhcpc -i wlan1

若依旧获取不到 IP，追加执行静态 IP 兜底方案。

---

六、常见问题说明

1. link becomes ready 只代表 WiFi 密码正确、链路接通，不代表能上外网
2. udhcpc 一直 discover：热点未分配 IPv4，使用静态 IP 即可
3. 密码错误会提示 4-Way Handshake failed，重新核对 WiFi 名称与密码
4. 本方案为底层原生 wpa_supplicant 连接，不依赖 NetworkManager，稳定性最高