# [Convert uvprojx-based projects to csolution](https://learn.arm.com/learning-paths/embedded-and-microcontrollers/uvprojx-conversion/)

## 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, 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](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

<details>
<summary>How do I start the conversion in Keil Studio?</summary>
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.
</details>

<details>
<summary>What result should I expect after a successful conversion?</summary>
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.
</details>

<details>
<summary>How do I verify the export from µVision worked?</summary>
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.
</details>

<details>
<summary>What should I check if the conversion option is missing or fails?</summary>
Confirm the µVision project uses Arm Compiler 6 as the default toolchain. Projects that use Arm Compiler 5 aren’t supported for conversion.
</details>

<details>
<summary>Can I convert from the command line and what should I do next?</summary>
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.
</details>