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 管理器 用于配置设备.

设置说明

Linux

系统兼容AMD64、ARM64 和 ARM32 架构.

1. 下载 LEAPS Docker

• LEAPS Docker LEAPS-DOCKER-LINUX-v1.0.0.zip.

2. 解压缩 LEAPS Docker 压缩包

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

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

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

例如，在 Ubuntu (Linux) 上：

source leaps_docker_install.sh

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

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

4. 更新正确的 IP 地址配置.

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

例如，在 Ubuntu (Linux) 上：

source update_configuration_ip.sh

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

5. 运行所有 LEAPS Docker 容器.

• 执行 leaps_docker_run_all.sh 脚本，它将为 LEAPS 中心、LEAPS 服务器、LEAPS 网关 和 Mosquitto (MQTT 代理) 拉取并运行所需的 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

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

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

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

• 在你的系统上使用 mosquitto_sub .

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

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

8. 通过 IP地址访问 LEAPS 中心 .

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

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

9. 登录 LEAPS 中心.

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

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

• 配置演示: TWR RTLS 和数据遥测演示 或 上行链路 TDoA RTLS 演示.

• 默认情况下，网络ID将是 0x1234.

• 在本例中，需要连接 ID 为 0x83A2 的网关板.

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

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

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

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

  

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

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

视窗

1. 下载 LEAPS Docker.

• LEAPS Docker LEAPS-DOCKER-LINUX-v1.0.0.zip.

2. 解压缩 LEAPS Docker 压缩包.

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

3. 在视窗上安装 Docker Desktop.

• 请按照 Docker 文档中提供的 “ Docker Windows 安装 <https://docs.docker.com/desktop/install/windows-install/>`_”说明进行操作.

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

4. 以管理员身份使用命令提示符安装 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
  

  

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

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

  

5. 使用 PowerShell 安装 Ubuntu 20.04 WSL.

   wsl --install -d Ubuntu-20.04
   

   

• 使用``exit``注销.

6. 使用 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
  

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

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

  ./update_configuration_ip.bat
  

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

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

  

8. Docker Desktop WSL 2.

• 请参阅 Docker 文档，了解启用 Docker Desktop WSL 2 的说明.

9. 使用 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
  

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

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

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

• 请参阅以下说明，了解更多详细信息: 连接 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
...

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

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

   例如，在 Windows 上：

usbipd bind --busid 1-4

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

   例如，在 Windows 上：

usbipd attach --wsl --busid 1-4

5. 确认 USB 设备已连接.

   例如，在 Windows 上：

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

12. 通过 IP地址访问 LEAPS 中心 .

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

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

13. 登录 LEAPS 中心.

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

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

• 配置演示: TWR RTLS 和数据遥测演示 或 上行链路 TDoA RTLS 演示.

• 默认情况下，网络ID将是 0x1234.

• 在本例中，需要连接 ID 为 0x83A2 的网关板.

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

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

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

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

  

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

  

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

小心

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