NXP S32K1xx - Application debug with PEmicro OCD on Windows

From ERIKA WIKI
Revision as of 12:29, 10 September 2018 by G.serano (talk | contribs) (→‎PEmicro Eclipse Plugin Configuration)
Jump to: navigation, search

Synopsys

This guide illustrates how to run and debug an ERIKA Enterprise v3 application for S32K144EVB or S32K148EVB boards:

  • Using the Eclipse environment with integrated debugger support (PEmicro OCD).

Prerequisites

Additional information on prerequisites is available at the Quick Start Guide - Prerequisites.

PEmicro Eclipse Plugin Download

Figure 1:PEmicro GDB Server for ARM devices.
  • Scroll down the entire page and click the PEmicro GDB Server for ARM devices - Eclipse Plugin link to download PEmicro Eclipse Plugin as shown in the following figure:
Figure 2: PEmicro GDB Server for ARM devices - Eclipse Plugin.
  • You have to insert your e-mail address into required form to reveive the download link.
  • Save the downloaded PEmicro Eclipse Plugin as you want into file-system.
  • Currently the PEmicro Eclipse Plugin file name is com.pemicro.debug.gdbjtag.pne.updatesite-3.0.9-SNAPSHOT.zip

PEmicro Eclipse Plugin Installation

  • Run RT-Druid v3 Eclipse IDE as shown in the following figure:
Figure 3: RT-Druid v3 Eclipse IDE
  • Click on Help->Install New Software... menu entry as shown in the following figure:
Figure 4: Install New Software...
  • The Available Software dialog will open as shown in the following figure:
Figure 5: Available Software.
  • Click on the Add... button to open the Add Repositoryas shown in the following figure:
Figure 6: Add Repository.
  • Click on Archive... button and select the previously downloaded PE Micro Eclipse Plugin (e.g. com.pemicro.debug.gdbjtag.pne.updatesite-3.0.9-SNAPSHOT.zip) package as shown in the following figure:
Figure 7: PE Micro Eclipse Plugin package selection.
  • Click on the Add button to confirm the PEmicro Eclipse Plugin package selection as shown in the following figure:
Figure 8: PE Micro Eclipse Plugin selection.
  • Click on the PEMicro Software check-box to select the PEmicro Eclipse Plugin to install.
  • Click on the Next > button to let the 'plugin requirements and dependencies calculation' process starts as shown in the following figure:
Figure 9: PE Micro Eclipse Plugin requirements and dependencies calculation.
  • Once the 'plugin requirements and dependencies calculation' process ends, the Installation Details dialog is opened as shown in the following figure:
Figure 10: PE Micro Eclipse Plugin installation details.
  • Click on the Next > button to open the Review Licenses dialog as shown in the following figure:
Figure 11: PE Micro Eclipse Plugin license review.
  • Click on the I accept the terms of the license agreements radio-button to accept the license terms.
  • Finally click on the Finish button to start the installation process as shown in the following figure:
Figure 12: PE Micro Eclipse Plugin installation.
  • Once the installation process ends, the Software Updates dialog will appear as shown in the following figure:
Figure 13: RT-Druid Eclipse restart.
  • Click on the Restart Now button to restart the RT-Druid Eclipse IDE.

PEmicro Eclipse Plugin Configuration

  • Instatiate and build an Erika 3 application as shown in the following figure:
Figure 14: Erika 3 application built.
  • Click on Run->Debug Configurations... menu entry as shown in the following figure:
Figure 15: Debug Configurations...
  • The Debug Configuration dialog window will open as shown in the following figure:
Figure 16: New Debug Configuration
  • Select GDB PEmicro Interface Debugging entry from the left panel and click on the New lauch configuration button as shown in the previous figure.
  • A New_configuration entry will be created as child of GDB PEmicro Interface Debugging entry in the left panel as shown in the following figure:
Figure 17: New Debug Configuration Entry
  • Fill the configuration Name field (e.g. S32K144Event).
  • Use the Browse... button to select the Project (e.g. S32K144Event)
  • Use the Browse... button to select the C/C++ Application to debug (e.g. C:\Evidence\Erika3\RT-Druid\CoMeS\ws\S32K144Event\out\erika3app.elf)
  • Then click on the Debugger tab-sheet to configure the PEmicro Debugger interface as shown in the following figure:
Figure 18: PEmicro Debug Configuration
  • Use Select Device button to select the device to debug (e.g. S32K144F512M15 from NXP/S32K1xx folder).
  • Scroll-down the Debugger tab-sheet to configure the GDB client as shown in the following figure:
Figure 19: GDB Client Configuration
  • Use the Browse... button to select the GDB Client Executable (e.g C:\Program Files (x86)\GNU Tools ARM Embedded\4.9 2015q3\bin\arm-none-eabi-gdb.exe)
  • Click on the "Apply" button to confirm the settings.

Embedded Systems Register View Eclipse Plugin

  • Click on Help->Install New Software... menu entry as shown in the following figure:
Figure 4: Install New Software...
  • The Available Software dialog will open as shown in the following figure:
Figure 5: Available Software.
  • Click on the Add... button to open the Add Repositoryas shown in the following figure:
Figure 6: Add Repository.
  • Click on Archive... button and select the previously downloaded PE Micro Eclipse Plugin (e.g. com.pemicro.debug.gdbjtag.pne.updatesite-3.0.9-SNAPSHOT.zip) package as shown in the following figure:
Figure 7: PE Micro Eclipse Plugin package selection.
  • Click on the Add button to confirm the PEmicro Eclipse Plugin package selection as shown in the following figure:
Figure 8: PE Micro Eclipse Plugin selection.
  • Click on the PEMicro Software check-box to select the PEmicro Eclipse Plugin to install.
  • Click on the Next > button to let the 'plugin requirements and dependencies calculation' process starts as shown in the following figure:
Figure 9: PE Micro Eclipse Plugin requirements and dependencies calculation.
  • Once the 'plugin requirements and dependencies calculation' process ends, the Installation Details dialog is opened as shown in the following figure:
Figure 10: PE Micro Eclipse Plugin installation details.
  • Click on the Next > button to open the Review Licenses dialog as shown in the following figure:
Figure 11: PE Micro Eclipse Plugin license review.
  • Click on the I accept the terms of the license agreements radio-button to accept the license terms.
  • Finally click on the Finish button to start the installation process as shown in the following figure:
Figure 12: PE Micro Eclipse Plugin installation.
  • Once the installation process ends, the Software Updates dialog will appear as shown in the following figure:
Figure 13: RT-Druid Eclipse restart.
  • Click on the Restart Now button to restart the RT-Druid Eclipse IDE.

PEmicro Debugger Configuration

  • Click on the Window->Preferences menu entry as shown in the following figure:
Figure 9: RT-Druid Eclipse Preferences.
  • The RT-Druid Eclipse Preferences window will open as shown in the following figure:
Figure 10: RT-Druid Eclipse Preferences OIL.
  • Click the Generator Properties entry in the OIL section of the left panel to show the RT-Druid Generator Properties to configure.
  • Double-click on the ARM GCC Compiler property to configure the MPLAB XC16 C Compiler installation path as shown in the following figure:
Figure 11: RT-Druid ARM GCC Compiler Path Property.
  • Browse the file-system to select the ARM GCC Compiler path (E.g. C:\Program Files (x86)\GNU Tools ARM Embedded\4.9 2015q3) and then click the OK button.
  • Double-click on the S32 SDK property to configure the S32 SDK installation path as shown in the following figure:
Figure 12: RT-Druid S32 SDK Path Property.
  • Browse the file-system to select the S32 SDK path (E.g. C:\NXP\S32DS_ARM_v2.0\S32DS\S32SDK_S32K14x_EAR_0.8.4) and then click the OK button.
  • Double-click on the Lauterbach TRACE32 property to configure the Lauterbach TRACE32 installation path as shown in the following figure:
Figure 13: RT-Druid Lauterbach TRACE32 Path Property.
  • Browse the file-system to select the Lauterbach TRACE32 path (E.g. C:\T32) and then click the OK button.
  • Double-click on the Lauterbach interface USB property to configure the Lauterbach Hardware Emulator interface as shown in the following figure:
Figure 14: RT-Druid Lauterbach interface USB Property.
  • Set correct value according to you Hardware Emulator interface and then click the OK button.
  • Finally, click the OK button to confirm the configuration properties as shown in the following figure:
Figure 15: RT-Druid Configured Properties.

ERIKA application debug using PEmicro OCD

  • Right-Click on EE3s32k148 project into Eclipse Project Explorer panel and click on Clean Erika context-menu entry as shown in the following figure:
Figure 16: Erika Clean.
  • The Clean up Erika Files dialog window will appear as shown in the following figure:
Figure 17: Clean up Erika Files.
  • Click on the Yes button to clean the whole ERIKA distribution.

NOTE: the distribution folder will be automatically regenerated if the flag Build Automatically is enabled.

Figure 18: Build automatically flag.

NOTE: this operation may be necessary every time an ERIKA or RT-Druid configuration property is modified.

Embedded Systems Register View Configuration

  • Right-click on EE3s32k148 project into Eclipse Project Explorer panel and click on Build Project context-menu entry as shown in the following figure:
Figure 19: Erika project build.
  • The build process starts as shown in the following figure:
Figure 20: Erika build process.
  • The build process ends successfully as shown in the following figure:
Figure 21: Erika build successfully.

Additional Notes

T.B.D.

Retrieved from "http://www.erika-enterprise.com/wiki/index.php?title=NXP_S32K1xx_-_Application_debug_with_PEmicro_OCD_on_Windows&oldid=988"