IMX6ULL学习笔记(16)——GPIO输入接口使用(官方SD
一、GPIO简介
i.MX6ULL 芯片的 GPIO 被分成 5 组,并且每组 GPIO 的数量不尽相同,例如 GPIO1 拥有 32 个引脚, GPIO2 拥有 22 个引脚, 其他 GPIO 分组的数量以及每个 GPIO 的功能请参考 《i.MX 6UltraLite Applications Processor Reference Manual》 第26章General Purpose Input/Output (GPIO)(P1133)。
通过 GPIO 硬件结构框图,就可以从整体上深入了解 GPIO 外设及它的各种应用模式。
1.1 IO命名
打开 i.MX6ULL 参考手册的第 32 章“Chapter 32: IOMUX Controller(IOMUXC)”
i.MX6ULL 的 IO 分为两类:SNVS 域的和通用的,这两类 IO 本质上都是一样的。
“IOMUXC_SW_MUX_CTL_PAD_GPIO1_IO00”的就是 GPIO 命名,命名形式就是“IOMUXC_SW_MUC_CTL_PAD_XX_XX
”,后面的“XX_XX
”就是 GPIO 命名,比如:GPIO1_IO01、UART1_TX_DATA、JTAG_MOD 等等。他是 根据某个 IO 所拥有的功能来命名的。比如我们一看到 GPIO1_IO01 就知道这个肯定能做 GPIO,看到 UART1_TX_DATA 肯定就知道这个 IO 肯定能做为 UART1 的发送引脚。
IO 复用功能。 i.MX6ULL 除了 GPIO1_IO00~GPIO1_IO09 引脚外,其它 IO 也是可以复用为 GPIO 功能。同样的,GPIO1_IO00~GPIO_IO09 也是可以复用为其它外设引脚。
1.2 IO复用
IOMUX 译为 IO 复用选择器。i.MX6ULL 的芯片每个 GPIO 都通过 IOMUX 支持多种功能, 例如一个 IO 可用于网络外设 ENET 的数据接收引脚,也可以被配置成 PWM 外设的输出引脚, 这样的设计大大增加了芯片的适用性,这样可选的功能就是由 IOMUX 实现的。IOMUX 相当于增加了多根内部信号线与 IO 引脚相连,
最多有 8 根,也就是说一个 IO 最多可支持 8 种可选的功能
。
以“IOMUXC_SW_MUX_CTL_PAD_GPIO1_IO00”这个 IO 为例,打开参考手册的 1568 页。
可以看到有个名为:IOMUXC_SW_MUX_CTL_PAD_GPIO1_IO00 的寄存器,寄存器地址为 0X020E005C,这个寄存器是 32 位的,但是只用到了最低 5 位,其中 bit0~bit3(MUX_MODE) 就是设置 GPIO1_IO00 的复用功能的。GPIO1_IO00 一共可以复用为 9 种功能 IO,分别对应 ALT0~ALT8,其中 ALT5 就是作为 GPIO1_IO00。GPIO1_IO00 还可以作为 I2C2_SCL、GPT1_CAPTURE1、ANATOP_OTG1_ID 等。
1.3 IO配置
IOMUX 由其左侧的 IOMUXC 控制(C表示Controler),IOMUXC 提供寄存器给用户进行配置, 它又分成 MUX Mode(IO模式控制) 以及 Pad Settings(Pad配置) 两个部分:
在 IOMUXC 外设中关于 MUX Mode 和 Pad Settings 寄存器命名格式如下:
IOMUXC控制类型 | 寄存器名称 |
---|---|
MUX Mode | IOMUXC_SW_MUX_CTL_PAD_XXXX |
Pad Settings | IOMUXC_SW_PAD_CTL_PAD_XXXX |
每个引脚都包含这两个寄存器,表中的XXXX表示引脚的名字
1.3.1 MUX Mode配置
MUX Mode 就是用来
配置引脚的复用功能
,即选择引脚具体是用于网络外设 ENET 的数据接收, 还是用于 PWM 外设的输出引脚,当然,也可以配置成普通的 IO 口,仅用于控制输出高低电平。
以 GPIO1_IO04 引脚为例对 MUX 寄存器进行说明,该引脚相应的 MUX 寄存器在参考手册中的描述如下:
该寄存器主要有两个配置域,分别是 SION 和 MUX_MODE。
- SION: 用于设置引脚在输出模式下同时开启输入通道。
-
MUX_MODE: 使用 4 个寄存器位表示可选的 ALT0~ALT7 这 8 个模式。
- 如 ALT2 模式就是用于 USB 外设的 USB_OTG1_PWR 信号;
- 若配置为 ALT5 则引脚会用作普通的 GPIO 功能, 用于输出高、低电平。
1.3.2 Pad Settings配置
Pad Settings 用于
配置引脚的属性
,例如驱动能力,是否使用上下拉电阻, 是否使用保持器,是否使用开漏模式以及使用施密特模式还是CMOS模式等。
以 GPIO1_IO04 引脚中 PAD 寄存器在参考手册中的描述如下:
相对来说 PAD 寄存器的配置项就更丰富了,而且图中仅是该寄存器的部分说明,如 HYS 设置使用施密特模式的滞后功能,PUS 配置上下拉电阻的阻值, 其它的还包含PUE、PKE、ODE、SPEED、DSE 及 SRE 的配置。
1.3.3 PAD(可跳过不看)
PAD 代表了一个 i.MX6ULL 的 GPIO 引脚。在它的左侧是一系列信号通道及控制线,如 input_on 控制输入开关,Dir 控制引脚的输入输出方向,Data_out 控制引脚输出高低电平,Data_in 作为信号输入,这些信号都经过一个 IOMUX 的器件连接到左侧的寄存器。
①PAD引脚
代表一个i.MX6ULL的引脚。
②输出缓冲区
当输出缓冲区使能时,引脚被配置为输出模式。在输出缓冲区中,又包含了如下的属性配置:
-
DSE驱动能力
当IO用作输出的时候用来设置IO的驱动能力。
DSE可以调整芯片内部与引脚串联电阻R0的大小,从而改变引脚的驱动能力。例如,R0的初始值为260欧姆,在3.3V电压下其电流驱动能力为12.69mA,通过DSE可以把R0的值配置为原值的1/2、1/3…1/7等。位设置 速度 000 输出驱动关闭 001 R0(3.3V 下 R0 是 260Ω,1.8V 下 R0 是 150Ω,接 DDR 的时候是 240Ω) 010 R0/2 011 R0/3 100 R0/4 101 R0/5 110 R0/6 111 R0/7 -
SRE压摆率配置
设置压摆率。
压摆率是指电压转换速率,可理解为电压由波谷升到波峰的时间。增大压摆率可减少输出电压的上升时间。i.MX6ULL的引脚通过SRE支持低速和高速压摆率这两种配置。当此位为0的时候是低压摆率,当为1的时候是高压摆率。压摆率是大信号特性,下面的带宽是小信号特性。 -
SPEED带宽配置
设置IO的带宽。
分别可设置为50MHz、100MHz以及200MHz。带宽的意思是能通过这个IO口最高的信号频率,通俗点讲就是方波不失真,如果超过这个频率方波就变正弦波。但是这个带宽要区别于IO的翻转速率,IO的翻转速率的信号来自于GPIO这个外设,而IO的带宽只是限制了IO口引脚的物理特性,IO口的信号可以来自于内部定时器输出的PWM信号,也可以来自于GPIO翻转输出的信号,两者相比之下,PWM信号的频率是远远高于GPIO翻转输出的信号频率。位设置 速度 00 低速 50M 01 中速 100M 10 中速 100M 11 最大速度 200M -
ODE开漏输出配置
设置引脚是否工作在开漏输出模式。
在该模式时引脚可以输出高阻态和低电平,此位为0的时候禁止开路输出,当此位为1的时候就使能开路输出功能。输出高阻态时可由外部上拉电阻拉至高电平。开漏输出模式常用在一些通讯总线中,如I2C。
③输入缓冲区
当输入缓冲区使能时,引脚被配置为输入模式。在输入缓冲区中,又包含了如下的属性配置:
- HYS滞后使能
用来使能迟滞比较器。
i.MX6ULL的输入检测可以使用普通的CMOS检测或施密特触发器模式(滞后模式)。施密特触发器具有滞后效应,对正向和负向变化的输入信有不同的阈值电压。如果需要对输入波形进行整形的话可以使能此位。此位为0的时候禁止迟滞比较器,为1的时候使能迟滞比较器。常被用于电子开关、波形变换等场合,其转换特性和对比如下,如检测按键时,使用施密特模式即可起到消抖的功能。
④Pull/Keeper上下拉、保持器
引脚的控制逻辑中还包含了上下拉、保持器的功能。芯片内部的上拉和下拉电阻可以将不确定的信号钳位在高、低电平,或小幅提高的电流输出能力,上拉提供输出电流,下拉提供输入电流。注意这些上下拉配置只是弱拉,对于类似I2C之类的总线,还是必须使用外部上拉电阻。i.MX6ULL芯片的电源模块中包含转换器,当转换器停止工作时,保持器会保持输入输出电压。
上下拉、保持器可以通过如下属性配置:
- PUS上下拉配置
设置上下拉电阻。
PUS可配置项可选为100K欧下拉以及22K欧、47K欧及100K欧上拉。位设置 含义 00 100K 下拉 01 47K 上拉 10 100K 上拉 11 22K 上拉 - PUE上下拉、保持器选择
上下拉功能和保持器功能是二选一的,可以通过PUE来选择。
当IO作为输入的时候,这个位用来设置 IO 使用上下拉还是状态保持器。当为0的时候使用状态保持器,当为1的时候使用上下拉。状态保持器在IO作为输入的时候才有用,顾名思义,就是当外部电路断电以后此IO口可以保持住以前的状态。 - PKE上下拉、保持器配置
用来使能或者禁止上下拉/状态保持器功能。
为0时禁止上下拉/状态保持器,为1时使能上下拉和状态保持器。
注意,当引脚被配置为输出模式时,不管上下拉、保持器是什么配置,它们都会被关闭。
1.4 GPIO配置
GPIO 模块是每个 IO 都具有的外设,它具有 IO 控制最基本的功能,如输出高低电平、检测电平输入等。 它也占用 IOMUX 分配的复用信号,也就是说使用 GPIO 模块功能时同样需要使用 IOMUX 选中 GPIO 外设,对其 GPIO 的功能进行配置。
1.4.1 GDIR方向寄存器
设置某个 IO 的工作方向。
控制一个 GPIO 引脚时,要先用 GDIR 方向寄存器配置该引脚用于输出电平信号还是用作输入检测。 典型的例子是使用输出模式可以控制LED灯的亮灭,输入模式时可以用来检测按键是否按下。
GDIR 寄存器的每一个数据位代表一个引脚的方向,对应的位被设置为0时该引脚为输入模式,被设置为1时该引脚为输出模式。
例如,对 GPIO1 的 GDIR 寄存器的 bit3 位被写入为 1,那么 GPIO1.3 引脚的模式即为输出。
1.4.2 DR数据寄存器
DR 数据寄存器直接代表了引脚的电平状态
,它也使用 1 个数据位表示 1 个引脚的电平,每位用 1 表示高电平,用 0 表示低电平。
当 GDIR 方向寄存器设置引脚为输出模式时,写入 DR 数据寄存器对应的位即可控制该引脚输出的电平状态, 如这时 GPIO1 的 DR 寄存器的 bit4 被写入为 1,则引脚为输出高电平。
当 GDIR 方向寄存器设置引脚为输入模式时,读取 DR 数据寄存器对应的位即可获取该引脚当前的输入电平状态,例如这里读取 GPIO1 的DR寄存器的 bit4,得到该位的值为 0,表示当前引脚的输入状态为低电平。
1.4.3 PSR引脚状态寄存器
读取相应的位即可获取对应的 GPIO 的状态
,也就是 GPIO 的高低电平值。PSR 引脚状态寄存器相当于 DR 寄存器的简化版,它仅在 GDIR 方向寄存器设置为输入模式时有效,它的每个位表示一个引脚当前的输入电平状态。PSR 寄存器的权限是只读的,对它进行写操作是无效的。
特别地,当引脚被配置成输出模式时,若 IOMUXC 中的 MUX 寄存器使能了 SION 功能(输出通道回环至输入), 可以通过 PSR 寄存器读取回引脚的状态值。
二、官方SDK库文件
使用汇编语言和C语言实现点亮LED灯。需要自己查找、定义那么多寄存器。这样做的缺点很明显,易错、费时、代码可读性差。NXP官方SDK中已经将所有的寄存器以及所有可用引脚的复用功能定义好了。
2.1 寄存器定义文件
在官方SDK的 “SDK_2.2_MCIM6ULL_EBF6ULL/devices/MCIMX6Y2” 目录下, 头文件
“ MCIMX6Y2.h”
文件多达4万多行,包含了i.MX6U芯片几乎所有的寄存器定义以及中断编号的定义。
这里只列 GPIO1相关寄存器 的部分代码。其他寄存器定义与此类似。 添加这些定义之后我们就可以 直接使用 “GPIO1->DR”
语句操作GPIO1的DR寄存器。操作方法与STM32非常相似。
typedef struct {
__IO uint32_t DR; /**< GPIO data register, offset: 0x0 */
__IO uint32_t GDIR; /**< GPIO direction register, offset: 0x4 */
__I uint32_t PSR; /**< GPIO pad status register, offset: 0x8 */
__IO uint32_t ICR1; /**< GPIO interrupt configuration register1,*/
__IO uint32_t ICR2; /**< GPIO interrupt configuration register2, */
__IO uint32_t IMR; /**< GPIO interrupt mask register, offset: 0x14 */
__IO uint32_t ISR; /**< GPIO interrupt status register, offset: 0x18 */
__IO uint32_t EDGE_SEL;/**< GPIO edge select register, offset: 0x1C */
} GPIO_Type;
/*********************以下代码省略***************************8*/
/** Peripheral GPIO1 base address */
#define GPIO1_BASE (0x209C000u)
/** Peripheral GPIO1 base pointer */
#define GPIO1 ((GPIO_Type *)GPIO1_BASE)
2.2 引脚复用和引脚属性定义文件
使用每一个引脚之前我们都要选择引脚的复用功能以及引脚的pad属性。在官方SDK中定义了所有可用引脚以及这些引脚的所有复用功能,我们需要哪种复用功能只需要选择即可,并且官方SDK中提供了初始化函数。
-
定义引脚的复用功能
这里只列出了“GPIO1_IO00”引脚的复用功能,其他引脚类似。每个引脚对应多个宏定义代表引脚的不同的复用功能,以宏“IOMUXC_GPIO1_IO00_I2C2_SCL”为例,它表示“GPIO1_IO00”引脚复用为“I2C2”的“SCL”引脚。这些宏定义将会用作某些函数的入口参数。
#define IOMUXC_GPIO1_IO00_I2C2_SCL \
0x020E005CU, 0x0U, 0x020E05ACU, 0x1U, 0x020E02E8U
#define IOMUXC_GPIO1_IO00_GPT1_CAPTURE1L \
0x020E005CU, 0x1U, 0x020E058CU, 0x0U, 0x020E02E8U
#define IOMUXC_GPIO1_IO00_ANATOP_OTG1_IDL \
0x020E005CU, 0x2U, 0x020E04B8U, 0x0U, 0x020E02E8U
#define IOMUXC_GPIO1_IO00_ENET1_REF_CLK1L \
0x020E005CU, 0x3U, 0x020E0574U, 0x0U, 0x020E02E8U
#define IOMUXC_GPIO1_IO00_MQS_RIGHTL \
0x020E005CU, 0x4U, 0x00000000U, 0x0U, 0x020E02E8U
#define IOMUXC_GPIO1_IO00_GPIO1_IO00L \
0x020E005CU, 0x5U, 0x00000000U, 0x0U, 0x020E02E8U
#define IOMUXC_GPIO1_IO00_ENET1_1588_EVENT0_INL \
0x020E005CU, 0x6U, 0x00000000U, 0x0U, 0x020E02E8U
#define IOMUXC_GPIO1_IO00_SRC_SYSTEM_RESETL \
0x020E005CU, 0x7U, 0x00000000U, 0x0U, 0x020E02E8U
#define IOMUXC_GPIO1_IO00_WDOG3_WDOG_BL \
0x020E005CU, 0x8U, 0x00000000U, 0x0U, 0x020E02E8U
#define IOMUXC_GPIO1_IO01_I2C2_SDAL \
0x020E0060U, 0x0U, 0x020E05B0U, 0x1U, 0x020E02ECU
#define IOMUXC_GPIO1_IO01_GPT1_COMPARE1L \
0x020E0060U, 0x1U, 0x00000000U, 0x0U, 0x020E02ECU
#define IOMUXC_GPIO1_IO01_USB_OTG1_OCL \
0x020E0060U, 0x2U, 0x020E0664U, 0x0U, 0x020E02ECU
-
引脚复用功能设置函数
IOMUXC_SetPinMux()
拥有6个入口参数, 但是前五个是通过上面的宏定义自动完成设置的。而第6个入口参数“inputOnfiled”用于设置是否开启读回引脚电平功能。
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);
}
}
-
引脚PAD属性设置函数
IOMUXC_SetPinConfig()
函数共有6个入口参数,其中前五个是通过上面的宏定义自动完成设置的。而第6个参数用于设置PAD属性,根据每个引脚拥有一个32位PAD属性寄存器。第六个参数就是设置要填入PAD属性寄存器的值。
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;
}
}
三、引脚确定
我使用的是 野火_EBF6ULL S1 Pro
开发板
KEY按键连接至
SNVS_TAMPER1
引脚,用作普通的按键。
板上4个按键的信息及相应GPIO端口引脚号的总结具体如下:
按键 | 丝印编号 | GPIO功能 | 按键按下时的电平 | 其它功能 |
---|---|---|---|---|
RST复位按键 | SW1 | 不支持 | 低电平 | 复位芯片 |
ON/OFF按键 | SW3 | 不支持 | 低电平 | 从低功耗唤醒 |
MODE按键 | SW4 | 支持 | BOOT_MODE[0]与BOOT_MODE[1]相反 | 选择芯片启动方式 |
KEY按键 | SW2 | 支持 | 高电平 | 无 |
四、编程流程
1. 移植官方寄存器定义文件
2. 移植引脚复用以及引脚属性定义文件
3. 使用官方定义的寄存器、引脚设置函数实现以下步骤
4. 开启GPIO时钟
5. 设置引脚的复用功能以及引脚属性
6. 设置引脚方向以及输出电平
7. 查询按键输入控制LED
五、宏定义实现PAD属性设置
通常情况下一个引脚要设置8种PAD属性,而这些属性只能通过数字指定。为简化PAD属性设置野火编写了一个PAD属性配置文件 pad_config.h
(embed_linux_driver_tutorial_imx6_code/bare_metal/led_rgb_c/pad_config.h),这里使用宏定义了引脚可选的PAD属性值,并且通过宏定义的名字很容易知道宏代表的属性值:
/* SPEED 带宽配置 */
#define SPEED_0_LOW_50MHz IOMUXC_SW_PAD_CTL_PAD_SPEED(0)
#define SPEED_1_MEDIUM_100MHz IOMUXC_SW_PAD_CTL_PAD_SPEED(1)
#define SPEED_2_MEDIUM_100MHz IOMUXC_SW_PAD_CTL_PAD_SPEED(2)
#define SPEED_3_MAX_200MHz IOMUXC_SW_PAD_CTL_PAD_SPEED(3)
/* PUE 选择使用保持器还是上下拉 */
#define PUE_0_KEEPER_SELECTED IOMUXC_SW_PAD_CTL_PAD_PUE(0)
#define PUE_1_PULL_SELECTED IOMUXC_SW_PAD_CTL_PAD_PUE(1)
/* PUS 上下拉配置 */
#define PUS_0_100K_OHM_PULL_DOWN IOMUXC_SW_PAD_CTL_PAD_PUS(0)
#define PUS_1_47K_OHM_PULL_UP IOMUXC_SW_PAD_CTL_PAD_PUS(1)
#define PUS_2_100K_OHM_PULL_UP IOMUXC_SW_PAD_CTL_PAD_PUS(2)
#define PUS_3_22K_OHM_PULL_UP IOMUXC_SW_PAD_CTL_PAD_PUS(3)
完整的代码请阅读源文件,这里只列出了文件“pad_config.h”部分代码(embed_linux_driver_tutorial_imx6_code/bare_metal/led_rgb_c/pad_config.h)。
六、编写启动文件
在 Ubuntu 下创建 start.S
文件用于编写启动文件。
在汇编文件中设置“栈地址”
并执行跳转命令跳转到main函数
执行C代码。
6.1 完整代码
/***********************第一部分*********************/
.text //代码段
.align 2 //设置2字节对齐
.global _start //定义一个全局标号
/*************************第二部分*************************/
_start: //程序的开始
b reset //跳转到reset标号处
/*************************第三部分*************************/
reset:
mrc p15, 0, r0, c1, c0, 0 /* 将 CP15 协处理器中的寄存器数据读到 ARM 寄存器中 */
bic r0, r0, #(0x1 << 12) /* 清除第12位(I位)禁用 I Cache */
bic r0, r0, #(0x1 << 2) /* 清除第 2位(C位)禁用 D Cache */
bic r0, r0, #0x2 /* 清除第 1位(A位)禁止严格对齐 */
bic r0, r0, #(0x1 << 11) /* 清除第11位(Z位)分支预测 */
bic r0, r0, #0x1 /* 清除第 0位(M位)禁用 MMU */
mcr p15, 0, r0, c1, c0, 0 /* 将 ARM 寄存器的数据写入到 CP15 协处理器寄存器中 */
/***********************第四部分*********************/
ldr sp, =0x84000000 //设置栈地址64M
b main //跳转到main函数
/***********************第五部分*******************/
/*进入死循环*/
loop:
b loop
6.2 分析代码
-
第一部分
.text
定义代码段。
.align 2
设置字节对齐。
.global _start
生命全局标号_start。
/*************************第一部分*************************/
.text //代码段
.align 2 //设置2字节对齐
.global _start //定义一个全局标号
-
第二部分
_start:
定义标号_start: ,它位于汇编的最前面,说以会首先被执行。
b reset
使用b指令将程序跳转到reset标号处。
/*************************第二部分*************************/
_start: //程序的开始
b reset //跳转到reset标号处
-
第三部分
通过修改CP15寄存器(系统控制寄存器)
关闭 I Cache 、D Cache、MMU 等等。
我们暂时用不到的功能,如果开启可能会影响我们裸机运行,为避免不必要的麻烦暂时关闭这些功能。
/*************************第三部分*************************/
reset:
mrc p15, 0, r0, c1, c0, 0 /* 将 CP15 协处理器中的寄存器数据读到 ARM 寄存器中 */
bic r0, r0, #(0x1 << 12) /* 清除第12位(I位)禁用 I Cache */
bic r0, r0, #(0x1 << 2) /* 清除第 2位(C位)禁用 D Cache */
bic r0, r0, #0x2 /* 清除第 1位(A位)禁止严格对齐 */
bic r0, r0, #(0x1 << 11) /* 清除第11位(Z位)分支预测 */
bic r0, r0, #0x1 /* 清除第 0位(M位)禁用 MMU */
mcr p15, 0, r0, c1, c0, 0 /* 将 ARM 寄存器的数据写入到 CP15 协处理器寄存器中 */
-
第四部分
ldr sp, =0x84000000
用于设置栈指针。野火i.MX6ULL开发板标配512M的DDR内存,裸机开发用不了这么多。程序中我们将栈地址设置到DDR的64M地址处。 这个值也可以根据需要自行定义。
b main
只用跳转指令跳转到main函数中执行。
/***********************第四部分*********************/
ldr sp, =0x84000000 //设置栈地址64M
b main //跳转到main函数
-
第五部分
b loop
是“无返回”的跳转指令。正常情况下,不会执行第五部分代码。
/***********************第五部分*******************/
/*进入死循环*/
loop:
b loop
七、编写C语言代码
在 Ubuntu 下创建 button.c
文件用于查询按键控制 LED。
7.1 完整代码
/*************************第一部分************************/
#include "MCIMX6Y2.h"
#include "fsl_iomuxc.h"
#include "pad_config.h"
/*************************第二部分************************/
/*LED GPIO端口、引脚号及IOMUXC复用宏定义*/
#define RGB_RED_LED_GPIO GPIO1
#define RGB_RED_LED_GPIO_PIN (4U)
#define RGB_RED_LED_IOMUXC IOMUXC_GPIO1_IO04_GPIO1_IO04
#define RGB_GREEN_LED_GPIO GPIO4
#define RGB_GREEN_LED_GPIO_PIN (20U)
#define RGB_GREEN_LED_IOMUXC IOMUXC_CSI_HSYNC_GPIO4_IO20
#define RGB_BLUE_LED_GPIO GPIO4
#define RGB_BLUE_LED_GPIO_PIN (19U)
#define RGB_BLUE_LED_IOMUXC IOMUXC_CSI_VSYNC_GPIO4_IO19
/*按键2 GPIO端口、引脚号及IOMUXC复用宏定义*/
#define button2_GPIO GPIO5
#define button2_GPIO_PIN (1U)
#define button2_IOMUXC IOMUXC_SNVS_SNVS_TAMPER1_GPIO5_IO01
/*************************第三部分************************/
/* 按键PAD配置 */
#define button_PAD_CONFIG_DATA (SRE_0_SLOW_SLEW_RATE| \
DSE_6_R0_6| \
SPEED_2_MEDIUM_100MHz| \
ODE_0_OPEN_DRAIN_DISABLED| \
PKE_0_PULL_KEEPER_DISABLED| \
PUE_0_KEEPER_SELECTED| \
PUS_0_100K_OHM_PULL_DOWN| \
HYS_1_HYSTERESIS_ENABLED)
/* 配置说明 : */
/* 转换速率: 转换速率慢
驱动强度: R0/6
带宽配置 : medium(100MHz)
开漏配置: 关闭
拉/保持器配置: 关闭
拉/保持器选择: 保持器(上面已关闭,配置无效)
上拉/下拉选择: 100K欧姆下拉(上面已关闭,配置无效)
滞回器配置: 开启 */
/* 所有引脚均使用同样的PAD配置 */
#define LED_PAD_CONFIG_DATA (SRE_0_SLOW_SLEW_RATE| \
DSE_6_R0_6| \
SPEED_2_MEDIUM_100MHz| \
ODE_0_OPEN_DRAIN_DISABLED| \
PKE_0_PULL_KEEPER_DISABLED| \
PUE_0_KEEPER_SELECTED| \
PUS_0_100K_OHM_PULL_DOWN| \
HYS_0_HYSTERESIS_DISABLED)
/* 配置说明 : */
/* 转换速率: 转换速率慢
驱动强度: R0/6
带宽配置 : medium(100MHz)
开漏配置: 关闭
拉/保持器配置: 关闭
拉/保持器选择: 保持器(上面已关闭,配置无效)
上拉/下拉选择: 100K欧姆下拉(上面已关闭,配置无效)
滞回器配置: 关闭 */
/*简单延时函数*/
void delay(uint32_t count)
{
volatile uint32_t i = 0;
for (i = 0; i < count; ++i)
{
__asm("NOP"); /* 调用nop空指令 */
}
}
int main()
{
/*led初始化*/
CCM_CCGR1_CG13(0x3);//开启GPIO1的时钟
CCM_CCGR3_CG6(0x3); //开启GPIO4的时钟
/*设置 红灯 引脚的复用功能以及PAD属性*/
IOMUXC_SetPinMux(RGB_RED_LED_IOMUXC,0);
IOMUXC_SetPinConfig(RGB_RED_LED_IOMUXC, LED_PAD_CONFIG_DATA);
/*设置 绿灯 引脚的复用功能以及PAD属性*/
IOMUXC_SetPinMux(RGB_GREEN_LED_IOMUXC,0);
IOMUXC_SetPinConfig(RGB_GREEN_LED_IOMUXC, LED_PAD_CONFIG_DATA);
/*设置 蓝灯 引脚的复用功能以及PAD属性*/
IOMUXC_SetPinMux(button2_IOMUXC,0);
IOMUXC_SetPinConfig(button2_IOMUXC, LED_PAD_CONFIG_DATA);
GPIO1->GDIR |= (1<<4); //设置GPIO1_04为输出模式
GPIO1->DR |= (1<<4); //设置GPIO1_04输出电平为高电平
GPIO4->GDIR |= (1<<20); //设置GPIO4_20为输出模式
GPIO4->DR |= (1<<20); //设置GPIO4_20输出电平为高电平
GPIO4->GDIR |= (1<<19); //设置GPIO4_19为输出模式
GPIO4->DR |= (1<<19); //设置GPIO4_19输出电平为高电平
/*************************第四部分************************/
/*按键初始化*/
CCM_CCGR1_CG15(0x3); //开启GPIO5的时钟
/*************************第五部分************************/
/*设置 绿灯 引脚的复用功能以及PAD属性*/
IOMUXC_SetPinMux(RGB_GREEN_LED_IOMUXC,0);
IOMUXC_SetPinConfig(RGB_GREEN_LED_IOMUXC, button_PAD_CONFIG_DATA);
/*************************第六部分************************/
GPIO5->GDIR &= ~(1<<1); //设置GPIO5_01为输入模式
/*************************第七部分************************/
while(1)
{
if((GPIO5->DR)&(1<<1))
{
delay(0xFF);
if((GPIO5->DR)&(1<<1))
{
/*有按键按下,执行绿色led灯翻转*/
if((GPIO4->DR)&(1<<20))
{
GPIO4->DR &= ~(1<<20); //绿灯亮
while((GPIO5->DR)&(1<<1));//等待按键松开
}
else
{
GPIO4->DR |= (1<<20); //绿灯灭
while((GPIO5->DR)&(1<<1));//等待按键松开
}
}
}
}
return 0;
}
7.2 分析代码
-
第一部分:添加头文件
文件“MCIMX6Y2.h”
和“fsl_iomuxc.h”
来自SDK。 文件“pad_config.h”
是野火编写的文件,在其他工程中可直接使用。
/*************************第一部分************************/
#include "MCIMX6Y2.h"
#include "fsl_iomuxc.h"
#include "pad_config.h"
- 第二部分:定义按键使用到的引脚
/*************************第二部分************************/
#define button2_GPIO GPIO5
#define button2_GPIO_PIN (1U)
#define button2_IOMUXC IOMUXC_SNVS_SNVS_TAMPER1_GPIO5_IO01
-
第三部分:设置按键引脚的PAD属性
PAD属性宏定义保存在“pad_config.h”
文件中,这里使用“|”
运算符将所有属性设置“合并”在一起,后面将作为函数参数。与LED灯引脚PAD属性差别是这里开启了滞回器的功能。
/*************************第三部分************************/
/* 按键PAD配置 */
#define button_PAD_CONFIG_DATA (SRE_0_SLOW_SLEW_RATE| \
DSE_6_R0_6| \
SPEED_2_MEDIUM_100MHz| \
ODE_0_OPEN_DRAIN_DISABLED| \
PKE_0_PULL_KEEPER_DISABLED| \
PUE_0_KEEPER_SELECTED| \
PUS_0_100K_OHM_PULL_DOWN| \
HYS_1_HYSTERESIS_ENABLED)
/* 配置说明 : */
/* 转换速率: 转换速率慢
驱动强度: R0/6
带宽配置 : medium(100MHz)
开漏配置: 关闭
拉/保持器配置: 关闭
拉/保持器选择: 保持器(上面已关闭,配置无效)
上拉/下拉选择: 100K欧姆下拉(上面已关闭,配置无效)
滞回器配置: 开启 */
按键机械触点断开、闭合时,由于触点的弹性作用,按键开关不会马上稳定接通或一下子断开,使用按键时会产生下图中的带波纹信号,需要用软件消抖处理滤波,不方便输入检测。
不过i.MX6U的GPIO引脚带有施密特触发器功能,使用该功能可以对信号实现硬件消抖处理, 从而简化了软件的工作,软件只需要直接检测引脚的电平即可。
- 第四部分:开启GPIO时钟
/*************************第四部分************************/
/*按键初始化*/
CCM_CCGR1_CG15(0x3); //开启GPIO5的时钟
- 第五部分:设置引脚的复用功能以及引脚PAD属性
/*************************第五部分************************/
IOMUXC_SetPinMux(RGB_GREEN_LED_IOMUXC,0);
IOMUXC_SetPinConfig(RGB_GREEN_LED_IOMUXC, button_PAD_CONFIG_DATA);
- 第六部分:设置GPIO为输入
/*************************第六部分************************/
GPIO5->GDIR &= ~(1<<1); //设置GPIO5_01为输入模式
-
第七部分:在while(1)死循环中检测按键的状态
如果按键按下则翻转绿灯状态并等待按键松开。
/*************************第七部分************************/
while(1)
{
if((GPIO5->DR)&(1<<1))
{
delay(0xFF);
if((GPIO5->DR)&(1<<1))
{
/*有按键按下,执行绿色led灯翻转*/
if((GPIO4->DR)&(1<<20))
{
GPIO4->DR &= ~(1<<20); //绿灯亮
while((GPIO5->DR)&(1<<1));//等待按键松开
}
else
{
GPIO4->DR |= (1<<20); //绿灯灭
while((GPIO5->DR)&(1<<1));//等待按键松开
}
}
}
}
八、编写链接脚本
写好的代码(无论是汇编还是C语言)都要经过编译、汇编、链接等步骤生成二进制文件或者可供下载的文件。在编译阶编译器会对每个源文件进行语法检查并生成对应的汇编语言,汇编是将汇编文件转化为机器码。
使用
arm-none-eabi-gcc -g -c led.S -o led.o
命令完成源码的编译、汇编工作,生成了.o
文件。编译和汇编是针对单个源文件,也就编译完成后一个源文件(.c
,.S
或.s
)对应一个.o
文件。程序链接阶段就会将这些.o
链接成一个文件。链接脚本的作用就是告诉编译器怎么链接这些文件,比如那个文件放在最前面,程序的代码段、数据段、bss段分别放在什么位置等等。
在 Ubuntu 下创建 button.lds
链接脚本。
8.1 完整代码
ENTRY(_start)
SECTIONS {
. = 0x80000000;
. = ALIGN(4);
.text :
{
start.o (.text)
*(.text)
}
. = ALIGN(4);
.data :
{
*(.data)
}
. = ALIGN(4);
.bss :
{
*(.bss)
}
}
8.2 分析代码
-
指定程序的入口
ENTRY(_start)
用于指定程序的入口,ENTRY()
是设置入口地址的命令,“_start”
是程序的入口,led程序的入口地址位于start.S
的“_start”
标号处。
ENTRY(_start)
-
定义SECTIONS
SECTIONS
可以理解为是一块区域,我们在这块区域排布我们的代码,链接时链接器就会按照这里的指示链接我们的代码。
SECTIONS {
···
···
}
-
定义链接起始地址
“.”
运算符代表当前位置。 我们在SECTION的最开始使用“.= 0x80000000”
就是将链接起始地址设置为0x80000000。
. = 0x80000000;
-
设置字节对齐
“. = ALIGN(4);”
它表示从当前位置开始执行四字节对齐。假设当前位置为0x80000001,执行该命令后当前地址将会空出三个字节转到0x80000004地址处。 -
设置代码段
“.text :”
用于定义代码段,固定的语法要求,我们按照要求写即可。在“{}”中指定那些内容放在代码段。
将start.o
中的代码放到代码段的最前面。start.S
是启动代码应当首先被执行,所以通常情况下要把它放到代码段的最前面,其他源文件的代码按照系统默认的排放顺序即可,通配符“*”
在这里表示其他剩余所有的.o
文件。
. = ALIGN(4);
.text :
{
start.o (.text)
*(.text)
}
-
设置数据段
同设置代码段类似,首先设置字节对齐,然后定义代码段。在数据段里使用“*”
通配符, 将所有源文件中的代码添加到这个数据段中。
. = ALIGN(4);
.data :
{
*(.data)
}
-
设置BSS段
设置方法与设置数据段完全相同。
. = ALIGN(4);
.bss :
{
*(.bss)
}
九、编写makefile文件
程序编写完成后需要依次输入编译、链接、格式转换命令才能最终生成二进制文件。这种编译方式效率低、容易出错。
使用
makefile
只需要在所在文件夹下执行make
命令,makefile工具便会自动完成程序的编译、链接、格式转换等工作。正常情况下我们可以在当前目录看到生成的一些中间文件以及我们期待的.bin
文件。
在 Ubuntu 下创建 makefile
文件。
9.1 完整代码
all: start.o button.o
arm-none-eabi-ld -Tbutton.lds $^ -o button.elf
arm-none-eabi-objcopy -O binary -S -g button.elf button.bin
%.o : %.S
arm-none-eabi-gcc -g -c $^ -o start.o
%.o : %.c
arm-none-eabi-gcc -g -c $^ -o button.o
.PHONY: clean
clean:
rm *.o *.elf *.bin
9.2 分析代码
- 添加最终目标以及依赖文件
all: start.o button.o
-
添加链接命令
“-Tled.lds”
表示使用led.lds链接脚本链接程序。
“$^”
代表所有的依赖文件。
“-o”
指定输出文件名。
arm-none-eabi-ld -Tbutton.lds $^ -o button.elf
-
添加格式转换命令
“-O binary”
指定输出二进制文件。
“-S”
不从源文件中复制重定位信息和符号信息。
“-g”
不从源文件中复制可调试信息。
arm-none-eabi-objcopy -O binary -S -g button.elf button.bin
-
添加汇编文件编译命令
“$^”
替代要编译的源文件。
%.o : %.S
arm-none-eabi-gcc -g -c $^ -o start.o
-
添加编译C文件的命令
“$^”
替代要编译的源文件。
%.o : %.c
arm-none-eabi-gcc -g -c $^ -o button.o
-
添加清理命令
“.PHONY”
定义了伪目标“clean”。伪目标一般没有依赖,并且“clean”
伪目标一般放在Makefile文件的末尾。
“clean”
为目标用于删除make生成的文件。
.PHONY: clean
clean:
rm *.o *.elf *.bin
十、编译下载验证
10.1 编译代码
make
执行make命令,生成button.bin文件。
10.2 代码烧写
编译成功后会在当前文件夹下生成.bin文件,这个.bin文件也不能直接放到开发板上运行, 这次是因为需要在.bin文件缺少启动相关信息。
为二进制文件添加头部信息并烧写到SD卡。查看 IMX6ULL学习笔记(12)——通过SD卡启动官方SDK程序
进入烧写工具目录,执行 ./mkimage.sh <烧写文件路径>
命令,例如要烧写的 button.bin 位于 home 目录下,则烧写命令为 ./mkimage.sh /home/button.bin
。
执行上一步后会列出linux下可烧写的磁盘,选择你插入的SD卡即可。这一步 非常危险!!!一定要确定选择的是你插入的SD卡!!,如果选错很可能破坏你电脑磁盘内容,造成数据损坏!!! 确定磁盘后SD卡以“sd”开头,选择“sd”后面的字符即可。例如要烧写的sd卡是“sdb”则输入“b”即可。
10.3 实验现象
将开发板设置为SD卡启动,接入SD卡,开发板上电,按下KEY按键,LED绿灯亮,再按则绿灯灭。
• 由 Leung 写于 2022 年 12 月 26 日
• 参考:8. GPIO输入—按键查询检测