-
Notifications
You must be signed in to change notification settings - Fork 7.8k
boards: fk723m1_zgt6: initial support #94299
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
paulwedeck
wants to merge
1
commit into
zephyrproject-rtos:main
Choose a base branch
from
paulwedeck:fk723m1
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
+428
−0
Open
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or 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,12 @@ | ||
# Copyright (c) 2025 Paul Wedeck <[email protected]> | ||
# SPDX-License-Identifier: Apache-2.0 | ||
|
||
config BOARD_FK723M1_ZGT6 | ||
select SOC_STM32H723XX | ||
|
||
if BOARD_FK723M1_ZGT6 | ||
|
||
config SDMMC_STM32_CLOCK_CHECK | ||
default n | ||
|
||
endif # BOARD_FK723M1_ZGT6 |
This file contains hidden or 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,10 @@ | ||
# SPDX-License-Identifier: Apache-2.0 | ||
|
||
# keep first | ||
board_runner_args(stm32cubeprogrammer "--port=swd" "--reset-mode=sw") | ||
board_runner_args(jlink "--device=STM32H723ZG" "--speed=4000") | ||
|
||
# keep first | ||
include(${ZEPHYR_BASE}/boards/common/stm32cubeprogrammer.board.cmake) | ||
include(${ZEPHYR_BASE}/boards/common/openocd.board.cmake) | ||
include(${ZEPHYR_BASE}/boards/common/jlink.board.cmake) |
This file contains hidden or 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: fk723m1_zgt6 | ||
full_name: FK723M1-ZGT6 | ||
vendor: fanke | ||
socs: | ||
- name: stm32h723xx |
Binary file not shown.
This file contains hidden or 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,173 @@ | ||
.. zephyr:board:: fk723m1_zgt6 | ||
|
||
Overview | ||
******** | ||
|
||
The FK723M1-ZGT6 board is a development board for the STM32H723ZGT6 SoC. | ||
|
||
Key Features | ||
|
||
- STM32 microcontroller in LQFP144 package | ||
- USB OTG or full-speed device | ||
- 1 user LEDs | ||
- 1 boot and reset push-buttons | ||
- 15 MHz and 32.768 kHz crystal oscillators | ||
|
||
Board connectors: | ||
- USB with USB-C | ||
- FPC10P LCD connector | ||
- FPC20P Camera connector | ||
- 8 pin debug connector | ||
|
||
More information about the board can be found at the `FK723M1-ZGT6 Schematic`_. | ||
|
||
Hardware | ||
******** | ||
|
||
FK723M1-ZGT6 provides the following hardware components: | ||
|
||
- STM32H723ZG in LQFP144 package | ||
- ARM 32-bit Cortex-M7 CPU with FPU | ||
- Chrom-ART Accelerator | ||
- Hardware JPEG Codec | ||
- 550 MHz max CPU frequency | ||
- VDD from 1.62 V to 3.6 V | ||
- 1 MB Flash | ||
- 562 kB SRAM max (376 kb used currently) | ||
- High-resolution timer (2.1 ns) | ||
- 32-bit timers(2) | ||
- 16-bit timers(12) | ||
- SPI(6) | ||
- I2C(4) | ||
- I2S (3) | ||
- USART(4) | ||
- UART(4) | ||
- USB OTG Full Speed(1) | ||
- CAN FD(2) | ||
- SAI(2) | ||
- SPDIF_Rx(4) | ||
- HDMI_CEC(1) | ||
- Dual Mode Quad SPI(1) | ||
- Camera Interface | ||
- GPIO (up to 114) with external interrupt capability | ||
- 16-bit ADC(3) with 36 channels / 3.6 MSPS | ||
- 12-bit DAC with 2 channels(2) | ||
- True Random Number Generator (RNG) | ||
- 16-channel DMA | ||
- LCD-TFT Controller with XGA resolution | ||
|
||
Supported Features | ||
================== | ||
|
||
.. zephyr:board-supported-hw:: | ||
|
||
Default Zephyr Peripheral Mapping: | ||
---------------------------------- | ||
|
||
The FK723M1-ZGT6 board features one USB port, two 30x2 pin headers, one 4x2 debug header, | ||
one micro SD slot, one FPC10P LCD interface, one FPC20P Camera interface and one built-in external Quad SPI flash. | ||
The board is configured as follows: | ||
|
||
- UART_1 TX/RX : PA9/PA10 (debug header UART) | ||
- LD1 : PG7 | ||
|
||
System Clock | ||
------------ | ||
|
||
FK723M1-ZGT6 System Clock could be driven by an internal or external | ||
oscillator, as well as the main PLL clock. By default, the System clock is | ||
driven by the PLL clock at 550MHz, driven by an 15MHz high-speed external clock. | ||
|
||
Serial Port | ||
----------- | ||
|
||
FK723M1-ZGT6 board has 4 UARTs and 4 USARTs. The Zephyr console output is | ||
assigned to UART1. Default settings are 115200 8N1. | ||
|
||
Programming and Debugging | ||
************************* | ||
|
||
FK723M1-ZGT6 provides a special SWD header. | ||
|
||
Flashing | ||
======== | ||
|
||
The board is configured to be flashed using west `STM32CubeProgrammer`_ runner, | ||
so its :ref:`installation <stm32cubeprog-flash-host-tools>` is required. | ||
|
||
Alternatively, OpenOCD or JLink can also be used to flash the board using | ||
the ``--runner`` (or ``-r``) option: | ||
|
||
.. code-block:: console | ||
|
||
$ west flash --runner openocd | ||
$ west flash --runner jlink | ||
|
||
Flashing an application to FK723M1-ZGT6 | ||
---------------------------------------- | ||
|
||
First, connect a SWD capable debugger to the debug header on FK723M1-ZGT6. | ||
Then connect the debugger to the host computer to prepare the board for flashing. | ||
Finally, build and flash your application. | ||
|
||
Here is an example for the :zephyr:code-sample:`blinky` application. | ||
|
||
Optional: Connect a USB-to-serial adapter to RX and TX (cross connect!). | ||
|
||
.. code-block:: console | ||
|
||
$ minicom -b 115200 -D /dev/ttyACM0 | ||
|
||
or use screen: | ||
|
||
.. code-block:: console | ||
|
||
$ screen /dev/ttyACM0 115200 | ||
|
||
Build and flash the application: | ||
|
||
.. zephyr-app-commands:: | ||
:zephyr-app: samples/basic/blinky | ||
:board: fk723m1_zgt6 | ||
:goals: build flash | ||
|
||
You should see the following messages on the console repeatedly: | ||
|
||
.. code-block:: console | ||
|
||
$ LED state: ON | ||
$ LED state: OFF | ||
|
||
Hello World example can also be used: | ||
|
||
.. zephyr-app-commands:: | ||
:zephyr-app: samples/hello_world | ||
:board: fk723m1_zgt6 | ||
:goals: build flash | ||
|
||
Debugging | ||
========= | ||
|
||
You can debug an application in the usual way. Here is an example for the | ||
:zephyr:code-sample:`hello_world` application. | ||
|
||
.. zephyr-app-commands:: | ||
:zephyr-app: samples/hello_world | ||
:board: fk723m1_zgt6 | ||
:maybe-skip-config: | ||
:goals: debug | ||
|
||
.. _FK723M1-ZGT6 Schematic: | ||
https://community.st.com/ysqtg83639/attachments/ysqtg83639/mcu-boards-hardware-tools-forum/20009/1/FK723M1-ZGT6.zh-CN.en.pdf | ||
|
||
.. _STM32H723ZG on www.st.com: | ||
https://www.st.com/en/microcontrollers-microprocessors/stm32h723zg.html | ||
|
||
.. _STM32H723 reference manual: | ||
https://www.st.com/resource/en/reference_manual/dm00603761-stm32h723733-stm32h725735-and-stm32h730-value-line-advanced-armbased-32bit-mcus-stmicroelectronics.pdf | ||
|
||
.. _STM32CubeIDE: | ||
https://www.st.com/en/development-tools/stm32cubeide.html | ||
|
||
.. _STM32CubeProgrammer: | ||
https://www.st.com/en/development-tools/stm32cubeprog.html |
This file contains hidden or 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,158 @@ | ||
/* | ||
* Copyright (c) 2020 Alexander Kozhinov <[email protected]> | ||
* Copyright (c) 2024 zack jiang <[email protected]> | ||
* Copyright (c) 2025 Paul Wedeck <[email protected]> | ||
* SPDX-License-Identifier: Apache-2.0 | ||
*/ | ||
|
||
/dts-v1/; | ||
#include <st/h7/stm32h723Xg.dtsi> | ||
#include <st/h7/stm32h723zgtx-pinctrl.dtsi> | ||
|
||
/ { | ||
model = "FK723M1-ZGT6 board"; | ||
compatible = "fanke,fk723m1-zgt6"; | ||
|
||
chosen { | ||
zephyr,console = &usart1; | ||
zephyr,shell-uart = &usart1; | ||
zephyr,dtcm = &dtcm; | ||
zephyr,sram = &sram0; | ||
zephyr,flash = &flash0; | ||
zephyr,canbus = &fdcan1; | ||
}; | ||
|
||
leds: leds { | ||
compatible = "gpio-leds"; | ||
|
||
blue_led: led_0 { | ||
gpios = <&gpiog 7 GPIO_ACTIVE_LOW>; | ||
label = "User LED"; | ||
}; | ||
}; | ||
|
||
aliases { | ||
led0 = &blue_led; | ||
sdhc0 = &sdmmc1; | ||
}; | ||
}; | ||
|
||
&clk_lsi { | ||
status = "okay"; | ||
}; | ||
|
||
&clk_hsi { | ||
status = "okay"; | ||
}; | ||
|
||
&clk_hsi48 { | ||
status = "okay"; | ||
}; | ||
|
||
&clk_hse { | ||
clock-frequency = <DT_FREQ_M(25)>; | ||
status = "okay"; | ||
}; | ||
|
||
&clk_lse { | ||
status = "okay"; | ||
}; | ||
|
||
&pll { | ||
div-m = <2>; | ||
mul-n = <44>; | ||
div-p = <1>; | ||
div-q = <22>; | ||
div-r = <2>; | ||
clocks = <&clk_hse>; | ||
status = "okay"; | ||
}; | ||
|
||
&pll2 { | ||
div-m = <2>; | ||
mul-n = <32>; | ||
div-p = <5>; | ||
div-q = <5>; | ||
div-r = <5>; | ||
clocks = <&clk_hse>; | ||
status = "okay"; | ||
}; | ||
|
||
&rcc { | ||
clocks = <&pll>; | ||
clock-frequency = <DT_FREQ_M(550)>; | ||
d1cpre = <1>; | ||
hpre = <2>; /* HCLK: 275 MHz */ | ||
d1ppre = <2>; /* APB1: 137.5 MHz */ | ||
d2ppre1 = <2>; /* APB2: 137.5 MHz */ | ||
d2ppre2 = <2>; /* APB3: 137.5 MHz */ | ||
d3ppre = <2>; /* APB4: 137.5 MHz */ | ||
}; | ||
|
||
&usart1 { | ||
pinctrl-0 = <&usart1_tx_pa9 &usart1_rx_pa10>; | ||
pinctrl-names = "default"; | ||
current-speed = <115200>; | ||
status = "okay"; | ||
}; | ||
|
||
&rtc { | ||
clocks = <&rcc STM32_CLOCK_BUS_APB4 0x00010000>, | ||
<&rcc STM32_SRC_LSI RTC_SEL(2)>; | ||
status = "okay"; | ||
}; | ||
|
||
&backup_sram { | ||
status = "okay"; | ||
}; | ||
|
||
zephyr_udc0: &usbotg_hs { | ||
pinctrl-0 = <&usb_otg_hs_dm_pa11 &usb_otg_hs_dp_pa12>; | ||
pinctrl-names = "default"; | ||
status = "okay"; | ||
}; | ||
|
||
&rng { | ||
status = "okay"; | ||
}; | ||
|
||
&sdmmc1 { | ||
pinctrl-0 = <&sdmmc1_d0_pc8 &sdmmc1_d1_pc9 &sdmmc1_d2_pc10 | ||
&sdmmc1_d3_pc11 &sdmmc1_ck_pc12 &sdmmc1_cmd_pd2>; | ||
pinctrl-names = "default"; | ||
clocks = <&rcc STM32_CLOCK(AHB3, 16U)>, | ||
<&rcc STM32_SRC_PLL1_Q SDMMC_SEL(0)>; | ||
disk-name = "SD"; | ||
status = "okay"; | ||
bus-width = <4>; | ||
}; | ||
|
||
&octospi1 { | ||
pinctrl-0 = <&octospim_p1_ncs_pg6 &octospim_p1_clk_pf10 | ||
&octospim_p1_io0_pf8 &octospim_p1_io1_pf9 | ||
&octospim_p1_io2_pf7 &octospim_p1_io3_pf6>; | ||
pinctrl-names = "default"; | ||
status = "okay"; | ||
|
||
/* Winbond external flash */ | ||
qspi: qspi-nor-flash@0 { | ||
compatible = "st,stm32-ospi-nor"; | ||
reg = <0 DT_SIZE_M(8)>; /* 64 Mbits */ | ||
ospi-max-frequency = <DT_FREQ_M(133)>; | ||
spi-bus-width = <OSPI_QUAD_MODE>; | ||
data-rate = <OSPI_STR_TRANSFER>; | ||
writeoc = "PP_1_1_4"; | ||
size = <DT_SIZE_M(64)>; | ||
status = "okay"; | ||
|
||
partitions { | ||
compatible = "fixed-partitions"; | ||
#address-cells = <1>; | ||
#size-cells = <1>; | ||
|
||
storage_partition: partition@0 { | ||
paulwedeck marked this conversation as resolved.
Show resolved
Hide resolved
|
||
reg = <0x00000000 DT_SIZE_M(8)>; /* 64 Mbits */ | ||
}; | ||
}; | ||
}; | ||
}; |
This file contains hidden or 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,22 @@ | ||
identifier: fk723m1_zgt6 | ||
name: FK723M1-ZGT6 | ||
type: mcu | ||
arch: arm | ||
toolchain: | ||
- zephyr | ||
- gnuarmemb | ||
- xtools | ||
ram: 432 | ||
flash: 1024 | ||
supported: | ||
- uart | ||
- gpio | ||
- counter | ||
- i2c | ||
- pwm | ||
- spi | ||
- backup_sram | ||
- usb_device | ||
- rtc | ||
- can | ||
vendor: other |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.