merge

Author: tomaszduda23

content/components/_index.md

@@ -123,6 +123,7 @@ ESPHome-specific components or components supporting ESPHome device provisioning
 "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",""
 {{< /imgtable >}}
 
 ## Management and Monitoring

content/components/ble_nus.md

@@ -0,0 +1,39 @@
+---
+description: "Nordic UART Service (NUS)"
+title: "Nordic UART Service (NUS)"
+params:
+  seo:
+    description: BLE UART support using Nordic UART Service (NUS) for ESPHome logging and communication.
+    image: uart.svg
+---
+
+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.
+
+```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:
+
+```bash
+esphome logs d.yaml --device BLE
+```
+
+Or connect to a specific BLE address:
+
+```bash
+esphome logs d.yaml --device 00:11:22:33:44:55
+```
+
+## See Also
+
+- Nordic UART Service <https://docs.nordicsemi.com/bundle/ncs-latest/page/nrf/libraries/bluetooth/services/nus.html>