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.1.3. Build and Debug the Project

  1. Then, right click on the project and select "Build Project".
    The “Debug” build directory will be created and the compiled object modules will be placed there.
    Figure 13. Bare Metal "Hello World - 01" Built Done
  2. To download and debug the program, select Run > Debug Configurations.
  3. Right click on DS-5 Debugger and select New to create a new debug configuration.
    Figure 14. New Debug Configuration
  4. In the Connection tab, select Altera > Cyclone V SoC (Single Core) > Bare Metal Debug > Debug Cortex-A9_0 and select "USB-Blaster" from the Target Connection pull-down menu.
    Figure 15. New Debug Configuration Target Connection Setting
  5. Select an available Bare Metal Debug Connection by clicking Browse.
    This will return a list of the available debug connections.
    Figure 16. Connection Browser
  6. Select the hardware and then click Select. Change the name of the configuration from "New_Configuration" to "bare-metal-hello-world-config", and select Apply.
    Figure 17. Bare Metal Hello World Config Connection Settings
  7. Go to the Files tab and select the application to download by clicking “Workspace” and select the object module that was built, bare-metal-hello-world-01.axf.
    It should be in the Debug folder within the project. Make sure that “Load symbols” is selected, and then click on Apply.
    Figure 18. Bare Metal Hello World Config Files Settings
  8. Go to the Debugger tab and make sure that under Run control, Debug from symbol is set to "main".
    Figure 19. Bare Metal Hello World Config Debugger Settings
  9. Select Debug to load and debug the application.
    It runs a query to change to the DS-5 Debug Perspective. Select Yes.
    Figure 20. Confirm Perspective Switch
  10. It switches to the DS-5 Debug Perspective and then download and begin to run the application.
    The program stops at main and waits there. In the Commands view, notice the entry point is 0xFFFF0000, which is the start address specified in the scatter file for the on-chip RAM.
    Figure 21. OCRAM Debug Stop at Main
  11. Click the Step Over Source Line icon or press F6.
  12. Then "Step" again.
    The output appears on the App Console view.
    Figure 22. "App Console" Output
  13. Select Continue to exit out of the application.
  14. Create a breakpoint by double clicking on the left margin of the bare-metal-hello-world-0.1.c Source view. If the Breakpoints view is not shown, then open it by selecting: View > Show View > Breakpoints.
    Figure 23. Debug Breakpoint Setup
Level Two Title