LEAPS Docker

本页提供：

  • LEAPS Docker 软件包.

  • 有关系统要求的信息.

  • 如何安装 LEAPS Docker 的说明.

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

免责声明

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

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

系统要求

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

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

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

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

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

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

设置说明

系统兼容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:udk1   "/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:udk1      "/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:udk1      "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:udk1   "/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 中心 .

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

  • 输入IP地址或 localhost 来访问 LEAPS 中心 .

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

  1. 登录 LEAPS 中心.

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

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

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

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

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

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

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

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

  • 请参阅 LEAPS 中心 和 LEAPS 管理器 了解更多关于如何使用应用程序来配置和可视化节点和网络的详情.

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

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

  1. 下载 LEAPS Docker.

  1. 解压缩 LEAPS Docker 压缩包.

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

  1. 在视窗上安装 Docker Desktop.

  • 请按照 Docker 文档中提供的 Docker 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 中心, LEAPS Server, LEAPS 网关和 Mosquitto (MQTT broker) 拉取并运行所需的 Docker 容器.

    ./leaps_docker_run_all.bat

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

    CONTAINER ID   IMAGE                       COMMAND                  CREATED          STATUS          PORTS                                              NAMES
6f2ae0c87d65   leapslabs/leaps_mosquitto:udk1   "/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:udk1     "/app/leaps-gateway …"   10 seconds ago   Up 10 seconds                                                      leaps_gateway
3d84cad7a913   leapslabs/leaps_server:udk1      "/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:udk1      "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 中心 .

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

  • 输入IP地址或 localhost 来访问 LEAPS 中心 .

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

  1. 登录 LEAPS 中心.

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

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

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

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

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

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

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

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

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

小心

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