Running system on
armv7m7-imxrt117x-evk (NXP i.MX RT117x)
This version is designed for NXP i.MX RT117x processors with ARM Cortex-M7 core. To launch this version the final disk image and loader image should be provided. The images are created as the final artifacts of the
phoenix-rtos-project building and are located in the
_boot directory. The disk image consists of the bootloader (plo), kernel, UART driver (tty), dummyfs filesystem server (RAM disk), and
psh (shell). Necessary tools to carry out the flashing process are located in the
_boot directory as well.
The easiest way to start programming hardware targets using Phoenix-RTOS is to get some of the evaluation boards with a specified target processor or microcontroller. In this case MIMXRT1170-EVK is the example of a board with the
imxrt117x processor, where the default configuration of peripherals allows to run Phoenix-RTOS.
Connecting the board
Firstly make sure, that the
J38jumper is in the
3-4position, so that the power will be supplied from the
USB OTGport. It is the simplest way, but the good practice is using a USB hub. You can provide power using an AC adapter and DC connector too (1-2 jumper position).
To provide a power supply for the board and make flashing possible, you should connect a USB to micro USB cable between your host pc and
J20) of the development board. Do it first.
To communicate with the board you will need to connect another USB cable, but to
DEBUG USBport (
J11). The onboard UART-USB converter is used here.
The picture below presents how the board should be connected:
- Now you should verify what USB device on your host-pc is connected with the
DEBUG USB(console). In order to check that run:
ls -l /dev/serial/by-id
If your output is like in the screenshot above, the console (
DEBUG USB in the evaluation board) is on the
- When the board is connected to your host-pc, open serial port in terminal using picocom and type the console port (in this case ACM0)
picocom -b 115200 --imap lfcrlf /dev/ttyACM0
How to get picocom (Ubuntu 20.04)
sudo apt-get update && \
sudo apt-get install picocom
You can leave the terminal with the serial port open, and follow the next steps.
Flashing the Phoenix-RTOS system image
The process comes down to a few steps, described below.
Uploading Phoenix-RTOS loader (plo) to the RAM memory
To flash the disk image to the board, the bootloader (plo) image located in the
_boot directory should be uploaded to the RAM using
psu (Phoenix Serial Uploader) via
SDP (Serial Download Protocol).
i. MX RT1176 should be set in Serial Download mode. Set the appropriate configuration of the
SW1 switch on
MIMXRT1170-EVK, which is
0001. If the configuration was different you should restart the board after the change and open the serial port using picocom once again.
Change directory to
_boot and run
psu as follow:
sudo ./psu plo-ram.sdp
The plo user interface should appear in the console.
To get the available bootloader command list please type
Copying flash image using PHFS (phoenixd)
To flash the disk image, first, you need to verify on which port plo USB device has appeared. You can check that using
ls as follow:
ls -l /dev/serial/by-id
To share disk image to the bootloader,
phoenixd has to be launched with the following arguments (choose suitable ttyACMx device, in this case, ttyACM1):
sudo ./phoenixd -p /dev/ttyACM1 -b 115200 -s .
To start copying a file, write the following command in the console with plo interface:
copy usb0 phoenix.disk flash0 0x0 0x0
flash0 is the external flash memory.
Booting Phoenix-RTOS from Flash
To launch Phoenix-RTOS from flash memory, change the
SW1 switch to Internal Boot mode (
0010 configuration) and restart the board (you can do it by pushing the
If everything has gone correctly, Phoenix-RTOS with the default configuration and the
psh shell command prompt will appear in the terminal after 2 seconds. If there is a need to enter the bootloader, the waiting for input should be interrupted by pressing any key. Then you can exit plo by passing
If you want to get the available command list please type:
To get the list of working processes please type:
To get the table of processes please type: