Skip to content

Commit 3b2d5a0

Browse files
author
Amanda Butler
authored
Edit and rearrange Gap.md
Rearrange content for flow, and edit mostly for precise language and international spelling.
1 parent b4fd1fb commit 3b2d5a0

File tree

1 file changed

+6
-4
lines changed

1 file changed

+6
-4
lines changed

docs/api/bluetooth/Gap.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -52,13 +52,15 @@ You may set preferred PHYs (separately for RX and TX) using `setPreferredPhys()`
5252

5353
You may query the currently used PHY using `readPhy()`, which returns the result through a call to the registered event handler. You may register the handler with `setEventHandler()`. The events inform about the currently used PHY and of any changes to PHYs, which the controller or the peer may trigger autonomously.
5454

55-
#### Data Length (over-the-air MTU)
55+
#### Data length (over-the-air MTU)
5656

57-
In addition to modulation schemes, MTU (Maximum Transmission Unit) size also strongly affects throughput. Newer controllers will allow you to negotiate bigger MTUs. Since each packet contains overhead bigger packets maximise throughput.
57+
In addition to modulation schemes, Maximum Transmission Unit (MTU) size also strongly affects throughput. Newer controllers allow you to negotiate bigger MTUs. Because each packet contains overhead, bigger packets maximize throughput.
5858

59-
The default value of Data Length supported by all controllers is 23 octets. If both controllers support Data Length Extension and a higher value is negotiated `onDataLengthChange` in the `Gap::EventHandler` will be called.
59+
There are two separate MTUs to consider: the `ATT_MTU` (maximum attribute size) and data length. `GattServer` and `GattClient` affect `ATT_MTU`. `Gap` only deals with data length, which is the maximum size of the packet that carries attributes that are fragmented across many such packets.
6060

61-
There are two separate MTUs to consider: the ATT_MTU (maximum attribute size) and Data Length. ATT_MTU is dealt with in `GattServer` and `GattClient`. `Gap` only deals with Data Length which is the maximum size of the packet that carries attributes which are fragmented across many such packets. ATT_MTU and Data Length are independent of each other.
61+
The default value of data length supported by all controllers is 23 octets. If both controllers support data length extension and a higher value is negotiated, `onDataLengthChange` in the `Gap::EventHandler` will be called.
62+
63+
`ATT_MTU` and data length are independent of each other.
6264

6365
### GAP class reference
6466

0 commit comments

Comments
 (0)