.. ReleaseNotes should only be located in the latest release notes! .. _ReleaseNotes-57: BSP-Yocto-AM57x-Ampliphy-PD24.1.0 ================================= .. include:: ../substitutions.rst .. substitutions .. |local-release-name| replace:: BSP-Yocto-AM57x-PD24.1.0 .. |local-kernel-version| replace:: 6.1.80 .. |local-kernel-tag| replace:: v6.1.80-09.02.00.009-phy6 .. |local-kernel-repo| replace:: `PHYTEC Linux kernel repository `__ .. |local-uboot-version| replace:: v2023.04 .. |local-uboot-tag| replace:: v2023.04-09.02.00.009-phy3 .. |local-uboot-repo| replace:: `PHYTEC U-Boot bootloader repository `__ .. |local-yocto-version| replace:: 4.0.20 Kirkstone .. |local-yocto-repo| replace:: `PHYTEC Meta Layer repository `__ .. |local-default-kit| replace:: KPCM-057-Lin .. |vendor-fork| replace:: v09.02.00.009 This document highlights the key features and support included in the |local-release-name| software release for the |product| SOM and development kit. .. list-table:: Board Support Package Status :widths: 50 50 :stub-columns: 1 * - BSP Operating system - Linux * - Release Status - **RELEASED** * - Release Date - 2024-09-27 * - Repository - `PHYTEC Public Repos `_ * - Binaries - `BSP-Yocto-Ampliphy-AM57x-PD24.1.0 `_ New in this Release ------------------- **Yocto** ^^^^^^^^^ * **Yocto Update**: Update to 4.0 (Kirkstone). * **Virtualization Support**: Yocto now supports containerization via Podman and Docker. * **New Distro**: A new Yocto distribution, `ampliphy-rt`, has been introduced. It integrates Linux with PREEMPT_RT patches for real-time performance. **Linux Kernel** ^^^^^^^^^^^^^^^^ * **Kernel Update**: Update to Linux v6.1. * **2D Accelerator**: The Vivante GC320 2D accelerator now utilizes the mainline Etnaviv driver. * **RPMSG_RPC Disabled**: The `CONFIG_RPMSG_RPC` option is no longer enabled, which means H.264 decoding via the Ducati GStreamer plugin is no longer available. **U-Boot Bootloader** ^^^^^^^^^^^^^^^^^^^^^ * **Bootloader Update**: Update to U-Boot v2024.04 **Known Issues** ^^^^^^^^^^^^^^^^ * PHYTEC's Qt demo is not running on Wayland anymore. The EGL support in the SGX GPU driver has issues with Wayland. Wayland can still be used for other applications then EGL. TI acknowledged to fix this problem in their 10.x SDK. Software Versioning ------------------- The |release-name| software release is largely based off of |vendor|'s |vendor-fork| Processor SDK Linux release and shares much of the same components and features. .. list-table:: Software Versioning :widths: 50 50 50 :stub-columns: 1 * - Tested Build Environment - Ubuntu 20.04 - `Ubuntu 20.04 Release Downloads `_ * - Linux Kernel - |local-kernel-version| (tag: |local-kernel-tag|) - |local-kernel-repo| * - U-Boot Bootloader - |local-uboot-version| (tag: |local-uboot-tag|) - |local-uboot-repo| * - Yocto - |local-yocto-version| (tag: |release-name|) - |local-yocto-repo| Part Number Summary ------------------- .. list-table:: Hardware Summary :widths: 50 50 75 50 :header-rows: 1 * - Part Number - Hardware Description - Configuration Details (DDR3 / DDR ECC / eMMC or NAND / QSPI NOR / Controller / EEPROM / Ethernet PHY / RTC / Temp) - PCB Version * - PCM-057-40300111I.A0 - phyCORE-AM57x SOM - 2GB (2 banks) / No / 8GB eMMC / No / AM5728 / Yes / Yes / Yes / Industrial - 1428.3 * - PCM-057-10306111I.A0 - - 1GB (1 bank) / No / 8GB eMMC / No / AM5729 / Yes / Yes / Yes / Industrial - 1428.5 * - PCM-057-50500111I.A1 - - 4GB (2 banks) / No / 32GB eMMC / No / AM5728 / Yes / Yes / Yes / Industrial - 1428.5 * - PCM-057-32302111I.A1 - - 2GB (1 banks) / Yes / 8GB eMMC / No / AM5749 / Yes / Yes / Yes / Industrial - 1428.5 .. list-table:: Kit Summary :widths: 25 25 25 25 :header-rows: 1 * - Part Number - Yocto MACHINE - Hardware Description - Notes * - |local-default-kit| - phycore-am57xx-1 - PCM-057.A3 + PCM-948 **(Default Kit)** - * - - phycore-am57xx-2 - PCM-057.A3 + PCM-948 - Headless only * - - phycore-am57xx-3 - PCM-057-40A00111I + PCM-948 - NAND Supported Builds ---------------- This release supports multiple builds for different kits, Yocto images and distribution. The follow table lists all supported builds. See Part Number Summary for an detailed explanation of Yocto Machines and associated hardware. .. list-table:: Supported Build Summary :widths: 20 20 20 40 :header-rows: 1 * - Yocto MACHINE - Yocto Image - Yocto Distro - Description * - phycore-am57xx-1 - phytec-qt5demo-image - ampliphy-xwayland - Qt5 image with PHYTEC's ampliPHY Xwayland distribution for the |local-default-kit| kit. * - phycore-am57xx-1 - phytec-qt5demo-image -c populated_sdk - ampliphy-xwayland - Qt5 image with PHYTEC's ampliPHY Xwayland distribution for the |local-default-kit| kit. This build includes a SDK. * - phycore-am57xx-1 - phytec-headless-image - ampliphy - Headless image with PHYTEC's ampliPHY distribution for the |local-default-kit| kit. * - phycore-am57xx-1 - phytec-headless-image - ampliphy-rt - Headless image with PHYTEC's ampliPHY PREEMPT-RT distribution for the |local-default-kit| kit. * - phycore-am57xx-2 - phytec-headless-image - ampliphy - Headless image with PHYTEC's ampliPHY distribution for the |local-default-kit| kit. * - phycore-am57xx-2 - phytec-headless-image - ampliphy-rt - Headless image with PHYTEC's ampliPHY PREEMPT-RT distribution for the |local-default-kit| kit. * - phycore-am57xx-3 - phytec-qt5demo-image - ampliphy-xwayland - Qt5 image with PHYTEC's ampliPHY Xwayland distribution for the |local-default-kit| kit. * - phycore-am57xx-3 - phytec-headless-image - ampliphy - Headless image with PHYTEC's ampliPHY distribution for the |local-default-kit| kit. * - phycore-am57xx-3 - phytec-headless-image - ampliphy-rt - Headless image with PHYTEC's ampliPHY PREEMPT-RT distribution for the |local-default-kit| kit. Linux Device Tree Summary ------------------------- This is a summary of how the device tree source files (.dts) and the various include files (.dtsi) are broken down in the kernel. These files describe the hardware in a hierarchical and modular way to the kernel, connecting device drivers to the interfaces brought out by the carrier board. .. list-table:: Linux Device Tree Summary :widths: 50 75 50 :header-rows: 1 * - Hardware Target - Device Tree File Descriptions - Filename * - phyCORE-AM57x kit - Default dts Build Target (includes the other's below) - am5728-phytec-pcm-948-40300111I.dts * - - SOM (silicon-specific) - adds support and enables silicon-specific features - am5728-phycore-som.dtsi * - - Carrier Board - enables circuits supported by the SOM - am57xx-pcm-948.dtsi If designing your own custom carrier board around the |product| SOM, you will eventually define a custom device tree for your board that includes the .dtsi file for the SOM, which PHYTEC has provided for you. All the BSP changes custom for your application should eventually be consolidated into its own Meta Layer. Supported Boot Sources ---------------------- The |product| allows to load a bootloader from different kind of sources. .. list-table:: Boot Source Summary :widths: 25 25 50 :header-rows: 1 * - Boot Source - Status - Notes * - SD-Card - **Supported** - * - eMMC - **Supported** - * - NAND - **Supported** - Supported Interfaces -------------------- The following table outlines the validated interfaces of the default |product| development kit. .. note:: This table only outlines the key features of the |product| PHYTEC has chosen to enable by default, which serves as a basis for customization in production designs. Unnecessary interfaces can be disabled and additional interfaces can be enabled when deploying the SOM on a custom carrier board. Other features of the |product| may or may not be configurable depending on pin multiplexing conflicts, for more information review the |product| schematic in tandem with the Processor Datasheet. .. list-table:: Supported Interfaces :widths: 25 50 :header-rows: 1 * - Interface - Status * - Debug UART - **Supported** * - Heartbeat & CPU activity LEDs - **Supported** * - GPIO buttons & LEDs - **Supported** * - eMMC - **Supported** * - NAND - **Supported** * - 2x CAN - **Supported** * - 2x Ethernet - **Supported** * - SD Card - **Supported** * - I2C EEPROM - **Supported** * - I2C RTC - **Supported** * - Parallel Camera - **Supported** * - SPI NOR FLash - **Supported** * - Watchdog - **Supported** * - DSP - Untested * - PRU-ICSSG - Untested * - GPU - **Supported** * - USB 2.0 + USB 3.0 - **Supported** * - HDMI - **Supported** * - LVDS - **Supported** * - WIFI - **Supported** * - Bluetooth - **Supported** * - PCIe - **Supported** * - SATA - **Supported** * - Audio - **Supported** .. note:: For technical support, please visit `PHYTEC's Support Portal `_!