I.MX6ULL的官方 SDK 移植实验

系列文章目录

I.MX6ULL的官方 SDK 移植实验

---

---

一、前言

在I.MX6ULL模仿 STM32 驱动开发格式实验，我们参考 ST 官方给 STM32 编写的 stm32f10x.h 来自行编写 I.MX6ULL的寄存器定义文件。自己编写这些寄存器定义不仅费时费力，没有任何意义，而且很容易写错，**NXP 官方为 I.MX6ULL 编写了 SDK 包，在 SDK 包里面 NXP 已经编写好了寄存器定义文件，所以我们可以直接移植 SDK 包里面的文件来用。**虽然 NXP 是为 I.MX6ULL 编写的 SDK 包，但是 I.MX6UL 也是可以使用的！

---

二、I.MX6ULL 官方 SDK 包简介

NXP 针对 I.MX6ULL 编写了一个 SDK 包，这个 SDK 包就类似于 STM32 的 STD 库或者
HAL 库，这个 SDK 包提供了 Windows 和 Linux 两种版本，分别针对主机系统是 Windows 和Linux。因为我们是在 Windows 下使用 Source Insight 来编写代码的，因此我们使用的是 Windows版本的。Windows 版本 SDK 里面的例程提供了 IAR 版本，肯定有人会问既然 NXP 提供了 IAR版本的 SDK，那我们为什么不用 IAR 来完成裸机试验，偏偏要用复杂的 GCC？因为我们要从简单的裸机开始掌握 Linux 下的 GCC 开发方法，包括 Ubuntu 操作系统的使用、Makefile 的编写、shell 等等。如果为了偷懒而使用 IAR 开发裸机的话，那么后续学习 Uboot 移植、Linux 移植和 Linux 驱动开发就会很难上手，因为开发环境都不熟悉！再者，不是所有的半导体厂商都会为 Cortex-A 架构的芯片编写裸机 SDK 包，我使用过那么多的 Cotex-A 系列芯片，也就发现了 NXP 给 I.MX6ULL 编写了裸机 SDK 包。而且去 NXP 官网看一下，会发现只有 I.MX6ULL这一款 Cotex-A 内核的芯片有裸机 SDK 包，NXP 的其它 Cotex-A 芯片都没有。
所以，使用 Cortex-A 内核芯片的时候不要想着有类似 STM32 库一样的东西，I.MX6ULL 是一个特例，基本所有的 Cortex-A 内核的芯片都不会提供裸机 SDK 包。因此在使用 STM32 的时候那些用起来很顺手的库文件，在 Cotex-A 芯片下基本都需要我们自行编写，比如.s 启动文件、寄存器定义等等。
nxp官网：www.nxp.com

下载图中的 WIN 版本 SDK，也就是“SDK2.2_iMX6ULL_WIN”
双击 SDK_2.2_MCIM6ULL_RFP_Win.exe 安装 SDK 包，安装的时候需要设置好安装位置，安装完成以后的 SDK 包如图所示：
重点是需要 SDK 包里面与寄存器定义相关的文件，一共需要如下三个文件：
fsl_common.h:位置为SDK_2.2_MCIM6ULL\devices\MCIMX6Y2\drivers\fsl_common.h。
fsl_iomuxc.h: 位置为 SDK_2.2_MCIM6ULL\devices\MCIMX6Y2\drivers\fsl_iomuxc.h。
MCIMX6Y2.h: 位置为 SDK_2.2_MCIM6ULL\devices\MCIMX6Y2\MCIMX6YH2.h。
整个 SDK 包我们就需要上面这三个文件，把这三个文件准备好，我们后面移植要用。

---

三、硬件原理图

I.MX6UALPHA 开发板上有一个 LED 灯，原理图如下图所示;

从图可以看出，LED0 接到了 GPIO_3 上，GPIO_3 就是 GPIO1_IO03，当 GPIO1_IO03输出低电平(0)的时候发光二极管 LED0 就会导通点亮，当 GPIO1_IO03 输出高电平(1)的时候发光二极管 LED0 不会导通，因此 LED0 也就不会点亮。所以 LED0 的亮灭取决于 GPIO1_IO03的输出电平，输出 0 就亮，输出 1 就灭。

---

四、试验程序编写

4.1 SDK 文件移植

使用 VSCode 新建工程，将 fsl_common.h、fsl_iomuxc.h 和 MCIMX6Y2.h 这三个文件拷贝到工程中，这三个文件直接编译的话肯定会出错的！需要对其做删减，根据make报错的删掉对应不需要的函数以及裁剪

4.2 创建 cc.h 文件

新建一个名为 cc.h 的头文件，cc.h 里面存放一些 SDK 库文件需要使用到的数据类型，在cc.h 里面输入如下代码：

#ifndef __CC_H
#define __CC_H
/*
* 自定义一些数据类型供库文件使用
*/
#define __I   volatile
#define __O   volatile
#define __IO  volatile
#define ON 1
#define OFF 0
typedef signed char          int8_t;
typedef signed short         int int16_t;
typedef signed int           int32_t;
typedef unsigned char        uint8_t;
typedef unsigned short int   uint16_t;
typedef unsigned int         uint32_t;
typedef unsigned long long   uint64_t;
typedef signed char              s8; 
typedef signed short int         s16;
typedef signed int               s32;
typedef signed long long int     s64;
typedef unsigned char            u8;
typedef unsigned short int       u16;
typedef unsigned int             u32;
typedef unsigned long long int   u64;
#endif

在 cc.h 文件中我们定义了很多的数据类型，因为有些第三方库会用到这些变量类型。

4.3 编写实验代码

新建 start.S 和 main.c 这两个文件，start.S 文件的内容和I.MX6ULL模仿 STM32 驱动开发格式实验一样，直接复制过来就可以，创建完成以后工程目录如图所示：
在 main.c 中输入如下所示代码：

1 #include "fsl_common.h"
2 #include "fsl_iomuxc.h"
3 #include "MCIMX6Y2.h"
4 
5 /*
6 * @description : 使能 I.MX6U 所有外设时钟
7 * @param : 无
8 * @return : 无
9 */
10 void clk_enable(void)
11 {
12 CCM->CCGR0 = 0XFFFFFFFF;
13 CCM->CCGR1 = 0XFFFFFFFF;
14 
15 CCM->CCGR2 = 0XFFFFFFFF;
16 CCM->CCGR3 = 0XFFFFFFFF;
17 CCM->CCGR4 = 0XFFFFFFFF;
18 CCM->CCGR5 = 0XFFFFFFFF;
19 CCM->CCGR6 = 0XFFFFFFFF;
2021 }
22 
23 /*
24 * @description : 初始化 LED 对应的 GPIO
25 * @param : 无
26 * @return : 无
27 */
28 void led_init(void)
29 {
30 /* 1、初始化 IO 复用 */
31 IOMUXC_SetPinMux(IOMUXC_GPIO1_IO03_GPIO1_IO03,0);
32 
33 /* 2、、配置 GPIO1_IO03 的 IO 属性 
34 *bit 16:0 HYS 关闭
35 *bit [15:14]: 00 默认下拉
36 *bit [13]: 0 kepper 功能
37 *bit [12]: 1 pull/keeper 使能
38 *bit [11]: 0 关闭开路输出
39 *bit [7:6]: 10 速度 100Mhz
40 *bit [5:3]: 110 R0/6 驱动能力
41 *bit [0]: 0 低转换率
42 */
43 IOMUXC_SetPinConfig(IOMUXC_GPIO1_IO03_GPIO1_IO03,0X10B0);
44 
45 /* 3、初始化 GPIO,设置 GPIO1_IO03 设置为输出 */
46 GPIO1->GDIR |= (1 << 3); 
47 
48 /* 4、设置 GPIO1_IO03 输出低电平，打开 LED0 */
49 GPIO1->DR &= ~(1 << 3); 
50 }
51 
52 /*
53 * @description : 打开 LED 灯
54 * @param : 无
55 * @return : 无
56 */
57 void led_on(void)
58 {
59 /* 将 GPIO1_DR 的 bit3 清零 */
60 GPIO1->DR &= ~(1<<3);
61 }
62 
63 /*
64 * @description : 关闭 LED 灯
65 * @param : 无
66 * @return : 无
67 */
68 void led_off(void)
69 {
70 /* 将 GPIO1_DR 的 bit3 置 1 */
71 GPIO1->DR |= (1<<3);
72 }
73 
74 /*
75 * @description : 短时间延时函数
76 * @param - n : 要延时循环次数(空操作循环次数，模式延时)
77 * @return : 无
78 */
79 void delay_short(volatile unsigned int n)
80 {
81 while(n--){}
82 }
83 
84 /*
85 * @description : 延时函数,在 396Mhz 的主频下
86 * 延时时间大约为 1ms
87 * @param - n : 要延时的 ms 数
88 * @return : 无
89 */
90 void delay(volatile unsigned int n)
91 {
92 while(n--)
93 {
94 delay_short(0x7ff);
95 }
96 }
97 
98 /*
99 * @description : main 函数
100 * @param : 无
101 * @return : 无
102 */
103 int main(void)
104 {
105 clk_enable(); /* 使能所有的时钟 */
106 led_init(); /* 初始化 led */
107
108 while(1) /* 死循环 */
109 { 
110 led_off(); /* 关闭 LED */
111 delay(500); /* 延时 500ms */
112
113 led_on(); /* 打开 LED */
114 delay(500); /* 延时 500ms */
115 }
116
117 return 0;
118 }

和一样I.MX6ULL模仿 STM32 驱动开发格式实验，main.c 有 7 个函数，这 7 个函数的含义都一样，只是本代码我们使用的是移植好的 NXP 官方 SDK 里面的寄存器定义。

---

重点来看一下 led_init 函数中的第 31 行和第 43 行，这两行的内容如下：

IOMUXC_SetPinMux(IOMUXC_GPIO1_IO03_GPIO1_IO03, 0);
IOMUXC_SetPinConfig(IOMUXC_GPIO1_IO03_GPIO1_IO03, 0X10B0);

这 里 使 用 了 两 个 函 数 IOMUXC_SetPinMux 和 IOMUXC_SetPinConfig ， 其 中 函 数IOMUXC_SetPinMux 是用来设置 IO 复 用 功 能 的 ， 最 终 肯 定 设 置 的 是 寄 存 器
“IOMUXC_SW_MUX_CTL_PAD_XX”。函数 IOMUXC_SetPinConfig 设置的是 IO 的上下拉、速度等的，也就是寄存器“IOMUXC_SW_PAD_CTL_PAD_XX”，所以上面两个函数其实就是I.MX6ULL模仿 STM32 驱动开发格式实验中的：

IOMUX_SW_MUX->GPIO1_IO03 = 0X5;
IOMUX_SW_PAD->GPIO1_IO03 = 0X10B0;

---

函数 IOMUXC_SetPinMux 在文件 fsl_iomuxc.h 中定义，函数源码如下：

static inline void IOMUXC_SetPinMux(uint32_t muxRegister,
 uint32_t muxMode,
 uint32_t inputRegister,
 uint32_t inputDaisy,
 uint32_t configRegister,
 uint32_t inputOnfield)
{
 *((volatile uint32_t *)muxRegister) =
 IOMUXC_SW_MUX_CTL_PAD_MUX_MODE(muxMode) | 
IOMUXC_SW_MUX_CTL_PAD_SION(inputOnfield);
 if (inputRegister)
 {
 *((volatile uint32_t *)inputRegister) = 
IOMUXC_SELECT_INPUT_DAISY(inputDaisy);
 }
}

函数 IOMUXC_SetPinMux 有 6 个参数，这 6 个参数的函数如下：
muxRegister ： IO 的 复 用 寄 存 器 地 址 ， 比 如 GPIO1_IO03 的 IO 复 用 寄 存 器
SW_MUX_CTL_PAD_GPIO1_IO03 的地址为 0X020E0068。
muxMode： IO 复用值，也就是 ALT0~ALT8，对应数字 0~8，比如要将 GPIO1_IO03 设置
为 GPIO 功能的话此参数就要设置为 5。
inputRegister：外设输入 IO 选择寄存器地址，有些 IO 在设置为其他的复用功能以后还需要设置 IO 输入寄存器，比如 GPIO1_IO03 要复用为 UART1_RX 的话还需要设置寄存器
UART1_RX_DATA_SELECT_INPUT，此寄存器地址为 0X020E0624。
inputDaisy：寄存器 inputRegister 的值，比如 GPIO1_IO03 要作为 UART1_RX 引脚的话此参数就是 1。
configRegister：未使用，函数 IOMUXC_SetPinConfig 会使用这个寄存器。
inputOnfield ： IO 软件输入使能，以 GPIO1_IO03 为例就是寄存器
SW_MUX_CTL_PAD_GPIO1_IO03 的 SION 位(bit4)。如果需要使能 GPIO1_IO03 的软件输入功能的话此参数应该为 1，否则的话就为 0。
IOMUXC_SetPinMux 的函数体很简单，就是根据参数对寄存器 muxRegister 和 inputRegister进行赋值。在代码第 31 行使用此函数将 GPIO1_IO03 的复用功能设置为
GPIO，如下：

IOMUXC_SetPinMux(IOMUXC_GPIO1_IO03_GPIO1_IO03, 0);

第一次看到上面代码的时候肯定会奇怪，为何只有两个参数？不是应该 6 个参数的吗？先看 IOMUXC_GPIO1_IO03_GPIO1_IO03 是个宏，在文件fsl_iomuxc.h 中有定义，NXP 的 SDK 库将一个 IO 的所有复用功能都定义了一个宏，比如GPIO1_IO03 就有如下 9 个宏定义：

IOMUXC_GPIO1_IO03_I2C1_SDA
IOMUXC_GPIO1_IO03_GPT1_COMPARE3 
IOMUXC_GPIO1_IO03_USB_OTG2_OC 
IOMUXC_GPIO1_IO03_USDHC1_CD_B 
IOMUXC_GPIO1_IO03_GPIO1_IO03 
IOMUXC_GPIO1_IO03_CCM_DI0_EXT_CLK 
IOMUXC_GPIO1_IO03_SRC_TESTER_ACK 
IOMUXC_GPIO1_IO03_UART1_RX 
IOMUXC_GPIO1_IO03_UART1_TX

上面 9 个宏定义分别对应着 GPIO1_IO03 的九种复用功能，比如复用为 GPIO 的宏定义就是：

#define IOMUXC_GPIO1_IO03_GPIO1_IO03 0x020E0068U, 0x5U, 0x00000000U, 
0x0U, 0x020E02F4U

将这个宏带入到代码中的 31 行以后就是：

IOMUXC_SetPinMux (0x020E0068U, 0x5U, 0x00000000U, 0x0U, 0x020E02F4U, 0);

这样就与函数 IOMUXC_SetPinMux 的 6 个参数对应起来了，如果我们要将GPIO1_IO03 复用为 I2C1_SDA 的话就可以使用如下代码：

IOMUXC_SetPinMux(IOMUXC_GPIO1_IO03_I2C1_SDA, 0);

---

函数 IOMUXC_SetPinConfig，此函数同样在文件 fsl_iomuxc.h 中有定义，函数源码如下：

static inline void IOMUXC_SetPinConfig(uint32_t muxRegister,
 uint32_t muxMode, uint32_t inputRegister,
 uint32_t inputDaisy,
 uint32_t configRegister,
 uint32_t configValue)
{
 if (configRegister)
 {
 *((volatile uint32_t *)configRegister) = configValue;
 }
}

函数 IOMUXC_SetPinConfig 有 6 个参数，其中前五个参数和函数 IOMUXC_SetPinMux 一样，但是此函数只使用了参数 configRegister 和 configValue，cofigRegister 参数是 IO 配置寄存器地址，比如 GPIO1_IO03 的 IO 配置寄存器为IOMUXC_SW_PAD_CTL_PAD_GPIO1_IO03，其地址为 0X020E02F4，参数 configValue 就是要写入到寄存器 configRegister 的值。同理，代码中的 43 行展开以后就是：

IOMUXC_SetPinConfig(0x020E0068U, 0x5U, 0x00000000U, 0x0U, 0x020E02F4U, 0X10B0);

根据函数 IOMUXC_SetPinConfig 的源码可以知道，上面函数就是将寄存器 0x020E02F4 的值设置为 0X10B0。
以后就可以使用这两个函数来方便的配置 IO 的复用功能和 IO 配置。

---

五、编译下载验证

5.1编写 Makefile 和链接脚本

新建 Makefile 文件，Makefile 文件内容如下：

1 CROSS_COMPILE ?= arm-linux-gnueabihf-
2 NAME ?= ledc
3 
4 CC := $(CROSS_COMPILE)gcc
5 LD := $(CROSS_COMPILE)ld
6 OBJCOPY := $(CROSS_COMPILE)objcopy
7 OBJDUMP := $(CROSS_COMPILE)objdump
8 
9 OBJS := start.o main.o
10
11 $(NAME).bin:$(OBJS)
12 $(LD) -Timx6ul.lds -o $(NAME).elf $^
13 $(OBJCOPY) -O binary -S $(NAME).elf $@
14 $(OBJDUMP) -D -m arm $(NAME).elf > $(NAME).dis
15
16 %.o:%.s
17 $(CC) -Wall -nostdlib -c -O2 -o $@ $<
18 
19 %.o:%.S
20 $(CC) -Wall -nostdlib -c -O2 -o $@ $<
21 
22 %.o:%.c
23 $(CC) -Wall -nostdlib -c -O2 -o $@ $<
24 
25 clean:
26 rm -rf *.o $(NAME).bin $(NAME).elf $(NAME).dis

Makefile 文件是在I.MX6ULL模仿 STM32 驱动开发格式实验上修改的，只是使用到了变量。链接脚本 imx6ul.lds 的内容和I.MX6ULL模仿 STM32 驱动开发格式实验一样，可以直接复制该链接脚本文件使用。

---

5.2编译下载

使用 Make 命令编译代码，编译成功以后使用软件 imxdownload 将编译完成的 ledc.bin 文件下载到 SD 卡中，命令如下：

chmod 777 imxdownload //给予 imxdownload 可执行权限，一次即可
./imxdownload ledc.bin /dev/sdd //烧写到 SD 卡中，不能烧写到/dev/sda 或 sda1 设备里面！

烧写成功以后将 SD 卡插到开发板的 SD 卡槽中，然后复位开发板，如果代码运行正常的
话 LED0 就会以 500ms 的时间间隔亮灭

---

END