drv_flash_f1.c 7.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296
  1. /*
  2. * Copyright (c) 2006-2018, RT-Thread Development Team
  3. *
  4. * SPDX-License-Identifier: Apache-2.0
  5. *
  6. * Change Logs:
  7. * Date Author Notes
  8. * 2018-12-5 SummerGift first version
  9. * 2020-03-05 redoc support stm32f103vg
  10. *
  11. */
  12. #include "board.h"
  13. #ifdef BSP_USING_ON_CHIP_FLASH
  14. #include "drv_config.h"
  15. #include "drv_flash.h"
  16. #if defined(PKG_USING_FAL)
  17. #include "fal.h"
  18. #endif
  19. //#define DRV_DEBUG
  20. #define LOG_TAG "drv.flash"
  21. #include <drv_log.h>
  22. /**
  23. * @brief Gets the page of a given address
  24. * @param Addr: Address of the FLASH Memory
  25. * @retval The page of a given address
  26. */
  27. static uint32_t GetPage(uint32_t addr)
  28. {
  29. uint32_t page = 0;
  30. page = RT_ALIGN_DOWN(addr, FLASH_PAGE_SIZE);
  31. return page;
  32. }
  33. /**
  34. * Read data from flash.
  35. * @note This operation's units is word.
  36. *
  37. * @param addr flash address
  38. * @param buf buffer to store read data
  39. * @param size read bytes size
  40. *
  41. * @return result
  42. */
  43. int stm32_flash_read(rt_uint32_t addr, rt_uint8_t *buf, size_t size)
  44. {
  45. size_t i;
  46. if ((addr + size) > STM32_FLASH_END_ADDRESS)
  47. {
  48. LOG_E("read outrange flash size! addr is (0x%p)", (void *)(addr + size));
  49. return -RT_EINVAL;
  50. }
  51. for (i = 0; i < size; i++, buf++, addr++)
  52. {
  53. *buf = *(rt_uint8_t *) addr;
  54. }
  55. return size;
  56. }
  57. /**
  58. * Write data to flash.
  59. * @note This operation's units is word.
  60. * @note This operation must after erase. @see flash_erase.
  61. *
  62. * @param addr flash address
  63. * @param buf the write data buffer
  64. * @param size write bytes size
  65. *
  66. * @return result
  67. */
  68. int stm32_flash_write(rt_uint32_t addr, const rt_uint8_t *buf, size_t size)
  69. {
  70. rt_err_t result = RT_EOK;
  71. rt_uint32_t end_addr = addr + size;
  72. rt_base_t level; /* 2026-09-28: 擦写期间关中断用 */
  73. if (addr % 4 != 0)
  74. {
  75. LOG_E("write addr must be 4-byte alignment");
  76. return -RT_EINVAL;
  77. }
  78. if ((end_addr) > STM32_FLASH_END_ADDRESS)
  79. {
  80. LOG_E("write outrange flash size! addr is (0x%p)", (void *)(addr + size));
  81. return -RT_EINVAL;
  82. }
  83. /* 2026-09-28: 原实现只校验地址对齐, 未校验长度。size 非 4 倍数时, 最后一次按字编程
  84. * 会越界读 buf 之后的 1~3 字节, 并把野字节写到 end_addr 之外(污染相邻数据)。
  85. * FlashDB 的 blob 长度由调用方决定, 极易出现非 4 倍数, 这里直接在入口拒绝。 */
  86. if (size % 4 != 0)
  87. {
  88. LOG_E("write size must be 4-byte alignment (size=%d)", size);
  89. return -RT_EINVAL;
  90. }
  91. /* 2026-09-28: APM32/STM32 片内 flash 擦写期间必须关中断(readme 2021-04-08 已记录该要求,
  92. * 但代码里一直没落地)。擦写一页约 20~40ms, 期间若响应中断(串口 DMA ISR / 调度),
  93. * 取指与编程会冲突, 且显著拉长中断延迟(正是串口环形缓冲索引错算的诱因)。 */
  94. level = rt_hw_interrupt_disable();
  95. HAL_FLASH_Unlock();
  96. while (addr < end_addr)
  97. {
  98. if (HAL_FLASH_Program(FLASH_TYPEPROGRAM_WORD, addr, *((rt_uint32_t *)buf)) == HAL_OK)
  99. {
  100. if (*(rt_uint32_t *)addr != *(rt_uint32_t *)buf)
  101. {
  102. result = -RT_ERROR;
  103. break;
  104. }
  105. addr += 4;
  106. buf += 4;
  107. }
  108. else
  109. {
  110. result = -RT_ERROR;
  111. break;
  112. }
  113. }
  114. HAL_FLASH_Lock();
  115. rt_hw_interrupt_enable(level);
  116. if (result != RT_EOK)
  117. {
  118. return result;
  119. }
  120. return size;
  121. }
  122. /**
  123. * Erase data on flash with bank.
  124. * @note This operation is irreversible.
  125. * @note This operation's units is different which on many chips.
  126. *
  127. * @param bank flash bank
  128. * @param addr flash address
  129. * @param size erase bytes size
  130. *
  131. * @return result
  132. */
  133. int stm32_flash_erase_bank(uint32_t bank, rt_uint32_t addr, size_t size)
  134. {
  135. rt_err_t result = RT_EOK;
  136. uint32_t PAGEError = 0;
  137. rt_base_t level; /* 2026-09-28: 擦写期间关中断用 */
  138. /*Variable used for Erase procedure*/
  139. FLASH_EraseInitTypeDef EraseInitStruct;
  140. if ((addr + size) > STM32_FLASH_END_ADDRESS)
  141. {
  142. LOG_E("ERROR: erase outrange flash size! addr is (0x%p)\n", (void *)(addr + size));
  143. return -RT_EINVAL;
  144. }
  145. /* Fill EraseInit structure*/
  146. EraseInitStruct.TypeErase = FLASH_TYPEERASE_PAGES;
  147. EraseInitStruct.PageAddress = GetPage(addr);
  148. /* 2026-09-28: 页数必须计入 addr 在页内的偏移 —— 原写法只按 size 计算,
  149. * 一旦 addr 不是页对齐, 末尾区域就擦不到, 后续 program 校验必然失败(返回 -RT_ERROR) */
  150. {
  151. rt_uint32_t off_in_page = addr - GetPage(addr);
  152. EraseInitStruct.NbPages = (off_in_page + size + FLASH_PAGE_SIZE - 1) / FLASH_PAGE_SIZE;
  153. }
  154. EraseInitStruct.Banks = bank;
  155. level = rt_hw_interrupt_disable(); /* 擦写一页约 20~40ms, 期间必须屏蔽中断(理由同 stm32_flash_write) */
  156. HAL_FLASH_Unlock();
  157. if (HAL_FLASHEx_Erase(&EraseInitStruct, &PAGEError) != HAL_OK)
  158. {
  159. result = -RT_ERROR;
  160. goto __exit;
  161. }
  162. __exit:
  163. HAL_FLASH_Lock();
  164. rt_hw_interrupt_enable(level);
  165. if (result != RT_EOK)
  166. {
  167. return result;
  168. }
  169. LOG_D("erase done: addr (0x%p), size %d", (void *)addr, size);
  170. return size;
  171. }
  172. /**
  173. * Erase data on flash .
  174. * @note This operation is irreversible.
  175. * @note This operation's units is different which on many chips.
  176. *
  177. * @param addr flash address
  178. * @param size erase bytes size
  179. *
  180. * @return result
  181. */
  182. int stm32_flash_erase(rt_uint32_t addr, size_t size)
  183. {
  184. #if defined(FLASH_BANK2_END)
  185. rt_err_t result = RT_EOK;
  186. rt_uint32_t addr_bank1 = 0;
  187. rt_uint32_t size_bank1 = 0;
  188. rt_uint32_t addr_bank2 = 0;
  189. rt_uint32_t size_bank2 = 0;
  190. if((addr + size) <= FLASH_BANK1_END)
  191. {
  192. addr_bank1 = addr;
  193. size_bank1 = size;
  194. size_bank2 = 0;
  195. }
  196. else if(addr > FLASH_BANK1_END)
  197. {
  198. size_bank1 = 0;
  199. addr_bank2 = addr;
  200. size_bank2 = size;
  201. }
  202. else
  203. {
  204. addr_bank1 = addr;
  205. size_bank1 = FLASH_BANK1_END + 1 - addr_bank1;
  206. addr_bank2 = FLASH_BANK1_END + 1;
  207. size_bank2 = addr + size - (FLASH_BANK1_END + 1);
  208. }
  209. if(size_bank1)
  210. {
  211. LOG_D("bank1: addr (0x%p), size %d", (void *)addr_bank1, size_bank1);
  212. if(size_bank1 != stm32_flash_erase_bank(FLASH_BANK_1, addr_bank1, size_bank1))
  213. {
  214. result = -RT_ERROR;
  215. goto __exit;
  216. }
  217. }
  218. if(size_bank2)
  219. {
  220. LOG_D("bank2: addr (0x%p), size %d", (void *)addr_bank2, size_bank2);
  221. if(size_bank2 != stm32_flash_erase_bank(FLASH_BANK_2, addr_bank2, size_bank2))
  222. {
  223. result = -RT_ERROR;
  224. goto __exit;
  225. }
  226. }
  227. __exit:
  228. if(result != RT_EOK)
  229. {
  230. return result;
  231. }
  232. return size_bank1 + size_bank2;
  233. #else
  234. return stm32_flash_erase_bank(FLASH_BANK_1, addr, size);
  235. #endif
  236. }
  237. #if defined(PKG_USING_FAL)
  238. static int fal_flash_read(long offset, rt_uint8_t *buf, size_t size);
  239. static int fal_flash_write(long offset, const rt_uint8_t *buf, size_t size);
  240. static int fal_flash_erase(long offset, size_t size);
  241. const struct fal_flash_dev stm32_onchip_flash = { "onchip_flash", STM32_FLASH_START_ADRESS, STM32_FLASH_SIZE, FLASH_PAGE_SIZE, {NULL, fal_flash_read, fal_flash_write, fal_flash_erase} };
  242. static int fal_flash_read(long offset, rt_uint8_t *buf, size_t size)
  243. {
  244. return stm32_flash_read(stm32_onchip_flash.addr + offset, buf, size);
  245. }
  246. static int fal_flash_write(long offset, const rt_uint8_t *buf, size_t size)
  247. {
  248. return stm32_flash_write(stm32_onchip_flash.addr + offset, buf, size);
  249. }
  250. static int fal_flash_erase(long offset, size_t size)
  251. {
  252. return stm32_flash_erase(stm32_onchip_flash.addr + offset, size);
  253. }
  254. #endif
  255. #endif /* BSP_USING_ON_CHIP_FLASH */