Skip to content

Commit 17b5e9f

Browse files
author
Kari Severinkangas
committed
Minor additions
1 parent 8e35ade commit 17b5e9f

File tree

2 files changed

+9
-1
lines changed

2 files changed

+9
-1
lines changed

docs/tutorials/using_apis/mesh/thread_commissioning.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,8 @@ To get the MAC address for your end device, connect the node to the Thread netwo
4444

4545
For example, in the **mesh-minimal** application, place this `printf("MAC address = %s\n", mesh.get_mac_address());` after `printf("connected. IP = %s\n", mesh.get_ip_address());`
4646

47+
It is also possible to use mesh-api (ThreadInterface.h) to set values for these parameters.
48+
4749
There are four additional (optional) query parameters you can put into this field:
4850

4951
- `vn` Vendor name.
@@ -55,6 +57,9 @@ Once you have completed the details, proceed to generate the QR code for your en
5557

5658
#### Using the Thread commissioning application
5759

60+
When building a Thread example application do not change any of the PSKc related parameters (network name, extended PAN ID or PSKc). PSKc has been pre-calculated for the application. The nanostack has no capability to generate PSKc on runtime.
61+
62+
5863
You can use the [Thread Android application](https://play.google.com/store/apps/details?id=org.threadgroup.commissioner) for commissioning. Download and install this on your Android device, turn on Wi-Fi and start the app. Then follow these steps after ensuring all the requirements listed above are satisfied:
5964

6065
1. Set up a connection to the Wi-Fi access point to which the Thread border router is connected. When connected, the application lists your Thread border router(s).

docs/tutorials/using_apis/mesh/thread_intro.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,7 @@ Nanostack provides a set of C API headers with more functionalities. The [nanost
4444
- `thread_diagcop_lib.h` for building and parsing the Thread diagnostics protocol TLV messages.
4545
- `thread_meshcop_lib.h` for building and parsing the Thread mesh commissioning protocol TLV messages.
4646
- `thread_net_config_api.h` for making neighbour discovery (ND) data requests.
47+
- `net_polling_api.h` for configuring the Thread node's sleep mode and polling interval.
4748

4849
#### Thread devices you can build on Mbed OS
4950

@@ -55,7 +56,7 @@ The Mbed OS Mesh API allows you to define 3 types of devices:
5556

5657
In addition the Nanostack API allows you to define the Full end device (FED) device type.
5758

58-
In most cases, the REED, MED and SED configurations are enough to build a network. In a SED device, the radio is switched off during the sleep times. To take the full advantage of the SED configuration, the application developer must implement the sleep procedures in the device.
59+
In most cases, the REED, MED and SED configurations are enough to build a network. The SED device can be configured to use sleep mode, in which case the radio is switched off between the polling times. To take the full advantage of the SED configuration, the application developer must implement the sleep procedures in the device.
5960

6061
For an end device or a router example, see [mesh minimal example](https://github.com/ARMmbed/mbed-os-example-mesh-minimal).
6162

@@ -122,6 +123,8 @@ The Thread network name and the extended PAN ID are received in the scanning pha
122123

123124
After the authentication phase, the commissioner requests the Thread network leader to petition the commissioner to become an authorized commissioner. Here, the border router works as an arbitrator in the middle.
124125

126+
The PSKc generation is described in the Thread specification.
127+
125128
Now, the Thread network is ready to accept new joiner devices.
126129

127130
1. The commissioner application scans the QR code, which is PSKd (Pre-Shared Key for device) + EUI64, from the device's label and informs the Thread network that this device is accepted to the network.

0 commit comments

Comments
 (0)