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.2. Create New Scatter File to Locate the Bare Metal Application in the OCRAM

  1. Create a scatter file. Right click on the project, and select "New > Other...", then "Scatter File Editor > Scatter File".
    The scatter file enables you to specify the memory map of an image to the linker using a description in a text file. It is used by the ARM compiler linker to determine the placement of the program in the target memory.
    Figure 8. Creating Scatter File
  2. Select the project name, bare-metal-hello-world-01, and enter the scatter file name, like scatter_OCRAM.scat
    Figure 9. Scatter File Setting
  3. Select Finish.
    The new file automatically appears in the Project Explorer view.
  4. In the scatter_OCRAM.scat editor view, enter the following when targeting a Cyclone V or Arria V device: 
    OCRAM 0xFFFF0000 0x10000
{     
	APP_CODE  + 0    
	{        
		* (+ RO , + RW , + ZI )    
	}     
	ARM_LIB_STACKHEAP 0xFFFF8000 EMPTY 0x8000 ; Application heap and stack    
	{ }
}
    The view looks similar to the following:
    Figure 10. Scatter OCRAM Code Snippet
    Note: The linker script instructs the linker on how to link the application:
    • Defines OCRAM base address (0xFFFF0000) and size (0x10000)
    • Loads all application sections in the OCRAM
    • Allocates a maximum of 32 KB (0x8000) for stack and heap starting from address 0xFFFF8000
    The parameters can easily be changed for targeting Arria 10 devices, where there are 256 KB of OCRAM located at 0xFFE00000.
  5. Select the Regions/Sections tab, located just below the scatter file to show what the memory map looks like.
    Figure 11. Scatter File Regions
  6. Select File > Save to save the modifications.
  7. After the scatter file has been created in the project, it needs to be associated with the project properties. Select the project name in the Project Explorer view and right-click to select Properties.
  8. Go to C/C++ Build > Settings > Tool Settings > ARM Linker 5 > Image Layout.
  9. In the Scatter file (--scatter) text field, browse to the newly created scatter file which should now be in the project folder.
  10. Select Apply and then OK.
    Figure 12. Scatter File Location Setting
Level Two Title