Merge branch 'ArmDeveloperEcosystem:main' into main

Author: odincodeshen

content/learning-paths/laptops-and-desktops/windowsperf_wpa_plugin/windowsperf_wpa_plugin.md

@@ -26,7 +26,7 @@ You can save a `.json` output from WindowsPerf by using the `--output` command f
     To create a file named `example.json`, run the following command:
 
     ```console
-    wperf stat -e ld_spec --output example.json
+    wperf stat -e ld_spec --timeout 5 --json --output example.json
     ```
 
 2. Open Windows Performance Analyzer, and see the following window:
@@ -54,9 +54,11 @@ You can use WPA to visualize PMU events in the recorded data.
 To try the timeline feature, run the command:
 
 ```command 
-wperf stat -m dcache -c 0,1,2,3,4,5,6,7 -t -i 0 -n 50 --json
+wperf stat -m dcache -c 0,1,2,3,4,5,6,7 -t -i 0 -n 10 --timeout 2 --json --output example2.json
 ```
 
+Note: above command will run for ~20 seconds.
+
 Open the generated output (`.json` file) in WPA to see the graph:
 
 ![timeline-by-core #center](figures/timeline-by-core.png)
@@ -72,9 +74,11 @@ To see all the generated graphs you can expand the `Counting timeline` section i
 Run another `wperf` command with different options:
 
 ```console 
-wperf stat -t -i 0 -m imix,l1d_cache_miss_ratio,l1d_cache_mpki,l1d_tlb_miss_ratio,l1d_tlb_mpki -e inst_spec,vfp_spec,ld_spec,st_spec -c 1 --json
+wperf stat -t -i 0 -n 10 -m imix,l1d_cache_miss_ratio,l1d_cache_mpki,l1d_tlb_miss_ratio,l1d_tlb_mpki -e inst_spec,vfp_spec,ld_spec,st_spec -c 1 --timeout 2 --json --output --example3.json
 ```
 
+Note: above command will run for ~20 seconds.
+
 The graph after opening the `.json` file is shown below:
 
 ![timeline-events-by-key #center](figures/timeline-events-by-key.png)
@@ -88,9 +92,11 @@ The WPA Plugin also provides visualization of [Arm telemetry metrics](https://de
 To visualize telemetry, run the following command:
 
 ```console 
-wperf stat -t -i 0 -m imix,l1d_cache_miss_ratio,l1d_cache_mpki,l1d_tlb_miss_ratio,l1d_tlb_mpki -e inst_spec,vfp_spec,ld_spec,st_spec -c 1 --json
+wperf stat -t -i 0 -n 10 -m imix,l1d_cache_miss_ratio,l1d_cache_mpki,l1d_tlb_miss_ratio,l1d_tlb_mpki -e inst_spec,vfp_spec,ld_spec,st_spec -c 1 --timeout 2 --json --output example4.json
 ```
 
+Note: above command will run for ~20 seconds.
+
 You can also see the telemetry timeline graphs under the graph explorer level in WPA. 
 
 These graphs are generated dynamically so only the relevant metrics for the given `.json` output file are visible.
@@ -101,4 +107,4 @@ Once expanded, a more in-depth view is visible under the Analysis tab of WPA.
 
 ![telemetry-table #center](figures/telemetry-table.png)
 
-You now have a basic understanding of how to use `wperf` generated data in the Windows Performance Analyzer.
+You now have a basic understanding of how to use `wperf` generated data in the Windows Performance Analyzer.

content/learning-paths/microcontrollers/mlek/_index.md

@@ -1,13 +1,13 @@
 ---
 title: Build and run the Arm Machine Learning Evaluation Kit examples
 
-minutes_to_complete: 30   
+minutes_to_complete: 30
 
 who_is_this_for: This is an introductory topic for embedded software developers interested in learning about machine learning.
 
-learning_objectives: 
+learning_objectives:
     - Build examples from Machine Learning Evaluation Kit (MLEK)
-    - Run the examples on Corstone-300 FVP or Virtual Hardware
+    - Run the examples on Corstone-320 FVP or Virtual Hardware
 
 prerequisites:
     - Some familiarity with embedded programming

content/learning-paths/microcontrollers/mlek/build.md

@@ -7,69 +7,138 @@ weight: 2 # 1 is first, 2 is second, etc.
 # Do not modify these elements
 layout: "learningpathall"
 ---
-The [Arm ML Evaluation Kit (MLEK)](https://review.mlplatform.org/plugins/gitiles/ml/ethos-u/ml-embedded-evaluation-kit) provides a number of ready-to-use ML applications. These allow you to investigate the embedded software stack and evaluate performance on the Cortex-M55 and Ethos-U55 processors.
+The [Arm ML Evaluation Kit (MLEK)](https://review.mlplatform.org/plugins/gitiles/ml/ethos-u/ml-embedded-evaluation-kit) provides a number of ready-to-use ML applications. These allow you to investigate the embedded software stack and evaluate performance on the Cortex-M55 and Ethos-U85 processors.
 
-You can use the MLEK source code to build sample applications and run them on the [Corstone reference systems](https://www.arm.com/products/silicon-ip-subsystems/), for example the [Corstone-300](https://developer.arm.com/Processors/Corstone-300) Fixed Virtual Platform (FVP).
+You can use the MLEK source code to build sample applications and run them on the [Corstone reference systems](https://www.arm.com/products/silicon-ip-subsystems/), for example the [Corstone-320](https://developer.arm.com/Processors/Corstone-320) Fixed Virtual Platform (FVP).
 
 ## Before you begin
 
 You can use your own Ubuntu Linux host machine or use [Arm Virtual Hardware (AVH)](https://www.arm.com/products/development-tools/simulation/virtual-hardware) for this Learning Path.
 
-The Ubuntu version should be 20.04 or 22.04. The `x86_64` architecture must be used because the Corstone-300 FVP is not currently available for the Arm architecture. You will need a Linux desktop to run the FVP because it opens graphical windows for input and output from the software applications.
+The Ubuntu version should be 20.04 or 22.04. These instructions have been tested on the `x86_64` architecture. You will need a way to interact visually with your machine to run the FVP, because it opens graphical windows for input and output from the software applications.
 
 If you want to use Arm Virtual Hardware the [Arm Virtual Hardware install guide](/install-guides/avh#corstone) provides setup instructions.
 
-### Compilers
+## Build the example application
 
-The examples can be built with [Arm Compiler for Embedded](https://developer.arm.com/Tools%20and%20Software/Arm%20Compiler%20for%20Embedded) or [Arm GNU Toolchain](https://developer.arm.com/Tools%20and%20Software/GNU%20Toolchain).
+### Install the dependencies
 
-Use the install guides to install the compilers on your computer:
-- [Arm Compiler for Embedded](/install-guides/armclang/)
-- [Arm GNU Toolchain](/install-guides/gcc/arm-gnu)
+Run the following commands to install some necessary tools.
 
-Both compilers are pre-installed in Arm Virtual Hardware.
+```bash
+sudo apt update
+sudo apt install unzip python3-venv python3-pip -y
+```
+### Install the compiler
 
-### Corstone-300 FVP {#fvp}
+The examples can be built with [Arm Compiler for Embedded](https://developer.arm.com/Tools%20and%20Software/Arm%20Compiler%20for%20Embedded) or [Arm GNU Toolchain](https://developer.arm.com/Tools%20and%20Software/GNU%20Toolchain).
 
-To install the Corstone-300 FVP on your computer refer to the [install guide for Arm Ecosystem FVPs](/install-guides/fm_fvp).
+Install the GNU toolchain (`gcc`).
 
-The Corstone-300 FVP is pre-installed in Arm Virtual Hardware.
+```bash
+wget https://developer.arm.com/-/media/Files/downloads/gnu/13.3.rel1/binrel/arm-gnu-toolchain-13.3.rel1-x86_64-arm-none-eabi.tar.xz
 
-## Clone the repository
+tar -xf arm-gnu-toolchain-13.3.rel1-x86_64-arm-none-eabi.tar.xz
 
-1. Install `virtualenv` to create Python virtual environments:
+export PATH=~/arm-gnu-toolchain-13.3.rel1-x86_64-arm-none-eabi/bin/:$PATH
 
-```console
-sudo apt update
-sudo apt install python3-venv -y
 ```
 
-2. Clone the ML Evaluation Kit repository, and navigate into the new directory:
+{{% notice Tip %}}
+You can review the installation guides for further details.
 
-```console
+- [Arm Compiler for Embedded](/install-guides/armclang/)
+- [Arm GNU Toolchain](/install-guides/gcc/arm-gnu)
+
+{{% /notice %}}
+
+
+Both compilers are pre-installed in Arm Virtual Hardware.
+
+### Clone the repository
+
+Clone the ML Evaluation Kit repository, and navigate into the new directory:
+
+```bash
 git clone "https://review.mlplatform.org/ml/ethos-u/ml-embedded-evaluation-kit"
 cd ml-embedded-evaluation-kit
 git submodule update --init
 ```
 
-## Build the example applications
+### Run the build sscript
+
+The default build is Ethos-U55  and Corstone-300. The default build for Ethos-U85 is Corstone-320. Use the `npu-config-name` flag to set Ethos-U85.
 
-The default compiler is `gcc`, but `armclang` can also be used.
+The default compiler is `gcc`, but `armclang` can also be used. Number after `ethos-u85-*` is number of MACs, 128-2048 (2^n).
 
 You can select either compiler to build applications. You can also try them both and compare the results.
 
 - Build with Arm GNU Toolchain (`gcc`)
 
 ```
-./build_default.py
+./build_default.py --npu-config-name ethos-u85-256 --toolchain gnu
 ```
 
 - Build with Arm Compiler for Embedded (`armclang`)
 
 ```console
-./build_default.py --toolchain arm
+./build_default.py --npu-config-name ethos-u85-256 --toolchain arm
 ```
 
 The build will take a few minutes.
 
-When the build is complete, you will find the example images (`.axf` files) in the `cmake-build-*/bin` directory. The `cmake-build` directory names are specific to the compiler used and Ethos-U55 configuration.
+When the build is complete, you will find the examples (`.axf` files) in the `cmake-build-*/bin` directory. The `cmake-build` directory names are specific to the compiler used and Ethos-U85 configuration. Verify that the files have been created by observing the output of the `ls` command
+
+```bash
+ls cmake-build-mps4-sse-320-ethos-u85-256-gnu/bin/
+```
+
+The next step is to install the FVP and run it with these example audio clips.
+
+
+## Corstone-320 FVP {#fvp}
+
+This section describes installation of the Corstone-320 to run on your local machine. If you are using Arm Virtual Hardware, that comes with the Corstone-300 FVP pre-installed, and you can move on to the next section. You can review Arm's full FVP offer and general installation steps in the [Fast Model and Fixed Virtual Platform](/install-guides/fm_fvp) install guides.
+
+{{% notice Note %}}
+The rest of the steps for the Corstone-320 need to be run in a new terminal window.
+{{% /notice %}}
+
+Open a **new terminal window** and download the Corstone-320 archive.
+
+```bash
+cd $HOME
+wget https://developer.arm.com/-/cdn-downloads/permalink/FVPs-Corstone-IoT/Corstone-320/FVP_Corstone_SSE-320_11.27_25_Linux64.tgz
+```
+
+Unpack it with `tar`, run the setup script and export the binary paths to the `PATH` environment variable.
+
+```bash
+tar -xf FVP_Corstone_SSE-320_11.27_25_Linux64.tgz
+./FVP_Corstone_SSE-320.sh --i-agree-to-the-contained-eula --no-interactive -q
+export PATH=$HOME/FVP_Corstone_SSE-320/models/Linux64_GCC-9.3:$PATH
+```
+
+The FVP requires an additional dependency, `libpython3.9.so.1.0`, which can be installed using a script. Note that this will tinkle with the python installation for the current terminal window, so make sure to open a new one for the next step.
+
+```bash
+source $HOME/FVP_Corstone_SSE-320/scripts/runtime.sh
+```
+
+Verify that the FVP was successfully installed by comparing your output from below command.
+
+```bash
+FVP_Corstone_SSE-320
+```
+
+```output
+telnetterminal0: Listening for serial connection on port 5000
+telnetterminal1: Listening for serial connection on port 5001
+telnetterminal2: Listening for serial connection on port 5002
+telnetterminal5: Listening for serial connection on port 5003
+
+```
+
+
+Now you are ready to test the application with the FVP.
+

content/learning-paths/microcontrollers/mlek/run.md

@@ -1,6 +1,6 @@
 ---
 # User change
-title: "Run the examples on Corstone-300 FVP"
+title: "Run the examples on the FVP"
 
 weight: 3 # 1 is first, 2 is second, etc.
 
@@ -9,35 +9,56 @@ layout: "learningpathall"
 ---
 ## Run an example
 
-To run an example on the Corstone-300 FVP target, launch the FVP executable with `-a` to specify the software application.
+Now you are ready to combine the FVP installation and the example application. Navigate to the evaluation kit repository.
 
-To run the key word spotting example `ethos-u-kws.axf` compiled with `gcc` use:
+```bash
+cd ml-embedded-evaluation-kit/
+```
+
+To run an example on the Corstone-320 FVP target, launch the FVP executable with `-a` to specify the software application.
+
+To run the key word spotting example `ethos-u-kws.axf` compiled with `gcc` use one of the two options below.
 
-- on your computer with the FVP installed
+## Option 1: On your computer with the FVP installed
+
+Run the FVP.
 
 ```console
-FVP_Corstone_SSE-300_Ethos-U55 -a cmake-build-mps3-sse-300-ethos-u55-128-gnu/bin/ethos-u-kws.axf
+FVP_Corstone_SSE-320                                    \
+    -C mps4_board.subsystem.ethosu.num_macs=256         \
+    -C mps4_board.visualisation.disable-visualisation=1 \
+    -C vis_hdlcd.disable_visualisation=1                \
+    -a cmake-build-mps4-sse-320-ethos-u85-256-gnu/bin/ethos-u-kws.axf
 ```
 
-- on Arm Virtual Hardware
+{{% notice Note %}}
+The number of NPU MACs specified in the build MUST match the number specified in the FVP. Else an error similar to the below will be emitted.
+
+```
+E: NPU config mismatch. npu.macs_per_cc=E: NPU config mismatch..
+```
+{{% /notice %}}
+
+## Option 2: On Arm Virtual Hardware
 
 ```console
 VHT_Corstone_SSE-300_Ethos-U55 -a cmake-build-mps3-sse-300-ethos-u55-128-gnu/bin/ethos-u-kws.axf
 ```
 When the example is running, a telnet instance will open allowing you to interact with the example.
 
 {{% notice Note %}}
-It may take some time to initialize the terminal, please be patient. 
+It may take some time to initialize the terminal, please be patient.
 
 If you see warnings regarding loading the image, these can likely be ignored.
 {{% /notice %}}
 
+## Interact with the application
 
 Use the menu to control the application. For the key word spotting application enter 1 to classify the next audio clip.
 
 ![terminal #center](term.png)
 
-The results of the classification will appear in the visualization window of the FVP. 
+The results of the classification will appear in the visualization window of the FVP.
 
 The display shows a 98% chance of the audio clips sound was down.
 
@@ -56,23 +77,23 @@ You can specify additional parameters to configure certain aspects of the simula
 List the available parameters by running the FVP executable with the `--list-params` option, for example:
 
 ```console
-FVP_Corstone_SSE-300_Ethos-U55 --list-params > parameters.txt
+FVP_Corstone_SSE-320 --list-params > parameters.txt
 ```
 
 {{% notice Note %}}
 If you are running with Arm Virtual Hardware substitute `VHT_Corstone_SSE-300_Ethos-U55` as the executable name.
 {{% /notice %}}
 
-Open the file `parameters.txt` to see all of the possible parameters and the default values. 
+Open the file `parameters.txt` to see all of the possible parameters and the default values.
 
 ### Set parameters
 
-Individual parameters can be set with the `-C` command option. 
+Individual parameters can be set with the `-C` command option.
 
 For example, to put the Ethos-U component into fast execution mode:
 
 ```console
-FVP_Corstone_SSE-300_Ethos-U55 -a cmake-build-mps3-sse-300-ethos-u55-128-gnu/bin/ethos-u-kws.axf -C ethosu.extra_args="--fast"
+FVP_Corstone_SSE-320 -a cmake-build-mps4-sse-320-ethos-u85-256-gnu/bin/ethos-u-kws.axf -C mps4_board.subsystem.ethosu.extra_args="--fast"
 ```
 {{% notice Note %}}
 Do not use fast execution mode whilst benchmarking performance.
@@ -83,14 +104,16 @@ To set multiple parameters it may be easier to list them in a text file (without
 For example, use a text editor to create a file named `options.txt` with the contents:
 
 ```console
-mps3_board.visualisation.disable-visualisation=1
-ethosu.extra_args="--fast"
+mps4_board.visualisation.disable-visualisation=1
+mps4_board.subsystem.ethosu.extra_args="--fast"
 ```
 
 Run the FVP with the `-f` option and the `options.txt` file:
 
 ```console
-FVP_Corstone_SSE-300_Ethos-U55 -a cmake-build-mps3-sse-300-ethos-u55-128-gnu/bin/ethos-u-kws.axf -f options.txt
+FVP_Corstone_SSE-320 -a cmake-build-mps4-sse-320-ethos-u85-256-gnu/bin/ethos-u-kws.axf -f options.txt
 ```
 
 Full instructions are provided in the evaluation kit [documentation](https://review.mlplatform.org/plugins/gitiles/ml/ethos-u/ml-embedded-evaluation-kit/+/HEAD/docs/quick_start.md).
+
+You have now run an example application on an Arm Fixed Virtual Platform.

data/stats_current_test_info.yml

@@ -1,5 +1,5 @@
 summary:
-  content_total: 303
+  content_total: 305
   content_with_all_tests_passing: 32
   content_with_tests_enabled: 34
 sw_categories: