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

3.5

Running Software Applications

This section describes how to run software applications on the Mars AX3 FPGA 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)
4. Application tab (see Figure 3):
(a) Make sure "CPU_microblaze_CPU" is enabled
(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) Enable Reset processor checkbox
(e) 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_AX3_PM3.bit and hit OK
(d) Use the Auto Detect option for PL device
(e) Enable checkboxes Reset entire system, Program FPGA
(f) 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 PM3 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, configures the FPGA with the
specified bitstream and runs the application in the Microblaze processing system.
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 FPGA is successfully configured, the
successfully, the output of the HelloWorld application should appear on the UART console.
D-0000-492-002
Run Configurations...
12 V DC in Figure 2).
DONE LED should be lit. When the application is running
13 / 24 Version 2022.1_v1.0.2, 04.01.2023