fix(PeriphDrivers): Fix UART DMA Transactions and Enable Full Duplex

Libraries/CMSIS/Device/Maxim/MAX32665/Include/max32665.h

@@ -499,6 +499,10 @@ typedef enum {
                  ((i) == 7) ? DMA15_IRQn : \
                               0))
 
+#define MXC_DMA_CH_GET_IRQ(i)                                                       \
+    (((i) > (MXC_DMA_CH_OFFSET - 1)) ? MXC_DMA1_CH_GET_IRQ(i % MXC_DMA_CH_OFFSET) : \
+                                       MXC_DMA0_CH_GET_IRQ(i))
+
 /* Create alias for MXC_DMA0 for backwards compatibility with code that was
    written for parts that only had one DMA instance. */
 #define MXC_DMA MXC_DMA0

Libraries/PeriphDrivers/Include/MAX32520/uart.h

@@ -41,6 +41,7 @@
 #define LIBRARIES_PERIPHDRIVERS_INCLUDE_MAX32520_UART_H_
 
 /***** Definitions *****/
+#include <stdbool.h>
 #include "uart_regs.h"
 #include "mxc_sys.h"
 
@@ -612,6 +613,69 @@ uint32_t MXC_UART_GetAsyncTXCount(mxc_uart_req_t *req);
  */
 uint32_t MXC_UART_GetAsyncRXCount(mxc_uart_req_t *req);
 
+/**
+ * @brief Enable or disable automatic DMA interrupt handlers for the UART module.
+ * 
+ * The @ref MXC_UART_TransactionDMA functions require special interrupt handlers to work.
+ *  
+ * When "Auto" DMA handlers are enabled, the UART drivers will acquire DMA channels
+ * and assign the appropriate handlers automatically.  The acquired channels are
+ * released after each transaction.
+ * 
+ * If "Auto" DMA handlers are disabled, the user must acquire DMA channels manually
+ * and assign them to the drivers with the @ref MXC_UART_SetTXDMAChannel and
+ * @ref MXC_UART_SetRXDMAChannel functions.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @param enable true to enable Auto DMA handlers, false to disable.
+ * @return 0 on success, or a non-zero error code on failure.
+ */
+int MXC_UART_SetAutoDMAHandlers(mxc_uart_regs_t *uart, bool enable);
+
+/**
+ * @brief Set the TX (Transmit) DMA channel for a UART module.
+ *
+ * This function assigns the DMA channel for transmitting data
+ * when @ref is MXC_UART_SetAutoDMAHandlers disabled.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @param channel The DMA channel number to be used for @ref MXC_UART_TransactionDMA.
+ */
+int MXC_UART_SetTXDMAChannel(mxc_uart_regs_t *uart, unsigned int channel);
+
+/**
+ * @brief Get the TX (Transmit) DMA channel for a UART module.
+ *
+ * This function retrieves the currently assigned DMA channel for transmitting data
+ * when @ref is MXC_UART_SetAutoDMAHandlers disabled.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @return The currently assigned TX DMA channel.
+ */
+int MXC_UART_GetTXDMAChannel(mxc_uart_regs_t *uart);
+
+/**
+ * @brief Set the RX (Receive) DMA channel for a UART module.
+ *
+ * This function assigns the DMA channel for receiving data
+ * when @ref is MXC_UART_SetAutoDMAHandlers disabled.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @param channel The DMA channel number to be used for @ref MXC_UART_TransactionDMA.
+ */
+int MXC_UART_SetRXDMAChannel(mxc_uart_regs_t *uart, unsigned int channel);
+
+/**
+ * @brief Get the RX (Receive) DMA channel for a UART module.
+ *
+ * This function retrieves the currently configured DMA channel for receiving data
+ * when @ref is MXC_UART_SetAutoDMAHandlers disabled.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @return The currently configured RX DMA channel.
+ */
+int MXC_UART_GetRXDMAChannel(mxc_uart_regs_t *uart);
+
 /**@} end of group uart */
 
 #ifdef __cplusplus

Libraries/PeriphDrivers/Include/MAX32570/uart.h

@@ -41,6 +41,7 @@
 #define LIBRARIES_PERIPHDRIVERS_INCLUDE_MAX32570_UART_H_
 
 /***** Definitions *****/
+#include <stdbool.h>
 #include "uart_regs.h"
 #include "mxc_sys.h"
 
@@ -700,6 +701,69 @@ uint32_t MXC_UART_GetAsyncTXCount(mxc_uart_req_t *req);
  */
 uint32_t MXC_UART_GetAsyncRXCount(mxc_uart_req_t *req);
 
+/**
+ * @brief Enable or disable automatic DMA interrupt handlers for the UART module.
+ * 
+ * The @ref MXC_UART_TransactionDMA functions require special interrupt handlers to work.
+ *  
+ * When "Auto" DMA handlers are enabled, the UART drivers will acquire DMA channels
+ * and assign the appropriate handlers automatically.  The acquired channels are
+ * released after each transaction.
+ * 
+ * If "Auto" DMA handlers are disabled, the user must acquire DMA channels manually
+ * and assign them to the drivers with the @ref MXC_UART_SetTXDMAChannel and
+ * @ref MXC_UART_SetRXDMAChannel functions.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @param enable true to enable Auto DMA handlers, false to disable.
+ * @return 0 on success, or a non-zero error code on failure.
+ */
+int MXC_UART_SetAutoDMAHandlers(mxc_uart_regs_t *uart, bool enable);
+
+/**
+ * @brief Set the TX (Transmit) DMA channel for a UART module.
+ *
+ * This function assigns the DMA channel for transmitting data
+ * when @ref is MXC_UART_SetAutoDMAHandlers disabled.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @param channel The DMA channel number to be used for @ref MXC_UART_TransactionDMA.
+ */
+int MXC_UART_SetTXDMAChannel(mxc_uart_regs_t *uart, unsigned int channel);
+
+/**
+ * @brief Get the TX (Transmit) DMA channel for a UART module.
+ *
+ * This function retrieves the currently assigned DMA channel for transmitting data
+ * when @ref is MXC_UART_SetAutoDMAHandlers disabled.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @return The currently assigned TX DMA channel.
+ */
+int MXC_UART_GetTXDMAChannel(mxc_uart_regs_t *uart);
+
+/**
+ * @brief Set the RX (Receive) DMA channel for a UART module.
+ *
+ * This function assigns the DMA channel for receiving data
+ * when @ref is MXC_UART_SetAutoDMAHandlers disabled.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @param channel The DMA channel number to be used for @ref MXC_UART_TransactionDMA.
+ */
+int MXC_UART_SetRXDMAChannel(mxc_uart_regs_t *uart, unsigned int channel);
+
+/**
+ * @brief Get the RX (Receive) DMA channel for a UART module.
+ *
+ * This function retrieves the currently configured DMA channel for receiving data
+ * when @ref is MXC_UART_SetAutoDMAHandlers disabled.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @return The currently configured RX DMA channel.
+ */
+int MXC_UART_GetRXDMAChannel(mxc_uart_regs_t *uart);
+
 /**@} end of group uart */
 
 #ifdef __cplusplus

Libraries/PeriphDrivers/Include/MAX32572/uart.h

@@ -41,6 +41,7 @@
 #define LIBRARIES_PERIPHDRIVERS_INCLUDE_MAX32572_UART_H_
 
 /***** Definitions *****/
+#include <stdbool.h>
 #include "uart_regs.h"
 #include "mxc_sys.h"
 
@@ -655,6 +656,69 @@ int MXC_UART_AbortAsync(mxc_uart_regs_t *uart);
  */
 int MXC_UART_AsyncHandler(mxc_uart_regs_t *uart);
 
+/**
+ * @brief Enable or disable automatic DMA interrupt handlers for the UART module.
+ * 
+ * The @ref MXC_UART_TransactionDMA functions require special interrupt handlers to work.
+ *  
+ * When "Auto" DMA handlers are enabled, the UART drivers will acquire DMA channels
+ * and assign the appropriate handlers automatically.  The acquired channels are
+ * released after each transaction.
+ * 
+ * If "Auto" DMA handlers are disabled, the user must acquire DMA channels manually
+ * and assign them to the drivers with the @ref MXC_UART_SetTXDMAChannel and
+ * @ref MXC_UART_SetRXDMAChannel functions.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @param enable true to enable Auto DMA handlers, false to disable.
+ * @return 0 on success, or a non-zero error code on failure.
+ */
+int MXC_UART_SetAutoDMAHandlers(mxc_uart_regs_t *uart, bool enable);
+
+/**
+ * @brief Set the TX (Transmit) DMA channel for a UART module.
+ *
+ * This function assigns the DMA channel for transmitting data
+ * when @ref is MXC_UART_SetAutoDMAHandlers disabled.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @param channel The DMA channel number to be used for @ref MXC_UART_TransactionDMA.
+ */
+int MXC_UART_SetTXDMAChannel(mxc_uart_regs_t *uart, unsigned int channel);
+
+/**
+ * @brief Get the TX (Transmit) DMA channel for a UART module.
+ *
+ * This function retrieves the currently assigned DMA channel for transmitting data
+ * when @ref is MXC_UART_SetAutoDMAHandlers disabled.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @return The currently assigned TX DMA channel.
+ */
+int MXC_UART_GetTXDMAChannel(mxc_uart_regs_t *uart);
+
+/**
+ * @brief Set the RX (Receive) DMA channel for a UART module.
+ *
+ * This function assigns the DMA channel for receiving data
+ * when @ref is MXC_UART_SetAutoDMAHandlers disabled.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @param channel The DMA channel number to be used for @ref MXC_UART_TransactionDMA.
+ */
+int MXC_UART_SetRXDMAChannel(mxc_uart_regs_t *uart, unsigned int channel);
+
+/**
+ * @brief Get the RX (Receive) DMA channel for a UART module.
+ *
+ * This function retrieves the currently configured DMA channel for receiving data
+ * when @ref is MXC_UART_SetAutoDMAHandlers disabled.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @return The currently configured RX DMA channel.
+ */
+int MXC_UART_GetRXDMAChannel(mxc_uart_regs_t *uart);
+
 /**@} end of group uart */
 
 #ifdef __cplusplus

Libraries/PeriphDrivers/Include/MAX32650/uart.h

@@ -41,6 +41,7 @@
 #define LIBRARIES_PERIPHDRIVERS_INCLUDE_MAX32650_UART_H_
 
 /***** Includes *****/
+#include <stdbool.h>
 #include <stdint.h>
 #include "uart_regs.h"
 #include "mxc_sys.h"
@@ -664,6 +665,69 @@ uint32_t MXC_UART_GetAsyncTXCount(mxc_uart_req_t *req);
  */
 uint32_t MXC_UART_GetAsyncRXCount(mxc_uart_req_t *req);
 
+/**
+ * @brief Enable or disable automatic DMA interrupt handlers for the UART module.
+ * 
+ * The @ref MXC_UART_TransactionDMA functions require special interrupt handlers to work.
+ *  
+ * When "Auto" DMA handlers are enabled, the UART drivers will acquire DMA channels
+ * and assign the appropriate handlers automatically.  The acquired channels are
+ * released after each transaction.
+ * 
+ * If "Auto" DMA handlers are disabled, the user must acquire DMA channels manually
+ * and assign them to the drivers with the @ref MXC_UART_SetTXDMAChannel and
+ * @ref MXC_UART_SetRXDMAChannel functions.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @param enable true to enable Auto DMA handlers, false to disable.
+ * @return 0 on success, or a non-zero error code on failure.
+ */
+int MXC_UART_SetAutoDMAHandlers(mxc_uart_regs_t *uart, bool enable);
+
+/**
+ * @brief Set the TX (Transmit) DMA channel for a UART module.
+ *
+ * This function assigns the DMA channel for transmitting data
+ * when @ref is MXC_UART_SetAutoDMAHandlers disabled.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @param channel The DMA channel number to be used for @ref MXC_UART_TransactionDMA.
+ */
+int MXC_UART_SetTXDMAChannel(mxc_uart_regs_t *uart, unsigned int channel);
+
+/**
+ * @brief Get the TX (Transmit) DMA channel for a UART module.
+ *
+ * This function retrieves the currently assigned DMA channel for transmitting data
+ * when @ref is MXC_UART_SetAutoDMAHandlers disabled.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @return The currently assigned TX DMA channel.
+ */
+int MXC_UART_GetTXDMAChannel(mxc_uart_regs_t *uart);
+
+/**
+ * @brief Set the RX (Receive) DMA channel for a UART module.
+ *
+ * This function assigns the DMA channel for receiving data
+ * when @ref is MXC_UART_SetAutoDMAHandlers disabled.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @param channel The DMA channel number to be used for @ref MXC_UART_TransactionDMA.
+ */
+int MXC_UART_SetRXDMAChannel(mxc_uart_regs_t *uart, unsigned int channel);
+
+/**
+ * @brief Get the RX (Receive) DMA channel for a UART module.
+ *
+ * This function retrieves the currently configured DMA channel for receiving data
+ * when @ref is MXC_UART_SetAutoDMAHandlers disabled.
+ *
+ * @param uart Pointer to the UART module's registers.
+ * @return The currently configured RX DMA channel.
+ */
+int MXC_UART_GetRXDMAChannel(mxc_uart_regs_t *uart);
+
 /**@} end of group uart */
 
 #ifdef __cplusplus