/* * Copyright (c) 2016, Freescale Semiconductor, Inc. * Copyright 2016-2017, 2020 NXP * All rights reserved. * * SPDX-License-Identifier: BSD-3-Clause */ #include "fsl_mrt.h" /* Component ID definition, used by tools. */ #ifndef FSL_COMPONENT_ID #define FSL_COMPONENT_ID "platform.drivers.mrt" #endif /******************************************************************************* * Prototypes ******************************************************************************/ /*! * @brief Gets the instance from the base address * * @param base Multi-Rate timer peripheral base address * * @return The MRT instance */ static uint32_t MRT_GetInstance(MRT_Type *base); /******************************************************************************* * Variables ******************************************************************************/ /*! @brief Pointers to MRT bases for each instance. */ static MRT_Type *const s_mrtBases[] = MRT_BASE_PTRS; #if !(defined(FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) && FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) /*! @brief Pointers to MRT clocks for each instance. */ static const clock_ip_name_t s_mrtClocks[] = MRT_CLOCKS; #endif /* FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL */ #if !(defined(FSL_SDK_DISABLE_DRIVER_RESET_CONTROL) && FSL_SDK_DISABLE_DRIVER_RESET_CONTROL) #if defined(MRT_RSTS_N) /*! @brief Pointers to MRT resets for each instance, writing a zero asserts the reset */ static const reset_ip_name_t s_mrtResets[] = MRT_RSTS_N; #elif defined(MRT_RSTS) /*! @brief Pointers to MRT resets for each instance, writing a one asserts the reset */ static const reset_ip_name_t s_mrtResets[] = MRT_RSTS; #endif #endif /* FSL_SDK_DISABLE_DRIVER_RESET_CONTROL */ /******************************************************************************* * Code ******************************************************************************/ static uint32_t MRT_GetInstance(MRT_Type *base) { uint32_t instance; uint32_t mrtArrayCount = (sizeof(s_mrtBases) / sizeof(s_mrtBases[0])); /* Find the instance index from base address mappings. */ for (instance = 0; instance < mrtArrayCount; instance++) { if (s_mrtBases[instance] == base) { break; } } assert(instance < mrtArrayCount); return instance; } /*! * brief Ungates the MRT clock and configures the peripheral for basic operation. * * note This API should be called at the beginning of the application using the MRT driver. * * param base Multi-Rate timer peripheral base address * param config Pointer to user's MRT config structure. If MRT has MULTITASK bit field in * MODCFG reigster, param config is useless. */ void MRT_Init(MRT_Type *base, const mrt_config_t *config) { assert(config != NULL); #if !(defined(FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) && FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) /* Ungate the MRT clock */ CLOCK_EnableClock(s_mrtClocks[MRT_GetInstance(base)]); #endif /* FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL */ #if !(defined(FSL_SDK_DISABLE_DRIVER_RESET_CONTROL) && FSL_SDK_DISABLE_DRIVER_RESET_CONTROL) #if defined(MRT_RSTS_N) || defined(MRT_RSTS) /* Reset the module. */ RESET_PeripheralReset(s_mrtResets[MRT_GetInstance(base)]); #endif #endif /* FSL_SDK_DISABLE_DRIVER_RESET_CONTROL */ #if !(defined(FSL_FEATURE_MRT_HAS_NO_MODCFG_MULTITASK) && FSL_FEATURE_MRT_HAS_NO_MODCFG_MULTITASK) /* Set timer operating mode */ base->MODCFG = MRT_MODCFG_MULTITASK(config->enableMultiTask); #endif } /*! * brief Gate the MRT clock * * param base Multi-Rate timer peripheral base address */ void MRT_Deinit(MRT_Type *base) { /* Stop all the timers */ MRT_StopTimer(base, kMRT_Channel_0); MRT_StopTimer(base, kMRT_Channel_1); #if (FSL_FEATURE_MRT_NUMBER_OF_CHANNELS > 2U) MRT_StopTimer(base, kMRT_Channel_2); #endif #if (FSL_FEATURE_MRT_NUMBER_OF_CHANNELS > 3U) MRT_StopTimer(base, kMRT_Channel_3); #endif #if !(defined(FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) && FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL) /* Gate the MRT clock*/ CLOCK_DisableClock(s_mrtClocks[MRT_GetInstance(base)]); #endif /* FSL_SDK_DISABLE_DRIVER_CLOCK_CONTROL */ } /*! * brief Used to update the timer period in units of count. * * The new value will be immediately loaded or will be loaded at the end of the current time * interval. For one-shot interrupt mode the new value will be immediately loaded. * * note User can call the utility macros provided in fsl_common.h to convert to ticks * * param base Multi-Rate timer peripheral base address * param channel Timer channel number * param count Timer period in units of ticks * param immediateLoad true: Load the new value immediately into the TIMER register; * false: Load the new value at the end of current timer interval */ void MRT_UpdateTimerPeriod(MRT_Type *base, mrt_chnl_t channel, uint32_t count, bool immediateLoad) { assert((uint8_t)channel < (uint8_t)FSL_FEATURE_MRT_NUMBER_OF_CHANNELS); uint32_t newValue = count; if (((base->CHANNEL[channel].CTRL & MRT_CHANNEL_CTRL_MODE_MASK) == (uint8_t)kMRT_OneShotMode) || (immediateLoad)) { /* For one-shot interrupt mode, load the new value immediately even if user forgot to enable */ newValue |= MRT_CHANNEL_INTVAL_LOAD_MASK; } /* Update the timer interval value */ base->CHANNEL[channel].INTVAL = newValue; }