nl::Ble::BleLayer

This class provides an interface for a single thread to drive data either up the stack via the BleLayer platform interface functions, or down the stack via a WeaveConnection object associated with a BLEEndPoint.

Summary

There are two ways to associate a WeaveConnection (defined by the WeaveMessageLayer) with a BLE connection:

First, the application can passively receive an incoming BLE connection and hand the platform-specific BLE_CONNECTION_OBJECT that this receipt generates to BleLayer via the corresponding platform interface function. This causes BleLayer to wrap the BLE_CONNECTION_OBJECT in a BLEEndPoint, and notify WeaveMessageLayer that a new BLE conneciotn has been received. The message layer then wraps the new BLEEndPoint object in a WeaveConnection, and hands this object to the application via the message layer's OnConnectionReceived callback.

Second, the application can actively form an outgoing BLE connection, e.g., by connecting to a BLE peripheral. It then creates a new WeaveConnection via the WeaveMessageLayer, assigns an authentication type to this connection, and binds it to the BLE_CONNECTION_OBJECT for the new BLE connection via WeaveConnection::ConnectBle. This function then establishes the secure session type specified by the WeaveConnection's authentication type member variable.

Inheritance

Public types

 @14

void(* BleConnectionReceivedFunct)(BLEEndPoint *newEndPoint)

BleConnectionReceivedFunct OnWeaveBleConnectReceived

void * mAppState

enum nl::Ble::BleLayer::@14 mState

 BleLayer(
  void
)

void HandleConnectionError(
  BLE_CONNECTION_OBJECT connObj,
  BLE_ERROR err
)

bool HandleIndicationConfirmation(
  BLE_CONNECTION_OBJECT connObj,
  const WeaveBleUUID *svcId,
  const WeaveBleUUID *charId
)

bool HandleIndicationReceived(
  BLE_CONNECTION_OBJECT connObj,
  const WeaveBleUUID *svcId,
  const WeaveBleUUID *charId,
  PacketBuffer *pBuf
)

bool HandleReadReceived(
  BLE_CONNECTION_OBJECT connObj,
  BLE_READ_REQUEST_CONTEXT requestContext,
  const WeaveBleUUID *svcId,
  const WeaveBleUUID *charId
)

bool HandleSubscribeComplete(
  BLE_CONNECTION_OBJECT connObj,
  const WeaveBleUUID *svcId,
  const WeaveBleUUID *charId
)

bool HandleSubscribeReceived(
  BLE_CONNECTION_OBJECT connObj,
  const WeaveBleUUID *svcId,
  const WeaveBleUUID *charId
)

bool HandleUnsubscribeComplete(
  BLE_CONNECTION_OBJECT connObj,
  const WeaveBleUUID *svcId,
  const WeaveBleUUID *charId
)

bool HandleUnsubscribeReceived(
  BLE_CONNECTION_OBJECT connObj,
  const WeaveBleUUID *svcId,
  const WeaveBleUUID *charId
)

bool HandleWriteConfirmation(
  BLE_CONNECTION_OBJECT connObj,
  const WeaveBleUUID *svcId,
  const WeaveBleUUID *charId
)

bool HandleWriteReceived(
  BLE_CONNECTION_OBJECT connObj,
  const WeaveBleUUID *svcId,
  const WeaveBleUUID *charId,
  PacketBuffer *pBuf
)

BLE_ERROR Init(
  BlePlatformDelegate *platformDelegate,
  BleApplicationDelegate *appDelegate,
  Weave::System::Layer *systemLayer
)

BLE_ERROR NewBleEndPoint(
  BLEEndPoint **retEndPoint,
  BLE_CONNECTION_OBJECT connObj,
  BleRole role,
  bool autoClose
)

nl::Weave::System::Error ScheduleWork(
  nl::Weave::System::Layer::TimerCompleteFunct aComplete,
  void *aAppState
)

BLE_ERROR Shutdown(
  void
)