hello_world#
Overview#
The Multicore Hello World demo application demonstrates how to set up projects for individual cores on a multicore system. In this demo, the primary core prints the “Hello World from the Primary Core!” string to the terminal and then releases the secondary core from the reset. The secondary core toggles an on-board LED indicating that the secondary core is running.
Building the application#
This shows example how to build application for evkbmimxrt1170 board with cm7 core_id.
Change the -b <board> parameter based on board you want to build.
Change the -Dcore_id=<core_id> parameter based on board core you want to build.
For these parameters please see attribute boards: in primary/example.yml.
west build --sysbuild examples/multicore_examples/hello_world/primary --toolchain armgcc --config debug -b evkbmimxrt1170 -Dcore_id=cm7
Supported Boards#
MIMXRT1170-EVKB
Hardware requirements
Mini/micro USB cable
MIMXRT1170-EVKB board
Personal Computer
Board settings
No special settings are required.
Prepare the Demo
Connect a USB cable between the host PC and the OpenSDA USB port on the target board.
Open a serial terminal with the following settings:
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Hello World from the Primary Core!
Copy Secondary core image to address: 0x20200000, size: 3280
Starting Secondary core.
The secondary core application has been started.
Note: The “Copy Secondary core image to address…” log message is not displayed on the terminal window when MCUXpresso IDE is used. In case of MCUXpresso IDE the secondary core image is copied to the target memory during startup automatically.
Note: To download and debug IAR EW project using J-Link (replacing the default CMSIS-DAP debug probe), following steps are needed:
Remove J6 and J7 jumpers.
Attach the J-Link probe (J-Link Plus / J-Trace) to the board using the J1 connector.
Set “J-Link / J-Trace” in CM7 project options -> Debugger -> Setup panel (replacing CMSIS-DAP option).
Unselect the “Use macro file(s)” in CM7 project options -> Debugger -> Setup panel.
Enable “Use command line options” in CM7 project options -> Debugger -> Extra Options panel (–jlink_script_file=$PROJ_DIR$/../evkbmimxrt1170_connect_cm4_cm7side.jlinkscript command line option is applied).
Click on “Download and Debug” button. During the loading process you can be asked by J-Link sw to select the proper device name (MIMXRT1176XXXA_M7 is unknown). Click O.K. and choose the MIMXRT1176xxxxA device.
It is not possible to attach to the CM4 core when using the J-Link. Also, the multicore debugging does not work with that probe.
Note: To download and debug Keil MDK project using J-Link (replacing the default CMSIS-DAP debug probe), following steps are needed:
Remove J6 and J7 jumpers.
Attach the J-Link probe (J-Link Plus / J-Trace) to the board using the J1 connector.
Set “J-LINK / J-TRACE Cortex” in CM7 project options -> Debug panel (replacing CMSIS-DAP Debugger option).
After the CM7 application build click on Download/F8 button (menu Flash -> Download).
Power off and power on the board.
Multicore example starts running, one can start debugging the CM7 side by clicking on Start/Stop Debug Session (Ctrl + F5).
It is not possible to attach to the CM4 core when using the J-Link.
MIMXRT1160-EVK
Hardware requirements
Mini/micro USB cable
MIMXRT1160-EVK board
Personal Computer
Board settings
No special settings are required.
Prepare the Demo
Connect a USB cable between the host PC and the OpenSDA USB port on the target board.
Open a serial terminal with the following settings:
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Hello World from the Primary Core!
Copy Secondary core image to address: 0x20200000, size: 3280
Starting Secondary core.
The secondary core application has been started.
Note: The “Copy Secondary core image to address…” log message is not displayed on the terminal window when MCUXpresso IDE is used. In case of MCUXpresso IDE the secondary core image is copied to the target memory during startup automatically.
Note: To download binary of cm7 core into qspiflash and boot from qspiflash directly, following steps are needed:
Compile flash target of the project, and get the binaray file “hello_world.bin”.
Set the SW1: 1 off 2 off 3 on 4 off, then power on the board and connect USB cable to J11.
Drop the binaray into disk “RT1160-EVK” on PC.
Wait for the disk disappear and appear again which will take couple of seconds.
Reset the board by pressing SW3 or power off and on the board. (If default boot core is cm4, binary of cm4 could be downloaded and boot according to steps above.)
Note: To download and debug IAR EW project using J-Link (replacing the default CMSIS-DAP debug probe), following steps are needed:
Remove J6 and J7 jumpers.
Attach the J-Link probe (J-Link Plus / J-Trace) to the board using the J1 connector.
Set “J-Link / J-Trace” in CM7 project options -> Debugger -> Setup panel (replacing CMSIS-DAP option).
Unselect the “Use macro file(s)” in CM7 project options -> Debugger -> Setup panel.
Enable “Use command line options” in CM7 project options -> Debugger -> Extra Options panel (–jlink_script_file=$PROJ_DIR$/../evkmimxrt1160_connect_cm4_cm7side.jlinkscript command line option is applied).
Click on “Download and Debug” button. During the loading process you can be asked by J-Link sw to select the proper device name (MIMXRT1166XXXA_M7 is unknown). Click O.K. and choose the MIMXRT1166xxxxA device.
It is not possible to attach to the CM4 core when using the J-Link. Also, the multicore debugging does not work with that probe.
Note: To download and debug Keil MDK project using J-Link (replacing the default CMSIS-DAP debug probe), following steps are needed:
Remove J6 and J7 jumpers.
Attach the J-Link probe (J-Link Plus / J-Trace) to the board using the J1 connector.
Set “J-LINK / J-TRACE Cortex” in CM7 project options -> Debug panel (replacing CMSIS-DAP Debugger option).
After the CM7 application build click on Download/F8 button (menu Flash -> Download).
Power off and power on the board.
Multicore example starts running, one can start debugging the CM7 side by clicking on Start/Stop Debug Session (Ctrl + F5).
It is not possible to attach to the CM4 core when using the J-Link.
MIMXRT1180-EVK
Hardware requirements
Mini/micro USB cable
MIMXRT1180-EVK board
Personal Computer
Board settings
No special settings are required.
Prepare the Demo
Connect a USB cable between the host PC and the OpenSDA USB port on the target board.
Open a serial terminal with the following settings:
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Hello World from the Primary Core!
Copy Secondary core image to address: 0x303C0000, size: 3280
Starting Secondary core.
The secondary core application has been started.
Note: The “Copy Secondary core image to address…” log message is not displayed on the terminal window when MCUXpresso IDE is used. In case of MCUXpresso IDE the secondary core image is copied to the target memory during startup automatically.
FRDM-K32L3A6
Hardware requirements
Mini/micro USB cable
FRDM-K32L3A6 board
Personal Computer
Board settings
No special settings are required.
Prepare the Demo
Connect the PC host and the board
Open a serial terminal with the following settings:
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Starting Secondary core.
Hello World from the Primary Core!
FRDM-MCXN947
Hardware requirements
Type-C USB cable
FRDM-MCXN947 board
Personal Computer
Board settings
No special settings are required.
Prepare the Demo
Note: MCUXpresso IDE project default debug console is semihost
Connect a type-c USB cable between the PC host and the MCU-Link USB port (J17) on the board
Open a serial terminal with the following settings (See Appendix A in Getting started guide for description how to determine serial port number):
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Copy Secondary core image to address: 0x2004e000, size: 3280
Starting Secondary core.
Hello World from the Primary Core!
Starting Secondary core.
The secondary core application has been started.
Note: The “Copy Secondary core image to address…” log message is not displayed on the terminal window when MCUXpresso IDE is used. In case of MCUXpresso IDE the secondary core image is copied to the target memory during startup automatically.
FRDM-MCXN947T
Hardware requirements
Type-C USB cable
FRDM-MCXN947T board
Personal Computer
Board settings
No special settings are required.
Prepare the Demo
Note: MCUXpresso IDE project default debug console is semihost
Connect a type-c USB cable between the PC host and the MCU-Link USB port (J17) on the board
Open a serial terminal with the following settings (See Appendix A in Getting started guide for description how to determine serial port number):
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Copy Secondary core image to address: 0x2004e000, size: 3280
Starting Secondary core.
Hello World from the Primary Core!
Starting Secondary core.
The secondary core application has been started.
Note: The “Copy Secondary core image to address…” log message is not displayed on the terminal window when MCUXpresso IDE is used. In case of MCUXpresso IDE the secondary core image is copied to the target memory during startup automatically.
FRDM-MCXW72
Hardware requirements
Type-C USB cable
FRDM-MCXW72 Board
Personal Computer
Board settings
For FRDM-MCXW72 board, connect J1 pin 7 to J4 pin 4 to allow LED2_BLUE control from the secondary core application.
Prepare the Demo
Connect a USB cable between the host PC and the board J10.
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Starting Secondary core.
Hello World from the Primary Core!
Starting Secondary core.
The secondary core application has been started.
KW47-EVK
Hardware requirements
Type-C USB cable
KW47-EVK Board
Personal Computer
Board settings
For KW-MCXW-EVK-MB RevB board, remove jumper on JP4 and manually connect JP4 pin 1 to J4 pin 7 (Arduino A2 pin) to allow LED2_BLUE control from the secondary core application.
Prepare the Demo
Connect a USB cable between the host PC and the EVK board J14.
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Starting Secondary core.
Hello World from the Primary Core!
Starting Secondary core.
The secondary core application has been started.
KW47-LOC
Hardware requirements
Type-C USB cable
KW47-LOC Board
Personal Computer
Board settings
For KW47-LOC board, remove jumper on JP23 and JP24, manually connect JP23 pin 1 to JP24 pin 1 to allow LED2_BLUE control from the secondary core application.
Prepare the Demo
Connect a USB cable between the host PC and the LOC board J3.
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Starting Secondary core.
Hello World from the Primary Core!
Starting Secondary core.
The secondary core application has been started.
LPCXpresso55S69
Hardware requirements
Mini/micro USB cable
LPCXpresso55s69 board
Personal Computer
Board settings
No special settings are required.
Prepare the Demo
Note: MCUXpresso IDE project default debug console is semihost
Connect a micro USB cable between the PC host and the CMSIS DAP USB port (P6) on the board
Open a serial terminal with the following settings (See Appendix A in Getting started guide for description how to determine serial port number):
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Copy Secondary core image to address: 0x20033000, size: 3280
Starting Secondary core.
Hello World from the Primary Core!
Starting Secondary core.
The secondary core application has been started.
Note: The “Copy Secondary core image to address…” log message is not displayed on the terminal window when MCUXpresso IDE is used. In case of MCUXpresso IDE the secondary core image is copied to the target memory during startup automatically.
MCX-N5XX-EVK
Hardware requirements
Mini/micro USB cable
MCX-N5XX-EVK board
Personal Computer
Board settings
No special settings are required.
Prepare the Demo
Note: MCUXpresso IDE project default debug console is semihost
Connect a micro USB cable between the PC host and the MCU-Link USB port (J5) on the board
Open a serial terminal with the following settings (See Appendix A in Getting started guide for description how to determine serial port number):
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Copy Secondary core image to address: 0x2004e000, size: 3280
Starting Secondary core.
Hello World from the Primary Core!
Starting Secondary core.
The secondary core application has been started.
Note: The “Copy Secondary core image to address…” log message is not displayed on the terminal window when MCUXpresso IDE is used. In case of MCUXpresso IDE the secondary core image is copied to the target memory during startup automatically.
MCX-N9XX-EVK
Hardware requirements
Mini/micro USB cable
MCX-N9XX-EVK board
Personal Computer
Board settings
No special settings are required.
Prepare the Demo
Note: MCUXpresso IDE project default debug console is semihost
Connect a micro USB cable between the PC host and the MCU-Link USB port (J5) on the board
Open a serial terminal with the following settings (See Appendix A in Getting started guide for description how to determine serial port number):
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Copy Secondary core image to address: 0x2004e000, size: 3280
Starting Secondary core.
Hello World from the Primary Core!
Starting Secondary core.
The secondary core application has been started.
Note: The “Copy Secondary core image to address…” log message is not displayed on the terminal window when MCUXpresso IDE is used. In case of MCUXpresso IDE the secondary core image is copied to the target memory during startup automatically.
MCX-W72-EVK
Hardware requirements
Type-C USB cable
MCX-W72-EVK Board
Personal Computer
Board settings
For KW-MCXW-EVK-MB RevB board, remove jumper on JP4 and manually connect JP4 pin 1 to J4 pin 7 (Arduino A2 pin) to allow LED2_BLUE control from the secondary core application.
Prepare the Demo
Connect a USB cable between the host PC and the EVK board J14.
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Starting Secondary core.
Hello World from the Primary Core!
Starting Secondary core.
The secondary core application has been started.
MIMXRT700-EVK
Hardware requirements
Mini/micro USB cable
MIMXRT700-EVK board
Personal Computer
Board settings
No special settings are required.
Prepare the Demo
Connect the PC host and the board
Open a serial terminal with the following settings:
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Starting Secondary core.
Hello World from the Primary Core!
FRDM-MCXL255
Hardware requirements
Type-C USB cable
FRDM-MCXL255 board
Personal Computer
Board settings
No special settings are required.
Prepare the Demo
Connect a USB cable between the host PC and the MCU-Link USB port on the target board.
Open a serial terminal with the following settings:
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Hello World from the Primary Core!
Copy Secondary core image to address: 0xa1000000, size: 4278
Starting Secondary core.
The secondary core application has been started.
Note: The “Copy Secondary core image to address…” log message is not displayed on the terminal window when MCUXpresso IDE is used. In case of MCUXpresso IDE the secondary core image is copied to the target memory during startup automatically.
Note: As it is not possible to use any on-board LED from the cm0plus core the secondary core is running LED indication is not working in this example.
MCXW72-LOC
Hardware requirements
Type-C USB cable
MCXW72-LOC Board
Personal Computer
Board settings
For MCXW72-LOC board, remove jumper on JP23 and JP24, manually connect JP23 pin 1 to JP24 pin 1 to allow LED2_BLUE control from the secondary core application.
Prepare the Demo
Connect a USB cable between the host PC and the LOC board J3.
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Starting Secondary core.
Hello World from the Primary Core!
Starting Secondary core.
The secondary core application has been started.
FRDM-IMXRT1186
Hardware requirements
Type-C USB cable
FRDM-IMXRT1186 board
Personal Computer
Board settings
No special settings are required.
Prepare the Demo
Connect a USB cable between the host PC and the OpenSDA USB port on the target board.
Open a serial terminal with the following settings:
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Hello World from the Primary Core!
Copy Secondary core image to address: 0x303C0000, size: 3280
Starting Secondary core.
The secondary core application has been started.
Note: The “Copy Secondary core image to address…” log message is not displayed on the terminal window when MCUXpresso IDE is used. In case of MCUXpresso IDE the secondary core image is copied to the target memory during startup automatically.
FRDM-IMXRT700
Hardware requirements
Type-C USB cable
FRDM-IMXRT700 board
Personal Computer
Board settings
No special settings are required.
Prepare the Demo
Connect the PC host and the board
Open a serial terminal with the following settings:
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Starting Secondary core.
Hello World from the Primary Core!
FRDM-MCXE32B
Hardware requirements
Type-C USB cable
FRDM-MCXE32B board
Personal Computer
Board settings
No special settings are required.
Prepare the Demo
Connect a type-c USB cable between the host PC and the MCU-Link USB port (J13) on the target board.
Open a serial terminal with the following settings:
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the hello world multicore demo in the terminal window:
Starting Secondary core.
Hello World from the Primary Core!
The secondary core application has been started.
Note: The secondary core (M7_1) image is embedded into the primary core (M7_0) image and programmed to flash at address 0x00600000. The primary core releases the secondary core through the MC_ME interface and the secondary core runs in place directly from flash. No copy-to-RAM step is performed.