Skip to content

[nrf52] NUS #5174

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 14 commits into
base: next
Choose a base branch
from
2 changes: 1 addition & 1 deletion Makefile
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
ESPHOME_PATH = ../esphome
ESPHOME_REF = 2025.8.0
ESPHOME_REF = dev
PAGEFIND_VERSION=1.1.1
PAGEFIND=pagefind
NET_PAGEFIND=../pagefindbin/pagefind
Expand Down
2 changes: 1 addition & 1 deletion _static/version
Original file line number Diff line number Diff line change
@@ -1 +1 @@
2025.8.0
2025.9.0-dev
40 changes: 40 additions & 0 deletions components/ble_nus.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
Nordic UART Service (NUS)
=============================

.. seo::
:description: BLE UART support using Nordic UART Service (NUS) for ESPHome logging and communication.

The BLE NUS component provides a Bluetooth Low Energy UART interface based on the Nordic UART Service.
It can be used to stream logs or enable custom bidirectional communication with ESPHome.

.. code-block:: yaml

# Example configuration entry
ble_nus:
type: logs

Configuration variables
-----------------------

- **type** (**Required**, string): Mode of operation. Must be set to ``logs`` to stream ESPHome logs over the BLE UART.

Usage
-----

To connect and view logs from the device over BLE:

.. code-block:: bash

esphome logs d.yaml --device BLE

Or connect to a specific BLE address:

.. code-block:: bash

esphome logs d.yaml --device 00:11:22:33:44:55

See Also
--------

- :ghedit:`Edit`
- `Nordic UART Service <https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/libraries/bluetooth/services/nus.html>`__
1 change: 1 addition & 0 deletions components/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -122,6 +122,7 @@ Bluetooth/BLE
ESP32 BLE Server, components/esp32_ble_server, bluetooth.svg, dark-invert
Bluetooth Proxy, components/bluetooth_proxy, bluetooth.svg, dark-invert
Improv via BLE, components/esp32_improv, improv.svg, dark-invert
Nordic UART Service (NUS), components/ble_nus, uart.svg, dark-invert

Management and Monitoring
-------------------------
Expand Down
4 changes: 2 additions & 2 deletions conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -71,9 +71,9 @@
# built documents.
#
# The short X.Y version.
version = "2025.8"
version = "2025.9"
# The full version, including alpha/beta/rc tags.
release = "2025.8.0"
release = "2025.9.0-dev"

# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
Expand Down