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

LEAPS Docker

本页提供：

  • LEAPS Docker 软件包。

  • 有关系统要求的信息。

  • 如何安装 LEAPS Docker 的说明。

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

免责声明

LEAPS Docker 仅供专业人士安装. 对于演示目的， LEAPS VMWare 是更好的选择。

访问官方的 Docker了解更多关于 Docker。

系统要求

  • 系统需求请参考 Docker Desktop on Linux 或 Docker Desktop on Windows。

  • 一个桌面设备：需要 2 GB 可用内存。

  • 在windows上，安装 WSL 会永久占用 2GB 内存。它被分配给 Ubuntu WSL。

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

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

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

设置说明

系统兼容AMD64, ARM64 和 ARM32 架构。

  1. 下载 LEAPS Docker

  1. 解压缩 LEAPS Docker 压缩包

  • 在终端中输入： $ unzip LEAPS-DOCKER-LINUX-v1.0.0.zip -d /path/to/directory

  1. 在你的操作系统上安装 Docker。

  • 运行 leaps_docker_install.sh 脚本，在你的操作系统上安装。

例如，在 Ubuntu (Linux) 上：

source leaps_docker_install.sh

  • 安装完成后，重新启动操作系统，以确保 Docker 配置正确。

  • 详细说明可以参考官方的 Docker文档。

  1. 更新正确的 IP 地址配置。

  • 使用 update_configuration_ip.sh 脚本，用你电脑的 IP 地址更新系统配置。

例如，在 Ubuntu (Linux) 上：

source update_configuration_ip.sh

  • 运行此脚本可确保系统的通讯配置正确无误。

  1. 运行所有 LEAPS Docker 容器。

例如，在 Ubuntu (Linux) 上：

source leaps_docker_run_all.sh

  • 执行 docker ps 命令，确保所有容器都能成功启动并准备就绪。

例如，在 Ubuntu (Linux) 上：

docker ps

CONTAINER ID   IMAGE                       COMMAND                  CREATED          STATUS          PORTS                                              NAMES
6f2ae0c87d65   leapslabs/leaps_mosquitto:udk   "/docker-entrypoint.…"   9 seconds ago    Up 9 seconds    0.0.0.0:1883->1883/tcp, 0.0.0.0:15675->15675/tcp   leaps_mosquitto
3d84cad7a913   leapslabs/leaps_server:udk      "/app/leaps-server -…"   10 seconds ago   Up 9 seconds    0.0.0.0:7777->7777/tcp, 0.0.0.0:7777->7777/udp     leaps_server
633c97e96f6e   leapslabs/leaps_center:udk      "sh -c 'cd /app &&  …"   10 seconds ago   Up 10 seconds   80/tcp, 0.0.0.0:80->8080/tcp                       leaps_center

sudo docker ps

CONTAINER ID   IMAGE                     COMMAND                  CREATED              STATUS                          PORTS     NAMES
6bb3bf42cb63   leapslabs/leaps_gateway:udk   "/app/leaps-gateway …"   About a minute ago   Up About a minute                         leaps_gateway

  1. 使用 USB-C 数据线将网关板连接到电脑。

../../../_images/leaps-connect-usb-port1.gif

  1. Mosquitto并检查信息 (可选)

  • 在你的系统上使用 mosquitto_sub 。

  • 要检查消息，请在终端中使用以下命令（该命令将连接到 Mosquitto MQTT 代理，并显示收到的所有消息）。

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

  1. 通过 IP地址访问 LEAPS Center 。

  • 使用电脑的网页浏览器。

  • 输入IP地址或 localhost 来访问 LEAPS Center 。

../../../_images/docker_leaps_center_login.png

  1. 登录 LEAPS Center。

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

  1. 使用 LEAPS Manager 准备网络。

../../../_images/docker_network_demo01.jpg

  1. 在 LEAPS Center 上配置网络。

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

  • 检查配置为PC IP地址的主机是否正确。

  • 在这个例子中，网络 ID 是 0x1234，主机是 192.168.1.12。

    ../../../_images/docker_leaps_center_config_network.png

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

../../../_images/docker_leaps_center_network.png

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

  1. 下载 LEAPS Docker。

  1. 解压缩 LEAPS Docker 压缩包。

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

  1. 在windows上安装 Docker Desktop。

  • 请按照 Docker 文档中提供的 Docker Windows 安装”说明进行操作。

  • 安装完成后，请重新启动windows系统，以确保所有更改生效。

  1. 以管理员身份使用命令提示符安装 USBIPD-WIN 项目。

  • 按照说明进行操作: 安装 USBIPD-WIN 项目。

  • 例如，使用 Windows 软件包管理器 (winget) 安装 usbipd-win 项目：

    winget install --interactive --exact dorssel.usbipd-win
    ../../../_images/docker-install-usbipd-win.png

  • 如果你省略了 --interactive ，winget 可能会在需要安装驱动程序时立即重新启动你的电脑。

  • 重新启动计算机，并使用 usbipd-win version 命令来验证安装。

    ../../../_images/docker-usbipd-version.png

  1. 使用 PowerShell 安装 Ubuntu 20.04 WSL。

    wsl --install -d Ubuntu-20.04
    ../../../_images/docker-wsl-install-buntu.png

  • 使用 exit 注销。

  1. 使用 PowerShell 将 Ubuntu 20.04 设置为默认 WSL 发行版。

    wsl --set-default Ubuntu-20.04

  • 列出所有已安装的 WSL 发行版，运行 wsl --list。

    Windows Subsystem for Linux Distributions:
Ubuntu-20.04 (Default)
docker-desktop-data
docker-desktop

  1. 使用 PowerShell 更新 IP 地址的正确配置。

  • 使用 update_configuration_ip.bat 脚本，根据电脑的 IP 地址更新系统配置。

    ./update_configuration_ip.bat

  • 运行此脚本可确保系统的通讯配置正确无误。

  • 在本例中，IP 地址是 192.168.1.12。

    ../../../_images/docker-update-configuration-ip.png

  1. Docker Desktop WSL 2.

../../../_images/docker_desktop_wsl2.png

  1. 使用 PowerShell 运行所有 LEAPS Docker 容器。

  • 执行 leaps_docker_run_all.bat 脚本，它将为 LEAPS Center, LEAPS Server, LEAPS Gateway和 Mosquitto (MQTT broker) 拉取并运行所需的 Docker 容器。

    ./leaps_docker_run_all.bat

  • 确保所有容器都能成功启动并准备就绪。

    CONTAINER ID   IMAGE                       COMMAND                  CREATED          STATUS          PORTS                                              NAMES
6f2ae0c87d65   leapslabs/leaps_mosquitto:udk   "/docker-entrypoint.…"   9 seconds ago    Up 9 seconds    0.0.0.0:1883->1883/tcp, 0.0.0.0:15675->15675/tcp   leaps_mosquitto
6bb3bf42cb63   leapslabs/leaps_gateway:udk     "/app/leaps-gateway …"   10 seconds ago   Up 10 seconds                                                      leaps_gateway
3d84cad7a913   leapslabs/leaps_server:udk      "/app/leaps-server -…"   11 seconds ago   Up 11 seconds    0.0.0.0:7777->7777/tcp, 0.0.0.0:7777->7777/udp    leaps_server
633c97e96f6e   leapslabs/leaps_center:udk      "sh -c 'cd /app &&  …"   12 seconds ago   Up 12 seconds   80/tcp, 0.0.0.0:80->8080/tcp                       leaps_center

  1. 使用 USB-C 数据线将网关板连接到电脑。

../../../_images/leaps-connect-usb-port1.gif

  1. 以管理员身份使用命令提示符连接 USB 设备。

  1. 检查并获取设备的总线 ID 信息。 列出所有已连接的 USB 设备。

例如，在 Windows 上：

usbipd list
Connected:
BUSID  VID:PID    DEVICE                                                        STATE
1-4    1915:e8e3  LEAPS API USB, USB Serial Device (COM24)                      Not attached
...

  1. 在这个例子中，设备的总线 ID 是 1-4。

  2. 共享设备，允许其连接到 WSL。

    例如，在 Windows 上：

usbipd bind --busid 1-4

  1. 选择你想要连接到 WSL 的设备的总线 ID。 如果未成功连接，请重复。

    例如，在 Windows 上：

usbipd attach --wsl --busid 1-4

  1. 确认 USB 设备已连接。

    例如，在 Windows 上：

usbipd list
Connected:
BUSID  VID:PID    DEVICE                                                        STATE
1-4    1915:e8e3  LEAPS API USB, USB Serial Device (COM24)                      Attached
...
../../../_images/docker-attach-a-USB-device.png

  1. 通过 IP地址访问 LEAPS Center 。

  • 使用电脑的网页浏览器。

  • 输入IP地址或 localhost 来访问 LEAPS Center 。

../../../_images/docker_leaps_center_login.png

  1. 登录 LEAPS Center。

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

  1. 使用 LEAPS Manager 准备网络。

../../../_images/docker_network_demo01.jpg

  1. 在 LEAPS Center 上配置网络。

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

  • 检查配置为PC IP地址的主机是否正确。

  • 在这个例子中，网络 ID 是 0x1234，主机是 192.168.1.12。

    ../../../_images/docker_leaps_center_config_network.png

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

    ../../../_images/docker_leaps_center_network.png

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

小心

重复 USB/IP attach WSL 2 步骤，连接 USB 设备。