How to properly rename a dual-core project?

AraceliGuerrero · ‎2026-03-23

Added dual-core to title - may be significant ...

Hello.

I've tried rename my project in the past, and this always generate a lot of errors due to the dependencies.
Which is the properly way?
I am working with STM32H755. Yes, dual-core.

Thanks!

AraceliGuerrero · ‎2026-03-23

Thank you so much!

Well, after reading here and there, I was able to follow these steps in this specific order, and the errors that were previously occurring no longer showed up.

In the IDE, rename the subprojects one by one. Keep the format ProjectName_CM4 and ProjectName_CM7. Press F2 and make sure the ‘Update references’ option is checked.
Rename the root project, the one that contains the .ioc file. Press F2 and use the desired name.
Delete the project from the IDE.
Rename the folder, keeping the same name.
Rename the .ioc file.
Open the .ioc file in STM32CubeMX and generate the code.
Import the project again into the IDE.
Delete the Debug Configurations.
Run ‘Clean Project’.
Press Ctrl + B to build everything.
Set up the debug configuration again.

View solution in original post

Andrew Neil · ‎2026-03-23

Which dependencies?

ISTR the IOC file doesn't get properly renamed - but a manual rename fixes it.

Maybe also Debug/Run configurations?

A complex system that works is invariably found to have evolved from a simple system that worked.
A complex system designed from scratch never works and cannot be patched up to make it work.

AraceliGuerrero · ‎2026-03-23

Okay, I’ll write down what I did and the order I did it in. I haven’t touched this part again because it started breaking, but from what I remember, in the end it would generate warnings that didn’t appear at the beginning. I also got an error saying the linker was corrupted or something like that. And overall, it didn’t feel like a clean rename because some things weren’t updating properly.

From the IDE, select ‘Rename’, press Enter, and wait.
The .ioc file doesn’t change, so I modify it manually.
Open CubeMX and check in Project Manager, because sometimes the name doesn’t get updated there.
Open the CM4 folder, modify the .project file to update the <name> tag with the new name. Do the same in CM7.
In CubeMX, click ‘Generate Code’ to make sure everything has the new name.
In CubeIDE, select ‘Clean Project’.

At this point, I start getting redefinition errors.

Andrew Neil · ‎2026-03-23

I've never found it necessary to hack the .project file.

But I've only ever done it on single-core projects - so that might make a difference ...

A complex system that works is invariably found to have evolved from a simple system that worked.
A complex system designed from scratch never works and cannot be patched up to make it work.

Ghofrane GSOURI · ‎2026-03-23

Hello @AraceliGuerrero

I believe there is no official, one-step rename feature for dual-core projects in STM32CubeIDE. I have raised this request #0060931 to the development team for a feasibility assessment.

THX

Ghofrane

To give better visibility on the answered topics, please click on Accept as Solution on the reply which solved your issue or answered your question.

AraceliGuerrero · ‎2026-03-23

Thank you so much!

Well, after reading here and there, I was able to follow these steps in this specific order, and the errors that were previously occurring no longer showed up.

In the IDE, rename the subprojects one by one. Keep the format ProjectName_CM4 and ProjectName_CM7. Press F2 and make sure the ‘Update references’ option is checked.
Rename the root project, the one that contains the .ioc file. Press F2 and use the desired name.
Delete the project from the IDE.
Rename the folder, keeping the same name.
Rename the .ioc file.
Open the .ioc file in STM32CubeMX and generate the code.
Import the project again into the IDE.
Delete the Debug Configurations.
Run ‘Clean Project’.
Press Ctrl + B to build everything.
Set up the debug configuration again.