alinx_z19_linux/README.md

Alinx_z19_Linux

How to Build Atomic Rules' Yocto ARDSoC Project for Alinx_z19 (this takes 2 to 3 hours to complete)

1. tar -xvf yocto-ardsoc_4-10-26.tar
2. cd yocto-ardsoc/
3. sudo ./scripts/plnx-env-setup.sh
4. replace the .xsa file with the latest version at the path below:
   yocto-ardsoc/sources/meta-atomicrules/meta-atomicrules-ardsoc/meta-z19-9081/recipes-bsp/external-hdf/files/system.xsa --> for AD9081 or
   yocto-ardsoc/sources/meta-atomicrules/meta-atomicrules-ardsoc/meta-z19-9082/recipes-bsp/external-hdf/files/system.xsa --> for AD9082
5. create build folder as shown below: --> this command creates/selects build folder and changes directoty into it
   source setupsdk z19-9081 build-z19-9081 --> for AD9081 or
   source setupsdk z19-9082 build-z19-9082 --> for AD9082
6. the command prompt should now be a the path below:
   yocto-ardoc/build-z19-9081 --> for AD9081
   yocto-ardoc/build-z19-9082 --> for AD9082
7. bitbake ardsoc-image-core --> if all builds successfully see Output Artifacts section

How to re-generate BOOT.BIN after the above steps have been completed (this takes 30 to 45 minutes to complete)

1. replace the .xsa file with the latest version at the path below:
   yocto-ardsoc/sources/meta-atomicrules/meta-atomicrules-ardsoc/meta-z19-9081/recipes-bsp/external-hdf/files/system.xsa --> for AD9081 or
   yocto-ardsoc/sources/meta-atomicrules/meta-atomicrules-ardsoc/meta-z19-9082/recipes-bsp/external-hdf/files/system.xsa --> for AD9082
2. cd yocto-ardsoc/
3. sudo ./scripts/plnx-env-setup.sh --> if the terminal window was not closed since last built, this command does not need to be run
4. create build folder as shown below: --> this command creates/selects build folder and changes directoty into it
   source setupsdk z19-9081 build-z19-9081 --> for AD9081 or
   source setupsdk z19-9082 build-z19-9082 --> for AD9082
5. rm -rf tmp/
6. bitbake ardsoc-image-core --> if all builds successfully see Output Artifacts section

Output Artifacts

After the compilation is completed the output artifacts can be found here:

For AD9081

a) yocto-ardsoc/build-z19-9081/tmp/deploy/images/ardsoc-z19-zynqmp/boot.bin
b) yocto-ardsoc/build-z19-9081/tmp/deploy/images/ardsoc-z19-zynqmp/ardsoc-image-core-ardsoc-z19-zynqmp.rootfs.wic.gz

For AD9082

a) yocto-ardsoc/build-z19-9082/tmp/deploy/images/ardsoc-z19-zynqmp/boot.bin
b) yocto-ardsoc/build-z19-9082/tmp/deploy/images/ardsoc-z19-zynqmp/ardsoc-image-core-ardsoc-z19-zynqmp.rootfs.wic.gz

How to set MAC address (Must be done after burning SD card and a serial cable is required)

1. turn on the board and stop u-boot by pressing the enter key several times
2. type saveenv --> this creates the environment variables file on the SD card
3. to set the MAC address (must change the last digits to an unused number):
   type setenv -f ethaddr 00:0a:30:00:81:01 --> for AD9081 or
   type setenv -f ethaddr 00:0a:30:00:82:01 --> for AD9082
4. type saveenv
5. type boot to reboot the board
6. login to linux and type ifconfig to verify that the MAC address was set correctly and that an IP address was assigned.

to transfer boot.bin to Alinx board

1. scp yocto-ardsoc/build-z19-9082/tmp/deploy/images/ardsoc-z19-zynqmp/boot.bin root@<ip_address>:/boot
2. After the transfer is completed, reboot or power cycle the board

to copy boot.bin from the ALinx board

1. scp root@<ip_address>:/boot/boot.bin .