Getting Started with KW47-EVK

2.1 MCUXpresso Installer (Recommended)

The MCUXpresso Installer is the recommended starting point for NXP microcontroller unit (MCU) development. It provides a single, streamlined installation process that brings together all the essential tools and components you need to get up and running quickly. Whether you are using Visual Studio (VS) Code, working from the command line with GNU compiler collection GCC or using partner integrated development environment (IDEs) from IAR or Arm (Keil), the installer helps you set up the needed components. Using this resource, you can also find other tools available for use with NXP products.

This installer is ideal for developers who want a ready-to-use environment without manually downloading and configuring multiple packages. We offer the installer for the following operating systems:

1. Run the Installer Double-click the downloaded “MCUxpresso Installer” file to launch the installation wizard.
2. Select “Components” In the component selection screen, choose the features you want to install or update. If you already have some components installed, the wizard will show which ones are up-to-date and which have an update available. The recommended minimum components for this guide are MCUxpresso SDK Developer, ARM GNU Toolchain, Link Server and MCUXpresso Config Tools.
3. Press Install and Complete Setup Click “Install” to start the process. Once installation finishes, you can close the MCUXpresso Installer window to exit.

2.2 MCUXpresso for VS Code

MCUXpresso for VS Code supports NXP MCUs based on Arm® Cortex®-M. It allows developers the flexibility to work on projects from Zephyr, Matter or the MCUXpresso software development kit (SDK.) The VS Code extension organizes relevant information including installed SDK repositories, available debug probes, user projects and links to help you get started:

1. Open VS Code Launch VS Code on your system. VS Code is automatically installed using MCUxpresso Installer under MCUXpresso SDK Developer.
2. Go to Extensions Marketplace Click on the Extensions icon in the left sidebar (or press Ctrl+Shift+X).
3. Search for “MCUXpresso” Type “MCUXpresso,” in the search bar to locate the official extension from NXP.
4. Install the Extension Click “Install.” Once installed, restart VS Code if prompted.

2.3 MCUXpresso SDK

The MCUXpresso SDK is inherently compatible with MCUXpresso for VS Code and also supports example projects for MCUXpresso IDE, IAR Embedded Workbench, Keil microcontroller development kit (MDK) and GCC with CMake + Kconfig. It includes production‑grade software with optional integrated real-time operating system (RTOS), enabling software technologies (stacks and middleware), reference software and more. Partner middleware and software can be integrated through custom west manifests.

The MCUXpresso SDK Developer component in the MCUXpresso Installer will download all required dependencies.

The NXP extension for VS Code allows you to add software repositories from four sources:

• Remote Git URL – Downloads the main repository, including all supported products
• Remote Archive Folder – Downloads an archive package for your chosen development board
• Local Git Repository – Uses an existing local Git repository previously downloaded to your PC
• Local Archive Folder – Uses an archive package previously downloaded from the SDK Builder

This section describes how to import the MCUXpresso SDK using the Remote Archive option:

1. Open the MCUXpresso Extension. Click the MCUXpresso icon in VS Code.
2. Start Import. Go to the “QUICKSTART PANEL” tab and click “Import Repository.” A new import window will appear.
3. Choose Remote Archive Source. Select “Remote Archive” as the source for SDK files.
4. Select Package and Version. Choose the development board and SDK version you intend to use.
5. Set Name and Destination Folder. Select a folder to store SDKs (e.g., “C:\SDK") and enter a name for the SDK (e.g., “mcuxsdk”).
6. Import and Wait. Click “Import” and wait for the process to complete.

2.4 MCUXpresso Config Tool

The MCUXpresso Config Tool is an integrated suite that provides pin, clock, peripheral and trusted environment execution/configuration tools to generate initialization C code for custom board support. it is integrated as a part of MCUXpresso for VS Code and as a separate tool if using a different IDE such as IAR or Keil.

Install it using our MCUXpresso Installer described above:

1. Open MCUXpresso Extension. In VS Code, click the MCUXpresso icon on the Activity Bar on the left side.
2. Launch “Config Tools”. In the “Projects” tab, select and right-click your project, then click “Open Config Tools.”

2.5 MCUXpresso Secure Provisioning Tools

NXP provides two complementary tools for secure programming and device provisioning on MCU devices. Both are fully supported for development and production workflows:

1. Secure Provisioning SEC Graphical User Interface (GUI) Tool: A user-friendly graphical tool for secure programming and provisioning, ideal for both development and mass production. The GUI can be installed using the MCUXpresso Installer. Learn how to create a secure image in just 6 clicks
2. Secure Provisioning Software Development Kit (SPSDK) Command-Line Interface (CLI): An open-source command-line toolkit for automation and integration, fully suitable for development and production workflows.

2.6 Alternative Tools

MCUxpresso for VS Code is recommended for new designs.

Still want to use a different toolchain?

To help you choose the right one, explore the MCUXpresso Suite of Software and Tools.

The MCUXpresso SDK includes support for other tools such as MCUXpresso IDE,IAR ,KEIL  and command-line GCC.

3.1 Build and Flash Application Using MCUXpresso for VS Code IDE

The following steps guide you through the wireless_uart demo application using MCUXpresso for VS Code IDE. But before you get started, you must download the Remote Archive SDK referenced in Section 2.3 of the Get Software step of this guide.

Be aware that it is necessary to work with the matching narrow band unit (NBU) image for the SDK version of the application you are working with. This means that when you download your SDK, prior to loading any wireless SDK example, update your NBU image as described in the following guide: Updating NBU for Wireless Examples.

1. Open Quickstart Panel: Click the MCUXpresso icon in VS Code, then select the "Quickstart Panel" tab.

2. Import Example: Click "Import example from Repository."

3. Select Archive Folder: From the “Repository” dropdown, choose your downloaded archive folder KW47-EVK.

4. Choose Board: From the Board dropdown, choose “KW47-EVK”.

5. Select Template: Select “wireless_uart_bm” from the Template dropdown.

6. Select Freestanding Project and Location: Select the location which the project will be saved on your PC.

7. Choose the Toolchain: Select the latest ARM GNU toolchain available

8. Import: Click “Import”

9. Build the Project: Expand Projects, right-click your project and select “Build Project” (or click the build icon).

10. Connect Board: Plug the board into your PC using the micro-USB cable on the MCU-LINK port.

11. Debug the Project: Right-click the project and select “Debug” (or click the debug icon) to download the app to the board.

12. Open Serial Monitor: In VS Code, open “Serial Monitor,” select “COMx - MCU-Link VCom Port,” set baud rate to 115200, and click “Start Monitoring.”.

13. Run and View Output: Click “Continue” to run the app and view output in the Serial Monitor. Press SW3 button to switch the BLE role to peripheral. Then press SW2 to start BLE Advertising. You should see the messages printed on the terminal

14. Open your NXP's IoT Toolbox app in your smartphone. Select the wireless UART icon. Select the wireless UART commen device. At this point, you should see your device's status as 'Connected' both on the IoT Toolbox app and the serial terminal.

15. Type and send any message on the NXP's IoT Toolbox app.

16. See it displayed on the serial terminal.

17. You can also type and send any message on the serial terminal and see it displayed on the NXP's IoT Toolbox app.

3.2 Build and Flash the Application with Alternative Toolchains

MCUXpresso IDE offers developers an easy-to-use, eclipse-based development environment for legacy NXP MCUs that are based on Arm® Cortex®-M cores. The preferred development environment is MCUxpresso for VSCode. However, MCUXpresso IDE remains fully supported for legacy products and SDKs that require MCUXpresso IDE. For those products that are not supported by MCUXpresso IDE, please refer to the SDK Documentation . Learn how to build and flash an application with MCUXpresso IDE .

Using a different toolchain?

4.1 Modify an SDK Project Using the Config Tools on MCUXpresso for VS Code

The following steps will guide you through the manipulation of a general-purpose input/output (GPIO). The example sets up a GPIO as an LED that toggles on board. Using the config tool, you will change the pin output so that the LED changes color.

1. Select Template: Follow the same steps as the previous section, but this time select “driver_examples/tpm/tpm_pwm_twochannel_cm33_core0” from the Template dropdown

2. Import: Click “Import”

3. Build the Project: Expand Projects, then right-click your project and select “Build Project” (or click the build icon).

4. Connect Board: Plug the board into your PC using the micro-USB cable on the MCU-LINK port.

5. Debug the Project: Right-click the project and select “Debug” (or click the debug icon) to download the app onto the board.

6. Open Serial Monitor: In VS Code, open “Serial Monitor,” select “COMx - MCU-Link VCom Port,” set baud rate to 115200, and click “Start Monitoring.”

7. Run and View Output: Click “Continue” to run the app.

8. View the output in the Serial Monitor. The application will prompt you to enter a number between 0 and 9. This number adjusts the RGB LED brightness by modifying its duty cycle

9. Stop Debug Session: Click on the stop debug session icon

10. Open MCUXpresso Config Tool: Right-click on the project and select “Open” with MCUXpresso Config Tools

11. Filter Pins: In the Pins view, uncheck “Show dedicated pins” and “Show no routed pins” to display only the routed pins (highlighted in green).

12. Enable GREEN LED: Check “Show no routed pins” to view the available options. To enable the GREEN LED, search for PTA19 and select TPM0_CH2, under the "TPM" column.

13. Export Updated Files: Save changes by clicking “Update Code” and the new pin_mux.c and pin_mux.h files will be generated, overwriting the original ones.

14. Update Application Code: In “app.h”, modify macros and configure TMP0 Channel 2 for the GREEN LED:

15. Next, you will add the necessary code to enable TPM0 Channel 2. To edit the tpm_pwm_twochannel.c code, use the following images as reference.

16. Build the Project: Expand Projects, then right-click your project and select “Build Project” (or click the build icon).

17. Debug the Project: Right-click the project and select “Debug” (or click the debug icon) to download the app to the board.

18. Run and View Output: Click “Continue” to run the app and view the GREEN LED and change its brightness.

4.2 Modify a Project Using Config Tools for Alternative Tools

MCUXpresso IDE offers developers an easy-to-use, eclipse-based development environment for legacy NXP MCUs based on Arm® Cortex®-M cores. The preferred development environment is MCUxpresso for VSCode. However, MCUXpresso IDE remains fully supported for legacy products and SDKs that require MCUXpresso IDE. For those products that are not supported by MCUXpresso IDE, please refer to the SDK Documentation . Learn how tomodify a project using the Config Tools in MCUXpresso IDE .

Using a different toolchain?

Check out each of the following sections to learn about the ecosystem provided to you for flexible protyping and development. In the video below, you will be introduced to the FRDM platform, the full-featured evaluation kit (EVK) and the compatible shields for extended capabilities. In addition, you will be guided through our Application Code Hub (ACH) portal where you will be provided numerous application examples through NXP's GitHub.

5.1 FRDM Platform, Full feature EVK and Shields

For quick prototyping platforms, we offer both the low-cost FRDM platform and the full-featured EVK.

FRDM Development Boards come with standard form factor and headers, easy access to MCU I/Os, on-board MCU-Link debugger and a USB-C cable. Our full-featured EVKs include extended I/O and interface access, extendable with WiFi and additional MCU-Link features.

There are also many compatible Click Board and/or Arduino shields. For those that are supported with an Open Cortex®-microcontroller software interface standard (CMSIS) Pack, examples may be available in the ACH. However, this is not the case if not many of them are easy to use via serial interface such as inter-integrated circuit (I2C), serial peripheral interface (SPI) or universal asynchronous receiver/transmitter (UART), for which we provide drivers with examples in the MCUXpresso SDK.

5.2 Application Code Hub

The ACH further enhances our MCUXpresso Developer Experience by giving developers an interactive dashboard to quickly locate software. Explore the ACH  today to discover additional details and the benefits of the new interactive Application Code Hub.

Software accessible from ACH is located in NXP’s GitHub repository  where it can be easily accessed and cloned directly from that location.

5.3 Demo Walkthrough

The following demo walks you through importing a project from ACH using a system based on the FRDM platform with a motor-control shield and a low-cost LCD. Although your evaluation board may differ from this system, the following steps can be replicated and used accordingly for all supported platforms.

5.4 FreeMASTER Run-Time Debugging Tool

FreeMASTER is a user‑friendly, real‑time debug monitor and data visualization tool that enables runtime configuration and tuning of embedded software applications. It supports non‑intrusive monitoring of variables on a running system and can display multiple variables on oscilloscope‑like views, standard widgets (gauges, sliders and more) or in text form, offering simple‑to‑use data recorders.

MCUXpresso Installer provides the FreeMASTER component for easy download and update.

5.5 GUI Guider

GUI Guider's drag-and-drop editor makes it easy to utilize the many features of the light and versatile graphics library (LVGL) such as widgets, animations and styles to create a GUI with minimal to no coding. It is a user-friendly GUI development tool from NXP that enables the rapid development of high-quality displays using the open-source LVGL.

MCUxpresso Installer offers the GUI Guider component that you can easily download and update.

Board Documents

• Board User Guide
• Hardware Design Guides
• Errata Mask 3P57k

Additional References

• MCUXpresso for VS Code documentation
• MCUXpresso SDK documentation
• Zephyr Knowledge Hub
• Resources for Zephyr
• Software Documentation
• Software Installer
• MCUXpresso Installer
• Getting Started with MCUXpresso SDK
• MCUXpresso SDK API Reference
• MCUXpresso SDK Builder
• MCU-Link FW
• Secure Provisioning Tool User Guide
• SPSDK Wiki