BSP-Yocto-Ampliphy-AM62x-PD24.1.0

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

Board Support Package Status

BSP Operating system

Linux

Release Status

RELEASED

Release Date

2024-09-27

Repository

PHYTEC Public Repos

Binaries

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

  • R5F as General-Purpose Core: New support for R5F cores being usable as general-purpose processors along with DM firmware.

  • Low-Power Mode Overlay: A new device tree overlay to manage low-power operations.

  • PEB-X-005 Overlay: Device-tree overlay support for a new expansion board related to EVSE (Electric Vehicle Supply Equipment) communication.

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.

  • M4F Firmware Restart: Fixed issues with restarting the M4F firmware.

  • Bootloader via Ethernet: Booting the bootloader through Ethernet is now functional.

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.

  • 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.

  • Display Issues: The PHYTEC AC200 and AC209a display overlays are broken and the displays will not function.

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.

  1. Select the I2C bus device 0:

uboot:~# i2c dev 0
  1. Read the current voltage setting from register 0A on the PMIC:

uboot:~# i2c md 30 0A 1
  1. Write the new voltage setting (0.85V) to the register:

uboot:~# i2c mw 30 0A 8A
  1. Set the necessary voltage steps in registers 34:

uboot:~# i2c mw 30 34 0A
uboot:~# i2c mw 30 34 07
  1. 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.0 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-phy2)

PHYTEC Linux kernel repository

U-Boot Bootloader

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

PHYTEC U-Boot bootloader repository

Yocto

5.0.3 Scarthgap (tag: BSP-Yocto-Ampliphy-AM62x-PD24.1.0)

PHYTEC Meta Layer repository

Part Number Summary

Hardware 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

Kit Summary

Part Number

Yocto MACHINE

Hardware Description

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.

Supported Build Summary

Yocto MACHINE

Yocto Image

Yocto Distro

Description

phyboard-lyra-am62xx-3

phytec-qt6demo-image

ampliphy-xwayland

Qt6 image with PHYTEC’s ampliPHY Xwayland distribution for the KPB-07124-002.A0 kit.

phyboard-lyra-am62xx-3

phytec-qt6demo-image -c populated_sdk

ampliphy-xwayland

Qt6 image with PHYTEC’s ampliPHY Xwayland distribution for the KPB-07124-002.A0 kit. This build includes a SDK.

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-xwayland

Qt6 image with PHYTEC’s ampliPHY Xwayland 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.

Linux Device Tree Summary

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

Hardware Feature Summary

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

Unsupported

Secure Key Storage

Unsupported

TEE

Supported

Cryptographic Acceleration

Supported

MCU

GPIO

Supported

SPI

Untested

UART

Untested

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 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

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!