PetaLinux Images Quick Try - 2023.2 English

Use the following basic steps to boot Linux and run an OpenAMP application using pre-built images. The following steps apply to the ZCU102 board.

If the target hardware platform is Versal, refer to https://xilinx-wiki.atlassian.net/wiki/spaces/A/pages/18841718/OpenAMP for information on supported hardware configurations and Versal-specific information for running the RPMsg demo in Kernel space on the Versal platform.

The echo-test application sends packets from Linux running on quad-core Cortex-A53 to a single Cortex-R5 running FreeRTOS, which sends them back.

1. Extract files BOOT.BIN, image.ub, and openamp.dtb files from a pre-built PetaLinux BSP tarball to an SD card. The OpenAMP related device nodes are not in the default system.dtb, but are included in the prebuilt openamp.dtb.

   host shell$ tar xvf xilinx-zcu102-v2019.2-final.bsp --strip-components=4 --wildcards */BOOT.BIN */image.ub */openamp.dtb
   
   host shell$ cp BOOT.BIN image.ub openamp.dtb <your sd card>

   Note: Alternatively, if you already created a PetaLinux project with a provided BSP for your board, you can find pre-built images in the <your project>/pre-built/linux/images/ directory.
2. Go to U-Boot prompt and boot Linux from the SD card:

   ZynqMP> mmcinfo && fatload mmc 0 0x10000000 image.ub && fatload mmc 0 0x14000000 openamp.dtb
   
   Device: mmc@ff170000
   
   Manufacturer ID: 3
   
   OEM: 5344
   
   Name: SL16G
   
   Bus Speed: 100000000
   
   Mode: UHS SDR50 (100MHz)
   
   Rd Block Len: 512
   
   SD version 3.0
   
   High Capacity: Yes
   
   Capacity: 14.8 GiB
   
   Bus Width: 4-bit
   
   Erase Group Size: 512 Bytes
   
   57212600 bytes read in 3718 ms (14.7 MiB/s)
   
   40961 bytes read in 26 ms (1.5 MiB/s)
   
   ZynqMP> bootm 0x10000000 0x10000000 0x14000000

   Note: As an alternative to all steps above to SD boot, you can JTAG boot the board. For this you need to have connected a JTAG cable, installed JTAG drivers, and created a PetaLinux project using a provided BSP.

   To do this, you must go in the <your project>/pre-built/linux/images directory and replace the system.dtb file by openamp.dtb, next type petalinux-boot --jtag --prebuilt 3.

3. At the Linux login prompt, type root for user and root for password, and run the echo-test demo.

   plnx_aarch64 login: root
   
   Password:
   
   root@plnx_aarch64:~# echo image_echo_test > /sys/class/remoteproc/remoteproc0/firmware
   
   root@plnx_aarch64:~# echo start > /sys/class/remoteproc/remoteproc0/state
   
   [  265.772355] remoteproc remoteproc0: powering up ff9a0100.zynqmp_r5_rproc
   
   [  265.779900] remoteproc remoteproc0: Booting fw image echotest_standalone_r5_0.elf, size 719860
   
   [  265.790005] zynqmp_r5_remoteproc ff9a0100.zynqmp_r5_rproc: RPU boot from TCM.
   
   Starting application...
   
   Initialize remoteproc successfully.
   
   creating remoteproc virtio
   
   initializing rpmsg shared buffer pool
   
   initializing rpmsg vdev
   
   initializing rpmsg vdev
   
   Try to create rpmsg endpoint.
   
   Successfully created rpmsg endpoint.
   
   [  265.797738] remoteproc remoteproc0: registered virtio0 (type 7)
   
   [  265.800388] virtio_rpmsg_bus virtio0: rpmsg host is online
   
   [  265.830254] remoteproc remoteproc0: remote processor ff9a0100.zynqmp_r5_rproc is now up
   
   [  265.838381] virtio_rpmsg_bus virtio0: creating channel rpmsg-openamp-demo-channel addr 0x0
   
   root@xilinx-zcu102-2019_1:/lib/firmware# echo_test -d virtio0.rpmsg-openamp-demo-channel.-1.0
   
   Echo test start
   
   Open rpmsg dev /dev/rpmsg0!
   
   **************************************
   
   Echo Test Round 0
   
   **************************************

   Note: This rpmsg device driver is an out-of-tree Linux kernel module. It can be loaded at boot time if you write a start-up init script (See examples in PetaLinux Tools Documentation: Reference Guide (UG1144).