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.3. Download and Debug 'Hello World' Example in the SDRAM Memory

  1. Select Run > Debug Configurations.
    Select the same debug configuration.
    Figure 37. Bare Metal "Hello World" Config Debugger
  2. Select Debug to launch.
    Figure 38. Run "Hello World" from SDRAM Stops at Main

    You should notice in the Commands view that the entry point is now S:0x02000000, which is the beginning of the mapped SDRAM.

  3. Click on the “Step Over Source Line” icon or press F6 to see the program counter progress to the next source line.
  4. Click it again to see the "!!!Hello World!!!" message in the App Console view.
    If the App Console view is not currently selected, then the letters are highlighted in bold letters to indicate that there is a message. Select the App Console view to see the output.
    Figure 39. Bare Metal "Hello World" App Console
  5. Select Continue to finish executing the program.
    Figure 40. Bare Metal "Hello World" App Console End
  6. To rerun, select the debug connection from the list in the Debug Control view. In this case, it is “bare-metal-hello-world-01”; and click the yellow arrow.
    This runs the same debug configuration again (and run from Main).
  7. When you are finished with this application, you can disconnect it from the target. To disconnect, right click on the Debug Connection and then click on the “Disconnect from Target”.
    Figure 41. Bare Metal "Hello World" App Console Disconnected
    It is not necessary to remove the disconnected debug connection from the Debug Control view; however, it can be removed since it only needs to run once.
    Note: If you do not remove a disconnected debug connection, then you can re-launch the configuration by selecting it from the Debug Control view and clicking the Connect to Target icon above it.

    Don’t forget that if you reboot the board, then you have to run the Preloader to configure the memory controller before running an application in SDRAM. One quick way to do this is to keep the disconnected debug connection in the Debug Control view; then select it and click on “Connect to Target”. This reproduces the previous launch.

  8. When you are completely finished with this application, you can remove it from the Debug Control view. The connections must be disconnected in order to remove them. To disconnect, select the Debug Connection and then click on the “Disconnect from Target”. Once disconnected you can select “Remove Connection” or “Remove All Connections”.
  9. After removing the Debug Connection from the Debug Control view, rerun the Preloader by using the Debug Configuration that was created for the Preloader. Rerun the demo, using the Debug Configuration that was created for the "Hello World" application.
Level Two Title