Convert uvprojx-based projects to csolution
Introduction
Using Keil Studio
Using µVision
Using the command line
Next Steps

  Log an issue

  Fork and edit

  Discuss on Discord

About this Learning Path

Skill level:  Advanced
Reading time:  10 min
Last updated:  14 Aug 2026
Skill level:
  Advanced
Reading time:
  10 min
Last updated:
  14 Aug 2026
Author:Christopher Seidl, Arm
Arm IP:Cortex-M
Tags: Performance and Architecture Windows Linux macOS Keil MDK CMSIS-Toolbox
Author:
  • Christopher Seidl, Arm
Arm IP:
Cortex-M
Tags:
Performance and Architecture Windows Linux macOS Keil MDK CMSIS-Toolbox

Who is this for?

This is a topic for users of µVision who want to migrate to the new project format (csolution) required by CMSIS-Toolbox.

What will you learn?

Upon completion of this Learning Path, you will be able to:

  • Import, convert, and build uvprojx-based projects in Keil Studio.
  • Convert uvprojx-based projects in µVision.
  • Convert and build uvprojx-based projects on the command line.

Prerequisites

Before starting, you will need the following:

  • Install Keil Studio on your machine.
  • Install µVision on your machine.
  • The µVision project must use Arm Compiler 6 as the default toolchain. Arm Compiler 5 is not supported.

Summary

AI-assisted

This summary was drafted with an approved AI-assisted workflow and reviewed by Arm contributors before publication. Human technical review remains part of the process so the final page reflects engineering rigor, accuracy, and Arm editorial standards.

Close
?
You’ll convert a µVision uvprojx project to the CMSIS-Toolbox csolution format. First, you’ll use Keil Studio for VS Code to generate .csolution.yaml, .cproject.yaml, and vcpkg-configuration.json files. Alternatively, you’ll export from µVision or run uv2csolution on the command line. Then, you’ll confirm the conversion output and open the project in CMSIS-Toolbox or Keil Studio.

Frequently asked questions

AI-assisted

These FAQs were drafted with an approved AI-assisted workflow and reviewed by Arm contributors before publication. Human technical review remains part of the process so the final page reflects engineering rigor, accuracy, and Arm editorial standards.

Close
?
How do I start the conversion in Keil Studio?
In VS Code, open the folder that contains the .uvprojx file, then right-click the .uvprojx and select “Convert µVision project to csolution.” Keil Studio generates the csolution and related files in the same workspace.
What result should I expect after a successful conversion?
You should see files such as <project>.csolution.yaml, <project>.cproject.yaml, and vcpkg-configuration.json. In Keil Studio, the Output window reports success and the vcpkg configuration is activated.
How do I verify the export from µVision worked?
Check the Build Output window for a successful conversion message. The generated csolution files appear alongside your project and can be opened by CMSIS-Toolbox or Keil Studio.
What should I check if the conversion option is missing or fails?
Confirm the µVision project uses Arm Compiler 6 as the default toolchain. Projects that use Arm Compiler 5 aren’t supported for conversion.
Can I convert from the command line and what should I do next?
Yes. Install the uv2csolution tool and follow its command-line usage. The tool is available for macOS, Linux, and Windows. After conversion, use the generated csolution with CMSIS-Toolbox or open it in Keil Studio.
Next