Bare Metal User Guide

Download PDF
ID 683211
Date 11/30/2015
Public
Document Table of Contents
Document Table of Contents x
1. Bare Metal User Guide
1. Bare Metal User Guide x
1.1. Introduction 1.2. Bare Metal Overview 1.3. Prerequisites for the Bare Metal Development Environment 1.4. Bare Metal Compiler 1.5. Bare Metal Development Flow 1.6. Using DS-5 AE to Create and Manage Bare Metal Projects 1.7. Importing, Building and Debugging in a Make-Based Example 1.8. DS-5 ARM HWLIBs Project Derived from Make-Based Project 1.9. Minimal Preloader 1.10. Appendix: Troubleshooting
1.6. Using DS-5 AE to Create and Manage Bare Metal Projects x
1.6.1. Simple Bare Metal Project Using On-Chip-RAM 1.6.2. Preloader 1.6.3. Modify Project to Run from SDRAM Instead of On-Chip RAM 1.6.4. Alternative Way to Create a Simple Bare Metal Project Running from On-Chip-RAM
1.6.1. Simple Bare Metal Project Using On-Chip-RAM x
1.6.1.1. Create Project 1.6.1.2. Create New Scatter File to Locate the Bare Metal Application in the OCRAM 1.6.1.3. Build and Debug the Project
1.6.2. Preloader x
1.6.2.1. Loading and Running the Default Preloader 1.6.2.2. Importing Preloader into a DS-5 Project
1.6.2.2. Importing Preloader into a DS-5 Project x
1.6.2.2.1. Import Preloader 1.6.2.2.2. Create New Debug Configurations and Debug Preloader 1.6.2.2.3. Download and Debug 'Hello World' Example in the SDRAM Memory
1.6.3. Modify Project to Run from SDRAM Instead of On-Chip RAM x
1.6.3.1. Create a New Scatter File to Locate the Bare Metal Application in the SDRAM
1.7. Importing, Building and Debugging in a Make-Based Example x
1.7.1. Import the Project 1.7.2. Build the Project 1.7.3. Debug the Project
1.8. DS-5 ARM HWLIBs Project Derived from Make-Based Project x
1.8.1. Create Project 1.8.2. Build Project 1.8.3. Run/Debug Project
1.8.1. Create Project x
1.8.1.1. Copy Files 1.8.1.2. Configure Build Settings
1.8.1.2. Configure Build Settings x
1.8.1.2.1. ARM C Compiler Settings
1.8.1.2.1. ARM C Compiler Settings x
1.8.1.2.1.1. ARM Assembler Settings 1.8.1.2.1.2. ARM Linker Settings
1.8.3. Run/Debug Project x
1.8.3.1. Create a Debug Configuration
1.9. Minimal Preloader x
1.9.1. Minimal Preloader Example Project
1.10. Appendix: Troubleshooting x
1.10.1. Debug Cable Does Not Work 1.10.2. FPGA Is Not Programmed Successfully 1.10.3. Temporary Directories not Writable
1. Bare Metal User Guide

1.6.2.1. Loading and Running the Default Preloader

There are a few options for running the Preloader.
  • It can be ran through a DS-5 command script.
  • It can be imported into a DS-5 project and launched similarly to any other Bare Metal application.
  • It can be launched by the DS-5 Run Control (Debug Control) independent from the DS-5 projects.

This section demonstrates how the preloader is launched independently from the DS-5 project for Cyclone V SoC Development Kit. To optionally import the Preloader into a DS-5 project, refer to the “Importing Preloader into a DS-5 Project” section.

This process uses the Run Configuration (Debug Configuration) of DS-5 to download and execute the Preloader.

  1. To begin, create a new Debug Configuration. Run > Debug Configurations.
  2. Select DS-5 Debugger and click on New icon, which is located just above the "type filter text" field.
    This creates a new Debug Configuration named “New_configuration”. Change the name in the Name field to something like “RunPreloaderDefault”.
  3. On the Connection tab, select Altera > Cyclone V SoC (Single Core) > Bare Metal Debug > Debug Cortex-A9 and then select "USB-Blaster" from the Target Connection pull-down menu.
    Figure 24. RunPreloaderDefault Target Connection Setting
  4. To select the physical debug connection, after the Connections field, click on Browse to select the specific Debug Hardware connection.
    Note: If there is only one debugger connected, then only one will show up in the list (as shown).
    Figure 25. Connection Browser
    Figure 26. RunPreloaderDefault Connection Settings
  5. Select the Files tab and use “File System…” to browse to the Preloader image (“u-boot-spl”).
    The Preloader image can typically be found in the following location: <SoC EDS installation folder>\embedded\examples\hardware\cv_soc_devkit_ghrd\software\preloader\uboot-socfpga\spl\u-boot-spl.
    Note: Uncheck the “Load symbols” option.
    Figure 27. RunPreloaderDefault Files Settings
  6. On the Debugger tab, select “Debug from Entry Point” under Run Control and select Execute debugger commands to enable the following commands:
    • Run
    • Pause 1s
    • Interrupt
    • Quit
    Figure 28. RunPreloaderDefault Debugger Settings
  7. Select Apply, Debug, and then "Yes" to switch to the DS-5 Debug perspective, if queried.
Related Information
Level Two Title