Running Software Applications; Running An Application Step-By-Step Guide - Enclustra Mars ZX2 User Manual

3.5

Running Software Applications

This section describes how to run software applications on the Mars ZX2 SoC module. The steps are
generic, and apply to the software example templates in the Vitis IDE.
Step Description
1 Create a run configuration for the application in Vitis IDE 2022.1:
1. Right click the previously generated application (e.g. HelloWorld) under the system
project (e.g. HelloWorld_system) and select
Run As
2. Right-click Single Application Debug and hit New Configuration or double-click on it
3. Enter a run configuration name in the Name field (e.g. HelloWorld) and hit Apply
4. Application tab (see Figure 3):
(a) Enable ps7_cortexa9_0 checkbox
(b) In the Project Name field click browse and select an application (e.g. HelloWorld)
(c) In the Application field click search and select an .elf file (e.g. HelloWorld.elf)
(d) Hit Apply
5. Target Setup tab (see Figure 4):
(a) For Hardware Platform refer to the corresponding Platform:
e.g. ${sdxTcfLaunchFile:project=HelloWorld;fileType=hw;}
(b) For Bitstream file field, hit Search...
(c) Select Mars_ZX2_ST3.bit and hit OK
(d) For PL Device and PS Device, use Auto Detect option
(e) Uncheck the "Use FSBL flow for initialisation" if it is enabled
(f) In the Initialization File field, hit Search...
(g) Select ps7_init.tcl and hit OK
(h) Enable checkboxes Reset entire system, Program FPGA, Run ps7_init and Run
ps7_post_config
(i) Hit Apply
2 Make sure the Hardware is configured according to Section 3.2:
Connect the 12 V DC power supply plug to the power connector of the Mars ST3 base
board (see label
With a serial console program e.g. Tera Term connect to the COM port that corresponds
to the Serial Converter B. For issues related to UART, refer to Section 5.4.
3 Start the application by clicking the Run button.
This method of starting the application resets the entire system, executes the required ini-
tialization for the PS, powers up the PL, configures the PLwith the specified bitstream and
downloads the application program to the ARM processor.
In some test setup cases it was observed that the Vitis tool was not able to start a second run
session without a hardware reset. If required, power off and on the base board and restart the
run configuration.
For issues related to JTAG, refer to Section 5.3.
Table 7: Running an Application Step-By-Step Guide
After the PL is successfully configured, the
successfully, the output of the HelloWorld application should appear on the UART console.
D-0000-489-003
Run Configurations...
12 V DC in Figure 2).
DONE LED should be lit. When the application is running
14 / 25 Version 2022.1_v2.0.1, 15.10.2022