Run a demo using MCUXpresso IDE

Note: Ensure that the MCUXpresso IDE toolchain is included when generating the MCUXpresso SDK package.

This section describes the steps required to configure MCUXpresso IDE to build, run, and debug example applications. The hello_world demo application targeted for the MIMXRT685-EVK hardware platform is used as an example, though these steps can be applied to any example application in the MCUXpresso SDK.

Select the workspace location

Every time MCUXpresso IDE launches, it prompts the user to select a workspace location. MCUXpresso IDE is built on top of Eclipse which uses workspace to store information about its current configuration, and in some use cases, source files for the projects are in the workspace. The location of the workspace can be anywhere, but it is recommended that the workspace be located outside the MCUXpresso SDK tree.

Parent topic:Run a demo using MCUXpresso IDE

Build an example application

To build an example application, follow these steps.

  1. Drag and drop the SDK zip file into the Installed SDKs view to install an SDK. In the window that appears, click OK and wait until the import has finished.

    |

|

  1. On the Quickstart Panel, click Import SDK example(s)….

    |

|

  1. In the window that appears, expand the MIMXRT600 folder and select MIMXRT685S. Then, select evkmimxrt685 and click Next.

    |

|

  1. Expand the demo_apps folder and select hello_world. Then, click Next.

    |

|

  1. Ensure Redlib: Use floating-point version of printf is selected if the example prints floating-point numbers on the terminal. Otherwise, it is not necessary to select this option. Then, click Finish.

    |

|

Parent topic:Run a demo using MCUXpresso IDE

Run an example application

For more information on debug probe support in the MCUXpresso IDE, see community.nxp.com.

To download and run the application, perform the following steps:

  1. See the table in Default debug interfaces to determine the debug interface that comes loaded on your specific hardware platform.

    • For boards with CMSIS-DAP/mbed/DAPLink interfaces, visit developer.mbed.org/handbook/Windows-serial-configuration and follow the instructions to install the Windows operating system serial driver. If running on Linux OS, this step is not required.

    • For boards with a P&E Micro interface, see PE micro to download and install the P&E Micro Hardware Interface Drivers package.

  2. Connect the development platform to your PC via a USB cable.

  3. Open the terminal application on the PC, such as PuTTY or TeraTerm, and connect to the debug serial port number (to determine the COM port number, see How to determine COM port). Configure the terminal with these settings:

    1. 115200 or 9600 baud rate, depending on your board (reference BOARD_DEBUG_UART_BAUDRATE variable in board.h file)

    2. No parity

    3. 8 data bits

    4. 1 stop bit |

|

  1. On the Quickstart Panel, click Debug evkmimxrt685_hello_world [Debug] to launch the debug session.

    |

|

  1. The first time you debug a project, the Debug Emulator Selection dialog is displayed, showing all supported probes that are attached to your computer. Select the probe through which you want to debug and click OK. (For any future debug sessions, the stored probe selection is automatically used, unless the probe cannot be found.)

    |

|

**Note:** If the debug probe is CMSIS-DAP and the debugging application is running in flash, make sure that the board is set to FlexSPI flash boot mode \(ISP2: ISP1: ISP0 = ON, OFF, ON\). Otherwise, you should not set to FlexSPI boot mode when debugging the application. If the debug probe is J-Link, **Reset before running** must be disabled. Double click the `<example> J-Link Debug.launch` file, and deselect this option under **JLink Debugger -\>Additional Options** menu.

|![](../images/figure12_rt600.png "Disabling Reset before running")

|

  1. The application is downloaded to the target and automatically runs to main().

    |

|

  1. Start the application by clicking Resume.

    |

|

The hello_world application is now running and a banner is displayed on the terminal. If not, check your terminal settings and connections.

|

|

Parent topic:Run a demo using MCUXpresso IDE

Build a TrustZone example application

This section describes the steps required to configure MCUXpresso IDE to build, run, and debug TrustZone example applications. The TrustZone version of the hello_world example application targeted for the MIMXRT685-EVK hardware platform is used as an example, though these steps can be applied to any TrustZone example application in the MCUXpresso SDK.

  1. TrustZone examples are imported into the workspace in a similar way as single core applications. When the SDK zip package for MIMXRT685-EVK is installed and available in the Installed SDKs view, click Import SDK example(s)… on the Quickstart Panel. In the window that appears, expand the MIMXRT600 folder and select MIMXRT685S. Then, select evkmimxrt685 and click Next.

    |

|

  1. Expand the trustzone_examples/ folder and select hello_world_s. Because TrustZone examples are linked together, the non-secure project is automatically imported with the secure project, and there is no need to select it explicitly. Then, click Finish.

    |

|

  1. Now, two projects should be imported into the workspace. To start building the TrustZone application, highlight the evkmimxrt685\_hello\_world\_s project (TrustZone master project) in the Project Explorer. Then, choose the appropriate build target, Debug, or Release, by clicking the downward facing arrow next to the hammer icon, as shown in Figure 3. For this example, select the Debug target.

    |

|

The project starts building after the build target is selected. It is requested to build the application for the secure project first, because the non-secure project must know the secure project since CMSE library when running the linker. It is not possible to finish the non-secure project linker when the secure project since CMSE library is not ready.

**Note:** When the **Release** build is requested, it is necessary to change the build configuration of both the secure and non-secure application projects first. To do this, select both projects in the Project Explorer view by clicking to select the first project, then using shift-click or control-click to select the second project. Right click in the Project Explorer view to display the context-sensitive menu and select **Build Configurations** \> **Set Active** \>**Release**. This is also possible by using the menu item of **Project** \> **Build Configuration** \>**Set Active** \>**Release**. After switching to the **Release** build configuration. Build the application for the secure project first.

|![](../images/switching_trustzone_projects_into_release_build_co.jpg "Switching TrustZone projects into the Release build
										configuration")

|

Parent topic:Run a demo using MCUXpresso IDE

Run a TrustZone example application

To download and run the application, perform all steps as described in Section 3.3, “Run an example application”. These steps are common for single core, and TrustZone applications, ensuring evkmimxrt685_hello_world_s is selected for debugging.

In the Quickstart Panel, click Debug evkmimxrt685__hello_world_s [Debug] to launch the second debug session.

|

|

|

|

Now, the TrustZone sesions should be opened. Click Resume. The hello_world TrustZone application then starts running, and the secure application starts the non-secure application during runtime.

|

|

Parent topic:Run a demo using MCUXpresso IDE