Ben Katz / mbed-dev-f303

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependents:   Hobbyking_Cheetah_Compact Hobbyking_Cheetah_Compact_DRV8323_14bit Hobbyking_Cheetah_Compact_DRV8323_V51_201907 HKC_MiniCheetah ... more

Fork of mbed-dev by mbed official

targets/TARGET_Freescale/TARGET_MCUXpresso_MCUS/TARGET_MCU_K22F/drivers/fsl_flexbus.c@154:37f96f9d4de2, 2017-01-04 (annotated)

Committer:
<>
Date:
Wed Jan 04 16:58:05 2017 +0000
Revision:
154:37f96f9d4de2
This updates the lib to the mbed lib v133

Who changed what in which revision?

UserRevisionLine numberNew contents of line
<> 154:37f96f9d4de2 1 /*
<> 154:37f96f9d4de2 2 * Copyright (c) 2015, Freescale Semiconductor, Inc.
<> 154:37f96f9d4de2 3 * All rights reserved.
<> 154:37f96f9d4de2 4 *
<> 154:37f96f9d4de2 5 * Redistribution and use in source and binary forms, with or without modification,
<> 154:37f96f9d4de2 6 * are permitted provided that the following conditions are met:
<> 154:37f96f9d4de2 7 *
<> 154:37f96f9d4de2 8 * o Redistributions of source code must retain the above copyright notice, this list
<> 154:37f96f9d4de2 9 * of conditions and the following disclaimer.
<> 154:37f96f9d4de2 10 *
<> 154:37f96f9d4de2 11 * o Redistributions in binary form must reproduce the above copyright notice, this
<> 154:37f96f9d4de2 12 * list of conditions and the following disclaimer in the documentation and/or
<> 154:37f96f9d4de2 13 * other materials provided with the distribution.
<> 154:37f96f9d4de2 14 *
<> 154:37f96f9d4de2 15 * o Neither the name of Freescale Semiconductor, Inc. nor the names of its
<> 154:37f96f9d4de2 16 * contributors may be used to endorse or promote products derived from this
<> 154:37f96f9d4de2 17 * software without specific prior written permission.
<> 154:37f96f9d4de2 18 *
<> 154:37f96f9d4de2 19 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
<> 154:37f96f9d4de2 20 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
<> 154:37f96f9d4de2 21 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
<> 154:37f96f9d4de2 22 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
<> 154:37f96f9d4de2 23 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
<> 154:37f96f9d4de2 24 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
<> 154:37f96f9d4de2 25 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
<> 154:37f96f9d4de2 26 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
<> 154:37f96f9d4de2 27 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
<> 154:37f96f9d4de2 28 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
<> 154:37f96f9d4de2 29 */
<> 154:37f96f9d4de2 30
<> 154:37f96f9d4de2 31 #include "fsl_flexbus.h"
<> 154:37f96f9d4de2 32
<> 154:37f96f9d4de2 33 /*******************************************************************************
<> 154:37f96f9d4de2 34 * Prototypes
<> 154:37f96f9d4de2 35 ******************************************************************************/
<> 154:37f96f9d4de2 36
<> 154:37f96f9d4de2 37 /*!
<> 154:37f96f9d4de2 38 * @brief Gets the instance from the base address
<> 154:37f96f9d4de2 39 *
<> 154:37f96f9d4de2 40 * @param base FLEXBUS peripheral base address
<> 154:37f96f9d4de2 41 *
<> 154:37f96f9d4de2 42 * @return The FLEXBUS instance
<> 154:37f96f9d4de2 43 */
<> 154:37f96f9d4de2 44 static uint32_t FLEXBUS_GetInstance(FB_Type *base);
<> 154:37f96f9d4de2 45
<> 154:37f96f9d4de2 46 /*******************************************************************************
<> 154:37f96f9d4de2 47 * Variables
<> 154:37f96f9d4de2 48 ******************************************************************************/
<> 154:37f96f9d4de2 49
<> 154:37f96f9d4de2 50 /*! @brief Pointers to FLEXBUS bases for each instance. */
<> 154:37f96f9d4de2 51 static FB_Type *const s_flexbusBases[] = FB_BASE_PTRS;
<> 154:37f96f9d4de2 52
<> 154:37f96f9d4de2 53 /*! @brief Pointers to FLEXBUS clocks for each instance. */
<> 154:37f96f9d4de2 54 static const clock_ip_name_t s_flexbusClocks[] = FLEXBUS_CLOCKS;
<> 154:37f96f9d4de2 55
<> 154:37f96f9d4de2 56 /*******************************************************************************
<> 154:37f96f9d4de2 57 * Code
<> 154:37f96f9d4de2 58 ******************************************************************************/
<> 154:37f96f9d4de2 59
<> 154:37f96f9d4de2 60 static uint32_t FLEXBUS_GetInstance(FB_Type *base)
<> 154:37f96f9d4de2 61 {
<> 154:37f96f9d4de2 62 uint32_t instance;
<> 154:37f96f9d4de2 63
<> 154:37f96f9d4de2 64 /* Find the instance index from base address mappings. */
<> 154:37f96f9d4de2 65 for (instance = 0; instance < FSL_FEATURE_SOC_FB_COUNT; instance++)
<> 154:37f96f9d4de2 66 {
<> 154:37f96f9d4de2 67 if (s_flexbusBases[instance] == base)
<> 154:37f96f9d4de2 68 {
<> 154:37f96f9d4de2 69 break;
<> 154:37f96f9d4de2 70 }
<> 154:37f96f9d4de2 71 }
<> 154:37f96f9d4de2 72
<> 154:37f96f9d4de2 73 assert(instance < FSL_FEATURE_SOC_FB_COUNT);
<> 154:37f96f9d4de2 74
<> 154:37f96f9d4de2 75 return instance;
<> 154:37f96f9d4de2 76 }
<> 154:37f96f9d4de2 77
<> 154:37f96f9d4de2 78 void FLEXBUS_Init(FB_Type *base, const flexbus_config_t *config)
<> 154:37f96f9d4de2 79 {
<> 154:37f96f9d4de2 80 assert(config != NULL);
<> 154:37f96f9d4de2 81 assert(config->chip < FB_CSAR_COUNT);
<> 154:37f96f9d4de2 82 assert(config->waitStates <= 0x3FU);
<> 154:37f96f9d4de2 83
<> 154:37f96f9d4de2 84 uint32_t chip = 0;
<> 154:37f96f9d4de2 85 uint32_t reg_value = 0;
<> 154:37f96f9d4de2 86
<> 154:37f96f9d4de2 87 /* Ungate clock for FLEXBUS */
<> 154:37f96f9d4de2 88 CLOCK_EnableClock(s_flexbusClocks[FLEXBUS_GetInstance(base)]);
<> 154:37f96f9d4de2 89
<> 154:37f96f9d4de2 90 /* Reset all the register to default state */
<> 154:37f96f9d4de2 91 for (chip = 0; chip < FB_CSAR_COUNT; chip++)
<> 154:37f96f9d4de2 92 {
<> 154:37f96f9d4de2 93 /* Reset CSMR register, all chips not valid (disabled) */
<> 154:37f96f9d4de2 94 base->CS[chip].CSMR = 0x0000U;
<> 154:37f96f9d4de2 95 /* Set default base address */
<> 154:37f96f9d4de2 96 base->CS[chip].CSAR &= (~FB_CSAR_BA_MASK);
<> 154:37f96f9d4de2 97 /* Reset FB_CSCRx register */
<> 154:37f96f9d4de2 98 base->CS[chip].CSCR = 0x0000U;
<> 154:37f96f9d4de2 99 }
<> 154:37f96f9d4de2 100 /* Set FB_CSPMCR register */
<> 154:37f96f9d4de2 101 /* FlexBus signal group 1 multiplex control */
<> 154:37f96f9d4de2 102 reg_value |= kFLEXBUS_MultiplexGroup1_FB_ALE << FB_CSPMCR_GROUP1_SHIFT;
<> 154:37f96f9d4de2 103 /* FlexBus signal group 2 multiplex control */
<> 154:37f96f9d4de2 104 reg_value |= kFLEXBUS_MultiplexGroup2_FB_CS4 << FB_CSPMCR_GROUP2_SHIFT;
<> 154:37f96f9d4de2 105 /* FlexBus signal group 3 multiplex control */
<> 154:37f96f9d4de2 106 reg_value |= kFLEXBUS_MultiplexGroup3_FB_CS5 << FB_CSPMCR_GROUP3_SHIFT;
<> 154:37f96f9d4de2 107 /* FlexBus signal group 4 multiplex control */
<> 154:37f96f9d4de2 108 reg_value |= kFLEXBUS_MultiplexGroup4_FB_TBST << FB_CSPMCR_GROUP4_SHIFT;
<> 154:37f96f9d4de2 109 /* FlexBus signal group 5 multiplex control */
<> 154:37f96f9d4de2 110 reg_value |= kFLEXBUS_MultiplexGroup5_FB_TA << FB_CSPMCR_GROUP5_SHIFT;
<> 154:37f96f9d4de2 111 /* Write to CSPMCR register */
<> 154:37f96f9d4de2 112 base->CSPMCR = reg_value;
<> 154:37f96f9d4de2 113
<> 154:37f96f9d4de2 114 /* Update chip value */
<> 154:37f96f9d4de2 115 chip = config->chip;
<> 154:37f96f9d4de2 116
<> 154:37f96f9d4de2 117 /* Base address */
<> 154:37f96f9d4de2 118 reg_value = config->chipBaseAddress;
<> 154:37f96f9d4de2 119 /* Write to CSAR register */
<> 154:37f96f9d4de2 120 base->CS[chip].CSAR = reg_value;
<> 154:37f96f9d4de2 121 /* Chip-select validation */
<> 154:37f96f9d4de2 122 reg_value = 0x1U << FB_CSMR_V_SHIFT;
<> 154:37f96f9d4de2 123 /* Write protect */
<> 154:37f96f9d4de2 124 reg_value |= (uint32_t)(config->writeProtect) << FB_CSMR_WP_SHIFT;
<> 154:37f96f9d4de2 125 /* Base address mask */
<> 154:37f96f9d4de2 126 reg_value |= config->chipBaseAddressMask << FB_CSMR_BAM_SHIFT;
<> 154:37f96f9d4de2 127 /* Write to CSMR register */
<> 154:37f96f9d4de2 128 base->CS[chip].CSMR = reg_value;
<> 154:37f96f9d4de2 129 /* Burst write */
<> 154:37f96f9d4de2 130 reg_value = (uint32_t)(config->burstWrite) << FB_CSCR_BSTW_SHIFT;
<> 154:37f96f9d4de2 131 /* Burst read */
<> 154:37f96f9d4de2 132 reg_value |= (uint32_t)(config->burstRead) << FB_CSCR_BSTR_SHIFT;
<> 154:37f96f9d4de2 133 /* Byte-enable mode */
<> 154:37f96f9d4de2 134 reg_value |= (uint32_t)(config->byteEnableMode) << FB_CSCR_BEM_SHIFT;
<> 154:37f96f9d4de2 135 /* Port size */
<> 154:37f96f9d4de2 136 reg_value |= (uint32_t)config->portSize << FB_CSCR_PS_SHIFT;
<> 154:37f96f9d4de2 137 /* The internal transfer acknowledge for accesses */
<> 154:37f96f9d4de2 138 reg_value |= (uint32_t)(config->autoAcknowledge) << FB_CSCR_AA_SHIFT;
<> 154:37f96f9d4de2 139 /* Byte-Lane shift */
<> 154:37f96f9d4de2 140 reg_value |= (uint32_t)config->byteLaneShift << FB_CSCR_BLS_SHIFT;
<> 154:37f96f9d4de2 141 /* The number of wait states */
<> 154:37f96f9d4de2 142 reg_value |= (uint32_t)config->waitStates << FB_CSCR_WS_SHIFT;
<> 154:37f96f9d4de2 143 /* Write address hold or deselect */
<> 154:37f96f9d4de2 144 reg_value |= (uint32_t)config->writeAddressHold << FB_CSCR_WRAH_SHIFT;
<> 154:37f96f9d4de2 145 /* Read address hold or deselect */
<> 154:37f96f9d4de2 146 reg_value |= (uint32_t)config->readAddressHold << FB_CSCR_RDAH_SHIFT;
<> 154:37f96f9d4de2 147 /* Address setup */
<> 154:37f96f9d4de2 148 reg_value |= (uint32_t)config->addressSetup << FB_CSCR_ASET_SHIFT;
<> 154:37f96f9d4de2 149 /* Extended transfer start/extended address latch */
<> 154:37f96f9d4de2 150 reg_value |= (uint32_t)(config->extendTransferAddress) << FB_CSCR_EXTS_SHIFT;
<> 154:37f96f9d4de2 151 /* Secondary wait state */
<> 154:37f96f9d4de2 152 reg_value |= (uint32_t)(config->secondaryWaitStates) << FB_CSCR_SWSEN_SHIFT;
<> 154:37f96f9d4de2 153 /* Write to CSCR register */
<> 154:37f96f9d4de2 154 base->CS[chip].CSCR = reg_value;
<> 154:37f96f9d4de2 155 /* FlexBus signal group 1 multiplex control */
<> 154:37f96f9d4de2 156 reg_value = (uint32_t)config->group1MultiplexControl << FB_CSPMCR_GROUP1_SHIFT;
<> 154:37f96f9d4de2 157 /* FlexBus signal group 2 multiplex control */
<> 154:37f96f9d4de2 158 reg_value |= (uint32_t)config->group2MultiplexControl << FB_CSPMCR_GROUP2_SHIFT;
<> 154:37f96f9d4de2 159 /* FlexBus signal group 3 multiplex control */
<> 154:37f96f9d4de2 160 reg_value |= (uint32_t)config->group3MultiplexControl << FB_CSPMCR_GROUP3_SHIFT;
<> 154:37f96f9d4de2 161 /* FlexBus signal group 4 multiplex control */
<> 154:37f96f9d4de2 162 reg_value |= (uint32_t)config->group4MultiplexControl << FB_CSPMCR_GROUP4_SHIFT;
<> 154:37f96f9d4de2 163 /* FlexBus signal group 5 multiplex control */
<> 154:37f96f9d4de2 164 reg_value |= (uint32_t)config->group5MultiplexControl << FB_CSPMCR_GROUP5_SHIFT;
<> 154:37f96f9d4de2 165 /* Write to CSPMCR register */
<> 154:37f96f9d4de2 166 base->CSPMCR = reg_value;
<> 154:37f96f9d4de2 167 }
<> 154:37f96f9d4de2 168
<> 154:37f96f9d4de2 169 void FLEXBUS_Deinit(FB_Type *base)
<> 154:37f96f9d4de2 170 {
<> 154:37f96f9d4de2 171 /* Gate clock for FLEXBUS */
<> 154:37f96f9d4de2 172 CLOCK_EnableClock(s_flexbusClocks[FLEXBUS_GetInstance(base)]);
<> 154:37f96f9d4de2 173 }
<> 154:37f96f9d4de2 174
<> 154:37f96f9d4de2 175 void FLEXBUS_GetDefaultConfig(flexbus_config_t *config)
<> 154:37f96f9d4de2 176 {
<> 154:37f96f9d4de2 177 config->chip = 0; /* Chip 0 FlexBus for validation */
<> 154:37f96f9d4de2 178 config->writeProtect = 0; /* Write accesses are allowed */
<> 154:37f96f9d4de2 179 config->burstWrite = 0; /* Burst-Write disable */
<> 154:37f96f9d4de2 180 config->burstRead = 0; /* Burst-Read disable */
<> 154:37f96f9d4de2 181 config->byteEnableMode = 0; /* Byte-Enable mode is asserted for data write only */
<> 154:37f96f9d4de2 182 config->autoAcknowledge = true; /* Auto-Acknowledge enable */
<> 154:37f96f9d4de2 183 config->extendTransferAddress = 0; /* Extend transfer start/extend address latch disable */
<> 154:37f96f9d4de2 184 config->secondaryWaitStates = 0; /* Secondary wait state disable */
<> 154:37f96f9d4de2 185 config->byteLaneShift = kFLEXBUS_NotShifted; /* Byte-Lane shift disable */
<> 154:37f96f9d4de2 186 config->writeAddressHold = kFLEXBUS_Hold1Cycle; /* Write address hold 1 cycles */
<> 154:37f96f9d4de2 187 config->readAddressHold = kFLEXBUS_Hold1Or0Cycles; /* Read address hold 0 cycles */
<> 154:37f96f9d4de2 188 config->addressSetup =
<> 154:37f96f9d4de2 189 kFLEXBUS_FirstRisingEdge; /* Assert ~FB_CSn on the first rising clock edge after the address is asserted */
<> 154:37f96f9d4de2 190 config->portSize = kFLEXBUS_1Byte; /* 1 byte port size of transfer */
<> 154:37f96f9d4de2 191 config->group1MultiplexControl = kFLEXBUS_MultiplexGroup1_FB_ALE; /* FB_ALE */
<> 154:37f96f9d4de2 192 config->group2MultiplexControl = kFLEXBUS_MultiplexGroup2_FB_CS4; /* FB_CS4 */
<> 154:37f96f9d4de2 193 config->group3MultiplexControl = kFLEXBUS_MultiplexGroup3_FB_CS5; /* FB_CS5 */
<> 154:37f96f9d4de2 194 config->group4MultiplexControl = kFLEXBUS_MultiplexGroup4_FB_TBST; /* FB_TBST */
<> 154:37f96f9d4de2 195 config->group5MultiplexControl = kFLEXBUS_MultiplexGroup5_FB_TA; /* FB_TA */
<> 154:37f96f9d4de2 196 }