-
Notifications
You must be signed in to change notification settings - Fork 6.7k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
board: arm: Add support for WeAct Mini STM32H7B0
This board is mostly the same as mini_stm32h743. Noatable diffrences for dt: - rcc config - octospi in quadspi mode - pinmux naming for USB and quadspi Signed-off-by: Sahaj Sarup <[email protected]>
- Loading branch information
Showing
9 changed files
with
557 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,35 @@ | ||
# Copyright (c) 2024 Linaro Limited | ||
# SPDX-License-Identifier: Apache-2.0 | ||
|
||
# WeAct Studio MiniSTM32H7B0 board configuration | ||
|
||
if BOARD_MINI_STM32H7B0 | ||
|
||
if DISPLAY | ||
|
||
config INPUT | ||
default y | ||
|
||
if LVGL | ||
|
||
config LV_COLOR_16_SWAP | ||
default y | ||
|
||
config LV_Z_BITS_PER_PIXEL | ||
default 16 | ||
|
||
endif # LVGL | ||
|
||
endif # DISPLAY | ||
|
||
if USB_DEVICE_STACK | ||
|
||
config UART_CONSOLE | ||
default CONSOLE | ||
|
||
config USB_DEVICE_INITIALIZE_AT_BOOT | ||
default y | ||
|
||
endif # USB_DEVICE_STACK | ||
|
||
endif # BOARD_MINI_STM32H7B0 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
# Copyright (c) 2024 Linaro Limited | ||
# SPDX-License-Identifier: Apache-2.0 | ||
|
||
config BOARD_MINI_STM32H7B0 | ||
select SOC_STM32H7B0XX |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,8 @@ | ||
# Copyright (c) 2024 Linaro Limited | ||
# SPDX-License-Identifier: Apache-2.0 | ||
|
||
board_runner_args(dfu-util "--pid=0483:df11" "--alt=0" "--dfuse") | ||
board_runner_args(jlink "--device=STM32H7B0VB" "--speed=4000") | ||
|
||
include(${ZEPHYR_BASE}/boards/common/dfu-util.board.cmake) | ||
include(${ZEPHYR_BASE}/boards/common/jlink.board.cmake) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,6 @@ | ||
board: | ||
name: mini_stm32h7b0 | ||
full_name: MiniSTM32H7B0 Core Board | ||
vendor: weact | ||
socs: | ||
- name: stm32h7b0xx |
Binary file not shown.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,238 @@ | ||
.. zephyr:board:: mini_stm32h7b0 | ||
Overview | ||
******** | ||
|
||
The MiniSTM32H7B0 Core board is a compact development board equipped with | ||
an STM32H7B0VBT6 microcontroller. It features a variety of peripherals, | ||
including a user LED and button, a display, and external SPI and QuadSPI | ||
NOR flash memory. | ||
|
||
Key Features | ||
|
||
- STM32 microcontroller in LQFP100 package | ||
- USB OTG or full-speed device | ||
- 1 user LED | ||
- User, boot, and reset push-buttons | ||
- 32.768 kHz and 25MHz HSE crystal oscillators | ||
- External NOR Flash memories: 64-Mbit Quad-SPI and 64-Mbit SPI | ||
- Board connectors: | ||
- Camera (8 bit) connector | ||
- ST7735 TFT-LCD 160 x 80 pixels (RGB565 3-SPI) | ||
- microSD |trade| card | ||
- USB Type-C Connector | ||
- SWD header for external debugger | ||
- 2x 40-pin GPIO connector | ||
|
||
.. figure:: img/stm32h7xx.webp | ||
:align: center | ||
:alt: MiniSTM32H7B0 Core Board | ||
|
||
MiniSTM32H7B0 Core Board (Credit: WeAct Studio) | ||
|
||
More information about the board can be found on the `Mini_STM32H7B0 website`_. | ||
|
||
Hardware | ||
******** | ||
|
||
The MiniSTM32H743 Core board provides the following hardware components: | ||
|
||
- STM32H7B0VBT6 in LQFP100 package | ||
- ARM 32-bit Cortex-M7 CPU with FPU | ||
- Chrom-ART Accelerator | ||
- Hardware JPEG Codec | ||
- 280 MHz max CPU frequency | ||
- VDD from 1.62 V to 3.6 V | ||
- 128 KB Flash | ||
- 1.4 MB SRAM | ||
- High-resolution timer (2.1 ns) | ||
- 32-bit timers(2) | ||
- 16-bit timers(10) | ||
- SPI(5) | ||
- I2C(4) | ||
- I2S (4) | ||
- USART(5) | ||
- UART(5) | ||
- USB OTG Full Speed and High Speed(1) | ||
- CAN FD(2) | ||
- SAI(4) | ||
- SPDIF_Rx(4) | ||
- HDMI_CEC(1) | ||
- Dual Mode Quad SPI(1) | ||
- Camera Interface | ||
- GPIO (up to 80) with external interrupt capability | ||
- 16-bit ADC(2) with 16 channels | ||
- 12-bit DAC with 2 channels(2) | ||
- True Random Number Generator (RNG) | ||
- 16-channel DMA | ||
- LCD-TFT Controller with XGA resolution | ||
|
||
More information about STM32H7BO can be found here: | ||
|
||
- `STM32H7B0VB on www.st.com`_ | ||
- `STM32H7B0VB reference manual`_ | ||
- `STM32H7B0VB datasheet`_ | ||
|
||
Supported Features | ||
================== | ||
|
||
The ``mini_stm32h7b0`` board target supports the following hardware features: | ||
|
||
+-----------+------------+-------------------------------------+ | ||
| Interface | Controller | Driver/Component | | ||
+===========+============+=====================================+ | ||
| NVIC | on-chip | nested vector interrupt controller | | ||
+-----------+------------+-------------------------------------+ | ||
| WDT | on-chip | watchdog | | ||
+-----------+------------+-------------------------------------+ | ||
| PINMUX | on-chip | pinmux | | ||
+-----------+------------+-------------------------------------+ | ||
| FLASH | on-chip | flash memory | | ||
+-----------+------------+-------------------------------------+ | ||
| GPIO | on-chip | gpio | | ||
+-----------+------------+-------------------------------------+ | ||
| SPI | on-chip | spi | | ||
+-----------+------------+-------------------------------------+ | ||
| QSPI NOR | on-chip | off-chip flash | | ||
+-----------+------------+-------------------------------------+ | ||
| SDMMC | on-chip | disk access | | ||
+-----------+------------+-------------------------------------+ | ||
| DISPLAY | on-chip | display | | ||
+-----------+------------+-------------------------------------+ | ||
|
||
Other hardware features have not been enabled yet for this board. | ||
|
||
The default configuration per core can be found in the defconfig file: | ||
``boards/weact/mini_stm32h743/mini_stm32h7b0_defconfig`` | ||
|
||
Pin Mapping | ||
=========== | ||
|
||
MiniSTM32H7B0 Core board has 5 GPIO controllers. These controllers are responsible for pin muxing, | ||
input/output, pull-up, etc. | ||
|
||
For more details please refer to `Mini_STM32H7B0 website`_. | ||
|
||
Default Zephyr Peripheral Mapping: | ||
---------------------------------- | ||
|
||
The MiniSTM32H743 Core board is configured as follows | ||
|
||
- USER_LED : PE3 | ||
- USER_PB : PC13 | ||
- SPI1 SCK/MISO/MOSI/NSS : PB3/PB4/PD7/PD6 (NOR Flash memory) | ||
- SPI4 SCK/MOSI/NSS : PE12/PE14/PE11 (LCD) | ||
- QuadSPI CLK/NCS/IO0/IO1/IO2/IO3 : PB2/PB6/PD11/PD12/PE2/PD13 (NOR Flash memory) | ||
- SDMMC1 CLK/DCMD/CD/D0/D1/D2/D3 : PC12/PD2/PD4/PC8/PC9/PC10/PC11 (microSD card) | ||
- USB DM/DP : PA11/PA12 (USB CDC ACM) | ||
|
||
System Clock | ||
============ | ||
|
||
The STM32H7B0VB System Clock can be driven by an internal or external oscillator, | ||
as well as by the main PLL clock. By default, the System clock is driven | ||
by the PLL clock at 280MHz. PLL clock is fed by a 25MHz high speed external clock. | ||
|
||
Serial Port (USB CDC ACM) | ||
========================= | ||
|
||
The Zephyr console output is assigned to the USB CDC ACM virtual serial port. | ||
Virtual COM port interface. Default communication settings are 115200 8N1. | ||
|
||
Programming and Debugging | ||
************************* | ||
|
||
The MiniSTM32H7B0 Core board facilitates firmware flashing via the USB DFU | ||
bootloader. This method simplifies the process of updating images, although | ||
it doesn't provide debugging capabilities. However, the board provides header | ||
pins for the Serial Wire Debug (SWD) interface, which can be used to connect | ||
an external debugger, such as ST-Link. | ||
|
||
Flashing | ||
======== | ||
|
||
To activate the bootloader, follow these steps: | ||
|
||
1. Press and hold the BOOT0 key. | ||
2. While still holding the BOOT0 key, press and release the RESET key. | ||
3. Wait for 0.5 seconds, then release the BOOT0 key. | ||
|
||
Upon successful execution of these steps, the device will transition into | ||
bootloader mode and present itself as a USB DFU Mode device. You can program | ||
the device using the west tool or the STM32CubeProgrammer. | ||
|
||
Flashing an application to MiniSTM32H743 | ||
---------------------------------------- | ||
|
||
Here is an example for the :zephyr:code-sample:`hello_world` application. | ||
|
||
First, put the board in bootloader mode as described above. Then build and flash | ||
the application in the usual way. Just add ``CONFIG_BOOT_DELAY=5000`` to the | ||
configuration, so that USB CDC ACM is initialized before any text is printed, | ||
as below: | ||
|
||
.. zephyr-app-commands:: | ||
:zephyr-app: samples/hello_world | ||
:board: mini_stm32h7b0 | ||
:goals: build flash | ||
:gen-args: -DCONFIG_BOOT_DELAY=5000 | ||
|
||
Run a serial host program to connect with your board: | ||
|
||
.. code-block:: console | ||
$ minicom -D <tty_device> -b 115200 | ||
Then, press the RESET button, you should see the following message after few seconds: | ||
|
||
.. code-block:: console | ||
Hello World! mini_stm32h7b0 | ||
Replace :code:`<tty_device>` with the port where the board XIAO BLE | ||
can be found. For example, under Linux, :code:`/dev/ttyACM0`. | ||
|
||
Debugging | ||
--------- | ||
|
||
This current Zephyr port does not support debugging. | ||
|
||
Testing the LEDs in the MiniSTM32H7B0 | ||
************************************* | ||
|
||
There is a sample that allows to test that LED on the board are working | ||
properly with Zephyr: | ||
|
||
.. zephyr-app-commands:: | ||
:zephyr-app: samples/basic/blinky | ||
:board: mini_stm32h7b0 | ||
:goals: build flash | ||
:gen-args: -DCONFIG_BOOT_DELAY=5000 | ||
|
||
You can build and flash the examples to make sure Zephyr is running correctly on | ||
your board. The LED definitions can be found in | ||
:zephyr_file:`boards/weact/mini_stm32h743/mini_stm32h7b0.dts`. | ||
|
||
Testing shell over USB in the MiniSTM32H7B0 | ||
******************************************* | ||
|
||
There is a sample that allows to test shell interface over USB CDC ACM interface | ||
with Zephyr: | ||
|
||
.. zephyr-app-commands:: | ||
:zephyr-app: samples/subsys/shell/shell_module | ||
:board: mini_stm32h7b0 | ||
:goals: build flash | ||
:gen-args: -DCONFIG_BOOT_DELAY=5000 | ||
|
||
.. _Mini_STM32H7B0 website: | ||
https://github.com/WeActStudio/WeActStudio.MiniSTM32H7B0 | ||
|
||
.. _STM32H7B0VB on www.st.com: | ||
https://www.st.com/en/microcontrollers-microprocessors/stm32h7b0vb.html | ||
|
||
.. _STM32H7B0VB reference manual: | ||
https://www.st.com/resource/en/reference_manual/rm0455-stm32h7a37b3-and-stm32h7b0-value-line-advanced-armbased-32bit-mcus-stmicroelectronics.pdf | ||
|
||
.. _STM32H7B0VB datasheet: | ||
https://www.st.com/resource/en/datasheet/stm32h7b0vb.pdf |
Oops, something went wrong.