From 282a755a27b8bf27e6cdc21e12781bc61affc05c Mon Sep 17 00:00:00 2001 From: Tomasz Duda Date: Thu, 5 Mar 2026 22:57:43 +0100 Subject: [PATCH 1/4] [ble_nus] add uart doc --- src/content/docs/components/ble_nus.mdx | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/src/content/docs/components/ble_nus.mdx b/src/content/docs/components/ble_nus.mdx index 0305f0ab8d..a7455241fc 100644 --- a/src/content/docs/components/ble_nus.mdx +++ b/src/content/docs/components/ble_nus.mdx @@ -14,7 +14,12 @@ ble_nus: ## Configuration variables -- **type** (*Optional*, string): Mode of operation. Must be set to ``logs`` to stream ESPHome logs over the BLE UART. +- **type** (*Optional*, string): Mode of operation. One of `logs` or `uart`. + `logs` streams ESPHome logs over the BLE UART. `uart` can be used as uart over BLE. +- **rx_buffer_size** (*Optional*, int): Size of the receive buffer in bytes. Range: 160-8192. Defaults to `512`. + Valid only for mode `uart`. +- **tx_buffer_size** (*Optional*, int): Size of the transmit buffer in bytes. Range: 160-8192. Defaults to `512`. +- **debug** (*Optional*, mapping): Options for debugging communication on the UART hub, see [Debugging](#uart-debugging). ## Usage @@ -30,6 +35,9 @@ Or connect to a specific BLE address: esphome logs d.yaml --device 00:11:22:33:44:55 ``` +`uart` can be used with python BLE Serial + ## See Also -- Nordic UART Service [https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/libraries/bluetooth/services/nus.html](https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/libraries/bluetooth/services/nus.html) +- [Nordic UART Service](https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/libraries/bluetooth/services/nus.html) +- [BLE Serial](https://pypi.org/project/ble-serial) From 69a8401544986f2a1c24ff0aac09519337e04da0 Mon Sep 17 00:00:00 2001 From: Tomasz Duda Date: Thu, 5 Mar 2026 23:03:15 +0100 Subject: [PATCH 2/4] fix --- src/content/docs/components/ble_nus.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/components/ble_nus.mdx b/src/content/docs/components/ble_nus.mdx index a7455241fc..7d5e694ded 100644 --- a/src/content/docs/components/ble_nus.mdx +++ b/src/content/docs/components/ble_nus.mdx @@ -19,7 +19,7 @@ ble_nus: - **rx_buffer_size** (*Optional*, int): Size of the receive buffer in bytes. Range: 160-8192. Defaults to `512`. Valid only for mode `uart`. - **tx_buffer_size** (*Optional*, int): Size of the transmit buffer in bytes. Range: 160-8192. Defaults to `512`. -- **debug** (*Optional*, mapping): Options for debugging communication on the UART hub, see [Debugging](#uart-debugging). +- **debug** (*Optional*, mapping): Options for debugging communication on the UART hub, see [Debugging](/components/uart#uart-debugging). ## Usage From 84e9f3769a972ee248acfd34b9ab191c85acbb7a Mon Sep 17 00:00:00 2001 From: Tomasz Duda Date: Thu, 5 Mar 2026 23:06:11 +0100 Subject: [PATCH 3/4] fix --- src/content/docs/components/ble_nus.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/components/ble_nus.mdx b/src/content/docs/components/ble_nus.mdx index 7d5e694ded..a5d1318843 100644 --- a/src/content/docs/components/ble_nus.mdx +++ b/src/content/docs/components/ble_nus.mdx @@ -15,7 +15,7 @@ ble_nus: ## Configuration variables - **type** (*Optional*, string): Mode of operation. One of `logs` or `uart`. - `logs` streams ESPHome logs over the BLE UART. `uart` can be used as uart over BLE. + `logs` streams ESPHome logs. `uart` provides two direction communication. Defaults to `logs`. - **rx_buffer_size** (*Optional*, int): Size of the receive buffer in bytes. Range: 160-8192. Defaults to `512`. Valid only for mode `uart`. - **tx_buffer_size** (*Optional*, int): Size of the transmit buffer in bytes. Range: 160-8192. Defaults to `512`. From 3b465f2b0427ab51a43cd81ac55ebb530ed71983 Mon Sep 17 00:00:00 2001 From: Keith Burzinski Date: Sun, 8 Mar 2026 04:06:41 -0500 Subject: [PATCH 4/4] copy --- src/content/docs/components/ble_nus.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/components/ble_nus.mdx b/src/content/docs/components/ble_nus.mdx index a5d1318843..a52ce12d35 100644 --- a/src/content/docs/components/ble_nus.mdx +++ b/src/content/docs/components/ble_nus.mdx @@ -15,7 +15,7 @@ ble_nus: ## Configuration variables - **type** (*Optional*, string): Mode of operation. One of `logs` or `uart`. - `logs` streams ESPHome logs. `uart` provides two direction communication. Defaults to `logs`. + `logs` streams ESPHome logs. `uart` provides bi-directional communication. Defaults to `logs`. - **rx_buffer_size** (*Optional*, int): Size of the receive buffer in bytes. Range: 160-8192. Defaults to `512`. Valid only for mode `uart`. - **tx_buffer_size** (*Optional*, int): Size of the transmit buffer in bytes. Range: 160-8192. Defaults to `512`.