Bar
SpaceWire UK
Specialist providers of VHDL Intellectual Property & Design Services
BarBarBarBar
Tutorial
Missing Image!
Part 6 - Create & build 2nd software project

Introduction

This tutorial details the steps required for using Vitis to create & deploy a very simple ARM Cortex-A9 based bare metal software application to access the LED's and slide switches on the ZedBoard hardware.

Aims

The aims of this tutorial are as follows :-
  1. Setup environment
  2. Launch Vitis
  3. Create project
  4. Build platform
  5. Create new source file
  6. Build project
  7. Archive project

1. Setup environment

Setup Xilinx design environment for the 2021.2 toolset.
steve@Linux-Steve:/home/steve$ source xilinx.sh
Xilinx tools available tools at /opt/Xilinx :-
1) 2021.2 - Vivado - SDK - Vitis - PetaLinux
0) Exit
Please select tools required or exit : 1

Tools are as follows :-
vivado @ /opt/Xilinx/Vivado/2021.2/bin/vivado
vitis @ /opt/Xilinx/Vitis/2021.2/bin/vitis
petalinux-build @ /opt/Xilinx/PetaLinux/2021.2/tool/tools/common/petalinux/bin/petalinux-build

2. Launch Vitis

Launch Vitis IDE and specify the new Workspace to create.
steve@Linux-Steve:/home/steve$ vitis -workspace /home/steve/projects/leds_switches/sw &

3. Create project

The Vitis IDE : Welcome window will now appear. Create a project by clicking on Create Application Project under the Project heading. Missing Image! The New Application : Project Create a New Project window will now appear. Review the information provided and then click Next. Missing Image! The New Application Project : Platform window will now appear. Select the exported hardware platform from Vivado by entering the Create a new platform form hardware (XSA) tab and setting the XSA File to /home/steve/projects/leds_switches/fw/system_wrapper.xsa. Click Next to continue. Missing Image! The New Application Project : Application Project Details window will now appear. Set the Application project name to leds_switches and then click Next. Missing Image! The New Application Project : Domain window will now appear. The default settings as shown are fine for this project. Click Next to contune. Missing Image! The New Application Project : Templates window will now appear. Create an empty application by selecting Empty Application(C) from the Available Templates section. Click Finish to contune. Missing Image! The Vitis IDE cockpit window will now appear. This is the window where all the action happens. Missing Image!

4. Build platform

Build the platform by right clicking on system_wrapper inside the Explorer tab and selecting Build Project. Missing Image!

5. Create new source file

Create a new source file inside the leds_switches application project. Right click on src then select New » File. Missing Image! In the Create New File dialog set the File name to leds_switches.c and click Finish to continue. Missing Image! The new source file is automatically opened in the Vitis IDE for editing. Missing Image! Copy the code below into the newly created leds_switches.c and save it by selecting File » Save from the main menu.

leds_switches.c

  1. #include "xparameters.h"
  2. #include "xil_printf.h"
  3. #include "xgpio.h"

  5. #define CHANNEL_LEDS 1
  6. #define CHANNEL_SWITCHES 2

  8. // Print LSB 'bits' from 'number' in binary format
  9. void print_bin(u32 number, u8 bits)
  10. {
  11.   u32 mask = 1 << (bits - 1);
  12.   for(; mask; mask >>= 1)
  13.     xil_printf("%d", (number & mask) != 0);
  14. }


  17. int main()
  18. {
  19.   XGpio_Config *gpio_0_cfg;
  20.   XGpio gpio_0;
  21.   u32 gpio_0_data;

  23.   // Initialise GPIO
  24.   gpio_0_cfg = XGpio_LookupConfig(XPAR_AXI_GPIO_0_BASEADDR);
  25.   XGpio_CfgInitialize(&gpio_0, gpio_0_cfg, gpio_0_cfg->BaseAddress);

  27.   // Print header
  28.   print("LED & Switch Example\n\n\r");
  29.   print("Select required operation :-\n\r");
  30.   print("r - Read from switch register\n\r");
  31.   print("w - Write to LED register\n\r");
  32.   print("q - Quit application\n\r");

  34.   // Wait for user input & perform required operation
  35.   char8 key;
  36.   do
  37.   {
  38.     key = inbyte();

  40.     switch (key)
  41.     {
  42.       case 'r':
  43.         gpio_0_data = XGpio_DiscreteRead(&gpio_0, CHANNEL_SWITCHES);
  44.         xil_printf("Switch Register @ 0x%x = 0b", gpio_0_cfg->BaseAddress);
  45.         print_bin(gpio_0_data, 8);
  46.         print("\n\r");
  47.         break;

  49.       case 'w':
  50.         gpio_0_data = 0b00000001;
  51.         for (u8 i = 0; i <= 15; i++)
  52.         {
  53.           XGpio_DiscreteWrite(&gpio_0, CHANNEL_LEDS, gpio_0_data);
  54.           xil_printf("LED Register @ 0x%x = 0b", gpio_0_cfg->BaseAddress);
  55.           print_bin(gpio_0_data, 8);
  56.           print("\n\r");
  57.           usleep(100000);
  58.           if (i < 7)
  59.             gpio_0_data <<= 1;
  60.           else
  61.             gpio_0_data >>= 1;
  62.         }
  63.         break;
  64.     }
  65.   } while (key != 'q');

  67.   // Print footer
  68.   print("All done!\n\n\r");

  70.   // Exit application
  71.   return 0;
  72. }

6. Build project

Build the project by right clicking on leds_switches under leds_switches_system inside the Explorer tab and selecting Build Project. Missing Image!

7. Archive project

Create an archive so the project can be regenerated and revision controlled (optional). Select File » Export... from the main menu. In the Export Vitis Projects dialog set Archive File to vitis_export_archive.ide.zip, set Directory to /home/steve/projects/leds_switches and tick System Projects & Platform Projects. Click OK to continue. Missing Image! In the Export Vitis Projects status dialog click OK to continue. Missing Image! Add the file /home/steve/projects/leds_switches/vitis_export_archive.ide.zip to the revision control system & commit (optional).
Copyright © 2004-2021 SpaceWire UK. All rights reserved.