BSP-Yocto-Ampliphy-AM62x-PD24.1.1
This document highlights the key features and support included in the BSP-Yocto-Ampliphy-AM62x-PD24.1.1 software release for the phyCORE-AM62x SOM and development kit.
BSP Operating system |
Linux |
|---|---|
Release Status |
PLANNED |
Release Date |
2024-12-19 |
Repository |
|
Binaries |
New in this Release
Yocto
Secure Boot: Secure Boot is now officially supported. A new machine, phyboard-lyra-am62xx-4, has been introduced to automatically sign all bootloader images for Secure Boot enforced devices. All images supported by phyboard-lyra-am62xx-3 are compatible with this new machine. Additionally, the phytec-securiphy-image is now available with the securiphy distribution, providing a full chain-of-trust Secure Boot implementation from BOOTROM to Linux. This distribution also enables additional security features.
Xwayland: XWayland is now integrated by default into the ampliphy distribution. As a result, the ampliphy-xwayland distribution has been consolidated into ampliphy.
Linux Mainline: A new distribution, ampliphy-linux-mainline, has been added. This distribution selects the latest Linux mainline kernel, allowing users to experience the most recent Linux version on the phyCORE-AM62x.
Linux Kernel
U-Boot Bootloader
Remoteproc:The remoteproc interface is now enabled in U-Boot. This allows co-processors to be started and firmware to be loaded directly from U-Boot. Additionally, Code Composer Studio can now be used with U-Boot insead of Linux to debug firmware via JTAG.
Issues Fixed
Partup Layout Configuration: Corrected a faulty layout configuration in Partup packages built with the ampliphy-rauc distro. The filesystem type for the config and app partitions is now properly set to ext4, ensuring functionality and compatibility.
GPIO Sysfs: The missing GPIO directory in the Linux sysfs has been restored.
LEDs: LED functionality has been resolved and is now operational.
Fan Hysteresis: The GPIO fan hysteresis issue has been fixed. Hysteresis is now enabled, preventing the fan from toggling on and off continuously.
Display Overlays: Resolved issues with the PHYTEC AC200 and AC209a display overlays. Both overlays now function correctly, restoring full display capabilities.
Ethernet Boot (1GB DDR): Resolved an issue preventing Ethernet boot on the phyCORE-AM62x SOM with the 1GB DDR option. Boot functionality is now fully operational.
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.
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.
Updated PMIC Enables 1.4 GHz Performance
The AM62x A53 supports multiple Operating Performance Points (OPP) to optimize between energy efficiency and maximum performance. Since different CPU frequencies require different core voltages, Linux can adjust the PMIC output accordingly.
The PMIC originally installed on the phyCORE-AM62x provides a default voltage of 0.75V. However, PHYTEC has updated the PMIC to supply 0.85V, which is essential for operating at 1.4 GHz.
With this updated PMIC supporting the 1.4 GHz OPP, we have enabled it by default in our BSP. For SOMs equipped with the older PMIC version, the VDD_CORE output rail voltage must be adjusted. The following U-Boot commands can be used to modify the voltage, though this change is not permanent and can be reverted.
Select the I2C bus device 0:
uboot:~# i2c dev 0
Read the current voltage setting from register 0A on the PMIC:
uboot:~# i2c md 30 0A 1
Write the new voltage setting (0.85V) to the register:
uboot:~# i2c mw 30 0A 8A
Set the necessary voltage steps in registers 34:
uboot:~# i2c mw 30 34 0A
uboot:~# i2c mw 30 34 07
Verify the new voltage setting:
uboot:~# i2c md 30 0A 1
Note
PHYTEC customers will receive a Product Change Notification (PCN) regarding this update. If you haven’t received yours, please reach out to us.
Software Versioning
The BSP-Yocto-Ampliphy-AM62x-PD24.1.1 software release is largely based off of Texas Instruments’s v10.00.08 Processor SDK Linux release and shares much of the same components and features.
Tested Build Environment |
Ubuntu 20.04 |
|
|---|---|---|
Linux Kernel |
v6.6.32-10.00.08 (tag: v6.6.32-10.00.08-phy3) |
|
U-Boot Bootloader |
v2024.04 (tag: v2024.04-10.00.08-phy5) |
|
Yocto |
5.0.5 Scarthgap (tag: BSP-Yocto-Ampliphy-AM62x-PD24.1.1) |
Part Number Summary
Part Number |
Hardware Description |
Configuration Details (SOC / PRU / DDR4 / eMMC / NOR / Ethernet PHY / RTC / Temperature) |
PCB Version |
|---|---|---|---|
PCM-071-5432DE11I.A0 |
phyCORE-AM62x SOM (HS-FS silicon) |
AM6254 / 2 PRUs + OPP High-Speed / 2GB / 32GB eMMC / 64MB OSPI NOR / Yes / Yes / Industrial |
1573.2 |
PCM-071-3231BX11I.A0 |
phyCORE-AM62x SOM (HS-FS silicon) |
AM6232 / 2 PRUs + OPP High-Speed / 1GB / 8GB eMMC / no NOR / Yes / Yes / Industrial |
1573.2 |
PCM-071.A1 |
phyCORE-AM62x SOM (GP silicon) |
AM6254 / 2 PRUs + OPP High-Speed / 2GB / 32GB eMMC / 64MB OSPI NOR / Yes / Yes / Industrial |
1573.1 |
PBA-C-24.A3 |
phyBOARD-Lyra AM62x (phyCORE-AM62x Carrier Board) |
1576.3 |
Part Number |
Yocto MACHINE |
Hardware Description |
|---|---|---|
KPB-07124-002.A0 |
phyboard-lyra-am62xx-4 |
PCM-071-5432DE11I.A0 + PBA-C-24.A3 / Secure Boot enforced with certificates burned into the device. |
KPB-07124-002.A0 |
phyboard-lyra-am62xx-3 |
PCM-071-5432DE11I.A0 + PBA-C-24.A3 (Default Kit) |
KPB-07124-001.A1 |
phyboard-lyra-am62xx-2 |
PCM-071.A1 + 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.
Yocto MACHINE |
Yocto Image |
Yocto Distro |
Description |
|---|---|---|---|
phyboard-lyra-am62xx-4 |
phytec-headless-image |
ampliphy |
Headless image with PHYTEC’s ampliPHY distribution for the KPB-07124-002.A0 kit. |
phyboard-lyra-am62xx-4 |
phytec-securiphy-image |
securiphy |
Securiphy image with PHYTEC’s securiPHY distribution for the KPB-07124-002.A0 kit. This distro has Secure Boot activated and includes further security improvements. |
phyboard-lyra-am62xx-4 |
phytec-securiphy-bundle |
securiphy |
Securiphy bundle with PHYTEC’s securiPHY distribution for the KPB-07124-002.A0 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 KPB-07124-002.A0 kit. |
phyboard-lyra-am62xx-3 |
phytec-qt6demo-image -c populated_sdk |
ampliphy |
Qt6 image with PHYTEC’s ampliPHY distribution for the KPB-07124-002.A0 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 KPB-07124-002.A0 kit. This build uses the latest Linux mainline tag, offering an experience consistent with the upstream version. |
phyboard-lyra-am62xx-3 |
phytec-headless-image |
ampliphy-rauc |
Headless image with PHYTEC’s ampliPHY RAUC distribution for the KPB-07124-002.A0 kit. Enables RAUC and includes a partup image for updates. |
phyboard-lyra-am62xx-3 |
phytec-headless-bundle |
ampliphy-rauc |
Headless bundle with PHYTEC’s ampliPHY RAUC distribution for the KPB-07124-002.A0 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 KPB-07124-002.A0 kit. Enables to the Linux RT branch. |
phyboard-lyra-am62xx-3 |
phytec-initramfs-image |
ampliphy |
initramfs image with PHYTEC’s ampliPHY distribution for the KPB-07124-002.A0 kit. Contains an initramfs to boot Linux from OSPI. |
phyboard-lyra-am62xx-3 |
phytec-headless-image |
ampliphy |
Headless image with PHYTEC’s ampliPHY distribution for the KPB-07124-002.A0 kit. |
phyboard-lyra-am62xx-2 |
phytec-qt6demo-image |
ampliphy |
Qt6 image with PHYTEC’s ampliPHY distribution for the KPB-07124-001.A1 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.
Hardware Target |
Device Tree File Descriptions |
Filename |
|---|---|---|
KPB-07124-002.A0 (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 |
|
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 phyCORE-AM62x 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 phyCORE-AM62x allows to load a bootloader from different kind of sources.
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 phyCORE-AM62x features.
Feature |
Sub-Feature |
Status |
Notes |
|---|---|---|---|
SoC |
AM6254 |
Supported |
|
AM6252 |
Supported |
||
AM6251 |
Supported |
||
AM6234 |
Supported |
||
AM6232 |
Supported |
||
AM6231 |
Supported |
||
AM6204 |
Unsupported |
||
AM6202 |
Unsupported |
||
AM6201 |
Unsupported |
||
DDR4 |
512 MB |
Unsupported |
|
1 GB |
Supported |
||
2 GB |
Supported |
||
4 GB |
Supported |
||
Inline ECC |
Supported |
Disabled by default. |
|
eMMC |
Supported |
||
SPI-NOR Flash |
OSPI |
Supported |
|
QSPI |
Supported |
||
Power Management |
PMIC |
Supported |
|
Suspend to RAM |
Supported |
Requires the lpm overlay. |
|
MCU Only Low Power Mode |
Unsupported |
||
A53 1.4 GHz Frequency |
Supported |
||
Watchdog |
Supported |
||
GPU |
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 |
|
Power Delivery |
Unsupported |
||
Ethernet |
Supported |
||
TSN Support |
Supported |
||
MIPI-CSI |
VM-016 |
Supported |
|
OLID/LVDS |
Supported |
||
HDMI |
Video |
Supported |
|
Audio |
Unsupported |
||
WiFi |
Supported |
||
Bluetooth |
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 |
||
Qt5 |
Unsupported |
||
Qt6 |
Supported |
||
Virtualization |
Podman |
Supported |
Interface Overview
The following table contains all interfaces connected to the phyCORE-AM62x’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.
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 |
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!