LV04-02-GPIO-04-C语言下的GPIO操作

发表于 分类于 ， ， 本文字数： 5k 阅读时长 ≈ 18 分钟

本文主要是C语言版的LED点亮实验的相关笔记，若笔记中有错误或者不合适的地方，欢迎批评指正😃。

点击查看使用工具及版本
Windows版本 windows11
Ubuntu版本 Ubuntu16.04的64位版本
VMware® Workstation 16 Pro 16.2.3 build-19376536
终端软件 MobaXterm(Professional Edition v23.0 Build 5042 (license))
Linux开发板 正点原子 i.MX6ULL Linux 阿尔法开发板
uboot NXP官方提供的uboot，NXP提供的版本为uboot-imx-rel_imx_4.1.15_2.1.0_ga(使用的uboot版本为U-Boot 2016.03)
linux内核 linux-4.15(NXP官方提供)
Win32DiskImager Win32DiskImager v1.0
点击查看本文参考资料
分类 网址 说明
官方网站 https://www.arm.com/ ARM官方网站，在这里我们可以找到Cotex-Mx以及ARMVx的一些文档
https://www.nxp.com.cn/ NXP官方网站
https://www.nxpic.org.cn/NXP 官方社区
https://u-boot.readthedocs.io/en/latest/u-boot官网
https://www.kernel.org/linux内核官网
点击查看相关文件下载
分类 网址 说明
NXP https://github.com/nxp-imx NXP imx开发资源GitHub组织，里边会有u-boot和linux内核的仓库
https://elixir.bootlin.com/linux/latest/source 在线阅读linux kernel源码
nxp-imx/linux-imx/releases/tag/rel_imx_4.1.15_2.1.0_ga NXP linux内核仓库tags中的rel_imx_4.1.15_2.1.0_ga
nxp-imx/uboot-imx/releases/tag/rel_imx_4.1.15_2.1.0_ga NXP u-boot仓库tags中的rel_imx_4.1.15_2.1.0_ga
I.MX6ULL i.MX 6ULL Applications Processors for Industrial Products I.MX6ULL 芯片手册（datasheet，可以在线查看）
i.MX 6ULL Applications ProcessorReference Manual I.MX6ULL 参考手册（下载后才能查看，需要登录NXP官网）

一、概述

实际工作中是很少用到汇编去写嵌入式驱动的，毕竟汇编太难，而且写出来也不好理解，大部分情况下都是使用 C 语言去编写的。只是在开始部分用汇编来初始化一下 C 语言环境，比如初始化 DDR、设置堆栈指针 SP 等等，当这些工作都做完以后就可以进入 C 语言环境，也就是运行 C 语言代码，一般都是进入 main 函数。所以我们有两部分文件要做：

  • （1）汇编文件：汇编文件只是用来完成 C 语言环境搭建。

  • （2）C 语言文件：C 语言文件就是完成我们的业务层代码的，其实就是我们实际例程要完成的功能。

其实 STM32 也是这样的，只是我们在开发 STM32 的时候没有想到这一点，以 STM32F103 为例，其启动文件 startup_stm32f10x_hd.s 这个汇编文件就是完成 C 语言环境搭建的，当然还有一些其他的处理，比如中断向量表等等。当 startup_stm32f10x_hd.s 把 C 语言环境初始化完成以后就会进入 C 语言环境

二、启动文件

1. start.S

最简单的，最简的启动文件内容如下所示：

1
2
3
4
5
6
7
8
9
10
11
12
.global _start  		/* 全局标号 */

/* 描述：	_start函数，程序从此函数开始执行，此函数主要功能是设置C运行环境。*/
_start:
	/* 进入SVC模式 */
	mrs r0, cpsr
	bic r0, r0, #0x1f 	/* 将r0寄存器中的低5位清零，也就是cpsr的M0~M4 	*/
	orr r0, r0, #0x13 	/* r0或上0x13,表示使用SVC模式					*/
	msr cpsr, r0		/* 将r0 的数据写入到cpsr_c中 					*/

	ldr sp, =0X80200000	/* 设置栈指针			 */
	b main				/* 跳转到main函数 		 */

2. 汇编分析

第 1 行：定义了一个全局标号_start。

第 4 行：就是标号_start 开始的地方，相当于是一个_start 函数，这个_start 就是第一行代码。

第 6 ~ 9 行：就是设置处理器进入 SVC 模式，Cortex-A 系列处理器有九个运行模型，这里我们设置处理器运行在 SVC 模式下。处理器模式的设置是通过修改 CPSR(程序状态)寄存器来完成的，其中 CPSR 寄存器的M[4:0]（CPSR 的 bit[4:0]）就是设置处理器运行模式的如果要将处理器设置为 SVC模式，那么 M[4:0]就要等于 0X13。第6~9 行代码就是先使用指令 MRS 将 CPSR寄存器的值读取到 R0 中，然后修改 R0 中的值，设置 R0 的 bit[4:0]为 0X13，然后再使用指令MSR 将修改后的 R0 重新写入到 CPSR 中。

第 11 行：通过 ldr 指令设置 SVC 模式下的 SP 指针=0X80200000，因为 I.MX6U-ALPHA 开发板上的 DDR3 地址范围是0X80000000 ~ 0XA0000000 （512MB）或 者0X80000000 ~ 0X90000000 （256MB），不管是 512MB 版本还是 256MB 版本的，其 DDR3 起始地址都是 0X80000000。由于Cortex-A7 的堆栈是向下增长的，所以将 SP 指针设置为 0X80200000，因此 SVC 模式的栈大小 0X80200000 - 0X80000000 = 0X200000 = 2MB，2MB 的栈空间已经很大了，如果做裸机开发的话绰绰有余。

第 12 行：就是跳转到 main 函数， main 函数就是 C 语言代码了。

以上就是汇编部分程序执行完成，就几行代码，用来设置处理器运行到 SVC 模式下、然后初始化 SP 指针、最终跳转到 C 文件的 main 函数中。其他的芯片，如三星的 S3C2440 或者 S5PV210 ，这一些芯片在使用 SDRAM 或者 DDR 之前必须先初始化 SDRAM 或者 DDR。所以 S3C2440或者 S5PV210 的汇编文件里面是一定会有 SDRAM 或者 DDR 初始化代码的。

但是我们上面编写的 start.s 文件中却没有初始化 DDR3 的代码，但是却将 SVC 模式下的 SP 指针设置到了 DDR3 的地址范围中，这不会出问题吗？肯定不会的， DDR3 肯定是要初始化的，但是不需要在 start.s 文件中完成。在前边学习 DCD 数据的时候就已经讲过了， DCD 数据包含了 DDR 配置参数， I.MX6U 内部的 Boot ROM 会读取 DCD 数据中的 DDR 配置参数然后完成 DDR 初始化的 。

三、C语言程序

1. 实现步骤

正点原子的ALPHA开发板的LED灯接在GPIO1_03上边。

1.1 使能时钟

我们看一下《i.MX 6ULL Applications Processor Reference Manual》的18.4 System Clocks一节的Table 18-3. System Clocks, Gating, and Override，我们直接搜索GPIO1_CLK关键词就可以找到GPIO1的时钟是CCGR1来控制的。

image-20230716162559972

然后查看一下，CCGR1的哪一位是用于配置gpio1的：

image-20230719195210025

可以看到是CG13[27:26]这两位来控制的，它们有四种情况，都代表什么含义？我们可以看一下参考手册的 18.6.23 CCM Clock Gating Register 0 (CCM_CCGR0) 也就是这些寄存器最开始的时候，对于值是有说明的：

image-20230719195813566

由此可知，对于GPIO时钟控制位来说，有如下四种情况：

（1）00：该 GPIO 模块全程被关闭

（2）01：该 GPIO 模块在 CPU run mode 情况下是使能的；在 WAIT 或 STOP 模式下，关闭

（3）10：保留

（4）11：该 GPIO 模块全程使能

1.2 选择GPIO功能

我们找到《i.MX 6ULL Applications Processor Reference Manual》参考手册的 32.6.10 SW_MUX_CTL_PAD_GPIO1_IO03 SW MUX Control Register (IOMUXC_SW_MUX_CTL_PAD_GPIO1_IO03) 一节：

image-20230719200601757

1.3 配置GPIO参数

我们可以找到《i.MX 6ULL Applications Processor Reference Manual》参考手册的32.6.156 SW_PAD_CTL_PAD_GPIO1_IO03 SW PAD Control Register (IOMUXC_SW_PAD_CTL_PAD_GPIO1_IO03)：

image-20230719201027343

可以知道：

 *bit 16     :0 HYS关闭
 *bit [15:14]: 00 默认下拉
 *bit [13]   : 0 kepper功能
 *bit [12]   : 1 pull/keeper使能
 *bit [11]   : 0 关闭开路输出
 *bit [7:6]  : 10 速度100Mhz
 *bit [5:3]  : 110 R0/6驱动能力
 *bit [0]    : 0 低转换率

1.4 设置GPIO引脚模式和电平

我们可以找到《i.MX 6ULL Applications Processor Reference Manual》参考手册的28.5 GPIO Memory Map/Register Definition，可以找到如下寄存器：

image-20230719201349250
  • 设置方向寄存器，把引脚设置为输出引脚：
image-20230719201427614
  • 设置数据寄存器，设置引脚的输出电平：
image-20230719201502966

2. 完整代码

2.1 main.h

点击查看 main.h 详细内容 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
#ifndef __MAIN_H
#define __MAIN_H
/* CCM相关寄存器地址 */
#define CCM_CCGR0 			*((volatile unsigned int *)0X020C4068)
#define CCM_CCGR1 			*((volatile unsigned int *)0X020C406C)

#define CCM_CCGR2 			*((volatile unsigned int *)0X020C4070)
#define CCM_CCGR3 			*((volatile unsigned int *)0X020C4074)
#define CCM_CCGR4 			*((volatile unsigned int *)0X020C4078)
#define CCM_CCGR5 			*((volatile unsigned int *)0X020C407C)
#define CCM_CCGR6 			*((volatile unsigned int *)0X020C4080)

/* IOMUX相关寄存器地址 */
#define SW_MUX_GPIO1_IO03 	*((volatile unsigned int *)0X020E0068)
#define SW_PAD_GPIO1_IO03 	*((volatile unsigned int *)0X020E02F4)

/* GPIO1相关寄存器地址 */
#define GPIO1_DR 			*((volatile unsigned int *)0X0209C000)
#define GPIO1_GDIR 			*((volatile unsigned int *)0X0209C004)
#define GPIO1_PSR 			*((volatile unsigned int *)0X0209C008)
#define GPIO1_ICR1 			*((volatile unsigned int *)0X0209C00C)
#define GPIO1_ICR2 			*((volatile unsigned int *)0X0209C010)
#define GPIO1_IMR 			*((volatile unsigned int *)0X0209C014)
#define GPIO1_ISR 			*((volatile unsigned int *)0X0209C018)
#define GPIO1_EDGE_SEL 		*((volatile unsigned int *)0X0209C01C)

#endif

2.2 main.c

点击查看 main.c 文件 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
#include "main.h"

/*
 * @description	: 使能I.MX6U所有外设时钟
 * @param 		: 无
 * @return 		: 无
 */
void clk_enable(void)
{
	CCM_CCGR0 = 0xffffffff;
	CCM_CCGR1 = 0xffffffff;
	CCM_CCGR2 = 0xffffffff;
	CCM_CCGR3 = 0xffffffff;
	CCM_CCGR4 = 0xffffffff;
	CCM_CCGR5 = 0xffffffff;
	CCM_CCGR6 = 0xffffffff;
}

/*
 * @description	: 初始化LED对应的GPIO
 * @param 		: 无
 * @return 		: 无
 */
void led_init(void)
{
	/* 1、初始化IO复用 */
	SW_MUX_GPIO1_IO03 = 0x5;	/* 复用为GPIO1_IO03 */

	/* 2、、配置GPIO1_IO03的IO属性	
	 *bit 16:0 HYS关闭
	 *bit [15:14]: 00 默认下拉
     *bit [13]: 0 kepper功能
     *bit [12]: 1 pull/keeper使能
     *bit [11]: 0 关闭开路输出
     *bit [7:6]: 10 速度100Mhz
     *bit [5:3]: 110 R0/6驱动能力
     *bit [0]: 0 低转换率
     */
	SW_PAD_GPIO1_IO03 = 0X10B0;		

	/* 3、初始化GPIO */
	GPIO1_GDIR = 0X0000008;	/* GPIO1_IO03设置为输出 */

	/* 4、设置GPIO1_IO03输出低电平，打开LED0 */
	GPIO1_DR = 0X0;
}

/*
 * @description	: 打开LED灯
 * @param 		: 无
 * @return 		: 无
 */
void led_on(void)
{
	/* 将GPIO1_DR的bit3清零 */
	GPIO1_DR &= ~(1<<3); 
}

/*
 * @description	: 关闭LED灯
 * @param 		: 无
 * @return 		: 无
 */
void led_off(void)
{
	/* 将GPIO1_DR的bit3置1 */
	GPIO1_DR |= (1<<3);
}

/*
 * @description	: 短时间延时函数
 * @param - n	: 要延时循环次数(空操作循环次数，模式延时)
 * @return 		: 无
 */
void delay_short(volatile unsigned int n)
{
	while(n--){}
}

/*
 * @description	: 延时函数,在396Mhz的主频下
 * 			  	  延时时间大约为1ms
 * @param - n	: 要延时的ms数
 * @return 		: 无
 */
void delay(volatile unsigned int n)
{
	while(n--)
	{
		delay_short(0x7ff);
	}
}

int main(void)
{
	clk_enable();		/* 使能所有的时钟		 	*/
	led_init();			/* 初始化led 			*/

	while(1)			/* 死循环 				*/
	{	
		led_off();		/* 关闭LED   			*/
		delay(500);		/* 延时大约500ms 		*/

		led_on();		/* 打开LED		 	*/
		delay(500);		/* 延时大约500ms 		*/
	}

	return 0;
}

main.c 文件里面一共有 7 个函数，这 7 个函数都很简单。

clk_enable 函数是使能CCGR0~CCGR6 所控制的所有外设时钟。

ed_init 函数是初始化 LED 灯所使用的 IO，包括设置IO 的复用功能、 IO 的属性配置和 GPIO 功能，最终控制 GPIO 输出低电平来打开 LED 灯。

led_on 和 led_off 这两个函数看名字就知道，用来控制 LED 灯的亮灭的。

delay_short()和 delay()这两个函数是延时函数， delay_short()函数是靠空循环来实现延时的， delay()是对 delay_short()的简单封装，在 I.MX6U 工作 在 396MHz(Boot ROM 设 置的 396MHz)的主频的时候delay_short(0x7ff)基本能够实现大约 1ms 的延时，所以 delay()函数我们可以用来完成 ms 延时。

main 函数就是我们的主函数了，在 main 函数中先调用函数 clk_enable()和 led_init()来完成时钟使能和 LED 初始化，最终在 while(1)循环中实现 LED 循环亮灭，亮灭时间大约是 500ms。

3. 链接文件imx6ul.lds

3.1 链接脚本演示

1
2
3
4
5
6
7
SECTIONS{
    . = 0X10000000;
    .text : {*(.text)}
    . = 0X30000000;
    .data ALIGN(4) : { *(.data) }
    .bss ALIGN(4) : { *(.bss) }
}

第 1 行：我们先写了一个关键字“SECTIONS”，后面跟了一个大括号，这个大括号和第 7 行的大括号是一对，这是必须的。看起来就跟 C 语言里面的函数一样。

第 2 行：对一个特殊符号“.”进行赋值，“.”在链接脚本里面叫做定位计数器，默认的定位计数器为 0。我们要求代码链接到以 0X10000000 为起始地址的地方，因此这一行给“.”赋值0X10000000，表示以 0X10000000 开始，后面的文件或者段都会以 0X10000000 为起始地址开始链接。

第 3 行：“.text”是段名，后面的冒号是语法要求，冒号后面的大括号里面可以填上要链接到“.text”这个段里面的所有文件，“*(.text)”中的“*”是通配符，表示所有输入文件的 .text 段都放到 “.text” 中。

第 4 行，我们的要求是数据放到 0X30000000 开始的地方，所以我们需要重新设置定位计数器“.”，将其改为 0X30000000。如果不重新设置的话会怎么样？假设“.text”段大小为 0X10000，那么接下来的.data 段开始地址就是 0X10000000+0X10000=0X10010000，这明显不符合我们的要求。所以我们必须调整定位计数器为 0X30000000。

第 5 行跟第 3 行一样，定义了一个名为“.data”的段，然后所有文件的“.data”段都放到这里面。但是这一行多了一个“ALIGN(4)”，这是什么意思呢？这是用来对“.data”这个段的起始地址做字节对齐的， ALIGN(4)表示 4 字节对齐。也就是说段“.data”的起始地址要能被 4 整除，一般常见的都是 ALIGN(4)或者 ALIGN(8)，也就是 4 字节或者 8 字节对齐。

第 6 行：定义了一个“.bss”段，所有文件中的“.bss”数据都会被放到这个里面，“.bss”数据就是那些定义了但是没有被初始化的变量。

3.2 imx6ul.lds

1
2
3
4
5
6
7
8
9
10
11
12
13
14
SECTIONS{
	. = 0X87800000;
	.text :
	{
		start.o 
		main.o 
		*(.text)
	}
	.rodata ALIGN(4) : {*(.rodata*)}     
	.data ALIGN(4)   : { *(.data) }    
	__bss_start = .;    
	.bss ALIGN(4)  : { *(.bss)  *(COMMON) }    
	__bss_end = .;
}

上面的链接脚本文件和前边的演示代码是基本一致的：

第 2 行设置定位计数器为0X87800000，因为我们的链接地址就是0X87800000。

第5行设置链接到开始位置的文件为start.o，因为 start.o 里面包含着第一个要执行的指令，所以一定要链接到最开始的地方。

第 6 行是 main.o这个文件，其实可以不用写出来，因为 main.o 的位置就无所谓了，可以由编译器自行决定链接位置。

第 11、 13 行：有“__bss_start”和“__bss_end”这两个东西？这个是什么呢？“__bss_start”和“__bss_end”是符号，第 11、 13 这两行其实就是对这两个符号进行赋值，其值为定位符 .，这两个符号用来保存 .bss 段的起始地址和结束地址。前面说了.bss 段是定义了但是没有被初始化的变量，我们需要手动对.bss 段的变量清零的，因此我们需要知道.bss 段的起始和结束地址，这样我们直接对这段内存赋 0 即可完成清零。通过第 11、 13 行代码， .bss 段的起始地址和结束地址就保存在了“__bss_start”和“__bss_end”中，我们就可以直接在汇编或者 C 文件里面使用这两个符号。

4. Makefile

点击查看 Makefile 文件 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
objs := start.o main.o

ledc.bin:$(objs)
	arm-linux-gnueabihf-ld -Timx6ul.lds -o ledc.elf $^
	arm-linux-gnueabihf-objcopy -O binary -S ledc.elf $@
	arm-linux-gnueabihf-objdump -D -m arm ledc.elf > ledc.dis
	
%.o:%.s
	arm-linux-gnueabihf-gcc -Wall -nostdlib -c -O2 -o $@ $<
	
%.o:%.S
	arm-linux-gnueabihf-gcc -Wall -nostdlib -c -O2 -o $@ $<
	
%.o:%.c
	arm-linux-gnueabihf-gcc -Wall -nostdlib -c -O2 -o $@ $<
	
clean:
	rm -rf *.o ledc.bin ledc.elf ledc.dis

四、编译运行

1. 编译程序

我们直接执行make命令，就会得到我们所需要的所有文件：

1
make
image-20230719201608630

2. 烧写程序

我们采用之前正点原子所提供的工具来在ubuntu下烧写到sd卡即可，感觉还是比较方便得。

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

3. 实验现象

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