Skip to content

Commit ef50a58

Browse files
authored
Merge pull request #1597 from KeilChris/uv2csolution_update
Update for new tools flow
2 parents 60a2873 + c441d83 commit ef50a58

File tree

7 files changed

+11
-91
lines changed

7 files changed

+11
-91
lines changed

content/learning-paths/embedded-and-microcontrollers/uvprojx-conversion/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ learning_objectives:
1313
prerequisites:
1414
- Install [Keil Studio](/install-guides/keilstudio_vs/) on your machine.
1515
- Install [µVision](/install-guides/mdk/) on your machine.
16-
- Install [vcpkg](https://vcpkg.io/en/getting-started.html) for the command line flow.
16+
- Install [uv2csolution](https://arm-software.github.io/MDK-Toolbox/01_installation/) for the command line flow.
1717
- The µVision project must use Arm Compiler 6 as the default toolchain. Arm Compiler 5 is not supported.
1818

1919
author: Christopher Seidl
1014 Bytes
Loading
-51.9 KB
Loading

content/learning-paths/embedded-and-microcontrollers/uvprojx-conversion/how-to-1.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -23,17 +23,17 @@ layout: learningpathall
2323

2424
![Successful conversion](./output_conversion.png)
2525

26-
1. The vcpkg configuration file is automatically activated. You notice an active "Environment" configuration in the **Status Bar** at the bottom:
26+
1. The vcpkg configuration file is automatically activated. You notice a couple of "Arm Tools" available in the
27+
**Status Bar** at the bottom:
2728

2829
![vcpkg activated](./vcpkg-activated.png)
2930

30-
1. Click on the **CMSIS** icon in the **Activity Bar**. The **Primary Side Bar** changes and shows the **CONTEXT**, **SOLUTION**, and **ACTIONS** for the project.
31-
32-
1. In the **ACTIONS** section, click on **Build**:
31+
2. Click on the **CMSIS** icon in the **Activity Bar** to open the **CMSIS View**. At the top, click on the hammer icon to
32+
build the project:
3333

3434
![CMSIS build](./cmsis-build.png)
3535

36-
1. The `cbuild` task starts. A successful project build will end with:
36+
3. The `cbuild` task starts. A successful project build will end with:
3737

3838
```output
3939
Program size: Code=... RO-data=... RW-data=... ZI-data=...

content/learning-paths/embedded-and-microcontrollers/uvprojx-conversion/how-to-2.md

Lines changed: 5 additions & 85 deletions
Original file line numberDiff line numberDiff line change
@@ -6,90 +6,10 @@ weight: 4
66
layout: learningpathall
77
---
88

9-
## Project conversion on the command line using vcpkg
9+
## Project conversion on the command line
1010

11-
[vcpkg](https://vcpkg.io/en/index.html) is a free C/C++ package manager for acquiring and managing libraries. It runs on all platforms, build systems, and work flows. it is maintained by the Microsoft C++ team and open source contributors.
11+
Follow the [instructions](https://arm-software.github.io/MDK-Toolbox/01_installation/) to install the `uv2csolution` tool on
12+
your local machine. The tool is available for all major host operating systems (macOS, LInux, Windows).
1213

13-
In your favorite terminal application, change to the directory containing the uvprojx-based project.
14-
15-
1. If you have not done it before, install vcpkg (otherwise continue to step 2):
16-
17-
{{< tabpane code=true >}}
18-
{{< tab header="Windows (cmd)" language="shell">}}
19-
curl -LO https://aka.ms/vcpkg-init.cmd && .\vcpkg-init.cmd
20-
{{< /tab >}}
21-
{{< tab header="Windows (PowerShell)" language="shell">}}
22-
iex (iwr -useb https://aka.ms/vcpkg-init.ps1)
23-
{{< /tab >}}
24-
{{< tab header="Linux/macOS" language="shell">}}
25-
. < (curl https://aka.ms/vcpkg-init.sh -L)
26-
{{< /tab >}}
27-
{{< /tabpane >}}
28-
29-
1. Initialize vcpkg:
30-
31-
{{< tabpane code=true >}}
32-
{{< tab header="Windows (cmd)" language="shell">}}
33-
%USERPROFILE%\.vcpkg\vcpkg-init.cmd
34-
{{< /tab >}}
35-
{{< tab header="Windows (PowerShell)" language="shell">}}
36-
. ~/.vcpkg/vcpkg-init.ps1
37-
{{< /tab >}}
38-
{{< tab header="Linux/macOS" language="shell">}}
39-
. ~/.vcpkg/vcpkg-init
40-
{{< /tab >}}
41-
{{< /tabpane >}}
42-
43-
2. Update the Arm vcpkg registry (this will give you access to tools hosted by Arm):
44-
45-
```shell
46-
vcpkg x-update-registry arm
47-
```
48-
49-
3. Enable the `uv2csolution` conversion tool:
50-
51-
```shell
52-
vcpkg use uv2csolution
53-
```
54-
55-
4. Run the conversion (in this example, the project is called `MyProject.uvprojx`):
56-
57-
```shell
58-
uv2csolution MyProject.uvprojx
59-
```
60-
61-
This step generates the following files:
62-
- `MyProject.csolution.yaml`
63-
- `MyProject.cproject.yaml`
64-
- `vcpkg-configuration.json`
65-
66-
5. Activate the vcpkg configuration (this will install all required tools on your machine):
67-
68-
```shell
69-
vcpkg activate
70-
```
71-
72-
5. Get an MDK-Community license:
73-
74-
```shell
75-
armlm activate -product KEMDK-COM0 -server https://mdk-preview.keil.arm.com
76-
```
77-
78-
5. [Optional] Check your license:
79-
80-
```shell
81-
armlm inspect
82-
```
83-
84-
6. Build the project:
85-
86-
```shell
87-
cbuild MyProject.csolution.yaml --update-rte
88-
```
89-
90-
A successful project build will end with:
91-
92-
```output
93-
Program size: Code=... RO-data=... RW-data=... ZI-data=...
94-
info cbuild: build finished successfully!
95-
```
14+
Follow the [command line usage instructions](https://arm-software.github.io/MDK-Toolbox/04_uv2csolution/) to convert
15+
µVision projects to CMSIS solution projects.
886 Bytes
Loading
-2.47 KB
Loading

0 commit comments

Comments
 (0)