BSP-Yocto-Ampliphy-AM64x-PD24.1.0

This document highlights the key features and support included in the BSP-Yocto-Ampliphy-AM64x-PD24.1.0 software release for the phyCORE-AM64x 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-AM64x-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.

  • Kernel Recipe: Kernel metadata handling with .scc (Source Code Control) files, integrating Poky’s kernel recipe handling features.

  • Default Machine: phytec-container-image is now the default image for the phyCORE-AM64x.

Linux Kernel

  • Kernel Update: Update to Linux v6.6.

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.

  • Additional SOM Option: New support for a SOM option with 1GB DDR.

Issues Fixed

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

  • Trickle Charger: Enabled Trickle Charger to charge the external battery.

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.

  • Remoteproc Driver: The remoteproc driver might hang when re-starting an R5F core.

Software Versioning

The BSP-Yocto-Ampliphy-AM64x-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-AM64x-PD24.1.0)

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

PCM-072-42F2DE11I.A0

phyCORE-AM64x SOM (HS-FS silicon)

AM6442 / Features F / 2GB / 32GB eMMC / 64MB OSPI NOR / Yes / Yes / Industrial

1565.1

PCM-072-42F2DE01I.A0

phyCORE-AM64x SOM (HS-FS silicon)

AM6442 / Features F / 2GB / 32GB eMMC / 64MB OSPI NOR / No / Yes / Industrial

1565.1

PCM-072-42F2BX11I.A0

phyCORE-AM64x SOM (HS-FS silicon)

AM6442 / Features F / 2GB / 8GB eMMC / no NOR / Yes / Yes / Industrial

1565.1

PCM-072.A2

phyCORE-AM64x SOM (HS-FS silicon)

AM6442 / Features F / 2GB / 32GB eMMC / 64MB OSPI NOR / Yes / Yes / Industrial

1565.1

PCM-072.A1

phyCORE-AM64x SOM (GP silicon)

AM6442 / Features F / 2GB / 32GB eMMC / 64MB OSPI NOR / Yes / Yes / Industrial

1565.1

PBA-C-25.A1

phyCORE-AM64x Carrier Board

1566.1
Kit Summary

Part Number

Yocto MACHINE

Hardware Description

KPB-07124-002.A0

phyboard-electra-am64xx-2

PCM-072-42F2DE11I.A0 + PBA-C-25.A1 (Default Kit)

KPB-07225-001.A0

phyboard-electra-am64xx-1

PCM-072.A2 + PBA-C-25.A1 (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-electra-am64xx-2

phytec-headless-image

ampliphy

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

phyboard-electra-am64xx-2

phytec-headless-image -c populated_sdk

ampliphy

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

phyboard-electra-am64xx-2

phytec-container-image

ampliphy

Container image with PHYTEC’s ampliPHY distribution for the KPB-07124-002.A0 kit. This build includes virtualization.

phyboard-electra-am64xx-2

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-electra-am64xx-2

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-electra-am64xx-2

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-electra-am64xx-2

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-electra-am64xx-1

phytec-headless-image

ampliphy

Headless image with PHYTEC’s ampliPHY distribution for the KPB-07124-002.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-07124-002.A0 (Default Kit)

Default Device Tree (includes the other .dtsi files below)

k3-am642-phyboard-electra-rdk.dts

Processor .dtsi - This file adds general support for the AM642x Processor from Texas Instruments

k3-am642.dtsi

SOM .dtsi- This file adds support for your specific SOM’s population options

k3-am64-phycore-som.dtsi

PCIe Overlay

k3-am642-phyboard-electra-pcie-usb2.dtbo

GPIO Fan Overlay

k3-am642-phyboard-electra-gpio-fan.dts

SPI1 and UART3 Overlay

k3-am64-phyboard-electra-x27-uart3-spi1.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-AM64x 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-AM64x 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

Unsupported

USB/DFU

Unsupported

phyBOARD-Electra has a USB Hub connected to the USB interface.

UART

Supported

Debug UART (X49) - Can’t boot Linux via UART.

Supported Features

The following table contains all supported phyCORE-AM64x features.

Hardware Feature Summary

Feature

Sub-Feature

Status

Notes

SoC

AM6442

Supported

AM6441

Untested

AM6422

Untested

AM6421

Untested

AM6412

Untested

AM6411

Untested

AM243x

Unsupported

DDR4

512 MB

Unsupported

1 GB

Supported

2 GB

Supported

Inline ECC

Supported

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

SD-Card

Supported

RTC

Supported

GPIO

Supported

UART

Supported

I2C

Supported

SPI

Supported

ePWM

Untested

eQEP

Untested

ADC

Supported

CAN

Supported

CAN FD

Supported

USB 2.0

Supported

USB 3.0

Supported

Ethernet

Supported

TSN Support

Supported

PCIe

Supported

TPM

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

Virtualization

Podman

Supported

Only available in phytec-container-image

Interface Overview

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

ADC

adc0

Supported

CAN

mcan0

Supported

mcan1

Supported

ECAP

ecap0

disabled

ecap1

disabled

ecap2

disabled

Ethernet

eth0 (cpsw ethernet)

Supported

DP83867IRRGZ SOM PHY

eth1 (pri-icssg0 ethernet)

Supported

DP83867IRRGZ CB PHY

eth2 (pri-icssg0 ethernet)

Supported

DP83867IRRGZ CB PHY

EPWM

epwm0

Supported

Enabled via Device Tree Overlay

epwm1

disabled

epwm2

disabled

EQEP

eqep0

disabled

eqep1

disabled

eqep2

disabled

FSI

fsi0

disabled

fsi1

disabled

fsi2

disabled

fsi3

disabled

fsi4

disabled

fsi5

disabled

GPIO

gpio0

Supported

gpio1

Supported

mcu_gpio0

disabled

GPMC

gpmc0

disabled

I2C

i2c0

Supported

i2c1

Supported

i2c2

disabled

i2c3

disabled

mcu_i2c0

disabled

wkup_i2c0

disabled

MMC

mmc0

Supported

eMMC Flash Memory on the SOM

mmc1

Supported

SD Card Slot on Dev Kit Carrier Board

mPCIe

serdes0

Supported

mPCIe at the X31 connector - Enabled with device tree overlay - serdes0 signals muxed between USB HUB and mPCIe

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

spi3

disabled

spi4

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

mcu_uart1

disabled

USB

usb0

Supported

Connected to USB 3.0 HUB - USB super speed signals (serdes0) muxed between USB HUB and mPCIe with device tree overlay - USB2.0 speeds still supported when mPCIe enabled

Note

For technical support, please visit PHYTEC’s Support Portal!