1.. zephyr:code-sample:: uart-stm32-single-wire
2   :name: Single-wire UART
3   :relevant-api: uart_interface
4
5   Use single-wire/half-duplex UART functionality of STM32 devices.
6
7Overview
8********
9
10A simple application demonstrating how to use the single-wire/half-duplex
11UART functionality of STM32 devices. The example runs on various STM32
12boards with minimal adaptations.
13Add a ``single_wire_uart_loopback`` fixture to your board in the hardware map to allow
14twister to verify this sample's output automatically.
15
16Hardware Setup
17**************
18
19You need to establish a physical connection between UART pins on the board.
20Refer to the specific board overlay file for the exact pin connections.
21
22Building and Running
23********************
24
25Build and flash as follows, replacing ``stm32f3_disco`` with your board:
26
27 .. zephyr-app-commands::
28    :zephyr-app: samples/boards/st/uart/single_wire
29    :board: stm32f3_disco
30    :goals: build flash
31    :compact:
32
33After flashing the console output should not show any failure reports,
34but the following message repeated every 2s:
35
36.. code-block:: none
37
38    Received c
39