Basic Virtual Interface Applications

This repository contains a simple Hello World example for Arm Virtual Hardware.

Examples Description

Example name	Description
Hello VSI	A sample of using the Virtual Streaming Interface on AVH. Data is streamed to the application via the python interface.There are different versions such as GUI version and gated fetch for various use cases.

Arm Virtual Hardware (AVH) Setup

Follow the Infrastructure documentation on how to setup AVH on the cloud or locally.

Change the Arm Tool Variant

In order to build applications for Arm Corstone-310, you need to use the ult tool variant. This is not necessary for Corstone-300 applications.

Change the tool variant by setting the following environment variable on the cloud or local build environment:

export ARM_TOOL_VARIANT='ult'

To make this permanent, you can add the line to your ~/.bashrc file.

Build a project

1. Clone this project using git.

   git clone https://github.com/Arm-Examples/Hello_AVH.git

2. Enter the application dir

   cd Hello_AVH/<example>

3. Update the keil packs index and Install necessary package

   csolution list packs -s target/<platform>/<application>.csolution.yml -m > packs.txt

   cpackget update-index

   cpackget add -f packs.txt
   

4. Convert yml project file to cprj project file

   csolution convert -s target/<platform>/<application>.csolution.yml

5. Build the application

   • Build with CMSIS Toolbox v1.3 or early

     cbuild --packs --rebuild target/<platform>/<application>.cprj

   • Build with CMSIS Toolbox v1.4 or later

     cbuild --packs --rebuild --update-rte target/<platform>/<application>.cprj

   You can run cbuild --version to check CMSIS Toolbox version

Run the Application using Virtual Hardware

./run_example.sh

Common Issues

Missing pack(s)

If you experience the following error:

M654: Package '<vendor>::<package>@<version>' was added to the list of missing packages.
error cbuild: missing packs must be installed, rerun cbuild with the --packs option

Use the following command to manually install the missing pack(s).
Note: replace <vendor>, <package> and <version> with the corresponding information from the error message.

cpackget pack add https://www.keil.com/pack/<vendor>.<package>.<version>.pack -a

Version History

Version	Date	Release notes
v0.0.1	2023.3.13	Arm VSI demo for Arm Virtual Hardware.
v0.0.1b	2023.3.29	Minor fix for v0.0.1
v0.0.1c	2023.4.12	Minor fix for v0.0.1b