OpenAMP v2024.05

Introduction

This release contains SD card images and docker container images built from the various components of the OpenAMP v2024.05 release.

Components

• open-amp library v2024.05.1
• libmetal v2024.05.0
• openamp-system-reference v2024.05.0
• meta-openamp v2024.05.0
• openamp-ci-builds v2024.05.0
  • Linux kernel v6.6.33
  • poky yocto-5.0.1
  • AMD Xilinx release v2024.1 (for reference images and boot firmware)
  • ST-OSS scarthgap branch (for reference image and boot firmware)
• openamp-demo (this repo) v2024.05.0
• AMD Xilinx QEMU v2024.1
• Zephyr SDK 0.16.8

Highlights from changes in this repository

• Brought back the docker containers and improved their build procedure
• Docker images are supported on x86_64 and aarch64 (arm64) Linux
• Upgraded underling Xilinx QEMU to our build of AMD Xilinx V2024.1
• Upgraded to Zephyr SDK 0.16.8
• Upgraded container base OS to Ubuntu 22.04
• make-image-targets now supports creating GPT partitioned images
• ST audio workaround no longer needed
• Improvements to test-qemu (logging etc)
• Added README.md to document build instructions

Instructions

To run these demos from SD cards:

• Setup serial port access according to the board in use
• Write these images to an SD card and boot your board
• For Zynqmp boards, let the board boot to the u-boot menu
  • choose one of the 3 demo configurations
• On the serial port at the Linux prompt, log in with user root and no password
• Follow the instructions provided

To run this version of the docker image use the command below and follow the prompts:

$ docker run -it --rm openamp/demo-lite:v2024.05

Known Issues

• All platforms: "shutdown now" does not actually shutdown
  • This must be an OS misconfiguration as it applies to all platforms
• qemu-zcu102 (docker demos): There is still a 1% boot failure rate
• All ZynqMP platforms (kv260 ZCU102 HW & QEMU): Linux gets random Ethernet mac address
  • This means that HW boards will get a new IP address each boot
  • For QEMU the first boot will get the expected address, reboots will not
• Boot firmware for ST SD card image is still from v2023.10
• Boot firmware for qemu-zcu102 is still Xilinx v2022.1
• KV260: Linux looses access to the UART console after running the zephyr R5 demos as they take over the UART.
  • use ssh if you wish to retain shell access to Linux
  • This is due to the nature of the board and so there is not issue filed for improvement
• ZCU102: Some R5 demos print to the main UART
  • Most R5 demos print to the 2nd UART as we want

All changes

Full Changelog: v2023.10.0...v2024.05.0

Demos for v2023.10.0

These sdcard images contain the demos built with the v2023.10.0 release of OpenAMP.

The Linux rpmsg utilities and Zephyr apps were built with v2023.10.0 of openamp-system-reference.
The DTBs used in the demo were built using v2023.10.1 of openamp-system-reference.
The OS images and boot firmware were built with v2023.10.0 openamp-ci-builds.
And this repo combines them and contains the demo scripts.

To run these demos:

• write these images to an sd card and boot your board
• For Zynqmp boards, let the board boot to the u-boot menu
  • choose one of the 3 demo configurations
• On the serial port, log in with user root and no password
• Follow the instructions provided

Notes:

• KV260: Linux looses access to the UART console after running the zephyr R5 demos as they take over the UART.
  • use ssh if you wish to retain shell access to Linux
• ZCU102: shutdown -r now does not work correctly when u-boot comes back up.
  • Power cycle the board to run a different demo config
  • Most R5 demos print to the 2nd UART on this board
• There is no docker image update for this release due to issues with Xilinx QEMU and the upstream kernel (v6.5.8)
  • This will be fix later