Softwareaaaaaaaaaaaaaaaaaa

Overviewaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa

Sourceaaaaaaaaaaaaaaaaaaaaaa

Documentationaaaaaaaaaaaaaaaaaa

Self-Support

Topics Supported via Service Requestaaaaaaaaaaaaaaaaa

Not Supported via Service Request

The AMD Embedded Development Framework (EDF) is a common framework to support platform level development and embedded software solutions for AMD adaptive SoC and FPGA products, as well as their evaluation boards.

Embedded SW on Github

AMD Embedded Development Framework (EDF)

Embedded Linux Forum

• Most recent 2 major releases

• Optimizations/customizations

• SDK GUI

• ToolChain

• TCF/XSDB

• XSCT/ HSI / TCF / XSDB

• Performance Analysis

• Bootgen and the flash writer tool

• AMD provided libraries

• Standalone drivers

• Board Support Packages

The AMD SDK is a collection of tools used for doing Embedded SW Development, Debug, Performance Optimization, and Deployment. It includes facilities for generating project specific BSPs, libraries, and example code. Additionally, XSDB is the debug tool incorporated in the Xilinx Software Command LIne Tool (XSCT) and in the XSDK GUI.

Embedded SW on Github

• UG1137

• UG821

• UG910

• UG643

• Baremetal Drivers and Libraries

Embedded Development Tools Forum

• Most recent 2 major releases

• Optimizations/customizations

First Stage Boot Loader. Configure PS & PL resources, Load Boot loader images from non volatile memories such as NAND, SD, eMMC and QSPI to volatile memory such as DDR, TCM and OCM. Hand off to Second stage bootloader. Support Image Encryption and Decryption.

Embedded SW on Github

• UG1137

• UG1209

• FSBL Wiki

Embedded Linux Forum

• Most recent 2 major releases

• Optimizations/customizations

The Platform Management Unit (PMU) is critical to the proper operation of a Zynq US+ MPSoC-based solution. AMD provides source which builds binaries tested for such proper system operation.
Though customers are enabled with sources and tools to rebuild PMU firmware, customers should carefully consider modification of any software due to potential impact on proper system operations.
For those customers who choose to modify PMU Firmware, AMD provides support only to enable customers to build and debug such code. Due to the deeply embedded nature of this code, AMD is unable provide support which ensures customers of proper system operation subsequent to modification.
Only rarely, and with consideration does AMD expect customers to modify PMU-firmware. For those customers who do choose to modify the code, support by AMD will be limited to use of AMD tools to modify and rebuild the sources, and to those functions which are included in AMD releases.

Embedded SW on Github

• UG1085

• UG1137

• UG1209

• PMU Firmware Wiki

Embedded Linux Forum

• Most recent 2 major releases

• Optimizations/customizations

This Power Management Framework handles several use cases scenarios. For example, Linux provides basic power management capabilities such as idle, hotplug, suspend, resume, and wakeup. The kernel relies on the underlining APIs to execute power management decisions, but most RTOS's do not have this capability. Therefore they rely on user implementation, which is made easier with use of the Power Management Framework and the XilPM library.

Embedded SW on Github

• UG1137

• Zynq 7000 Power Management Design Hub

• ZU+ PM Wiki

• Zynq-7000 PM Wiki

Embedded Linux Forum

• AMD provided SW for supported use cases

• Optimizations/customizations

Properly developed and tested ARM Trusted Firmware is fundamental to recommended/supported operation of the APU. The binaries, built with source code provided by AMD, are supported and tested for AMD-enabled use cases and features including CSU access, AMP and power management support.
Only rarely, and with consideration does AMD expect customers to modify ATF. For those customers who do choose to modify the code, support by AMD will be limited to use of AMD tools to modify and rebuild the sources, and to those functions which are included in AMD releases.

ATF on Github

• ATF GitHub Documentation

• ATF Wiki

Embedded Linux Forum

• AMD provided ATF

• Optimizations/customizations

AMD U-Boot is an open source project based on http://git.denx.de, that is used as a second stage boot loader in order to boot Linux OS on AMD HW Platforms including Microblaze, Zynq-7000, Zynq Ultrascale+ and Versal devices. Along with boot loader functionality it offers some essential device drivers like UART, GPIO, I2C etc. for AMD HW platforms. It also lists the latest Flash devices tested, and up streams AMD patches.

U-Boot on Github

U-Boot Wiki

Flash Parts:

• Zynq-7000

• Zynq UltraScale Plus

Embedded Linux Forum

• AMD provided U-boot, features enabled in default configuration

• Features not enabled in default configuration

• Optimizations/customizations

• U-Boot SPL

AMD Linux is an open source project based on the http://kernel.org Linux kernel, which provides the latest kernel and all the essential device drivers and kernel frameworks needed by AMD hardware platforms. As part of the project AMD patches are also up-streamed as necessary.

Linux on Github

Linux Drivers Documentation

Embedded Linux Forum

• AMD drivers

• Kernel optimizations and customizations

• Open Source bugs in kernel including back-porting of patches

• 3rd Party Drivers

• Kernel version mismatch with release version

• RT Linux, SE Linux

• Non-AMD specific Linux features (contact appropriate Linux mailing list)

PetaLinux is a AMD Linux development tool and contains everything necessary to create, configure, build, test, package and deploy Embedded Linux systems on a AMD Hardware and QEMU Emulation Platform. It provides board support packages for AMD and third-party boards with prebuilt images. It uses the Yocto build system under the hood.

PetaLinux Product Page

• UG1144

• PetaLinux Release Notes Answer Record

• PetaLinux Yocto Tips

Embedded Linux Forum

• Most recent 2 major releases

• Kernel optimizations/Customizations

• Yocto features not tested/utilized by AMD

• Creation of custom recipes

• Custom build scripts for PetaLinux

• Open Source User Space Applications

• 32-bit Applications and Root File System (Multilib)

• Yocto Build system (Example: Buildroot, OpenWRT etc.)

AMD uses Yocto eSDK build system within our PetaLinux product which is the exclusive extent to which we test Yocto. AMD provide Yocto recipes for all key components. It is incumbent on our customers to address any issues between their own in-house Yocto build system and the Yocto recipes provided by AMD.

meta-xilinx on Github
meta-petalinux on Github
meta-openembedded on Github
meta-linaro on Github
meta-virtualization on Github
meta-openamp on Github
meta-xilinx-tools on Github
meta-qt5 on Github

• YoctoProject.org Documentation

• Yocto Wiki

For reporting bugs/patchs, please use the appropriate mailing list:

• meta-xilinx@yoctoproject.org

• yocto@yoctoproject.org

For anything else, post to:

Embedded Linux Forum

• Suspected bugs in Xilinx meta layers (meta-xilinx, meta-petalinux, meta-xilinx-tools, meta-openamp)

• Changes in the Yocto flow

• Modifications made to meta-xilinx, meta-petalinux, meta-xilinx-tools, meta-openamp

• Meta-xilinx, meta-petalinux, meta-xilinx-tools, meta-openamp layer versions not in sync with appropriate Linux Kernel, U-Boot and ATF tags

• Devtool Utility in Yocto

AMD XSDK includes a tested port of FreeRTOS for AMD silicon. This includes critical drivers needed to ensure basic multi-threaded support of FreeRTOS on AMD products. AMD bare-metal drivers can be used within a single-threaded context on FreeRTOS. It is beyond scope of A<D to provide support to customers who wish to use the bare-metal drivers in a multi-threaded application context.

Embedded SW on Github

• FreeRTOS.org Documentation

• FreeRTOS on Xilinx Wiki

FreeRTOS Forum

• XSDK Reference designs

• AMD BSPs

• Optimizations/Customizations

• Driver modifications for multi-threaded application support

• Baremetal interrupt applications running on the FreeRTOS platform

AMD provides essential components for a Xen hypervisor based solution consisting of Linux and bare-metal guests.

Xen Project
Xen on Github

• Xen Hypervisor

Embedded Linux Forum

• Petalinux reference designs

• Optimizations/Customizations

• Topics unrelated to Linux or AMD bare-metal guests

AMD provides documentation and code for usage of OpenAMP and libMetal within example designs. Customers should consult the source code and documentation for extension to alternate solutions.

OpenAMP on Github
meta-openamp on Github
libmetal on Github

• UG1186

• OpenAMP

AMD specific issues:

• OpenAMP Forum

General Issues:

• OpenAMP Mailing list

• AMD documented use cases and reference designs

• General OpenAMP Issues

AMD’s QEMU is an open source functionally accurate, virtual emulation platform. It enables customers to develop their embedded software exactly as they would on the actual hardware. Instead of having to carry around cables and boards you can develop your software entirely on your laptop. AMD’s QEMU is free of charge. It is delivered as part of AMD’s Petalinux, SDK and Yocto’s meta-xilinx layer. AMD provides QEMU virtual emulation platforms for Zynq 7000, Zynq Ultrascale+ MPSoC and Microblaze™

QEMU on Github

• UG1169 – 2019.2

• Introduction to Xilinx’s QEMU – YouTube

• Xilinx QEMU

Embedded Linux Forum

• Xilinx QEMU

• Optimizations/customizations

Whilst AMD works with its 3rd party software ecosystem partners to provide software and solutions for AMD products, those partners are responsible to provide all direct support, technical and business engagement.

Various Vendors

• Embedded Linux Forum

• Vendor specific forums

• No Support via SRs

• Debian, Android, etc

AMD has partnered with Canonical to provide certified Ubuntu images for AMD Silicon. As it is a partner provided image, support is limited from AMD and the partner/community is responsible to provide all direct support, technical and business engagement.

Install Ubuntu on Xilinx | Ubuntu

• Xilinx Ubuntu Wiki

• Embedded Linux Forum

•  

  • For official Canonical Ubuntu release, tag post with "Embedded Ubuntu"

• Other Canonical Ubuntu Support Information

• Kria SOM Application provided by AMD on Certified Ubuntu Images

• Kernel Customization

• Optimizations

• Kernel build

• Custom image certification

• Custom applications developed on Canonical Ubuntu

AMD provides an open source TCP/IP networking stack for embedded systems called Lightweight IP (lwIP). lwIP is a small, community-developed light-weight TCP/IP stack that can be used in bare-metal applications where networking is required. AMD support is limited to use of the community sources on AMD devices. Correction of lwIP bugs or other issues within the lwIP code base are presumed by AMD to take place within the developer community.

Embedded SW on Github

• UG643

• lwIP on Wiki

• lwIP Project

lwIP Mailing Lists

• XSDK Reference designs

• AMD BSPs

• Optimizations/customizations

Mali support is enabled/supported by AMD only for Linux. This support is provided via a GPL-licensed Linux kernel module as well as a AMD-built and provided user-space application binary. AMD is unable to routinely provide sources corresponding to the user-space application. Support is limited to use of the AMD-provided software in form of PetaLinux tools, or separately available Yocto recipes for Mali support.

Mali-400 SW download

• Adding Mali binaries on Wiki

• AMD provided binaries

• Optimizations/customizations

AMD Application Notes are provided as-is and only the specific conditions and scenarios described in the application note are supported.

• Exact conditions specified in application note

• Porting application notes to different versions

• Modifications to the design in any way

Whilst AMD works with its 3rd party software ecosystem partners to provide software and solutions for AMD products, those partners are responsible to provide all direct support, technical and business engagement.

Examples: 

• MCAL (Microcontroller Abstraction Layer) drivers & applications based on AUTOSAR or equivalent stacks

• Vendor specific forums or dedicated vendor support contact.

• No Support via SRs

• No Support via SRs