/** * @author Tilen MAJERLE * @email tilen@majerle.eu * @website http://stm32f4-discovery.net * @link http://stm32f4-discovery.net/2015/07/hal-library-11-sdram-for-stm32fxxx/ * @version v1.1 * @ide Keil uVision * @license MIT * @brief External SDRAM for STM32F429-Discovery, STM32F439-EVAL, STM32F469-Discovery or STM32F7-Discovery boards * \verbatim ---------------------------------------------------------------------- Copyright (c) 2016 Tilen MAJERLE 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 THE AUTHORS OR COPYRIGHT HOLDERS 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. ---------------------------------------------------------------------- \endverbatim */ #ifndef TM_SDRAM_H #define TM_SDRAM_H 110 /** * @addtogroup TM_STM32Fxxx_HAL_Libraries * @{ */ /** * @defgroup TM_SDRAM * @brief Connect external SDRAM to STM32Fxxx devices with integrated FMC peripheral - http://stm32f4-discovery.net/2015/07/hal-library-11-sdram-for-stm32fxxx/ * @{ * * This library allows you to connect and use external SDRAM. * * It supports boards below:: * - STM32F429-Discovery: * - 8MB (64Mbit) memory size * - STM32F439-EVAL: * - 8MB (64Mbit) memory size * - STM32F7-Discovery: * - 8MB (64Mbit) memory size * * \par Set your target * * \note If you follow my description in @ref TM_DISCO library on how to select your used board, then this library will automatically select your "target". * * By default, STM32F429-Discovery configuration is used, because this board is cheap and most users uses this. * * If you are working with STM324x9-EVAL board, you can add define in defines.h file and enable configuration for SDRAM on this board. * Other boards are supported below. * \code //Use SDRAM on STM32F439-EVAL board #define SDRAM_USE_STM32F439_EVAL //Use SDRAM on STM32F7-Discovery board #define SDRAM_USE_STM32F7_DISCOVERY //Use SDRAM on STM32F429-Discovery board #define SDRAM_USE_STM32F429_DISCOVERY //Use SDRAM on STM32F469-Discovery board #define SDRAM_USE_STM32F469_DISCOVERY //Use SDRAM on STM32F769-Discovery board #define SDRAM_USE_STM32F769_DISCOVERY \endcode * * \par STM32F429-Discovery pinout * \verbatim PB5 <-> FMC_SDCKE | PC0 <-> FMC_SDNWE | PD0 <-> FMC_D2 | PE0 <-> FMC_NBL0 | PF0 <-> FMC_A0 | PG0 <-> FMC_A10 PB6 <-> FMC_SDNE1 | | PD1 <-> FMC_D3 | PE1 <-> FMC_NBL1 | PF1 <-> FMC_A1 | PG1 <-> FMC_A11 | | PD8 <-> FMC_D13 | PE7 <-> FMC_D4 | PF2 <-> FMC_A2 | PG4 <-> FMC_BA0 | | PD9 <-> FMC_D14 | PE8 <-> FMC_D5 | PF3 <-> FMC_A3 | PG5 <-> FMC_BA1 | | PD10 <-> FMC_D15 | PE9 <-> FMC_D6 | PF4 <-> FMC_A4 | PG8 <-> FMC_SDCLK | | PD14 <-> FMC_D0 | PE10 <-> FMC_D7 | PF5 <-> FMC_A5 | PG15 <-> FMC_NCAS | | PD15 <-> FMC_D1 | PE11 <-> FMC_D8 | PF11 <-> FMC_NRAS | | | | PE12 <-> FMC_D9 | PF12 <-> FMC_A6 | | | | PE13 <-> FMC_D10 | PF13 <-> FMC_A7 | | | | PE14 <-> FMC_D11 | PF14 <-> FMC_A8 | | | | PE15 <-> FMC_D12 | PF15 <-> FMC_A9 | \endverbatim * * \par STM32439-EVAL pinout * \verbatim PD0 <-> FMC_D2 | PE0 <-> FMC_NBL0 | PF0 <-> FMC_A0 | PG0 <-> FMC_A10 | PH2 <-> FMC_SDCKE0| PI0 <-> FMC_D24 PD1 <-> FMC_D3 | PE1 <-> FMC_NBL1 | PF1 <-> FMC_A1 | PG1 <-> FMC_A11 | PH3 <-> FMC_SDNE0 | PI1 <-> FMC_D25 PD8 <-> FMC_D13 | PE7 <-> FMC_D4 | PF2 <-> FMC_A2 | PG4 <-> FMC_A14 | PH5 <-> FMC_SDNWE | PI2 <-> FMC_D26 PD9 <-> FMC_D14 | PE8 <-> FMC_D5 | PF3 <-> FMC_A3 | PG5 <-> FMC_A15 | PH8 <-> FMC_D16 | PI3 <-> FMC_D27 PD10 <-> FMC_D15 | PE9 <-> FMC_D6 | PF4 <-> FMC_A4 | PG8 <-> FC_SDCLK | PH9 <-> FMC_D17 | PI4 <-> FMC_NBL2 PD14 <-> FMC_D0 | PE10 <-> FMC_D7 | PF5 <-> FMC_A5 | PG15 <-> FMC_NCAS | PH10 <-> FMC_D18 | PI5 <-> FMC_NBL3 PD15 <-> FMC_D1 | PE11 <-> FMC_D8 | PF11 <-> FC_NRAS | | PH11 <-> FMC_D19 | PI6 <-> FMC_D28 | PE12 <-> FMC_D9 | PF12 <-> FMC_A6 | | PH12 <-> FMC_D20 | PI7 <-> FMC_D29 | PE13 <-> FMC_D10 | PF13 <-> FMC_A7 | | PH13 <-> FMC_D21 | PI9 <-> FMC_D30 | PE14 <-> FMC_D11 | PF14 <-> FMC_A8 | | PH14 <-> FMC_D22 | PI10 <-> FMC_D31 | PE15 <-> FMC_D12 | PF15 <-> FMC_A9 | | PH15 <-> FMC_D23 | \endverbatim * * \par STM32F469-Discovery pinout * \verbatim PC0 <-> FMC_SDNWE | PD0 <-> FMC_D2 | PE0 <-> FMC_NBL0 | PF0 <-> FMC_A0 | PG0 <-> FMC_A10 | PH2 <-> FMC_SDCKE0| PI0 <-> FMC_D24 | PD1 <-> FMC_D3 | PE1 <-> FMC_NBL1 | PF1 <-> FMC_A1 | PG1 <-> FMC_A11 | PH3 <-> FMC_SDNE0 | PI1 <-> FMC_D25 | PD8 <-> FMC_D13 | PE7 <-> FMC_D4 | PF2 <-> FMC_A2 | PG4 <-> FMC_A14 | PH8 <-> FMC_D16 | PI2 <-> FMC_D26 | PD9 <-> FMC_D14 | PE8 <-> FMC_D5 | PF3 <-> FMC_A3 | PG5 <-> FMC_A15 | PH9 <-> FMC_D17 | PI3 <-> FMC_D27 | PD10 <-> FMC_D15 | PE9 <-> FMC_D6 | PF4 <-> FMC_A4 | PG8 <-> FC_SDCLK | PH10 <-> FMC_D18 | PI4 <-> FMC_NBL2 | PD14 <-> FMC_D0 | PE10 <-> FMC_D7 | PF5 <-> FMC_A5 | PG15 <-> FMC_NCAS | PH11 <-> FMC_D19 | PI5 <-> FMC_NBL3 | PD15 <-> FMC_D1 | PE11 <-> FMC_D8 | PF11 <-> FC_NRAS | | PH12 <-> FMC_D20 | PI6 <-> FMC_D28 | | PE12 <-> FMC_D9 | PF12 <-> FMC_A6 | | PH13 <-> FMC_D21 | PI7 <-> FMC_D29 | | PE13 <-> FMC_D10 | PF13 <-> FMC_A7 | | PH14 <-> FMC_D22 | PI9 <-> FMC_D30 | | PE14 <-> FMC_D11 | PF14 <-> FMC_A8 | | PH15 <-> FMC_D23 | PI10 <-> FMC_D31 | | PE15 <-> FMC_D12 | PF15 <-> FMC_A9 | | | \endverbatim * * \par STM32F7-Discovery pinout * \verbatim PC3 <-> FMC_SDCKE0 | PD0 <-> FMC_D2 | PE0 <-> FMC_NBL0 | PF0 <-> FMC_A0 | PG0 <-> FMC_A10 | PH3 <-> FMC_SDNE0 | PD1 <-> FMC_D3 | PE1 <-> FMC_NBL1 | PF1 <-> FMC_A1 | PG1 <-> FMC_A11 | PH5 <-> FMC_SDNWE | PD3 <-> | PE7 <-> FMC_D4 | PF2 <-> FMC_A2 | PG4 <-> FMC_BA0 | | PD8 <-> FMC_D13 | PE8 <-> FMC_D5 | PF3 <-> FMC_A3 | PG5 <-> FMC_BA1 | | PD9 <-> FMC_D14 | PE9 <-> FMC_D6 | PF4 <-> FMC_A4 | PG8 <-> FMC_SDCLK | | PD10 <-> FMC_D15 | PE10 <-> FMC_D7 | PF5 <-> FMC_A5 | PG15 <-> FMC_SDNCAS | | PD14 <-> FMC_D0 | PE11 <-> FMC_D8 | PF11 <-> FMC_NRAS | | | PD15 <-> FMC_D1 | PE12 <-> FMC_D9 | PF12 <-> FMC_A6 | | | | PE13 <-> FMC_D10 | PF13 <-> FMC_A7 | | | | PE14 <-> FMC_D11 | PF14 <-> FMC_A8 | | | | PE15 <-> FMC_D12 | PF15 <-> FMC_A9 | | \endverbatim * * \par Changelog * \verbatim Version 1.0 - First release Version 1.1 - October 10, 2015 - Added support for STM32F469-Discovery \endverbatim * * \par Dependencies * \verbatim - STM32Fxxx HAL - defines.h - attributes.h - TM GPIO \endverbatim */ #include "stm32fxxx_hal.h" #include "defines.h" #include "attributes.h" #include "tm_stm32_gpio.h" /** * @defgroup TM_SDRAM_Macros * @brief Library defines * @{ * * Library defines depends on board you use. */ #if defined(SDRAM_USE_STM32F439_EVAL) || defined(STM32F439_EVAL) /* Make define */ #ifndef SDRAM_USE_STM32F439_EVAL #define SDRAM_USE_STM32F439_EVAL #endif /* SDRAM start address = FMC peripheral start address */ #define SDRAM_START_ADR (uint32_t)0xC0000000 #define SDRAM_MEMORY_SIZE (uint32_t)0x800000 #define SDRAM_BANK FMC_SDRAM_BANK1 #define SDRAM_COMMAND_TARGET_BANK FMC_SDRAM_CMD_TARGET_BANK1 #define SDRAM_REFRESH_COUNT 1385 #define SDRAM_ROWBITS_NUMBER FMC_SDRAM_ROW_BITS_NUM_11 #define SDRAM_MEMORY_WIDTH FMC_SDRAM_MEM_BUS_WIDTH_32 #define SDRAM_READ_BURST_STATE FMC_SDRAM_RBURST_DISABLE #define SDRAM_CAS_LATENCY FMC_SDRAM_CAS_LATENCY_3 #define SDRAM_REG_VALUE 0x0230 #elif defined(SDRAM_USE_STM32F469_DISCOVERY) || defined(STM32F469_DISCOVERY) /* Make define */ #ifndef SDRAM_USE_STM32F469_DISCOVERY #define SDRAM_USE_STM32F469_DISCOVERY #endif /* SDRAM start address = FMC peripheral start address */ #define SDRAM_START_ADR (uint32_t)0xC0000000 #define SDRAM_MEMORY_SIZE (uint32_t)0x800000 #define SDRAM_BANK FMC_SDRAM_BANK1 #define SDRAM_COMMAND_TARGET_BANK FMC_SDRAM_CMD_TARGET_BANK1 #define SDRAM_REFRESH_COUNT 1385 #define SDRAM_ROWBITS_NUMBER FMC_SDRAM_ROW_BITS_NUM_11 #define SDRAM_MEMORY_WIDTH FMC_SDRAM_MEM_BUS_WIDTH_32 #define SDRAM_READ_BURST_STATE FMC_SDRAM_RBURST_DISABLE #define SDRAM_CAS_LATENCY FMC_SDRAM_CAS_LATENCY_3 #define SDRAM_REG_VALUE 0x0230 #elif defined(SDRAM_USE_STM32F429_DISCOVERY) || defined(STM32F429_DISCOVERY) /* Make define */ #ifndef SDRAM_USE_STM32F429_DISCOVERY #define SDRAM_USE_STM32F429_DISCOVERY #endif /* SDRAM start address = FMC peripheral start address */ #define SDRAM_START_ADR (uint32_t)0xD0000000 #define SDRAM_MEMORY_SIZE (uint32_t)0x800000 #define SDRAM_BANK FMC_SDRAM_BANK2 #define SDRAM_COMMAND_TARGET_BANK FMC_SDRAM_CMD_TARGET_BANK2 #define SDRAM_REFRESH_COUNT 680 #define SDRAM_ROWBITS_NUMBER FMC_SDRAM_ROW_BITS_NUM_12 #define SDRAM_MEMORY_WIDTH FMC_SDRAM_MEM_BUS_WIDTH_16 #define SDRAM_READ_BURST_STATE FMC_SDRAM_RBURST_DISABLE #define SDRAM_CAS_LATENCY FMC_SDRAM_CAS_LATENCY_3 #define SDRAM_REG_VALUE 0x0231 #elif defined(SDRAM_USE_STM32F7_DISCOVERY) || defined(STM32F7_DISCOVERY) /* Make define */ #ifndef SDRAM_USE_STM32F7_DISCOVERY #define SDRAM_USE_STM32F7_DISCOVERY #endif /* SDRAM start address = FMC peripheral start address */ #define SDRAM_START_ADR (uint32_t)0xC0000000 #define SDRAM_MEMORY_SIZE (uint32_t)0x800000 #define SDRAM_BANK FMC_SDRAM_BANK1 #define SDRAM_COMMAND_TARGET_BANK FMC_SDRAM_CMD_TARGET_BANK1 #define SDRAM_REFRESH_COUNT 0x0603 #define SDRAM_ROWBITS_NUMBER FMC_SDRAM_ROW_BITS_NUM_12 #define SDRAM_MEMORY_WIDTH FMC_SDRAM_MEM_BUS_WIDTH_16 #define SDRAM_READ_BURST_STATE FMC_SDRAM_RBURST_DISABLE #define SDRAM_CAS_LATENCY FMC_SDRAM_CAS_LATENCY_2 #define SDRAM_REG_VALUE 0x0220 #elif defined(SDRAM_USE_STM32F769_DISCOVERY) || defined(STM32F769_DISCOVERY) /* Make define */ #ifndef SDRAM_USE_STM32F769_DISCOVERY #define SDRAM_USE_STM32F769_DISCOVERY #endif /* SDRAM start address = FMC peripheral start address */ #define SDRAM_START_ADR (uint32_t)0xC0000000 #define SDRAM_MEMORY_SIZE (uint32_t)0x1000000 #define SDRAM_BANK FMC_SDRAM_BANK1 #define SDRAM_COMMAND_TARGET_BANK FMC_SDRAM_CMD_TARGET_BANK1 #define SDRAM_REFRESH_COUNT 0x0603 #define SDRAM_ROWBITS_NUMBER FMC_SDRAM_ROW_BITS_NUM_12 #define SDRAM_MEMORY_WIDTH FMC_SDRAM_MEM_BUS_WIDTH_32 #define SDRAM_READ_BURST_STATE FMC_SDRAM_RBURST_DISABLE #define SDRAM_CAS_LATENCY FMC_SDRAM_CAS_LATENCY_3 #define SDRAM_REG_VALUE 0x0230 #endif /* Timeout for SDRAM initialization */ #define SDRAM_TIMEOUT ((uint32_t)0xFFFF) /** * @} */ /** * @defgroup TM_SDRAM_Functions * @brief Library Functions * @{ */ /** * @brief Initializes SDRAM * @param None * @retval SDRAM status * - 0: SDRAM is not configured OK * - > 0: SDRAM is configured OK and prepared to work */ uint8_t TM_SDRAM_Init(void); /** * @brief Gets SDRAM memory size * @param None * @retval SDRAM memory size in bytes */ #define TM_SDRAM_GetSize() (SDRAM_MEMORY_SIZE) /** * @brief Writes 8-bit value to SDRAM * @param address: Offset address from starting address of SDRAM * @param value: 8-bit value to be saved in SDRAM * @retval None * @note Defined as macro for faster execution */ #define TM_SDRAM_Write8(address, value) (*(__IO uint8_t *) (SDRAM_START_ADR + (address)) = (value)) /** * @brief Reads 8-bit value from SDRAM * @param address: offset address from starting address of SDRAM * @retval 8-bit value stored at desired location * @note Defined as macro for faster execution */ #define TM_SDRAM_Read8(address) (*(__IO uint8_t *) (SDRAM_START_ADR + (address))) /** * @brief Writes 16-bit value to SDRAM * @param address: Offset address from starting address of SDRAM * @param value: 16-bit value to be saved in SDRAM * @retval None * @note Defined as macro for faster execution */ #define TM_SDRAM_Write16(address, value) (*(__IO uint16_t *) (SDRAM_START_ADR + (address)) = (value)) /** * @brief Reads 16-bit value from SDRAM * @param address: offset address from starting address of SDRAM * @retval 16-bit value stored at desired location * @note Defined as macro for faster execution */ #define TM_SDRAM_Read16(address) (*(__IO uint16_t *) (SDRAM_START_ADR + (address))) /** * @brief Writes 32-bit value to SDRAM * @param address: Offset address from starting address of SDRAM * @param value: 32-bit value to be saved in SDRAM * @retval None * @note Defined as macro for faster execution */ #define TM_SDRAM_Write32(address, value) (*(__IO uint32_t *) (SDRAM_START_ADR + (address)) = (value)) /** * @brief Reads 32-bit value from SDRAM * @param address: offset address from starting address of SDRAM * @retval 32-bit value stored at desired location * @note Defined as macro for faster execution */ #define TM_SDRAM_Read32(address) (*(__IO uint32_t *) (SDRAM_START_ADR + (address))) /** * @brief Writes float value to SDRAM * @param address: Offset address from starting address of SDRAM * @param value: float value to be saved in SDRAM * @retval None * @note Defined as macro for faster execution */ #define TM_SDRAM_WriteFloat(address, value) (*(__IO float *) (SDRAM_START_ADR + (address)) = (value)) /** * @brief Reads float value from SDRAM * @param address: offset address from starting address of SDRAM * @retval float value stored at desired location * @note Defined as macro for faster execution */ #define TM_SDRAM_ReadFloat(address) (*(__IO float *) (SDRAM_START_ADR + (address))) /** * @brief Initialize custom pins callback. * It can be used by user to implement custom pins for application if needed * @note This function is called every time @ref TM_SDRAM_Init() function is called * @param AlternateFunction: Alternate function to be used when initializing GPIO pins * @retval Initialization status: * - 0: User did not initialize custom pins, default will be used, depending on already supported boards * - > 0: User has initialized custom pins, default pins will be ignored * @note With __weak parameter to prevent link errors if not defined by user */ uint8_t TM_SDRAM_InitCustomPinsCallback(uint16_t AlternateFunction); /** * @} */ /** * @} */ /** * @} */ #endif