STM32F4 External interrupts
Each STM32F4 device has 23 external interrupt or event sources.
They are split into 2 sections.
First interrupt section is for external pins (P0 to P15) on each port,
and other section is for other events, like RTC interrupt, Ethernet interrupt, USB interrupt and so on.
GPIO as Interrupt
Interrupt lines
I will show now how to configure GPIO pin to be an interrupt and how to handle it in your code with CMSIS function.
In section one (GPIOs) we have 16 interrupt lines.
They are line0 to line15 and they also represent pin number.
This means, PA0 is connected to Line0and PA13 is connected to Line13.
You have to know that PB0 is also connected to Line0 and PC0 also and so on.
This is for all pins on board, All Px0 (where x is GPIO name) pins are connected to Line0
and let’s say all Px3 are connected to Line3 on the Interrupt channel.
All pins with same number are connected to line with same number.
They are multiplexed to one line.
IMPORTANT: You can not use two pins on one line simultaneously:
- PA0 and PB0 and PC0 and so on, are connected to Line0,
so you can use only one pin at one time to handle interrupt from there. - PA0 and PA5 are connected to different lines, they can be used at the same time.
Each line can trigger an interrupt on rising, falling or rising_falling enge on signal.
Interrupt handlers
OK, now you have selected your pin you want to use.
But you have to handle interrupt somehow.
This process is described below.
STM32F4 has 7 interrupt handlers for GPIO pins.
They are in table below:
Irq | Handler | Description |
---|---|---|
EXTI0_IRQn | EXTI0_IRQHandler | Handler for pins connected to line 0 |
EXTI1_IRQn | EXTI1_IRQHandler | Handler for pins connected to line 1 |
EXTI2_IRQn | EXTI2_IRQHandler | Handler for pins connected to line 2 |
EXTI3_IRQn | EXTI3_IRQHandler | Handler for pins connected to line 3 |
EXTI4_IRQn | EXTI4_IRQHandler | Handler for pins connected to line 4 |
EXTI9_5_IRQn | EXTI9_5_IRQHandler | Handler for pins connected to line 5 to 9 |
EXTI15_10_IRQn | EXTI15_10_IRQHandler | Handler for pins connected to line 10 to 15 |
This table show you which IRQ you have to set for NVIC (first column)
and function names to handle your interrupts (second column).
You have probably also figured, that only lines 0 to 4 have own IRQ handler.
Yes, lines 5-9 have the same interrupt handler and this is also for lines 10 to 15.
After you set settings for EXTI, you have to add them into NVIC.
Example
In this example, we will set pin PD0 and PB12 to be a GPIO interrupts.
Code below should be well documented to understand how it works.
/** * External interrupts example * * @author Tilen Majerle * @email [email protected] * @website http://stm32f4-discovery.com * @ide Keil uVision 5 */ #include "stm32f4xx.h" #include "stm32f4xx_exti.h" #include "stm32f4xx_syscfg.h" #include "misc.h" /* Configure pins to be interrupts */ void Configure_PD0(void) { /* Set variables used */ GPIO_InitTypeDef GPIO_InitStruct; EXTI_InitTypeDef EXTI_InitStruct; NVIC_InitTypeDef NVIC_InitStruct; /* Enable clock for GPIOD */ RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOD, ENABLE); /* Enable clock for SYSCFG */ RCC_APB2PeriphClockCmd(RCC_APB2Periph_SYSCFG, ENABLE); /* Set pin as input */ GPIO_InitStruct.GPIO_Mode = GPIO_Mode_IN; GPIO_InitStruct.GPIO_OType = GPIO_OType_PP; GPIO_InitStruct.GPIO_Pin = GPIO_Pin_0; GPIO_InitStruct.GPIO_PuPd = GPIO_PuPd_UP; GPIO_InitStruct.GPIO_Speed = GPIO_Speed_100MHz; GPIO_Init(GPIOD, &GPIO_InitStruct); /* Tell system that you will use PD0 for EXTI_Line0 */ SYSCFG_EXTILineConfig(EXTI_PortSourceGPIOD, EXTI_PinSource0); /* PD0 is connected to EXTI_Line0 */ EXTI_InitStruct.EXTI_Line = EXTI_Line0; /* Enable interrupt */ EXTI_InitStruct.EXTI_LineCmd = ENABLE; /* Interrupt mode */ EXTI_InitStruct.EXTI_Mode = EXTI_Mode_Interrupt; /* Triggers on rising and falling edge */ EXTI_InitStruct.EXTI_Trigger = EXTI_Trigger_Rising_Falling; /* Add to EXTI */ EXTI_Init(&EXTI_InitStruct); /* Add IRQ vector to NVIC */ /* PD0 is connected to EXTI_Line0, which has EXTI0_IRQn vector */ NVIC_InitStruct.NVIC_IRQChannel = EXTI0_IRQn; /* Set priority */ NVIC_InitStruct.NVIC_IRQChannelPreemptionPriority = 0x00; /* Set sub priority */ NVIC_InitStruct.NVIC_IRQChannelSubPriority = 0x00; /* Enable interrupt */ NVIC_InitStruct.NVIC_IRQChannelCmd = ENABLE; /* Add to NVIC */ NVIC_Init(&NVIC_InitStruct); } void Configure_PB12(void) { /* Set variables used */ GPIO_InitTypeDef GPIO_InitStruct; EXTI_InitTypeDef EXTI_InitStruct; NVIC_InitTypeDef NVIC_InitStruct; /* Enable clock for GPIOB */ RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOB, ENABLE); /* Enable clock for SYSCFG */ RCC_APB2PeriphClockCmd(RCC_APB2Periph_SYSCFG, ENABLE); /* Set pin as input */ GPIO_InitStruct.GPIO_Mode = GPIO_Mode_IN; GPIO_InitStruct.GPIO_OType = GPIO_OType_PP; GPIO_InitStruct.GPIO_Pin = GPIO_Pin_12; GPIO_InitStruct.GPIO_PuPd = GPIO_PuPd_UP; GPIO_InitStruct.GPIO_Speed = GPIO_Speed_100MHz; GPIO_Init(GPIOB, &GPIO_InitStruct); /* Tell system that you will use PB12 for EXTI_Line12 */ SYSCFG_EXTILineConfig(EXTI_PortSourceGPIOB, EXTI_PinSource12); /* PB12 is connected to EXTI_Line12 */ EXTI_InitStruct.EXTI_Line = EXTI_Line12; /* Enable interrupt */ EXTI_InitStruct.EXTI_LineCmd = ENABLE; /* Interrupt mode */ EXTI_InitStruct.EXTI_Mode = EXTI_Mode_Interrupt; /* Triggers on rising and falling edge */ EXTI_InitStruct.EXTI_Trigger = EXTI_Trigger_Rising_Falling; /* Add to EXTI */ EXTI_Init(&EXTI_InitStruct); /* Add IRQ vector to NVIC */ /* PB12 is connected to EXTI_Line12, which has EXTI15_10_IRQn vector */ NVIC_InitStruct.NVIC_IRQChannel = EXTI15_10_IRQn; /* Set priority */ NVIC_InitStruct.NVIC_IRQChannelPreemptionPriority = 0x00; /* Set sub priority */ NVIC_InitStruct.NVIC_IRQChannelSubPriority = 0x01; /* Enable interrupt */ NVIC_InitStruct.NVIC_IRQChannelCmd = ENABLE; /* Add to NVIC */ NVIC_Init(&NVIC_InitStruct); } /* Set interrupt handlers */ /* Handle PD0 interrupt */ void EXTI0_IRQHandler(void) { /* Make sure that interrupt flag is set */ if (EXTI_GetITStatus(EXTI_Line0) != RESET) { /* Do your stuff when PD0 is changed */ /* Clear interrupt flag */ EXTI_ClearITPendingBit(EXTI_Line0); } } /* Handle PB12 interrupt */ void EXTI15_10_IRQHandler(void) { /* Make sure that interrupt flag is set */ if (EXTI_GetITStatus(EXTI_Line12) != RESET) { /* Do your stuff when PB12 is changed */ /* Clear interrupt flag */ EXTI_ClearITPendingBit(EXTI_Line12); } } int main(void) { /* System init */ SystemInit(); /* Configure PD0 as interrupt */ Configure_PD0(); /* Configure PB12 as interrupt */ Configure_PB12(); while (1) { } }