# Convert uvprojx-based projects to csolution

## In this learning path

- [Introduction](https://learn.arm.com/learning-paths/embedded-and-microcontrollers/uvprojx-conversion/)
- [Using Keil Studio](https://learn.arm.com/learning-paths/embedded-and-microcontrollers/uvprojx-conversion/how-to-1/)
- [Using µVision](https://learn.arm.com/learning-paths/embedded-and-microcontrollers/uvprojx-conversion/how-to-mdk/)
- [Using the command line](https://learn.arm.com/learning-paths/embedded-and-microcontrollers/uvprojx-conversion/how-to-2/)
- [Next Steps](https://learn.arm.com/learning-paths/embedded-and-microcontrollers/uvprojx-conversion/_next-steps/)

## About this Learning Path

|  |  |
| --- | --- |
| Skill level: | Advanced |
| Reading time: | 10 min |
| Last updated: | 14 Aug 2026 |

|  |  |
| --- | --- |
| Author: | Christopher Seidl , Arm |
| Arm IP: | [Cortex-M](https://support.arm.com/?tab=compute-ip&Product%20Type=Microcontrollers) |
| Tags: | [Performance and Architecture](https://learn.arm.com/tag/performance-and-architecture/) [Windows](https://learn.arm.com/tag/windows) [Linux](https://learn.arm.com/tag/linux) [macOS](https://learn.arm.com/tag/macos) [Keil MDK](https://learn.arm.com/tag/keil-mdk) [CMSIS-Toolbox](https://learn.arm.com/tag/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?
After completing this Learning Path, you'll be able to perform the following tasks:

- 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'll need the following prerequisites:

- Install [Keil Studio](https://learn.arm.com/install-guides/keilstudio_vs/) on your machine.
- Install [µVision](https://learn.arm.com/install-guides/mdk/) on your machine.
- The µVision project must use Arm Compiler 6 as the default toolchain. Arm Compiler 5 is not supported.

### Summary
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.
