• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# OpenThread CLI - Commissioning
2
3## Quick Start
4
5### Form Network
6
7Form a network with the device that has Commissioner support.
8
91. Generate and view new network configuration.
10
11   ```bash
12   > dataset init new
13   Done
14   > dataset
15   Active Timestamp: 1
16   Channel: 13
17   Channel Mask: 0x07fff800
18   Ext PAN ID: d63e8e3e495ebbc3
19   Mesh Local Prefix: fd3d:b50b:f96d:722d::/64
20   Network Key: dfd34f0f05cad978ec4e32b0413038ff
21   Network Name: OpenThread-8f28
22   PAN ID: 0x8f28
23   PSKc: c23a76e98f1a6483639b1ac1271e2e27
24   Security Policy: 0, onrc
25   Done
26   ```
27
282. Commit new dataset to the Active Operational Dataset in non-volatile storage.
29
30   ```bash
31   dataset commit active
32   Done
33   ```
34
353. Enable Thread interface
36
37   ```bash
38   > ifconfig up
39   Done
40   > thread start
41   Done
42   ```
43
44### Obtain Joiner IEEE EUI-64
45
461. Start the Joiner node and obtain the Joiner's IEEE EUI-64.
47
48   ```bash
49   > eui64
50   18b4300000000002
51   Done
52   ```
53
54### Start Commissioner
55
561. Start the Commissioner Role
57
58   ```bash
59   > commissioner start
60   Commissioner: petitioning
61   Done
62   Commissioner: active
63   ```
64
652. Add the Joiner with the device-specific pre-shared key (PSKd)
66
67   ```bash
68   > commissioner joiner add 18b4300000000002 J01NME
69   Done
70   ```
71
72### Start Joiner
73
741. Factory reset the device.
75
76   ```bash
77   > factoryreset
78   ```
79
802. Start the Joiner process.
81
82   ```bash
83   > ifconfig up
84   Done
85   > joiner start J01NME
86   Done
87   Join success
88   ```
89
903. Attach to Thread network
91
92   ```bash
93   > thread start
94   Done
95   ```
96
974. After successful attach, validate the device has the same Active Operational Dataset as above.
98
99   ```bash
100   > dataset active
101   Active Timestamp: 1
102   Channel: 13
103   Channel Mask: 0x07fff800
104   Ext PAN ID: d63e8e3e495ebbc3
105   Mesh Local Prefix: fd3d:b50b:f96d:722d::/64
106   Network Key: dfd34f0f05cad978ec4e32b0413038ff
107   Network Name: OpenThread-8f28
108   PAN ID: 0x8f28
109   PSKc: c23a76e98f1a6483639b1ac1271e2e27
110   Security Policy: 0, onrc
111   Done
112   ```
113
114## CLI Reference
115
116- [Commissioner CLI Reference](README_COMMISSIONER.md)
117- [Joiner CLI Reference](README_JOINER.md)
118