396 lines
16 KiB
C
396 lines
16 KiB
C
/**
|
|
* @file xmc_pau.h
|
|
* @date 2015-06-20
|
|
*
|
|
* @cond
|
|
*********************************************************************************************************************
|
|
* XMClib v2.1.16 - XMC Peripheral Driver Library
|
|
*
|
|
* Copyright (c) 2015-2017, Infineon Technologies AG
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without modification,are permitted provided that the
|
|
* following conditions are met:
|
|
*
|
|
* Redistributions of source code must retain the above copyright notice, this list of conditions and the following
|
|
* disclaimer.
|
|
*
|
|
* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following
|
|
* disclaimer in the documentation and/or other materials provided with the distribution.
|
|
*
|
|
* Neither the name of the copyright holders nor the names of its contributors may be used to endorse or promote
|
|
* products derived from this software without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
|
|
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
|
* SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
|
* WHETHER IN CONTRACT, STRICT LIABILITY,OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
* To improve the quality of the software, users are encouraged to share modifications, enhancements or bug fixes with
|
|
* Infineon Technologies AG dave@infineon.com).
|
|
*********************************************************************************************************************
|
|
*
|
|
* Change History
|
|
* --------------
|
|
*
|
|
* 2015-02-20:
|
|
* - Initial version
|
|
*
|
|
* 2015-05-20:
|
|
* - Documentation updated
|
|
*
|
|
* 2015-06-20:
|
|
* - Removed version macros and declaration of GetDriverVersion API
|
|
* @endcond
|
|
*
|
|
*/
|
|
|
|
#ifndef XMC_PAU_H
|
|
#define XMC_PAU_H
|
|
|
|
/*********************************************************************************************************************
|
|
* HEADER FILES
|
|
*********************************************************************************************************************/
|
|
|
|
#include "xmc_common.h"
|
|
|
|
#if defined(PAU)
|
|
|
|
/**
|
|
* @addtogroup XMClib XMC Peripheral Library
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* @addtogroup PAU
|
|
* @brief Peripheral Access Unit (PAU) driver for the XMC1000 microcontroller family
|
|
*
|
|
* The Peripheral Access Unit (PAU) supports access control of memories and peripherals.
|
|
* It allows user application to enable/disable the access to the registers of a peripheral.
|
|
* It generates a HardFault exception when there is an access to a disabled or unassigned
|
|
* address location. It also provides information on the availability of peripherals and
|
|
* sizes of memories.
|
|
*
|
|
* The PAU low level driver provides functions to check the availability of peripherals
|
|
* and to enable/disable peripheral access.
|
|
* @{
|
|
*/
|
|
|
|
/*********************************************************************************************************************
|
|
* MACROS
|
|
*********************************************************************************************************************/
|
|
|
|
/**
|
|
* A convenient symbol for the PAU peripheral base address
|
|
*/
|
|
#define XMC_PAU ((XMC_PAU_t *) PAU_BASE)
|
|
|
|
/*
|
|
* This macro is used in the LLD for assertion checks (XMC_ASSERT)
|
|
*/
|
|
#define XMC_PAU_CHECK_MODULE_PTR(p) ((p) == XMC_PAU)
|
|
|
|
/*********************************************************************************************************************
|
|
* ENUMS
|
|
*********************************************************************************************************************/
|
|
|
|
/**
|
|
* Status return values for PAU low level driver
|
|
*/
|
|
typedef enum XMC_PAU_STATUS
|
|
{
|
|
XMC_PAU_STATUS_OK = 0U, /**< Operation successful */
|
|
XMC_PAU_STATUS_BUSY = 1U, /**< Busy with a previous request */
|
|
XMC_PAU_STATUS_ERROR = 2U /**< Operation unsuccessful */
|
|
} XMC_PAU_STATUS_t;
|
|
|
|
/**
|
|
* PAU peripheral select
|
|
*/
|
|
typedef enum XMC_PAU_PERIPHERAL
|
|
{
|
|
XMC_PAU_PERIPHERAL_FLASH = PAU_PRIVDIS0_PDIS2_Msk, /**< Flash SFRs Privilege Disable Flag */
|
|
XMC_PAU_PERIPHERAL_RAM_BLOCK1 = PAU_PRIVDIS0_PDIS5_Msk, /**< RAM Block 1 Privilege Disable Flag */
|
|
XMC_PAU_PERIPHERAL_RAM_BLOCK2 = PAU_PRIVDIS0_PDIS6_Msk, /**< RAM Block 2 Privilege Disable Flag */
|
|
XMC_PAU_PERIPHERAL_RAM_BLOCK3 = PAU_PRIVDIS0_PDIS7_Msk, /**< RAM Block 3 Privilege Disable Flag */
|
|
#if defined(WDT)
|
|
XMC_PAU_PERIPHERAL_WDT = PAU_PRIVDIS0_PDIS19_Msk, /**< WDT Privilege Disable Flag */
|
|
#endif
|
|
#if defined(MATH)
|
|
XMC_PAU_PERIPHERAL_MATH_GLOBAL_AND_DIV = PAU_PRIVDIS0_PDIS20_Msk, /**< MATH Global SFRs and Divider Privilege Disable Flag */
|
|
#endif
|
|
#if defined(MATH)
|
|
XMC_PAU_PERIPHERAL_MATH_CORDIC = PAU_PRIVDIS0_PDIS21_Msk, /**< MATH CORDIC Privilege Disable Flag */
|
|
#endif
|
|
#if defined(PORT0)
|
|
XMC_PAU_PERIPHERAL_PORT0 = PAU_PRIVDIS0_PDIS22_Msk, /**< Port 0 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(PORT1)
|
|
XMC_PAU_PERIPHERAL_PORT1 = PAU_PRIVDIS0_PDIS23_Msk, /**< Port 1 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(PORT2)
|
|
XMC_PAU_PERIPHERAL_PORT2 = PAU_PRIVDIS0_PDIS24_Msk, /**< Port 2 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(PORT3)
|
|
XMC_PAU_PERIPHERAL_PORT3 = PAU_PRIVDIS0_PDIS25_Msk, /**< Port 3 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(PORT4)
|
|
XMC_PAU_PERIPHERAL_PORT4 = PAU_PRIVDIS0_PDIS26_Msk, /**< Port 4 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(USIC0)
|
|
XMC_PAU_PERIPHERAL_USIC0_CH0 = PAU_PRIVDIS1_PDIS0_Msk | 0x10000000U, /**< USIC0 Channel 0 Privilege Disable Flag */
|
|
XMC_PAU_PERIPHERAL_USIC0_CH1 = PAU_PRIVDIS1_PDIS1_Msk | 0x10000000U, /**< USIC0 Channel 1 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(USIC1)
|
|
XMC_PAU_PERIPHERAL_USIC1_CH0 = PAU_PRIVDIS1_PDIS16_Msk | 0x10000000U, /**< USIC1 Channel 0 Privilege Disable Flag */
|
|
XMC_PAU_PERIPHERAL_USIC1_CH1 = PAU_PRIVDIS1_PDIS17_Msk | 0x10000000U, /**< USIC1 Channel 1 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(PRNG)
|
|
XMC_PAU_PERIPHERAL_PRNG = PAU_AVAIL1_AVAIL4_Msk | 0x10000000U, /**< PRNG Availability Flag*/
|
|
#endif
|
|
#if defined(VADC)
|
|
XMC_PAU_PERIPHERAL_VADC_GLOBAL = PAU_PRIVDIS1_PDIS5_Msk | 0x10000000U, /**< VADC0 Basic SFRs Privilege Disable Flag */
|
|
#if defined(VADC_G0)
|
|
XMC_PAU_PERIPHERAL_VADC_GROUP0 = PAU_PRIVDIS1_PDIS6_Msk | 0x10000000U, /**< VADC0 Group 0 SFRs Privilege Disable Flag */
|
|
#endif
|
|
#if defined(VADC_G1)
|
|
XMC_PAU_PERIPHERAL_VADC_GROUP1 = PAU_PRIVDIS1_PDIS7_Msk | 0x10000000U, /**< VADC0 Group 1 SFRs Privilege Disable Flag */
|
|
#endif
|
|
#endif
|
|
#if defined(SHS0)
|
|
XMC_PAU_PERIPHERAL_VADC_SHS0 = PAU_PRIVDIS1_PDIS8_Msk | 0x10000000U, /**< SHS0 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(CCU40)
|
|
XMC_PAU_PERIPHERAL_CCU40_CC40_AND_GLOBAL = PAU_PRIVDIS1_PDIS9_Msk | 0x10000000U, /**< CCU40_CC40 and CCU40 Kernel SFRs Privilege Disable Flag */
|
|
#if defined(CCU40_CC41)
|
|
XMC_PAU_PERIPHERAL_CCU40_CC41 = PAU_PRIVDIS1_PDIS10_Msk | 0x10000000U, /**< CCU40_CC41 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(CCU40_CC42)
|
|
XMC_PAU_PERIPHERAL_CCU40_CC42 = PAU_PRIVDIS1_PDIS11_Msk | 0x10000000U, /**< CCU40_CC42 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(CCU40_CC43)
|
|
XMC_PAU_PERIPHERAL_CCU40_CC43 = PAU_PRIVDIS1_PDIS12_Msk | 0x10000000U, /**< CCU40_CC43 Privilege Disable Flag */
|
|
#endif
|
|
#endif
|
|
#if defined(CCU41)
|
|
XMC_PAU_PERIPHERAL_CCU41_CC40_AND_GLOBAL = PAU_PRIVDIS1_PDIS25_Msk | 0x10000000U, /**< CCU41_CC40 and CCU41 Kernel SFRs Privilege Disable Flag */
|
|
#if defined(CCU41_CC41)
|
|
XMC_PAU_PERIPHERAL_CCU41_CC41 = PAU_PRIVDIS1_PDIS26_Msk | 0x10000000U, /**< CCU41_CC41 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(CCU41_CC42)
|
|
XMC_PAU_PERIPHERAL_CCU41_CC42 = PAU_PRIVDIS1_PDIS27_Msk | 0x10000000U, /**< CCU41_CC42 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(CCU41_CC43)
|
|
XMC_PAU_PERIPHERAL_CCU41_CC43 = PAU_PRIVDIS1_PDIS28_Msk | 0x10000000U, /**< CCU41_CC43 Privilege Disable Flag */
|
|
#endif
|
|
#endif
|
|
#if defined(CCU80)
|
|
XMC_PAU_PERIPHERAL_CCU80_CC80_AND_GLOBAL = PAU_PRIVDIS2_PDIS0_Msk | 0x20000000U, /**< CCU80_CC80 and CCU80 Kernel SFRs Privilege Disable Flag */
|
|
#if defined(CCU80_CC81)
|
|
XMC_PAU_PERIPHERAL_CCU80_CC81 = PAU_PRIVDIS2_PDIS1_Msk | 0x20000000U, /**< CCU80_CC81 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(CCU80_CC82)
|
|
XMC_PAU_PERIPHERAL_CCU80_CC82 = PAU_PRIVDIS2_PDIS2_Msk | 0x20000000U, /**< CCU80_CC82 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(CCU80_CC83)
|
|
XMC_PAU_PERIPHERAL_CCU80_CC83 = PAU_PRIVDIS2_PDIS3_Msk | 0x20000000U, /**< CCU80_CC83 Privilege Disable Flag */
|
|
#endif
|
|
#endif
|
|
#if defined(CCU81)
|
|
XMC_PAU_PERIPHERAL_CCU81_CC80_AND_GLOBAL = PAU_PRIVDIS2_PDIS16_Msk | 0x20000000U, /**< CCU81_CC80 and CCU81 Kernel SFRs Privilege Disable Flag */
|
|
#if defined(CCU81_CC81)
|
|
XMC_PAU_PERIPHERAL_CCU81_CC81 = PAU_PRIVDIS2_PDIS17_Msk | 0x20000000U, /**< CCU81_CC81 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(CCU81_CC82)
|
|
XMC_PAU_PERIPHERAL_CCU81_CC82 = PAU_PRIVDIS2_PDIS18_Msk | 0x20000000U, /**< CCU81_CC82 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(CCU81_CC83)
|
|
XMC_PAU_PERIPHERAL_CCU81_CC83 = PAU_PRIVDIS2_PDIS19_Msk | 0x20000000U, /**< CCU81_CC83 Privilege Disable Flag */
|
|
#endif
|
|
#endif
|
|
#if defined(POSIF0)
|
|
XMC_PAU_PERIPHERAL_POSIF0 = PAU_PRIVDIS2_PDIS12_Msk | 0x20000000U, /**< POSIF0 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(POSIF1)
|
|
XMC_PAU_PERIPHERAL_POSIF1 = PAU_PRIVDIS2_PDIS28_Msk | 0x20000000U, /**< POSIF1 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(LEDTS0)
|
|
XMC_PAU_PERIPHERAL_LEDTS0 = PAU_PRIVDIS2_PDIS13_Msk | 0x20000000U, /**< LEDTS0 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(LEDTS1)
|
|
XMC_PAU_PERIPHERAL_LEDTS1 = PAU_PRIVDIS2_PDIS14_Msk | 0x20000000U, /**< LEDTS1 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(LEDTS2)
|
|
XMC_PAU_PERIPHERAL_LEDTS2 = PAU_PRIVDIS2_PDIS29_Msk | 0x20000000U, /**< LEDTS2 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(BCCU0)
|
|
XMC_PAU_PERIPHERAL_BCCU0 = PAU_PRIVDIS2_PDIS15_Msk | 0x20000000U, /**< BCCU0 Privilege Disable Flag */
|
|
#endif
|
|
#if defined(CAN)
|
|
#if defined(CAN_NODE0)
|
|
XMC_PAU_PERIPHERAL_MCAN_NODE0_AND_GLOBAL = PAU_PRIVDIS2_PDIS21_Msk | 0x20000000U, /**< MCAN NODE0 and Global SFRs Privilege */
|
|
#endif
|
|
#if defined(CAN_NODE1)
|
|
XMC_PAU_PERIPHERAL_MCAN_NODE1_AND_GLOBAL = PAU_PRIVDIS2_PDIS23_Msk | 0x20000000U, /**< MCAN NODE1 Privilege Disable Flag */
|
|
#endif
|
|
XMC_PAU_PERIPHERAL_MCAN_OBJECTS = PAU_PRIVDIS2_PDIS28_Msk | 0x20000000U, /**< MCAN Message Objects Privilege Disable Flag */
|
|
#endif
|
|
} XMC_PAU_PERIPHERAL_t;
|
|
|
|
|
|
/*********************************************************************************************************************
|
|
* DATA STRUCTURES
|
|
*********************************************************************************************************************/
|
|
|
|
|
|
/**
|
|
* External Peripheral Access Unit (PAU) device structure <br>
|
|
*
|
|
* The structure represents a collection of all hardware registers
|
|
* used to configure the PAU peripheral on the XMC microcontroller.
|
|
* The registers can be accessed with ::XMC_PAU.
|
|
*/
|
|
typedef struct
|
|
{
|
|
__I uint32_t RESERVED0[16];
|
|
__I uint32_t AVAIL[3];
|
|
__I uint32_t RESERVED1[13];
|
|
__IO uint32_t PRIVDIS[3];
|
|
__I uint32_t RESERVED2[221];
|
|
__I uint32_t ROMSIZE;
|
|
__I uint32_t FLSIZE;
|
|
__I uint32_t RESERVED3[2];
|
|
__I uint32_t RAM0SIZE;
|
|
} XMC_PAU_t;
|
|
|
|
/*********************************************************************************************************************
|
|
* API PROTOTYPES
|
|
*********************************************************************************************************************/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @param peripheral Peripheral of type ::XMC_PAU_PERIPHERAL_t for which access needs to be enabled
|
|
* @return None
|
|
*
|
|
* \par<b>Description: </b><br>
|
|
* Enable the peripheral access <br>
|
|
*
|
|
* \par
|
|
* The function resets the PRIVDISx.PDISy bit to enable the access to the registers of a peripheral
|
|
* during run time.
|
|
*
|
|
* \par<b>Related APIs:</b><br>
|
|
* XMC_PAU_DisablePeripheralAccess()
|
|
*/
|
|
void XMC_PAU_EnablePeripheralAccess(XMC_PAU_PERIPHERAL_t peripheral);
|
|
|
|
/**
|
|
* @param peripheral Peripheral of type ::XMC_PAU_PERIPHERAL_t for which access needs to be disabled
|
|
* @return None
|
|
*
|
|
* \par<b>Description: </b><br>
|
|
* Disable the peripheral access <br>
|
|
*
|
|
* \par
|
|
* The function sets the PRIVDISx.PDISy bit to disable the access to the registers of a peripheral
|
|
* during run time. An access to a disabled or unassigned address location generates a hardfault
|
|
* exception.
|
|
*
|
|
* \par<b>Related APIs:</b><br>
|
|
* XMC_PAU_EnablePeripheralAccess()
|
|
*/
|
|
void XMC_PAU_DisablePeripheralAccess(XMC_PAU_PERIPHERAL_t peripheral);
|
|
|
|
/**
|
|
* @param peripheral Peripheral of type ::XMC_PAU_PERIPHERAL_t for which access enabled status to be checked
|
|
* @return bool "false" if peripheral access is enabled, "true" otherwise
|
|
*
|
|
* \par<b>Description: </b><br>
|
|
* Checks if the peripheral access is enabled or not <br>
|
|
*
|
|
* \par
|
|
* The function checks the PRIVDISx.PDISy bit to know whether the access to the registers of a peripheral
|
|
* during run time is enabled or not.
|
|
*
|
|
* \par<b>Related APIs:</b><br>
|
|
* XMC_PAU_DisablePeripheralAccess(), XMC_PAU_EnablePeripheralAccess()
|
|
*/
|
|
bool XMC_PAU_IsPeripheralAccessEnabled(XMC_PAU_PERIPHERAL_t peripheral);
|
|
|
|
/**
|
|
* @param peripheral Peripheral of type ::XMC_PAU_PERIPHERAL_t for which access needs to be disabled
|
|
* @return bool Returns "true" if peripheral is available, "false" otherwise
|
|
*
|
|
* \par<b>Description: </b><br>
|
|
* Checks if a peripheral is available or not <br>
|
|
*
|
|
* \par
|
|
* The function checks the AVAILx.AVAILy bit to know whether the peripheral
|
|
* is available or not for the particular device variant.
|
|
*/
|
|
bool XMC_PAU_IsPeripheralAvailable(XMC_PAU_PERIPHERAL_t peripheral);
|
|
|
|
/**
|
|
* @return uint32_t Returns ROM size
|
|
*
|
|
* \par<b>Description: </b><br>
|
|
* Gets the ROM size <br>
|
|
*
|
|
* \par
|
|
* The function checks the ROMSIZE.ADDR bitfield to indicate the available size of ROM in the device in bytes.
|
|
*/
|
|
__STATIC_INLINE uint32_t XMC_PAU_GetROMSize(void)
|
|
{
|
|
return (uint32_t)(((XMC_PAU->ROMSIZE & PAU_ROMSIZE_ADDR_Msk) >> PAU_ROMSIZE_ADDR_Pos) * 256U);
|
|
}
|
|
|
|
/**
|
|
* @return uint32_t Returns flash size
|
|
*
|
|
* \par<b>Description: </b><br>
|
|
* Gets the flash size <br>
|
|
*
|
|
* \par
|
|
* The function checks the FLSIZE.ADDR bitfield to indicate the available size of FLASH in the device in Kbytes.
|
|
*/
|
|
__STATIC_INLINE uint32_t XMC_PAU_GetFlashSize(void)
|
|
{
|
|
return (uint32_t)((((XMC_PAU->FLSIZE & PAU_FLSIZE_ADDR_Msk) >> PAU_FLSIZE_ADDR_Pos) - 1U) * 4U);
|
|
}
|
|
|
|
/**
|
|
* @return uint32_t Returns RAM size
|
|
*
|
|
* \par<b>Description: </b><br>
|
|
* Gets RAM size <br>
|
|
*
|
|
* \par
|
|
* The function checks the RAM0SIZE.ADDR bitfield to indicate the available size of RAM in the device in bytes.
|
|
*/
|
|
__STATIC_INLINE uint32_t XMC_PAU_GetRAMSize(void)
|
|
{
|
|
return (uint32_t)(((XMC_PAU->RAM0SIZE & PAU_RAM0SIZE_ADDR_Msk) >> PAU_RAM0SIZE_ADDR_Pos) * 256U);
|
|
}
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#endif /* defined(PAU) */
|
|
|
|
#endif /* XMC_PAU_H */
|
|
|