BSP-Yocto-Ampliphy-AM62x-PD23.2.0 ================================= .. include:: ../substitutions.rst .. substitutions .. |local-release-name| replace:: BSP-Yocto-Ampliphy-AM62x-PD23.2.0 .. |local-ti-sdk-version| replace:: v09.00.00.007 .. |local-kernel-version| replace:: v6.1.33 .. |local-kernel-tag| replace:: v6.1.33-phy3 .. |local-kernel-repo| replace:: `PHYTEC Linux kernel repository `__ .. |local-uboot-version| replace:: v2023.04 .. |local-uboot-tag| replace:: v2023.04_09.00.00.007-phy4 .. |local-uboot-repo| replace:: `PHYTEC U-Boot bootloader repository `__ .. |local-yocto-version| replace:: 4.0.12 Kirkstone .. |local-yocto-tag| replace:: BSP-Yocto-Ampliphy-AM62x-PD23.2.0 .. |local-yocto-repo| replace:: `PHYTEC Meta Layer repository `__ .. |local-default-kit| replace:: KPB-07124-002.A0 .. |vendor-fork| replace:: v09.00.00.007 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 - 2023-09-29 * - Repository - `PHYTEC Public Repos `_ * - Binaries - `BSP-Yocto-Ampliphy-AM62x-PD23.2.0 `_ New in this Release ------------------- **Yocto** * MACHINE=phyboard-lyra-am62xx-3 for TI's High Security-Field Securable (HS-FS) SoCs. * HS-FS variant phyCORE-AM62x SOMs are now the default SOM configuration shipping in Development kits. * UART boot source now available. * Inline ECC support is now available but not enabled by default. * Switched graphics support to Xwayland. * Virtualization support with Podman/Docker **Linux Kernel** * TSN support for Ethernet. * Switched M.2 WiFi/Bluetooth module to Laird LWB5+ * Bluetooth support. * Default ALSA config to play and record audio with the phyBOARD-Lyra carrier-board. * LVDS and HDMI can now be used at the same time. * New device tree overlay references for disabling optional population options of the SOM. * RPMSG reserved memory regions enabled by default (previously enabled by device tree overlay) **U-Boot Bootloader** * EEPROM Hardware introspection enabled for identifying Ethernet PHY, SPI-NOR Flash, and RTC population options * USB Host support 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: |local-yocto-tag|) - |local-yocto-repo| PHYTEC Meta Layer ----------------- This BSP release supports various configurations of the |product| SOM and Development Kit, here is a summary of the Yocto MACHINE configuration support included in the PHYTEC Meta Layer for this release: .. list-table:: Yocto MACHINE Summary :widths: 20 20 20 20 20 20 20 20 :header-rows: 1 * - Yocto MACHINE - Default Target Image - Linux Distro - Kit Part Number - Compatible Modules - U-Boot defconfig - Linux defconfig - Device Tree Files * - phyboard-lyra-am62xx-3 **(Default Kit - HS-FS Soc Variant)** - phytec-qt5demo-image - PHYTEC Ampliphy Reference Distribution - KPB-07124-002.A0 - **SOM\:** |br| |default-som| |br| **Carrier Board\:** |br| |default-cb| - **u-boot.img\:** |br| phycore_am62x_a53_defconfig |br| **SPL\:** |br| phycore_am62x_r5_defconfig - phytec_ti_defconfig |br| phytec_ti_platform.config - **Default Device Tree\:** |br| k3-am625-phyboard-lyra-rdk.dtb |br| **Overlays\:** |br| k3-am62-phyboard-lyra-m2-lwb5p.dtbo |br| k3-am62-phyboard-lyra-oldi-lcd185.dtbo |br| k3-am62-phyboard-lyra-vm016-mipi.dtbo |br| k3-am62-phyboard-lyra-x17-spi0.dtbo |br| k3-am62-phyboard-lyra-gpio-fan.dtbo |br| k3-am6-phycore-disable-spi-nor.dtbo |br| k3-am6-phycore-disable-rtc.dtbo |br| k3-am6-phycore-disable-eth-phy.dtbo * - phyboard-lyra-am62xx-2 **(Deprecated - GP Soc Variant)** - phytec-qt5demo-image - PHYTEC Ampliphy Reference Distribution - KPB-07124-001.A1 - **SOM\:** |br| PCM-071.A1 |br| **Carrier Board\:** |br| PBA-C-24.A3 - **u-boot.img\:** |br| phycore_am62x_a53_defconfig |br| **SPL\:** |br| phycore_am62x_r5_defconfig - phytec_ti_defconfig |br| phytec_ti_platform.config - **Default Device Tree\:** |br| k3-am625-phyboard-lyra-rdk.dtb |br| **Overlays\:** |br| k3-am62-phyboard-lyra-m2-lwb5p.dtbo |br| k3-am62-phyboard-lyra-oldi-lcd185.dtbo |br| k3-am62-phyboard-lyra-vm016-mipi.dtbo |br| k3-am62-phyboard-lyra-x17-spi0.dtbo |br| k3-am62-phyboard-lyra-gpio-fan.dtbo |br| k3-am6-phycore-disable-spi-nor.dtbo |br| k3-am6-phycore-disable-rtc.dtbo |br| k3-am6-phycore-disable-eth-phy.dtbo * - phyboard-lyra-am62xx-1 **(Deprecated - GP Soc Variant)** - phytec-qt5demo-image - PHYTEC Ampliphy Reference Distribution - KPB-07124-ALPHA.A1 - **SOM\:** |br| PCM-071.A0 |br| **Carrier Board\:** |br| PBA-C-24.A1 - **u-boot.img\:** |br| phycore_am62x_a53_defconfig |br| **SPL\:** |br| phycore_am62x_r5_defconfig - phytec_ti_defconfig |br| phytec_ti_platform.config - **Default Device Tree\:** |br| k3-am625-phyboard-lyra-deprecated-rev0-som.dtb |br| **Overlays\:** |br| k3-am62-phyboard-lyra-m2-lwb5p.dtbo |br| k3-am62-phyboard-lyra-oldi-lcd185.dtbo |br| k3-am62-phyboard-lyra-vm016-mipi.dtbo |br| k3-am62-phyboard-lyra-x17-spi0.dtbo |br| k3-am62-phyboard-lyra-gpio-fan.dtbo |br| k3-am6-phycore-disable-spi-nor.dtbo |br| k3-am6-phycore-disable-rtc.dtbo |br| k3-am6-phycore-disable-eth-phy.dtbo Part Number Summary ------------------- .. list-table:: Hardware Summary :widths: 50 50 50 50 :header-rows: 1 * - Part Number - Hardware Description - Configuration Details (DDR4 / eMMC / NOR / Ethernet PHY / Temperature) - PCB Version * - PCM-071-5432DE11I.A0 - |product| SOM (HS-FS silicon) - 2GB / 32GB eMMC / 64MB OSPI NOR / Yes / Industrial - 1573.2 * - PCM-071.A1 - |product| SOM (GP silicon) - 2GB / 16GB eMMC / 64MB OSPI NOR / Yes / Industrial - 1573.1 * - PCM-071.A0 - |product| SOM (GP silicon - No PMIC) - 2GB / 16GB eMMC / 64MB OSPI NOR / Yes / Industrial - 1573.0 * - PBA-C-24.A3 - phyCORE-AM62x Carrier Board - - 1576.3 * - |local-default-kit| **(Default Kit)** - PCM-071-5432DE11I.A0 + PBA-C-24.A3 - - * - KPB-07124-001.A1 - PCM-071.A1 + PBA-C-24.A3 **(Deprecated)** - - * - KPB-07124-ALPHA.A1 - PCM-071.A0 + PBA-C-24.A1 **(Deprecated)** - - Compatible Modules and Accessories ---------------------------------- .. list-table:: Compatible Add-Ons :widths: 50 50 50 50 :header-rows: 1 * - Module Name - Part Number - Description - Link * - M.2 WIFI Module - 453-00048 - Sterling-LWB5+ M.2 Module - https://www.digikey.com/en/products/detail/laird-connectivity-inc/453-00048/13240570 * - OLDI Display Module - LCDK185-101CTL1ARNTTR1.0 - 10.1" Lincoln Tech. LCD Display with Adapter for TI - https://www.digikey.com/en/products/detail/lincoln-technology-solutions/LCDK185-101CTL1ARNTTR1-0/20485318?s=N4IgTCBcDaIDIGEAiBpAjADgKwgLoF8g * - MIPI Camera Module - VM-016-COL-M-M12.A1 - PHYTEC MIPI-CSI Camera Module - https://www.phytec.eu/en/produkte/embedded-imaging/kameramodule/vm-016-phycam-m/ 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 * - |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-lwb5p.dts * - - OLDI Display Overlay - k3-am62-phyboard-lyra-oldi-lcd185.dts * - - 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 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 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 25 25 25 25 50 :header-rows: 1 * - Interface - Detail - Implemented - Tested - Status in Device tree - Notes * - UART - uart0 - Yes - Yes - Okay - Default serial console |br| - Connected to UART-to-USB FTDI IC * - - uart1 - Yes - - Okay - UART1 may be used by TIFS firmware * - I2C - i2c0 - Yes - Yes - Okay - * - - i2c1 - Yes - Yes - Okay - * - Ethernet - eth0 (cpsw ethernet) - Yes - Yes - Okay - DP83867IRRGZ SOM PHY * - - eth1 (cpsw ethernet) - Yes - Yes - Okay - DP83867IRRGZ CB PHY * - eMMC/SD/SDIO - mmc0 - Yes - Yes - Okay - eMMC Flash Memory on the SOM * - - mmc1 - Yes - Yes - Okay - SD Card Slot on Dev Kit Carrier Board * - USB - usb0 - Yes - Yes - Okay - Connected to USB C port X34 * - - usb1 - Yes - Yes - Okay - Connected to USB 2.0 HUB * - CAN - mcan0 - Yes - Yes - Okay - * - SPI - spi0 - Yes - - - Enabled with spidev driver via Device Tree Overlay * - OSPI - ospi0 - Yes - Yes - Okay - NOR Serial Flash on SOM * - OLDI LVDS Display - vout0 - Yes - Yes - - Enabled via Device Tree Overlay * - HDMI - hdmi - Yes - Yes - Okay - Enabled by Default * - GPIO - User LEDs - Yes - Yes - Okay - User LEDs populated on SOM and Carrier Board * - - User Buttons - Yes - Yes - Okay - * - - General Purpose I/O - - - - GPIOs can be configured "on the fly" |br| - See Blink and GPIO Peripheral Interface Guides * - Memory - SOM EEPROM - Yes - Yes - Okay - M24C32 on i2c0 |br| - Used for Hardware Introspection * - - Carrier Board EEPROM - Yes - - Okay - M24C02 on i2c1 * - - OSPI NOR Flash - Yes - Yes - Okay - MT35XU512ABA * - RTC - SOM RTC - Yes - Yes - Okay - RV-3028-C7 on I2C0 .. note:: For technical support, please visit `PHYTEC's Support Portal `_!