Adding test steps to take the design to Hardware (VCK190 board)

Tutorials/AIE-PL/Export_to_Vitis/README.md

@@ -214,7 +214,7 @@ ${SD_CARD}: ${BUILD_DIR}/${XSA} ${PS_EXE} ${KERNEL_IMAGE} ${ROOTFS} ${STIMULUS_I
 
 This target creates an `sd_card.img` that can be loaded onto a board, in this case a VCK190. The packager takes as inputs the VSS and the XSA that was generated by the linker.
 
-## Building and Running the Project
+## Building and Running the Project for Hardware Emulation
 
 The `Makefile` contained in this folder invokes other Makefiles in the project to build each component, then link and package the overall platform.
 
@@ -265,6 +265,90 @@ Max Error: 256
 
 ```
 
+## Building and Running the Project for Hardware
+
+1. Run `make all TARGET=hw` in a terminal window to build and package the project for the target.
+
+![figure1](Images/hwtest1.png)
+
+2. The build process will take some time. When complete, the outputs will appear in a new folder named `package`.
+
+![figure1](Images/hwtest2.png)
+
+3. A new folder named `build_hw` will appear under `vitis` after completion of hardware build:
+
+![figure1](Images/hwtest3.png)
+
+![figure1](Images/hwtest4.png)
+
+4. Prerequisites:
+* An sd_card.img file, generated by Vitis for the design to be tested on board
+* VCK190 Evaluation board
+  * System Controller SD Card: may already be available with the board and plugged in.
+  * VCK190 SD card: may already be available with the board. This is the card, where you will write the sd_card.img file generated for your design.
+  * Connect uSD card to your laptop. If your laptop does not come with a uSD card reader slot, an USB-to-uSD card-reader may be used, assuming laptop has a USB port
+  * For board setup please refer to (https://github.com/Xilinx/Vitis_Model_Composer/tree/2024.2/QuickGuides/Running_on_Hardware/linux).
+
+5. Now Run the command `connect com0` in the vitis terminal.
+
+6. Open a new terminal and cd to the path for .pdi file.
+   cd "the_path_for_golden_pdi_file" (You must have your .pdi file in your system)
+
+7. Type `xsdb`
+
+8. Type `conn`
+
+9. Type `ta 1`
+
+10. Type `dev p linux_prod.pdi`
+
+![figure1](Images/hwtest5.png)
+
+10. Go back to the 1st terminal and hit any key to stop auto boot.
+
+11. Type `booti 2000000 - 1000` this command will boot the default linux.
+
+12. Now copy the image file at a specified location by using below commands: 
+
+`scp sd_card.img <image_file_location>`
+
+`dd if=sd_card.img of=/dev/mmcblk0`
+
+13. Type `sync`.
+
+14. Now switch back to the 2nd terminal and type `exit` (It will exit from the xsdb).
+
+15. Type `power 0 power 1` (It will execute the power sequence of the board).
+
+16. Now switch back to 1st terminal and type `connect com0`.
+
+17. Now go to the 2nd terminal and type `xsdb` and then type `conn`. 
+
+18. Run the below commands in a sequence as shown in the figure below:
+
+ ta 1
+ mwr -force 0xF1260200 0xE100
+ mrd -force 0xF1260200
+ after 2000
+ mwr -force 0xF126031C 0x8
+
+![figure1](Images/hwtest6.PNG)
+
+18. Type the command `petalinux` and then type `sudo su`.
+
+19. Mount the memory location and then change the current directory by using the below commands.
+
+`mount /dev/mmcblk0p1 /mnt`
+
+`cd /mnt/`
+
+20. Type `ls` and run the executable file from the list by using the command `./embedded_exec.sh`.
+
+21. It should print the test result as shown in the below image:
+
+![figure1](Images/hwtest9.png)
+
+
 ## Conclusion
 
 **Congratulations!** In this tutorial, you saw how to export a heterogeneous design (AI Engine + PL) to Vitis as a Vitis Subsystem (VSS) and build a complete design targeting the board.