BSP-Yocto-Ampliphy-AM62Ax-PD24.1.0 ================================== .. include:: ../substitutions.rst .. substitutions .. |local-release-name| replace:: BSP-Yocto-Ampliphy-AM62Ax-PD24.1.0 .. |local-ti-sdk-version| replace:: v10.00.08 .. |local-kernel-version| replace:: v6.6.32-10.00.08 .. |local-kernel-tag| replace:: v6.6.32-10.00.08-phy2 .. |local-uboot-version| replace:: v2024.04 .. |local-uboot-tag| replace:: v2024.04-10.00.08-phy2 .. |local-yocto-version| replace:: 5.0.3 Scarthgap .. |local-yocto-tag| replace:: BSP-Yocto-Ampliphy-AM62Ax-PD24.1.0 .. |local-default-kit| replace:: KPB-07524-ALPHA.A1 .. |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 - 2024-09-27 * - Repository - `PHYTEC Public Repos `_ * - Binaries - `BSP-Yocto-Ampliphy-AM62Ax-PD24.1.0 `_ New in this Release ------------------- **Yocto** ^^^^^^^^^ * **Yocto Update**: Update to 5.0 (Scarthgap). * **OP-TEE 4.2**: Trusted Execution Environment updated to version 4.2. * **Watchdog**: Switched from Poky to using `systemd` watchdog, which would handle system restarts or shutdowns in case of failure. * **Kernel Recipe**: Kernel metadata handling with `.scc` (Source Code Control) files, integrating Poky's kernel recipe handling features. * **Qt Update**: Update to Qt6 and switch to `phytec-qt6demo-image`. **Linux Kernel** ^^^^^^^^^^^^^^^^ * **Kernel Update**: Update to Linux v6.6. **U-Boot Bootloader** ^^^^^^^^^^^^^^^^^^^^^ * **Bootloader Update**: Update to U-Boot v2024.04 * **OSPI Partitions in Device Tree**: Defining OSPI flash partitions directly in the device tree. **Issues Fixed** ^^^^^^^^^^^^^^^^ * **Poweroff Fix**: The board now shuts down properly without triggering a reset via the watchdog. * **R5F Firmware Restart**: Fixed issues with restarting the M4F firmware. * **Bootloader via Ethernet**: Booting the bootloader through Ethernet is now functional. **Known Issues** ^^^^^^^^^^^^^^^^ * **Flashcp Command Failures**: Occasional failures during verification in `flashcp`. * **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. * **Boot Hang Issue**: The first-stage bootloader occasionally hangs in about 1% of all boot attempts on High Secure devices. * **Partup**: Partup packages built with the `ampliphy-rauc` distro contain a faulty layout configuration. The filesystem of the config and app partitions is incorrectly set to `null`. The filesystem type for the config and app partitions has been corrected to `ext4` in `meta-phytec`. This fix will be included in the next release. Partup packages built with the `ampliphy` and `ampliphy-xwayland` distros are not affected by this issue. 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 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: |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 * - PCL-075.A1 - |product| SOM (HS-FS silicon) - AM62A74 / JPEG Encoder + OPP High-Speed / 2GB / 32GB eMMC / 64MB OSPI NOR / Yes / Yes / Industrial - 1598.1 * - PCM-075.A0 - |product| SOM (GP silicon) - AM62A74 / JPEG Encoder + OPP High-Speed / 2GB / 32GB eMMC / 64MB OSPI NOR / Yes / Yes / Industrial - 1598.0 * - PBA-C-24.A3 - phyCORE-AM62x Carrier Board - - 1576.3 .. list-table:: Kit Summary :widths: 33 33 33 :header-rows: 1 * - Part Number - Yocto MACHINE - Hardware Description * - |local-default-kit| - phyboard-lyra-am62axx-2 - PCM-075.A1 + PBA-C-24.A3 **(Default Kit)** * - KPB-07524-ALPHA.A0 - phyboard-lyra-am62axx-1 - PCM-075.A0 + PBA-C-24.A3 **(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-am62axx-2 - phytec-qt6demo-image - ampliphy - Qt6 image with PHYTEC's ampliPHY distribution for the |local-default-kit| kit. * - phyboard-lyra-am62axx-2 - 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-am62axx-2 - phytec-headless-image - ampliphy - Headless image with PHYTEC's ampliPHY distribution for the |local-default-kit| kit. * - phyboard-lyra-am62axx-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-lyra-am62axx-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-lyra-am62axx-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-lyra-am62axx-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-lyra-am62axx-1 - phytec-qt6demo-image - ampliphy - Qt6 image with PHYTEC's ampliPHY distribution for the KPB-07524-ALPHA.A0 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: 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-am62a7-phyboard-lyra-rdk.dts * - - Processor .dtsi - This file adds general support for the AM625x Processor from Texas Instruments - k3-am62a7.dtsi * - - SOM .dtsi- This file adds support for your specific SOM's population options - k3-am62a-phycore-som.dtsi * - - MIPI Camera Overlay - k3-am62-phyboard-lyra-vm016-mipi.dts * - - SPI0 Overlay - k3-am62-phyboard-lyra-x17-spi0.dts * - - GPIO Fan Overlay - k3-am62-phyboard-lyra-gpio-fan.dts * - - Disable OSPI NOR Overlay - k3-am6-phycore-disable-spi-nor.dts * - - Disable RTC Overlay - k3-am6-phycore-disable-rtc.dts * - - Disable SOM Ethernet PHY Overlay - k3-am6-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 50 :header-rows: 1 * - Boot Source - Status - Notes * - SD-Card - **Supported** - * - eMMC - **Supported** - * - QSPI/OSPI-Nor Flash - **Supported** - * - Ethernet - **Supported** - Eth0 (X7) * - USB/DFU - **Supported** - USB-C (X34) * - 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 - AM62A74 - **Supported** - * - - AM62A72 - Unsupported - * - - AM62A34 - Unsupported - * - - AM62A32 - Unsupported - * - - AM62A31 - Unsupported - * - DDR4 - 512 MB - Unsupported - * - - 1 GB - Unsupported - * - - 2 GB - **Supported** - * - - 4 GB - Unsupported - * - eMMC - - **Supported** - * - SPI-NOR Flash - OSPI - **Supported** - * - - QSPI - **Supported** - * - Power Management - PMIC - **Supported** - * - - Suspend to RAM - Unsupported - * - - MCU Only Low Power Mode - Unsupported - * - - A53 1.4 GHz Frequency - Unsupported - * - Watchdog - - **Supported** - * - C7x DSP - - **Supported** - * - JPEG Encoder - H.264 - **Supported** - * - JPEG Encoder - H.265 - **Supported** - * - SD-Card - - **Supported** - * - RTC - - **Supported** - * - GPIO - - **Supported** - * - UART - - **Supported** - * - I2C - - **Supported** - * - SPI - - **Supported** - * - ePWM - - Untested - * - eQEP - - Untested - * - CAN - - **Supported** - * - - CAN FD - **Supported** - * - McASP - Play - **Supported** - * - - Record - **Supported** - * - USB 2.0 - - **Supported** - * - USB-C - Data Transport - **Supported** - * - USB-C - Power Delivery - Unsupported - * - Ethernet - - **Supported** - * - - TSN Support - **Supported** - * - MIPI-CSI - VM-016 - **Supported** - * - HDMI - Video - **Supported** - * - - Audio - Unsupported - * - WiFi - - **Supported** - * - Bluetooth - - **Supported** - * - Security - Secure Boot - Unsupported - * - - Secure Key Storage - Unsupported - * - - TEE - **Supported** - * - - Cryptographic Acceleration - **Supported** - * - MCU - GPIO - **Supported** - * - - SPI - Untested - * - - UART - Untested - * - - CAN - Untested - * - - I2C - Untested - * - Qt5 - - **Supported** - * - Qt6 - - Unsupported - * - Virtualization - Podman - **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 * - OSPI - ospi0 - **supported** - NOR Serial Flash on SOM * - 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 - **Supported** - 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 .. note:: For technical support, please visit `PHYTEC's Support Portal `_!