1.. zephyr:board:: b_g474e_dpow1
2
3Overview
4********
5The B-G474E-DPOW1 Discovery kit is a digital power solution and a complete
6demonstration and development platform for the STMicroelectronics STM32G474RET6
7microcontroller. Leveraging the new HRTimer-oriented features, 96 Kbytes of
8embedded RAM, math accelerator functions and USB-PD 3.0 offered by STM32G474RET6,
9the B-G474E-DPOW1 Discovery kit, based on the USB 2.0 FS Type-C™ connector
10interface, helps the user to prototype applications with digital power such as a
11buck-boost converter, RGB power LED lighting or a class-D audio amplifier. The
12B-G474E-DPOW1 Discovery kit does not require any separate probe, as it integrates
13the STLINK-V3E debugger and programmer.
14
15- STM32G474RET6 Arm® Cortex®-M4 core-based microcontroller, featuring 512 Kbytes
16  of Flash memory and 128 Kbytes of SRAM, in LQFP64 package
17- USB Type-C™ with USB 2.0 FS interface compatible with USB-PD 3.0
18- RGB power LED for a bright lighting
19- Digital power buck-boost converter with internal or external Input voltage and
20  with onboard resistor loads
21- Audio Class-D amplifier capable
22- 4 user LEDs
23- 3 LEDs for power and ST-LINK communication
24- 4-direction joystick with a selection button
25- Reset push-button
26- Board connectors:
27    - USB Type-C™
28    - USB Micro-B
29    - 2 x 32-pin header, 2.54 mm pitch, daughterboard extension connector for breadboard connection
30- Flexible power-supply options: ST-LINK USB VBUS or USB Type-C™ VBUS or external source
31- On-board STLINK-V3E debugger/programmer with USB re-enumeration capability: mass storage,
32  Virtual COM port, and debug port
33
34More information about the board can be found at the `B-G474E-DPOW1 website`_.
35
36
37More information about STM32G474RE can be found here:
38
39- `G474RE on www.st.com`_
40- `STM32G4 reference manual`_
41
42
43Supported Features
44==================
45
46.. zephyr:board-supported-hw::
47
48Connections and IOs
49===================
50
51Each of the GPIO pins can be configured by software as output (push-pull or open-drain), as
52input (with or without pull-up or pull-down), or as peripheral alternate function. Most of the
53GPIO pins are shared with digital or analog alternate functions. All GPIOs are high current
54capable except for analog inputs.
55
56Default Zephyr Peripheral Mapping:
57----------------------------------
58
59- UART_3 TX/RX       : PC10/PC11 (ST-Link Virtual Port Com)
60- BUTTON (JOY_SEL)   : PC13
61- BUTTON (JOY_LEFT)  : PC4
62- BUTTON (JOY_DOWN)  : PC5
63- BUTTON (JOY_RIGHT) : PB2
64- BUTTON (JOY_UP)    : PB10
65- LED (DOWN BLUE)    : PA15
66- LED (LEFT ORANGE)  : PB1
67- LED (UP RED)       : PB5
68- LED (RIGHT GREEN)  : PB7
69- USB DM             : PA11
70- USB DP             : PA12
71- UCPD CC2           : PB4
72- UCPD CC1           : PB6
73
74For more details please refer to `B-G474E-DPOW1 Discovery board User Manual`_.
75
76Programming and Debugging
77*************************
78
79The B-G474E-DPOW1 Discovery board includes an ST-LINK/V3E embedded debug tool interface.
80
81Applications for the ``b_g474e_dpow1`` board configuration can be built and
82flashed in the usual way (see :ref:`build_an_application` and
83:ref:`application_run` for more details).
84
85Flashing
86========
87
88The board is configured to be flashed using west `STM32CubeProgrammer`_ runner,
89so its :ref:`installation <stm32cubeprog-flash-host-tools>` is required.
90
91.. code-block:: console
92
93   $ west flash
94
95Flashing an application to the B_G474E_DPOW1
96--------------------------------------------
97
98Here is an example for the :zephyr:code-sample:`blinky` application.
99
100.. zephyr-app-commands::
101   :zephyr-app: samples/basic/blinky
102   :board: b_g474e_dpow1
103   :goals: build flash
104
105You will see the LED blinking every second.
106
107Debugging
108=========
109
110You can debug an application in the usual way. Here is an example for the
111:zephyr:code-sample:`hello_world` application.
112
113.. zephyr-app-commands::
114   :zephyr-app: samples/hello_world
115   :board: b_g474e_dpow1
116   :maybe-skip-config:
117   :goals: debug
118
119References
120**********
121
122.. target-notes::
123
124.. _B-G474E-DPOW1 website:
125   https://www.st.com/en/evaluation-tools/b-g474e-dpow1.html
126
127.. _STM32G4 reference manual:
128   https://www.st.com/resource/en/reference_manual/rm0440-stm32g4-series-advanced-armbased-32bit-mcus-stmicroelectronics.pdf
129
130.. _B-G474E-DPOW1 Discovery board User Manual:
131   https://www.st.com/resource/en/user_manual/um2577-discovery-kit-with-stm32g474re-mcu-stmicroelectronics.pdf
132
133.. _G474RE on www.st.com:
134   https://www.st.com/en/microcontrollers-microprocessors/stm32g474re.html
135
136.. _STM32CubeProgrammer:
137   https://www.st.com/en/development-tools/stm32cubeprog.html
138