LEAPS Docker

本页提供:

  • LEAPS Docker 软件包.

  • 有关系统要求的信息.

  • 如何安装 LEAPS Docker 的说明.

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

免责声明

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

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

系统要求

  • 系统需求请参考 Docker Desktop on LinuxDocker 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`和密码 :red:`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.

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

  • 按照说明进行操作:安装 USBIPD-WIN 项目 <https://learn.microsoft.com/en-us/windows/wsl/connect-usb#install-the-usbipd-win-project>`_.

  • 例如,使用 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 Gateway 和 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`和密码 :red:`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 设备.