BSP-Yocto-Ampliphy-AM62Ax-PD24.1.1

This document highlights the key features and support included in the BSP-Yocto-Ampliphy-AM62Ax-PD24.1.1 software release for the phyCORE-AM62Ax SOM and development kit.

Board Support Package Status

BSP Operating system

Linux

Release Status

RELEASED

Release Date

2024-12-20

Repository

PHYTEC Public Repos

Binaries

BSP-Yocto-Ampliphy-AM62Ax-PD24.1.1

New in this Release

Yocto

  • Xwayland: XWayland is now integrated by default into the ampliphy distribution. As a result, the ampliphy-xwayland distribution has been consolidated into ampliphy.

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.

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.

Software Versioning

The BSP-Yocto-Ampliphy-AM62Ax-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.

Software Versioning

Tested Build Environment

Ubuntu 20.04

Ubuntu 20.04 Release Downloads

Linux Kernel

v6.6.32-10.00.08 (tag: v6.6.32-10.00.08-phy3)

PHYTEC Linux kernel repository

U-Boot Bootloader

v2024.04 (tag: v2024.04-10.00.08-phy5)

PHYTEC U-Boot bootloader repository

Yocto

5.0.5 Scarthgap (tag: BSP-Yocto-Ampliphy-AM62Ax-PD24.1.1)

PHYTEC Meta Layer repository

Part Number Summary

Hardware Summary

Part Number

Hardware Description

Configuration Details (SOC / Features / DDR4 / eMMC / NOR / Ethernet PHY / RTC / Temperature)

PCB Version

PCL-075.A1

phyCORE-AM62Ax SOM (HS-FS silicon)

AM62A74 / JPEG Encoder + OPP High-Speed / 2GB / 32GB eMMC / 64MB OSPI NOR / Yes / Yes / Industrial

1598.1

PCM-075.A0

phyCORE-AM62Ax 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
Kit Summary

Part Number

Yocto MACHINE

Hardware Description

KPB-07524-ALPHA.A1

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.

Supported Build Summary

Yocto MACHINE

Yocto Image

Yocto Distro

Description

phyboard-lyra-am62axx-2

phytec-qt6demo-image

ampliphy

Qt6 image with PHYTEC’s ampliPHY distribution for the KPB-07524-ALPHA.A1 kit.

phyboard-lyra-am62axx-2

phytec-qt6demo-image -c populated_sdk

ampliphy

Qt6 image with PHYTEC’s ampliPHY distribution for the KPB-07524-ALPHA.A1 kit. This build includes a SDK.

phyboard-lyra-am62axx-2

phytec-headless-image

ampliphy

Headless image with PHYTEC’s ampliPHY distribution for the KPB-07524-ALPHA.A1 kit.

phyboard-lyra-am62axx-2

phytec-headless-image

ampliphy-rauc

Headless image with PHYTEC’s ampliPHY RAUC distribution for the KPB-07524-ALPHA.A1 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 KPB-07524-ALPHA.A1 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 KPB-07524-ALPHA.A1 kit. Enables to the Linux RT branch.

phyboard-lyra-am62axx-2

phytec-initramfs-image

ampliphy

initramfs image with PHYTEC’s ampliPHY distribution for the KPB-07524-ALPHA.A1 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.

Linux Device Tree Summary

Hardware Target

Device Tree File Descriptions

Filename

KPB-07524-ALPHA.A1 (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-am62x-phyboard-lyra-gpio-fan.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-AM62Ax 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-AM62Ax allows to load a bootloader from different kind of sources.

Boot Source Summary

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-AM62Ax features.

Hardware Feature Summary

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

Supported

CAN

Untested

I2C

Untested

Qt5

Unsupported

Qt6

Supported

Virtualization

Podman

Supported

Interface Overview

The following table contains all interfaces connected to the phyCORE-AM62Ax’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 Overview

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!