Framework

Core Bluetooth

Communicate with Bluetooth 4.0 low energy devices.

Overview

The Core Bluetooth framework provides the classes needed for your apps to communicate with Bluetooth-equipped low energy wireless technology.

Don’t subclass any of the classes of the Core Bluetooth framework. Overriding these classes isn’t supported and results in undefined behavior.

Core Bluetooth background execution modes aren’t supported in iPad apps running on macOS.

Topics

Centrals

CBCentral

A remote device connected to a local app which is acting as a peripheral.

CBCentralManager

An object that scans for, discovers, connects to, and manages peripherals.

CBCentralManagerDelegate

A protocol that provides updates for the discovery and management of peripheral devices.

Peripherals

CBPeripheral

A remote peripheral device.

CBPeripheralDelegate

A protocol that provides updates on the use of a peripheral’s services.

CBPeripheralManager

An object that manages and advertises peripheral services exposed by this app.

CBPeripheralManagerDelegate

A protocol that provides updates for local peripheral state and interactions with remote central devices.

CBAttribute

A representation of common aspects of services offered by a peripheral.

CBAttributePermissions

Values that represent the read, write, and encryption permissions for a characteristic’s value.

Services

CBService

A collection of data and associated behaviors for accomplishing a function or feature of a device.

CBMutableService

A service with writeable property values.

CBCharacteristic

A characteristic of a remote peripheral’s service.

CBMutableCharacteristic

A characteristic of a local peripheral’s service.

CBDescriptor

An object that provides further information about a remote peripheral’s characteristic.

CBMutableDescriptor

An object that provides additional information about a local peripheral’s characteristic.

Supporting Types

CBManager

The abstract base class for managing central and peripheral objects.

CBATTRequest

A request that uses the Attribute Protocol (ATT).

CBPeer

An object that represents a remote device.

CBUUID

A universally unique identifier, as defined by Bluetooth standards.

Errors

CBErrorDomain

The domain for Core Bluetooth errors.

CBError

The possible errors returned during Bluetooth low energy transactions.

CBATTErrorDomain

The domain for Core Bluetooth ATT errors.

CBATTError

The possible errors returned by a GATT server (a remote peripheral) during Bluetooth low energy ATT transactions.

Deprecated

CBCentralManagerState

Values representing the current state of a central manager object.

Deprecated
CBPeripheralManagerState

Values representing the current state of the peripheral manager.

Deprecated
Deprecated Constants

This document describes the constants found in the Core Bluetooth framework.

See Also