org.bluez...ngManager(5)

🦋 org.bluez.LEAdvertisingManager 🦋

okay bestie so this is the page for org.bluez...ngManager(5), straight out of the Linux System Administration manual (yes, that's the manual mane, we stan) 💅. Buckle up, we're learning the BlueZ D-Bus LEAvertisingManager API documentation together and honestly it's giving main character energy ✨

---

🌸 Name 🌸

• org.bluez.LEAdvertisingManager — BlueZ D-Bus LEAvertisingManager API documentation 🫶 (that's the whole name section, we ate and left no crumbs)

---

🎀 Interface 🎀

So the Advertising Manager? It's literally the plug 🔥. It lets external applications register Advertisement Data that should be broadcast to devices. And no cap — Advertisement Data elements must follow the API for LE Advertisement Data described above. like, that's non-negotiable bestie 💜

⭐ Service

• org.bluez

⭐ Interface

• org.bluez.LEAdvertisingManager1

⭐ Object path

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

⭐ Used by

• bluetoothctl(1)

---

✨ Methods ✨

🤖 void RegisterAdvertisement(object advertisement, dict options)

Registers an advertisement object to be sent over the LE Advertising channel. Iconic behaviour, honestly 👑

Yo, heads up: the service must implement the org.bluez.LEAdvertisement(5) interface. No ifs, no buts, iykyk 🧚

Possible errors (aka the vibe check failures 😭):

• org.bluez.Error.InvalidArguments — indicates that the object has invalid or conflicting properties.
• org.bluez.Error.AlreadyExists — indicates the object is already registered. like bestie it's already in the group chat 🙈
• org.bluez.Error.InvalidLength — indicates that the data provided generates a data packet which is too long. too much text, no thoughts, packet said "I'm full" 💀
• org.bluez.Error.NotPermitted — indicates the maximum number of advertisement instances has been reached. capacity is capacity, periodt ✋

Examples:

bluetoothctl
       > advertise <on/off/type>

🤖 void UnregisterAdvertisement(object advertisement)

Unregisters an advertisement that has been previously registered using RegisterAdvertisement(). It's the "leave the group chat" button, and honestly sometimes you gotta 🌈

The object path parameter must match the same value that has been used on registration. Same path or it's not gonna work, bestie 💅

Possible errors:

• org.bluez.Error.InvalidArguments
• org.bluez.Error.DoesNotExist

---

🔥 Properties 🔥

💖 byte ActiveInstances [readonly]

Number of active advertising instances. literally just a count, but a cute one 🎀

💖 byte SupportedInstances [readonly]

Number of available advertising instances.

💖 array{string} SupportedIncludes [readonly]

List of supported system includes. 🦋

Possible values:

• "tx-power"
• "appearance"
• "local-name"
• "rsi"

💖 array{string} SupportedSecondaryChannels [readonly]

List of supported Secondary channels. Secondary channels can be used to advertise with the corresponding PHY. fancy stuff, obsessed ⭐

Possible values:

• "1M"
• "2M"
• "Coded"

💖 dict SupportedCapabilities [readonly]

Enumerates Advertising-related controller capabilities useful to the client. it's literally the controller's resume 📄✨

Possible Values:

• byte MaxAdvLen — Max advertising data length
• byte MaxScnRspLen — Max advertising scan response length
• int16 MinTxPower — Min advertising tx power (dBm)
• int16 MaxTxPower — Max advertising tx power (dBm)

💖 array{string} SupportedFeatures [readonly,optional]

List of supported platform features. If no features are available on the platform, the SupportedFeatures array will be empty. an empty array is still valid, we don't shame 🫶

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.

---

aaaand that's the whole page, bestie 💜 no notes, we understood the assignment. brought to you by BlueZ, dated October 2023 — slay forever, mwah 😘🌸