.. ReleaseNotes should only be located in the latest release notes! .. _ReleaseNotes-62: BSP-Yocto-Ampliphy-AM62x-PD25.1.1 ================================== .. include:: ../substitutions.rst .. substitutions .. |local-release-name| replace:: BSP-Yocto-Ampliphy-AM62x-PD25.1.1 .. |local-ti-sdk-version| replace:: v11.02.11 .. |local-kernel-version| replace:: v6.12.57-11.02.11 .. |local-kernel-tag| replace:: v6.12.57-11.02.11-phy6 .. |local-uboot-version| replace:: v2025.07 .. |local-uboot-tag| replace:: v2025.07-phy9 .. |local-yocto-version| replace:: 5.0.16 Scarthgap .. |local-yocto-tag| replace:: BSP-Yocto-Ampliphy-AM62x-PD25.1.1 .. |local-default-kit| replace:: KPB-07124-002.A2 .. |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 - 2026-04-17 * - Repository - `PHYTEC Public Repos `_ * - Binaries - `BSP-Yocto-Ampliphy-AM62x-PD25.1.1 `_ New in this Release ------------------- **Yocto** ^^^^^^^^^ * **TI Firmware Update**: Bumped TI firmware to v11.02.11 * **Camera Support**: Added phycam-setup package and udev rules for phyBOARD-Lyra camera * **Vulkan**: Enabled Vulkan distro feature * **partup**: Updated to v3.0.0 with SPI-NOR flash layout configs * **Serial Names**: Serial interfaces now have predicable aliases in /dev/serial/by-label/ based on the device-tree node name. The behavior of /dev/ttyS devices has not been changed. **Linux Kernel** ^^^^^^^^^^^^^^^^ * **Kernel Update**: Update to v6.12.57 (tag: v6.12.57-11.02.11-phy6) based on TI SDK v11.02.11 * **TI SDK Update**: Bump from TI Processor SDK v11.01.05 to v11.02.11 * **AR0144 Camera Fixes**: Fixed frame rate calculation, blanking control representation, and disallowed dynamic pixel correction changes while streaming * **I2C Bus Frequency Fix**: Corrected I2C bus frequency for cameras on phyBOARD-Lyra **U-Boot Bootloader** ^^^^^^^^^^^^^^^^^^^^^ * **Bootloader Update**: Update to U-Boot v2025.07 (tag: v2025.07-phy9) * **RAUC Bootmeth**: Merged upstream RAUC A/B bootmeth with memory handling fixes **Issues Fixed** ^^^^^^^^^^^^^^^^ **Known Issues** ^^^^^^^^^^^^^^^^ * **Securiphy**: There was a regression in the chain of trust while booting. When switching to u-boot standard boot we added an unsigned boot script, which is a violation of the chain of trust. This only applies to the securiphy distro. * **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`. * **Weston Startup Issues**: Failure to start Weston when both HDMI and LVDS are active at boot. * **Low-Power Mode MCU Issue**: MCU-only low-power mode is non-functional when M4F firmware is loaded. * **USB I/O errors**: There may be I/O errors with **/dev/sdb** during the boot process from eMMC. However, no issues have been observed when reading from or writing to the drive after booting. Software Versioning ------------------- The |local-release-name| software release is largely based off of |vendor|'s |local-ti-sdk-version| 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 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| Upstream Status ^^^^^^^^^^^^^^^ PHYTEC is dedicated to upstreaming the |product| platform to mainline repositories. The versions shown in the tables below represent the setups used for validation of this release. The Upstream Status entries under Supported Boot Sources and Supported Features indicate the current upstream state of each feature. .. list-table:: Upstream Repository Versions :widths: 50 50 :stub-columns: 1 * - Project - Version * - Linux - 6.17-rc5 * - U-Boot - 2025.10-rc4 Part Number Summary ------------------- .. list-table:: Hardware Summary :widths: 25 25 25 25 :header-rows: 1 * - Part Number - Hardware Description - Configuration Details (SOC / PRU / DDR4 / eMMC / NOR / Ethernet PHY / RTC / Temperature) - PCB Version * - PCM-071-5432DE11I-0.A1 - |product| SOM (HS-FS silicon) - AM6254 / 2 PRUs + OPP High-Speed / 2GB / 32GB eMMC / 64MB OSPI NOR / Yes / Yes / Industrial - 1573.2 * - PCM-071-3231BX11I-0.A1 - |product| SOM (HS-FS silicon) - AM6232 / 2 PRUs + OPP High-Speed / 1GB / 8GB eMMC / no NOR / Yes / Yes / Industrial - 1573.2 * - PCM-071.A1 - |product| SOM (GP silicon) - AM6254 / 2 PRUs + OPP High-Speed / 2GB / 32GB eMMC / 64MB OSPI NOR / Yes / Yes / Industrial - 1573.1 * - PBA-C-24.A4 - phyBOARD-Lyra AM62x (phyCORE-AM62x Carrier Board) - - 1576.4 .. list-table:: Kit Summary :widths: 33 33 33 :header-rows: 1 * - Part Number - Yocto MACHINE - Hardware Description * - |local-default-kit| - phyboard-lyra-am62xx-4 - PCM-071-5432DE11I-0.A1 + PBA-C-24.A4 / Secure Boot enforced with certificates burned into the device. * - |local-default-kit| - phyboard-lyra-am62xx-3 - PCM-071-5432DE11I-0.A1 + PBA-C-24.A4 **(Default Kit)** * - KPB-07124-001.A1 - phyboard-lyra-am62xx-2 - PCM-071.A1 + PBA-C-24.A4 **(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-lyra-am62xx-4 - phytec-headless-image - ampliphy - Headless image with PHYTEC's ampliPHY distribution for the |local-default-kit| kit. * - phyboard-lyra-am62xx-4 - 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-lyra-am62xx-3 - phytec-qt6demo-image - ampliphy - Qt6 image with PHYTEC's ampliPHY distribution for the |local-default-kit| kit. * - phyboard-lyra-am62xx-3 - phytec-qt6demo-image -c populated_sdk - ampliphy - Qt6 image with PHYTEC's ampliPHY distribution for the |local-default-kit| kit. This build includes a SDK. * - phyboard-lyra-am62xx-3 - phytec-qt6demo-image - ampliphy-linux-mainline - Qt6 image with PHYTEC's ampliPHY distribution for the |local-default-kit| kit. This build uses the latest Linux mainline tag, offering an experience consistent with the upstream version. * - phyboard-lyra-am62xx-3 - 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-lyra-am62xx-3 - 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-lyra-am62xx-3 - phytec-headless-image - ampliphy - Headless image with PHYTEC's ampliPHY distribution for the |local-default-kit| kit. * - phyboard-lyra-am62xx-2 - phytec-qt6demo-image - ampliphy - Qt6 image with PHYTEC's ampliPHY distribution for the KPB-07124-001.A1 kit. Ampliphy Linux Mainline ^^^^^^^^^^^^^^^^^^^^^^^ Our BSP includes a distro called ``ampliphy-linux-mainline``, which tracks the latest tagged Linux versions. Refer to the chapter |ref-build-bsp| for instructions on selecting and building this distribution, or use the pre-built images provided with the |http-link-download-bsp| release. .. note:: Currently, we do not provide a mainline U-Boot version within our Yocto BSP. 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: 25 50 25 :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-am625-phyboard-lyra-rdk.dts * - - Processor .dtsi - This file adds general support for the AM625x Processor from Texas Instruments - k3-am625.dtsi * - - SOM .dtsi- This file adds support for your specific SOM's population options - k3-am62-phycore-som.dtsi * - - WIFI Overlay - k3-am62-phyboard-lyra-m2-cc3351.dts * - - OLDI Display Overlay - k3-am62-phyboard-lyra-oldi-lcd185.dts * - - OLDI Display Overlay for PHYTEC AC200 Display - k3-am62-phyboard-lyra-oldi-ac200.dts * - - OLDI Display Overlay for PHYTEC AC209a Display - k3-am62-phyboard-lyra-oldi-ac209a.dts * - - MIPI Camera Overlay - k3-am62-phyboard-lyra-vm016-mipi.dts * - - SPI0 Overlay - k3-am62-phyboard-lyra-x17-spi0.dts * - - PEB-X-005 EV communication Overlay - k3-am62-phyboard-lyra-x17-evse.dts * - - GPIO Fan Overlay - k3-am62x-phyboard-lyra-gpio-fan.dts * - - Overlay to enable Low-Power Modes - k3-am62-phyboard-lyra-lpm.dtbo.dts * - - Disable OSPI NOR Overlay - k3-am6xx-phycore-disable-spi-nor.dts * - - Disable RTC Overlay - k3-am6xx-phycore-disable-rtc.dts * - - Disable SOM Ethernet PHY Overlay - k3-am6xx-phycore-disable-eth-phy.dts * - - Switch from OSPI to QSPI SPI NOR Flash - k3-am6xx-phycore-qspi-nor.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 25 :header-rows: 1 * - Boot Source - Release Status - Upstream Status - Notes * - SD-Card - **Supported** - **Supported** - * - eMMC - **Supported** - **Supported** - * - QSPI/OSPI-Nor Flash - **Supported** - **Supported** - * - Ethernet - **Supported** - **Supported** - Eth0 (X7) * - USB/DFU - **Supported** - **Supported** - USB-C (X34) * - UART - **Supported** - **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: 20 20 20 20 20 :header-rows: 1 * - Feature - Sub-Feature - Release Status - Upstream Status - Notes * - SoC - AM6254 - **Supported** - **Supported** - * - - AM6252 - **Supported** - **Supported** - * - - AM6251 - **Supported** - **Supported** - * - - AM6234 - **Supported** - **Supported** - * - - AM6232 - **Supported** - **Supported** - * - - AM6231 - **Supported** - **Supported** - * - - AM6204 - Unsupported - Unsupported - * - - AM6202 - Unsupported - Unsupported - * - - AM6201 - Unsupported - Unsupported - * - DDR4 - 512 MB - Unsupported - Unsupported - * - - 1 GB - **Supported** - **Supported** - * - - 2 GB - **Supported** - **Supported** - * - - 4 GB - **Supported** - **Supported** - * - - Inline ECC - **Supported** - **Supported** - Disabled by default. * - eMMC - - **Supported** - **Supported** - * - SPI-NOR Flash - OSPI - **Supported** - **Supported** - * - - QSPI - **Supported** - **Supported** - * - Power Management - PMIC - **Supported** - **Supported** - * - - Suspend to RAM - **Supported** - Unsupported - Requires the lpm overlay. * - - MCU Only Low Power Mode - Unsupported - Unsupported - * - - A53 1.4 GHz Frequency - **Supported** - **Supported** - * - Watchdog - - **Supported** - **Supported** - * - GPU - - **Supported** - **Supported** - * - SD-Card - - **Supported** - **Supported** - * - RTC - - **Supported** - **Supported** - * - GPIO - - **Supported** - **Supported** - * - UART - - **Supported** - **Supported** - * - I2C - - **Supported** - **Supported** - * - SPI - - **Supported** - **Supported** - * - ePWM - - Untested - Untested - * - eQEP - - Untested - Untested - * - CAN - - **Supported** - **Supported** - * - - CAN FD - **Supported** - **Supported** - * - McASP - Play - **Supported** - **Supported** - * - - Record - **Supported** - **Supported** - * - USB 2.0 - - **Supported** - **Supported** - * - USB-C - Data Transport - **Supported** - **Supported** - * - - Power Delivery - Unsupported - Unsupported - * - Ethernet - - **Supported** - **Supported** - * - - TSN Support - **Supported** - Unsupported - * - MIPI-CSI - VM-016 - **Supported** - Unsupported - * - OLID/LVDS - - **Supported** - Unsupported - * - HDMI - Video - **Supported** - **Supported** - * - - Audio - Unsupported - Unsupported - * - WiFi - - **Supported** - Unsupported - * - Bluetooth - - **Supported** - Unsupported - * - Security - Secure Boot - **Supported** - **Supported** - * - - Image Encryption - Unsupported - Unsupported - * - - Secure Key Storage - Unsupported - Unsupported - * - - TEE - **Supported** - **Supported** - * - - Cryptographic Acceleration - **Supported** - **Supported** - * - MCU - GPIO - **Supported** - **Supported** - * - - SPI - Untested - Untested - * - - UART - **Supported** - **Supported** - * - - CAN - Untested - Untested - * - - I2C - Untested - Untested - * - PRU Subsystem - Ethercat - Untested - Untested - * - - Profibus - Untested - Untested - * - - GPIO - Untested - Untested - * - - UART - Untested - Untested - * - - I2C - Untested - Untested - * - Qt5 - - Unsupported - Unsupported - * - Qt6 - - **Supported** - **Supported** - * - Virtualization - Podman - **Supported** - **Supported** - 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: 25 25 25 25 :header-rows: 1 * - Interface - Detail - Status - Notes * - CAN - mcan0 - **Supported** - * - - mcu_mcan0 - disabled - * - - mcu_mcan1 - disabled - * - MIPI CSI-2 - ti_csi2rc0 - **Supported** - Enabled via Device Tree Overlay * - ECAP - ecap0 - disabled - * - - ecap1 - disabled - * - - ecap2 - disabled - * - Ethernet - eth0 (cpsw ethernet) - **Supported** - DP83867IRRGZ SOM PHY * - - eth1 (cpsw ethernet) - **Supported** - DP83867IRRGZ CB PHY * - EPWM - epwm0 - **Supported** - Enabled via Device Tree Overlay * - - epwm1 - disabled - * - - epwm2 - disabled - * - EQEP - eqep0 - disabled - * - - eqep1 - disabled - * - - eqep2 - disabled - * - GPIO - gpio0 - **Supported** - * - - gpio1 - **Supported** - * - - mcu_gpio0 - disabled - * - GPMC - gpmc0 - disabled - * - HDMI - vout0 - **Supported** - * - I2C - i2c0 - **Supported** - * - - i2c1 - **Supported** - * - - i2c2 - disabled - * - - i2c3 - disabled - * - - mcu_i2c0 - disabled - * - - wkup_i2c0 - disabled - * - McASP - mcasp0 - disabled - * - - mcasp1 - disabled - * - - mcasp1 - **Supported** - * - MMC - mmc0 - **Supported** - eMMC Flash Memory on the SOM * - - mmc1 - **Supported** - SD Card Slot on Dev Kit Carrier Board * - - mmc2 - **Supported** - M.2 connector on Dev Kit Carrier Board * - OLDI LVDS Display - oldi0 - **Supported** - Enabled via Device Tree Overlay * - OSPI - ospi0 - **Supported** - NOR Serial Flash on SOM * - PRUSS - pr0_pru0 - disabled - * - - pr0_pru1 - disabled - * - SPI - spi0 - **Supported** - Enabled with spidev driver via Device Tree Overlay * - - spi1 - disabled - * - - spi2 - disabled - * - - mcu_spi0 - disabled - * - - mcu_spi1 - disabled - * - UART - uart0 - **Supported** - Default serial console - Connected to UART-to-USB FTDI IC * - - uart1 - **Supported** - UART1 may be used by TIFS firmware * - - uart2 - disabled - * - - uart3 - disabled - * - - uart4 - disabled - * - - uart5 - disabled - * - - uart6 - disabled - * - - mcu_uart0 - disabled - Default stdout for M4F co-processor * - - wkup_uart0 - disabled - * - USB - usb0 - **Supported** - Connected to USB C port X34 * - - usb1 - **Supported** - Connected to USB 2.0 HUB .. include:: ../../common/support-disclaimer-us.rst