feat(PeriphDrivers): Add new MXC_SPI_GetAndClearFlags API

petejohanson-adi · petejohanson-adi · commit 50d63a115730 · 2026-04-15T15:59:32.000-06:00
Add new MXC_SPI_GetAndClearFlags to simultaneously retrieve the current
interrupt flags, and clear only the returned flags. This avoids
accidentally clearing flags that have been set since a call to get the
current flags using the existing MXC_SPI_ClearFlags API.

Signed-off-by: Pete Johanson &lt;pete.johanson@analog.com&gt;
diff --git a/Libraries/PeriphDrivers/Include/MAX32520/spi.h b/Libraries/PeriphDrivers/Include/MAX32520/spi.h
@@ -470,6 +470,18 @@ unsigned int MXC_SPI_GetFlags(mxc_spi_regs_t *spi);
  */
 void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi);
 
+/**
+ * @brief   Gets and clears the interrupt flags that are currently set
+ *
+ * These functions should not be used while using non-blocking Transaction Level
+ * functions (Async or DMA)
+ *
+ * @param   spi         Pointer to SPI registers (selects the SPI block used.)
+ *
+ * @return The interrupt flags
+ */
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi);
+
 /**
  * @brief   Enables specific interrupts
  *
diff --git a/Libraries/PeriphDrivers/Include/MAX32570/spi.h b/Libraries/PeriphDrivers/Include/MAX32570/spi.h
@@ -478,6 +478,18 @@ unsigned int MXC_SPI_GetFlags(mxc_spi_regs_t *spi);
  */
 void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi);
 
+/**
+ * @brief   Gets and clears the interrupt flags that are currently set
+ *
+ * These functions should not be used while using non-blocking Transaction Level
+ * functions (Async or DMA)
+ *
+ * @param   spi         Pointer to SPI registers (selects the SPI block used.)
+ *
+ * @return The interrupt flags
+ */
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi);
+
 /**
  * @brief   Enables specific interrupts
  *
diff --git a/Libraries/PeriphDrivers/Include/MAX32572/spi.h b/Libraries/PeriphDrivers/Include/MAX32572/spi.h
@@ -320,6 +320,18 @@ unsigned int MXC_SPI_GetFlags(mxc_spi_regs_t *spi);
  */
 void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi);
 
+/**
+ * @brief   Gets and clears the interrupt flags that are currently set
+ *
+ * These functions should not be used while using non-blocking Transaction Level
+ * functions (Async or DMA)
+ *
+ * @param   spi         Pointer to SPI registers (selects the SPI block used.)
+ *
+ * @return The interrupt flags
+ */
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi);
+
 /**
  * @brief   Enables specific interrupts
  *
diff --git a/Libraries/PeriphDrivers/Include/MAX32650/spi.h b/Libraries/PeriphDrivers/Include/MAX32650/spi.h
@@ -480,6 +480,18 @@ unsigned int MXC_SPI_GetFlags(mxc_spi_regs_t *spi);
  */
 void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi);
 
+/**
+ * @brief   Gets and clears the interrupt flags that are currently set
+ *
+ * These functions should not be used while using non-blocking Transaction Level
+ * functions (Async or DMA)
+ *
+ * @param   spi         Pointer to SPI registers (selects the SPI block used.)
+ *
+ * @return The interrupt flags
+ */
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi);
+
 /**
  * @brief   Enables specific interrupts
  *
diff --git a/Libraries/PeriphDrivers/Include/MAX32655/spi.h b/Libraries/PeriphDrivers/Include/MAX32655/spi.h
@@ -523,6 +523,18 @@ unsigned int MXC_SPI_GetFlags(mxc_spi_regs_t *spi);
  */
 void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi);
 
+/**
+ * @brief   Gets and clears the interrupt flags that are currently set
+ *
+ * These functions should not be used while using non-blocking Transaction Level
+ * functions (Async or DMA)
+ *
+ * @param   spi         Pointer to SPI registers (selects the SPI block used.)
+ *
+ * @return The interrupt flags
+ */
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi);
+
 /**
  * @brief   Enables specific interrupts
  *
diff --git a/Libraries/PeriphDrivers/Include/MAX32657/spi.h b/Libraries/PeriphDrivers/Include/MAX32657/spi.h
@@ -522,6 +522,18 @@ unsigned int MXC_SPI_GetFlags(mxc_spi_regs_t *spi);
  */
 void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi);
 
+/**
+ * @brief   Gets and clears the interrupt flags that are currently set
+ *
+ * These functions should not be used while using non-blocking Transaction Level
+ * functions (Async or DMA)
+ *
+ * @param   spi         Pointer to SPI registers (selects the SPI block used.)
+ *
+ * @return The interrupt flags
+ */
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi);
+
 /**
  * @brief   Enables specific interrupts
  *
diff --git a/Libraries/PeriphDrivers/Include/MAX32660/spi.h b/Libraries/PeriphDrivers/Include/MAX32660/spi.h
@@ -476,6 +476,18 @@ unsigned int MXC_SPI_GetFlags(mxc_spi_regs_t *spi);
  */
 void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi);
 
+/**
+ * @brief   Gets and clears the interrupt flags that are currently set
+ *
+ * These functions should not be used while using non-blocking Transaction Level
+ * functions (Async or DMA)
+ *
+ * @param   spi         Pointer to SPI registers (selects the SPI block used.)
+ *
+ * @return The interrupt flags
+ */
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi);
+
 /**
  * @brief   Enables specific interrupts
  *
diff --git a/Libraries/PeriphDrivers/Include/MAX32662/spi.h b/Libraries/PeriphDrivers/Include/MAX32662/spi.h
@@ -501,6 +501,18 @@ unsigned int MXC_SPI_GetFlags(mxc_spi_regs_t *spi);
  */
 void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi);
 
+/**
+ * @brief   Gets and clears the interrupt flags that are currently set
+ *
+ * These functions should not be used while using non-blocking Transaction Level
+ * functions (Async or DMA)
+ *
+ * @param   spi         Pointer to SPI registers (selects the SPI block used.)
+ *
+ * @return The interrupt flags
+ */
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi);
+
 /**
  * @brief   Enables specific interrupts
  *
diff --git a/Libraries/PeriphDrivers/Include/MAX32665/spi.h b/Libraries/PeriphDrivers/Include/MAX32665/spi.h
@@ -478,6 +478,18 @@ unsigned int MXC_SPI_GetFlags(mxc_spi_regs_t *spi);
  */
 void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi);
 
+/**
+ * @brief   Gets and clears the interrupt flags that are currently set
+ *
+ * These functions should not be used while using non-blocking Transaction Level
+ * functions (Async or DMA)
+ *
+ * @param   spi         Pointer to SPI registers (selects the SPI block used.)
+ *
+ * @return The interrupt flags
+ */
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi);
+
 /**
  * @brief   Enables specific interrupts
  *
diff --git a/Libraries/PeriphDrivers/Include/MAX32670/spi.h b/Libraries/PeriphDrivers/Include/MAX32670/spi.h
@@ -476,6 +476,18 @@ unsigned int MXC_SPI_GetFlags(mxc_spi_regs_t *spi);
  */
 void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi);
 
+/**
+ * @brief   Gets and clears the interrupt flags that are currently set
+ *
+ * These functions should not be used while using non-blocking Transaction Level
+ * functions (Async or DMA)
+ *
+ * @param   spi         Pointer to SPI registers (selects the SPI block used.)
+ *
+ * @return The interrupt flags
+ */
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi);
+
 /**
  * @brief   Enables specific interrupts
  *
diff --git a/Libraries/PeriphDrivers/Include/MAX32672/spi.h b/Libraries/PeriphDrivers/Include/MAX32672/spi.h
@@ -475,6 +475,18 @@ unsigned int MXC_SPI_GetFlags(mxc_spi_regs_t *spi);
  */
 void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi);
 
+/**
+ * @brief   Gets and clears the interrupt flags that are currently set
+ *
+ * These functions should not be used while using non-blocking Transaction Level
+ * functions (Async or DMA)
+ *
+ * @param   spi         Pointer to SPI registers (selects the SPI block used.)
+ *
+ * @return The interrupt flags
+ */
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi);
+
 /**
  * @brief   Enables specific interrupts
  *
diff --git a/Libraries/PeriphDrivers/Include/MAX32675/spi.h b/Libraries/PeriphDrivers/Include/MAX32675/spi.h
@@ -475,6 +475,18 @@ unsigned int MXC_SPI_GetFlags(mxc_spi_regs_t *spi);
  */
 void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi);
 
+/**
+ * @brief   Gets and clears the interrupt flags that are currently set
+ *
+ * These functions should not be used while using non-blocking Transaction Level
+ * functions (Async or DMA)
+ *
+ * @param   spi         Pointer to SPI registers (selects the SPI block used.)
+ *
+ * @return The interrupt flags
+ */
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi);
+
 /**
  * @brief   Enables specific interrupts
  *
diff --git a/Libraries/PeriphDrivers/Include/MAX32680/spi.h b/Libraries/PeriphDrivers/Include/MAX32680/spi.h
@@ -499,6 +499,18 @@ unsigned int MXC_SPI_GetFlags(mxc_spi_regs_t *spi);
  */
 void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi);
 
+/**
+ * @brief   Gets and clears the interrupt flags that are currently set
+ *
+ * These functions should not be used while using non-blocking Transaction Level
+ * functions (Async or DMA)
+ *
+ * @param   spi         Pointer to SPI registers (selects the SPI block used.)
+ *
+ * @return The interrupt flags
+ */
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi);
+
 /**
  * @brief   Enables specific interrupts
  *
diff --git a/Libraries/PeriphDrivers/Include/MAX32690/spi.h b/Libraries/PeriphDrivers/Include/MAX32690/spi.h
@@ -318,6 +318,18 @@ unsigned int MXC_SPI_GetFlags(mxc_spi_regs_t *spi);
  */
 void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi);
 
+/**
+ * @brief   Gets and clears the interrupt flags that are currently set
+ *
+ * These functions should not be used while using non-blocking Transaction Level
+ * functions (Async or DMA)
+ *
+ * @param   spi         Pointer to SPI registers (selects the SPI block used.)
+ *
+ * @return The interrupt flags
+ */
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi);
+
 /**
  * @brief   Enables specific interrupts
  *
diff --git a/Libraries/PeriphDrivers/Include/MAX78000/spi.h b/Libraries/PeriphDrivers/Include/MAX78000/spi.h
@@ -494,6 +494,18 @@ unsigned int MXC_SPI_GetFlags(mxc_spi_regs_t *spi);
  */
 void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi);
 
+/**
+ * @brief   Gets and clears the interrupt flags that are currently set
+ *
+ * These functions should not be used while using non-blocking Transaction Level
+ * functions (Async or DMA)
+ *
+ * @param   spi         Pointer to SPI registers (selects the SPI block used.)
+ *
+ * @return The interrupt flags
+ */
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi);
+
 /**
  * @brief   Enables specific interrupts
  *
diff --git a/Libraries/PeriphDrivers/Include/MAX78002/spi.h b/Libraries/PeriphDrivers/Include/MAX78002/spi.h
@@ -319,6 +319,18 @@ unsigned int MXC_SPI_GetFlags(mxc_spi_regs_t *spi);
  */
 void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi);
 
+/**
+ * @brief   Gets and clears the interrupt flags that are currently set
+ *
+ * These functions should not be used while using non-blocking Transaction Level
+ * functions (Async or DMA)
+ *
+ * @param   spi         Pointer to SPI registers (selects the SPI block used.)
+ *
+ * @return The interrupt flags
+ */
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi);
+
 /**
  * @brief   Enables specific interrupts
  *
diff --git a/Libraries/PeriphDrivers/Source/SPI/spi_ai87.c b/Libraries/PeriphDrivers/Source/SPI/spi_ai87.c
@@ -373,6 +373,11 @@ void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi)
     MXC_SPI_RevA1_ClearFlags((mxc_spi_reva_regs_t *)spi);
 }
 
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi)
+{
+    return MXC_SPI_RevA1_GetAndClearFlags((mxc_spi_reva_regs_t *)spi);
+}
+
 void MXC_SPI_EnableInt(mxc_spi_regs_t *spi, unsigned int intEn)
 {
     MXC_SPI_RevA1_EnableInt((mxc_spi_reva_regs_t *)spi, intEn);
diff --git a/Libraries/PeriphDrivers/Source/SPI/spi_ai87_v2.c b/Libraries/PeriphDrivers/Source/SPI/spi_ai87_v2.c
@@ -273,6 +273,11 @@ void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi)
     MXC_SPI_RevA2_ClearFlags((mxc_spi_reva_regs_t *)spi);
 }
 
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi)
+{
+    return MXC_SPI_RevA2_GetAndClearFlags((mxc_spi_reva_regs_t *)spi);
+}
+
 void MXC_SPI_EnableInt(mxc_spi_regs_t *spi, unsigned int intEn)
 {
     MXC_SPI_RevA2_EnableInt((mxc_spi_reva_regs_t *)spi, (uint32_t)intEn);
diff --git a/Libraries/PeriphDrivers/Source/SPI/spi_me10.c b/Libraries/PeriphDrivers/Source/SPI/spi_me10.c
@@ -294,6 +294,11 @@ void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi)
     MXC_SPI_RevA1_ClearFlags((mxc_spi_reva_regs_t *)spi);
 }
 
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi)
+{
+    return MXC_SPI_RevA1_GetAndClearFlags((mxc_spi_reva_regs_t *)spi);
+}
+
 /* ************************************************************************ */
 void MXC_SPI_EnableInt(mxc_spi_regs_t *spi, unsigned int mask)
 {
diff --git a/Libraries/PeriphDrivers/Source/SPI/spi_me11.c b/Libraries/PeriphDrivers/Source/SPI/spi_me11.c
@@ -220,6 +220,11 @@ void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi)
     MXC_SPI_RevA1_ClearFlags((mxc_spi_reva_regs_t *)spi);
 }
 
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi)
+{
+    return MXC_SPI_RevA1_GetAndClearFlags((mxc_spi_reva_regs_t *)spi);
+}
+
 void MXC_SPI_EnableInt(mxc_spi_regs_t *spi, unsigned int mask)
 {
     MXC_SPI_RevA1_EnableInt((mxc_spi_reva_regs_t *)spi, mask);
diff --git a/Libraries/PeriphDrivers/Source/SPI/spi_me12.c b/Libraries/PeriphDrivers/Source/SPI/spi_me12.c
@@ -329,6 +329,11 @@ void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi)
     MXC_SPI_RevA1_ClearFlags((mxc_spi_reva_regs_t *)spi);
 }
 
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi)
+{
+    return MXC_SPI_RevA1_GetAndClearFlags((mxc_spi_reva_regs_t *)spi);
+}
+
 void MXC_SPI_EnableInt(mxc_spi_regs_t *spi, unsigned int intEn)
 {
     MXC_SPI_RevA1_EnableInt((mxc_spi_reva_regs_t *)spi, intEn);
diff --git a/Libraries/PeriphDrivers/Source/SPI/spi_me13.c b/Libraries/PeriphDrivers/Source/SPI/spi_me13.c
@@ -254,6 +254,11 @@ void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi)
     MXC_SPI_RevA1_ClearFlags((mxc_spi_reva_regs_t *)spi);
 }
 
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi)
+{
+    return MXC_SPI_RevA1_GetAndClearFlags((mxc_spi_reva_regs_t *)spi);
+}
+
 void MXC_SPI_EnableInt(mxc_spi_regs_t *spi, unsigned int mask)
 {
     MXC_SPI_RevA1_EnableInt((mxc_spi_reva_regs_t *)spi, mask);
diff --git a/Libraries/PeriphDrivers/Source/SPI/spi_me14.c b/Libraries/PeriphDrivers/Source/SPI/spi_me14.c
@@ -314,6 +314,11 @@ void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi)
     MXC_SPI_RevA1_ClearFlags((mxc_spi_reva_regs_t *)spi);
 }
 
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi)
+{
+    return MXC_SPI_RevA1_GetAndClearFlags((mxc_spi_reva_regs_t *)spi);
+}
+
 void MXC_SPI_EnableInt(mxc_spi_regs_t *spi, unsigned int mask)
 {
     MXC_SPI_RevA1_EnableInt((mxc_spi_reva_regs_t *)spi, mask);
diff --git a/Libraries/PeriphDrivers/Source/SPI/spi_me15.c b/Libraries/PeriphDrivers/Source/SPI/spi_me15.c
@@ -234,6 +234,11 @@ void MXC_SPI_ClearFlags(mxc_spi_regs_t *spi)
     MXC_SPI_RevA1_ClearFlags((mxc_spi_reva_regs_t *)spi);
 }
 
+unsigned int MXC_SPI_GetAndClearFlags(mxc_spi_regs_t *spi)
+{
+    return MXC_SPI_RevA1_GetAndClearFlags((mxc_spi_reva_regs_t *)spi);
+}
+
 void MXC_SPI_EnableInt(mxc_spi_regs_t *spi, unsigned int mask)
 {
     MXC_SPI_RevA1_EnableInt((mxc_spi_reva_regs_t *)spi, mask);
diff --git a/Libraries/PeriphDrivers/Source/SPI/spi_me16.c b/Libraries/PeriphDrivers/Source/SPI/spi_me16.c
diff --git a/Libraries/PeriphDrivers/Source/SPI/spi_me17.c b/Libraries/PeriphDrivers/Source/SPI/spi_me17.c
diff --git a/Libraries/PeriphDrivers/Source/SPI/spi_me18.c b/Libraries/PeriphDrivers/Source/SPI/spi_me18.c
diff --git a/Libraries/PeriphDrivers/Source/SPI/spi_me18_v2.c b/Libraries/PeriphDrivers/Source/SPI/spi_me18_v2.c
diff --git a/Libraries/PeriphDrivers/Source/SPI/spi_me21.c b/Libraries/PeriphDrivers/Source/SPI/spi_me21.c
diff --git a/Libraries/PeriphDrivers/Source/SPI/spi_me30.c b/Libraries/PeriphDrivers/Source/SPI/spi_me30.c
diff --git a/Libraries/PeriphDrivers/Source/SPI/spi_me55.c b/Libraries/PeriphDrivers/Source/SPI/spi_me55.c
diff --git a/Libraries/PeriphDrivers/Source/SPI/spi_me55_v2.c b/Libraries/PeriphDrivers/Source/SPI/spi_me55_v2.c
diff --git a/Libraries/PeriphDrivers/Source/SPI/spi_reva1.c b/Libraries/PeriphDrivers/Source/SPI/spi_reva1.c
diff --git a/Libraries/PeriphDrivers/Source/SPI/spi_reva2.c b/Libraries/PeriphDrivers/Source/SPI/spi_reva2.c
