Freescale Semiconductor MQX RTOS User manual

Freescale Semiconductor Document Number: MQXGSIAR
User’s Guide Rev. 5, 04/2015
© 2015 Freescale Semiconductor, Inc. All rights reserved.
Getting Started with
Freescale MQX™ RTOS and IAR
Embedded Workbench®
PRODUCT:
Freescale MQX™ RTOS
PRODUCT VERSION:
4.2.0
DESCRIPTION:
Using IAR Embedded Workbench Tools with Freescale MQX™ RTOS
RELEASE DATE:
April, 2015

Document Number: MQXGSIAR
Rev. 05, 04/2015
How to Reach Us:
Home Page:
www.freescale.com
Web Support:
http://www.freescale.com/support
Information in this document is provided solely to enable system and software
implementers to use Freescale products. There are no express or implied copyright
licenses granted hereunder to design or fabricate any integrated circuits based on
the information in this document.
Freescale reserves the right to make changes without further notice to any products
herein. Freescale makes no warranty, representation, or guarantee regarding the
suitability of its products for any particular purpose, nor does Freescale assume any
liability arising out of the application or use of any product or circuit, and specifically
disclaims any and all liability, including without limitation consequential or incidental
damages. “Typical” parameters that may be provided in Freescale data sheets
and/or specifications can and do vary in different applications, and actual
performance may vary over time. All operating parameters, including “typicals,”
must be validated for each customer application by customer’s technical experts.
Freescale does not convey any license under its patent rights nor the rights of
others. Freescale sells products pursuant to standard terms and conditions of sale,
which can be found at the following address:
freescale.com/SalesTermsandConditions.
Freescale, the Freescale logo, and CodeWarrior are trademarks of Freescale
Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off. Vybrid and Tower are
trademarks of Freescale Semiconductor, Inc. All other product or service
names are the property of their respective owners. ARM, ARM Powered logo,
and Cortex are registered trademarks of ARM Limited (or its subsidiaries) in
the EU and/or elsewhere. All rights reserved.
© 2008-2015 Freescale Semiconductor, Inc.

Getting Started with Freescale MQX™and IAR Embedded Workbench®, Rev. 5, 04/2015
Freescale Semiconductor 1
Table of Contents
Getting Started with Freescale MQX™ RTOS and IAR Embedded Workbench®........................i
1 Read Me First...............................................................................................................................2
2 Building the MQX RTOS Libraries and example application ....................................................3
2.1 Batch Build in IAR Embedded Workbench IDE........................................................................3
2.2 Build example/demo application project file.............................................................................4
3 Running and Debugging the MQX RTOS application................................................................5
3.1 Run MQX RTOS Hello World program....................................................................................5
3.2 Multi-core debugging...............................................................................................................6
3.3 Debugging (attach) the Application loaded by MQX RTOS Bootloader..................................11
3.4 MQX RTOS Task Aware Debugging .....................................................................................13
4 Using the MQX RTOS DebugI/O Driver with EWARM IDE.......................................................19

Getting Started with Freescale MQX™and IAR Embedded Workbench®, Rev. 5, 04/2015
Freescale Semiconductor 2
1 Read Me First
This document describes the steps required to configure the IAR Embedded Workbench®
development tools and use it to build, run, and debug applications of the Freescale MQX™ RTOS
operating system. See Getting Started with Freescale MQX™RTOS and other user documentation
included within the latest Freescale MQX RTOS installation for more details not specifically related
to the IAR Embedded Workbench tools.
Get the latest Freescale MQX RTOS at freescale.com/mqx.

Getting Started with Freescale MQX™and IAR Embedded Workbench®, Rev. 5, 04/2015
Freescale Semiconductor 3
2 Building the MQX RTOS Libraries and example application
See Chapter 2 of the Getting Started with Freescale MQX™ RTOS (document MQXGSRTOS) for
details on generic build process and compile time configuration. This document concentrates on
steps specific to IAR tool chain only.
For MQX RTOS v4.2.0, each example/demo application comes with one workspace file, which
contains the path to the example/demo project file and all dependent MQX RTOS library project
files. Import the workspace file in the folder. For example, with MQX RTOS:
<mqx_install_dir>/mqx/examples/<example>/build/iar/<example>_<board_name>/<exampl
e>_<board_name>.eww
For Hello World example of MQX RTOS for FRDMK64F120M, the workspace file is located in
folder:
<mqx_install_dir>/mqx/examples/hello/build/iar/hello_frdmk64f/hello_frdmk64f.eww
Figure 1- Import projects into IAR workspace
2.1 Batch Build in IAR Embedded Workbench IDE
The IAR IDE supports build of multiple project files in one go. Follow these spets to build all the
MQX RTOS library project files within a workspace at once.
Go to menu “Project / Batch Build” or press the F8 key in the IAR IDE.
Select Batch configuration to build (see next section for more details about build targets).
Press the “Make” button to start the batch build process.

Getting Started with Freescale MQX™and IAR Embedded Workbench®, Rev. 5, 04/2015
Freescale Semiconductor 4
Figure 2- Batch build
2.2 Build example/demo application project file
Select the build target and memory configuration for the example/demo application. With the
Hello World example application of MQX RTOS for FRDMK64120M, it is Int Flash
Debug/Int Flash Release
Figure 3- Build application
Go to menu Project/Make, press the F7 key, or click the icon in the IAR IDE to build the
application.

Getting Started with Freescale MQX™and IAR Embedded Workbench®, Rev. 5, 04/2015
Freescale Semiconductor 5
3 Running and Debugging the MQX RTOS application
The description bellow is provided for FRDMK64F120M BSP and Hello World example application.
The same procedure applies for all other BSPs and examples.
3.1 Run MQX RTOS Hello World program
Loading and debugging MQX RTOS applications is an easy task with IAR Embedded Workbench
tool and it is not different from debugging classic non-OS applications. Make sure that you select
the correct debugger interface in the project options and that you use the correct processor
initialization Macro file.
Connect the USB cable to the OpenJTAG connector on TWR-K60N512 board. Open the
Terminal Window application by using Port USB COM, Baud 115200, Parity None, Bits 8.
In project/Options-Debugger check debugger Driver settings. Default is J-Link. When a MQX
RTOS application is compiled and linked to all MQX RTOS libraries, press the debug button
to download the application to target.
The application gets executed and stops at the default C language entry point in the main()
function. Be aware that, at this breakpoint, the MQX Operating System is not yet running.
Therefore, the use of TAD plugin features, as described in subsequent sections, is limited.
Figure 4- mqx_main.c
Press the “Run” button to start the application.
Figure 5- Run button
Hello World is printed on serial console terminal.
Figure 6 –Console terminal

Getting Started with Freescale MQX™and IAR Embedded Workbench®, Rev. 5, 04/2015
Freescale Semiconductor 6
3.2 Multi-core debugging
This chapter describes the basics of multi-core debugging with MQX RTOS. Description is provided
for twrvf65gs10_a5 a twrvf65gs10_m4 (Vybrid) board support package and MCC (multi-core
communication) example application. In this case, the ARM® Cortex®-A5 is the primary core while
the ARM® Cortex®-M4 is set up as an auxiliary core.
3.2.1 Debugging with J-Link
Before you start, ensure that the IAR 6.50.2 or newer and the latest J-Link drivers from
SEGGER is used.
Open two instances of IAR IDE. In the first IDE instance, open the Cortex-A5 example
application. In the second IDE instance, open the application for Cortex-M4 core.
<mqx_install_dir>/mcc/examples/pingpong/build/iar/pingpong_example_twrvf65gs10
_a5
And
<mqx_install_dir>/mcc/examples/pingpong/build/iar/pingpong_example_twrvf65gs10
_m4
Ensure that both MQX RTOS library and MCC (<mqx_install_dir>/mcc/build) library are
compiled for each core prior to the compilation of the example application. Set the following
parameters before debugging:
For primary core (Cortex-A5), set in project Options:

Getting Started with Freescale MQX™and IAR Embedded Workbench®, Rev. 5, 04/2015
Freescale Semiconductor 7
Figure 7- Options
Set “JTAG scan chain with multiple targets” and TAP number “0” in the J-Link/J-Trace
setting.
Figure 8-Options for node
For secondary core, select “JTAG scan chain with multiple targets” and TAP number “3” in
the J-Link/J-Trace setting. The number 0 and 3 are the indexes of the CPUs on JTAG chain.
Since this can differ on other processors, see your processor Reference Manual for details.

Getting Started with Freescale MQX™and IAR Embedded Workbench®, Rev. 5, 04/2015
Freescale Semiconductor 8
Figure 9- Options for node
Set the Reset type to “Core.”
Figure 10- Options for node - setup
Start the primary core (Cortex-A5) application . You should see the following message on
the terminal:
Figure 11- Terminal
Start the auxiliary core (Cortex-M4) application . The responder starts and the message
“pingpong” starts between the cores.