/**************************************************************************//** * @file ebi.c * @version V3.00 * @brief External Bus Interface(EBI) driver source file * * @copyright (C) 2019 Nuvoton Technology Corp. All rights reserved. * * Redistribution and use in source and binary forms, with or without modification, * are permitted provided that the following conditions are met: * 1. Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * 2. 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. * 3. Neither the name of Nuvoton Technology Corp. 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. *****************************************************************************/ #include "NuMicro.h" /** @addtogroup Standard_Driver Standard Driver @{ */ /** @addtogroup EBI_Driver EBI Driver @{ */ /** @addtogroup EBI_EXPORTED_FUNCTIONS EBI Exported Functions @{ */ /** * @brief Initialize EBI for specify Bank * * @param[in] u32Bank Bank number for EBI. Valid values are: * - \ref EBI_BANK0 * - \ref EBI_BANK1 * - \ref EBI_BANK2 * @param[in] u32DataWidth Data bus width. Valid values are: * - \ref EBI_BUSWIDTH_8BIT * - \ref EBI_BUSWIDTH_16BIT * @param[in] u32TimingClass Default timing configuration. Valid values are: * - \ref EBI_TIMING_FASTEST * - \ref EBI_TIMING_VERYFAST * - \ref EBI_TIMING_FAST * - \ref EBI_TIMING_NORMAL * - \ref EBI_TIMING_SLOW * - \ref EBI_TIMING_VERYSLOW * - \ref EBI_TIMING_SLOWEST * @param[in] u32BusMode Set EBI bus operate mode. Valid values are: * - \ref EBI_OPMODE_NORMAL * - \ref EBI_OPMODE_CACCESS * - \ref EBI_OPMODE_ADSEPARATE * @param[in] u32CSActiveLevel CS is active High/Low. Valid values are: * - \ref EBI_CS_ACTIVE_HIGH * - \ref EBI_CS_ACTIVE_LOW * * @return None * * @details This function is used to open specify EBI bank with different bus width, timing setting and \n * active level of CS pin to access EBI device. * @note Write Buffer Enable(WBUFEN) and Extend Time Of ALE(TALE) are only available in EBI bank0 control register. */ void EBI_Open(uint32_t u32Bank, uint32_t u32DataWidth, uint32_t u32TimingClass, uint32_t u32BusMode, uint32_t u32CSActiveLevel) { uint32_t u32Index0 = (uint32_t)&EBI->CTL0 + (uint32_t)u32Bank * 0x10U; uint32_t u32Index1 = (uint32_t)&EBI->TCTL0 + (uint32_t)u32Bank * 0x10U; volatile uint32_t *pu32EBICTL, *pu32EBITCTL; uint32_t pu32Index0, pu32Index1; pu32Index0 = u32Index0; pu32Index1 = u32Index1; pu32EBICTL = (uint32_t *)(pu32Index0); pu32EBITCTL = (uint32_t *)(pu32Index1); if(u32DataWidth == EBI_BUSWIDTH_8BIT) { *pu32EBICTL &= ~EBI_CTL_DW16_Msk; } else { *pu32EBICTL |= EBI_CTL_DW16_Msk; } *pu32EBICTL |= u32BusMode; switch(u32TimingClass) { case EBI_TIMING_FASTEST: *pu32EBICTL = (*pu32EBICTL & ~(EBI_CTL_MCLKDIV_Msk | EBI_CTL_TALE_Msk)) | (EBI_MCLKDIV_1 << EBI_CTL_MCLKDIV_Pos) | (u32CSActiveLevel << EBI_CTL_CSPOLINV_Pos) | EBI_CTL_EN_Msk; *pu32EBITCTL = 0x0U; break; case EBI_TIMING_VERYFAST: *pu32EBICTL = (*pu32EBICTL & ~(EBI_CTL_MCLKDIV_Msk | EBI_CTL_TALE_Msk)) | (EBI_MCLKDIV_1 << EBI_CTL_MCLKDIV_Pos) | (u32CSActiveLevel << EBI_CTL_CSPOLINV_Pos) | EBI_CTL_EN_Msk | (0x3U << EBI_CTL_TALE_Pos) ; *pu32EBITCTL = 0x03003318U; break; case EBI_TIMING_FAST: *pu32EBICTL = (*pu32EBICTL & ~(EBI_CTL_MCLKDIV_Msk | EBI_CTL_TALE_Msk)) | (EBI_MCLKDIV_2 << EBI_CTL_MCLKDIV_Pos) | (u32CSActiveLevel << EBI_CTL_CSPOLINV_Pos) | EBI_CTL_EN_Msk; *pu32EBITCTL = 0x0U; break; case EBI_TIMING_NORMAL: *pu32EBICTL = (*pu32EBICTL & ~(EBI_CTL_MCLKDIV_Msk | EBI_CTL_TALE_Msk)) | (EBI_MCLKDIV_2 << EBI_CTL_MCLKDIV_Pos) | (u32CSActiveLevel << EBI_CTL_CSPOLINV_Pos) | EBI_CTL_EN_Msk | (0x3U << EBI_CTL_TALE_Pos) ; *pu32EBITCTL = 0x03003318U; break; case EBI_TIMING_SLOW: *pu32EBICTL = (*pu32EBICTL & ~(EBI_CTL_MCLKDIV_Msk | EBI_CTL_TALE_Msk)) | (EBI_MCLKDIV_2 << EBI_CTL_MCLKDIV_Pos) | (u32CSActiveLevel << EBI_CTL_CSPOLINV_Pos) | EBI_CTL_EN_Msk | (0x7U << EBI_CTL_TALE_Pos) ; *pu32EBITCTL = 0x07007738U; break; case EBI_TIMING_VERYSLOW: *pu32EBICTL = (*pu32EBICTL & ~(EBI_CTL_MCLKDIV_Msk | EBI_CTL_TALE_Msk)) | (EBI_MCLKDIV_4 << EBI_CTL_MCLKDIV_Pos) | (u32CSActiveLevel << EBI_CTL_CSPOLINV_Pos) | EBI_CTL_EN_Msk | (0x7U << EBI_CTL_TALE_Pos) ; *pu32EBITCTL = 0x07007738U; break; case EBI_TIMING_SLOWEST: *pu32EBICTL = (*pu32EBICTL & ~(EBI_CTL_MCLKDIV_Msk | EBI_CTL_TALE_Msk)) | (EBI_MCLKDIV_8 << EBI_CTL_MCLKDIV_Pos) | (u32CSActiveLevel << EBI_CTL_CSPOLINV_Pos) | EBI_CTL_EN_Msk | (0x7U << EBI_CTL_TALE_Pos) ; *pu32EBITCTL = 0x07007738U; break; default: *pu32EBICTL &= ~EBI_CTL_EN_Msk; break; } } /** * @brief Disable EBI on specify Bank * * @param[in] u32Bank Bank number for EBI. Valid values are: * - \ref EBI_BANK0 * - \ref EBI_BANK1 * - \ref EBI_BANK2 * * @return None * * @details This function is used to close specify EBI function. */ void EBI_Close(uint32_t u32Bank) { uint32_t u32Index = (uint32_t)&EBI->CTL0 + u32Bank * 0x10U; volatile uint32_t *pu32EBICTL; uint32_t pu32Index; pu32Index = u32Index; pu32EBICTL = (uint32_t *)(pu32Index); *pu32EBICTL &= ~EBI_CTL_EN_Msk; } /** * @brief Set EBI Bus Timing for specify Bank * * @param[in] u32Bank Bank number for EBI. Valid values are: * - \ref EBI_BANK0 * - \ref EBI_BANK1 * - \ref EBI_BANK2 * @param[in] u32TimingConfig Configure EBI timing settings, includes TACC, TAHD, W2X and R2R setting. * @param[in] u32MclkDiv Divider for MCLK. Valid values are: * - \ref EBI_MCLKDIV_1 * - \ref EBI_MCLKDIV_2 * - \ref EBI_MCLKDIV_4 * - \ref EBI_MCLKDIV_8 * - \ref EBI_MCLKDIV_16 * - \ref EBI_MCLKDIV_32 * - \ref EBI_MCLKDIV_64 * - \ref EBI_MCLKDIV_128 * * @return None * * @details This function is used to configure specify EBI bus timing for access EBI device. */ void EBI_SetBusTiming(uint32_t u32Bank, uint32_t u32TimingConfig, uint32_t u32MclkDiv) { uint32_t u32Index0 = (uint32_t)&EBI->CTL0 + (uint32_t)u32Bank * 0x10U; uint32_t u32Index1 = (uint32_t)&EBI->TCTL0 + (uint32_t)u32Bank * 0x10U; volatile uint32_t *pu32EBICTL, *pu32EBITCTL; uint32_t pu32Index0, pu32Index1; pu32Index0 = u32Index0; pu32Index1 = u32Index1; pu32EBICTL = (uint32_t *)(pu32Index0); pu32EBITCTL = (uint32_t *)(pu32Index1); *pu32EBICTL = (*pu32EBICTL & ~EBI_CTL_MCLKDIV_Msk) | (u32MclkDiv << EBI_CTL_MCLKDIV_Pos); *pu32EBITCTL = u32TimingConfig; } /*@}*/ /* end of group EBI_EXPORTED_FUNCTIONS */ /*@}*/ /* end of group EBI_Driver */ /*@}*/ /* end of group Standard_Driver */ /*** (C) COPYRIGHT 2019 Nuvoton Technology Corp. ***/