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.2.2. Create New Debug Configurations and Debug Preloader

  1. Select "USB-Blaster" from the Target Connection pull-down menu and then select an available Bare Metal Debug Connection by clicking Browse.
    Figure 32. Run Preloader Hello Connection Settings
  2. On the Files tab, select Workspace and browse to the project and then the Preloader file “u-boot-spl”.
  3. Uncheck the check box next to "Load Symbols".
    Figure 33. Run Preloader Hello Files Settings
  4. 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 34. Run Preloader Hello Debugger Settings
  5. Select Apply and then Debug, then “Yes” to switch to the DS-5 Debug perspective, if queried.
    Figure 35. Confirm Perspective Switch
  6. DS-5 AE should load and run the Preloader in the on-chip RAM, similarly to how the simple Bare Metal example is ran. This initializes the SDRAM memory controller and then stop and wait.
    The display should look something like this:
    Figure 36. Run Preloader Hello Debug View
    This Run Control can now be used to launch the Preloader.

    Although this method associates the Preloader image with a specific DS-5 project, it can still be used with other projects. However, it is important to remember which project contains the Preloader image.

    It should load and run the Preloader in the on-chip RAM, similarly to how the simple Bare Metal example was run. This configures the SDRAM memory controller and then stops.

    After that, you can download and run the "Hello World" example in the SDRAM memory. The same Debug Configuration created earlier for the Hello World example can be used.

Level Two Title