BSP-Yocto-Ampliphy-AM64x-PD23.2.0

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

Board Support Package Status

BSP Operating system

Linux

Release Status

RELEASED

Release Date

2023-09-29

Repository

PHYTEC Public Repos

Binaries

BSP-Yocto-Ampliphy-AM64x-PD23.2.0

New in this Release

Yocto

  • MACHINE=phyboard-electra-am64xx-2 for TI’s High Security-Field Securable (HS-FS) SoCs.

    • HS-FS variant phyCORE-AM64x SOMs are now the default SOM configuration shipping in Development kits.

  • UART boot source now available.

  • Inline ECC support is now available and enabled by default.

  • Virtualization support with Podman/Docker

Linux Kernel

  • TSN support for Ethernet.

  • New device tree overlay references for disabling optional population options of the SOM.

  • Watchdog support

  • GPIO FAN with pre-set thermal zone

  • ADC channels are configured correctly

  • RPMSG reserved memory regions enabled by default (previously enabled by device tree overlay)

U-Boot Bootloader

  • EEPROM Hardware introspection enabled for identifying Ethernet PHY, SPI-NOR Flash, and RTC population options

  • USB Host support

Software Versioning

The BSP-Yocto-Ampliphy-AM64x-PD23.2.0 software release is largely based off of Texas Instruments’s v09.00.00.007 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.33 (tag: v6.1.33-phy3)

PHYTEC Linux kernel repository

U-Boot Bootloader

v2023.04 (tag: v2023.04_09.00.00.007-phy4)

PHYTEC U-Boot bootloader repository

Yocto

4.0.12 Kirkstone (tag: BSP-Yocto-Ampliphy-AM64x-PD23.2.0)

PHYTEC Meta Layer repository

PHYTEC Meta Layer

This BSP release supports various configurations of the phyCORE-AM64x SOM and Development Kit, here is a summary of the Yocto MACHINE configuration support included in the PHYTEC Meta Layer for this release:

Yocto MACHINE Summary

Yocto MACHINE

Default Target Image

Linux Distro

Kit Part Number

Compatible Modules

U-Boot defconfig

Linux defconfig

Device Tree Files

phyboard-electra-am64xx-2 (Default Kit - HS-FS Soc Variant)

phytec-headless-image

PHYTEC Ampliphy Reference Distribution

KPB-07225-002.A0

SOM:
PCM-072-42F2DE11I.A0
Carrier Board:
PBA-C-25.A1

u-boot.img:
phycore_am64x_a53_defconfig
SPL:
phycore_am64x_r5_defconfig

phytec_ti_defconfig
phytec_ti_platform.config

Default Device Tree:
k3-am642-phyboard-electra-rdk.dtb
Overlays:
k3-am64-phyboard-electra-pcie-usb2.dtbo
k3-am64-phyboard-electra-x27-uart3-spi1.dtbo
k3-am64-phyboard-electra-gpio-fan.dtbo
k3-am6-phycore-disable-spi-nor.dtbo
k3-am6-phycore-disable-rtc.dtbo
k3-am6-phycore-disable-eth-phy.dtbo

phyboard-electra-am64xx-2 (Deprecated - HS-FS Soc Variant)

phytec-headless-image

PHYTEC Ampliphy Reference Distribution

KPB-07225-001.A0

SOM:
PCM-072.A2
Carrier Board:
PBA-C-25.A1

u-boot.img:
phycore_am64x_a53_defconfig
SPL:
phycore_am64x_r5_defconfig

phytec_ti_defconfig
phytec_ti_platform.config

Default Device Tree:
k3-am642-phyboard-electra-rdk.dtb
Overlays:
k3-am64-phyboard-electra-pcie-usb2.dtbo
k3-am64-phyboard-electra-x27-uart3-spi1.dtbo
k3-am64-phyboard-electra-gpio-fan.dtbo
k3-am6-phycore-disable-spi-nor.dtbo
k3-am6-phycore-disable-rtc.dtbo
k3-am6-phycore-disable-eth-phy.dtbo

phyboard-electra-am64xx-1 (Deprecated - GP Soc Variant)

phytec-headless-image

PHYTEC Ampliphy Reference Distribution

KPB-07225-ALPHA.A1

SOM:
PCM-072.A1
Carrier Board:
PBA-C-25.A1

u-boot.img:
phycore_am64x_a53_defconfig
SPL:
phycore_am64x_r5_defconfig

phytec_ti_defconfig
phytec_ti_platform.config

Default Device Tree:
k3-am642-phyboard-electra-rdk.dtb
Overlays:
k3-am64-phyboard-electra-pcie-usb2.dtbo
k3-am64-phyboard-electra-x27-uart3-spi1.dtbo
k3-am64-phyboard-electra-gpio-fan.dtbo
k3-am6-phycore-disable-spi-nor.dtbo
k3-am6-phycore-disable-rtc.dtbo
k3-am6-phycore-disable-eth-phy.dtbo

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

KPB-07225-002.A0

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

KPB-07225-001.A0

PCM-072.A2 + PBA-C-25.A1 (Deprecated)

KPB-07225-ALPHA.A1

PCM-072.A1 + PBA-C-25.A1 (Deprecated)

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

The following table outlines the validated interfaces of the default phyCORE-AM64x development kit.

Note

This table only outlines the key features of the phyCORE-AM64x PHYTEC has chosen to enable by default, which serves as a basis for customization in production designs. Unnecessary interfaces can be disabled and additional interfaces can be enabled when deploying the SOM on a custom carrier board. Other features of the phyCORE-AM64x may or may not be configurable depending on pin multiplexing conflicts, for more information review the phyCORE-AM64x schematic in tandem with the Processor Datasheet.

Supported Interfaces

Interface

Detail

Implemented

Tested

Status in Device tree

Notes

UART

uart0

Yes

Yes

Okay

Default serial console
- Connected to CP2105 header

I2C

i2c0

Yes

Yes

Okay

i2c1

Yes

Yes

Okay

Ethernet

eth0 (cpsw ethernet)

Yes

Yes

Okay

DP83867IRRGZ SOM PHY

eth1 (pru-icssg0 ethernet)

Yes

Yes

Okay

DP83867IRRGZ CB PHY

eth2 (pru-icssg0 ethernet)

Yes

Yes

Okay

DP83867IRRGZ CB PHY

eMMC/SD/SDIO

mmc0

Yes

Yes

Okay

eMMC Flash Memory on the SOM

mmc1

Yes

Yes

Okay

SD Card Slot on Dev Kit Carrier Board

USB

usb0

Yes

Yes

Okay

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

CAN

can0

Yes

Yes

Okay

Full Duplex CAN brought out to X2 10pin header

can1

Yes

Yes

Okay

Full Duplex CAN brought out to X3 10pin header

SPI

spi0

Yes

Yes

Okay

Connected to Infineon Trusted Platform Module (TPM) SLB9670

OSPI

ospi0

Yes

Yes

Okay

NOR Serial Flash on SOM

GPIO

User LEDs

Yes

Yes

Okay

User LEDs populated on SOM and Carrier Board

User Buttons

Yes

Yes

Okay

General Purpose I/O

GPIOs can be configured “on the fly”
- See GPIO Peripheral Interface Guide

Memory

SOM EEPROM

Yes

Yes

Okay

M24C32 on i2c0

Carrier Board EEPROM

Yes

Yes

Okay

M24C02 on i2c1

OSPI NOR Flash

Yes

Yes

Okay

MT35XU512ABA

RTC

SOM RTC

Yes

Yes

Okay

RV-3028-C7 on I2C0

mPCIe

serdes0

Yes

Yes

Disabled

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

PRU-ICSSG

pru_icssg0

Yes

Yes

Okay

Connected to eth1 and eth2

Note

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