1.. zephyr:board:: stm32373c_eval
2
3Overview
4********
5The STM32373C-EVAL evaluation board is designed as a complete demonstration and development platform for STMicroelectronics ARM Cortex-M4 core-based STM32F373VCT6 microcontroller.
6
7The full range of hardware features on the board can help the user evaluate all peripherals (USB FS, USART, audio DAC, microphone ADC, dot-matrix LCD, IrDA, LDR, MicroSD card, HDMI CEC, ECG, pressure sensor, CAN, IR transmitter and receiver, EEPROM, touch slider, temperature sensor, etc.) and develop their own applications.
8
9Extension headers make it possible to easily connect a daughter board or wrapping board for a specific application.
10
11More information about the board can be found at the `STM32373C-EVAL website`_.
12
13Hardware
14********
15
16STM32373C-EVAL provides the following hardware components:
17
18- STM32F373VCT6 microcontroller
19- Four 5 V power supply options:
20    - Power jack
21    - ST-LINK/V2 USB connector
22    - User USB connector
23    - Daughter board
24- Audio jack connected to I2 S DAC
25- Microphone connected to ADC through an amplifier
26- 2-GByte (or more) MicroSD card on SPI
27- Three components on I2 C bus: temperature sensor, EEPROM and dual interface RF EEPROM
28- RS-232 communication configurable for communication of Flash loader
29- IrDA transceiver
30- 240x320 TFT color LCD connected to SPI interface
31- Joystick with 4-direction control and selector
32- Reset, Wakeup or Tamper, and Key buttons
33- 4 color user LEDs
34- 2 LEDs for MCU power range indicator
35- ECG, pressure sensor and PT100 temperature sensor connected to the 16-bit Sigma Delta ADC of STM32F373VCT6
36- Extension connectors for daughter board or wrapping board
37- MCU voltage: 3.3 V or adjustable 2.0 V - 3.6 V
38- USB FS connector
39- Touch slider
40- RTC with backup battery
41- CAN 2.0 A/B compliant connection
42- Light dependent resistor (LDR)
43- Two HDMI connectors with DDC and CEC
44- IR transmitter and receiver
45- Two ADC & DAC input and output signal connectors and one Sigma Delta ADC input signal connector
46- Potentiometer
47- JTAG/SWD and ETM trace debug support
48- Embedded ST-LINK/V2
49
50More information about STM32F373VCT6 can be found here:
51       - `STM32F373VCT6 reference manual`_
52
53
54Supported Features
55==================
56
57The Zephyr stm32373c_eval board configuration supports the following hardware features:
58
59+-----------+------------+-------------------------------------+
60| Interface | Controller | Driver/Component                    |
61+===========+============+=====================================+
62| NVIC      | on-chip    | nested vector interrupt controller  |
63+-----------+------------+-------------------------------------+
64| UART      | on-chip    | serial port-polling;                |
65|           |            | serial port-interrupt               |
66+-----------+------------+-------------------------------------+
67| PINMUX    | on-chip    | pinmux                              |
68+-----------+------------+-------------------------------------+
69| GPIO      | on-chip    | gpio                                |
70+-----------+------------+-------------------------------------+
71| CLOCK     | on-chip    | reset and clock control             |
72+-----------+------------+-------------------------------------+
73| FLASH     | on-chip    | flash memory                        |
74+-----------+------------+-------------------------------------+
75| WATCHDOG  | on-chip    | independent watchdog                |
76+-----------+------------+-------------------------------------+
77
78Other hardware features are not yet supported in this Zephyr port.
79
80The default configuration can be found in
81:zephyr_file:`boards/st/stm32373c_eval/stm32373c_eval_defconfig`
82
83Connections and IOs
84===================
85
86Each of the GPIO pins can be configured by software as output (push-pull or open-drain), as
87input (with or without pull-up or pull-down), or as peripheral alternate function. Most of the
88GPIO pins are shared with digital or analog alternate functions. All GPIOs are high current
89capable except for analog inputs.
90
91Board connectors:
92-----------------
93.. image:: img/stm32373c_eval_connectors.jpg
94     :align: center
95     :alt: STM32373C_EVAL connectors
96
97Default Zephyr Peripheral Mapping:
98----------------------------------
99- UART_2_TX : PD5
100- UART_2_RX : PD6
101- USER_PB   : PA2
102- LED2      : PC1
103
104Programming and Debugging
105*************************
106
107Applications for the ``stm32373c_eval`` board configuration can be built and
108flashed in the usual way (see :ref:`build_an_application` and
109:ref:`application_run` for more details).
110
111Flashing
112========
113
114STM32373C-EVAL board includes an ST-LINK/V2-1 embedded debug tool interface.
115At power-on, the board is in firmware-upgrade mode (also called DFU for
116"Device Firmware Upgrade"), allowing the firmware to be updated through the USB.
117This interface is supported by the openocd version included in Zephyr SDK.
118
119Flashing an application to STM32373C-EVAL
120-----------------------------------------
121
122Here is an example for the :zephyr:code-sample:`blinky` application.
123
124.. zephyr-app-commands::
125   :zephyr-app: samples/basic/blinky
126   :board: stm32373c_eval
127   :goals: build flash
128
129You will see the LED blinking every second.
130
131Debugging
132=========
133
134You can debug an application in the usual way.  Here is an example for the
135:zephyr:code-sample:`blinky` application.
136
137.. zephyr-app-commands::
138   :zephyr-app: samples/basic/blinky
139   :board: stm32373c_eval
140   :maybe-skip-config:
141   :goals: debug
142
143References
144**********
145
146.. target-notes::
147
148.. _STM32373C-EVAL website:
149   https://www.st.com/en/evaluation-tools/stm32373c-eval.html
150
151.. _STM32F373VCT6 reference manual:
152   https://www.st.com/resource/en/reference_manual/dm00041563.pdf
153