README.rst
1.. zephyr:code-sample:: uart
2 :name: UART circular mode
3 :relevant-api: uart_interface
4
5 Read data from the console and echo it back using a circular dma configuration.
6
7Overview
8********
9
10This sample demonstrates how to use STM32 UART serial driver with DMA in circular mode.
11It reads data from the console and echoes it back.
12
13By default, the UART peripheral that is normally assigned to the Zephyr shell
14is used, hence the majority of boards should be able to run this sample.
15
16Building and Running
17********************
18
19Build and flash the sample as follows, changing ``nucleo_g071rb`` for
20your board:
21
22.. zephyr-app-commands::
23 :zephyr-app: samples/boards/st/uart/circular_dma
24 :board: nucleo_g071rb
25 :goals: build flash
26 :compact:
27
28Sample Output
29=============
30
31.. code-block:: console
32
33 Enter message to fill RX buffer size and press enter :
34 # Type e.g. :
35 # "Lorem Ipsum is simply dummy text of the printing and typesetting industry.
36 # Lorem Ipsum has been the industry's standard dummy text ever since the 1500s,
37 # when an unknown printer took a galley of type and scrambled it to make a type specimen book.
38 # It has survived not only five centuries, but also the leap into electronic typesetting,
39 # remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset
40 # sheets containing Lorem Ipsum passages, and more recently with desktop publishing software
41 # like Aldus PageMaker including versions of Lorem Ipsum."
42
43 Lorem Ipsum is simply dummy text of the printing and typesetting industry.
44 Lorem Ipsum has been the industry's standard dummy text ever since the 1500s,
45 when an unknown printer took a galley of type and scrambled it to make a type specimen book.
46 It has survived not only five centuries, but also the leap into electronic typesetting,
47 remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset
48 sheets containing Lorem Ipsum passages, and more recently with desktop publishing software
49 like Aldus PageMaker including versions of Lorem Ipsum.
50
