Skip to content

{bp-19143} !arch/stm32: split stm32 and stm32f0l0g0 into per-chip-family directories#19272

Merged
xiaoxiang781216 merged 16 commits into
apache:releases/13.0from
jerpelea:bp-19143
Jul 3, 2026
Merged

{bp-19143} !arch/stm32: split stm32 and stm32f0l0g0 into per-chip-family directories#19272
xiaoxiang781216 merged 16 commits into
apache:releases/13.0from
jerpelea:bp-19143

Conversation

@jerpelea

@jerpelea jerpelea commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Summary

This PR moves the shared arch/arm/src/stm32 and arch/arm/src/stm32f0l0g0 arch and board code into common/stm32 directories and splits the two historical super-directories into one directory per chip family.

Most of the changes in the PR involve moving files and using "git mv" to preserve git history. The size of this PR is quite large, but it can't be broken down into smaller pieces without breaking CI.

I also added a page in the documentation summarizing the stm32 ports standardization with migration guide.

Reference: #19004

Fixes #16172 and #18894

Depends on
#19271

Impact

RELEASE

Testing

CI

@jerpelea jerpelea mentioned this pull request Jul 2, 2026
Merged
@github-actions github-actions Bot added Area: Build system Arch: arm Issues related to ARM (32-bit) architecture Size: XL The size of the change in this PR is very large. Consider breaking down the PR into smaller pieces. labels Jul 2, 2026
@jerpelea jerpelea mentioned this pull request Jul 2, 2026
Merged
raiden00pl added 16 commits July 2, 2026 16:21
@raiden00pl @jerpelea
!boards/arm/stm32: move common board sources
ecf7764 
BREAKING CHANGE: Move the existing STM32 board common sources to
boards/arm/common/stm32 and fold in the common STM32F0/L0/G0/C0
board helpers so split STM32 board families can share one source
tree.

Signed-off-by: raiden00pl <raiden00@railab.me>
@raiden00pl @jerpelea
boards/arm/stm32l4: build through common STM32 board infrastructure
6cf37a6 
Add boards/arm/stm32l4/common so STM32L4 boards build through the shared
STM32 board-common tree (boards/arm/common/stm32), like the other split
STM32 families.

Convert each STM32L4 board's src/Makefile to src/Make.defs so the
per-board sources are pulled in by the common board Makefile.

Signed-off-by: raiden00pl <raiden00@railab.me>
@raiden00pl @jerpelea
!arch/stm32: move common sources to common/stm32
765ff4b 
BREAKING CHANGE: Common STM32 source and private header files moved to
arch/arm/src/common/stm32. Out-of-tree code that references family-local
common source paths must update includes, build rules, and source paths
to the new common STM32 location.

Signed-off-by: raiden00pl <raiden00@railab.me>
@raiden00pl @jerpelea
!arch/stm32f0l0g0: move stm32f0 to its own directory
6c83b99 
BREAKING CHANGE:

Part of splitting the legacy stm32 super-directory; relocates
the stm32f0 sources, headers and boards into arch/arm/src/stm32f0,
arch/arm/include/stm32f0 and boards/arm/stm32f0.

Signed-off-by: raiden00pl <raiden00@railab.me>
@raiden00pl @jerpelea
!arch/stm32f0l0g0: move stm32l0 to its own directory
3bf81db 
BREAKING CHANGE:

Part of splitting the legacy stm32 super-directory; relocates
the stm32l0 sources, headers and boards into arch/arm/src/stm32l0,
arch/arm/include/stm32l0 and boards/arm/stm32l0.

Signed-off-by: raiden00pl <raiden00@railab.me>
@raiden00pl @jerpelea
!arch/stm32f0l0g0: move stm32g0 to its own directory
95731f2 
BREAKING CHANGE:

Part of splitting the legacy stm32 super-directory; relocates
the stm32g0 sources, headers and boards into arch/arm/src/stm32g0,
arch/arm/include/stm32g0 and boards/arm/stm32g0.

Signed-off-by: raiden00pl <raiden00@railab.me>
@raiden00pl @jerpelea
!arch/stm32f0l0g0: move stm32c0 and finalize the directory split
8f0f6b0 
Move the stm32c0 sources, headers and boards into arch/arm/src/stm32c0,
arch/arm/include/stm32c0 and boards/arm/stm32c0, then finalize the split:
source each split family directly in arch/arm/Kconfig and boards/Kconfig and
remove the now-empty combined arch/arm/src/stm32f0l0g0 and
boards/arm/stm32f0l0g0 trees.

BREAKING CHANGE: The combined STM32F0/L0/G0/C0 architecture and board
paths were split into stm32f0, stm32l0, stm32g0, and stm32c0 directories.
Out-of-tree boards, include paths, source paths, and defconfigs must move
from stm32f0l0g0 to the matching split family.

Signed-off-by: raiden00pl <raiden00@railab.me>
@raiden00pl @jerpelea
!arch/stm32: move stm32f1 to its own directory
0c6824b 
BREAKING CHANGE:

Part of splitting the legacy stm32 super-directory; relocates
the stm32f1 sources, headers and boards into arch/arm/src/stm32f1,
arch/arm/include/stm32f1 and boards/arm/stm32f1.

Signed-off-by: raiden00pl <raiden00@railab.me>
@raiden00pl @jerpelea
!arch/stm32: move stm32f2 to its own directory
c64f8a7 
BREAKING CHANGE:

Part of splitting the legacy stm32 super-directory; relocates
the stm32f2 sources, headers and boards into arch/arm/src/stm32f2,
arch/arm/include/stm32f2 and boards/arm/stm32f2.

Signed-off-by: raiden00pl <raiden00@railab.me>
@raiden00pl @jerpelea
!arch/stm32: move stm32f3 to its own directory
27180de 
BREAKING CHANGE:

Part of splitting the legacy stm32 super-directory; relocates
the stm32f3 sources, headers and boards into arch/arm/src/stm32f3,
arch/arm/include/stm32f3 and boards/arm/stm32f3.

Signed-off-by: raiden00pl <raiden00@railab.me>
@raiden00pl @jerpelea
!arch/stm32: move stm32f4 to its own directory
2ad4c74 
BREAKING CHANGE:

Part of splitting the legacy stm32 super-directory; relocates
the stm32f4 sources, headers and boards into arch/arm/src/stm32f4,
arch/arm/include/stm32f4 and boards/arm/stm32f4.

Signed-off-by: raiden00pl <raiden00@railab.me>
@raiden00pl @jerpelea
!arch/stm32: move stm32g4 to its own directory
94dfd7c 
BREAKING CHANGE:

Part of splitting the legacy stm32 super-directory; relocates
the stm32g4 sources, headers and boards into arch/arm/src/stm32g4,
arch/arm/include/stm32g4 and boards/arm/stm32g4.

Signed-off-by: raiden00pl <raiden00@railab.me>
@raiden00pl @jerpelea
!arch/stm32: move stm32l1 and finalize the directory split
cd7cd8e 
Move the stm32l1 sources, headers and boards into arch/arm/src/stm32l1,
arch/arm/include/stm32l1 and boards/arm/stm32l1, then finalize the split:
source each split family directly in arch/arm/Kconfig and boards/Kconfig and
remove the now-empty combined arch/arm/src/stm32 and boards/arm/stm32 trees.

BREAKING CHANGE: The legacy STM32 architecture and board paths were split into
stm32f1, stm32l1, stm32f2, stm32f3, stm32f4, and stm32g4 directories.
Out-of-tree boards must move from stm32 to the matching split family.

Signed-off-by: raiden00pl <raiden00@railab.me>
@raiden00pl @jerpelea
boards: fix various stm32 boards errors
a2f579a 
fix various stm32 boards errors found by CI

Signed-off-by: raiden00pl <raiden00@railab.me>
@raiden00pl @jerpelea
ci/arm-13.dat: update targets
db8d8f3 
update arm-13.dat build targets so they match state before stm32 split

Signed-off-by: raiden00pl <raiden00@railab.me>
@raiden00pl @jerpelea
Documentation: add STM32 porting guide
06013d4 
add STM32 porting guide

Signed-off-by: raiden00pl <raiden00@railab.me>
@jerpelea

jerpelea commented Jul 2, 2026

Copy link
Copy Markdown
Contributor Author

ping @acassis

@xiaoxiang781216 xiaoxiang781216 merged commit bfad0f1 into apache:releases/13.0 Jul 3, 2026
23 of 43 checks passed
@jerpelea jerpelea deleted the bp-19143 branch July 3, 2026 06:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@acassis acassis acassis approved these changes
@cederom cederom cederom approved these changes
@linguini1 linguini1 linguini1 approved these changes
@GUIDINGLI GUIDINGLI Awaiting requested review from GUIDINGLI GUIDINGLI is a code owner
@hartmannathan hartmannathan Awaiting requested review from hartmannathan hartmannathan is a code owner
@btashton btashton Awaiting requested review from btashton btashton is a code owner
@raiden00pl raiden00pl Awaiting requested review from raiden00pl raiden00pl is a code owner
@yf13 yf13 Awaiting requested review from yf13 yf13 is a code owner
@adamfeuer adamfeuer Awaiting requested review from adamfeuer adamfeuer is a code owner
@rcsim rcsim Awaiting requested review from rcsim rcsim is a code owner
@anchao anchao Awaiting requested review from anchao anchao is a code owner
@Ouss4 Ouss4 Awaiting requested review from Ouss4 Ouss4 is a code owner
@xiaoxiang781216 xiaoxiang781216 Awaiting requested review from xiaoxiang781216 xiaoxiang781216 is a code owner
@pkarashchenko pkarashchenko Awaiting requested review from pkarashchenko pkarashchenko is a code owner
@gustavonihei gustavonihei Awaiting requested review from gustavonihei gustavonihei is a code owner
@antmerlino antmerlino Awaiting requested review from antmerlino antmerlino is a code owner
@simbit18 simbit18 Awaiting requested review from simbit18 simbit18 is a code owner
@davids5 davids5 Awaiting requested review from davids5 davids5 is a code owner
@patacongo patacongo Awaiting requested review from patacongo patacongo is a code owner
@yamt yamt Awaiting requested review from yamt yamt is a code owner
@michallenc michallenc Awaiting requested review from michallenc michallenc is a code owner
@pussuw pussuw Awaiting requested review from pussuw pussuw is a code owner
@Donny9 Donny9 Awaiting requested review from Donny9 Donny9 is a code owner
@liuguo09 liuguo09 Awaiting requested review from liuguo09 liuguo09 is a code owner
@masayuki2009 masayuki2009 Awaiting requested review from masayuki2009 masayuki2009 is a code owner
@tmedicci tmedicci Awaiting requested review from tmedicci tmedicci is a code owner

Assignees

No one assigned

Labels

Arch: arm Issues related to ARM (32-bit) architecture Area: Build system Board: arm Size: XL The size of the change in this PR is very large. Consider breaking down the PR into smaller pieces.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

6 participants

@jerpelea @acassis @cederom @linguini1 @xiaoxiang781216 @raiden00pl