This is the documentation for the latest (main) development branch. If you are looking for the documentation of previous releases, use the drop-down menu on the left and select the desired version.

Texas Instruments Reference Boards

A number of the OpenAMP project examples can be executed on TI Reference boards.

The Zephyr demo OpenAMP using resource table can be built for the following boards:

Board

Zephyr Identifier

Deploy Firmware Name

TI SK-AM64B

sk_am64/am6442/m4

am64-mcu-m4f0_0-fw

BeagleBoard PocketBeagle 2

sk_am64/am6442/m4

am64-mcu-m4f0_0-fw

Use the Zephyr Getting Started Guide to setup the build environment. Then build the OpenAMP example firmware with:

west build -p -b <Zephyr Identifier> samples/subsys/ipc/openamp_rsc_table

This will produce a firmware named zephyr_openamp_rsc_table.elf which can be deployed to the board. Then copy or symlink it to the expected name in the firmware directory:

ln -s zephyr_openamp_rsc_table.elf /lib/firmware/<Deploy Firmware Name>

Either restart the board so the kernel can load it on boot, or restart the remote processor manually:

# check remote processor state
cat /sys/class/remoteproc/remoteproc0/state

# Stop remote processor if running
echo stop > /sys/class/remoteproc/remoteproc0/state

# Load and start target firmware onto remote processor
echo start > /sys/class/remoteproc/remoteproc0/state

Note

The remote processor number (remoteproc0) may be different depending on driver probe order. To check which remote processor the number belongs to print out the default firmware name (cat /sys/class/remoteproc/remoteproc0/firmware) and match that to the Deploy Firmware Name above.