/* * Copyright 2017-2020 NXP * All rights reserved. * * SPDX-License-Identifier: BSD-3-Clause */ #include "fsl_romapi.h" /******************************************************************************* * Definitions ******************************************************************************/ /* Component ID definition, used by tools. */ #ifndef FSL_COMPONENT_ID #define FSL_COMPONENT_ID "driver.romapi" #endif /******************************************************************************* * Prototypes ******************************************************************************/ /*! * @brief Interface for the ROM FLEXSPI NOR flash driver. */ typedef struct { uint32_t version; status_t (*init)(uint32_t instance, flexspi_nor_config_t *config); status_t (*program)(uint32_t instance, flexspi_nor_config_t *config, uint32_t dst_addr, const uint32_t *src); status_t (*erase_all)(uint32_t instance, flexspi_nor_config_t *config); status_t (*erase)(uint32_t instance, flexspi_nor_config_t *config, uint32_t start, uint32_t lengthInBytes); status_t (*read)( uint32_t instance, flexspi_nor_config_t *config, uint32_t *dst, uint32_t addr, uint32_t lengthInBytes); void (*clear_cache)(uint32_t instance); status_t (*xfer)(uint32_t instance, flexspi_xfer_t *xfer); status_t (*update_lut)(uint32_t instance, uint32_t seqIndex, const uint32_t *lutBase, uint32_t seqNumber); status_t (*get_config)(uint32_t instance, flexspi_nor_config_t *config, serial_nor_config_option_t *option); } flexspi_nor_driver_interface_t; /*! * @brief Root of the bootloader api tree. * * An instance of this struct resides in read-only memory in the bootloader. It * provides a user application access to APIs exported by the bootloader. * * @note The order of existing fields must not be changed. */ typedef struct { const uint32_t version; /*!< Bootloader version number */ const char *copyright; /*!< Bootloader Copyright */ void (*runBootloader)(void *arg); /*!< Function to start the bootloader executing */ const uint32_t *reserved0; /*!< Reserved */ const flexspi_nor_driver_interface_t *flexSpiNorDriver; /*!< FlexSPI NOR Flash API */ const uint32_t *reserved1[5]; /*!< Reserved */ } bootloader_api_entry_t; /******************************************************************************* * Variables ******************************************************************************/ #define g_bootloaderTree ((bootloader_api_entry_t *)*(uint32_t *)0x0020001cU) /******************************************************************************* * Codes ******************************************************************************/ /******************************************************************************* * ROM FLEXSPI NOR driver ******************************************************************************/ #if defined(FSL_FEATURE_BOOT_ROM_HAS_ROMAPI) && FSL_FEATURE_BOOT_ROM_HAS_ROMAPI #if defined(FSL_ROM_HAS_RUNBOOTLOADER_API) && FSL_ROM_HAS_RUNBOOTLOADER_API /*! * @brief Enter Bootloader. * * @param arg A pointer to the storage for the bootloader param. * refer to System Boot Chapter in device reference manual for details. */ void ROM_RunBootloader(void *arg) { g_bootloaderTree->runBootloader(arg); } #endif /* FSL_ROM_HAS_RUNBOOTLOADER_API */ /*! * @brief Initialize Serial NOR devices via FLEXSPI. * * @param instance storage the instance of FLEXSPI. * @param config A pointer to the storage for the driver runtime state. */ status_t ROM_FLEXSPI_NorFlash_Init(uint32_t instance, flexspi_nor_config_t *config) { return g_bootloaderTree->flexSpiNorDriver->init(instance, config); } /*! * @brief Program data to Serial NOR via FLEXSPI. * * @param instance storage the instance of FLEXSPI. * @param config A pointer to the storage for the driver runtime state. * @param dstAddr A pointer to the desired flash memory to be programmed. * @param src A pointer to the source buffer of data that is to be programmed * into the NOR flash. */ status_t ROM_FLEXSPI_NorFlash_ProgramPage(uint32_t instance, flexspi_nor_config_t *config, uint32_t dstAddr, const uint32_t *src) { return g_bootloaderTree->flexSpiNorDriver->program(instance, config, dstAddr, src); } #if defined(FSL_ROM_FLEXSPINOR_API_HAS_FEATURE_READ) && FSL_ROM_FLEXSPINOR_API_HAS_FEATURE_READ /*! * @brief Read data from Serial NOR * * @param instance storage the instance of FLEXSPI. * @param config A pointer to the storage for the driver runtime state. * @param dst A pointer to the dest buffer of data that is to be read from the NOR flash. * @param lengthInBytes The length, given in bytes to be read. */ status_t ROM_FLEXSPI_NorFlash_Read( uint32_t instance, flexspi_nor_config_t *config, uint32_t *dst, uint32_t start, uint32_t lengthInBytes) { return g_bootloaderTree->flexSpiNorDriver->read(instance, config, dst, start, lengthInBytes); } #endif /* FSL_ROM_FLEXSPINOR_API_HAS_FEATURE_READ */ /*! * @brief Erase Flash Region specified by address and length. * * @param instance storage the index of FLEXSPI. * @param config A pointer to the storage for the driver runtime state. * @param start The start address of the desired NOR flash memory to be erased. * @param length The length, given in bytes to be erased. */ status_t ROM_FLEXSPI_NorFlash_Erase(uint32_t instance, flexspi_nor_config_t *config, uint32_t start, uint32_t length) { return g_bootloaderTree->flexSpiNorDriver->erase(instance, config, start, length); } #if defined(FSL_ROM_FLEXSPINOR_API_HAS_FEATURE_ERASE_ALL) && FSL_ROM_FLEXSPINOR_API_HAS_FEATURE_ERASE_ALL /*! @brief Erase all the Serial NOR devices connected on FLEXSPI. */ status_t ROM_FLEXSPI_NorFlash_EraseAll(uint32_t instance, flexspi_nor_config_t *config) { return g_bootloaderTree->flexSpiNorDriver->erase_all(instance, config); } #endif /* FSL_ROM_FLEXSPINOR_API_HAS_FEATURE_ERASE_ALL */ #if defined(FSL_ROM_FLEXSPINOR_API_HAS_FEATURE_CMD_XFER) && FSL_ROM_FLEXSPINOR_API_HAS_FEATURE_CMD_XFER /*! @brief FLEXSPI command */ status_t ROM_FLEXSPI_NorFlash_CommandXfer(uint32_t instance, flexspi_xfer_t *xfer) { return g_bootloaderTree->flexSpiNorDriver->xfer(instance, xfer); } #endif /* FSL_ROM_FLEXSPINOR_API_HAS_FEATURE_CMD_XFER */ #if defined(FSL_ROM_FLEXSPINOR_API_HAS_FEATURE_UPDATE_LUT) && FSL_ROM_FLEXSPINOR_API_HAS_FEATURE_UPDATE_LUT /*! @brief Configure FLEXSPI Lookup table. */ status_t ROM_FLEXSPI_NorFlash_UpdateLut(uint32_t instance, uint32_t seqIndex, const uint32_t *lutBase, uint32_t seqNumber) { return g_bootloaderTree->flexSpiNorDriver->update_lut(instance, seqIndex, lutBase, seqNumber); } #endif /* FSL_ROM_FLEXSPINOR_API_HAS_FEATURE_UPDATE_LUT */ /*! @brief Software reset for the FLEXSPI logic. */ void ROM_FLEXSPI_NorFlash_ClearCache(uint32_t instance) { g_bootloaderTree->flexSpiNorDriver->clear_cache(instance); } #if defined(FSL_ROM_FLEXSPINOR_API_HAS_FEATURE_GET_CONFIG) && FSL_ROM_FLEXSPINOR_API_HAS_FEATURE_GET_CONFIG /*! @brief Get FLEXSPI NOR Configuration Block based on specified option. */ status_t ROM_FLEXSPI_NorFlash_GetConfig(uint32_t instance, flexspi_nor_config_t *config, serial_nor_config_option_t *option) { status_t status = g_bootloaderTree->flexSpiNorDriver->get_config(instance, config, option); if (status == kStatus_Success) { if (config->memConfig.readSampleClkSrc == (uint8_t)kFLEXSPIReadSampleClk_LoopbackInternally) { config->memConfig.readSampleClkSrc = (uint8_t)kFLEXSPIReadSampleClk_LoopbackFromDqsPad; } } return status; } #endif /* FSL_ROM_FLEXSPINOR_API_HAS_FEATURE_GET_CONFIG */ #endif /* FSL_FEATURE_BOOT_ROM_HAS_ROMAPI */