.. ReleaseNotes should only be located in the latest release notes! .. _ReleaseNotes-64: BSP-Yocto-Ampliphy-AM64x-PD25.1.0 ================================= .. include:: ../substitutions.rst .. substitutions .. |local-release-name| replace:: BSP-Yocto-Ampliphy-AM64x-PD25.1.0 .. |local-kernel-version| replace:: v6.12.8 .. |local-kernel-tag| replace:: v6.12.8-phy4 .. |local-uboot-version| replace:: v2025.01 .. |local-uboot-tag| replace:: v2025.01-phy2 .. |local-yocto-version| replace:: 5.0.7 Scarthgap .. |local-yocto-tag| replace:: BSP-Yocto-Ampliphy-AM64x-PD25.1.0 .. |local-default-kit| replace:: KPB-07124-002.A0 .. |local-kernel-repo| replace:: `PHYTEC Linux kernel repository `__ .. |local-uboot-repo| replace:: `PHYTEC U-Boot bootloader repository `__ .. |local-yocto-repo| replace:: `PHYTEC Meta Layer repository `__ 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 - 2025-03-28 * - Repository - `PHYTEC Public Repos `_ * - Binaries - `BSP-Yocto-Ampliphy-AM64x-PD25.1.0 `_ New in this Release ------------------- This is the first mainline release for the AM64x. It includes the same feature set as the previous release, with some additional changes. **Yocto** ^^^^^^^^^ * **CAN FD**: Now enabled by default. * **Inline-ECC**: Inline-ECC is now a machine feature and can be easily disabled via Yocto. * **EEPROM Flashtool**: Updated with a new command to store serial numbers. * **Meta TI**: Removed all dependencies on TI’s meta layer (meta-ti) to simplify the phyCORE-AM64x BSP. * **Initramfs**: Updated to include udev and network support. **Linux Kernel** ^^^^^^^^^^^^^^^^ * **Kernel Update**: Update to Linux v6.12 and transitioned from TI's branch to an upstream branch with minimal patches. * **Industrial Communication**: Added a new overlay for the PEB-C-010 expansion board, which supports industrial communication protocols. **U-Boot Bootloader** ^^^^^^^^^^^^^^^^^^^^^ * **Bootloader Update**: Update to U-Boot v2025.01 and transitioned from TI's branch to an upstream branch with minimal patches. * **EFI Capsule Updates**: Added support for updating U-Boot images using the EFI Firmware Management Protocol (FMP). **Issues Fixed** ^^^^^^^^^^^^^^^^ * **PRU Ethernet Crashes**: PRU_ICSSG-based Ethernet interfaces may experience crashes when operating at 10 Mbit/s. This issue has been resolved in the Linux mainline and will be integrated into a future PHYTEC release. * **PRU Ethernet Performance**: Enhanced the receive performance of PRU_ICSSG-based Ethernet interfaces from approximately 700 Mbit/s to 900 Mbit/s. **Known Issues** ^^^^^^^^^^^^^^^^ * **Linux RT Latency**: Real-time Linux can have worst-case latencies up to 600 microseconds under heavy memory load. * **Flashcp Command Failures**: Occasional failures during verification in `flashcp`. * **Remoteproc Driver**: The `remoteproc` driver might hang when re-starting an R5F core. Software Versioning ------------------- The |local-release-name| software release is based on mainline stacks and shares much of the same components and features as the |vendor| BSP. .. list-table:: Software Versioning :widths: 50 50 50 :stub-columns: 1 * - Tested Build Environment - Ubuntu 22.04 - `Ubuntu 22.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: |local-yocto-tag|) - |local-yocto-repo| Part Number Summary ------------------- .. list-table:: Hardware Summary :widths: 50 50 50 50 :header-rows: 1 * - Part Number - Hardware Description - Configuration Details (SOC / Features / DDR4 / eMMC / NOR / Ethernet PHY / RTC / Temperature) - PCB Version * - PCM-072-42F2DE11I.A0 - |product| SOM (HS-FS silicon) - AM6442 / Features F / 2GB / 32GB eMMC / 64MB OSPI NOR / Yes / Yes / Industrial - 1565.1 * - PCM-072-42F2DE01I.A0 - |product| SOM (HS-FS silicon) - AM6442 / Features F / 2GB / 32GB eMMC / 64MB OSPI NOR / No / Yes / Industrial - 1565.1 * - PCM-072-42F2BX11I.A0 - |product| SOM (HS-FS silicon) - AM6442 / Features F / 2GB / 8GB eMMC / no NOR / Yes / Yes / Industrial - 1565.1 * - PCM-072.A2 - |product| SOM (HS-FS silicon) - AM6442 / Features F / 2GB / 32GB eMMC / 64MB OSPI NOR / Yes / Yes / Industrial - 1565.1 * - PCM-072.A1 - |product| SOM (GP silicon) - AM6442 / Features F / 2GB / 32GB eMMC / 64MB OSPI NOR / Yes / Yes / Industrial - 1565.1 * - PBA-C-25.A2 - phyCORE-AM64x Carrier Board - - 1566.2 .. list-table:: Kit Summary :widths: 33 33 33 :header-rows: 1 * - Part Number - Yocto MACHINE - Hardware Description * - |local-default-kit| - phyboard-electra-am64xx-3 - PCM-072-42F2DE11I.A0 + PBA-C-25.A2 / Secure Boot enforced with certificates burned into the device. * - |local-default-kit| - phyboard-electra-am64xx-2 - PCM-072-42F2DE11I.A0 + PBA-C-25.A2 **(Default Kit)** * - KPB-07225-001.A0 - phyboard-electra-am64xx-1 - PCM-072.A2 + PBA-C-25.A2 **(Deprecated)** 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 * - phyboard-electra-am64xx-3 - phytec-headless-image - ampliphy - Headless image with PHYTEC's ampliPHY distribution for the |local-default-kit| kit. * - phyboard-electra-am64xx-3 - phytec-securiphy-image - securiphy - Securiphy image with PHYTEC's securiPHY distribution for the |local-default-kit| kit. This distro has Secure Boot activated and includes further security improvements. * - phyboard-electra-am64xx-3 - phytec-securiphy-bundle - securiphy - Securiphy bundle with PHYTEC's securiPHY distribution for the |local-default-kit| kit. Includes a raucb file to update a RAUC partition. * - phyboard-electra-am64xx-2 - phytec-headless-image - ampliphy - Headless image with PHYTEC's ampliPHY distribution for the |local-default-kit| kit. * - phyboard-electra-am64xx-2 - phytec-headless-image -c populated_sdk - ampliphy - Headless image with PHYTEC's ampliPHY distribution for the |local-default-kit| kit. * - phyboard-electra-am64xx-2 - phytec-container-image - ampliphy - Container image with PHYTEC's ampliPHY distribution for the |local-default-kit| kit. This build includes virtualization. * - phyboard-electra-am64xx-2 - phytec-headless-image - ampliphy-linux-mainline - Headless image with PHYTEC's ampliPHY distribution for the |local-default-kit| kit. This build includes virtualization and is based on the latest Linux mainline tag, providing an experience aligned with the upstream version. * - phyboard-electra-am64xx-2 - phytec-initramfs-image - ampliphy - initramfs image with PHYTEC's ampliPHY distribution for the |local-default-kit| kit. Contains an initramfs to boot Linux from OSPI. * - phyboard-electra-am64xx-2 - phytec-headless-image - ampliphy-rauc - Headless image with PHYTEC's ampliPHY RAUC distribution for the |local-default-kit| kit. Enables RAUC and includes a partup image for updates. * - phyboard-electra-am64xx-2 - phytec-headless-bundle - ampliphy-rauc - Headless bundle with PHYTEC's ampliPHY RAUC distribution for the |local-default-kit| kit. Includes a raucb file to update a RAUC partition. * - phyboard-electra-am64xx-2 - phytec-headless-image - ampliphy-rt - Headless image with PHYTEC's ampliPHY RT distribution for the |local-default-kit| kit. Enables to the Linux RT branch. * - phyboard-electra-am64xx-1 - phytec-headless-image - ampliphy - Headless image with PHYTEC's ampliPHY 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: 33 33 33 :header-rows: 1 * - Hardware Target - Device Tree File Descriptions - Filename * - |local-default-kit| **(Default Kit)** - Default Device Tree (includes the other .dtsi files below) - k3-am642-phyboard-electra-rdk.dts * - - Processor .dtsi - This file adds general support for the AM642x Processor from Texas Instruments - k3-am642.dtsi * - - SOM .dtsi- This file adds support for your specific SOM's population options - k3-am64-phycore-som.dtsi * - - PCIe Overlay - k3-am642-phyboard-electra-pcie-usb2.dtbo * - - GPIO Fan Overlay - k3-am642-phyboard-electra-gpio-fan.dts * - - GPIO1, SPI1 and UART3 Overlay - k3-am642-phyboard-electra-x27-gpio1-spi1-uart3.dts * - - PEB-C-010 Expansion Board Overlay. Required for industrial communication protocols. - k3-am642-phyboard-electra-peb-c-010.dts 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 25 :header-rows: 1 * - Boot Source - Status - Notes * - SD-Card - **Supported** - * - eMMC - **Supported** - * - QSPI/OSPI-Nor Flash - **Supported** - * - Ethernet - Unsupported - * - USB/DFU - Unsupported - phyBOARD-Electra has a USB Hub connected to the USB interface. * - UART - **Supported** - Debug UART (X49) - Can't boot Linux via UART. Supported Features ------------------ The following table contains all supported |product| features. .. list-table:: Hardware Feature Summary :widths: 25 25 25 25 :header-rows: 1 * - Feature - Sub-Feature - Status - Notes * - SoC - AM6442 - **Supported** - * - - AM6441 - Untested - * - - AM6422 - Untested - * - - AM6421 - Untested - * - - AM6412 - Untested - * - - AM6411 - Untested - * - - AM243x - Unsupported - * - DDR4 - 512 MB - Unsupported - * - - 1 GB - **Supported** - * - - 2 GB - **Supported** - * - - Inline ECC - **Supported** - * - eMMC - - **Supported** - * - SPI-NOR Flash - OSPI - **Supported** - * - - QSPI - **Supported** - * - Power Management - PMIC - **Supported** - * - - Suspend to RAM - Unsupported - * - - MCU Only Low Power Mode - Unsupported - * - Watchdog - - **Supported** - * - SD-Card - - **Supported** - * - RTC - - **Supported** - * - GPIO - - **Supported** - * - UART - - **Supported** - * - I2C - - **Supported** - * - SPI - - **Supported** - * - ePWM - - Untested - * - eQEP - - Untested - * - ADC - - **Supported** - * - CAN - - **Supported** - * - - CAN FD - **Supported** - * - USB 2.0 - - **Supported** - * - USB 3.0 - - **Supported** - * - Ethernet - - **Supported** - * - - TSN Support - **Supported** - * - PCIe - - **Supported** - * - TPM - - **Supported** - * - Security - Secure Boot - **Supported** - * - - Image Encryption - Unsupported - * - - Secure Key Storage - Unsupported - * - - TEE - **Supported** - * - - Cryptographic Acceleration - **Supported** - * - MCU - GPIO - **Supported** - * - - SPI - Untested - * - - UART - **Supported** - * - - CAN - Untested - * - - I2C - Untested - * - PRU Subsystem - Ethercat - Untested - * - - Profibus - Untested - * - - GPIO - Untested - * - - UART - Untested - * - - I2C - Untested - * - Virtualization - Podman - **Supported** - Only available in phytec-container-image Interface Overview ------------------ The following table contains all interfaces connected to the |product|'s connectors and each status. .. note:: For simplicity reasons interfaces located in the MCU and WAKEUP domains have a prefix. Interfaces located in the MAIN domain might have a `main_` prefix but it was not added here. .. list-table:: Interface Overview :widths: 20 20 20 20 20 :header-rows: 1 * - Interface - Detail - BSP Status - Upstream Status - Notes * - ADC - adc0 - **Supported** - **Supported** - * - CAN - mcan0 - **Supported** - **Supported** - * - - mcan1 - **Supported** - **Supported** - * - ECAP - ecap0 - disabled - disabled - * - - ecap1 - disabled - disabled - * - - ecap2 - disabled - disabled - * - Ethernet - eth0 (cpsw ethernet) - **Supported** - **Supported** - DP83867IRRGZ SOM PHY * - - eth1 (pri-icssg0 ethernet) - **Supported** - **Supported** - DP83867IRRGZ CB PHY * - - eth2 (pri-icssg0 ethernet) - **Supported** - **Supported** - DP83867IRRGZ CB PHY * - EPWM - epwm0 - **Supported** - **Supported** - Enabled via Device Tree Overlay * - - epwm1 - disabled - disabled - * - - epwm2 - disabled - disabled - * - EQEP - eqep0 - disabled - disabled - * - - eqep1 - disabled - disabled - * - - eqep2 - disabled - disabled - * - FSI - fsi0 - disabled - disabled - * - - fsi1 - disabled - disabled - * - - fsi2 - disabled - disabled - * - - fsi3 - disabled - disabled - * - - fsi4 - disabled - disabled - * - - fsi5 - disabled - disabled - * - GPIO - gpio0 - **Supported** - **Supported** - * - - gpio1 - **Supported** - **Supported** - * - - mcu_gpio0 - disabled - disabled - * - GPMC - gpmc0 - disabled - disabled - * - I2C - i2c0 - **Supported** - **Supported** - * - - i2c1 - **Supported** - **Supported** - * - - i2c2 - disabled - disabled - * - - i2c3 - disabled - disabled - * - - mcu_i2c0 - disabled - disabled - * - - wkup_i2c0 - disabled - disabled - * - MMC - mmc0 - **Supported** - **Supported** - eMMC Flash Memory on the SOM * - - mmc1 - **Supported** - **Supported** - SD Card Slot on Dev Kit Carrier Board * - mPCIe - serdes0 - **Supported** - **Supported** - mPCIe at the X31 connector - Enabled with device tree overlay - serdes0 signals muxed between USB HUB and mPCIe * - OSPI - ospi0 - **Supported** - **Supported** - NOR Serial Flash on SOM * - PRUSS - pr0_pru0 - disabled - disabled - * - - pr0_pru1 - disabled - disabled - * - SPI - spi0 - **Supported** - **Supported** - Enabled with spidev driver via Device Tree Overlay * - - spi1 - disabled - disabled - * - - spi2 - disabled - disabled - * - - spi3 - disabled - disabled - * - - spi4 - disabled - disabled - * - - mcu_spi0 - disabled - disabled - * - - mcu_spi1 - disabled - disabled - * - UART - uart0 - **Supported** - **Supported** - Default serial console - Connected to UART-to-USB FTDI IC * - - uart1 - **Supported** - **Supported** - UART1 may be used by TIFS firmware * - - uart2 - disabled - disabled - * - - uart3 - disabled - disabled - * - - uart4 - disabled - disabled - * - - uart5 - disabled - disabled - * - - uart6 - disabled - disabled - * - - mcu_uart0 - disabled - disabled - Default stdout for M4F co-processor * - - mcu_uart1 - disabled - disabled - * - USB - usb0 - **Supported** - **Supported** - Connected to USB 3.0 HUB - USB super speed signals (serdes0) muxed between USB HUB and mPCIe with device tree overlay - USB2.0 speeds still supported when mPCIe enabled .. include:: ../../common/support-disclaimer-us.rst