chip-tool pairing 命令的解析

chip-tool pairing 命令是 Matter 设备与 Commissioner 配对过程中的一个关键工具。可以使用它来启动配对、进行设备认证、获取设备信息等。

以下是命令的详细列表：

---

常见的配对命令

1. unpair

• 用途：用于解除设备与 Commissioner 的配对。
• 示例：

 ./chip-tool pairing unpair <node-id>

2. code

• 用途：通过 PIN 码进行设备配对。通常设备和 Commissioner 使用共享的 PIN 码进行配对。
• 示例：

 ./chip-tool pairing code <node-id> <payloade>

3. code-paseonly

• 用途：仅使用 PASE（Pairing and Secure Establishment）协议配对设备，不涉及其他配置。
• 示例：

 ./chip-tool pairing code-paseonly <node-id> <payloade>

4. code-wifi

• 用途：使用 Wi-Fi 配对设备，通常涉及 Wi-Fi 网络的配置。
• 示例：

 ./chip-tool pairing code-wifi <node-id> <ssid> <password> <payload>

5. code-thread

• 用途：使用 Thread 配对设备，适用于 Thread 网络。
• 示例：

 ./chip-tool pairing code-thread <node-id> <operationalDataset> <payload>

6. code-wifi-thread

• 用途：设备同时连接 Wi-Fi 和 Thread 网络，适用于双网络配置的设备。
• 示例：

 ./chip-tool pairing code-wifi-thread <node-id>  <ssid>   <password>   <operationalDataset>   <payload> 

7. ble-wifi

• 用途：使用蓝牙低功耗（BLE）通过 Wi-Fi 配对设备。
• 示例：

 ./chip-tool pairing ble-wifi <node-id> <setup-pin-code> <wifi-ssid> <wifi-password>

8. ble-thread

• 用途：使用蓝牙低功耗（BLE）通过 Thread 配对设备。
• 示例：

 ./chip-tool pairing ble-thread <node-id> <operationalDataset> <setup-pin-code> <discriminator>

9. softap

• 用途：设备使用 SoftAP（软件接入点）进行配对。这通常适用于无网络的设备，设备创建一个 Wi-Fi 热点，Commissioner 通过此热网进行配对。
• 示例：

 ./chip-tool pairing softap <node-id> <ssid> <password> <setup-pin-code> <discriminator> <device-remote-ip> <device-remote-port>

10. wifipaf-wifi

• 用途：通过 Wi-Fi 连接配对设备，适用于 Wi-Fi PAF（Private Access Facility）场景。
• 示例：

./chip-tool pairing wifipaf-wifi node-id ssid password setup-pin-code discriminator

---

设备发现命令

11. already-discovered

• 用途：已经发现设备时，直接进行配对。适用于设备已经通过某些方式被发现，但尚未进行配对的情况。
• 示例：

./chip-tool pairing already-discovered node-id setup-pin-code device-remote-ip device-remote-por

12. already-discovered-by-index

• 用途：通过设备的索引来进行配对。适用于设备已被发现并按索引排列。
• 示例：

./chip-tool pairing already-discovered-by-index node-id setup-pin-code index

13. already-discovered-by-index-with-wifi

• 用途：通过设备索引，并配置 Wi-Fi 信息进行配对。
• 示例：

./chip-tool pairing already-discovered-by-index-with-wifi node-id ssid password setup-pin-code index

14. already-discovered-by-index-with-code

• 用途：通过设备索引，并使用 PIN 码进行配对。
• 示例：

./chip-tool pairing already-discovered-by-index-with-code node-id payload index

---

网络配对命令

15. onnetwork

• 用途：通过网络进行配对，通常适用于通过现有网络（如 Wi-Fi 或 Thread）进行配对的设备。
• 示例：

./chip-tool pairing onnetwork node-id setup-pin-code

16. onnetwork-short

• 用途：简化的网络配对命令，适用于短时配对。
• 示例：

./chip-tool pairing onnetwork-short node-id setup-pin-code discriminator

17. onnetwork-long

• 用途：扩展的网络配对命令，适用于长时间配对。
• 示例：

./chip-tool pairing onnetwork-long node-id setup-pin-code discriminator

18. onnetwork-vendor

• 用途：针对厂商特定的配对网络配置。
• 示例：

./chip-tool pairing onnetwork-vendor node-id setup-pin-code vendor-id

19. onnetwork-commissioning-mode

• 用途：以特定的 Commissioning 模式进行网络配对。
• 示例：

./chip-tool pairing onnetwork-commissioning-mode node-id setup-pin-code

20. onnetwork-commissioner

• 用途：作为 Commissioner 角色进行网络配对。
• 示例：

./chip-tool pairing onnetwork-commissioner node-id setup-pin-code

21. onnetwork-device-type

• 用途：指定设备类型的网络配对。
• 示例：

./chip-tool pairing onnetwork-device-type node-id setup-pin-code device-type

22. onnetwork-instance-name

• 用途：指定设备实例名称进行网络配对。
• 示例：

./chip-tool pairing onnetwork-instance-name node-id setup-pin-code name 

---

高级操作命令

23. start-udc-server

• 用途：启动 UDC 服务器。UDC（Universal Device Certificate）是一种用于设备认证的技术。
• 示例：

 ./chip-tool pairing start-udc-server

24. open-commissioning-window

• 用途：打开设备的配网窗口，等待 Commissioner 配网。
• 示例：

 ./chip-tool pairing open-commissioning-window node-id option window-timeout iteration discriminator

25. get-commissioner-node-id

• 用途：获取 Commissioner 节点 ID。通常用于确认 Commissioner 的身份。
• 示例：

 ./chip-tool pairing get-commissioner-node-id

26. get-commissioner-root-certificate

• 用途：获取 Commissioner 的根证书。返回的是 base64 编码的证书数据。
• 示例：

 ./chip-tool pairing get-commissioner-root-certificate

27. issue-noc-chain

• 用途：生成并返回 NOC（Network Operational Certificate）链。通常用于生成设备的网络操作证书。
• 示例：

 ./chip-tool pairing issue-noc-chain <node-id>

---

总结

• chip-tool pairing 提供了多种设备配对方式，支持 Wi-Fi、Thread、BLE 等多种连接方式。
• 配对方式可以根据 网络类型、设备类型 或 Commissioning 模式 进行定制。
• 高级功能如 打开配网窗口、获取 Commissioner 信息、生成证书 也通过该命令进行管理。