BSP-Yocto-Ampliphy-AM62x-PD23.2.1

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

Board Support Package Status

BSP Operating system

Linux

Release Status

RELEASED

Release Date

2024-03-29

Repository

PHYTEC Public Repos

Binaries

BSP-Yocto-Ampliphy-AM62x-PD23.2.1

New in this Release

Yocto

  • Drops support for phyboard-lyra-am62xx-1 (PCM-071.A0 SOMs with no PMIC)

  • Adds support for partup to easily flash the eMMC.

  • Integrates a blinky demo for the M4F Co-processor based on TI’s MCU+ SDK.

    • Documentation explains how to build and deploy a custom firmware.

  • New Yocto image phytec-initramfs-image to flash and boot a tiny initramfs-based Linux from the OSPI NOR Flash.

  • New Yocto distro ampliphy-rt which enables Linux with PREEMPT_RT patches.

  • New Yocto distro ampliphy-rauc for A/B system updates based on RAUC.

  • Adds watchdog support by switching to Poky’s watchdog.

Linux Kernel

  • Adds 1.4 GHz Operating Performance Point (OPP).

  • Watchdog is now enabled by default.

  • New overlay for AC200 OLDI Glyn display.

  • New overlay for AC209 OLDI Powertip display.

  • Reduces the I2C bus frequency, which is routed to the Carrier-board, from 400 to 100 kHz.

U-Boot Bootloader

  • More Boot Sources available

    • Boot via Ethernet (Eth0)

    • Load and run U-Boot via UART (X49)

    • Support for loading U-Boot over USB with Snagboot

  • Additional SOM options supported

    • QSPI as alternative for OSPI NOR Flashes

    • 1 GB DDR

    • 4 GB DDR

  • Supports standard boot, offering integrated booting for various OSs and devices, including EFI boot and EFI bootmgr.

Issues Fixed

  • Read/write performance on the USB-C connector can drop sometimes.

Known Issues

  • Linux RT worst-case latency can go up to 500us under heavy memory load.

  • The flashcp command occasionally fails during the verification step.

  • Weston fails to start when HDMI and LVDS are used during boot.

Software Versioning

The BSP-Yocto-Ampliphy-AM62x-PD23.2.1 software release is largely based off of Texas Instruments’s v09.02.00.005 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.1.69-09.02.00.005 (tag: v6.1.69-09.02.00.005-phy3)

PHYTEC Linux kernel repository

U-Boot Bootloader

v2023.04 (tag: v2023.04-09.02.00.005-phy2)

PHYTEC U-Boot bootloader repository

Yocto

4.0.16 Kirkstone (tag: BSP-Yocto-Ampliphy-AM62x-PD23.2.1)

PHYTEC Meta Layer repository

Part Number Summary

Hardware Summary

Part Number

Hardware Description

Configuration Details (DDR4 / eMMC / NOR / Ethernet PHY / Temperature)

PCB Version

PCM-071-5432DE11I.A0

phyCORE-AM62x SOM (HS-FS silicon)

2GB / 32GB eMMC / 64MB OSPI NOR / Yes / Industrial

1573.2

PCM-071-3231BX11I.A0

phyCORE-AM62x SOM (HS-FS silicon)

1GB / 8GB eMMC / no NOR / Yes / Industrial

1573.2

PCM-071.A1

phyCORE-AM62x SOM (GP silicon)

2GB / 16GB eMMC / 64MB OSPI NOR / 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-qt5demo-image

ampliphy-xwayland

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

phyboard-lyra-am62xx-3

phytec-qt5demo-image -c populated_sdk

ampliphy-xwayland

Qt5 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-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-qt5demo-image

ampliphy-xwayland

Qt5 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

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

Unsupported

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

Untested

MCU

GPIO

Supported

SPI

Untested

UART

Untested

CAN

Untested

I2C

Untested

PRU Subsystem

Ethercat

Untested

Profibus

Untested

GPIO

Untested

UART

Untested

I2C

Untested

Qt5

Supported

Qt6

Unsupported

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!