Intel® Arria® 10 SoC UEFI Boot Loader User Guide

ID 683536
Date 12/15/2017
Document Table of Contents Configuring and Starting the Debugger in Eclipse

This task describes how to configure your project setting to use Eclipse with the Arm* DS-5* Intel® SoC FPGA Edition debugger.

  1. Connect the mini USB cable from the Intel® Arria® 10 SoC FPGA development board Intel® FPGA Download Cable II port to the PC.
  2. Verify that your JTAG Intel® FPGA Download Cable II can detect the devices. The diagram below shows an example.
    Figure 85. Verifying Device Detection
  3. Start the Eclipse application if it is not yet started. Select Start Menu > All Programs > ARM DS-5 > Eclipse for DS-5 to start Eclipse from the program search window. Alternatively, you can start Eclipse from the Embedded Command Shell window.
  4. The Eclipse tool, part of the Arm* DS-5* Intel® SoC FPGA Edition, prompts for the workspace folder to be used. You can use the suggested folder and click OK.
  5. The Arm* DS-5* Intel® SoC FPGA Edition Welcome screen appears. You can use this screen to access documentation, tutorials and videos.
  6. Select Window > Open Perspective > DS-5 Debug to open the workbench.
    Figure 86. Opening the DS-5 Workbench
  7. Select Run > Debug Configurations... to access the launch configurations.
    Figure 87. Opening Debug Configurations
  8. In the Debug Configuration dialog box left panel, select DS-5 Debugger > New_configuration
    Figure 88. Opening New Configuration
  9. Enter your preferred Name. In the example shown below, the Name text field has an entry of A10_SOC_DEBUG.
    Figure 89. New Configuration Name Text Field
  10. Configure the target to be Altera > Arria 10 SoC > Bare Metal Debug > Debug Cortex-A9_0.
    Figure 90. Configure Target Connection
  11. In the Target Connection pull-down menu, select USB-Blaster connection.
    Figure 91. Select USB Blaster Connection
  12. For the Bare Metal Debug Connection, click Browse… and select USB-BlasterII on localhost [USB-1]:USB-BlasterII USB-1.
    Figure 92. Selecting Bare Metal Debug Connection
  13. Select the Debugger tab and select the Connect only option.
    Figure 93. Connect Only Selection for Run Control
  14. Click the Debug button.
  15. In the DS-5 Debug window, select Import Script….
    Figure 94. Import Script
  16. Browse to your Arm* DS-5* Intel® SoC FPGA Edition script location under Build/load_uefi_fw.ds. In this example, /data/<username>/pggit/uefi-socfpga/Build/load_uefi_fw.ds is selected.
    Figure 95. Browsing to the load_uefi_fw.ds File
  17. Click Open.
  18. Edit your load_uefi_fw.ds file by selecting the pencil icon.
    Figure 96. Editing the load_uefi_fw.ds File
  19. Verify the load_uefi_fw.ds file loads the correct Build/PEI.256 path. If not, edit the path to locate the correct Build/PEI.256 file path. In this example, the PEI.256 file is found at: /data/<username>/pggit/uefisocfpga/Build/PEI.256. Make the following change from the screenshot below:
    Figure 97. Original PEI.256 Path
    To the following path:
    Figure 98. Modified PEI.256 Path
  20. Click Save.
  21. Double-click the load_uefi_fw.ds file to run the updated script.
  22. If you encounter the error messages below, verify that you have edited the load_uefi_fw.ds to the correct path. Proceed to step 24 if you do not see this error.
    Figure 99. Error Message Window
  23. Click Save and double-click the load_uefi_fw.ds file to run the updated script.
  24. Select Window > Show View > App Console to enable the App Console window.
    Figure 100. Enabling the App Console Window
  25. Click the continue green arrow to run the application.
  26. The following content appears in the App Console window:
    Figure 101. App Console Window

    At the same time, pin multiplexing configuration output messages appear on the serial terminal program window.

    Figure 102. Serial Terminal Pin Multiplexing Configuration Output Messages
  27. Use the Outline view to edit and view your source file. If you encounter a "Source Not Found" error, click Set Path Substitution.
    Figure 103. Correcting a "Source Not Found" Error
  28. When the Edit Substitute Path dialog box appears, configure the Host Path to the correct path and click OK.
    Figure 104. Configuring the Host Path