ember-zli

中文文档
6.1.0发布于 2026/11/03GPL-3.0-or-laterTypeScriptES Module构建来源已验证

Interact with EmberZNet-based adapters using zigbee-herdsman 'ember' driver

原始使用文档
文档目录9 节
  1. Available Interactive Menus
  2. ember-zli bootloader
  3. ember-zli help [COMMAND]
  4. ember-zli monitor
  5. ember-zli router
  6. ember-zli sniff
  7. ember-zli stack
  8. ember-zli utils
  9. ember-zli version

Ember ZLI

Interact with EmberZNet-based adapters using zigbee-herdsman 'ember' driver. Also supports bootloading to/from CPC and Spinel protocols.

oclif Version Downloads ci

[!IMPORTANT] ember-zli uses the ember driver from zigbee-herdsman under the hood. As such, it roughly has the same firmware requirements as Zigbee2MQTT ember; firmware 7.4.x minimum.

Available Interactive Menus

See https://github.com/Nerivec/ember-zli/wiki

ToC

Usage

$ npm install -g ember-zli
$ ember-zli COMMAND
running command...
$ ember-zli (--version)
ember-zli/6.1.0 linux-x64 node-v24.22.1
$ ember-zli --help [COMMAND]
USAGE
  $ ember-zli COMMAND
...

Commands

ember-zli bootloader

Interact with the Gecko bootloader in the adapter.

USAGE
  $ ember-zli bootloader

DESCRIPTION
  Interact with the Gecko bootloader in the adapter.

EXAMPLES
  $ ember-zli bootloader

See code: src/commands/bootloader/index.ts

ember-zli help [COMMAND]

Display help for ember-zli.

USAGE
  $ ember-zli help [COMMAND...] [-n]

ARGUMENTS
  [COMMAND...]  Command to show help for.

FLAGS
  -n, --nested-commands  Include all nested commands in the output.

DESCRIPTION
  Display help for ember-zli.

See code: @oclif/plugin-help

ember-zli monitor

Monitor the chosen port in the console.

USAGE
  $ ember-zli monitor

DESCRIPTION
  Monitor the chosen port in the console.

EXAMPLES
  $ ember-zli monitor

See code: src/commands/monitor/index.ts

ember-zli router

Use a coordinator firmware as a router and interact with the joined network.

USAGE
  $ ember-zli router

DESCRIPTION
  Use a coordinator firmware as a router and interact with the joined network.

EXAMPLES
  $ ember-zli router

See code: src/commands/router/index.ts

ember-zli sniff

Sniff Zigbee traffic (to Wireshark, to PCAP file, to custom handler or just log raw data).

USAGE
  $ ember-zli sniff

DESCRIPTION
  Sniff Zigbee traffic (to Wireshark, to PCAP file, to custom handler or just log raw data).

EXAMPLES
  $ ember-zli sniff

See code: src/commands/sniff/index.ts

ember-zli stack

Interact with the EmberZNet stack in the adapter.

USAGE
  $ ember-zli stack

DESCRIPTION
  Interact with the EmberZNet stack in the adapter.

EXAMPLES
  $ ember-zli stack

See code: src/commands/stack/index.ts

ember-zli utils

Execute various utility commands.

USAGE
  $ ember-zli utils

DESCRIPTION
  Execute various utility commands.

EXAMPLES
  $ ember-zli utils

See code: src/commands/utils/index.ts

ember-zli version

USAGE
  $ ember-zli version [--json] [--verbose]

FLAGS
  --verbose  Show additional information about the CLI.

GLOBAL FLAGS
  --json  Format output as json.

FLAG DESCRIPTIONS
  --verbose  Show additional information about the CLI.

    Additionally shows the architecture, node version, operating system, and versions of plugins that the CLI is using.

See code: @oclif/plugin-version

版本与发布记录

ember-zli 共发布 64 个版本,首次发布于 2024/05/21;过去 12 个月发布了 15 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
6.1.0latest2026/11/03今天
6.0.22026/10/1420 天前
6.0.12026/10/0826 天前
6.0.02026/10/0727 天前
5.0.02026/09/071 个月前
4.2.32026/06/294 个月前

关于 ember-zli 的常见问题

ember-zli 是什么?

使用zigbee-herdsman ‘ember’驱动程序与基于emberznet的适配器交互

如何安装 ember-zli?

在项目目录运行 npm install ember-zli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ember-zli,可以用 npx ember-zli 直接运行。

ember-zli 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

ember-zli 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

ember-zli 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js ^22.22.0 || ^24.12.0 || <=26.2.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

ember-zli 可以商用吗?

ember-zli 使用 GPL-3.0-or-later 许可。强 Copyleft:分发包含该代码的软件时,整个作品需以 GPL-3.0 兼容许可开源,并附带专利与反锁定条款。仅内部使用不触发此义务。以上为概括,不构成法律意见,请以许可原文为准。

ember-zli 还在维护吗?

最新版本 6.1.0 发布于 2026/11/03(今天);至今共发布 64 个版本,其中过去 12 个月发布了 15 个;首次发布于 2024/05/21。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。