User Managed Flow - 2023.2 English

Vitis Unified Software Platform Documentation: Embedded Software Development (UG1400)

Document ID
Release Date
2023.2 English

If you prefer to manage your source code hierarchy and build process in a unique way, for instance, by crafting your own Makefile or CMake files, you can use User Managed Mode. This mode empowers you by offering enhanced support and debugging capabilities, especially when you oversee the build flow. Additionally, the User Managed Flow simplifies the process, making the build launch more seamless and user-friendly. If you prefer command line flow to develop your application, User managed flow is an ideal choice. This flow supports Makefile based projects. Execute the following steps to use the flow.

  1. Start Vitis Unified IDE.
  2. Open a workspace where Makefile based project exists.
  3. Click User Managed Flow to switch to user managed flow in the Component view. The Explorer view must contains all the files in the directory.
    Note: The explorer view can also be reached from Menu > View > Explorer.
  4. Create build configuration.
    1. Right click anywhere on File Explorer > Edit Build Configuration.
    2. Create a new build configuration by clicking + button,
    3. A new configuration is created. Input your build command and clean command. You can also specify the build directory, if needed. See the following figure for an example.
    4. Right click anywhere in the file explorer and select Build to build your project.
  5. Create Run/Debug launch configuration after build is finished.
    1. Right click anywhere in the file explorer and select Edit Launch Configuration.
    2. Create a launch configuration by clicking + button.
    3. It brings up Create Launch Configuration wizard. You have four options for embedded application component.
      1. Attach to Running Target: If you desire to debug on the already running target, select this option. You need to provide the target connection and begin to debug.
        Note: Refer to Target Connections for creating the target connections.
      2. Baremetal: This is used to debug or run the bare-metal application component. Specify the XSA file and click Submit to create the configuration file. Wait until the Launch Configuration file pops up. Refer to Launch Configurations for setting references.
      3. Attach to Running Process on Linux Target: To debug a Linux application on an already running Linux target, select this option and click Submit. Launch configuration window appears. Provide the target connection and executable file, post which you can run/debug it.
      4. Linux Application with ELF: If a Linux application has to be run/debugged, select this option and provide the elf. Launch configuration with the few sections is created for the app. Provide the necessary information post which you can run/debug it.