iMX8MQ MCUXpresso SDK开发详解

飞凌iMX8MQ 平台内部有一个Cortex M4内核，支持使用MCUXpresso SDK进行开发。

MCUXpresso SDK是微控制器软件支持的集合，它包含外围驱动程序，RPMSG多核通信，以及FreeRTOS支持。可以查看SDK API文档了解它实现的函数和结构体。

OKMX8MQ平台可以使用以下工具链进行SDK开发：

Linux环境： Makefiles support with GCC revision v7-2017-q4-major from Arm Embedded

Windows环境：IAR Embedded Workbench for ARM version 8.30.2

一、使用ARM GCC工具编译应用程序
在Linux环境下，MCUXpresso SDK使用GCC工具进行编译，下面以hello_world demo为例说明编译的过程。

首先需要搭建Linux编译环境：

1、安装cmake

$ sudo apt-get install cmake

$ cmake --version

cmake 的版本要大于 3.0.x 才行。如果您的的版本小于3.0，可以参考下列步骤进行更新。

$ cd /tmp

$ wget https://cmake.org/files/v3.11/cmake-3.11.0-rc4-Linux-x86_64.tar.gz

$ tar zxvf cmake-3.11.0-rc4-Linux-x86_64.tar.gz

$ sudo mv cmake-3.11.0-rc4-Linux-x86_64 /opt/cmake-3.11

$ sudo ln -sf /opt/cmake-3.11/bin/* /usr/bin/

$ cmake --version

2、安装GCC编译器

将用户资料工具目录的 gcc-arm-none-eabi-7-2017-q4-major-linux.tar.bz2 拷贝到虚拟机/tmp 目录。

$ cd /tmp

$ sudo tar xvf gcc-arm-none-eabi-7-2017-q4-major-linux.tar.bz2 -C /opt

3、设置环境变量

$ export ARMGCC_DIR=/opt/gcc-arm-none-eabi-7-2017-q4-major

$ export PATH=/opt/gcc-arm-none-eabi-7-2017-q4-major/bin:$PATH

设置完成可以看一下是否设置成功：

$ echo $ARMGCC_DIR

$ echo $PATH

4、编译

将用户资料原厂资料中的 SDK_2.8.0_EVK-MIMX8MQ.zip 拷贝到虚拟机 /home/forlinx/imx8mq 目录下：

$ cd /home/forlinx/imx8mq

$ mkdir SDK_2.8.0_EVK-MIMX8MQ

$ mv SDK_2.8.0_EVK-MIMX8MQ.zip SDK_2.8.0_EVK-MIMX8MQ

$ cd SDK_2.8.0_EVK-MIMX8MQ

$ unzip SDK_2.8.0_EVK-MIMX8MQ.zip

$ cd boards/evkmimx8mq/demo_apps/hello_world/armgcc

$ ./build_debug.sh

编译出来的 hello_world.bin 文件在 ./debug 目录下。

注意：这里也可以编译其他版本，如build_ddr_debug.sh，只是在运行的时候会有差别。

二、 使用IAR和J link编译和 调试
参考官方提供的手册 《SDK_2.8.0_EVK-MIMX8MQ\docs\Getting Started with MCUXpresso SDK for EVK-MIMX8MQ》。

1、IAR和Jlink官方工具版本要求
IAR请使用IAR embedded Workbench 8.30.2版本或更高版本，jlink官方工具版本请使用包含MIM8M6_M4设备的版本，我们使用的版本为JLink_Windows_V654c。IAR embedded Workbench为付费软件，请用户自行购买安装。Jlink官方工具用户可以在jlink官方网站下载。

另外还需要NXP提供的SDK_2.8.0_EVK-MIMX8MQ，用户资料内已经提供。

2、IAR通过Jlink运行测试程序
步骤一、打开工程

1. 打开IAR
   

2. 在“File”菜单下选择“Open Workspace”，选择SDK_2.8.0_EVK-MIMX8MQ\boards\evkmimx8mq\demo_apps\hello_world\iar\hello_world.eww。
   

3. 选择debug选项
   

步骤 二 、 配置工程

按下ALT+F7快捷键打开配置界面。

1. 设置General Options选项配置：
   

2. 设置linker选项配置：
   

点击“Edit...”

选择MIMX8MQ6xxxJZ_cm4_ddr_ram.icf、MIMX8MQ6xxxJZ_cm4_ram.icf，不同的选项会生成的镜像会运行在不同的存储中（ddr、ram）。

3. 设置Debugger选项配置：
   

4. 设置J-Link/J-Trace选项配置：
   

配置完成后点击 “OK”。

步骤三、编译并运行工程

注意：调试M4程序，iMX8MQ开发板不能启动到Linux内核阶段，需要停止在uboot（启动时，在调试串口按下空格键）。

1. 点击“Make”编译工程，工程编译完成，且无报错：
   

2. 点击“Download and Debug”按钮：
   

3. 提示设置 J-Link 选择设备：
   

4. 选择“MIMX8MQ6_M4”设备：
   

5. 运行测试程序：
   

6. 在M4核调试串口查看运行结果：
   

三、使用 U -boot运行应用程序
可以在iMX8MQ开发板启动的时候进入u-boot命令行，通过u-boot命令来将bin文件加载到M4中并运行，下面以hello_world.bin程序为例说明运行的过程。

注意：M4程序运行可能和A53有资源冲突，如某个接口在M4中已经使用，A53中不要再次调用此接口。M4程序运行在DDR中，需要Linux中预留这部分内存。在系统烧写的设备树ok8mq-evk-rpmsg.dtb中有配置。我们下面测试都是使用此设备树测试M4程序。

在uboot命令行内输入下列命令修改设备树：

$ setenv fdt_file ok8mq-evk-rpmsg.dtb

$ saveenv

1、 准备测试用M4程序

采用第一或者第二中的方法生成运行在DDR和ram的hello_world.bin，并将它们分别命名为hello_world_ddr.bin和hello_world_ram.bin。

2、 串口连接

由于hello_world程序中使用了uart2，因此在开始测试之前请连接uart2到PC的串口。并使用串口调试工具打开对应的COM口，波特率等参数设置和OKMX8MQ Debug口参数相同。

3、 将编译出来的hello_world_ddr.bin和hello_world_ram.bin拷贝到U盘（Fat32）的根目录下面，将U盘插到开发板上，重启iMX8MQ开发板，停在u-boot命令行。

4、 在u-boot命令行执行如下命令

对于debug/release版本的bin文件，它运行在TCM，执行下列命令：

$ usb start

$ fatload usb 0:1 0x48000000 hello_world_ram.bin

$ cp.b 0x48000000 0x7e0000 0x20000

$ bootaux 0x7e0000

终端的执行：

在uart2的调试串口工具上可以看到打印信息如下：

对于ddr_debug/ddr_release版本的bin文件，它运行在DDR4，执行下列命令：

$setenv fdt_file ok8mq-evk-rpmsg.dtb

$ saveenv

$ usb start

$ fatload usb 0:1 0x80000000 hello_world_ddr.bin

$ dcache flush

$ bootaux 0x80000000

终端的执行：

在uart2的调试串口工具上可以看到打印信息如下：

四、Uboot自动启动M4程序
在制作系统镜像的时候，会将源码包内images/m4/文件夹下的文件写入到boot.img镜像内，该镜像是rootfs.sdcard的一部分。我们把镜像烧写到emmc后，这些m4程序的镜像就在emmc的fat32分区内存在。Uboot启动过程中会运行m4_run，将m4_run设置为启动m4程序，启动后uboot会启动M4程序。

以hello_world例程示例，按下面的方法设置uboot环境变量后，uboot会自动启动M4程序。

hello_world程序的镜像，我们已经默认添加到源码的images/m4/文件夹下，所以我们的镜像内emmc的分区1内的m4文件夹下包含了hello_world的镜像，hello_world_ram.bin和hello_world_ddr.bin。

在ram启动M4程序。

$ setenv m4_run 'mmc dev 0; fatload mmc 0:1 0x48000000 m4/hello_world_ram.bin; cp.b 0x48000000 0x7e0000 0x20000; bootaux 0x7e0000 '

$ saveenv

在ddr启动M4程序。

$ setenv m4_run 'mmc dev 0; fatload mmc 0:1 0x80000000 m4/hello_world_ddr.bin; dcache flush; bootaux 0x80000000'

$ saveenv

注1：用户添加自己编译的镜像放到images/m4/文件夹下，编辑生成镜像，烧写后就会在emmc的fat分区内，启动的时候根据编译的为ddr版或ram版选择m4_run的设置方法，并将m4_run命令内的m4镜像名字替换成自己编译的m4镜像的名字。

注2：可以在系统启动后查看fat分区内包含的镜像，也可以通过cp命令添加镜像。

查看镜像：

$ ls /run/media/mmcblk0p1/m4

复制镜像到文件夹：

$ cp /run/media/sda1/m4_flash.bin /run/media/mmcblk0p1/m4/

五、异构多核通信测试
使用RPMsg（Remote Processor Messaging）实现Cortex A53跟Cortex M4进行通信。

RPMsg是一种基于virtio的消息传递总线，它允许内核驱动程序与系统上可用的远程处理器（如Cortex M4）进行通信。下图是一个多核通信架构：

飞凌iMX8MQ的MCUXpresso SDK中有一个demo：rpmsg_lite_pingpong_rtos，它实现了Cortex A53与Cortex M4的数据收发，二者使用了共享内存，并且在Cortex M4上运行了一个FreeRTOS Task。

在Cortex A53端通过内核模块的方式实现该功能，代码位于：drivers/rpmsg/imx_rpmsg_pingpong.c。

下面以 Arm GCC 方式编译示例。

进入以下目录：

$ cd boards/evkmimx8mq/multicore_examples/rpmsg_lite_pingpong_rtos/linux_remote/armgcc

编译debug版本的bin文件：

$ ./build_debug.sh

$ cd debug

$ ls -l

将编译出来的bin文件rpmsg_lite_pingpong_rtos_linux_remote.bin拷贝到U盘（Fat32）的根目录下面，启动开发板停在u-boot命令行。

$ setenv fdt_file ok8mq-evk-rpmsg.dtb

$ saveenv

$ usb start

$ fatload usb 0:1 0x48000000 rpmsg_lite_pingpong_rtos_linux_remote.bin

$ cp.b 0x48000000 0x7e0000 0x20000

$ bootaux 0x7e0000

运行bin文件后，可以在uart2的串口终端看到以下输出：

然后在A53 U-boot命令行输入 boot 启动kernel，此时可以在Cortex M4的串口终端看到以下输出：

然后在Cortex A53的串口终端加载以下内核模块：

$ modprobe imx_rpmsg_pingpong

模块加载之后，Cortex A53开始跟Cortex M4进行数据传输，此时可以在Cortex M4的串口终端看到以下输出：

此时可以在Cortex A53的串口终端看到以下输出：

六、FreeRTOS 应用程序测试
飞凌iMX8MQ板卡内部有一个Cortex M4核，可以在上面运行FreeRTOS 应用程序。

下面以freertos_swtimer demo为例测试FreeRTOS。

进入目录：

$ cd boards/evkmimx8mq/rtos_examples/freertos_swtimer/armgcc

编译debug版本的bin文件：

$ ./build_debug.sh

$ cd debug

$ ls -l

将编译出来的bin文件 freertos_swtimer.bin 拷贝到U盘（FAT32）的根目录下面。将U盘插入开发板USB Host接口，启动开发板停在u-boot命令行。

$ setenv fdt_file ok8mq-evk-rpmsg.dtb

$ saveenv

$ usb start

$ fatload usb 0:1 0x48000000 freertos_swtimer.bin

$ cp.b 0x48000000 0x7e0000 0x20000

$ fbootaux 0x7e0000

此时可以在Cortex M4的串口终端看到以下输出：

可以看到终端周期性的打印出Tick字符，说明FreeRTOS 应用程序中的定时器任务正在运行。