Getting Started with JN5189

2.1 Download MCUXpresso SDK with Connectivity Software

MCUXpresso SDK for the JN5189 integrates the MCUXpresso Software Development Kit with all the wireless connectivity stacks required to develop your solution with ZigBee.

Click below to download a pre-configured SDK release for the JN5189 that includes the wireless connectivity ZigBee stack for the JN5189.

Get MCUXpresso SDK

Extract the contents of the download SDK zip and locate the flash programmer installer SDK_X.X.X_JN5189DK6\tools\JN-SW-4401-DK6-Flash-Programmer. Add the installation location to your system path.

2.2 Install Your Toolchain

NXP offers a complimentary toolchain called MCUXpresso IDE.

Get MCUXpresso IDE

2.3 Install Python 3.8

The JN5189 bootloader requires an image signature to verify the validity of a binary image. The image signing tool requires a Python install to exist on the PC. Download and the latest install Python 3.8 and add it to your system path. Then in a terminal window enter pip install pycryptodome to install the library.

Download Python 3.8

The JN5189 Wireless Connectivity Stack comes with a list of demo applications and driver examples ready to be compiled and run.

3.1 Install the SDK

To install the SDK, open MCUXpresso and drag and drop the SDK zip file into the installed SDKs window. Confirm the installation to copy the SDK into the MCUXpresso IDE framework.

3.2 Import SDK Examples

From the quickstart panel, select “Import SDK examples”, select JN5189DK6, click next and choose wireless example of your choice. (Refer to the wireless example’s documentation to find out more information). Then click finish to import the project.

3.3 Build your Project

Build your imported project by selecting “Build” in the quickstart panel. Once complete, a binary file (.bin) will be generated inside the project folder under the folder called “Debug” (the name of the selected build configuration).

3.4 Flash your Device

Open a terminal window in the location of your binary file Your_MCUxpresso_Workspace\Project_Name\Debug. In your terminal window enter:

DK6Programmer -l

To list your connected COM ports. Identify the COM port of your device, then enter:

This will program the board with your newly built binary. Congratualtions!

3.5 Running a Demo Using IAR

The following steps will guide you through compiling, flashing, and running a simple Heart Rate Sensor ZigBee application using the JN5189 board.

Build a ZigBee Application

1. Navigate to the Heart Rate Sensor workspace located at ''\boards\JN5189cdk\wireless_examples\bluetooth\heart_rate_sensor\freertos\iar

   

2. After the workspace is open, select the project

   

3. Click the Make button to build the project

   

Download and Run the Application Demo

1. Connect the first JN5189 board to your PC if it is not already. Use the J2 USB connector on the JN5189

2. Open the terminal application on the PC (such as PuTTY or TeraTerm) and connect to the debug COM port you determined earlier. Configure the terminal with these settings:

   

3. Click the "Download and Debug" button to download the application to the target

   

4. The firmware will be downloaded to the board and then you may see the following message. Check the “Don’t show again” checkbox and then click on the Yes button

   

5. The debugger will then be started. Click on the “Go” button to begin running the demo

   

Run the Heart Rate Sensor Demo

1. Open the NXP IoT Toolbox application on your mobile device and click on the Heart Rate icon

   

2. On the JN5189 board, press Buton1 to begin ZigBee advertising

3. In the smartphone app, you should now see the FSL_HRS name. Click on it

   

4. The board will then connect to the phone, and you’ll see a graph of the random BPM reading

   

3.6 Use Keil MDK

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. In the Pack Installer window, search for “JN” to bring up the JN5189 family. Click on the JN5189 name, and then in the right hand side you’ll see the NXP::JN5189_DFP pack. Click on the “Install” button next to the pack. This process requires an internet connection to successfully complete

3. After the installation finishes, close the Pack Installer window and return to the µVision IDE
4. Build an Example Application

The following steps will guide you through opening the heart_rate_sensor ZigBee demo.

1. Inside the MDK, go to Project→Open Project
2. Navigate to the Heart Rate Sensor workspace located at \boards\JN5189cdk\wireless_examples\bluetooth\heart_rate_sensor\freertos\keil and open the heart_rate_sensor_freertos.uvprojx project

3. To build the demo project, select the "Rebuild" button, highlighted in red

4. The build will complete without errors

Run an Example Application

1. Connect the first JN5189 board to your PC if it is not already. Use the J2 USB connector on the JN5189
2. Click on the Start/Stop Debug Session button to download the code to the board and start debugging it

3. Run the code by clicking the "Run" button to start the application

Run the Heart Rate Sensor Demo

1. Open the NXP IoT Toolbox application on your mobile device and click on the Heart Rate icon

2. On the JN5189 board, press Buton1 to begin ZigBee advertising.
3. In the smartphone app, you should now see the FSL_HRS name. Click on it

4. The board will then connect to the phone, and you’ll see a graph of the random BPM reading

3.7 Running a Demo Using MCUXpresso IDE

The following steps will guide you through opening the hybrid example. This project will be loaded to one board, while another project will be loaded on the 2^nd board.

1. Find the Quickstart Panel in the lower left hand corner

   

2. Then click on Import SDK examples(s)…

   

3. Click on the JN5189 board to select that you want to import an example that can run on that board, and then click on Next

   

4. Now we need to select the project to import. Use the arrow button to expand the wireless_examples category, and then under the bluetooth category expand the heart_rate_sensor project and select the freertos version of project

   This particular project doesn’t make use of the UART, but for projects that do, select the “UART” option for the SDK Debug Console. Then, click on Finish

   

5. Now build the project by clicking on the JN5189cdk_wireless_examples_bluetooth_heart_rate_sensor_freertos project name and then in the Quickstart Panel click on Build

   

6. You can see the status of the build in the Console tab. If you get a compile error, make sure you had imported two projects at the same

   

Download and Run the Application Demo

1. Connect the first JN5189 board to your PC if it is not already. Use the J2 USB connector on the JN5189
2. In the Quickstart Panel click on Debug ‘JN5189cdk_wireless_examples_bluetooth_heart_rate_sensor_freertos’ [Debug]

3. MCUXpresso IDE will probe for connected boards and should find the LPC-LINK2 CMSIS-DAP debug probe that is part of the integrated debug circuit on the JN5189. Click on OK to continue

   

4. You may get the following error. Hit “OK” to dismiss it

   

5. The firmware will be downloaded to the board and the debugger started

   

Run the Heart Rate Sensor Demo

1. Open the NXP IoT Toolbox application on your mobile device and click on the Heart Rate icon

   

2. On the JN5189 board, press Buton1 to begin ZigBee advertising

3. In the smartphone app, you should now see the FSL_HRS name. Click on it

   

4. The board will then connect to the phone, and you’ll see a graph of the random BPM reading

   

4.1 Sensors

Explore the world with a full assortment of NXP sensor solutions. From accelerometers, pressure sensors, touch sensors, and many more, NXP has a sensor solution for your project. Find out more at Sensors.

4.2 NFC

Near Field Communication is a simple, intuitive technology that lets you interact securely with the world around you with a simple touch. Learn more about NXP’s NFC solutions at NFC - Near Field Communication.

Troubleshooting

Did your board come in a box that looks like this?

No problem! Your board simply came in the old packaging and has a different out-of-box demo loaded into the flash memory.

You should be seeing the RGB LED toggling between each of the three colors; red, blue and green. It's OK to move onto the next step when you're ready.

Still not working?

Try proceeding to the next steps to get other example applications running on your board. If you still have problems, try contacting us through the NXP Community.

Forums

Connect with other engineers and get expert advice on designing with JN MCUs and Wireless Connectivity software. Join the community discussion in the Wireless Connectivity Community