Noah UWB CLI

快速开始

环境要求

• Node.js >= 18

安装

git clone https://github.com/Dspecial/noah-uwb-cli.git
cd noah-uwb-cli
npm install
npm link

After npm link, the uwb command will be available globally in your terminal.

配置

# 配置API baseUrl
uwb setbaseurl

示例：

uwb setbaseurl 'http://localhost:8002/api/uwb'

命令参考

概览

uwb <command> [options]

Commands:
  setbaseurl <url>                  重置  ~/.uwb-cli/config.json 文件中的 baseUrl
  detail [options] <device_id>      UWB 设备信息查询
  control <device_id> <properties>  设置设备属性
  restart [options] <device_id>     重启设备

Global Options:
  -V, --version                     显示版本号
  -h, --help                        显示帮助信息

所有查询命令均支持 --json 选项，输出原始 JSON 数据，便于脚本集成。

uwb detail -- 设备详情

# uwb设备详情
uwb detail <device_id>

示例：

$ uwb detail 192.168.12.212:69

✔ 192.168.12.212:69 设备信息获取成功
  - 本地IP      :  192.168.12.212
  - 本地端口    :  03000
  - 上位机IP    :  192.168.12.111
  - 上位机端口  :  08888
  - 网关IP      :  192.168.12.1
  - 子网掩码    :  255.255.255.0
  - MAC地址     :  80.19.04.25.00.BD
  - UWB基站版本 :  3000.v1.3.58_v20240528
  - UWB基站信息 :  0001.30005100D4938FAC.0002.0001.192.168.012.212.03000.80.19.04.25.00.BD
  - UWB基站时间 :  2020.12.12.12.23.17

uwb control -- 设置设备

# 设置设备
uwb control <device_id> '<properties_json>'

示例：

# 设置设备的上位机ip
uwb control 192.168.12.212:69 '{"upip":"192.168.12.111"}'

# 设置设备的上位机端口
uwb control 192.168.12.212:69 '{"upport":"8888"}'

# 重置设备的MAC地址为初始值
uwb control 192.168.12.212:69 '{"mac":true}'

# 多个设置
uwb control 192.168.12.212:69 '{"upip":"192.168.12.111","upport":"8888","mac":true}'

uwb restart -- 设备重启

uwb restart <device_id>

示例：

# 重启
uwb restart 192.168.12.212:69

JSON 输出

所有查询命令均支持 --json 参数，输出机器可读的 JSON 格式：

# 获取原始 JSON 用于脚本处理
uwb detail 192.168.12.212:69 --json

# 保存到文件
uwb detail 192.168.12.212:69 --json > info.json

项目结构

noah-uwb-cli/
├── bin/uwb.js                  # CLI 入口文件
├── package.json                # npm package 安装包
├── src/
│   ├── index.js                # 主程序，注册所有命令
│   ├── api.js                  # UWB API 服务
│   ├── config.js               # Config
│   ├── commands/
│   │   ├── control.js          # 设备设置
│   │   ├── detail.js           # 设备详情
│   │   ├── restart.js          # 设备重启
│   │   ├── setbaseurl.js       # apiUrl 设置
│   └── utils/
│       └── output.js           # 表格/颜色/旋转器格式

License

MIT