Add peripheral interface files

Signed-off-by: Sadik.Ozer <Sadik.Ozer@maximintegrated.com>

Author: Sadik.Ozer

targets/TARGET_Maxim/TARGET_MAX32670/Libraries/PeriphDrivers/Include/MAX32670/crc.h

@@ -0,0 +1,185 @@
+/**
+ * @file    crc.h
+ * @brief   cyclic redundancy check driver.
+ */
+
+/* ****************************************************************************
+ * Copyright (C) 2022 Maxim Integrated Products, Inc., All Rights Reserved.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a
+ * copy of this software and associated documentation files (the "Software"),
+ * to deal in the Software without restriction, including without limitation
+ * the rights to use, copy, modify, merge, publish, distribute, sublicense,
+ * and/or sell copies of the Software, and to permit persons to whom the
+ * Software is furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included
+ * in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+ * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+ * IN NO EVENT SHALL MAXIM INTEGRATED BE LIABLE FOR ANY CLAIM, DAMAGES
+ * OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+ * OTHER DEALINGS IN THE SOFTWARE.
+ *
+ * Except as contained in this notice, the name of Maxim Integrated
+ * Products, Inc. shall not be used except as stated in the Maxim Integrated
+ * Products, Inc. Branding Policy.
+ *
+ * The mere transfer of this software does not imply any licenses
+ * of trade secrets, proprietary technology, copyrights, patents,
+ * trademarks, maskwork rights, or any other form of intellectual
+ * property whatsoever. Maxim Integrated Products, Inc. retains all
+ * ownership rights.
+ * 
+ *************************************************************************** */
+
+#ifndef _CRC_H_
+#define _CRC_H_
+
+/***** Includes *****/
+#include "crc_regs.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @defgroup crc CRC
+ * @ingroup periphlibs
+ * @{
+ */
+
+/***** CRC Definitions *****/
+/**
+  * @brief  Structure used to set up CRC request
+  *
+  */
+typedef struct _mxc_crc_req_t {
+    uint32_t* dataBuffer;     ///< Pointer to the data 
+    uint32_t dataLen;         ///< Length of the data
+    uint32_t resultCRC;       ///< Calculated CRC value
+} mxc_crc_req_t;
+
+/** 
+ * @brief CRC data bit order
+ *  
+ */
+typedef enum {
+    CRC_LSB_FIRST,
+    CRC_MSB_FIRST
+} mxc_crc_bitorder_t;
+
+/***** Function Prototypes *****/
+
+/* ************************************************************************* */
+/* Global Control/Configuration functions                                    */
+/* ************************************************************************* */
+
+/**
+ * @brief   Enable portions of the CRC
+ *
+ *
+ * @return  Success/Fail, see \ref MXC_Error_Codes for a list of return codes.
+ */
+int MXC_CRC_Init (void);
+
+/**
+ * @brief   Disable and reset portions of the CRC
+ *
+ * @return  Success/Fail, see \ref MXC_Error_Codes for a list of return codes.
+ */
+int MXC_CRC_Shutdown (void);
+
+/**
+ * @brief   This function should be called from the CRC ISR Handler
+ *          when using Async functions
+ * @param   ch      DMA channel
+ * @param   error   error
+ */
+void MXC_CRC_Handler (int ch, int error);
+
+/**
+ * @brief   Set the bit-order of CRC calculation
+ *
+ * @param   bitOrder  The direction to perform CRC calculation in
+ */
+void MXC_CRC_SetDirection (mxc_crc_bitorder_t bitOrder);
+
+/**
+ * @brief   Set the bit-order of CRC calculation
+ *
+ * @return  The direction of calculation, 1 for MSB first, 0 for LSB first
+ */
+mxc_crc_bitorder_t MXC_CRC_GetDirection (void);
+
+/**
+ * @brief   Byte Swap CRC Data Input
+ *
+ * @param   bitOrder  The direction to perform CRC calculation in
+ */
+void MXC_CRC_SwapDataIn (mxc_crc_bitorder_t bitOrder);
+
+/**
+ * @brief   Byte Swap CRC Data output
+ *
+ * @param   bitOrder  The direction to perform CRC calculation in
+ */
+void MXC_CRC_SwapDataOut (mxc_crc_bitorder_t bitOrder);
+
+/**
+ * @brief   Set the Polynomial for CRC calculation
+ *
+ * @param   poly  The polynomial to use for CRC calculation
+ */
+void MXC_CRC_SetPoly (uint32_t poly);
+
+/**
+ * @brief   Get the polynomial for CRC calculation
+ *
+ * @return  The polynomial used in calculation
+ */
+uint32_t MXC_CRC_GetPoly (void);
+
+/**
+ * @brief   Get the result of a CRC calculation
+ *
+ * @return  The calculated CRC value
+ */
+uint32_t MXC_CRC_GetResult (void);
+
+/*******************************/
+/* High Level Functions        */
+/*******************************/
+
+/**
+ * @brief   Perform a CRC computation
+ * @note    The result of the CRC calculation will be placed in the
+ *          mxc_crc_req_t structure
+ *
+ * @param   req   Structure containing the data for calculation
+ *
+ * @return  see \ref MXC_Error_Codes for a list of return codes.
+ */
+int MXC_CRC_Compute (mxc_crc_req_t* req);
+
+/**
+ * @brief   Perform a CRC computation using DMA
+ * @note    The result of the CRC calculation will be placed in the
+ *          mxc_crc_req_t structure. The user must call
+ *          MXC_DMA_Handler() in the ISR
+ *
+ * @param   req   Structure containing the data for calculation
+ * 
+ * @return  see \ref MXC_Error_Codes for a list of return codes.
+ */
+int MXC_CRC_ComputeAsync (mxc_crc_req_t* req);
+
+#ifdef __cplusplus
+}
+#endif
+/**@} end of group crc */
+
+#endif  /* _CRC_H_ */

targets/TARGET_Maxim/TARGET_MAX32670/Libraries/PeriphDrivers/Include/MAX32670/dma.h

@@ -4,7 +4,7 @@
  */
 
 /* ****************************************************************************
- * Copyright (C) Maxim Integrated Products, Inc., All Rights Reserved.
+ * Copyright (C) 2022 Maxim Integrated Products, Inc., All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a
  * copy of this software and associated documentation files (the "Software"),
@@ -42,7 +42,6 @@
 /* **** Includes **** */
 #include <stdbool.h>
 #include "mxc_device.h"
-#include "mxc_errors.h"
 #include "dma_regs.h"
 
 #ifdef __cplusplus
@@ -57,63 +56,75 @@ extern "C" {
 
 /* **** Definitions **** */
 
-
 /**
  * @brief   Enumeration for the DMA Channel's priority level.
  *
  */
 typedef enum {
-    MXC_DMA_PRIO_HIGH    = MXC_V_DMA_CFG_PRI_HIGH,      ///< High Priority */
-    MXC_DMA_PRIO_MEDHIGH = MXC_V_DMA_CFG_PRI_MEDHIGH,   ///< Medium High Priority */
-    MXC_DMA_PRIO_MEDLOW  = MXC_V_DMA_CFG_PRI_MEDLOW,    ///< Medium Low Priority */
-    MXC_DMA_PRIO_LOW     = MXC_V_DMA_CFG_PRI_LOW,       ///< Low Priority */
+    MXC_DMA_PRIO_HIGH    = MXC_V_DMA_CTRL_PRI_HIGH,      ///< High Priority */
+    MXC_DMA_PRIO_MEDHIGH = MXC_V_DMA_CTRL_PRI_MEDHIGH,   ///< Medium High Priority */
+    MXC_DMA_PRIO_MEDLOW  = MXC_V_DMA_CTRL_PRI_MEDLOW,    ///< Medium Low Priority */
+    MXC_DMA_PRIO_LOW     = MXC_V_DMA_CTRL_PRI_LOW,       ///< Low Priority */
 } mxc_dma_priority_t;
 
 /** @brief DMA request select */
 typedef enum {
-    MXC_DMA_REQUEST_MEMTOMEM = MXC_S_DMA_CFG_REQSEL_MEMTOMEM,  ///< Memory to Memory DMA Request Selection
-    MXC_DMA_REQUEST_SPI0RX   = MXC_S_DMA_CFG_REQSEL_SPI0RX,    ///< SPI0 Receive DMA Request Selection
-    MXC_DMA_REQUEST_SPI1RX   = MXC_S_DMA_CFG_REQSEL_SPI1RX,    ///< SPI1 Receive DMA Request Selection
-    MXC_DMA_REQUEST_UART0RX  = MXC_S_DMA_CFG_REQSEL_UART0RX,   ///< UART0 Receive DMA Request Selection
-    MXC_DMA_REQUEST_UART1RX  = MXC_S_DMA_CFG_REQSEL_UART1RX,   ///< UART1 Receive DMA Request Selection
-    MXC_DMA_REQUEST_I2C0RX   = MXC_S_DMA_CFG_REQSEL_I2C0RX,    ///< I2C0 Receive DMA Request Selection
-    MXC_DMA_REQUEST_I2C1RX   = MXC_S_DMA_CFG_REQSEL_I2C1RX,    ///< I2C1 Receive DMA Request Selection
-    MXC_DMA_REQUEST_SPI0TX   = MXC_S_DMA_CFG_REQSEL_SPI0TX,    ///< SPI0 Transmit DMA Request Selection
-    MXC_DMA_REQUEST_SPI1TX   = MXC_S_DMA_CFG_REQSEL_SPI1TX,    ///< SPI1 Transmit DMA Request Selection
-    MXC_DMA_REQUEST_UART0TX  = MXC_S_DMA_CFG_REQSEL_UART0TX,   ///< UART0 Transmit DMA Request Selection
-    MXC_DMA_REQUEST_UART1TX  = MXC_S_DMA_CFG_REQSEL_UART1TX,   ///< UART1 Transmit DMA Request Selection
-    MXC_DMA_REQUEST_I2C0TX   = MXC_S_DMA_CFG_REQSEL_I2C0TX,    ///< I2C0 Transmit DMA Request Selection
-    MXC_DMA_REQUEST_I2C1TX   = MXC_S_DMA_CFG_REQSEL_I2C1TX,    ///< I2C1 Transmit DMA Request Selection
+    MXC_DMA_REQUEST_MEMTOMEM = MXC_S_DMA_CTRL_REQUEST_MEMTOMEM,  ///< Memory to Memory DMA Request Selection 
+    MXC_DMA_REQUEST_SPI0RX   = MXC_S_DMA_CTRL_REQUEST_SPI0RX,    ///< SPI0 Receive DMA Request Selection 
+    MXC_DMA_REQUEST_SPI1RX   = MXC_S_DMA_CTRL_REQUEST_SPI1RX,    ///< SPI1 Receive DMA Request Selection 
+    MXC_DMA_REQUEST_SPI2RX   = MXC_S_DMA_CTRL_REQUEST_SPI2RX,    ///< SPI2 Receive DMA Request Selection 
+    MXC_DMA_REQUEST_UART0RX  = MXC_S_DMA_CTRL_REQUEST_UART0RX,   ///< UART0 Receive DMA Request Selection 
+    MXC_DMA_REQUEST_UART1RX  = MXC_S_DMA_CTRL_REQUEST_UART1RX,   ///< UART1 Receive DMA Request Selection 
+    MXC_DMA_REQUEST_I2C0RX   = MXC_S_DMA_CTRL_REQUEST_I2C0RX,    ///< I2C0 Receive DMA Request Selection 
+    MXC_DMA_REQUEST_I2C1RX   = MXC_S_DMA_CTRL_REQUEST_I2C1RX,    ///< I2C1 Receive DMA Request Selection 
+    MXC_DMA_REQUEST_I2C2RX   = MXC_S_DMA_CTRL_REQUEST_I2C2RX,    ///< I2C2 Receive DMA Request Selection 
+    MXC_DMA_REQUEST_UART2RX  = MXC_S_DMA_CTRL_REQUEST_UART2RX,   ///< UART2 Receive DMA Request Selection 
+    MXC_DMA_REQUEST_AESRX    = MXC_S_DMA_CTRL_REQUEST_AESRX,     ///< AES Receive DMA Request Selection 
+    MXC_DMA_REQUEST_UART3RX  = MXC_S_DMA_CTRL_REQUEST_UART3RX,   ///< UART3 Receive DMA Request Selection     
+    MXC_DMA_REQUEST_I2SRX    = MXC_S_DMA_CTRL_REQUEST_I2SRX,     ///< I2S Receive DMA Request Selection 
+    MXC_DMA_REQUEST_SPI0TX   = MXC_S_DMA_CTRL_REQUEST_SPI0TX,    ///< SPI0 Transmit DMA Request Selection 
+    MXC_DMA_REQUEST_SPI1TX   = MXC_S_DMA_CTRL_REQUEST_SPI1TX,    ///< SPI1 Transmit DMA Request Selection 
+    MXC_DMA_REQUEST_SPI2TX   = MXC_S_DMA_CTRL_REQUEST_SPI2TX,    ///< SPI2 Transmit DMA Request Selection 
+    MXC_DMA_REQUEST_UART0TX  = MXC_S_DMA_CTRL_REQUEST_UART0TX,   ///< UART0 Transmit DMA Request Selection 
+    MXC_DMA_REQUEST_UART1TX  = MXC_S_DMA_CTRL_REQUEST_UART1TX,   ///< UART1 Transmit DMA Request Selection 
+    MXC_DMA_REQUEST_I2C0TX   = MXC_S_DMA_CTRL_REQUEST_I2C0TX,    ///< I2C0 Transmit DMA Request Selection 
+    MXC_DMA_REQUEST_I2C1TX   = MXC_S_DMA_CTRL_REQUEST_I2C1TX,    ///< I2C1 Transmit DMA Request Selection 
+    MXC_DMA_REQUEST_I2C2TX   = MXC_S_DMA_CTRL_REQUEST_I2C2TX,    ///< I2C2 Transmit DMA Request Selection     
+    MXC_DMA_REQUEST_CRCTX    = MXC_S_DMA_CTRL_REQUEST_CRCTX,     ///< CRC Transmit DMA Request Selection 
+    MXC_DMA_REQUEST_UART2TX  = MXC_S_DMA_CTRL_REQUEST_UART2TX,   ///< UART2 Transmit DMA Request Selection 
+    MXC_DMA_REQUEST_AESTX    = MXC_S_DMA_CTRL_REQUEST_AESTX,     ///< AES Transmit DMA Request Selection 
+    MXC_DMA_REQUEST_UART3TX  = MXC_S_DMA_CTRL_REQUEST_UART3TX,   ///< UART3 Transmit DMA Request Selection     
+    MXC_DMA_REQUEST_I2STX    = MXC_S_DMA_CTRL_REQUEST_I2STX,     ///< I2S Transmit DMA Request Selection     
 } mxc_dma_reqsel_t;
 
 /** @brief Enumeration for the DMA prescaler */
 typedef enum {
-    MXC_DMA_PRESCALE_DISABLE = MXC_S_DMA_CFG_PSSEL_DIS,     ///< Prescaler disabled
-    MXC_DMA_PRESCALE_DIV256  = MXC_S_DMA_CFG_PSSEL_DIV256,  ///< Divide by 256
-    MXC_DMA_PRESCALE_DIV64K  = MXC_S_DMA_CFG_PSSEL_DIV64K,  ///< Divide by 65,536
-    MXC_DMA_PRESCALE_DIV16M  = MXC_S_DMA_CFG_PSSEL_DIV16M,  ///< Divide by 16,777,216
+    MXC_DMA_PRESCALE_DISABLE = MXC_S_DMA_CTRL_TO_CLKDIV_DIS,     ///< Prescaler disabled 
+    MXC_DMA_PRESCALE_DIV256  = MXC_S_DMA_CTRL_TO_CLKDIV_DIV256,  ///< Divide by 256 
+    MXC_DMA_PRESCALE_DIV64K  = MXC_S_DMA_CTRL_TO_CLKDIV_DIV64K,  ///< Divide by 65,536 
+    MXC_DMA_PRESCALE_DIV16M  = MXC_S_DMA_CTRL_TO_CLKDIV_DIV16M,  ///< Divide by 16,777,216 
 } mxc_dma_prescale_t;
 
 /** @brief Enumeration for the DMA timeout value */
 typedef enum {
-    MXC_DMA_TIMEOUT_4_CLK   = MXC_S_DMA_CFG_TOSEL_TO4,      ///< DMA timeout of 4 clocks
-    MXC_DMA_TIMEOUT_8_CLK   = MXC_S_DMA_CFG_TOSEL_TO8,      ///< DMA timeout of 8 clocks
-    MXC_DMA_TIMEOUT_16_CLK  = MXC_S_DMA_CFG_TOSEL_TO16,     ///< DMA timeout of 16 clocks
-    MXC_DMA_TIMEOUT_32_CLK  = MXC_S_DMA_CFG_TOSEL_TO32,     ///< DMA timeout of 32 clocks
-    MXC_DMA_TIMEOUT_64_CLK  = MXC_S_DMA_CFG_TOSEL_TO64,     ///< DMA timeout of 64 clocks
-    MXC_DMA_TIMEOUT_128_CLK = MXC_S_DMA_CFG_TOSEL_TO128,    ///< DMA timeout of 128 clocks
-    MXC_DMA_TIMEOUT_256_CLK = MXC_S_DMA_CFG_TOSEL_TO256,    ///< DMA timeout of 256 clocks
-    MXC_DMA_TIMEOUT_512_CLK = MXC_S_DMA_CFG_TOSEL_TO512,    ///< DMA timeout of 512 clocks
+    MXC_DMA_TIMEOUT_4_CLK   = MXC_S_DMA_CTRL_TO_PER_TO4,      ///< DMA timeout of 4 clocks 
+    MXC_DMA_TIMEOUT_8_CLK   = MXC_S_DMA_CTRL_TO_PER_TO8,      ///< DMA timeout of 8 clocks 
+    MXC_DMA_TIMEOUT_16_CLK  = MXC_S_DMA_CTRL_TO_PER_TO16,     ///< DMA timeout of 16 clocks 
+    MXC_DMA_TIMEOUT_32_CLK  = MXC_S_DMA_CTRL_TO_PER_TO32,     ///< DMA timeout of 32 clocks 
+    MXC_DMA_TIMEOUT_64_CLK  = MXC_S_DMA_CTRL_TO_PER_TO64,     ///< DMA timeout of 64 clocks 
+    MXC_DMA_TIMEOUT_128_CLK = MXC_S_DMA_CTRL_TO_PER_TO128,    ///< DMA timeout of 128 clocks
+    MXC_DMA_TIMEOUT_256_CLK = MXC_S_DMA_CTRL_TO_PER_TO256,    ///< DMA timeout of 256 clocks
+    MXC_DMA_TIMEOUT_512_CLK = MXC_S_DMA_CTRL_TO_PER_TO512,    ///< DMA timeout of 512 clocks
 } mxc_dma_timeout_t;
 
 /** @brief DMA transfer data width */
 typedef enum {
     /* Using the '_V_' define instead of the '_S_' since these same values will be used to
        specify the DSTWD also.  The API functions will shift the value the correct amount
        prior to writing the cfg register. */
-    MXC_DMA_WIDTH_BYTE     = MXC_V_DMA_CFG_SRCWD_BYTE,      ///< DMA transfer in bytes
-    MXC_DMA_WIDTH_HALFWORD = MXC_V_DMA_CFG_SRCWD_HALFWORD,  ///< DMA transfer in 16-bit half-words
-    MXC_DMA_WIDTH_WORD     = MXC_V_DMA_CFG_SRCWD_WORD,      ///< DMA transfer in 32-bit words
+    MXC_DMA_WIDTH_BYTE     = MXC_V_DMA_CTRL_SRCWD_BYTE,      ///< DMA transfer in bytes 
+    MXC_DMA_WIDTH_HALFWORD = MXC_V_DMA_CTRL_SRCWD_HALFWORD,  ///< DMA transfer in 16-bit half-words 
+    MXC_DMA_WIDTH_WORD     = MXC_V_DMA_CTRL_SRCWD_WORD,      ///< DMA transfer in 32-bit words 
 } mxc_dma_width_t;
 
 /**
@@ -246,7 +257,7 @@ int MXC_DMA_SetSrcDst (mxc_dma_srcdst_t srcdst);
  *
  * @return     See \ref MXC_Error_Codes for a list of return values
  */
-int MXC_DMA_GetSrcDst (mxc_dma_srcdst_t *srcdst);
+int MXC_DMA_GetSrcDst (mxc_dma_srcdst_t* srcdst);
 
 /**
  * @brief      Set channel reload source, destination, and count for the transfer
@@ -266,7 +277,7 @@ int MXC_DMA_SetSrcReload (mxc_dma_srcdst_t srcdstReload);
  *
  * @return     See \ref MXC_Error_Codes for a list of return values
  */
-int MXC_DMA_GetSrcReload (mxc_dma_srcdst_t *srcdstReload);
+int MXC_DMA_GetSrcReload (mxc_dma_srcdst_t* srcdstReload);
 
 /**
  * @brief      Set channel interrupt callback
@@ -302,7 +313,7 @@ int MXC_DMA_SetCallback (int ch, void (*callback) (int, int));
  * @param      ctz Enable channel count to zero interrupt.
  * @return     #E_BAD_PARAM if an unused or invalid channel handle, #E_NO_ERROR otherwise
  */
-int MXC_DMA_SetChannelInterruptEn (int ch, bool chdis, bool ctz);
+int MXC_DMA_SetChannelInterruptEn(int ch, bool chdis, bool ctz);
 
 /**
  * @brief      Enable channel interrupt

targets/TARGET_Maxim/TARGET_MAX32670/Libraries/PeriphDrivers/Include/MAX32670/flc.h

@@ -5,7 +5,7 @@
  */
 
 /* ****************************************************************************
- * Copyright (C) Maxim Integrated Products, Inc., All Rights Reserved.
+ * Copyright (C) 2022 Maxim Integrated Products, Inc., All Rights Reserved.
  *
  * Permission is hereby granted, free of charge, to any person obtaining a
  * copy of this software and associated documentation files (the "Software"),
@@ -43,7 +43,6 @@
 /* **** Includes **** */
 #include "flc_regs.h"
 #include "mxc_sys.h"
-#include "mxc_errors.h"
 
 #ifdef __cplusplus
 extern "C" {