在Raspberry Pi OS上配置设备Wi-Fi

1 概述

介绍在Raspberry Pi OS上通过图形化工具或者命令行来配置Wi-Fi。

1.1 背景

部分用户在使用带Wi-Fi功能的ED-CM4SEN、ED-CM4IND、ED-IPC系列和ED-HMI系列等产品时，由于对Raspberry Pi的Debian系统不熟悉，导致无法配置设备的Wi-Fi。针对这一问题，我司提供详细的操作说明，指导用户配置设备的Wi-Fi。

1.2 适用范围

本应用适用于带Wi-Fi功能的ED-CM4SEN、ED-CM4IND、ED-IPC系列和ED-HMI系列等产品。

2 应用指导

设备的操作系统包含桌面版和Lite版，下文分别介绍在桌面版和Lite版系统上配置设备Wi-Fi的操作步骤。

2.1 在Raspberry Pi OS (Desktop) 上配置Wi-Fi

在Desktop版本的操作系统中，可以通过桌面图标先使能Wi-Fi，再通过桌面图标或者NetworkManager工具来连接Wi-Fi。

2.1.1 使能Wi-Fi

Wi-Fi功能默认是屏蔽的，需要设置国家区域来进行使能。

操作步骤：

  1. 左键单击桌面右上角的image-20240605105202872图标，在菜单中选择“Click here to set Wi-Fi country”。
image-20241126174314132
  1. 在弹出的Wireless LAN Country窗格中设置Country的取值，根据实际地区来选择即可。
image-20240605105230131
  1. 选择“OK”，完成设置。

2.1.2 通过桌面图标连接Wi-Fi

前提条件：

已使能Wi-Fi。

操作步骤：

  1. 左键单击桌面右上角的image-20240605105435147图标，在弹出的Wi-Fi列表中选择待连接的Wi-Fi并单击。
image-20241126174353062
  1. 在弹出的Wi-Fi Network Authentication Required窗格的Password右侧输入Wi-Fi密码。
image-20240605105456533
  1. 单击“Connect”连接网络，连接完成后，可在桌面右上角单击图标查看Wi-Fi信息。

2.1.3 通过NetworkManager工具连接Wi-Fi

前提条件：

  • 已使能Wi-Fi功能。
  • 已准备可连接的Wi-Fi名和密码，例如Wi-Fi名为SSID，密码为password。

操作步骤：

  1. 打开命令终端窗格执行如下命令，扫描可连接的Wi-Fi列表。
sudo nmcli device wifi
image-20240605105531840
  1. 执行如下命令，连接待接入的Wi-Fi。
sudo nmcli device wifi connect SSID password password
  • 其中SSID为待连接的WiFi名称，password为待连接的WiFi密码。
  1. 执行如下命令，设置Wi-Fi自动连接。
sudo nmcli connection modify SSID connection.autoconnect yes
  • 其中SSID为待连接的Wi-Fi名称。

2.2 在Raspberry Pi OS (Lite) 上配置Wi-Fi

在Lite版本的操作系统中，支持通过raspi-config工具先使能Wi-Fi，再通过raspi-config或者NetworkManager工具来连接Wi-Fi。

2.2.1 使能Wi-Fi

Wi-Fi功能默认是屏蔽的，需要设置国家区域来进行使能。

操作步骤：

  1. 打开命令终端窗格执行如下命令，打开Raspberry Pi Software Configuration Tool (raspi-config)界面。
sudo raspi-config
  1. 选择“5 Localisation Options”并按Enter。
Localisation Options
  1. 在打开的界面中选择“L4 WLAN Country”并按Enter。
L4 WLAN Country
  1. 在打开的界面中根据实际地区选择一个国家码，并按Enter。
country_code
  1. 在打开的Wireless LAN country set to CN界面中按Enter。
Wireless LAN country set to CN

2.2.2 通过raspi-config工具连接Wi-Fi

前提条件：

  • 已使能Wi-Fi功能。
  • 已准备可连接的Wi-Fi名和密码，例如Wi-Fi名为SSID，密码为password。

操作步骤：

  1. 打开命令终端窗格执行如下命令，打开Raspberry Pi Software Configuration Tool (raspi-config)界面。
sudo raspi-config
image-20240605105636339
  1. 选择“1 System Options”并按Enter，在打开的界面中选择“S1 Wireless LAN”。
image-20240605105646571
  1. 按Enter，在打开的Please enter SSID界面中输入Wi-Fi名称。
image-20240605105656511
  1. 按Enter，在打开的Please enter passphrase界面中输入Wi-Fi密码。

提示

如果Wi-Fi没有密码，则无需输入密码，直接按Enter确认。

image-20240605105710881

  1. 按Enter连接Wi-Fi，待Wi-Fi连接成功后，选择“Finish”并按Enter完成设置，返回至命令行窗口。

  2. 执行如下命令，重启设备，使配置生效。

sudo reboot
  1. 执行如下命令，查询Wi-Fi是否连接成功。
ifconfig
  • 如果返回结果中包含wlan0，且详细的信息中包含“inet: 192.168.XX.XX”，则表示Wi-Fi连接成功。
  • 如果返回结果中未包含wlan0，则表示Wi-Fi连接失败。
wlan0

2.2.3 通过NetworkManager工具连接Wi-Fi

前提条件：

  • 已使能Wi-Fi功能。
  • 已准备可连接的Wi-Fi名和密码，例如Wi-Fi名为SSID，密码为password。

操作步骤：

  1. 打开命令终端窗格执行如下命令，扫描可连接的Wi-Fi列表。
sudo nmcli device wifi
image-20240605105531840
  1. 执行如下命令，连接待接入的Wi-Fi。
sudo nmcli device wifi connect SSID password password
  • 其中SSID为待连接的WiFi名称，password为待连接的WiFi密码。
  1. 执行如下命令，设置Wi-Fi自动连接。
sudo nmcli connection modify SSID connection.autoconnect yes
  • 其中SSID为待连接的Wi-Fi名称。