Skip to content

Conversation

eivindj-nordic
Copy link
Contributor

Add ble_adv library documentation.

@eivindj-nordic eivindj-nordic self-assigned this Oct 8, 2025
@eivindj-nordic eivindj-nordic requested review from a team as code owners October 8, 2025 10:45
@github-actions github-actions bot added changelog-entry-required Update changelog before merge. Remove label if entry is not needed or already added. doc-required PR must not be merged without tech writer approval. labels Oct 8, 2025
@github-actions
Copy link

github-actions bot commented Oct 8, 2025

You can find the documentation preview for this PR here.

@eivindj-nordic eivindj-nordic force-pushed the doc_ble_adv branch 2 times, most recently from 67f8346 to 7a536f5 Compare October 8, 2025 11:15

The advertising modes are enabled by Kconfig options. See the :ref:`lib_ble_adv_configure` section below.

When advertising, the module pass through the enabled advertising modes until a connection is made or advertising times out.
Copy link
Contributor

@MirkoCovizzi MirkoCovizzi Oct 10, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
When advertising, the module pass through the enabled advertising modes until a connection is made or advertising times out.
When advertising, the library transitions through the enabled advertising modes until a connection is made or advertising times out.

``Direct High Duty`` is a one-shot burst and its time-out thresholdsand advertising interval cannot be configured.

Whitelist
=========
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Insert a newline.

You should also provide an event handler that is called when advertising transitions to a new mode.
Use the event handler to add functionality, for example to indicate such transitions to the user by flashing an LED when advertising starts, or to power down the application when no peer is found.

If enabled, the event handler must handle requests to update the whitelist (:c:enum:`BLE_ADV_EVT_WHITELIST_REQUEST`) and peer address (:c:enum:`BLE_ADV_EVT_PEER_ADDR_REQUEST``).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If enabled, the event handler must handle requests to update the whitelist (:c:enum:`BLE_ADV_EVT_WHITELIST_REQUEST`) and peer address (:c:enum:`BLE_ADV_EVT_PEER_ADDR_REQUEST``).
If enabled, the event handler must handle requests to update the whitelist (:c:enum:`BLE_ADV_EVT_WHITELIST_REQUEST`) and peer address (:c:enum:`BLE_ADV_EVT_PEER_ADDR_REQUEST`).

Add ble_adv library documentation.

Signed-off-by: Eivind Jølsgard <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

changelog-entry-required Update changelog before merge. Remove label if entry is not needed or already added. doc-required PR must not be merged without tech writer approval.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants