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.7.2. Build the Project

Now that the project is imported, make sure the current toolchain (ARM Compiler 5 (DS-5 built-in)) is selected correctly in the Tool Chain Editor. This can be done with the following steps:
  1. Right click on the project and select "Properties".
  2. Go to C/C++ Build > Tool Chain Editor.
    Next, right click on the project and select "Build Project". This initiates a Make-based build that does the following:
    • Copies additional source files from HWLibs into the project.
    • Creates an object file of the FPGA image using standard Altera tools and objcopy.
    • Compiles and links everything into an AXF executable (ELF-compatible).
    Note: For details of what is happening, browse the Makefile that is part of the project.

Included with the project are a number of key items that are used to properly initialize the ARM core:

  • A scatter file (scatter.scat) that the ARM tools use for linking
    Note: Much simpler that GNU linker syntax
  • A DS script file (debug-hosted.ds) that controls debug flow
    • Loads and runs the Preloader
    • Loads the project executable (HWLIB.axf) and stops at the “main” symbol
  • A readme.txt file which describes more about this example
Level Two Title