Skip to content

Commit 89eae64

Browse files
committed
Bluetooth: Host: Amend recycled() callback documentation
The API documentation for the recycled() callback predates [1], and still warns users to "treat this callback as an ISR", although it now runs on the system work-queue thread, as does disconnected(). "Making Bluetooth API calls" to "re-start connectable advertising or scanning", as suggested, should no longer be "strongly discouraged". [1] efb5d83: Bluetooth: Host: Defer `conn.recycled()` to the syswq Signed-off-by: Christophe Dufaza <[email protected]>
1 parent 6129f50 commit 89eae64

File tree

1 file changed

+2
-4
lines changed
  • include/zephyr/bluetooth

1 file changed

+2
-4
lines changed

include/zephyr/bluetooth/conn.h

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1701,10 +1701,8 @@ struct bt_conn_cb {
17011701
*
17021702
* Use this to e.g. re-start connectable advertising or scanning.
17031703
*
1704-
* Treat this callback as an ISR, as it originates from
1705-
* @ref bt_conn_unref which is used by the BT stack. Making
1706-
* Bluetooth API calls in this context is error-prone and strongly
1707-
* discouraged.
1704+
* This callback runs on the system-worqueue thread,
1705+
* the usual precautions apply.
17081706
*/
17091707
void (*recycled)(void);
17101708

0 commit comments

Comments
 (0)