LEAPS Raspberry Pi

本页提供：

  • LEAPS Raspberry Pi 软件包.

  • 有关系统要求的信息.

  • 如何安装 LEAPS Raspberry Pi 的说明.

安装快速简单，只需要完成一次.

开始之前:记住备份 SD 卡中任何你想要保留的重要文件，因为格式化时所有数据都将被永久覆盖.

系统要求

  • Raspberry Pi 3B 或更新版本.

  • 推荐： 一套 UDK1 (至少五个设备) 来验证.

  • 推荐：为设备供电的电池或 USB-C 电缆.

  • 推荐: LEAPS 管理器 用于配置设备.

设置说明

  1. 下载 LEAPS Raspberry Pi 镜像.

  1. 提取 LEAPS Raspberry Pi 档案.

  • 使用 WinZip 或 7-Zip 等程序解压缩下载的 LEAPS Raspberry Pi 压缩文件.

  1. 启动 Raspberry Pi 相机.

  • 您的操作系统可能会尝试阻止安装程序.

  • 在视窗上： 如果看到警告信息，请点击 More info 和 Run anyway.

  1. 安装 LEAPS Raspberry Pi 镜像.

  • 将 SD卡插入电脑或笔记本电脑的 SD 卡插槽.

  • 打开 Raspberry Pi 映像器.

../../../_images/raspberry_pi_imager.png

  • 选择 “使用自定义”，然后选择你想要安装的 LEAPS Raspberry Pi 镜像.

../../../_images/raspberry_pi_image_use_custom.png

  • 选择正确的 SD 卡来安装映像. 在不同的平台上,驱动器可能会有不同的显示方式.

../../../_images/choose_the_correct_sd_card.png

  • 请格外注意，根据硬盘的内存容量选择正确的硬盘.

  • 一旦选择了 LEAPS Raspberry Pi Image 和 SD 卡，就会出现一个新的 WRITE 按钮.

../../../_images/raspberry_pi_image_write.png

  • 点击 写 按钮.

  1. 写入并完成.

  • 等待 Raspberry Pi 相机完成写入过程.

../../../_images/raspberry_pi_image_writing.png

  • 收到确认信息后，你就可以安全地弹出 SD 卡了.

../../../_images/raspberry_pi_image_confirm.png

  1. 开始使用LEAPS.

  • 从电脑或笔记本电脑中取出SD卡，并将其插入 Raspberry Pi.

  • 确保你的 Raspberry Pi 处于开机状态.

  • LEAPS 系统已安装并配置为与你的 Raspberry Pi 一起启动.

  1. 等待系统启动.

  • 请耐心等待几分钟，让整个系统完成启动.

  1. 使用密码 Leaps1234 连接到 Raspberry Pi 广播的 LEAPS-AP 网络.

../../../_images/connect_leaps_udk1_network.png

  1. SSH 进入 Raspberry Pi（可选）.

  • 在 PC 上（甚至是另一台 Raspberry Pi），打开 PowerShell 或 Terminal 窗口，然后输入以下命令，通过 SSH 连接 Raspberry Pi.

    ssh leaps@192.168.200.1

  • 默认情况下，账户是 leaps，密码是 leaps.

  1. 使用 LEAPS 管理器 准备网络.

../../../_images/raspberry_pi_network_demo01.jpg

  1. 与网关板连接.

  • 使用 USB-C 数据线将网关板连接到你的 Raspberry Pi.

  • 将 USB-C 数据线插入 PC 上的 USB-C Data Port 1. 确保连接稳定.

  • 如果在网关模式下成功连接，将听到两声哔哔声作为确认.

  1. 检查系统状态（可选）.

  • 使用 mosquitto_sub 命令来检查系统状态. 该命令将连接到 Mosquitto MQTT 代理，并显示所有收到的消息.

mosquitto_sub -p 1883 -d -v -t '#'

  1. 访问 LEAPS 中心.

  • 在网络浏览器中，访问 192.168.200.1/24 的地址. (可以直接在 Raspberry Pi 上打开，或者在连接到 Raspberry Pi 广播的 LEAPS-AP 网络的 PC 上打开，密码为 Leaps1234 - 第 9 步)

  • 如果你在局域网中，请使用另一台电脑的网页浏览器来访问 Raspberry Pi 的 IP 地址.

  • 在 LEAPS 中心 中配置网络设置，以匹配您所连接的网关板的网络 ID.

  1. 登录 LEAPS 中心.

  • 以用户名 admin`和密码 :red:`admin 登录.

../../../_images/raspberry_leaps_center_login.png

  1. 在 LEAPS 中心 上配置网络.

  • 检查 LEAPS 中心 中的网络设置，以匹配您所连接的网关板卡的网络 ID.

../../../_images/raspberry_pi_leaps_center_udk1.png

现在系统已经成功设置和配置. 祝您使用愉快！

注解

如何重新配置任何网络

  1. 关闭Raspberry Pi 上的 LEAPS-AP Wi-Fi AP

  • 首先，确保关闭 Raspberry Pi 上的 Wi-Fi 接入点 (AP).

  1. 将 Raspberry Pi 连接到所需的网络

  • 将你的 Raspberry Pi 连接到你想要使用的以太网或 Wi-Fi 网络.

  1. 检查IP 地址

  • 在 Raspberry Pi 上打开终端，使用 ifconfig 命令检查 IP 地址

../../../_images/raspberry_pi_check_ip.png

  • 记下 IP 地址，例如可能是 192.168.0.104.

  1. 更新对应的 IP 地址

  • 打开 LEAPS 网关的配置文件：

    sudo nano /usr/share/LEAPS-DOCKER-LINUX/leaps-gateway-hub/data/leaps-gateway.conf
    ../../../_images/raspberry_pi_leaps_gateway.png

  • 查找指定 IP 地址的行，并将其更改为 192.168.0.104.

  • 接下来，打开 LEAPS 服务器的配置文件:

    sudo nano /usr/share/LEAPS-DOCKER-LINUX/leaps-server-hub/data/leaps-server.conf
    ../../../_images/raspberry_pi_leaps_server.png

  • 再次更新此文件，以反映新的 IP 地址 192.168.0.104.

  1. 重新启动 LEAPS 服务器和 LEAPS 网关

  • 修改后，重新启动这两个服务：

    sudo docker restart leaps_server

    sudo docker restart leaps_gateway

  1. 确认 LEAPS服务器和LEAPS网关工作正常

  • 检查正在运行的 Docker 容器的状态：

    leaps@raspberrypi:~ $ sudo docker ps
CONTAINER ID   IMAGE                          COMMAND                  CREATED      STATUS          PORTS                                                                                  NAMES
b5bc1d479a04   leapslabs/leaps_gateway:udk1   "/app/leaps-gateway …"   6 days ago   Up 15 minutes                                                                                          leaps_gateway
68c33d70bc07   leapslabs/leaps_server:udk1    "/app/leaps-server -…"   6 days ago   Up 15 minutes   0.0.0.0:7777->7777/tcp, 0.0.0.0:7777->7777/udp, :::7777->7777/tcp, :::7777->7777/udp   leaps_server
38092ca7b1b1   leapslabs/leaps_center:udk1    "sh -c 'cd /app &&  …"   6 days ago   Up 15 minutes   80/tcp, 0.0.0.0:80->8080/tcp, [::]:80->8080/tcp                                        leaps_center

  1. 监控 MQTT 消息

  • 要监控 MQTT 消息，请使用:

    mosquitto_sub -p 1883 -d -v -t '#'

  1. 打开 LEAPS 中心并更新主机

  • 启动 LEAPS Center 应用程序，将主机地址更新为 192.168.0.104.

  • 确保重新加载网络以应用更改.

../../../_images/raspberry_pi_leaps_center_reconfig.png

如何为 Wi-Fi 接入点设置密码:LEAPS-AP

在 Raspberry Pi OS Bookworm 上设置接入点安全和密码:

sudo nmcli con modify hotspot wifi-sec.key-mgmt wpa-psk
sudo nmcli con modify hotspot wifi-sec.psk "Leaps1234"

在 Raspberry Pi OS Bullseye 及更早版本上设置接入点：

  1. 编辑Hostapd配置. 使用此命令打开Hostapd配置文件：

sudo nano /etc/hostapd/hostapd.conf

  1. 在文件末尾添加以下参数：

wpa=2
wpa_passphrase=Leaps1234
wpa_key_mgmt=WPA-PSK
wpa_pairwise=TKIP
rsn_pairwise=CCMP

  1. 保存并退出

按 CTRL + O 保存，然后按 CTRL + X 退出编辑器.

  1. 重新启动你的 Raspberry Pi

要应用更改，请重启你的 Raspberry Pi.