MCUXpresso_MIMXRT1021xxxxx/boards/evkmimxrt1020/demo_apps/shell

Overview

The Shell Demo application demonstrates to control Leds by commands. Note: Please input one character at a time. If you input too many characters each time, the receiver may overflow because the low level UART uses simple polling way for receiving. If you want to try inputting many characters each time, just define DEBUG_CONSOLE_TRANSFER_NON_BLOCKING in your project to use the advanced debug console utility. Besides, the demo does not support semihosting mode. The shell component is based on debug console and serial manager. When semihosting is used, debug console and serial manager are bypassed. So the shell demo cannot work with semihosting.

SDK version

• Version: 2.15.000

Toolchain supported

• IAR embedded Workbench 9.40.1
• Keil MDK 5.38.1
• GCC ARM Embedded 12.2
• MCUXpresso 11.8.0

Hardware requirements

• Mini/micro USB cable
• EVK-MIMXRT1020 board
• Personal Computer

Board settings

No special settings are required.

Prepare the Demo

1. Connect a USB cable between the host PC and the OpenSDA USB port on the target board.
2. Open a serial terminal with the following settings:
   • 115200 baud rate
   • 8 data bits
   • No parity
   • One stop bit
   • No flow control
3. Download the program to the target board.
4. Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.

Running the demo

When the example runs successfully, the following message is displayed in the terminal:

SHELL (build: Jun 19 2020)
Copyright 2020 NXP

SHELL>> help

"help": Lists all the registered commands

"led arg1 arg2":
 Usage:
    arg1: 1|2|3|4...            Led index
    arg2: on|off                Led status

"exit": Exit program

SHELL>> led 1 on
SHELL>> led 1 off
SHELL>> led 2 on
LED index is wrongs
SHELL>>

Note: 1,The shell information "SHELL (build: Jun 19 2020)" may be different, which depends on the compile date. 2,If the command 'led x on'/'led x off' run success, the corresponding LEDx on board will turn on/turn off. But the valid "Led index" may be different, which depends how many LEDs are available on the specific board. For example: one board only have LED1/LED2, then shell demo will print "LED index is wrong" for all led index bigger than 2.

Note: To debug in qspiflash, following steps are needed:

1. Select the flash target and compile.
2. Set the SW8: 1 off 2 off 3 on 4 off, then power on the board and connect USB cable to J23.
3. Start debugging in IDE.
   • Keil: Click "Download (F8)" to program the image to qspiflash first then clicking "Start/Stop Debug Session (Ctrl+F5)" to start debugging.