Run a demo using Keil MDK/μVision

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

Install CMSIS device pack

After the MDK tools are installed, Cortex Microcontroller Software Interface Standard (CMSIS) device packs must be installed to fully support the device from a debug perspective. These packs include things such as memory map information, register definitions, and flash programming algorithms. Follow these steps to install the appropriate CMSIS pack.

1. Open the MDK IDE, which is called μVision. In the IDE, select the Pack Installer icon.

   

2. After the installation finishes, close the Pack Installer window and return to the μVision IDE.

Parent topic:Run a demo using Keil MDK/μVision

Build an example application

1. Open the desired example application workspace in:

   <install_dir>/boards/<board_name>/*<example\_type\>*/<application_name>/mdk
   

   The workspace file is named as <demo_name>.uvmpw. For this specific example, the actual path is:

   <install_dir>/boards/mcxn9xxevk/demo_apps/hello_world/mdk/hello_world.uvmpw
   

2. To build the demo project, select Rebuild, highlighted in red.

   

3. The build completes without errors.

Parent topic:Run a demo using Keil MDK/μVision

Run an example application

To download and run the application, perform these steps:

1. See Table 1 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 P&E Micro interfaces, visit www.pemicro.com/support/downloads_find.cfm and download the P&E Micro Hardware Interface Drivers package.

   • If using J-Link either a standalone debug pod or OpenSDA, install J-Link software (drivers and utilities) from https://www.segger.com/downloads/jlink/.

   • If using J-Link either a standalone debug pod or J-link firmware programmed into the on-board debug probe, install the J-Link software (drivers and utilities) from https://www.segger.com/downloads/jlink/.

   • For boards with the OSJTAG interface, install the driver from https://www.keil.com/download/.

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

3. Open the terminal application on the PC, such as PuTTY or TeraTerm, and connect to the debug COM port (to determine the COM port number, see How to determine com port. Configure the terminal with the MCX-N9XX-EVK settings:

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

   2. No parity

   3. 8 data bits

   4. 1 stop bit

4. In μVision, click the Download and Debug button to download the application to the target.

   

5. The application is then downloaded to the target and automatically runs to the main() function.

   

6. Run the code by clicking the Go button.

   

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

   

Parent topic:Run a demo using Keil MDK/μVision

Build a TrustZone example application

This section describes the particular steps that need to be done in order to build and run a TrustZone application. The demo applications workspace files are located in this folder:

<install_dir>/boards/<board_name>/trustzone_examples/<application_name>/<core_type>/iar/<application_name>_ns/iar

<install_dir>/boards/<board_name>/trustzone_examples/<application_name>/<core_type>/iar/<application_name>_s/mdk

Begin with a simple TrustZone version of the Hello World application. The TrustZone Hello World Keil MSDK/μVision

workspaces are located in this folder:

<install_dir>/boards/mcxn9xxevk/trustzone_examples/hello_world/cm33_core0/hello_world_ns/mdk/
hello_world_ns.uvmpw

<install_dir>/boards/mcxn9xxevk/trustzone_examples/hello_world/cm33_core0/hello_world_s/mdk/
hello_world_s.uvmpw

<install_dir>/boards/mcxn9xxevk/trustzone_examples/hello_world/cm33_core0/hello_world_s/mdk/hello_world.uvmpw

This project hello_world.uvmpw contains both secure and non-secure projects in one workspace and it allows the user to easily transition from one project to another.

Build both applications separately by clicking Rebuild. It is requested to build the application for the secure project first, because the non-secure project needs to know the secure project since CMSE library is running the linker. It is not possible to finish the non-secure project linker with the secure project because CMSE library is not ready.

Parent topic:Run a demo using Keil MDK/μVision

Run a TrustZone example application

The secure project is configured to download both secure and non-secure output files so debugging can be fully managed from the secure project.

To download and run the TrustZone application, switch to the secure application project and perform steps as described in Run an example application. These steps are common for single core, dual-core, and TrustZone applications in μVision. After clicking Download and Debug, both the secure and non-secure image are loaded into the device flash memory, and the secure application is executed. It stops at the function.

Run the code by clicking Run to start the application.

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

Parent topic:Run a demo using Keil MDK/μVision