跳到主要内容

网络配置

通过设备热点连接控制页面,也可使用 AccessPopup 将树莓派接入路由器,访问 Web、JupyterLab 和 SSH。

设备通过树莓派热点 AccessPopup 提供网络连接。出厂镜像已启用 AccessPopup 网页(端口 8052),可在浏览器里配置 Wi-Fi。

选择连接方式​

访问控制页、实时画面、JupyterLab 和 SSH 时,将电脑与树莓派连接到同一网络。容器内 ROS2 程序通过 SSH 操作;跨电脑 ROS2 通信还需要单独配置 ROS Domain 与网络发现。

方式适用场景典型地址
树莓派热点(AP)首次配网、手动切到热点模式,或自动检测时找不到已保存的 Wi-Fihttp://192.168.50.5:5000
Wi-Fi(STA)日常遥控和开发http://<OLED W 行 IP>:5000
网线固定环境、较稳定的传输http://<OLED E 行 IP>:5000
服务端口
控制页5000
JupyterLab8888
AccessPopup(配网)8052

以 OLED 和当前镜像为准。建议使用 Chrome。

方式一:热点 AccessPopup​

首次开机且尚未保存 Wi-Fi 配置时,树莓派会开启热点 AccessPopup,密码为 1234567890。电脑或手机连上该热点后,用浏览器打开以下地址。

http://192.168.50.5:5000

JupyterLab:

http://192.168.50.5:8888

AccessPopup 配网页面:

http://192.168.50.5:8052

也可在控制页右侧点 AccessPopup 打开。

AccessPopup 首页如下。“当前网络设备详情”显示当前连接和 IP 地址;点击顶部红框中的“添加新 WiFi 网络”可配置新的无线网络。

AccessPopup 首页导航和当前网络设备详情,红框标出添加新 WiFi 网络入口

方式二:连接现场 Wi-Fi​

出厂镜像默认已打开 AccessPopup 网页。用控制页入口或直接打开 http://<IP>:8052(热点下为 http://192.168.50.5:8052)。页面支持中英文切换。

切换网络前,先结束运动和自动任务,确认底盘和机械臂静止。连接过程中网页和 SSH 可能断开,不能依靠断连停止设备。

第一次连接已知 Wi-Fi:

  1. 电脑或手机连上热点 AccessPopup(或已与树莓派同一网络)。
  2. 打开控制页,点右侧 AccessPopup;或浏览器打开 http://<IP>:8052。
  3. 进入 添加新 WiFi 网络,点 刷新列表,等待附近网络出现(可能需约 30 秒)。
  4. 选中目标 Wi-Fi,输入密码并连接。
  5. 查看 OLED W 行是否变成新地址,再把电脑连上同一路由器,用新地址打开控制页和 JupyterLab。

开启自动检测后,树莓派找不到任何已保存的 Wi-Fi 时,会开启 AccessPopup 热点。如果附近还有其他已保存的 Wi-Fi,树莓派可继续连接这些网络。

网页其它常用操作​

操作位置
查看当前连接与 IP首页
固定开热点 / 恢复自动检测首页的“切换到热点模式”和“重启网络检测”
连接、改密码或删除已保存网络“编辑 WiFi 配置”
修改热点名称或密码“编辑 WiFi 配置” 中的 AccessPopup 配置

切换网络后,用新 IP 重新打开页面。

终端方式(可选)​

无法打开 :8052,或更习惯命令行时,可在 JupyterLab Terminal 中配置:

  1. 通过控制页的 JupyterLab 按钮或 http://<IP>:8888 打开 JupyterLab,在启动页点击 "Terminal"。

    JupyterLab 启动页中的 Terminal 入口

  2. 进入 AccessPopup 配置目录,为 Wi-Fi 配置脚本添加可执行权限,然后运行脚本:

    cd /home/ws/ugv_rpi/AccessPopup
    sudo chmod +x installconfig.sh
    sudo ./installconfig.sh
  3. 输入 5 添加网络。脚本列出附近的 Wi-Fi 后,输入目标 Wi-Fi 前的序号,再按提示输入密码。

    AccessPopup 脚本列出附近的 Wi-Fi 及其序号

  4. 看 OLED W 行是否变成新地址,再用新地址打开控制页和 JupyterLab。

  5. 输入 9 退出脚本。

管理 Wi-Fi 连接​

切换热点模式​

如何切换回 AP(热点)模式?

需要让树莓派重新提供 AccessPopup 热点时,切回热点模式(AP)。切换前先结束运动和自动任务,确认底盘和机械臂静止。

在热点模式(AP)与 Wi-Fi(STA)之间切换时,网页和 SSH 可能断开。切换后,将电脑连到树莓派所在的网络,在浏览器地址栏将旧 IP 替换为 OLED W 行显示的当前 IP,重新打开控制页(端口 5000)和 JupyterLab(端口 8888)。

在 JupyterLab Terminal 中,按需要选择对应的命令。

切回热点模式(AP):

sudo accesspopup -a

恢复自动检测,使树莓派在已保存的 Wi-Fi 可用时尝试连接:

sudo accesspopup

删除已保存的 Wi-Fi​

删除当前连接会使 SSH 和网页断开。操作前先停止运动,并准备通过热点或网线重新连接。也可在 AccessPopup 配网页面的“编辑 WiFi 配置”中删除。

在 JupyterLab Terminal 中,先列出连接,再将 连接名称 替换为要删除的实际连接名称。保留引号以处理空格。

nmcli connection show
sudo nmcli connection delete "连接名称"

开启自动检测时,只有找不到其他已保存的 Wi-Fi,树莓派才会切回热点。SSH 断开后,查看电脑的 Wi-Fi 列表,确认 AccessPopup 热点是否可用。

开启 SSH​

镜像已打开 SSH 时可跳过。需要在车上打开时,在 JupyterLab Terminal 输入:

sudo raspi-config

选择 Interface Options → SSH → Yes,再选 Finish。回到终端检查:

systemctl is-active ssh

显示 active 后,从电脑尝试连接;无需仅为开启 SSH 就重新启动整机。

电脑与树莓派位于同一网络时:

ssh ws@<IP>

出厂镜像用户名和密码均为 ws。

下一步见 Web 控制界面使用。