org.bluez.LEAdvertisingManager(5) Linux System Administration org.bluez.LEAdvertisingManager(5)

# [Name](#Name)

org.bluez.LEAdvertisingManager - BlueZ D-Bus LEAvertisingManager API documentation

# [Interface](#Interface)

The Advertising Manager allows external applications to register Advertisement Data which should be broadcast to devices. Advertisement Data elements must follow the API for LE Advertisement Data described above.

[**Service**](#Service)

org.bluez

[**Interface**](#Interface~2)

org.bluez.LEAdvertisingManager1

[**Object path**](#Object)

/org/bluez/{hci0,hci1,...}

[**Used by**](#Used)

[**bluetoothctl(1)**](/man/os/bluez/bluetoothctl.1)

## [Methods](#Methods)

## [void RegisterAdvertisement(object advertisement, dict options)](#void_RegisterAdvertisement%28object_advertisement,_dict_options%29)

Registers an advertisement object to be sent over the LE Advertising channel.

The service must implement [**org.bluez.LEAdvertisement(5)**](/man/os/bluez/org.bluez.LEAdvertisement.5) interface.

Possible errors:

[**org.bluez.Error.InvalidArguments**](#org.bluez.Error.InvalidArguments)

Indicates that the object has invalid or conflicting properties.

[**org.bluez.Error.AlreadyExists**](#org.bluez.Error.AlreadyExists)

Indicates the object is already registered.

[**org.bluez.Error.InvalidLength**](#org.bluez.Error.InvalidLength)

Indicates that the data provided generates a data packet which is too long.

[**org.bluez.Error.NotPermitted**](#org.bluez.Error.NotPermitted)

Indicates the maximum number of advertisement instances has been reached.

Examples:

[**bluetoothctl**](#bluetoothctl)

> advertise <on/off/type>

## [void UnregisterAdvertisement(object advertisement)](#void_UnregisterAdvertisement%28object_advertisement%29)

Unregisters an advertisement that has been previously registered using **RegisterAdvertisement()**.

The object path parameter must match the same value that has been used on registration.

Possible errors:

[**org.bluez.Error.InvalidArguments**](#org.bluez.Error.InvalidArguments~2)

[**org.bluez.Error.DoesNotExist**](#org.bluez.Error.DoesNotExist)

## [Properties](#Properties)

## [byte ActiveInstances \[readonly\]](#byte_ActiveInstances__readonly_)

Number of active advertising instances.

## [byte SupportedInstances \[readonly\]](#byte_SupportedInstances__readonly_)

Number of available advertising instances.

## [array{string} SupportedIncludes \[readonly\]](#array_string__SupportedIncludes__readonly_)

List of supported system includes.

Possible values:

**"tx-power"**

**"appearance"**

**"local-name"**

**"rsi"**

## [array{string} SupportedSecondaryChannels \[readonly\]](#array_string__SupportedSecondaryChannels__readonly_)

List of supported Secondary channels. Secondary channels can be used to advertise with the corresponding PHY.

Possible values:

**"1M"**

**"2M"**

**"Coded"**

## [dict SupportedCapabilities \[readonly\]](#dict_SupportedCapabilities__readonly_)

Enumerates Advertising-related controller capabilities useful to the client.

Possible Values:

[**byte MaxAdvLen**](#byte)

Max advertising data length

[**byte MaxScnRspLen**](#byte~2)

Max advertising scan response length

[**int16 MinTxPower**](#int16)

Min advertising tx power (dBm)

[**int16 MaxTxPower**](#int16~2)

Max advertising tx power (dBm)

## [array{string} SupportedFeatures \[readonly,optional\]](#array_string__SupportedFeatures__readonly,optional_)

List of supported platform features. If no features are available on the platform, the SupportedFeatures array will be empty.

Possible values:

**"CanSetTxPower"**

Indicates whether platform can specify tx power on each advertising instance.

**"HardwareOffload"**

Indicates whether multiple advertising will be offloaded to the controller.

October 2023 BlueZ

---

Document: org.bluez.LEAdvertisingManager(5) from bluez 5.87-r2 (Chainguard OS)
Source: https://github.com/bluez/bluez