Merge pull request #8 from ReinhardKeil/main

Doc improvements, cleanup, DWARF-5 added to csolution.yml

Author: ReinhardKeil

.vscode/settings.json

@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <package schemaVersion="1.7.40" xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="https://raw.githubusercontent.com/Open-CMSIS-Pack/Open-CMSIS-Pack-Spec/v1.7.40/schema/PACK.xsd">
   <vendor>ARM</vendor>
-  <name>CMSIS-MLEK</name>
-  <description overview="overview/README.md">MLEK (Machine Learning Evaluation Kit) for CMSIS workflows</description>
+  <name>cmsis-mlek</name>
+  <description overview="overview/README.md">Machine Learning Evaluation Kit (MLEK) for CMSIS workflows</description>
   <!-- web download link -->
   <url>https://www.keil.com/pack/</url>
   <license>LICENSE</license>

ARM.CMSIS-MLEK.pdsc

@@ -18,13 +18,13 @@ Directory                         | Description
 ----------------------------------|-------------------------------
 [overview](./overview)            | Top-level overview of MLEK reference applications.
 [docs](./docs/)                   | Source of the [user documentation](https://arm-examples.github.io/cmsis-mlek) of the MLEK reference applications.
-[template](./template)            | [MLEK reference applications](https://arm-examples.github.io/cmsis-mlek/main/template.html), a test framework for DSP and ML algorithms.
+[template](./template)            | MLEK reference applications source code.
 [.github/workflows](./.github/workflows) | GitHub Actions for validation and publishing.
 [.ci](./.ci)                      | Files that relate to CI tests.
 
 ## Related
 
-- [MLEK Pack](https://www.keil.arm.com/packs/MLEK) available on [keil.arm.com/packs](https://www.keil.arm.com/packs).
+- [CMSIS-MLEK Pack](https://www.keil.arm.com/packs/cmsis-mlek-arm) available on [keil.arm.com/packs](https://www.keil.arm.com/packs).
 - [tensorflow-lite-micro Pack](https://www.keil.arm.com/packs/tensorflow-lite-micro-tensorflow) available on [keil.arm.com/packs](https://www.keil.arm.com/packs).
 - [MLEK Examples](https://github.com/Arm-Examples/mlek-examples) a repository with MLEK applications that are configured for evaluation boards and use cases.
 - [ML Developers Guide for Cortex-M Processors and Ethos-U NPU](https://developer.arm.com/documentation/109267).

README.md

@@ -1,11 +1,20 @@
-# CMSIS-MLEK Reference Application Package
+# Machine Learning Evaluation Kit (MLEK) for CMSIS Workflows
 
-This documentation explains the usage of the CMSIS-MLEK Reference Application Package for developing Machine Learning (ML) and Edge AI applications on Cortex-M processors with Ethos-U NPUs.
+This documentation explains the usage of the CMSIS-MLEK Reference Application Package for developing Machine Learning (ML) and Edge AI applications on Cortex-M processors optional with Ethos-U NPUs.
 
 ## Target Audience
 
 This user's guide assumes basic knowledge about Cortex-M software development and CMSIS-Toolbox workflows. It is written for embedded software developers who work with C/C++ compiler toolchains and develop machine learning applications for microcontroller devices with Cortex-M processors and Ethos-U NPUs.
 
+## Manual Chapters
+
+- [**Overview**](overview.md) explains the features and capabilities of the MLEK templates package.
+- [**MLEK Audio Applications**](templates_audio.md) describes the available ML templates for audio use-cases.
+- [**MLEK Video Applications**](templates_video.md) describes the available ML templates for video and image use-cases.
+- [**Targeting Hardware Boards**](target_configuration_refapp.md) gives step-by-step guidance for deploying the reference applications to a hardware platform in VS Code.
+- [**Targeting Arm Virtual Hardware**](target_configuration_avh.md) shows how to select a virtual target in Visual Studio code.  
+
+<!--  Duplicate of Overview.md
 ## Package Overview
 
 The CMSIS-MLEK package provides ready-to-use templates and examples for machine learning applications. It includes three main template categories:
@@ -14,14 +23,6 @@ The CMSIS-MLEK package provides ready-to-use templates and examples for machine
 - **Video Reference Applications** - Object detection and video processing examples  
 - **Generic Reference Applications** - General-purpose inference runner for custom ML models (available from version 1.0+)
 
-## Manual Chapters
-
-- [**Overview**](overview.md) explains the features and capabilities of the MLEK templates package.
-- [**MLEK Reference Applications - Audio**](templates_audio.md) describes the available ML templates for audio use-cases.
-- [**MLEK Reference Applications - Video**](templates_video.md) describes the available ML templates for video and image use-cases.
-- [**Target Configuration Reference Application Hardware**](target_configuration_refapp.md) gives step-by-step guidance for deploying the reference applications to a hardware platform in Visual Studion Code. 
-- [**Target Configuration Arm Virtual Hardware**](target_configuration_avh.md) shows how to select a virtual target in Visual Studio code.  
-
 ## Available Templates
 
 The package includes the following example templates:
@@ -44,10 +45,10 @@ The templates support multiple Arm Cortex-M platforms:
 - **Corstone-320** (Cortex-M85 + Ethos-U85)
 
 Each template can be built for both Arm Virtual Hardware (AVH) simulation and physical evaluation boards.
+-->
 
 ## Revision History
 
 | Version | Description |
 |---------|-------------|
-| 0.1.0   | Initial draft release of CMSIS-MLEK templates package |
 | 0.5.0   | First published release.                              |

docs/images/ConfigureMLEKSolution.png

@@ -14,9 +14,9 @@ The CMSIS-MLEK software pack is derived from the [Arm® ML embedded evaluation k
 
 | ML application                                 | Description             |  Neural Network Model |
 |:-----------------------------------------------|:------------------------|:----------------------|
-| [Keyword spotting (KWS)](https://github.com/ARM-software/cmsis-mlek/template/audio)      | Recognize the presence of a key word in verbal speech | [MicroNet](https://github.com/ARM-software/ML-zoo/tree/9f506fe52b39df545f0e6c5ff9223f671bc5ae00/models/keyword_spotting/micronet_medium/tflite_int8) |
-| [Object detection](https://github.com/ARM-software/cmsis-mlek/template/video)           | Detects and draws face bounding box in a given image  | [Yolo Fastest](https://github.com/emza-vs/ModelZoo/blob/master/object_detection/yolo-fastest_192_face_v4.tflite) |
-| [Generic inference runner](https://github.com/ARM-software/cmsis-mlek/template/generic) | Code block allowing you to develop your own use case  | Your custom model |
+| [Keyword spotting (KWS)](https://github.com/Arm-Examples/cmsis-mlek/template/audio)      | Recognize the presence of a key word in verbal speech | [MicroNet](https://github.com/ARM-software/ML-zoo/tree/9f506fe52b39df545f0e6c5ff9223f671bc5ae00/models/keyword_spotting/micronet_medium/tflite_int8) |
+| [Object detection](https://github.com/Arm-Examples/cmsis-mlek/template/video)           | Detects and draws face bounding box in a given image  | [Yolo Fastest](https://github.com/emza-vs/ModelZoo/blob/master/object_detection/yolo-fastest_192_face_v4.tflite) |
+| [Generic inference runner](https://github.com/Arm-Examples/cmsis-mlek/template/generic) | Code block allowing you to develop your own use case  | Your custom model |
 
 Each [ML reference application](https://open-cmsis-pack.github.io/cmsis-toolbox/ReferenceApplications/) is a *csolution project* which supports deployment to physical hardware or Arm Virtual Hardware (AVH-FVP) for simulation.