From aaee0e429e496733647de374ea5388d3ea103082 Mon Sep 17 00:00:00 2001 From: Sid Chaudhary Date: Sun, 8 Nov 2026 02:27:45 +0000 Subject: [PATCH] sw: document that GPIO interrupt status reads clear all pins GPIO_INTRPT_STATUS is cleared on read as a whole, so gpio_pin_get_interrupt_status() also drops the pending status of every other pin. Say so in gpio.h and point to gpio_get_interrupt_status() for checking several pins. --- sw/lib/inc/gpio.h | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/sw/lib/inc/gpio.h b/sw/lib/inc/gpio.h index 70bf58592..0b506eb1c 100644 --- a/sw/lib/inc/gpio.h +++ b/sw/lib/inc/gpio.h @@ -32,7 +32,7 @@ uint32_t gpio_read(void); void gpio_enable_rising_interrupts(uint32_t mask); void gpio_enable_falling_interrupts(uint32_t mask); void gpio_disable_interrupts(uint32_t mask); -uint32_t gpio_get_interrupt_status(void); +uint32_t gpio_get_interrupt_status(void); // the status register is cleared on read // functions applying to only one GPIO pin // LSB is considered GPIO number 0 @@ -48,4 +48,6 @@ uint8_t gpio_pin_read(uint8_t gpio_pin); void gpio_pin_enable_rising_interrupt(uint8_t gpio_pin); void gpio_pin_enable_falling_interrupt(uint8_t gpio_pin); void gpio_pin_disable_interrupts(uint8_t gpio_pin); +// reads and clears the interrupt status of all pins, not only gpio_pin; +// to check several pins, call gpio_get_interrupt_status() once and test the bits uint8_t gpio_pin_get_interrupt_status(uint8_t gpio_pin);