Getting Started with FRDM KW019032 Evaluation Board

2. Build a Demo Application

The KSDK demo applications are built upon the software building blocks provided in the Kinetis SDK platform library, built in the previous section. If the platform library is not present, the linker displays an error indicating that it cannot find the library. An easy way to check whether the library is present is to expand the Output folder in the ksdk_platform_lib project. If the platform library binary is not built and present, follow the steps on page 1 to build it. Otherwise, continue with the following steps to build the desired demo application.

1. If not already done, open the desired demo application workspace (*.eww file). This example's workspace file is located in:

   /examples/frdmkl43z/demo_apps/hello_world/iar

2. Select the desired build target from the drop-down. For this example, select the "hello_world - Debug" target.

   

3. To build the demo application, click the "Make" button, highlighted in red below.

   

4. The build will complete without errors.

3. Run a Demo Application

The FRDM-KL43Z board comes loaded with the PE micro debug interface from the factory. If you have changed the debug OpenSDA application on your board, visit http://www.nxp.com/opensda for information on updating or restoring your board to the factory state.

1. Connect the development platform to your PC via USB cable between the "SDAUSB" USB port on the board and the PC USB connector.

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:

   • 115200 baud rate
   • No parity
   • 8 data bits
   • 1 stop bit

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

   

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

   

5. Run the code by clicking the "Go" button to start the application.

   

6. 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.

   

These steps show how to:

1. Build the platform libraries required by the application demo

2. Build the demo application.

3. Download and run the demo application.

The example used below is for the SMAC Connectivity Test demo, but these steps can be applied to any of the Wireless Connectivity demo applications.

1. Build the platform library

1. Open the "Connectivity_Test.eww" IAR workspace.

   \KW40Z_Connectivity_Software_ \ConnSw\examples\smac\ Connectivity_Test\usbkw40z\FreeRTOS\build\iar\Connectivity_Test.eww

   

2. After the workspace is open, some projects are shown: One for the KSDK platform library and one for the demo application. Build ALL the required KSDK libraries by right clicking on the SDK projects and click on 'Make'.

   

2. Build the application demo

1. Select and build the "Connectivity_Test - Debug" project.

   

   Note: If you select another project, don't forget to build the required KSDK libraries for that project.

3. Download and Run the application demo

1. Connect your FRDM-KW019032 board to your PC.

2. Open a Terminal Emulator program and open a session to your FRDM-KW019032 COM port. Configure the terminal with these settings:

   • 115200 baud rate
   • No parity
   • 8 data bits
   • 1 stop bit

3. Click on "Download and Debug" icon to flash the board.

   

4. The following output will be displayed.

   

   If you don't see this output, verify your terminal settings and connections.

5. Refer to \KW01_Connectivity_Software_v1.0.0\ConnSw\doc\MKW01SMACDAUG.pdf – "KW01 Simple Media AccessController (SMAC) Demonstration Applications" document for instructions on how to run all the demo applications.

These steps show how to:

1. Build the platform libraries required by the application demo.

2. Build the demo application.

3. Download and run the demo application.

The example used below is for “MyWirelessApp” application demo (Coordinator), but these steps can be applied to any of the Wireless Connectivity demo applications.

1. Build the platform library

1. Open the "MyWirelessAppCoordinator.eww" IAR workspace.

   \KW01_Connectivity_Software_v1.0.0\ConnSw\examples\ieee_802_15_4\MyWirelessApp\Coordinator\frdmkw019032\FreeRTOS\build\iar\MyWirelessAppCoordinator.eww

   \ieee_802_15_4\MyWirelessApp\Coordinator\usbkw40z\FreeRTOS\build\iar\MyWirelessAppCoordinator.eww

   

2. After the workspace is open, some projects are shown: One for the KSDK platform library and one for the demo application. Build ALL the required KSDK libraries by right clicking on the SDK projects and click on 'Make'.

   

2. Build the application demo

1. Select and build the "MyWirelessAppCoordinator - Debug" project.

   

   Note: If you select another project, don’t forget to build the required KSDK libraries for that project.

3. Download and Run the application demo

1. Connect your FRDM-KW019032 board to your PC.

2. Open a Terminal Emulator program and open a session to your FRDM-KW019032 COM port. Configure the terminal with these settings:

   • 115200 baud rate
   • No parity
   • 8 data bits
   • 1 stop bit

3. Click on "Download and Debug" icon to flash the board.

   

4. The following output will be displayed

   

   If you don't see this output, verify your terminal settings and connections.

5. Repeat all steps with "MyWirelessApp" End Device demo application to communicate with this device.
6. Refer to \KW01_Connectivity_Software_v1.0.0\ConnSw\doc\802154MPDAUG.pdf – "NXP 802.15.4 Media Access Controller (MAC) Demo Applications" document for instructions on how to run all the demo applications.

These steps show how to:

1. Build the platform libraries required by the application demo.

2. Build the demo application.

3. Download and run the demo application.

The example used below is for the heart rate sensor demo, but these steps can be applied to any of the Wireless Connectivity demo applications.

1. Build the platform library

1. Open the "heart_rate_sensor.eww" IAR workspace.

   \KW40Z_Connectivity_Software_ \ConnSw\examples

   \bluetooth\heart_rate_sensor\usbkw40z\FreeRTOS\build\iar\heart_rate_sensor.eww

   

2. After the workspace is open, some projects are shown: One for the KSDK platform library and one for the demo application. Build ALL the required KSDK libraries by right clicking on the SDK projects and click on 'Make'.

   

2. Build the application demo

1. Select and build the "heart_rate_sensor - Debug" project.

   

   Note: If you select another project, don’t forget to build the required KSDK libraries for that project.

3. Download and Run the application demo

1. Connect your USB-KW40Z board to your PC.

2. Right click on the "heart_rate_sensor - Debug" project and select "Set as Active"

3. Click on "Download and Debug" icon to flash the board.

   

4. Press "Stop Debugging" button.

   

5. Unplug and plug again the USB to your PC. LEDs labeled as D2 and D3 in the USB will start blinking.

6. Press SW1 of the USB-KW40Z, LED D2 will start blinking indicating that the board is in advertising/discoverable mode.

7. Please, see section 3.3 How to play with the Bluetooth Low Energy Connectivity Demos? to learn how to play with the app.

8. Refer to \KW40Z_Connectivity_Software_ \ConnSw\doc\BLEDAUG.pdf – "Bluetooth Low Energy (BLE) Demo Applications User's Guide" document for instructions on how to run all the demo applications.

These steps show how to:

1. Build the platform libraries required by the application demo.

2. Build the demo application.

3. Download and run the demo application.

The example used below is for “dual_mode_demo”, but these steps can be applied to any of the Wireless Connectivity demo applications.

1. Build the platform library

1. Open the "dual_mode_demo.eww" IAR workspace.

   \KW40Z_Connectivity_Software_ \ConnSw\examples\hybrid\

   ble_802_15_4_dual_mode_demo\usbkw40z\bare_metal\build\iar\dual_mode_demo.eww

   

2. After the workspace is open, some projects are shown: One for the KSDK platform library and one for the demo application. Build ALL the required KSDK libraries by right clicking on the SDK projects and click on 'Make'.

   

2. Build the application demo

1. Select and build the "dual_mode_demo – dual_mode_debug_BM -Debug" project.

   

   Note: If you select another project, don’t forget to build the required KSDK libraries for that project.

3. Download and Run the application demo

1. Connect your USB-KW40Z board to your PC

2. Right click on the " dual_mode_demo – dual_mode_debug_BM -Debug " project and select "Set as Active".

3. Click on "Download and Debug" icon to flash the board.

   

4. Open a Terminal Emulator program and open a session to your USB-KW40Z COM port.

   Configure the terminal with these settings:

   • 115200 baud rate
   • No parity
   • 8 data bits
   • 1 stop bit

5. Press "Go" button.

   

6. The following output will be displayed in the serial terminal.

   

   If you don't see this output, verify your terminal settings and connections.

7. Now unplug the first board, and plug in the other USB-KW40Z.

8. Program a second USB-KW40Z with the "MyWirelessApp" End Device demo application which can be found at \KW40Z_Connectivity_Software_\ConnSw\examples\ieee_802_15_4\MyWirelessApp\EndDevice\usbkw40z\FreeRTOS\build\iar\MyWirelessAppEndDevice.eww using the same steps as above.

9. Close any open terminal windows, then power cycle both boards, and with both boards plugged into your computer, open up a terminal window for each board.

10. Press SW1 on the Coordinator board, and then press SW1 on the board programmed with the EndDevice application, and wait for them to connect.

11. Once connected, type into the terminal of either of the boards, and you will see the text print out on the other board.

12. Use the Kinetis BLE Toolbox mobile application to play with the BLE part of this demo, which correspond to a Heart Rate Sensor. Please, see section 3.3 How to play with the Bluetooth Low Energy Connectivity Demos? to learn how to play with the app.

13. Refer to \KW40Z_Connectivity_Software_ \ConnSw\doc\BLEDAUG.pdf – "Bluetooth Low Energy (BLE) Demo Applications User's Guide" document for instructions on how to run all the demo applications.

These steps show how to:

1. Configure Kinetis Protocol Analyzer Adapter and Wireshark Network Analyzer.

2. Sniff IEEE 802.15.4 wireless applications.

1. Configure Kinetis Protocol Analyzer and Wireshark Network Analyzer

1. Open the "Kinetis Protocol Analyzer Adapter".

   

2. Make sure, you have USB-KW40Z connected to your PC when opening Kinetis Protocol Analyzer Adapter, it will start looking for Kinetis sniffer hardware. Once USB-KW40Z is detected, KW40Z device will be displayed.

   

3. Click on the Wireshark icon to open Wireshark Network Protocol Analyzer.

   
   

4. Wireshark Network Analyzer will be opened. On the "Capture" option of the main window, select the Local Area Connection that was created by the Kinetis Protocol Analyzer, in this example, Kinetis Protocol Analyzer created "Local Area Connection 2", then click "Start" button.

   
   

5. "Capture" window will be opened.

6. Select the desired IEEE 802.15.4 channel to scan in the Kinetis Protocol Analyzer Adapter window. In this guide, we are going to select channel 19 as an example.

   

7. USB-KW40Z will start to sniff and upcoming data will be displayed in the "Capture" window of the Wireshark Network Protocol Analyzer.

   
   

8. Refer to the "Kinetis Protocol Analyzer Adapter User's Guide" for more information about how to enable other features of your USB-KW40Z sniffer. Document can be found in the next path: \Kinetis Protocol Analyzer Adapter\Kinetis Protocol Analyzer Adapter User's Guide.pdf

These steps show how to:

1. Configure Kinetis Protocol Analyzer Adapter and Wireshark Network Analyzer.

2. Sniff BLE wireless applications.

1. Configure Kinetis Protocol Analyzer and Wireshark Network Analyzer

1. Open the "Kinetis Protocol Analyzer Adapter".

   

2. Make sure, you have USB-KW40Z connected to your PC when opening Kinetis Protocol Analyzer Adapter, it will start looking for Kinetis sniffer hardware. Once USB-KW40Z is detected, KW40Z device will be displayed.

   

3. Click on the Wireshark icon to open Wireshark Network Protocol Analyzer.

   
   

4. Wireshark Network Analyzer will be opened. On the "Capture" option of the main window, select the Local Area Connection that was created by the Kinetis Protocol Analyzer, in this example, Kinetis Protocol Analyzer created "Local Area Connection 2", then click "Start" button.

   
   

5. "Capture" window will be opened.

6. Select the desired advertising channel to scan in the Kinetis Protocol Analyzer Adapter window. In this guide, we are going to select All option to start sniffing on all advertising channels (37, 38 and 39). However, you could select different advertising channels of interest to sniff.

   

7. Address Filter is selected in this guide, hence, only data upcoming from the specified address will be displayed on the "Capture" window. If you are not interested on following any specific address, you can provide a Hopping interval to sniff any device in the advertising channels.

8. USB-KW40Z will start to sniff and upcoming data will be displayed in the "Capture" window of the Wireshark Network Protocol Analyzer.

   
   

9. Refer to the "Kinetis Protocol Analyzer Adapter User's Guide" for more information about how to enable other features of your USB-KW40Z sniffer. Document can be found in the next path: \Kinetis Protocol Analyzer Adapter\Kinetis Protocol Analyzer Adapter User's Guide.pdf

This document describes how to update or program a new application in the USB-KW40Z using J-Link debugger.

USB-KW40Z contains two MCUs that need to be programmed depending on the desired use case. Hence, USB-KW40Z contains two connectors to program the board. These connectors are shown in the figure 1 as "SWD MKW40Z" and "JTAG MK22F".

Figure 1. USB-KW40Z Hardware

When an application needs to be programmed in the MK22FN512 MCU, "JTAG MK22F" connector is used. Different from this, "SWD MKW40Z" connector is used when programming KW40Z device. In order to be able to program an application to the USB-KW40Z using JLink, ".bin" files are needed because it is the format that JLink application requires in order to be able to program a board. Please, follow the next steps to program USB-KW40Z.

1. Locate the .bin file that need to be programmed in the USB-KW40Z. In this case, this file is the one downloaded from the "Getting Started" web page.

2. Go to JLink installation path. (i.e. "C:\Program Files (x86)\SEGGER\JLink_V502")

3. Copy and paste the ".bin" file into the JLink installation path. Just as an example, in this document, a file called "usb-kw40z_cmsis-dap.bin" for the MK22FN512 MCU will be used.

4. Make sure that Jlink debugger is connected to the corresponding JTAG MK22F connector (J6) in the USB-KW40Z.

   

   Figure 2. JLink debugger connected to JTAG MK22F connector

5. Go the JLink installation path, and then open the application "JLink". Windows shown in figure 3 will be displayed.

   

   Figure 3. JLink application

6. Call the next instructions in next order:

   1. unlock kinetis

   2. device mk22fn512xxx12

   3. loadbin usb-kw40z_cmsis-dap.bin 0

7. One important thing to note in the step 6 is the "loadbin" command. The name of the file to be programmed in the MCU is specified in this command. In this case, "usb-kw40z_cmsis-dap.bin" is used as an example for this document.

8. A success or "O.K." message should be displayed in the window once the binary file is downloaded.

9. Disconnect and reconnect the board.

10. Now, an application to the K22F MCU was successfully downloaded.

These steps show how to:

1. Build the platform libraries required by the application demo.
2. Build the demo application.
3. Download and run the demo application.

The example used below is for "MyWirelessApp" application demo, but these steps can be applied to any of the Wireless Connectivity demo applications.

1. Build the platform library
   1. Open the "MyWirelessAppCoordinator.eww" IAR workspace.

   \KW01_Connectivity_Software_v1.0.0\ConnSw\examples\ieee_802_15_4\MyWirelessApp\Coordinator\frdmkw019032\FreeRTOS\build\iar\MyWirelessAppCoordinator.eww

   
   2. After the workspace is open, some projects are shown: Some for the KSDK platform libraries and one for the demo application. Build ALL the required KSDK libraries by right clicking on the SDK projects and click on 'Make'.
   
2. Build the application demo
   1. Select and build the "MyWirelessAppCoordinator – Debug" project.
   

   Note: If you select another project, don't forget to build the required KSDK libraries for that project.

3. Download and Run the application demo
   1. Connect your FRDM-KW019032 board to your PC.
   2. Open a Terminal Emulator program and open a session to your FRDM-KW019032 COM port. Configure the terminal with these settings:
      • 115200 baud rate
      • No parity
      • 8 data bits
      • 1 stop bit
   3. Click on "Download and Debug" icon to flash the board.
   
   4. The following output will be displayed
   

   If you don't see this output, verify your terminal settings and connections.

   5. Repeat all steps with "MyWirelessApp" End Device demo application to communicate with this device.
   6. Refer to \KW01_Connectivity_Software_v1.0.0\ConnSw\doc\802154MPDAUG.pdf – "NXP 802.15.4 Media Access Controller (MAC) Demo Applications" document for instructions on how to run all the demo applications.

1. Connect your USB-KW019032 to your PC, MBED (E:) will be detected.

2. Drag and drop the Sniffer_usbkw01_US.bin to MBED (E:) using the MSD capabilities of the CMSIS-DAP.



3. MBED (E:) will blink, disconnect the board, connect it again and the new firmware will start to run in the KW01.