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

### Frequently asked questions

**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.