Skip to content

Commit 2f2fbc4

Browse files
committed
uVisor: Update README
Note: The README is auto-generated by the importer script, which copies the QUICKSTART.md guide from ARMmbed/uvisor.
1 parent 0712b8a commit 2f2fbc4

File tree

1 file changed

+16
-11
lines changed

1 file changed

+16
-11
lines changed

features/FEATURE_UVISOR/README.md

Lines changed: 16 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -129,15 +129,14 @@ In the code above we specified 3 elements:
129129
1. Main box Access Control Lists (ACLs). Since with uVisor enabled everything runs in unprivileged mode, we need to make sure that peripherals that are accessed by the OS and the main box are allowed. These peripherals are specified using a list like the one in the snippet above. For the purpose of this example we provide you the list of all the ACLs that we know you will need. For other platforms or other applications you need to determine those ACLs following a process that is described in a [section](#the-main-box-acls) below.
130130
1. App-specific uVisor configurations: `UVISOR_SET_MODE_ACL`. This macro sets the uVisor mode (enabled) and associates the list of ACLs we just created with the main box.
131131
132-
Before compiling, we need to add a custom target that inherits all the features of the original `K64F` target, and enables the uVisor feature. To do so, add the file `~/code/uvisor-example/mbed_app.json` with the following content:
132+
Before compiling, we need to override the original `K64F` target to enable the uVisor feature. To do so, add the file `~/code/uvisor-example/mbed_app.json` with the following content:
133133
134134
```JSON
135135
{
136-
"custom_targets": {
137-
"K64F_SECURE": {
138-
"inherits": ["K64F"],
139-
"extra_labels_add":["K64F", "UVISOR_SUPPORTED"],
140-
"features_add": ["UVISOR"]
136+
"target_overrides": {
137+
"K64F": {
138+
"target.features_add": ["UVISOR"],
139+
"target.extra_labels_add": ["UVISOR_SUPPORTED"]
141140
}
142141
}
143142
}
@@ -147,16 +146,16 @@ Before compiling, we need to add a custom target that inherits all the features
147146

148147
**Checkpoint**
149148

150-
Compile the application again, but this time targeting `K64F_SECURE`:
149+
Compile the application again. This time the `K64F` target will include the new features and labels we provided in `mbed_app.json`;
151150

152151
```bash
153-
$ mbed compile -m K64F_SECURE -t GCC_ARM
152+
$ mbed compile -m K64F -t GCC_ARM
154153
```
155154

156155
The binary will be located at:
157156

158157
```bash
159-
~/code/uvisor-example/.build/K64F_SECURE/GCC_ARM/uvisor-example.bin
158+
~/code/uvisor-example/.build/K64F/GCC_ARM/uvisor-example.bin
160159
```
161160

162161
Re-flash the device and press the reset button. The device LED should be blinking as in the previous case.
@@ -290,7 +289,13 @@ A few things to note in the code above:
290289

291290
**Checkpoint**
292291

293-
Compile the application again, re-flash the device, and press the reset button. The device LED should be blinking as in the previous case.
292+
Compile the application again:
293+
294+
```bash
295+
$ mbed compile -m K64F -t GCC_ARM
296+
```
297+
298+
Re-flash the device, and press the reset button. The device LED should be blinking as in the previous case.
294299

295300
If you don't see the LED blinking, it means that the application halted somewhere, probably because uVisor captured a fault. You can setup the uVisor debug messages to see if there is any problem. Follow the [Debugging uVisor on mbed OS](DEBUGGING.md) document for a step-by-step guide.
296301

@@ -374,7 +379,7 @@ static const UvisorBoxAclItem g_main_box_acls[] = {
374379
You now need to compile your application using uVisor in debug mode. This operation requires some more advanced steps, which are described in detail in the [Debugging uVisor on mbed OS](DEBUGGING.md) document. The main idea is that you compile the application in debug mode:
375380

376381
```bash
377-
$ mbed compile -m K64F_SECURE -t GCC_ARM -o "debug-info"
382+
$ mbed compile -m K64F -t GCC_ARM -o "debug-info"
378383
```
379384

380385
and then use a GDB-compatible interface to flash the device, enable semihosting, and access the uVisor debug messages. Please read the [Debugging uVisor on mbed OS](DEBUGGING.md) document for the detailed instructions.

0 commit comments

Comments
 (0)