zephyr/samples/drivers/uart/stm32/single_wire
Keith Packard 0b90fd5adf samples, tests, boards: Switch main return type from void to int
As both C and C++ standards require applications running under an OS to
return 'int', adapt that for Zephyr to align with those standard. This also
eliminates errors when building with clang when not using -ffreestanding,
and reduces the need for compiler flags to silence warnings for both clang
and gcc.

Most of these changes were automated using coccinelle with the following
script:

@@
@@
- void
+ int
main(...) {
	...
-	return;
+	return 0;
	...
}

Approximately 40 files had to be edited by hand as coccinelle was unable to
fix them.

Signed-off-by: Keith Packard <keithp@keithp.com>
2023-04-14 07:49:41 +09:00
..
boards
src samples, tests, boards: Switch main return type from void to int 2023-04-14 07:49:41 +09:00
CMakeLists.txt
prj.conf
README.rst
sample.yaml

.. _sample_uart_stm32_single_wire:

STM32 Single Wire UART
######################

Overview
********

A simple application demonstrating how to use the single wire / half-duplex UART
functionality of STM32. Without adaptions this example runs on STM32F3 discovery
board. You need to establish a physical connection between pins PA2 (USART2_TX) and
PC10 (UART4_TX).

Add a `single_wire_uart_loopback` fixture to your board in the hardware map to allow
twister to verify this sample's output automatically.

Building and Running
********************

Build and flash as follows, replacing ``stm32f3_disco`` with your board:

 .. zephyr-app-commands::
    :zephyr-app: samples/drivers/uart/stm32/single_wire
    :board: stm32f3_disco
    :goals: build flash
    :compact:

After flashing the console output should not show any failure reports,
but the following message repeated every 2s:

.. code-block:: none

    Received c