Please note that the Chinese and Japanese versions are currently being updated and are not yet complete. Stay tuned for the final versions!

LEAPS Raspberry Pi

本页提供:

  • LEAPS Raspberry Pi 软件包。

  • 有关系统要求的信息。

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

安装快速简单,只需要完成一次。

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

系统要求

  • Raspberry Pi 3B 或更新版本。

  • 推荐: 一套 UDK (至少五个设备) 来验证。

  • 推荐: 为设备供电的电池或 USB-C 电缆。

  • 推荐: LEAPS Manager 用于配置设备.

设置说明

  1. 下载 LEAPS Raspberry Pi 镜像。

  1. 提取 LEAPS Raspberry Pi 档案。

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

  1. 启动 Raspberry Pi 相机。

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

  • 在windows上: 如果看到警告信息,请点击 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_udk_network.png
  1. SSH 进入 Raspberry Pi(可选)。

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

    ssh leaps@192.168.200.1
    
  • 默认情况下,账户是 leaps,密码是 leaps

  1. 使用 LEAPS Manager 准备网络。

../../../_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 Center

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

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

  • LEAPS Center 中配置网络设置,以匹配您所连接的网关板的网络 ID。

  1. 登录 LEAPS Center

  • 以用户名 admin 和密码 admin 登录。

../../../_images/raspberry_leaps_center_login.png
  1. LEAPS Center 上配置网络。

  • 检查 LEAPS Center 中的网络设置,以匹配您所连接的网关板卡的网络 ID。

../../../_images/raspberry_pi_leaps_center_udk.png
  • 请参阅 LEAPS CenterLEAPS Manager 了解更多关于如何使用应用程序来配置和可视化节点和网络的详情。

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

注解

如何重新配置任何网络

  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 Gateway的配置文件:

    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 server的配置文件:

    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 server和 LEAPS Gateway

  • 修改后,重新启动这两个服务:

    sudo docker restart leaps_server
    
    sudo docker restart leaps_gateway
    
  1. 确认 LEAPS server和LEAPS Gateway工作正常

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

    leaps@raspberrypi:~ $ sudo docker ps
    CONTAINER ID   IMAGE                          COMMAND                  CREATED      STATUS          PORTS                                                                                  NAMES
    b5bc1d479a04   leapslabs/leaps_gateway:udk   "/app/leaps-gateway …"   6 days ago   Up 15 minutes                                                                                          leaps_gateway
    68c33d70bc07   leapslabs/leaps_server:udk    "/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:udk    "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 Center并更新主机

  • 启动 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。