LEAPS 网关

LEAPS网关是 UWB 和 TCP/IP 网络之间的桥梁.

主要功能

  • LEAPS网关一侧通过通用LEAPS API、SPI或USB与LEAPS UWBS通信，另一侧通过TCP/IP与LEAPS服务器通信。

  • 根据LEAPS UWB网络配置文件，它提供了一种媒介，用于向MQTT代理传输锚和标签的上行链路和下行链路位置以及遥测数据。

  • 与UWBS的互连是通过专用LEAPS网关嵌入式设备上的SPI完成的。当与LEAPS UWBS的互连通过USB完成时，就像UDK1设备的情况一样，LEAPS网关作为守护进程服务在Linux平台上运行。

安装

系统要求

Docker的系统要求因操作系统而异.

  • 对于 Linux，您需要 64 位架构, 兼容的内核版本和特定的内核功能.

  • 在 Windows 上，在启用虚拟化的 Windows 10上使用 Docker Desktop

  • 在 macOS 上，请使用配备 macOS 10.13 或更新版本的Docker Desktop. 在硬件方面，建议至少配备 2GB 内存以及足够的 CPU 和磁盘空间.

注解

有关最新详情，请参阅 Docker 官方文档.

说明

  1. 在电脑上安装 Docker

在 Linux 上安装 Docker Desktop

此外，您还可以参考以下命令进行安装：

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh ./get-docker.sh
sudo usermod -aG docker $USER

在 Windows 上安装 Docker Desktop

  1. 创建文件夹 leaps_gateway_hub 和子文件夹 data。然后，在 leaps_gateway_hub/data 中添加 leaps-gateway.conf 配置文件。.

#######################################################################
# LEAPS Gateway settings
#

# -----------------------------------------------------------------
# Logging
# -----------------------------------------------------------------
log_level = 0 #  Logging level, default is 0 (0=none, 1=fatal, 2=error, 3=warning, 4=info, 5=debug, 6=verbose)

# Path to log file. Comment out to disable logging to file (log to stdio instead).
# log-file = leaps-gateway.log


# LEAPS Server host
# Default: localhost
leaps-server-host = localhost # Or your Computer's IP Address

# LEAPS Server port
# Default: 7777
leaps-server-port = 7777

# -----------------------------------------------------------------
# UWBS USB Device VID/PID
# -----------------------------------------------------------------
#

# Vendor ID, default is 0x1915, possible values are (0x1915-Nordic, 0x04d8-Microchip)
# Allowed values: 16-bit number in decimal, hexadecimal or octal format
# uwbs-usb-dev-vid = 0x04d8
uwbs-usb-dev-vid = 0x1915

# Product ID, default is 0xe8e3 for LEAPS RTLS devices
# Allowed values: 16-bit number in decimal, hexadecimal or octal format
uwbs-usb-dev-pid = 0xe8e3

# -----------------------------------------------------------------
# UWBS device configurations
# -----------------------------------------------------------------
#

# Bridge mode
# Allowed values: 0=Disable 1=Enable
# Default: (keep-current)
# uwbs-bridge = 0

# Initiator mode
# Allowed values: 0=Disable 1=Enable
# Default: (keep-current)
# uwbs-initiator = 0

# UWBMAC Profile ID
# Default: (keep-current)
# uwbs-profile-id = 0

# LEDs mode
# Allowed values: 0=Disable 1=Enable
# Default: (keep-current)
# uwbs-led = 1

# UWB encryption
# Allowed values: 0=Disable 1=Enable
# Default: (keep-current)
# uwbs-enc = 0

# UWB firmware update
# Allowed values: 0=Disable 1=Enable
# Default: (keep-current)
# uwbs-fwup = 0

# UWB mode
# Allowed values: 0=Off 1=Passive 2=Active
# Default: (keep-current)
# uwbs-uwb = 2

# UWB Backhaul Routing
# Allowed values: 0=Off 1=On 2=Auto
# Default: (keep-current)
uwbs-bh = 1

# BLE
# Allowed values: 0=Off 1=On
# Default: (keep-current)
# uwbs-ble = 1

# UWB encryption key
# Allowed values: 128-bit number in hexadecimal format
# Default: (keep-current)
# uwbs-enc-key = 11111111222222223333333344444444

# UWB network PANID
# Allowed values: 16-bit number in decimal, hexadecimal or octal format
# Default: (keep-current)
# uwbs-panid = 0x0000

# Device label
# Default: (keep-current)
# uwbs-label = gw-uwbs

# Device position in mm [x, y, z]
# Default: (keep-current)
# uwbs-pos-x = 0
# uwbs-pos-y = 0
# uwbs-pos-z = 0

  1. 在电脑上打开命令提示符或终端窗口.

  • 导航到创建配置文件的文件夹。

例如，在Ubuntu（Linux）上：

cd leaps_gateway_hub/

  1. 安装 LEAPS 网关 Docker 软件包并运行：

注解

LEAPS 网关需要使用USB端口。因此，用户需要以管理员权限运行才能在docker容器上挂载和使用USB。

sudo docker run -d -it --name some_name --privileged -v /dev/bus/usb:/dev/bus/usb -v /path/to/data/data/:/app/data/ leapslabs/leaps_gateway:tag /app/leaps_gateway --cfg /app/data/leaps_gateway.conf

其中 some_name 是您要分配给容器的名称，tag 指定您想要的 leaps-gateway 版本。

  • 推荐的运行选项

    • --user $(id -u):$(id -g) 在特定用户和组下运行实例.

    • --除非停止否则重新启动 自动重新启动实例，以防服务器崩溃。

  1. The LEAPS 网关安装过程将开始。

例如，在Ubuntu（Linux）上：

sudo docker run -d -it --name leaps_gateway --privileged -v /dev/bus/usb:/dev/bus/usb -v "$(pwd)"/data/:/app/data leapslabs/leaps_gateway:latest /app/leaps-gateway -c /app/data/leaps-gateway.conf

Unable to find image 'leapslabs/leaps_gateway:latest' locally
latest: Pulling from leapslabs/leaps_gateway
a458657ccc71: Pull complete
Digest: sha256:a19b127656d41d8607f043c2c83924e5b9a5cbd4dc23cfbed070be3b9cfc6b9a
Status: Downloaded newer image for leapslabs/leaps_gateway:latest
320d3768289874e063619f75faca7a24dd75a08884df8cd8fb2cc9b54c6f0a46

  1. 确认安装成功，运行：

例如，在Ubuntu（Linux）上：

sudo docker ps

CONTAINER ID   IMAGE                    COMMAND                  CREATED          STATUS                          PORTS     NAMES
b1145b72db35   leapslabs/leaps_gateway:latest   "sh -c 'cd /app &&  …"   37 seconds ago   11 seconds ago                           leaps_gateway

因此，您已在PC上成功安装并启动 LEAPS 网关 。

开始

LEAPS网关Docker

  • 启动LEAPS网关，运行: sudo docker Start LEAPS_Gateway

  • 停止LEAPS网关，运行: sudo docker Stop-LEAPS_Gateway

  • 重启LEAPS网关，运行: sudo docker Restart LEAPS_Gateway

  • 删除LEAPS网关，运行 sudo docker rm--force LEAPS_Gateway

网络配置

  • 记录

    # Logging level, default is 3 (0=none, 1=error, 2=warning, 3=info, 4=debug, 5=verbose).
log-level = 0

# Path to log file. Comment out to disable logging to file (log to stdio instead).
log-file = leaps-gateway.log

  • LEAPS服务器主机

    # Default: localhost
leaps-server-host = 192.168.1.1 # Your Computer's IP Address

# LEAPS Server port
# Default: 7777
leaps-server-port = 7777

  • UWBS USB设备VID/PID

    # Vendor ID, default is 0x1915, possible values are (0x1915-Nordic, 0x04d8-Microchip)
# Allowed values: 16-bit number in decimal, hexadecimal or octal format
# uwbs-usb-dev-vid = 0x04d8
uwbs-usb-dev-vid = 0x1915

# Product ID, default is 0xe8e3 for LEAPS RTLS devices
# Allowed values: 16-bit number in decimal, hexadecimal or octal format
uwbs-usb-dev-pid = 0xe8e3

  • UWBS设备配置

    # Bridge mode
# Allowed values: 0=Disable 1=Enable
# Default: (keep-current)
uwbs-bridge = 0

# Initiator mode
# Allowed values: 0=Disable 1=Enable
# Default: (keep-current)
uwbs-initiator = 0

# UWBMAC Profile ID
# Default: (keep-current)
uwbs-profile-id = 0

# LEDs mode
# Allowed values: 0=Disable 1=Enable
# Default: (keep-current)
uwbs-led = 1

# UWB encryption
# Allowed values: 0=Disable 1=Enable
# Default: (keep-current)
uwbs-enc = 0

# UWB firmware update
# Allowed values: 0=Disable 1=Enable
# Default: (keep-current)
uwbs-fwup = 0

# UWB mode
# Allowed values: 0=Off 1=Passive 2=Active
# Default: (keep-current)
uwbs-uwb = 2

# UWB Backhaul Routing
# Allowed values: 0=Off 1=On 2=Auto
# Default: (keep-current)
uwbs-bh = 1

# BLE
# Allowed values: 0=Off 1=On
# Default: (keep-current)
uwbs-ble = 1

# UWB encryption key
# Allowed values: 128-bit number in hexadecimal format
# Default: (keep-current)
uwbs-enc-key = 11111111222222223333333344444444

# UWB network PANID
# Allowed values: 16-bit number in decimal, hexadecimal or octal format
# Default: (keep-current)
uwbs-panid = 0x0000

# Device label
# Default: (keep-current)
uwbs-label = gw-uwbs

# Device position in mm [x, y, z]
# Default: (keep-current)
uwbs-pos-x = 0
uwbs-pos-y = 0
uwbs-pos-z = 0

故障排除

  • 使用以下命令 sudo docker restart leaps_gateway 重新启动LEAPS网关。

  • 在windows上，重复USB/IP连接WSL 2以连接USB设备。（usbipd wsl附加--busid<busid>）