Bluetooth: hci_raw: Fix misleading documentation for bt_send()

jhedberg · kartben · commit 5d6d876567ef · 2025-04-29T13:00:33.000+02:00
The documentation for the HCI raw interface was incorrectly talking about
the need to define buffer pools, when in fact the hci_raw module provides
the necessary API to perform buffer allocation.

Signed-off-by: Johan Hedberg &lt;johan.hedberg@silabs.com&gt;
diff --git a/include/zephyr/bluetooth/hci_raw.h b/include/zephyr/bluetooth/hci_raw.h
@@ -29,10 +29,10 @@ extern "C" {
 
 /** @brief Send packet to the Bluetooth controller
  *
- * Send packet to the Bluetooth controller. Caller needs to
- * implement netbuf pool.
+ * Send packet to the Bluetooth controller. The buffers should be allocated using
+ * bt_buf_get_tx().
  *
- * @param buf netbuf packet to be send
+ * @param buf HCI packet to be sent.
  *
  * @return Zero on success or (negative) error code otherwise.
  */

Original file line number	Diff line number	Diff line change
`@@ -29,10 +29,10 @@ extern "C" {`
`29`	`29`
`30`	`30`	`/** @brief Send packet to the Bluetooth controller`
`31`	`31`	`*`
`32`		`- * Send packet to the Bluetooth controller. Caller needs to`
`33`		`- * implement netbuf pool.`
	`32`	`+ * Send packet to the Bluetooth controller. The buffers should be allocated using`
	`33`	`+ * bt_buf_get_tx().`
`34`	`34`	`*`
`35`		`- * @param buf netbuf packet to be send`
	`35`	`+ * @param buf HCI packet to be sent.`
`36`	`36`	`*`
`37`	`37`	`* @return Zero on success or (negative) error code otherwise.`
`38`	`38`	`*/`