Skip to content

Commit fa337c9

Browse files
committed
[primer] rename Router/REED to Active/Standby Mesh Extender
Update the Thread Primer documentation to transition terminology from Router and Router Eligible End Device (REED) to Active Mesh Extender and Standby Mesh Extender, respectively. - Rename "Router" to "Active Mesh Extender" (or "Mesh Extender" where referring generally to the device capability). - Rename REED (Router Eligible End Device) to Standby Mesh Extender. - Rename "Router-Router links" to "Active Mesh Extender links". - Adjust roles, device types, addressing, and MLE attach descriptions to use the new terminology. - Fix grammatical errors (e.g., "a Active" to "an Active") and typos introduced during the transition.
1 parent b4b0788 commit fa337c9

7 files changed

Lines changed: 189 additions & 177 deletions

File tree

181 KB
Loading
125 KB
Loading
199 KB
Loading

site/en/guides/thread-primer/ipv6-addressing.md

Lines changed: 24 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -34,20 +34,22 @@ location in the network topology.
3434

3535
### How a Routing Locator is generated
3636

37-
All devices are assigned a Router ID and a Child ID. Each Router maintains a
38-
table of all their Children, the combination of which uniquely identifies a
39-
device within the topology. For example, consider the highlighted nodes in the
40-
following topology, where the number in a Router (pentagon) is the Router ID,
41-
and the number in an End Device (circle) is the Child ID:
37+
All devices are assigned a Router ID and a Child ID. Each Parent
38+
maintains a table of all their Children, the combination of which
39+
uniquely identifies a device within the topology. For example,
40+
consider the highlighted nodes in the following topology, where the
41+
number in a Parent (pentagon) is the Router ID, and the number in an
42+
End Device (circle) is the Child ID:
4243

4344
<figure>
4445
<a href="../images/ot-primer-rloc-topology_2x.png"><img src="../images/ot-primer-rloc-topology.png" srcset="../images/ot-primer-rloc-topology.png 1x, ../images/ot-primer-rloc-topology_2x.png 2x" border="0" width="600" alt="OT RLOC Topology" /></a>
4546
</figure>
4647

47-
Each Child's Router ID corresponds to their Parent (Router). Because a Router is
48-
not a Child, the Child ID for a Router is always 0. Together, these values are
49-
unique for each device in the Thread network, and are used to create the RLOC16,
50-
which represents the last 16 bits of the RLOC.
48+
Each Child's Router ID corresponds to its Parent (Active Mesh
49+
Extender). Because an Active Mesh Extender is not a Child, the Child ID for an
50+
Active Mesh Extender is always 0. Together, these values are unique for each
51+
device in the Thread network, and are used to create the RLOC16, which
52+
represents the last 16 bits of the RLOC.
5153

5254
For example, here's how the RLOC16 is calculated for the upper-left node (Router
5355
ID = 1 and Child ID = 1):
@@ -81,9 +83,10 @@ This same logic can be used to determine the RLOC for all highlighted nodes in t
8183
However, because the RLOC is based on the location of the node in the topology,
8284
the RLOC of a node can change as the topology changes.
8385

84-
For example, perhaps node `0x400` is removed from the Thread network. Nodes
85-
`0x401` and `0x402` establish new links to different Routers, and as a result
86-
they are each assigned a new RLOC16 and RLOC:
86+
For example, perhaps node `0x400` is removed from the Thread
87+
network. Nodes `0x401` and `0x402` establish new links to different
88+
Mesh Extenders, and as a result they are each assigned a new RLOC16
89+
and RLOC:
8790

8891
<figure>
8992
<a href="../images/ot-primer-rloc-topology-change_2x.png"><img src="../images/ot-primer-rloc-topology-change.png" srcset="../images/ot-primer-rloc-topology-change.png 1x, ../images/ot-primer-rloc-topology-change_2x.png 2x" border="0" width="600" alt="OT Topology after Change" /></a>
@@ -272,7 +275,7 @@ What you've learned:
272275
* A Thread device has multiple unicast IPv6 addresses
273276
* An RLOC represents a device's location in the Thread network
274277
* An ML-EID is unique to a Thread device within a partition and should be used by applications
275-
* Thread uses multicast to forward data to groups of nodes and routers
278+
* Thread uses multicast to forward data to groups of nodes
276279
* Thread uses anycast when the RLOC of a destination is unknown
277280

278281
To learn more about Thread's IPv6 addressing, see sections 5.2 and 5.3 of the
@@ -319,12 +322,12 @@ To learn more about Thread's IPv6 addressing, see sections 5.2 and 5.3 of the
319322
<div>Incorrect.</div>
320323
</div>
321324
<div>
322-
<div>The device is a REED.</div>
325+
<div>The device is a Standby Mesh Extender.</div>
323326
<div>Close, but incorrect.</div>
324327
</div>
325328
<div correct>
326-
<div>The device is a Router.</div>
327-
<div>Correct. A Router always has a Child ID of 0.</div>
329+
<div>The device is an Active Mesh Extender.</div>
330+
<div>Correct. An Active Mesh Extender always has a Child ID of 0.</div>
328331
</div>
329332
</devsite-multiple-choice>
330333
</div>
@@ -339,10 +342,10 @@ To learn more about Thread's IPv6 addressing, see sections 5.2 and 5.3 of the
339342
network.</div>
340343
</div>
341344
<div correct>
342-
<div>A router dropped off the network.</div>
343-
<div>Correct. When a router drops off a network, the network
344-
topology changes, which may result in the device promoting itself to a
345-
router and obtaining a new RLOC.</div>
345+
<div>An Active Mesh Extender dropped off the network.</div>
346+
<div>Correct. When an Active Mesh Extender drops off a network, the network
347+
topology changes, which may result in the device promoting itself to an
348+
Active Mesh Extender and obtaining a new RLOC.</div>
346349
</div>
347350
<div>
348351
<div>The camera entered sleep mode, which changed the network topology.
@@ -381,7 +384,7 @@ To learn more about Thread's IPv6 addressing, see sections 5.2 and 5.3 of the
381384
<div>
382385
<devsite-multiple-choice>
383386
<div>What type of addressing and routing does Thread use to forward data to
384-
groups of nodes and routers?</div>
387+
groups of nodes?</div>
385388
<div>
386389
<div>unicast</div>
387390
<div>Incorrect.</div>

site/en/guides/thread-primer/network-discovery.md

Lines changed: 34 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -24,9 +24,8 @@ When creating a new Thread network, or searching for an existing one to join, a
2424
Thread device performs an active scan for 802.15.4 networks within radio range:
2525

2626
1. The device broadcasts an 802.15.4 Beacon Request on a specific Channel.
27-
1. In return, any Routers or Router Eligible End Devices (REEDs) in range
28-
broadcast a Beacon that contains their Thread network PAN ID, XPAN ID, and
29-
Network Name.
27+
1. In return, any Mesh Extenders in range broadcast a Beacon that contains
28+
their Thread network PAN ID, XPAN ID, and Network Name.
3029
1. The device repeats the previous two steps for each Channel.
3130

3231
Once a Thread device has discovered all networks in range, it can either attach
@@ -62,11 +61,12 @@ device has already been commissioned.
6261

6362
## Create a new network
6463

65-
If the device elects to create a new network, it selects the least busy Channel
66-
and a PAN ID not in use by other networks, then becomes a Router and elects
67-
itself the Leader. This device sends MLE Advertisement messages to other
68-
802.15.4 devices to inform them of its link state, and responds to Beacon
69-
Requests by other Thread devices performing an active scan.
64+
If the device elects to create a new network, it selects the least
65+
busy Channel and a PAN ID not in use by other networks, then becomes
66+
an Active Mesh Extender and elects itself the Leader. This device
67+
sends MLE Advertisement messages to other 802.15.4 devices to inform
68+
them of its link state, and responds to Beacon Requests by other
69+
Thread devices performing an active scan.
7070

7171
## Join an existing network
7272

@@ -75,13 +75,13 @@ ID, XPAN ID, and Network Name to match that of the target network via Thread
7575
Commissioning, then goes through the MLE Attach process to attach as a Child
7676
(End Device). This process is used for Child-Parent links.
7777

78-
Key Point: Every device, router-capable or not, initially attaches to a Thread
78+
Key Point: Every device, Mesh Extender or not, initially attaches to a Thread
7979
network as a Child (End Device).
8080

8181
1. The Child sends a multicast [Parent Request](#1_parent_request) to all
82-
neighboring Routers and REEDs in the target network.
83-
1. All neighboring Routers and REEDs (if the Parent Request Scan Mask includes
84-
REEDs) send [Parent Responses](#2_parent_response) with information about
82+
neighboring Mesh Extenders in the target network.
83+
1. All neighboring Mesh Extenders (if the Parent Request Scan Mask includes
84+
Standby Mesh Extenders) send [Parent Responses](#2_parent_response) with information about
8585
themselves.
8686
1. The Child chooses a Parent device and sends a [Child ID
8787
Request](#3_child_id_request) to it.
@@ -91,8 +91,7 @@ network as a Child (End Device).
9191
### 1. Parent Request
9292

9393
A Parent Request is a multicast request from the attaching device that is used
94-
to discover neighboring Routers and Router Eligible End Devices (REEDs) in the
95-
target network.
94+
to discover neighboring Mesh Extenders in the target network.
9695

9796
<figure>
9897
<a href="../images/ot-primer-network-mle-attach-01.png"><img src="../images/ot-primer-network-mle-attach-01.png" width="350" border="0" alt="OT MLE Attach Parent Request" /></a>
@@ -113,15 +112,15 @@ target network.
113112
</tr>
114113
<tr>
115114
<td width="25%"><b>Scan Mask</b></td>
116-
<td>Limits the request to only Routers or to both Routers and REEDs</td>
115+
<td>Limits the request to only Active Mesh Extenders or to all Mesh Extenders</td>
117116
</tr>
118117
</tbody>
119118
</table>
120119

121120
### 2. Parent Response
122121

123122
A Parent Response is a unicast response to a Parent Request that provides
124-
information about a Router or REED to the attaching device.
123+
information about a Mesh Extender to the attaching device.
125124

126125
<figure>
127126
<a href="../images/ot-primer-network-mle-attach-02.png"><img src="../images/ot-primer-network-mle-attach-02.png" width="350" border="0" alt="OT MLE Attach Parent Response" /></a>
@@ -143,31 +142,31 @@ information about a Router or REED to the attaching device.
143142
<tr>
144143
<td width="25%"><b>Link Frame
145144
Counter</b></td>
146-
<td>802.15.4 Frame Counter on the Router/REED</td>
145+
<td>802.15.4 Frame Counter on the Mesh Extender</td>
147146
</tr>
148147
<tr>
149148
<td width="25%"><b>MLE Frame
150149
Counter</b></td>
151-
<td>MLE Frame Counter on the Router/REED</td>
150+
<td>MLE Frame Counter on the Mesh Extender</td>
152151
</tr>
153152
<tr>
154153
<td width="25%"><b>Source
155154
Address</b></td>
156-
<td>RLOC16 of the Router/REED</td>
155+
<td>RLOC16 of the Mesh Extender</td>
157156
</tr>
158157
<tr>
159158
<td width="25%"><b>Link
160159
Margin</b></td>
161-
<td>Receive signal quality of the Router/REED</td>
160+
<td>Receive signal quality of the Mesh Extender</td>
162161
</tr>
163162
<tr>
164163
<td width="25%"><b>Connectivity</b></td>
165-
<td>Describes the Router/REED’s level of connectivity</td>
164+
<td>Describes the Mesh Extender’s level of connectivity</td>
166165
</tr>
167166
<tr>
168167
<td width="25%"><b>Leader
169168
Data</b></td>
170-
<td>Information about the Router/REED’s Leader</td>
169+
<td>Information about the Mesh Extender’s Leader</td>
171170
</tr>
172171
<tr>
173172
<td width="25%"><b>Challenge</b></td>
@@ -179,11 +178,11 @@ information about a Router or REED to the attaching device.
179178

180179
### 3. Child ID Request
181180

182-
A Child ID Request is a unicast request from the attaching device (Child) that
183-
is sent to the Router or REED (Parent) for the purpose of establishing a
184-
Child-Parent link. If the request is sent to a REED, it [upgrades itself to a
185-
Router](router-selection.md) before
186-
accepting the request.
181+
A Child ID Request is a unicast request from the attaching device
182+
(Child) that is sent to the Mesh Extender for the purpose of
183+
establishing a Child-Parent link. If the request is sent to a Standby
184+
Mesh Extender, it [upgrades itself to an Active Mesh
185+
Extender](router-selection.md) before accepting the request.
187186

188187
<figure>
189188
<a href="../images/ot-primer-network-mle-attach-03.png"><img src="../images/ot-primer-network-mle-attach-03.png" width="350" border="0" alt="OT MLE Attach Child ID Request" /></a>
@@ -264,7 +263,7 @@ Child to confirm that a Child-Parent link has been established.
264263
</tr>
265264
<tr>
266265
<td width="25%"><b>Route
267-
(REED only)</b></td>
266+
(to FTDs only)</b></td>
268267
<td>Route propagation</td>
269268
</tr>
270269
<tr>
@@ -323,19 +322,18 @@ What you've learned:
323322
<devsite-multiple-choice>
324323
<div>What is a Parent Request used for?</div>
325324
<div correct>
326-
<div>To discover neighboring Routers and Router Eligible End Devices
327-
(REEDs) in the target network.</div>
325+
<div>To discover neighboring Mesh Extenders in the target network.</div>
328326
<div>Correct. A Parent Request is issued by a device seeking to attach to
329327
a network.</div>
330328
</div>
331329
<div>
332-
<div>To announce that a Router is becoming a parent.</div>
333-
<div>Incorrect. A Router does not initiate a Parent-Child relationship
334-
with another network device. Instead, a network device selects a Router
335-
to become its Child.</div>
330+
<div>To announce that a Mesh Extender is becoming a parent.</div>
331+
<div>Incorrect. A Parent does not initiate a Parent-Child relationship
332+
with another network device. Instead, a network device selects a Mesh Extender
333+
to become its Parent.</div>
336334
</div>
337335
<div>
338-
<div>To request that a Router Eligible End Device be promoted to a Router.
336+
<div>To request that a Standby Mesh Extender be promoted to an Active Mesh Extender.
339337
</div>
340338
<div>Incorrect.</div>
341339
</div>
@@ -378,7 +376,7 @@ What you've learned:
378376
<div>Incorrect.</div>
379377
</div>
380378
<div>
381-
<div>REED (Router-Eligible End Device) </div>
379+
<div>Active Mesh Extender</div>
382380
<div>Incorrect.</div>
383381
</div>
384382
</devsite-multiple-choice>

0 commit comments

Comments
 (0)