如何获取Z-Wave设备（如Zipato Bulb 2）可用命令的完整描述？

我完全理解你遇到的这种 frustration——买了设备却连基本的命令文档都拿不到，官方支持还不给力，确实头疼。针对Zipato Bulb 2这种情况，你可以试试下面这些方法来摸索它的支持命令：

• 先获取设备支持的命令类清单
  所有Z-Wave设备都会在入网时向控制器上报自己支持的命令类（Command Classes），你可以用Z-Wave框架的工具来提取这个信息：

  • 如果用OpenZWave，运行ozw_dump命令，找到对应节点的Command Classes section，这里会列出设备支持的所有命令类ID和名称（比如0x25是Switch Binary，0x26是Switch Multilevel）。
  • 如果用Z-Wave JS，在控制台执行node.getDefinedCommandClasses()（替换node为你的设备节点ID），会返回结构化的命令类列表。
    这一步是基础，至少能知道设备具备哪些功能大类。

• 测试对应命令类的标准命令
  Z-Wave的命令类是标准化的，每个命令类下的核心命令都是统一的。比如：

  • 对于Switch Multilevel（调光类，0x26），你可以尝试发送SwitchMultilevelSet命令，参数设为0-99的亮度值，或者SwitchMultilevelGet来获取当前亮度。
  • 对于Switch Binary（开关类，0x25），发送SwitchBinarySet，参数0xFF是开，0x00是关。
    具体发送命令的方式：
  • OpenZWave用ozw_send_command，格式类似ozw_send_command --node 12 --command SwitchMultilevelSet --args 50
  • Z-Wave JS用node.sendCommand({commandClass: 'switchMultilevel', command: 'set', args: [50]})
    发送后观察设备反应，或者看控制器的日志有没有收到设备的响应报告。

• 抓包/分析控制器日志
  开启控制器的调试日志，或者用Z-Wave USB stick的监听模式，捕捉设备和控制器之间的所有通信：

  • OpenZWave可以在配置文件中设置LogLevel=Debug，然后查看日志文件里的命令交互细节，比如设备主动上报的状态，或者控制器发送命令后设备的响应。
  • Z-Wave JS开启verbose日志，在控制台就能实时看到所有命令帧。
    比如当你用物理开关（如果有的话）控制灯泡时，设备会向控制器发送状态报告，从这些报告里就能反推设备支持的上报命令，进而知道对应的控制命令。

• 尝试扫描配置参数
  几乎所有Z-Wave设备都支持Configuration Command Class（0x70），用来调整设备的行为。你可以尝试扫描参数范围：

  • 发送ConfigurationGet命令，参数从1开始，逐步增加（比如1到50），每个参数尝试不同的大小（1字节、2字节），看设备是否返回参数值。
  • 找到存在的参数后，尝试设置不同的值（比如参数1设为1或2），观察设备的变化，比如亮度渐变速度、色温调整（如果灯泡支持的话）。
    这一步能发现很多文档没提到的自定义功能。

• 参考同类型设备的命令集
  Zipato Bulb 2是调光LED灯泡，这类设备的Z-Wave命令集高度标准化，和其他品牌的调光灯泡（比如Aeotec LED Bulb、Philips Hue Z-Wave Bulb）的命令重叠度很高。你可以找这些同类型设备的公开文档，直接测试里面的命令，大概率能在Zipato Bulb 2上生效。

• 社区求助
  去Home Automation相关的社区发帖，详细说明你的设备型号、已经探测到的命令类，以及你测试过的命令和结果。很多用过同款设备的用户会分享自己的摸索经验，甚至整理好的命令清单。

内容的提问来源于stack exchange，提问作者nowox