IoT::BtLE

class GATTPeripheral

File Information

Library: IoT/BtLE
Package: BtLE
Header: IoT/BtLE/GATTPeripheral.h

Description

This class provides a high-level interface to a Bt LE peripheral device using the Bt Generic Attribute Profile (GATT).

Inheritance

Direct Base Classes: Peripheral

All Base Classes: Peripheral

Member Summary

Member Functions: address, characteristic, characteristicForAssignedNumber, characteristics, connect, connectAsync, disconnect, firmwareRevision, handleForDescriptor, hardwareRevision, isConnected, manufacturerName, modelNumber, onConnected, onDisconnected, onError, onIndication, onNotification, readBytes, readDeviceInformation, readInt16, readInt32, readInt8, readString, readString0, readUInt16, readUInt32, readUInt8, serialNumber, serviceUUIDForAssignedNumber, services, softwareRevision, writeBytes, writeInt16, writeInt32, writeInt8, writeString, writeUInt16, writeUInt32, writeUInt8

Inherited Functions: address, characteristic, characteristicForAssignedNumber, characteristics, connect, connectAsync, disconnect, firmwareRevision, handleForDescriptor, hardwareRevision, isConnected, manufacturerName, modelNumber, readBytes, readInt16, readInt32, readInt8, readString, readString0, readUInt16, readUInt32, readUInt8, serialNumber, serviceUUIDForAssignedNumber, services, softwareRevision, writeBytes, writeInt16, writeInt32, writeInt8, writeString, writeUInt16, writeUInt32, writeUInt8

Constructors

GATTPeripheral

GATTPeripheral(
    const std::string & address,
    GATTClient::Ptr pGATTClient
);

Creates the GATTPeripheral.

Destructor

~GATTPeripheral virtual

~GATTPeripheral();

Destroys the GATTPeripheral.

Member Functions

address virtual

std::string address() const;

characteristic virtual

Characteristic characteristic(
    const std::string & serviceUUID,
    const std::string & characteristicUUID
);

characteristicForAssignedNumber virtual

Characteristic characteristicForAssignedNumber(
    const std::string & serviceUUID,
    Poco::UInt32 assignedNumber
);

characteristics virtual

std::vector < std::string > characteristics(
    const std::string & serviceUUID
);

connect virtual

void connect();

connectAsync virtual

void connectAsync();

disconnect virtual

void disconnect();

firmwareRevision virtual

std::string firmwareRevision();

handleForDescriptor virtual

Poco::UInt16 handleForDescriptor(
    const std::string & serviceUUID,
    const std::string & descriptorUUID
);

hardwareRevision virtual

std::string hardwareRevision();

isConnected virtual

bool isConnected() const;

manufacturerName virtual

std::string manufacturerName();

modelNumber virtual

std::string modelNumber();

readBytes virtual

std::vector < char > readBytes(
    Poco::UInt16 valueHandle
);

readInt16 virtual

Poco::Int16 readInt16(
    Poco::UInt16 valueHandle
);

readInt32 virtual

Poco::Int32 readInt32(
    Poco::UInt16 valueHandle
);

readInt8 virtual

Poco::Int8 readInt8(
    Poco::UInt16 valueHandle
);

readString virtual

std::string readString(
    Poco::UInt16 valueHandle
);

readString0 virtual

std::string readString0(
    Poco::UInt16 valueHandle
);

readUInt16 virtual

Poco::UInt16 readUInt16(
    Poco::UInt16 valueHandle
);

readUInt32 virtual

Poco::UInt32 readUInt32(
    Poco::UInt16 valueHandle
);

readUInt8 virtual

Poco::UInt8 readUInt8(
    Poco::UInt16 valueHandle
);

serialNumber virtual

std::string serialNumber();

serviceUUIDForAssignedNumber virtual

std::string serviceUUIDForAssignedNumber(
    Poco::UInt32 assignedNumber
);

services virtual

std::vector < std::string > services();

softwareRevision virtual

std::string softwareRevision();

writeBytes virtual

void writeBytes(
    Poco::UInt16 valueHandle,
    const std::vector < char > & value,
    bool withResponse
);

writeInt16 virtual

void writeInt16(
    Poco::UInt16 valueHandle,
    Poco::Int16 value,
    bool withResponse
);

writeInt32 virtual

void writeInt32(
    Poco::UInt16 valueHandle,
    Poco::UInt32 value,
    bool withResponse
);

writeInt8 virtual

void writeInt8(
    Poco::UInt16 valueHandle,
    Poco::Int8 value,
    bool withResponse
);

writeString virtual

void writeString(
    Poco::UInt16 valueHandle,
    const std::string & value,
    bool withResponse
);

writeUInt16 virtual

void writeUInt16(
    Poco::UInt16 valueHandle,
    Poco::UInt16 value,
    bool withResponse
);

writeUInt32 virtual

void writeUInt32(
    Poco::UInt16 valueHandle,
    Poco::UInt32 value,
    bool withResponse
);

writeUInt8 virtual

void writeUInt8(
    Poco::UInt16 valueHandle,
    Poco::UInt8 value,
    bool withResponse
);

onConnected protected

void onConnected();

onDisconnected protected

void onDisconnected();

onError protected

void onError(
    const std::string & error
);

onIndication protected

void onIndication(
    const GATTClient::Indication & ind
);

onNotification protected

void onNotification(
    const GATTClient::Notification & nf
);

readDeviceInformation protected

std::string readDeviceInformation(
    Poco::UInt32 assignedNumber
);

Securely control IoT edge devices from anywhere   Connect a Device