BSP-Yocto-Ampliphy-AM64x-PD23.2.1

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

New in this Release

Yocto

  • 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 image phytec-container-image to provide a BSP with virtualization enabled.

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

Linux Kernel

U-Boot Bootloader

  • New Boot Source available; load and run U-Boot via UART (X49).

  • Supports QSPI SOM option as alternative for OSPI NOR Flashes.

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

Issues Fixed

Known Issues

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

  • The flashcp command occasionally fails during the verification step.

Software Versioning

The BSP-Yocto-Ampliphy-AM64x-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-v09.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-AM64x-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-072-42F2DE11I.A0

phyCORE-AM64x SOM (HS-FS silicon)

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

1565.1

PCM-072-42F2DE01I.A0

phyCORE-AM64x SOM (HS-FS silicon)

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

1565.1

PCM-072-42F2BX11I.A0

phyCORE-AM64x SOM (HS-FS silicon)

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

1565.1

PCM-072.A2

phyCORE-AM64x SOM (HS-FS silicon)

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

1565.1

PCM-072.A1

phyCORE-AM64x SOM (GP silicon)

2GB / 16GB eMMC / 64MB OSPI NOR / 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-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-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-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-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-am64-phyboard-electra-pcie-usb2.dtbo

SPI1 and UART3 Overlay

k3-am64-phyboard-electra-x27-uart3-spi1.dts

GPIO Fan Overlay

k3-am64-phyboard-electra-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-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

Unsupported

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

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!