ARMmbed
/
mbed-os
mirror of https://github.com/ARMmbed/mbed-os.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Merge pull request #2 from pan-/PHY_API 

Phy api
pull/7899/head
Vincent Coubard 2018-07-16 11:57:26 +01:00
parent 4deb64aed1
commit 47ea39982f
1 changed files with 16 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
features/FEATURE_BLE/ble/Gap.h
View File

@ -276,6 +276,20 @@ class GapAdvertisingData;
* gap.startScan(handle_advertising_packet); * gap.startScan(handle_advertising_packet);
* @endcode * @endcode
* *
* @par Changing the PHYsical transport of a connection
*
* Once a connection has been established, it is possible to change the physical
* transport used between the local and the distant device. Changing the transport
* can either increase the bandwidth or increase the communication range.
* An increased bandwidth equals a better power consumption but also a loss in
* sensibility and therefore a degraded range.
* Symmetrically an increased range means a lowered bandwith and a degraded power
* consumption.
*
* Applications can change the PHY used by calling the function setPhy. Once the
* update has been made the result is forwarded to the application by calling the
* function onPhyUpdateComplete of the event handler registered.
*
* @par disconnection * @par disconnection
* *
* The application code initiates a disconnection when it calls the * The application code initiates a disconnection when it calls the
@ -1105,7 +1119,7 @@ public:
* *
* @param rxPhy PHY used by the receiver. * @param rxPhy PHY used by the receiver.
*/ */
virtual void onPhyRead( virtual void onReadPhy(
ble_error_t status, ble_error_t status,
Handle_t connectionHandle, Handle_t connectionHandle,
ble::phy_t txPhy, ble::phy_t txPhy,
@ -1471,7 +1485,7 @@ public:
const Phys_t* rxPhys, const Phys_t* rxPhys,
CodedSymbolPerBit_t codedSymbol CodedSymbolPerBit_t codedSymbol
) { ) {
return BLE_ERROR_NONE; return BLE_ERROR_NOT_IMPLEMENTED;
} }
/** /**