Skip to content

Commit 977da71

Browse files
committed
nrf_802154: doc: Update mpsl documentation
Add information about multiprotocol timings Signed-off-by: Dawid Przybylo <[email protected]>
1 parent fcd90f9 commit 977da71

File tree

2 files changed

+152
-0
lines changed

2 files changed

+152
-0
lines changed

nrf_802154/doc/multiprotocol_support.rst

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -75,6 +75,13 @@ Because of the nature of the Bluetooth Low Energy protocol (TDMA), the Bluetooth
7575
Dropped packets are common in wireless networks, and IEEE 802.15.4 based protocols are usually resilient to that.
7676
To mitigate the number of packets lost on IEEE 802.15.4 based protocol, prolong the timing parameters for Bluetooth Low Energy, such as the advertising interval or the connection interval.
7777

78+
.. _rd_multiprotocol_support_measurements:
79+
80+
Multiprotocol measurements
81+
==========================
82+
83+
.. include:: multiprotocol_switching_tables.rst
84+
7885
.. _rd_multiprotocol_support_hf_clock:
7986

8087
Handling high-frequency clock
Lines changed: 145 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,145 @@
1+
:orphan:
2+
3+
Disclaimer
4+
----------
5+
.. note::
6+
The following data and tables are provided for informational purposes only, do not constitute requirements,
7+
and were obtained from measurements on Nordic DK development kits.
8+
9+
10+
Protocol and Radio Transition Measurements
11+
------------------------------------------
12+
13+
The following measurement utilizes the nRF21540 Front-End Module (FEM) connected to a Nordic SoC, which provides
14+
essential timing data via GPIO pins. The RX_EN pin manages the Low-Noise Amplifier (LNA) function of the
15+
FEM. When RX_EN is low (deactivated), the LNA is disabled, signaling that receive operations are ending or the
16+
radio is being deactivated at the conclusion of a time slot. Additionally, the PDN signal indicates when the
17+
module is fully powered down or powered up during protocol transitions.
18+
19+
During protocol transitions, two distinct timing metrics are measured:
20+
21+
802.15.4 to BLE Transitions:
22+
Radio Switching Time:
23+
- Start: RX_EN (LNA) pin deactivation (802.15.4 radio turning off on the end of 802.15.4 activity)
24+
- End: READY pin activation for BLE operation (ble radio turned on and ready)
25+
- Measures how quickly the radio hardware switches modes
26+
27+
Protocol Switching Time:
28+
- Start: First PDN event marking the end of 802.15.4 activity
29+
- End: Second PDN event marking the start of BLE activity
30+
- Captures the full protocol stack transition overhead
31+
32+
BLE to 802.15.4 Transitions:
33+
Radio Switching Time:
34+
- Start: DISABLED pin event (BLE radio turning off)
35+
- End: READY pin activation for 802.15.4 operation (802.15.4 radio turned on and ready)
36+
- Measures how quickly the radio hardware switches modes
37+
38+
Protocol Switching Time:
39+
- Start: PDN event at the end of BLE activity
40+
- End: PDN event at the start of 802.15.4 activity
41+
- Captures the full protocol stack transition overhead
42+
43+
The measurements are collected during BLE advertisement, scanning, and connection activities.
44+
45+
46+
Multiprotocol switching time comparison by device family
47+
--------------------------------------------------------
48+
49+
50+
Protocol Switching Time
51+
^^^^^^^^^^^^^^^^^^^^^^^
52+
+-------------------+---------------+-----------------+-----------------+------------------+
53+
| BLE activity name | Direction | nRF52 mean [us] | nRF53 mean [us] | nRF54L mean [us] |
54+
+===================+===============+=================+=================+==================+
55+
| advertisement | 802.15.4→BLE | 257 | 261 | 205 |
56+
+-------------------+---------------+-----------------+-----------------+------------------+
57+
| advertisement | BLE→802.15.4 | 152 | 181 | 80 |
58+
+-------------------+---------------+-----------------+-----------------+------------------+
59+
| scanning | 802.15.4→BLE | 251 | 251 | 210 |
60+
+-------------------+---------------+-----------------+-----------------+------------------+
61+
| scanning | BLE→802.15.4 | 135 | 183 | 76 |
62+
+-------------------+---------------+-----------------+-----------------+------------------+
63+
| connection | 802.15.4→BLE | 258 | 258 | 214 |
64+
+-------------------+---------------+-----------------+-----------------+------------------+
65+
| connection | BLE→802.15.4 | 149 | 182 | 80 |
66+
+-------------------+---------------+-----------------+-----------------+------------------+
67+
68+
69+
Radio Switching Time
70+
^^^^^^^^^^^^^^^^^^^^
71+
+-------------------+---------------+-----------------+-----------------+------------------+
72+
| BLE activity name | Direction | nRF52 mean [us] | nRF53 mean [us] | nRF54L mean [us] |
73+
+===================+===============+=================+=================+==================+
74+
| advertisement | 802.15.4→BLE | 324 | 346 | 268 |
75+
+-------------------+---------------+-----------------+-----------------+------------------+
76+
| advertisement | BLE→802.15.4 | 289 | 335 | 172 |
77+
+-------------------+---------------+-----------------+-----------------+------------------+
78+
| scanning | 802.15.4→BLE | 303 | 315 | 256 |
79+
+-------------------+---------------+-----------------+-----------------+------------------+
80+
| scanning | BLE→802.15.4 | 234 | 292 | 150 |
81+
+-------------------+---------------+-----------------+-----------------+------------------+
82+
| connection | 802.15.4→BLE | 386 | 388 | 348 |
83+
+-------------------+---------------+-----------------+-----------------+------------------+
84+
| connection | BLE→802.15.4 | 333 | 398 | 211 |
85+
+-------------------+---------------+-----------------+-----------------+------------------+
86+
87+
Multiprotocol switching time measurements by device family
88+
----------------------------------------------------------
89+
90+
91+
nRF52 family
92+
^^^^^^^^^^^^
93+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
94+
| BLE activity name | Direction | Protocol Switching (min | mean | max) [us] | Radio Switching (min | mean | max) [us] |
95+
+===================+===============+============================================+=========================================+
96+
| advertisement | 802.15.4→BLE | 238 | 257 | 359 | 305 | 324 | 427 |
97+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
98+
| advertisement | BLE→802.15.4 | 136 | 152 | 163 | 273 | 289 | 299 |
99+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
100+
| scanning | 802.15.4→BLE | 235 | 251 | 265 | 287 | 303 | 317 |
101+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
102+
| scanning | BLE→802.15.4 | 133 | 135 | 141 | 232 | 234 | 239 |
103+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
104+
| connection | 802.15.4→BLE | 243 | 258 | 275 | 372 | 386 | 398 |
105+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
106+
| connection | BLE→802.15.4 | 135 | 149 | 165 | 312 | 333 | 354 |
107+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
108+
109+
110+
nRF53 family
111+
^^^^^^^^^^^^
112+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
113+
| BLE activity name | Direction | Protocol Switching (min | mean | max) [us] | Radio Switching (min | mean | max) [us] |
114+
+===================+===============+============================================+=========================================+
115+
| advertisement | 802.15.4→BLE | 236 | 261 | 420 | 320 | 346 | 505 |
116+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
117+
| advertisement | BLE→802.15.4 | 169 | 181 | 197 | 324 | 335 | 352 |
118+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
119+
| scanning | 802.15.4→BLE | 234 | 251 | 265 | 298 | 315 | 328 |
120+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
121+
| scanning | BLE→802.15.4 | 181 | 183 | 196 | 290 | 292 | 305 |
122+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
123+
| connection | 802.15.4→BLE | 244 | 258 | 275 | 375 | 388 | 401 |
124+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
125+
| connection | BLE→802.15.4 | 167 | 182 | 196 | 379 | 398 | 418 |
126+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
127+
128+
129+
nRF54L family
130+
^^^^^^^^^^^^^
131+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
132+
| BLE activity name | Direction | Protocol Switching (min | mean | max) [us] | Radio Switching (min | mean | max) [us] |
133+
+===================+===============+============================================+=========================================+
134+
| advertisement | 802.15.4→BLE | 118 | 205 | 209 | 184 | 268 | 273 |
135+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
136+
| advertisement | BLE→802.15.4 | 79 | 80 | 80 | 171 | 172 | 173 |
137+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
138+
| scanning | 802.15.4→BLE | 209 | 210 | 211 | 255 | 256 | 257 |
139+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
140+
| scanning | BLE→802.15.4 | 75 | 76 | 77 | 149 | 150 | 150 |
141+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
142+
| connection | 802.15.4→BLE | 212 | 214 | 223 | 345 | 348 | 348 |
143+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+
144+
| connection | BLE→802.15.4 | 79 | 80 | 80 | 195 | 211 | 225 |
145+
+-------------------+---------------+--------------------------------------------+-----------------------------------------+

0 commit comments

Comments
 (0)