stm32l4xx_ll_flash.rar

/** ****************************************************************************** * @file stm32l4xx_ll_flash.c * @author ZCShou * @brief Flash LL module driver. ****************************************************************************** * @attention * * <h2><center>&copy; COPYRIGHT(c) 2017 ZCShou</center></h2> * * ST 的官方驱动 LL 库并没有 flash 驱动。这里自己实现。 * * 1. 由于在 stm32l4xx_ll_system.h 中存在部分 FLASH 操作函数（ACR寄存器的处理）且不全面 * 因此这里需要额外处理（重命名） * * 2. Main memory * （1） FLASH_ACR 完成 * （2） FLASH_PDKEYR 完成 * （3） FLASH_KEYR 完成 * （4） FLASH_OPTKEYR 完成 * （5） FLASH_SR 完成 * （6） FLASH_CR 完成 * （7） FLASH_ECCR 完成 * （8） FLASH_OPTR 未完成 * （9） FLASH_PCROP1SR 未完成 * 后续寄存器 均未完成 * 3. Information block * - System memory * - OTP area * - Option bytes * 4. 根据 HAL 库的实现，相比于与手册的推荐流程，擦写的执行序列还有其他操作。 * * 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. * ****************************************************************************** */ /* Includes ------------------------------------------------------------------*/ #include "stm32l4xx_ll_flash.h" #include "stm32l4xx_ll_rcc.h" #include "stm32l4xx_ll_system.h" #include "stm32l4xx_ll_pwr.h" #ifdef USE_FULL_ASSERT #include "stm32_assert.h" #else #define assert_param(expr) ((void)0U) #endif /* USE_FULL_ASSERT */ /** @addtogroup STM32L4xx_LL_Driver * @{ */ /** @addtogroup FLASH_LL * @{ */ /* Private types -------------------------------------------------------------*/ /* Private variables ---------------------------------------------------------*/ /* Private constants ---------------------------------------------------------*/ /** @addtogroup FLASH_LL_Private_Constants * @{ */ /** * @} */ /* Private macros ------------------------------------------------------------*/ /** @addtogroup FLASH_LL_Private_Macros * @{ */ #define IS_LL_FLASH_WRITE_ADDR(__ADDR__) ((__ADDR__) % LL_FLASH_ALIGNMENT_MIN_SIZE == 0) /** * @} */ /* Private function prototypes -----------------------------------------------*/ /** @defgroup FLASH_LL_Private_Functions FLASH Private functions * @{ */ /** * @} */ /* Exported functions --------------------------------------------------------*/ /** @addtogroup FLASH_LL_Exported_Functions * @{ */ /** * @brief Clear All Error in SR * @param FLASHx FLASH Instance * @retval None */ void LL_FLASH_ClearAllErrorFlag(void) { LL_FLASH_ClearFlag_OPTVERR(FLASH); LL_FLASH_ClearFlag_RDERR(FLASH); LL_FLASH_ClearFlag_FASTERR(FLASH); LL_FLASH_ClearFlag_MISERR(FLASH); LL_FLASH_ClearFlag_PGSERR(FLASH); LL_FLASH_ClearFlag_SIZERR(FLASH); LL_FLASH_ClearFlag_PGAERR(FLASH); LL_FLASH_ClearFlag_WRPERR(FLASH); LL_FLASH_ClearFlag_PROGERR(FLASH); LL_FLASH_ClearFlag_OPERR(FLASH); } /** * @brief Flush the instruction and data caches. * @retval None */ void LL_FLASH_FlushCaches(void) { /* Flush instruction cache */ if (LL_FLASH_IsEnabledInstructionCache(FLASH)) { LL_FLASH_DisableInstructionCache(FLASH); /* Reset instruction cache */ LL_FLASH_InstructionCacheReset(FLASH); /* Enable instruction cache */ LL_FLASH_EnableInstructionCache(FLASH); } /* Flush data cache */ if(LL_FLASH_IsEnabledDataCache(FLASH)) { LL_FLASH_ZCS_DisableDataCache(FLASH); /* Reset data cache */ LL_FLASH_DataCacheReset(FLASH); /* Enable data cache */ LL_FLASH_ZCS_EnableDataCache(FLASH); } } /** * @brief Erase Page * @param No Page No * @retval None */ void LL_FLASH_ErasePage(uint32_t No) { /* Check that no Flash memory operation is ongoing by checking the BSY bit */ while(LL_FLASH_IsActiveFlag_BSY(FLASH)); /* Check and clear all error programming flags due to a previous programming. If not, PGSERR is set. */ LL_FLASH_ClearAllErrorFlag(); /* Set the PER bit and select the page you wish to erase (PNB) with the associated bank (BKER) in the Flash control register (FLASH_CR). */ LL_FLASH_EnablePageErase(FLASH); if (No >= LL_FLASH_BANK1_PAGE_NUM) { No -= LL_FLASH_BANK1_PAGE_NUM; LL_FLASH_SetErasePageBank(FLASH, LL_FLASH_BANK2); } else { LL_FLASH_SetErasePageBank(FLASH, LL_FLASH_BANK1); } LL_FLASH_SetErasePageNo(FLASH, No); /* Set the STRT bit in the FLASH_CR register. */ LL_FLASH_EraseStart(FLASH); /* Wait for the BSY bit to be cleared in the FLASH_SR register. */ while(LL_FLASH_IsActiveFlag_BSY(FLASH)); /* 完成只有需要清除擦除标志. */ LL_FLASH_DisablePageErase(FLASH); /* Flush the caches to be sure of the data consistency */ LL_FLASH_FlushCaches(); } /** * @brief Erase Bank * @param Bank This parameter can be one of the following values: * @arg @ref LL_FLASH_BANK1 * @arg @ref LL_FLASH_BANK2 * @retval None */ void LL_FLASH_EraseBank(uint32_t Bank) { /* Check that no Flash memory operation is ongoing by checking the BSY bit */ while(LL_FLASH_IsActiveFlag_BSY(FLASH)); /* Check and clear all error programming flags due to a previous programming. If not, PGSERR is set. */ LL_FLASH_ClearAllErrorFlag(); /* Set the MER1 bit or/and MER2 (depending on the bank) in the Flash control register (FLASH_CR). Both banks can be selected in the same operation. */ if (Bank == LL_FLASH_BANK1) { LL_FLASH_EnableBank1Erase(FLASH); } else { LL_FLASH_EnableBank2Erase(FLASH); } /* Set the STRT bit in the FLASH_CR register. */ LL_FLASH_EraseStart(FLASH); /* Wait for the BSY bit to be cleared in the FLASH_SR register. */ while(LL_FLASH_IsActiveFlag_BSY(FLASH)); /* 完成只有需要清除擦除标志. */ LL_FLASH_DisableBank1Erase(FLASH); LL_FLASH_DisableBank2Erase(FLASH); /* Flush the caches to be sure of the data consistency */ LL_FLASH_FlushCaches(); } /** * @brief Erase Chip * @param None * @retval None */ void LL_FLASH_EraseChip(void) { /* Check that no Flash memory operation is ongoing by checking the BSY bit */ while(LL_FLASH_IsActiveFlag_BSY(FLASH)); /* Check and clear all error programming flags due to a previous programming. If not, PGSERR is set. */ LL_FLASH_ClearAllErrorFlag(); /* Set the MER1 bit or/and MER2 (depending on the bank) in the Flash control register (FLASH_CR). Both banks can be selected in the same operation. */ LL_FLASH_EnableBank1Erase(FLASH); LL_FLASH_EnableBank2Erase(FLASH); /* Set the STRT bit in the FLASH_CR register. */ LL_FLASH_EraseStart(FLASH); /* Wait for the BSY bit to be cleared in the FLASH_SR register. */ while(LL_FLASH_IsActiveFlag_BSY(FLASH)); /* 完成只有需要清除擦除标志. */ LL_FLASH_DisableBank1Erase(FLASH); LL_FLASH_DisableBank2Erase(FLASH); /* Flush the caches t