Universal Unique Identifiers (UUIDs)

API Reference

group bt_uuid

UUIDs.

Defines

BT_UUID_SIZE_16

Size in octets of a 16-bit UUID

BT_UUID_SIZE_32

Size in octets of a 32-bit UUID

BT_UUID_SIZE_128

Size in octets of a 128-bit UUID

BT_UUID_INIT_16(value)

Initialize a 16-bit UUID.

Parameters

• value – 16-bit UUID value in host endianness.

BT_UUID_INIT_32(value)

Initialize a 32-bit UUID.

Parameters

• value – 32-bit UUID value in host endianness.

BT_UUID_INIT_128(value...)

Initialize a 128-bit UUID.

Parameters

• value – 128-bit UUID array values in little-endian format. Can be combined with BT_UUID_128_ENCODE to initialize a UUID from the readable form of UUIDs.

BT_UUID_DECLARE_16(value)

Helper to declare a 16-bit UUID inline.

Parameters

• value – 16-bit UUID value in host endianness.

Returns

Pointer to a generic UUID.

BT_UUID_DECLARE_32(value)

Helper to declare a 32-bit UUID inline.

Parameters

• value – 32-bit UUID value in host endianness.

Returns

Pointer to a generic UUID.

BT_UUID_DECLARE_128(value...)

Helper to declare a 128-bit UUID inline.

Parameters

• value – 128-bit UUID array values in little-endian format. Can be combined with BT_UUID_128_ENCODE to declare a UUID from the readable form of UUIDs.

Returns

Pointer to a generic UUID.

BT_UUID_16(__u)

Helper macro to access the 16-bit UUID from a generic UUID.

BT_UUID_32(__u)

Helper macro to access the 32-bit UUID from a generic UUID.

BT_UUID_128(__u)

Helper macro to access the 128-bit UUID from a generic UUID.

BT_UUID_128_ENCODE(w32, w1, w2, w3, w48)

Encode 128 bit UUID into array values in little-endian format.

Helper macro to initialize a 128-bit UUID array value from the readable form of UUIDs, or encode 128-bit UUID values into advertising data Can be combined with BT_UUID_DECLARE_128 to declare a 128-bit UUID.

Example of how to declare the UUID 6E400001-B5A3-F393-E0A9-E50E24DCCA9E

BT_UUID_DECLARE_128(
     BT_UUID_128_ENCODE(0x6E400001, 0xB5A3, 0xF393, 0xE0A9, 0xE50E24DCCA9E))

Example of how to encode the UUID 6E400001-B5A3-F393-E0A9-E50E24DCCA9E into advertising data.

BT_DATA_BYTES(BT_DATA_UUID128_ALL,
     BT_UUID_128_ENCODE(0x6E400001, 0xB5A3, 0xF393, 0xE0A9, 0xE50E24DCCA9E))

Just replace the hyphen by the comma and add 0x prefixes.

Parameters

• w32 – First part of the UUID (32 bits)

• w1 – Second part of the UUID (16 bits)

• w2 – Third part of the UUID (16 bits)

• w3 – Fourth part of the UUID (16 bits)

• w48 – Fifth part of the UUID (48 bits)

Returns

The comma separated values for UUID 128 initializer that may be used directly as an argument for BT_UUID_INIT_128 or BT_UUID_DECLARE_128

BT_UUID_16_ENCODE(w16)

Encode 16-bit UUID into array values in little-endian format.

Helper macro to encode 16-bit UUID values into advertising data.

Example of how to encode the UUID 0x180a into advertising data.

BT_DATA_BYTES(BT_DATA_UUID16_ALL, BT_UUID_16_ENCODE(0x180a))

Parameters

• w16 – UUID value (16-bits)

Returns

The comma separated values for UUID 16 value that may be used directly as an argument for BT_DATA_BYTES.

BT_UUID_32_ENCODE(w32)

Encode 32-bit UUID into array values in little-endian format.

Helper macro to encode 32-bit UUID values into advertising data.

Example of how to encode the UUID 0x180a01af into advertising data.

BT_DATA_BYTES(BT_DATA_UUID32_ALL, BT_UUID_32_ENCODE(0x180a01af))

Parameters

• w32 – UUID value (32-bits)

Returns

The comma separated values for UUID 32 value that may be used directly as an argument for BT_DATA_BYTES.

BT_UUID_STR_LEN

Recommended length of user string buffer for Bluetooth UUID.

The recommended length guarantee the output of UUID conversion will not lose valuable information about the UUID being processed. If the length of the UUID is known the string can be shorter.

BT_UUID_GAP_VAL

Generic Access UUID value.

BT_UUID_GAP

Generic Access.

BT_UUID_GATT_VAL

Generic attribute UUID value.

BT_UUID_GATT

Generic Attribute.

BT_UUID_IAS_VAL

Immediate Alert Service UUID value.

BT_UUID_IAS

Immediate Alert Service.

BT_UUID_LLS_VAL

Link Loss Service UUID value.

BT_UUID_LLS

Link Loss Service.

BT_UUID_TPS_VAL

Tx Power Service UUID value.

BT_UUID_TPS

Tx Power Service.

BT_UUID_CTS_VAL

Current Time Service UUID value.

BT_UUID_CTS

Current Time Service.

BT_UUID_HTS_VAL

Health Thermometer Service UUID value.

BT_UUID_HTS

Health Thermometer Service.

BT_UUID_DIS_VAL

Device Information Service UUID value.

BT_UUID_DIS

Device Information Service.

BT_UUID_HRS_VAL

Heart Rate Service UUID value.

BT_UUID_HRS

Heart Rate Service.

BT_UUID_BAS_VAL

Battery Service UUID value.

BT_UUID_BAS

Battery Service.

BT_UUID_HIDS_VAL

HID Service UUID value.

BT_UUID_HIDS

HID Service.

BT_UUID_RSCS_VAL

Running Speed and Cadence Service UUID value.

BT_UUID_RSCS

Running Speed and Cadence Service.

BT_UUID_CSC_VAL

Cycling Speed and Cadence Service UUID value.

BT_UUID_CSC

Cycling Speed and Cadence Service.

BT_UUID_ESS_VAL

Environmental Sensing Service UUID value.

BT_UUID_ESS

Environmental Sensing Service.

BT_UUID_BMS_VAL

Bond Management Service UUID value.

BT_UUID_BMS

Bond Management Service.

BT_UUID_IPSS_VAL

IP Support Service UUID value.

BT_UUID_IPSS

IP Support Service.

BT_UUID_HPS_VAL

HTTP Proxy Service UUID value.

BT_UUID_HPS

HTTP Proxy Service.

BT_UUID_OTS_VAL

Object Transfer Service UUID value.

BT_UUID_OTS

Object Transfer Service.

BT_UUID_MESH_PROV_VAL

Mesh Provisioning Service UUID value.

BT_UUID_MESH_PROV

Mesh Provisioning Service.

BT_UUID_MESH_PROXY_VAL

Mesh Proxy Service UUID value.

BT_UUID_MESH_PROXY

Mesh Proxy Service.

BT_UUID_AICS_VAL

Audio Input Control Service value.

BT_UUID_AICS

Audio Input Control Service.

BT_UUID_VCS_VAL

Volume Control Service value.

BT_UUID_VCS

Volume Control Service.

BT_UUID_VOCS_VAL

Volume Offset Control Service value.

BT_UUID_VOCS

Volume Offset Control Service.

BT_UUID_CSIS_VAL

Coordinated Set Identification Service value.

BT_UUID_CSIS

Coordinated Set Identification Service.

BT_UUID_MCS_VAL

Media Control Service value.

BT_UUID_MCS

Media Control Service.

BT_UUID_GMCS_VAL

Generic Media Control Service value.

BT_UUID_GMCS

Generic Media Control Service.

BT_UUID_MICS_VAL

Microphone Input Control Service value.

BT_UUID_MICS

Microphone Input Control Service.

BT_UUID_ASCS_VAL

Audio Stream Control Service value.

BT_UUID_ASCS

Audio Stream Control Service.

BT_UUID_BASS_VAL

Broadcast Audio Scan Service value.

BT_UUID_BASS

Broadcast Audio Scan Service.

BT_UUID_PACS_VAL

Published Audio Capabilities Service value.

BT_UUID_PACS

Published Audio Capabilities Service.

BT_UUID_BASIC_AUDIO_VAL

Basic Audio Announcement Service value.

BT_UUID_BASIC_AUDIO

Basic Audio Announcement Service.

BT_UUID_BROADCAST_AUDIO_VAL

Broadcast Audio Announcement Service value.

BT_UUID_BROADCAST_AUDIO

Broadcast Audio Announcement Service.

BT_UUID_GATT_PRIMARY_VAL

GATT Primary Service UUID value.

BT_UUID_GATT_PRIMARY

GATT Primary Service.

BT_UUID_GATT_SECONDARY_VAL

GATT Secondary Service UUID value.

BT_UUID_GATT_SECONDARY

GATT Secondary Service.

BT_UUID_GATT_INCLUDE_VAL

GATT Include Service UUID value.

BT_UUID_GATT_INCLUDE

GATT Include Service.

BT_UUID_GATT_CHRC_VAL

GATT Characteristic UUID value.

BT_UUID_GATT_CHRC

GATT Characteristic.

BT_UUID_GATT_CEP_VAL

GATT Characteristic Extended Properties UUID value.

BT_UUID_GATT_CEP

GATT Characteristic Extended Properties.

BT_UUID_GATT_CUD_VAL

GATT Characteristic User Description UUID value.

BT_UUID_GATT_CUD

GATT Characteristic User Description.

BT_UUID_GATT_CCC_VAL

GATT Client Characteristic Configuration UUID value.

BT_UUID_GATT_CCC

GATT Client Characteristic Configuration.

BT_UUID_GATT_SCC_VAL

GATT Server Characteristic Configuration UUID value.

BT_UUID_GATT_SCC

GATT Server Characteristic Configuration.

BT_UUID_GATT_CPF_VAL

GATT Characteristic Presentation Format UUID value.

BT_UUID_GATT_CPF

GATT Characteristic Presentation Format.

BT_UUID_GATT_CAF_VAL

GATT Characteristic Aggregated Format UUID value.

BT_UUID_GATT_CAF

GATT Characteristic Aggregated Format.

BT_UUID_VALID_RANGE_VAL

Valid Range Descriptor UUID value.

BT_UUID_VALID_RANGE

Valid Range Descriptor.

BT_UUID_HIDS_EXT_REPORT_VAL

HID External Report Descriptor UUID value.

BT_UUID_HIDS_EXT_REPORT

HID External Report Descriptor.

BT_UUID_HIDS_REPORT_REF_VAL

HID Report Reference Descriptor UUID value.

BT_UUID_HIDS_REPORT_REF

HID Report Reference Descriptor.

BT_UUID_ES_CONFIGURATION_VAL

Environmental Sensing Configuration Descriptor UUID value.

BT_UUID_ES_CONFIGURATION

Environmental Sensing Configuration Descriptor.

BT_UUID_ES_MEASUREMENT_VAL

Environmental Sensing Measurement Descriptor UUID value.

BT_UUID_ES_MEASUREMENT

Environmental Sensing Measurement Descriptor.

BT_UUID_ES_TRIGGER_SETTING_VAL

Environmental Sensing Trigger Setting Descriptor UUID value.

BT_UUID_ES_TRIGGER_SETTING

Environmental Sensing Trigger Setting Descriptor.

BT_UUID_GAP_DEVICE_NAME_VAL

GAP Characteristic Device Name UUID value.

BT_UUID_GAP_DEVICE_NAME

GAP Characteristic Device Name.

BT_UUID_GAP_APPEARANCE_VAL

GAP Characteristic Appearance UUID value.

BT_UUID_GAP_APPEARANCE

GAP Characteristic Appearance.

BT_UUID_GAP_PPCP_VAL

GAP Characteristic Peripheral Preferred Connection Parameters UUID value.

BT_UUID_GAP_PPCP

GAP Characteristic Peripheral Preferred Connection Parameters.

BT_UUID_GATT_SC_VAL

GATT Characteristic Service Changed UUID value.

BT_UUID_GATT_SC

GATT Characteristic Service Changed.

BT_UUID_ALERT_LEVEL_VAL

Alert Level UUID value.

BT_UUID_ALERT_LEVEL

Alert Level.

BT_UUID_TPS_TX_POWER_LEVEL_VAL

TPS Characteristic Tx Power Level UUID value.

BT_UUID_TPS_TX_POWER_LEVEL

TPS Characteristic Tx Power Level.

BT_UUID_BAS_BATTERY_LEVEL_VAL

BAS Characteristic Battery Level UUID value.

BT_UUID_BAS_BATTERY_LEVEL

BAS Characteristic Battery Level.

BT_UUID_HTS_MEASUREMENT_VAL

HTS Characteristic Measurement Value UUID value.

BT_UUID_HTS_MEASUREMENT

HTS Characteristic Measurement Value.

BT_UUID_HIDS_BOOT_KB_IN_REPORT_VAL

HID Characteristic Boot Keyboard Input Report UUID value.

BT_UUID_HIDS_BOOT_KB_IN_REPORT

HID Characteristic Boot Keyboard Input Report.

BT_UUID_DIS_SYSTEM_ID_VAL

DIS Characteristic System ID UUID value.

BT_UUID_DIS_SYSTEM_ID

DIS Characteristic System ID.

BT_UUID_DIS_MODEL_NUMBER_VAL

DIS Characteristic Model Number String UUID value.

BT_UUID_DIS_MODEL_NUMBER

DIS Characteristic Model Number String.

BT_UUID_DIS_SERIAL_NUMBER_VAL

DIS Characteristic Serial Number String UUID value.

BT_UUID_DIS_SERIAL_NUMBER

DIS Characteristic Serial Number String.

BT_UUID_DIS_FIRMWARE_REVISION_VAL

DIS Characteristic Firmware Revision String UUID value.

BT_UUID_DIS_FIRMWARE_REVISION

DIS Characteristic Firmware Revision String.

BT_UUID_DIS_HARDWARE_REVISION_VAL

DIS Characteristic Hardware Revision String UUID value.

BT_UUID_DIS_HARDWARE_REVISION

DIS Characteristic Hardware Revision String.

BT_UUID_DIS_SOFTWARE_REVISION_VAL

DIS Characteristic Software Revision String UUID value.

BT_UUID_DIS_SOFTWARE_REVISION

DIS Characteristic Software Revision String.

BT_UUID_DIS_MANUFACTURER_NAME_VAL

DIS Characteristic Manufacturer Name String UUID Value.

BT_UUID_DIS_MANUFACTURER_NAME

DIS Characteristic Manufacturer Name String.

BT_UUID_DIS_PNP_ID_VAL

DIS Characteristic PnP ID UUID value.

BT_UUID_DIS_PNP_ID

DIS Characteristic PnP ID.

BT_UUID_CTS_CURRENT_TIME_VAL

CTS Characteristic Current Time UUID value.

BT_UUID_CTS_CURRENT_TIME

CTS Characteristic Current Time.

BT_UUID_MAGN_DECLINATION_VAL

Magnetic Declination Characteristic UUID value.

BT_UUID_MAGN_DECLINATION

Magnetic Declination Characteristic.

BT_UUID_HIDS_BOOT_KB_OUT_REPORT_VAL

HID Boot Keyboard Output Report Characteristic UUID value.

BT_UUID_HIDS_BOOT_KB_OUT_REPORT

HID Boot Keyboard Output Report Characteristic.

BT_UUID_HIDS_BOOT_MOUSE_IN_REPORT_VAL

HID Boot Mouse Input Report Characteristic UUID value.

BT_UUID_HIDS_BOOT_MOUSE_IN_REPORT

HID Boot Mouse Input Report Characteristic.

BT_UUID_HRS_MEASUREMENT_VAL

HRS Characteristic Measurement Interval UUID value.

BT_UUID_HRS_MEASUREMENT

HRS Characteristic Measurement Interval.

BT_UUID_HRS_BODY_SENSOR

HRS Characteristic Body Sensor Location.

BT_UUID_HRS_BODY_SENSOR_VAL

BT_UUID_HRS_CONTROL_POINT

HRS Characteristic Control Point.

BT_UUID_HRS_CONTROL_POINT_VAL

HRS Characteristic Control Point UUID value.

BT_UUID_HIDS_INFO_VAL

HID Information Characteristic UUID value.

BT_UUID_HIDS_INFO

HID Information Characteristic.

BT_UUID_HIDS_REPORT_MAP_VAL

HID Report Map Characteristic UUID value.

BT_UUID_HIDS_REPORT_MAP

HID Report Map Characteristic.

BT_UUID_HIDS_CTRL_POINT_VAL

HID Control Point Characteristic UUID value.

BT_UUID_HIDS_CTRL_POINT

HID Control Point Characteristic.

BT_UUID_HIDS_REPORT_VAL

HID Report Characteristic UUID value.

BT_UUID_HIDS_REPORT

HID Report Characteristic.

BT_UUID_HIDS_PROTOCOL_MODE_VAL

HID Protocol Mode Characteristic UUID value.

BT_UUID_HIDS_PROTOCOL_MODE

HID Protocol Mode Characteristic.

BT_UUID_RSC_MEASUREMENT_VAL

RSC Measurement Characteristic UUID value.

BT_UUID_RSC_MEASUREMENT

RSC Measurement Characteristic.

BT_UUID_RSC_FEATURE_VAL

RSC Feature Characteristic UUID value.

BT_UUID_RSC_FEATURE

RSC Feature Characteristic.

BT_UUID_CSC_MEASUREMENT_VAL

CSC Measurement Characteristic UUID value.

BT_UUID_CSC_MEASUREMENT

CSC Measurement Characteristic.

BT_UUID_CSC_FEATURE_VAL

CSC Feature Characteristic UUID value.

BT_UUID_CSC_FEATURE

CSC Feature Characteristic.

BT_UUID_SENSOR_LOCATION_VAL

Sensor Location Characteristic UUID value.

BT_UUID_SENSOR_LOCATION

Sensor Location Characteristic.

BT_UUID_SC_CONTROL_POINT_VAL

SC Control Point Characteristic UUID value.

BT_UUID_SC_CONTROL_POINT

SC Control Point Characteristic.

BT_UUID_ELEVATION_VAL

Elevation Characteristic UUID value.

BT_UUID_ELEVATION

Elevation Characteristic.

BT_UUID_PRESSURE_VAL

Pressure Characteristic UUID value.

BT_UUID_PRESSURE

Pressure Characteristic.

BT_UUID_TEMPERATURE_VAL

Temperature Characteristic UUID value.

BT_UUID_TEMPERATURE

Temperature Characteristic.

BT_UUID_HUMIDITY_VAL

Humidity Characteristic UUID value.

BT_UUID_HUMIDITY

Humidity Characteristic.

BT_UUID_TRUE_WIND_SPEED_VAL

True Wind Speed Characteristic UUID value.

BT_UUID_TRUE_WIND_SPEED

True Wind Speed Characteristic.

BT_UUID_TRUE_WIND_DIR_VAL

True Wind Direction Characteristic UUID value.

BT_UUID_TRUE_WIND_DIR

True Wind Direction Characteristic.

BT_UUID_APPARENT_WIND_SPEED_VAL

Apparent Wind Speed Characteristic UUID value.

BT_UUID_APPARENT_WIND_SPEED

Apparent Wind Speed Characteristic.

BT_UUID_APPARENT_WIND_DIR_VAL

Apparent Wind Direction Characteristic UUID value.

BT_UUID_APPARENT_WIND_DIR

Apparent Wind Direction Characteristic.

BT_UUID_GUST_FACTOR_VAL

Gust Factor Characteristic UUID value.

BT_UUID_GUST_FACTOR

Gust Factor Characteristic.

BT_UUID_POLLEN_CONCENTRATION_VAL

Pollen Concentration Characteristic UUID value.

BT_UUID_POLLEN_CONCENTRATION

Pollen Concentration Characteristic.

BT_UUID_UV_INDEX_VAL

UV Index Characteristic UUID value.

BT_UUID_UV_INDEX

UV Index Characteristic.

BT_UUID_IRRADIANCE_VAL

Irradiance Characteristic UUID value.

BT_UUID_IRRADIANCE

Irradiance Characteristic.

BT_UUID_RAINFALL_VAL

Rainfall Characteristic UUID value.

BT_UUID_RAINFALL

Rainfall Characteristic.

BT_UUID_WIND_CHILL_VAL

Wind Chill Characteristic UUID value.

BT_UUID_WIND_CHILL

Wind Chill Characteristic.

BT_UUID_HEAT_INDEX_VAL

Heat Index Characteristic UUID value.

BT_UUID_HEAT_INDEX

Heat Index Characteristic.

BT_UUID_DEW_POINT_VAL

Dew Point Characteristic UUID value.

BT_UUID_DEW_POINT

Dew Point Characteristic.

BT_UUID_DESC_VALUE_CHANGED_VAL

Descriptor Value Changed Characteristic UUID value.

BT_UUID_DESC_VALUE_CHANGED

Descriptor Value Changed Characteristic.

BT_UUID_MAGN_FLUX_DENSITY_2D_VAL

Magnetic Flux Density - 2D Characteristic UUID value.

BT_UUID_MAGN_FLUX_DENSITY_2D

Magnetic Flux Density - 2D Characteristic.

BT_UUID_MAGN_FLUX_DENSITY_3D_VAL

Magnetic Flux Density - 3D Characteristic UUID value.

BT_UUID_MAGN_FLUX_DENSITY_3D

Magnetic Flux Density - 3D Characteristic.

BT_UUID_BAR_PRESSURE_TREND_VAL

Barometric Pressure Trend Characteristic UUID value.

BT_UUID_BAR_PRESSURE_TREND

Barometric Pressure Trend Characteristic.

BT_UUID_BMS_CONTROL_POINT_VAL

Bond Management Control Point UUID value.

BT_UUID_BMS_CONTROL_POINT

Bond Management Control Point.

BT_UUID_BMS_FEATURE_VAL

Bond Management Feature UUID value.

BT_UUID_BMS_FEATURE

Bond Management Feature.

BT_UUID_CENTRAL_ADDR_RES_VAL

Central Address Resolution Characteristic UUID value.

BT_UUID_CENTRAL_ADDR_RES

Central Address Resolution Characteristic.

BT_UUID_URI_VAL

URI UUID value.

BT_UUID_URI

URI.

BT_UUID_HTTP_HEADERS_VAL

HTTP Headers UUID value.

BT_UUID_HTTP_HEADERS

HTTP Headers.

BT_UUID_HTTP_STATUS_CODE_VAL

HTTP Status Code UUID value.

BT_UUID_HTTP_STATUS_CODE

HTTP Status Code.

BT_UUID_HTTP_ENTITY_BODY_VAL

HTTP Entity Body UUID value.

BT_UUID_HTTP_ENTITY_BODY

HTTP Entity Body.

BT_UUID_HTTP_CONTROL_POINT_VAL

HTTP Control Point UUID value.

BT_UUID_HTTP_CONTROL_POINT

HTTP Control Point.

BT_UUID_HTTPS_SECURITY_VAL

HTTPS Security UUID value.

BT_UUID_HTTPS_SECURITY

HTTPS Security.

BT_UUID_OTS_FEATURE_VAL

OTS Feature Characteristic UUID value.

BT_UUID_OTS_FEATURE

OTS Feature Characteristic.

BT_UUID_OTS_NAME_VAL

OTS Object Name Characteristic UUID value.

BT_UUID_OTS_NAME

OTS Object Name Characteristic.

BT_UUID_OTS_TYPE_VAL

OTS Object Type Characteristic UUID value.

BT_UUID_OTS_TYPE

OTS Object Type Characteristic.

BT_UUID_OTS_SIZE_VAL

OTS Object Size Characteristic UUID value.

BT_UUID_OTS_SIZE

OTS Object Size Characteristic.

BT_UUID_OTS_FIRST_CREATED_VAL

OTS Object First-Created Characteristic UUID value.

BT_UUID_OTS_FIRST_CREATED

OTS Object First-Created Characteristic.

BT_UUID_OTS_LAST_MODIFIED_VAL

OTS Object Last-Modified Characteristic UUI value.

BT_UUID_OTS_LAST_MODIFIED

OTS Object Last-Modified Characteristic.

BT_UUID_OTS_ID_VAL

OTS Object ID Characteristic UUID value.

BT_UUID_OTS_ID

OTS Object ID Characteristic.

BT_UUID_OTS_PROPERTIES_VAL

OTS Object Properties Characteristic UUID value.

BT_UUID_OTS_PROPERTIES

OTS Object Properties Characteristic.

BT_UUID_OTS_ACTION_CP_VAL

OTS Object Action Control Point Characteristic UUID value.

BT_UUID_OTS_ACTION_CP

OTS Object Action Control Point Characteristic.

BT_UUID_OTS_LIST_CP_VAL

OTS Object List Control Point Characteristic UUID value.

BT_UUID_OTS_LIST_CP

OTS Object List Control Point Characteristic.

BT_UUID_OTS_LIST_FILTER_VAL

OTS Object List Filter Characteristic UUID value.

BT_UUID_OTS_LIST_FILTER

OTS Object List Filter Characteristic.

BT_UUID_OTS_CHANGED_VAL

OTS Object Changed Characteristic UUID value.

BT_UUID_OTS_CHANGED

OTS Object Changed Characteristic.

BT_UUID_OTS_TYPE_UNSPECIFIED_VAL

OTS Unspecified Object Type UUID value.

BT_UUID_OTS_TYPE_UNSPECIFIED

OTS Unspecified Object Type.

BT_UUID_OTS_DIRECTORY_LISTING_VAL

OTS Directory Listing UUID value.

BT_UUID_OTS_DIRECTORY_LISTING

OTS Directory Listing.

BT_UUID_MESH_PROV_DATA_IN_VAL

Mesh Provisioning Data In UUID value.

BT_UUID_MESH_PROV_DATA_IN

Mesh Provisioning Data In.

BT_UUID_MESH_PROV_DATA_OUT_VAL

Mesh Provisioning Data Out UUID value.

BT_UUID_MESH_PROV_DATA_OUT

Mesh Provisioning Data Out.

BT_UUID_MESH_PROXY_DATA_IN_VAL

Mesh Proxy Data In UUID value.

BT_UUID_MESH_PROXY_DATA_IN

Mesh Proxy Data In.

BT_UUID_MESH_PROXY_DATA_OUT_VAL

Mesh Proxy Data Out UUID value.

BT_UUID_MESH_PROXY_DATA_OUT

Mesh Proxy Data Out.

BT_UUID_GATT_CLIENT_FEATURES_VAL

Client Supported Features UUID value.

BT_UUID_GATT_CLIENT_FEATURES

Client Supported Features.

BT_UUID_GATT_DB_HASH_VAL

Database Hash UUID value.

BT_UUID_GATT_DB_HASH

Database Hash.

BT_UUID_GATT_SERVER_FEATURES_VAL

Server Supported Features UUID value.

BT_UUID_GATT_SERVER_FEATURES

Server Supported Features.

BT_UUID_AICS_STATE_VAL

Audio Input Control Service State value.

BT_UUID_AICS_STATE

Audio Input Control Service State.

BT_UUID_AICS_GAIN_SETTINGS_VAL

Audio Input Control Service Gain Settings Properties value.

BT_UUID_AICS_GAIN_SETTINGS

Audio Input Control Service Gain Settings Properties.

BT_UUID_AICS_INPUT_TYPE_VAL

Audio Input Control Service Input Type value.

BT_UUID_AICS_INPUT_TYPE

Audio Input Control Service Input Type.

BT_UUID_AICS_INPUT_STATUS_VAL

Audio Input Control Service Input Status value.

BT_UUID_AICS_INPUT_STATUS

Audio Input Control Service Input Status.

BT_UUID_AICS_CONTROL_VAL

Audio Input Control Service Control Point value.

BT_UUID_AICS_CONTROL

Audio Input Control Service Control Point.

BT_UUID_AICS_DESCRIPTION_VAL

Audio Input Control Service Input Description value.

BT_UUID_AICS_DESCRIPTION

Audio Input Control Service Input Description.

BT_UUID_VCS_STATE_VAL

Volume Control Setting value.

BT_UUID_VCS_STATE

Volume Control Setting.

BT_UUID_VCS_CONTROL_VAL

Volume Control Control point value.

BT_UUID_VCS_CONTROL

Volume Control Control point.

BT_UUID_VCS_FLAGS_VAL

Volume Control Flags value.

BT_UUID_VCS_FLAGS

Volume Control Flags.

BT_UUID_VOCS_STATE_VAL

Volume Offset State value.

BT_UUID_VOCS_STATE

Volume Offset State.

BT_UUID_VOCS_LOCATION_VAL

Audio Location value.

BT_UUID_VOCS_LOCATION

Audio Location.

BT_UUID_VOCS_CONTROL_VAL

Volume Offset Control Point value.

BT_UUID_VOCS_CONTROL

Volume Offset Control Point.

BT_UUID_VOCS_DESCRIPTION_VAL

Volume Offset Audio Output Description value.

BT_UUID_VOCS_DESCRIPTION

Volume Offset Audio Output Description.

BT_UUID_CSIS_SET_SIRK_VAL

Set Identity Resolving Key value.

BT_UUID_CSIS_SET_SIRK

Set Identity Resolving Key.

BT_UUID_CSIS_SET_SIZE_VAL

Set size value.

BT_UUID_CSIS_SET_SIZE

Set size.

BT_UUID_CSIS_SET_LOCK_VAL

Set lock value.

BT_UUID_CSIS_SET_LOCK

Set lock.

BT_UUID_CSIS_RANK_VAL

Rank value.

BT_UUID_CSIS_RANK

Rank.

BT_UUID_MCS_PLAYER_NAME_VAL

Media player name value.

BT_UUID_MCS_PLAYER_NAME

Media player name.

BT_UUID_MCS_ICON_OBJ_ID_VAL

Media Icon Object ID value.

BT_UUID_MCS_ICON_OBJ_ID

Media Icon Object ID.

BT_UUID_MCS_ICON_URL_VAL

Media Icon URL value.

BT_UUID_MCS_ICON_URL

Media Icon URL.

BT_UUID_MCS_TRACK_CHANGED_VAL

Track Changed value.

BT_UUID_MCS_TRACK_CHANGED

Track Changed.

BT_UUID_MCS_TRACK_TITLE_VAL

Track Title value.

BT_UUID_MCS_TRACK_TITLE

Track Title.

BT_UUID_MCS_TRACK_DURATION_VAL

Track Duration value.

BT_UUID_MCS_TRACK_DURATION

Track Duration.

BT_UUID_MCS_TRACK_POSITION_VAL

Track Position value.

BT_UUID_MCS_TRACK_POSITION

Track Position.

BT_UUID_MCS_PLAYBACK_SPEED_VAL

Playback Speed value.

BT_UUID_MCS_PLAYBACK_SPEED

Playback Speed.

BT_UUID_MCS_SEEKING_SPEED_VAL

Seeking Speed value.

BT_UUID_MCS_SEEKING_SPEED

Seeking Speed.

BT_UUID_MCS_TRACK_SEGMENTS_OBJ_ID_VAL

Track Segments Object ID value.

BT_UUID_MCS_TRACK_SEGMENTS_OBJ_ID

Track Segments Object ID.

BT_UUID_MCS_CURRENT_TRACK_OBJ_ID_VAL

Current Track Object ID value.

BT_UUID_MCS_CURRENT_TRACK_OBJ_ID

Current Track Object ID.

BT_UUID_MCS_NEXT_TRACK_OBJ_ID_VAL

Next Track Object ID value.

BT_UUID_MCS_NEXT_TRACK_OBJ_ID

Next Track Object ID.

BT_UUID_MCS_PARENT_GROUP_OBJ_ID_VAL

Parent Group Object ID value.

BT_UUID_MCS_PARENT_GROUP_OBJ_ID

Parent Group Object ID.

BT_UUID_MCS_CURRENT_GROUP_OBJ_ID_VAL

Group Object ID value.

BT_UUID_MCS_CURRENT_GROUP_OBJ_ID

Group Object ID.

BT_UUID_MCS_PLAYING_ORDER_VAL

Playing Order value.

BT_UUID_MCS_PLAYING_ORDER

Playing Order.

BT_UUID_MCS_PLAYING_ORDERS_VAL

Playing Orders supported value.

BT_UUID_MCS_PLAYING_ORDERS

Playing Orders supported.

BT_UUID_MCS_MEDIA_STATE_VAL

Media State value.

BT_UUID_MCS_MEDIA_STATE

Media State.

BT_UUID_MCS_MEDIA_CONTROL_POINT_VAL

Media Control Point value.

BT_UUID_MCS_MEDIA_CONTROL_POINT

Media Control Point.

BT_UUID_MCS_MEDIA_CONTROL_OPCODES_VAL

Media control opcodes supported value.

BT_UUID_MCS_MEDIA_CONTROL_OPCODES

Media control opcodes supported.

BT_UUID_MCS_SEARCH_RESULTS_OBJ_ID_VAL

Search result object ID value.

BT_UUID_MCS_SEARCH_RESULTS_OBJ_ID

Search result object ID.

BT_UUID_MCS_SEARCH_CONTROL_POINT_VAL

Search control point value.

BT_UUID_MCS_SEARCH_CONTROL_POINT

Search control point.

BT_UUID_OTS_TYPE_MPL_ICON_VAL

Media Player Icon Object Type value.

BT_UUID_OTS_TYPE_MPL_ICON

Media Player Icon Object Type.

BT_UUID_OTS_TYPE_TRACK_SEGMENT_VAL

Track Segments Object Type value.

BT_UUID_OTS_TYPE_TRACK_SEGMENT

Track Segments Object Type.

BT_UUID_OTS_TYPE_TRACK_VAL

Track Object Type value.

BT_UUID_OTS_TYPE_TRACK

Track Object Type.

BT_UUID_OTS_TYPE_GROUP_VAL

Group Object Type value.

BT_UUID_OTS_TYPE_GROUP

Group Object Type.

BT_UUID_CCID_VAL

Content Control ID value.

BT_UUID_CCID

Content Control ID.

BT_UUID_MICS_MUTE_VAL

Microphone Input Control Service Mute value.

BT_UUID_MICS_MUTE

Microphone Input Control Service Mute.

BT_UUID_ASCS_ASE_SNK_VAL

Audio Stream Endpoint Sink Characteristic value.

BT_UUID_ASCS_ASE_SNK

Audio Stream Endpoint Sink Characteristic.

Audio Stream Endpoint Source Characteristic.

BT_UUID_ASCS_ASE_SRC_VAL

Audio Stream Endpoint Source Characteristic value.

BT_UUID_ASCS_ASE_SRC

BT_UUID_ASCS_ASE_CP_VAL

Audio Stream Endpoint Control Point Characteristic value.

BT_UUID_ASCS_ASE_CP

Audio Stream Endpoint Control Point Characteristic.

BT_UUID_BASS_CONTROL_POINT_VAL

Broadcast Audio Scan Service Scan State value.

BT_UUID_BASS_CONTROL_POINT

Broadcast Audio Scan Service Scan State.

BT_UUID_BASS_RECV_STATE_VAL

Broadcast Audio Scan Service Receive State value.

BT_UUID_BASS_RECV_STATE

Broadcast Audio Scan Service Receive State.

BT_UUID_PACS_SNK_VAL

Sink PAC Characteristic value.

BT_UUID_PACS_SNK

Sink PAC Characteristic.

BT_UUID_PACS_SNK_LOC_VAL

Sink PAC Locations Characteristic value.

BT_UUID_PACS_SNK_LOC

Sink PAC Locations Characteristic.

BT_UUID_PACS_SRC_VAL

Source PAC Characteristic value.

BT_UUID_PACS_SRC

Source PAC Characteristic.

BT_UUID_PACS_SRC_LOC_VAL

Source PAC Locations Characteristic value.

BT_UUID_PACS_SRC_LOC

Source PAC Locations Characteristic.

BT_UUID_PACS_CONTEXT_VAL

Available Audio Contexts Characteristic value.

BT_UUID_PACS_CONTEXT

Available Audio Contexts Characteristic.

BT_UUID_PACS_SUPPORTED_CONTEXT_VAL

Supported Audio Context Characteristic value.

BT_UUID_PACS_SUPPORTED_CONTEXT

Supported Audio Context Characteristic.

BT_UUID_SDP_VAL

BT_UUID_SDP

BT_UUID_UDP_VAL

BT_UUID_UDP

BT_UUID_RFCOMM_VAL

BT_UUID_RFCOMM

BT_UUID_TCP_VAL

BT_UUID_TCP

BT_UUID_TCS_BIN_VAL

BT_UUID_TCS_BIN

BT_UUID_TCS_AT_VAL

BT_UUID_TCS_AT

BT_UUID_ATT_VAL

BT_UUID_ATT

BT_UUID_OBEX_VAL

BT_UUID_OBEX

BT_UUID_IP_VAL

BT_UUID_IP

BT_UUID_FTP_VAL

BT_UUID_FTP

BT_UUID_HTTP_VAL

BT_UUID_HTTP

BT_UUID_BNEP_VAL

BT_UUID_BNEP

BT_UUID_UPNP_VAL

BT_UUID_UPNP

BT_UUID_HIDP_VAL

BT_UUID_HIDP

BT_UUID_HCRP_CTRL_VAL

BT_UUID_HCRP_CTRL

BT_UUID_HCRP_DATA_VAL

BT_UUID_HCRP_DATA

BT_UUID_HCRP_NOTE_VAL

BT_UUID_HCRP_NOTE

BT_UUID_AVCTP_VAL

BT_UUID_AVCTP

BT_UUID_AVDTP_VAL

BT_UUID_AVDTP

BT_UUID_CMTP_VAL

BT_UUID_CMTP

BT_UUID_UDI_VAL

BT_UUID_UDI

BT_UUID_MCAP_CTRL_VAL

BT_UUID_MCAP_CTRL

BT_UUID_MCAP_DATA_VAL

BT_UUID_MCAP_DATA

BT_UUID_L2CAP_VAL

BT_UUID_L2CAP

Enums

enum [anonymous]

Bluetooth UUID types.

Values:

enumerator BT_UUID_TYPE_16

UUID type 16-bit.

enumerator BT_UUID_TYPE_32

UUID type 32-bit.

enumerator BT_UUID_TYPE_128

UUID type 128-bit.

Functions

int bt_uuid_cmp(const struct bt_uuid *u1, const struct bt_uuid *u2)

Compare Bluetooth UUIDs.

Compares 2 Bluetooth UUIDs, if the types are different both UUIDs are first converted to 128 bits format before comparing.

Parameters

• u1 – First Bluetooth UUID to compare

• u2 – Second Bluetooth UUID to compare

Returns

negative value if u1 < u2, 0 if u1 == u2, else positive

bool bt_uuid_create(struct bt_uuid *uuid, const uint8_t *data, uint8_t data_len)

Create a bt_uuid from a little-endian data buffer.

Create a bt_uuid from a little-endian data buffer. The data_len parameter is used to determine whether the UUID is in 16, 32 or 128 bit format (length 2, 4 or 16). Note: 32 bit format is not allowed over the air.

Parameters

• uuid – Pointer to the bt_uuid variable

• data – pointer to UUID stored in little-endian data buffer

• data_len – length of the UUID in the data buffer

Returns

true if the data was valid and the UUID was successfully created.

void bt_uuid_to_str(const struct bt_uuid *uuid, char *str, size_t len)

Convert Bluetooth UUID to string.

Converts Bluetooth UUID to string. UUID can be in any format, 16-bit, 32-bit or 128-bit.

Parameters

• uuid – Bluetooth UUID

• str – pointer where to put converted string

• len – length of str

struct bt_uuid

#include <uuid.h>

This is a ‘tentative’ type and should be used as a pointer only.

struct bt_uuid_16

#include <uuid.h>

Public Members

struct bt_uuid uuid

UUID generic type.

uint16_t val

UUID value, 16-bit in host endianness.

struct bt_uuid_32

#include <uuid.h>

Public Members

struct bt_uuid uuid

UUID generic type.

uint32_t val

UUID value, 32-bit in host endianness.

struct bt_uuid_128

#include <uuid.h>

Public Members

struct bt_uuid uuid

UUID generic type.

uint8_t val[16]

UUID value, 128-bit in little-endian format.