/* * Copyright (c) 2022 BrainCo Inc. * * SPDX-License-Identifier: Apache-2.0 */ #include "flash_gd32.h" #include #include #include LOG_MODULE_DECLARE(flash_gd32); #define GD32_NV_FLASH_V2_NODE DT_INST(0, gd_gd32_nv_flash_v2) #define GD32_NV_FLASH_V2_TIMEOUT DT_PROP(GD32_NV_FLASH_V2_NODE, max_erase_time_ms) #if !defined(CONFIG_SOC_GD32A503) /** * @brief GD32 FMC v2 flash memory has 2 banks. * Bank0 holds the first 512KB, bank1 is used give capacity for reset. * The page size is the same within the same bank, but not equal for all banks. */ #if (PRE_KB(512) >= SOC_NV_FLASH_SIZE) #define GD32_NV_FLASH_V2_BANK0_SIZE SOC_NV_FLASH_SIZE #define GD32_NV_FLASH_V2_BANK0_PAGE_SIZE DT_PROP(GD32_NV_FLASH_V2_NODE, bank0_page_size) #else #define GD32_NV_FLASH_V2_BANK0_SIZE KB(512) #define GD32_NV_FLASH_V2_BANK0_PAGE_SIZE DT_PROP(GD32_NV_FLASH_V2_NODE, bank0_page_size) #define GD32_NV_FLASH_V2_BANK1_SIZE (SOC_NV_FLASH_SIZE - KB(512)) #define GD32_NV_FLASH_V2_BANK1_PAGE_SIZE DT_PROP(GD32_NV_FLASH_V2_NODE, bank1_page_size) #endif #elif defined(CONFIG_SOC_GD32A503) /** * @brief GD32A503 series flash memory has 2 banks. * Bank0 holds the first 256KB, bank1 is used give capacity for reset. * The page size is 1KB for all banks. */ #if (PRE_KB(256) >= SOC_NV_FLASH_SIZE) #define GD32_NV_FLASH_V2_BANK0_SIZE SOC_NV_FLASH_SIZE #define GD32_NV_FLASH_V2_BANK0_PAGE_SIZE DT_PROP(GD32_NV_FLASH_V2_NODE, bank0_page_size) #else #define GD32_NV_FLASH_V2_BANK0_SIZE KB(256) #define GD32_NV_FLASH_V2_BANK0_PAGE_SIZE DT_PROP(GD32_NV_FLASH_V2_NODE, bank0_page_size) #define GD32_NV_FLASH_V2_BANK1_SIZE (SOC_NV_FLASH_SIZE - KB(256)) #define GD32_NV_FLASH_V2_BANK1_PAGE_SIZE DT_PROP(GD32_NV_FLASH_V2_NODE, bank1_page_size) #endif #endif #define GD32_FMC_V2_BANK0_WRITE_ERR (FMC_STAT0_PGERR | FMC_STAT0_WPERR) #define GD32_FMC_V2_BANK0_ERASE_ERR FMC_STAT0_WPERR #define GD32_FMC_V2_BANK1_WRITE_ERR (FMC_STAT1_PGERR | FMC_STAT1_WPERR) #define GD32_FMC_V2_BANK1_ERASE_ERR FMC_STAT1_WPERR #ifdef CONFIG_FLASH_PAGE_LAYOUT static struct flash_pages_layout gd32_fmc_v2_layout[] = { { .pages_size = GD32_NV_FLASH_V2_BANK0_PAGE_SIZE, .pages_count = GD32_NV_FLASH_V2_BANK0_SIZE / GD32_NV_FLASH_V2_BANK0_PAGE_SIZE }, #ifdef GD32_NV_FLASH_V2_BANK1_SIZE { .pages_size = GD32_NV_FLASH_V2_BANK1_PAGE_SIZE, .pages_count = GD32_NV_FLASH_V2_BANK1_SIZE / GD32_NV_FLASH_V2_BANK1_PAGE_SIZE } #endif }; #endif static inline void gd32_fmc_v2_bank0_unlock(void) { FMC_KEY0 = UNLOCK_KEY0; FMC_KEY0 = UNLOCK_KEY1; } static inline void gd32_fmc_v2_bank0_lock(void) { FMC_CTL0 |= FMC_CTL0_LK; } static int gd32_fmc_v2_bank0_wait_idle(void) { const int64_t expired_time = k_uptime_get() + GD32_NV_FLASH_V2_TIMEOUT; while (FMC_STAT0 & FMC_STAT0_BUSY) { if (k_uptime_get() > expired_time) { return -ETIMEDOUT; } } return 0; } static int gd32_fmc_v2_bank0_write(off_t offset, const void *data, size_t len) { flash_prg_t *prg_flash = (flash_prg_t *)((uint8_t *)SOC_NV_FLASH_ADDR + offset); flash_prg_t *prg_data = (flash_prg_t *)data; int ret = 0; gd32_fmc_v2_bank0_unlock(); if (FMC_STAT0 & FMC_STAT0_BUSY) { return -EBUSY; } FMC_CTL0 |= FMC_CTL0_PG; for (size_t i = 0U; i < (len / sizeof(flash_prg_t)); i++) { *prg_flash++ = *prg_data++; } ret = gd32_fmc_v2_bank0_wait_idle(); if (ret < 0) { goto expired_out; } if (FMC_STAT0 & GD32_FMC_V2_BANK0_WRITE_ERR) { ret = -EIO; FMC_STAT0 |= GD32_FMC_V2_BANK0_WRITE_ERR; LOG_ERR("FMC bank0 programming failed"); } expired_out: FMC_CTL0 &= ~FMC_CTL0_PG; gd32_fmc_v2_bank0_lock(); return ret; } static int gd32_fmc_v2_bank0_page_erase(uint32_t page_addr) { int ret = 0; gd32_fmc_v2_bank0_unlock(); if (FMC_STAT0 & FMC_STAT0_BUSY) { return -EBUSY; } FMC_CTL0 |= FMC_CTL0_PER; FMC_ADDR0 = page_addr; FMC_CTL0 |= FMC_CTL0_START; ret = gd32_fmc_v2_bank0_wait_idle(); if (ret < 0) { goto expired_out; } if (FMC_STAT0 & GD32_FMC_V2_BANK0_ERASE_ERR) { ret = -EIO; FMC_STAT0 |= GD32_FMC_V2_BANK0_ERASE_ERR; LOG_ERR("FMC bank0 page %u erase failed", page_addr); } expired_out: FMC_CTL0 &= ~FMC_CTL0_PER; gd32_fmc_v2_bank0_lock(); return ret; } static int gd32_fmc_v2_bank0_erase_block(off_t offset, size_t size) { uint32_t page_addr = SOC_NV_FLASH_ADDR + offset; int ret = 0; while (size > 0U) { ret = gd32_fmc_v2_bank0_page_erase(page_addr); if (ret < 0) { return ret; } size -= GD32_NV_FLASH_V2_BANK0_PAGE_SIZE; page_addr += GD32_NV_FLASH_V2_BANK0_PAGE_SIZE; } return 0; } #ifdef GD32_NV_FLASH_V2_BANK1_SIZE static inline void gd32_fmc_v2_bank1_unlock(void) { FMC_KEY1 = UNLOCK_KEY0; FMC_KEY1 = UNLOCK_KEY1; } static inline void gd32_fmc_v2_bank1_lock(void) { FMC_CTL1 |= FMC_CTL1_LK; } static int gd32_fmc_v2_bank1_wait_idle(void) { const int64_t expired_time = k_uptime_get() + GD32_NV_FLASH_V2_TIMEOUT; while (FMC_STAT1 & FMC_STAT1_BUSY) { if (k_uptime_get() > expired_time) { return -ETIMEDOUT; } } return 0; } static int gd32_fmc_v2_bank1_write(off_t offset, const void *data, size_t len) { flash_prg_t *prg_flash = (flash_prg_t *)((uint8_t *)SOC_NV_FLASH_ADDR + offset); flash_prg_t *prg_data = (flash_prg_t *)data; int ret = 0; gd32_fmc_v2_bank1_unlock(); if (FMC_STAT1 & FMC_STAT1_BUSY) { return -EBUSY; } FMC_CTL1 |= FMC_CTL1_PG; for (size_t i = 0U; i < (len / sizeof(flash_prg_t)); i++) { *prg_flash++ = *prg_data++; } ret = gd32_fmc_v2_bank1_wait_idle(); if (ret < 0) { goto expired_out; } if (FMC_STAT1 & GD32_FMC_V2_BANK1_WRITE_ERR) { ret = -EIO; FMC_STAT1 |= GD32_FMC_V2_BANK1_WRITE_ERR; LOG_ERR("FMC bank1 programming failed"); } expired_out: FMC_CTL1 &= ~FMC_CTL1_PG; gd32_fmc_v2_bank1_lock(); return ret; } static int gd32_fmc_v2_bank1_page_erase(uint32_t page_addr) { int ret = 0; gd32_fmc_v2_bank1_unlock(); if (FMC_STAT1 & FMC_STAT1_BUSY) { return -EBUSY; } FMC_CTL1 |= FMC_CTL1_PER; FMC_ADDR1 = page_addr; FMC_CTL1 |= FMC_CTL1_START; ret = gd32_fmc_v2_bank1_wait_idle(); if (ret < 0) { goto expired_out; } if (FMC_STAT1 & GD32_FMC_V2_BANK1_ERASE_ERR) { ret = -EIO; FMC_STAT1 |= GD32_FMC_V2_BANK1_ERASE_ERR; LOG_ERR("FMC bank1 page %u erase failed", page_addr); } expired_out: FMC_CTL1 &= ~FMC_CTL1_PER; gd32_fmc_v2_bank1_lock(); return ret; } static int gd32_fmc_v2_bank1_erase_block(off_t offset, size_t size) { uint32_t page_addr = SOC_NV_FLASH_ADDR + offset; int ret = 0; while (size > 0U) { ret = gd32_fmc_v2_bank1_page_erase(page_addr); if (ret < 0) { return ret; } size -= GD32_NV_FLASH_V2_BANK0_SIZE; page_addr += GD32_NV_FLASH_V2_BANK0_SIZE; } return 0; } #endif /* GD32_NV_FLASH_V2_BANK1_SIZE */ bool flash_gd32_valid_range(off_t offset, uint32_t len, bool write) { if ((offset > SOC_NV_FLASH_SIZE) || ((offset + len) > SOC_NV_FLASH_SIZE)) { return false; } if (write) { /* Check offset and len is flash_prg_t aligned. */ if ((offset % sizeof(flash_prg_t)) || (len % sizeof(flash_prg_t))) { return false; } } else { if (offset < GD32_NV_FLASH_V2_BANK0_SIZE) { if (offset % GD32_NV_FLASH_V2_BANK0_PAGE_SIZE) { return false; } if (((offset + len) <= GD32_NV_FLASH_V2_BANK0_SIZE) && (len % GD32_NV_FLASH_V2_BANK0_PAGE_SIZE)) { return false; } } #ifdef GD32_NV_FLASH_V2_BANK1_SIZE /* Remove bank0 info from offset and len. */ if ((offset < GD32_NV_FLASH_V2_BANK0_SIZE) && ((offset + len) > GD32_NV_FLASH_V2_BANK0_SIZE)) { len -= (GD32_NV_FLASH_V2_BANK0_SIZE - offset); offset = GD32_NV_FLASH_V2_BANK0_SIZE; } if (offset >= GD32_NV_FLASH_V2_BANK0_SIZE) { if ((offset % GD32_NV_FLASH_V2_BANK1_PAGE_SIZE) || (len % GD32_NV_FLASH_V2_BANK1_PAGE_SIZE)) { return false; } } #endif } return true; } int flash_gd32_write_range(off_t offset, const void *data, size_t len) { size_t len0 = 0U; int ret = 0; if (offset < GD32_NV_FLASH_V2_BANK0_SIZE) { if ((offset + len) > GD32_NV_FLASH_V2_BANK0_SIZE) { len0 = GD32_NV_FLASH_V2_BANK0_SIZE - offset; } else { len0 = len; } ret = gd32_fmc_v2_bank0_write(offset, data, len0); if (ret < 0) { return ret; } } #ifdef GD32_NV_FLASH_V2_BANK1_SIZE size_t len1 = len - len0; if (len1 == 0U) { return 0; } /* Will programming bank1, remove bank0 offset. */ if (offset < GD32_NV_FLASH_V2_BANK0_SIZE) { offset = GD32_NV_FLASH_V2_BANK0_SIZE; } ret = gd32_fmc_v2_bank1_write(offset, data, len1); if (ret < 0) { return ret; } #endif return 0; } int flash_gd32_erase_block(off_t offset, size_t size) { size_t size0 = 0U; int ret = 0; if (offset < GD32_NV_FLASH_V2_BANK0_SIZE) { if ((offset + size0) > GD32_NV_FLASH_V2_BANK0_SIZE) { size0 = GD32_NV_FLASH_V2_BANK0_SIZE - offset; } else { size0 = size; } ret = gd32_fmc_v2_bank0_erase_block(offset, size0); if (ret < 0) { return ret; } } #ifdef GD32_NV_FLASH_V2_BANK1_SIZE size_t size1 = size - size0; if (size1 == 0U) { return 0; } /* Will programming bank1, remove bank0 info from offset. */ if (offset < GD32_NV_FLASH_V2_BANK0_SIZE) { offset = GD32_NV_FLASH_V2_BANK0_SIZE; } ret = gd32_fmc_v2_bank1_erase_block(offset, size1); if (ret < 0) { return ret; } #endif return 0; } #ifdef CONFIG_FLASH_PAGE_LAYOUT void flash_gd32_pages_layout(const struct device *dev, const struct flash_pages_layout **layout, size_t *layout_size) { ARG_UNUSED(dev); *layout = gd32_fmc_v2_layout; *layout_size = ARRAY_SIZE(gd32_fmc_v2_layout); } #endif /* CONFIG_FLASH_PAGE_LAYOUT */