《I.MX6U嵌入式Linux驱动开发指南》第十一章模仿STM32驱动开发格式实验-CFANZ编程社区

模仿STM32驱动开发格式实验

在上一章使用C语言编写LED灯驱动的时候，每个寄存器的地址我们都需要写宏定义，使用起来非常的不方便。我们在学习STM32的时候，可以使用“GPIOB->ODR”这种方式来给GPIOB的寄存器ODR赋值，因为在STM32中同属于一个外设的所有寄存器地址基本是相邻的(有些会有保留寄存器)。因此我们可以借助C语言里面的结构体成员地址递增的特点来将某个外设的所有寄存器写入到一个结构体里面，然后定义一个结构体指针指向这个外设的寄存器基地址，这样我们就可以通过这个结构体指针来访问这个外设的所有寄存器。同理，I.MX6U也可以使用这种方法来定义外设寄存器，本章我们就模仿STM32里面的寄存器定义方式来编写I.MX6U的驱动，通过本章的学习也可以对STM32的寄存器定义方式有一个深入的认识。

11.1 模仿STM32寄存器定义

11.1.1 STM32寄存器定义简介

为了开发方便，ST官方为STM32F103编写了一个叫做stm32f10x.h的文件，在这个文件里面定义了STM32F103所有外设寄存器，我们可以使用其定义的寄存器来进行开发，比如我们可以用如下代码来初始化一个GPIO：

GPIOE->CRL&=0XFF0FFFFF;
GPIOE->CRL|=0X00300000;  //PE5推挽输出
GPIOE->ODR|=1<<5;   //PE5输出高

上述代码是初始化STM32的PE5这个GPIO为推挽输出，需要配置的就是GPIOE的寄存器CRL和ODR， “GPIOE”的定义：

#define GPIOE ((GPIO_TypeDef *) GPIOE_BASE)

可以看出“GPIOE”是个宏定义，是一个指向地址GPIOE_BASE的结构体指针，结构体为GPIO_TypeDef，GPIO_TypeDef和GPIOE_BASE的定义如下：

typedef struct
{
 __IO uint32_t CRL;
 __IO uint32_t CRH;
 __IO uint32_t IDR;
 __IO uint32_t ODR;
 __IO uint32_t BSRR;
 __IO uint32_t BRR;
 __IO uint32_t LCKR;
} GPIO_TypeDef;

#define GPIOE_BASE  (APB2PERIPH_BASE + 0x1800)
#define APB2PERIPH_BASE  (PERIPH_BASE + 0x10000)
#define PERIPH_BASE  ((uint32_t)0x40000000)

上述定义中GPIO_TypeDef是个结构体，结构体里面的成员变量有CRL、CRH、IDR、ODR、BSRR、BRR和LCKR，这些都是GPIO的寄存器，每个成员变量都是32位(4字节)，这些寄存器在结构体中的位置都是按照其地址值从小到大排序的。GPIOE_BASE就是GPIOE的基地址，其为：

GPIOE_BASE=APB2PERIPH_BASE+0x1800
   = PERIPH_BASE + 0x10000 + 0x1800
   =0x40000000 + 0x10000 + 0x1800
   =0x40011800

GPIOE_BASE的基地址为0x40011800，宏GPIOE指向这个地址，因此GPIOE的寄存器CRL的地址就是0X40011800，寄存器CRH的地址就是0X40011800+4=0X40011804，其他寄存器地址以此类推。我们要操作GPIOE的ODR寄存器的话就可以通过“GPIOE->ODR”来实现，这个方法是借助了结构体成员地址连续递增的原理。

了解了STM32的寄存器定义以后，我们就可以参考其原理来编写I.MX6U的外设寄存器定义了。NXP官方并没有为I.MX6UL编写类似stm32f10x.h这样的文件，NXP只为I.MX6ULL提供了类似stm32f10x.h这样的文件，名为MCIMX6Y2.h，但是I.MX6UL和I.MX6ULL几乎一模一样，所以文件MCIMX6Y2.h可以用在I.MX6UL上。关于文件MCIMX6Y2.h的移植我们在下一章讲解，本章我们参考stm32f10x.h来编写一个简单的MCIMX6Y2.h文件。

11.1.2 I.MX6U寄存器定义

参考STM32的官方文件来编写I.MX6U的寄存器定义，比如IO复用寄存器组“IOMUX_SW_MUX_CTL_PAD_XX”，步骤如下：

1、编写外设结构体

先将同属于一个外设的所有寄存器编写到一个结构体里面，如IO复用寄存器组的结构体如下：

示例代码11.1.2.1 寄存器IOMUX_SW_MUX_Type
 /* 
 * IOMUX寄存器组
 */
1 typedef struct 
2 {
3  volatile unsigned int BOOT_MODE0;
4  volatile unsigned int BOOT_MODE1;
5  volatile unsigned int SNVS_TAMPER0;
6  volatile unsigned int SNVS_TAMPER1;
 ………
107  volatile unsigned int CSI_DATA00;
108  volatile unsigned int CSI_DATA01;
109  volatile unsigned int CSI_DATA02;
110  volatile unsigned int CSI_DATA03;
111  volatile unsigned int CSI_DATA04;
112  volatile unsigned int CSI_DATA05;
113  volatile unsigned int CSI_DATA06;
114  volatile unsigned int CSI_DATA07;
   /* 为了缩短代码，其余IO复用寄存器省略 */
115}IOMUX_SW_MUX_Tpye

上述结构体IOMUX_SW_MUX_Type就是IO复用寄存器组，成员变量是每个IO对应的复用寄存器，每个寄存器的地址是32位，每个成员都使用“volatile”进行了修饰，目的是防止编译器优化。

2、定义IO复用寄存器组的基地址

根据结构体IOMUX_SW_MUX_Type的定义，其第一个成员变量为BOOT_MODE0，也就是BOOT_MODE0这个IO的IO复用寄存器，查找I.MX6U的参考手册可以得知其地址为0X020E0014，所以IO复用寄存器组的基地址就是0X020E0014，定义如下：

#define IOMUX_SW_MUX_BASE   (0X020E0014)

3、定义访问指针

访问指针定义如下：

#define IOMUX_SW_MUX  ((IOMUX_SW_MUX_Type *)IOMUX_SW_MUX_BASE)

通过上面三步我们就可以通过“IOMUX_SW_MUX->GPIO1_IO03”来访问GPIO1_IO03的IO复用寄存器了。同样的，其他的外设寄存器都可以通过这三步来定义。

11.2 硬件原理分析

本章使用到的硬件资源和第八章一样，就是一个LED0。

11.3 实验程序编写

本实验对应的例程路径为：开发板光盘-> 1、裸机例程-> 3_ledc_stm32。

创建VSCode工程，工作区名字为“ledc_stm32”，新建三个文件：start.S、main.c和imx6ul.h。其中start.S是汇编文件，start.S文件的内容和第十章的start.S一样，直接复制过来就可以。main.c 和imx6ul.h是C文件，完成以后如图11.3.1所示：

《I.MX6U嵌入式Linux驱动开发指南》第十一章模仿STM32驱动开发格式实验_寄存器

图11.3.1 工程文件目录

文件imx6ul.h用来存放外设寄存器定义，在imx6ul.h中输入如下代码：

在编写寄存器组结构体的时候注意寄存器的地址是否连续，有些外设的寄存器地址可能不是连续的，会有一些保留地址，因此我们需要在结构体中留出这些保留的寄存器。比如CCM的CCGR6寄存器地址为0X020C4080，而寄存器CMEOR的地址为0X020C4088。按照地址顺序递增的原理，寄存器CMEOR的地址应该是0X020C4084，但是实际上CMEOR的地址是0X020C4088，相当于中间跳过了0X020C4088-0X020C4080=8个字节，如果寄存器地址连续的话应该只差4个字节(32位)，但是现在差了8个字节，所以需要在寄存器CCGR6和CMEOR直接加入一个保留寄存器，这个就是“示例代码11.3.1”中第47行RESERVED_3[1]的来源。如果不添加保留位来占位的话就会导致寄存器地址错位！

示例代码11.2.1 imx6ul.h文件代码
/***************************************************************
Copyright © zuozhongkai Co., Ltd. 1998-2019. All rights reserved.
文件名 : imx6ul.h
作者 : 左忠凯
版本 : V1.0
描述 : IMX6UL相关寄存器定义，参考STM32寄存器定义方法
其他 : 无
日志 : 初版V1.0 2019/1/3 左忠凯创建
**************************************************************/

/* 
 * 外设寄存器组的基地址 
 */
1 #define CCM_BASE   (0X020C4000)
2 #define CCM_ANALOG_BASE  (0X020C8000)
3 #define IOMUX_SW_MUX_BASE  (0X020E0014)
4 #define IOMUX_SW_PAD_BASE  (0X020E0204)
5 #define GPIO1_BASE  (0x0209C000)
6 #define GPIO2_BASE  (0x020A0000)
7 #define GPIO3_BASE  (0x020A4000)
8 #define GPIO4_BASE  (0x020A8000)
9 #define GPIO5_BASE  (0x020AC000)
10 
11 /* 
12 * CCM寄存器结构体定义，分为CCM和CCM_ANALOG 
13 */
14 typedef struct 
15 {
16 volatile unsigned int CCR;
17 volatile unsigned int CCDR;
18 volatile unsigned int CSR;
  ……
46 volatile unsigned int CCGR6;
47 volatile unsigned int RESERVED_3[1];
48 volatile unsigned int CMEOR; 
49 } CCM_Type; 
50 
51 typedef struct 
52 {
53 volatile unsigned int PLL_ARM;
54 volatile unsigned int PLL_ARM_SET;
55 volatile unsigned int PLL_ARM_CLR;
56 volatile unsigned int PLL_ARM_TOG;
  ……
110 volatile unsigned int MISC2;
111 volatile unsigned int MISC2_SET;
112 volatile unsigned int MISC2_CLR;
113 volatile unsigned int MISC2_TOG;
114 } CCM_ANALOG_Type; 
115 
116 /* 
117  * IOMUX寄存器组
118 */
119 typedef struct 
120 {
121 volatile unsigned int BOOT_MODE0;
122 volatile unsigned int BOOT_MODE1;
123 volatile unsigned int SNVS_TAMPER0;
  ……
241 volatile unsigned int CSI_DATA04;
242 volatile unsigned int CSI_DATA05;
243 volatile unsigned int CSI_DATA06;
244 volatile unsigned int CSI_DATA07;
245 }IOMUX_SW_MUX_Type;
246 
247 typedef struct 
248 {
249 volatile unsigned int DRAM_ADDR00;
250 volatile unsigned int DRAM_ADDR01;
  ……
419 volatile unsigned int GRP_DDRPKE;
420 volatile unsigned int GRP_DDRMODE;
421 volatile unsigned int GRP_DDR_TYPE;
422 }IOMUX_SW_PAD_Type;
423 
424 /* 
425 * GPIO寄存器结构体
426 */
427 typedef struct 
428 {
429 volatile unsigned int DR; 
430 volatile unsigned int GDIR; 
431 volatile unsigned int PSR; 
432 volatile unsigned int ICR1; 
433 volatile unsigned int ICR2; 
434 volatile unsigned int IMR; 
435 volatile unsigned int ISR; 
436 volatile unsigned int EDGE_SEL; 
437 }GPIO_Type;
438 
439 
440 /* 
441  * 外设指针 
442 */
443 #define CCM  ((CCM_Type *)CCM_BASE)
444 #define CCM_ANALOG  ((CCM_ANALOG_Type *)CCM_ANALOG_BASE)
445 #define IOMUX_SW_MUX  ((IOMUX_SW_MUX_Type *)IOMUX_SW_MUX_BASE)
446 #define IOMUX_SW_PAD  ((IOMUX_SW_PAD_Type *)IOMUX_SW_PAD_BASE)
447 #define GPIO1  ((GPIO_Type *)GPIO1_BASE)
448 #define GPIO2  ((GPIO_Type *)GPIO2_BASE)
449 #define GPIO3  ((GPIO_Type *)GPIO3_BASE)
450 #define GPIO4  ((GPIO_Type *)GPIO4_BASE)
451 #define GPIO5  ((GPIO_Type *)GPIO5_BASE)

main.c文件中输入如下所示内容：

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

main.c中7个函数，这7个函数的含义和第十章中的main.c文件一样，只是函数体写法变了，寄存器的访问采用imx6ul.h中定义的外设指针。比如第27行设置GPIO1_IO03的复用功能就可以通过“IOMUX_SW_MUX->GPIO1_IO03”来给寄存SW_MUX_CTL_PAD_GPIO1_IO03赋值。

11.4 编译下载验证

11.4.1 编写Makefile和链接脚本

Makefile文件的内容基本和第十章的Makefile一样，如下：

链接脚本imx6ul.lds的内容和上一章一样，可以直接使用上一章的链接脚本文件。

示例代码11.4.1 Makefile文件代码
1  objs := start.o main.o
2 
3 ledc.bin:$(objs)
4   arm-linux-gnueabihf-ld -Timx6ul.lds -o ledc.elf $^
5  arm-linux-gnueabihf-objcopy -O binary -S ledc.elf $@
6  arm-linux-gnueabihf-objdump -D -m arm ledc.elf > ledc.dis
7 
8 %.o:%.s
9  arm-linux-gnueabihf-gcc -Wall -nostdlib -c -O2 -o $@ $<
10 
11 %.o:%.S
12  arm-linux-gnueabihf-gcc -Wall -nostdlib -c -O2 -o $@ $<
13 
14 %.o:%.c
15  arm-linux-gnueabihf-gcc -Wall -nostdlib -c -O2 -o $@ $<
16 
17 clean:
18  rm -rf *.o ledc.bin ledc.elf ledc.dis

11.4.2 编译下载

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

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

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

《I.MX6U嵌入式Linux驱动开发指南》 第十一章 模仿STM32驱动开发格式实验