drv_flash_f1.c 8.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320
  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. #include <rtdevice.h> /* 页间喂狗用 rt_device_find/rt_device_control */
  14. #ifdef BSP_USING_ON_CHIP_FLASH
  15. //#include "drv_config.h"
  16. #include "drv_flash.h"
  17. #if defined(PKG_USING_FAL)
  18. #include "fal.h"
  19. #endif
  20. //#define DRV_DEBUG
  21. #define LOG_TAG "drv.flash"
  22. #include <drv_log.h>
  23. /**
  24. * @brief Gets the page of a given address
  25. * @param Addr: Address of the FLASH Memory
  26. * @retval The page of a given address
  27. */
  28. static uint32_t GetPage(uint32_t addr)
  29. {
  30. uint32_t page = 0;
  31. page = RT_ALIGN_DOWN(addr, FLASH_PAGE_SIZE);
  32. return page;
  33. }
  34. /**
  35. * Read data from flash.
  36. * @note This operation's units is word.
  37. *
  38. * @param addr flash address
  39. * @param buf buffer to store read data
  40. * @param size read bytes size
  41. *
  42. * @return result
  43. */
  44. int stm32_flash_read(rt_uint32_t addr, rt_uint8_t *buf, size_t size)
  45. {
  46. size_t i;
  47. if ((addr + size) > STM32_FLASH_END_ADDRESS)
  48. {
  49. LOG_E("read outrange flash size! addr is (0x%p)", (void *)(addr + size));
  50. return -RT_EINVAL;
  51. }
  52. for (i = 0; i < size; i++, buf++, addr++)
  53. {
  54. *buf = *(rt_uint8_t *) addr;
  55. }
  56. return size;
  57. }
  58. /**
  59. * Write data to flash.
  60. * @note This operation's units is word.
  61. * @note This operation must after erase. @see flash_erase.
  62. *
  63. * @param addr flash address
  64. * @param buf the write data buffer
  65. * @param size write bytes size
  66. *
  67. * @return result
  68. */
  69. int stm32_flash_write(rt_uint32_t addr, const rt_uint8_t *buf, size_t size)
  70. {
  71. rt_err_t result = RT_EOK;
  72. rt_uint32_t end_addr = addr + size;
  73. rt_base_t level;
  74. if (addr % 4 != 0)
  75. {
  76. LOG_E("write addr must be 4-byte alignment");
  77. return -RT_EINVAL;
  78. }
  79. if ((end_addr) > STM32_FLASH_END_ADDRESS)
  80. {
  81. LOG_E("write outrange flash size! addr is (0x%p)", (void *)(addr + size));
  82. return -RT_EINVAL;
  83. }
  84. /* APM32 片内 Flash 编程期间需关闭中断。
  85. * 使用 rt_hw_interrupt_disable/rt_hw_interrupt_enable 保存并恢复中断状态,
  86. * 避免嵌套临界区被 __enable_irq() 提前打开。 */
  87. level = rt_hw_interrupt_disable();
  88. HAL_FLASH_Unlock();
  89. while (addr < end_addr)
  90. {
  91. rt_uint32_t word;
  92. size_t remain = (size_t)(end_addr - addr);
  93. if (remain >= 4)
  94. {
  95. rt_memcpy(&word, buf, 4);
  96. }
  97. else
  98. {
  99. /* 尾部不足一个字的:高位用 0xFF 补齐(NOR 编程只会清位,
  100. * 不会破坏已擦除区域),同时避免越界读取 buf */
  101. word = 0xFFFFFFFFu;
  102. rt_memcpy(&word, buf, remain);
  103. }
  104. if (HAL_FLASH_Program(FLASH_TYPEPROGRAM_WORD, addr, word) == HAL_OK)
  105. {
  106. if (*(rt_uint32_t *)addr != word)
  107. {
  108. result = -RT_ERROR;
  109. break;
  110. }
  111. addr += 4;
  112. buf += 4;
  113. }
  114. else
  115. {
  116. result = -RT_ERROR;
  117. break;
  118. }
  119. }
  120. HAL_FLASH_Lock();
  121. rt_hw_interrupt_enable(level);
  122. if (result != RT_EOK)
  123. {
  124. return result;
  125. }
  126. return size;
  127. }
  128. /**
  129. * Erase data on flash with bank.
  130. * @note This operation is irreversible.
  131. * @note This operation's units is different which on many chips.
  132. *
  133. * @param bank flash bank
  134. * @param addr flash address
  135. * @param size erase bytes size
  136. *
  137. * @return result
  138. */
  139. int stm32_flash_erase_bank(uint32_t bank, rt_uint32_t addr, size_t size)
  140. {
  141. rt_err_t result = RT_EOK;
  142. uint32_t PAGEError = 0;
  143. uint32_t nb_pages, i, page;
  144. rt_base_t level;
  145. /*Variable used for Erase procedure*/
  146. FLASH_EraseInitTypeDef EraseInitStruct;
  147. if ((addr + size) > STM32_FLASH_END_ADDRESS)
  148. {
  149. LOG_E("ERROR: erase outrange flash size! addr is (0x%p)\n", (void *)(addr + size));
  150. return -RT_EINVAL;
  151. }
  152. /* 逐页擦除:每页一个"关中断 → 解锁 → 擦 → 上锁 → 开中断"的临界区
  153. * (与写路径一致:片内 Flash 编程/擦除期间需关闭中断)。整段一次关中断
  154. * 会长时间饿死 SysTick 与喂狗线程,故按页拆分;页间主动喂狗,避免
  155. * OTA/恢复固件等大区域擦除期间看门狗超时。 */
  156. nb_pages = (size + FLASH_PAGE_SIZE - 1) / FLASH_PAGE_SIZE;
  157. page = GetPage(addr);
  158. EraseInitStruct.TypeErase = FLASH_TYPEERASE_PAGES;
  159. EraseInitStruct.Banks = bank;
  160. EraseInitStruct.NbPages = 1;
  161. for (i = 0; i < nb_pages; i++)
  162. {
  163. level = rt_hw_interrupt_disable();
  164. HAL_FLASH_Unlock();
  165. EraseInitStruct.PageAddress = page;
  166. if (HAL_FLASHEx_Erase(&EraseInitStruct, &PAGEError) != HAL_OK)
  167. {
  168. result = -RT_ERROR;
  169. }
  170. HAL_FLASH_Lock();
  171. rt_hw_interrupt_enable(level);
  172. if (result != RT_EOK)
  173. {
  174. break;
  175. }
  176. page += FLASH_PAGE_SIZE;
  177. /* 页间喂狗(设备未就绪时 find 返回 NULL,跳过) */
  178. {
  179. rt_device_t wdt = rt_device_find("wdt");
  180. if (wdt != RT_NULL)
  181. {
  182. rt_device_control(wdt, RT_DEVICE_CTRL_WDT_KEEPALIVE, RT_NULL);
  183. }
  184. }
  185. }
  186. if (result != RT_EOK)
  187. {
  188. return result;
  189. }
  190. LOG_D("erase done: addr (0x%p), size %d", (void *)addr, size);
  191. return size;
  192. }
  193. /**
  194. * Erase data on flash .
  195. * @note This operation is irreversible.
  196. * @note This operation's units is different which on many chips.
  197. *
  198. * @param addr flash address
  199. * @param size erase bytes size
  200. *
  201. * @return result
  202. */
  203. int stm32_flash_erase(rt_uint32_t addr, size_t size)
  204. {
  205. #if defined(FLASH_BANK2_END)
  206. rt_err_t result = RT_EOK;
  207. rt_uint32_t addr_bank1 = 0;
  208. rt_uint32_t size_bank1 = 0;
  209. rt_uint32_t addr_bank2 = 0;
  210. rt_uint32_t size_bank2 = 0;
  211. if((addr + size) <= FLASH_BANK1_END)
  212. {
  213. addr_bank1 = addr;
  214. size_bank1 = size;
  215. size_bank2 = 0;
  216. }
  217. else if(addr > FLASH_BANK1_END)
  218. {
  219. size_bank1 = 0;
  220. addr_bank2 = addr;
  221. size_bank2 = size;
  222. }
  223. else
  224. {
  225. addr_bank1 = addr;
  226. size_bank1 = FLASH_BANK1_END + 1 - addr_bank1;
  227. addr_bank2 = FLASH_BANK1_END + 1;
  228. size_bank2 = addr + size - (FLASH_BANK1_END + 1);
  229. }
  230. if(size_bank1)
  231. {
  232. LOG_D("bank1: addr (0x%p), size %d", (void *)addr_bank1, size_bank1);
  233. if(size_bank1 != stm32_flash_erase_bank(FLASH_BANK_1, addr_bank1, size_bank1))
  234. {
  235. result = -RT_ERROR;
  236. goto __exit;
  237. }
  238. }
  239. if(size_bank2)
  240. {
  241. LOG_D("bank2: addr (0x%p), size %d", (void *)addr_bank2, size_bank2);
  242. if(size_bank2 != stm32_flash_erase_bank(FLASH_BANK_2, addr_bank2, size_bank2))
  243. {
  244. result = -RT_ERROR;
  245. goto __exit;
  246. }
  247. }
  248. __exit:
  249. if(result != RT_EOK)
  250. {
  251. return result;
  252. }
  253. return size_bank1 + size_bank2;
  254. #else
  255. return stm32_flash_erase_bank(FLASH_BANK_1, addr, size);
  256. #endif
  257. }
  258. #if defined(PKG_USING_FAL)
  259. static int fal_flash_read(long offset, rt_uint8_t *buf, size_t size);
  260. static int fal_flash_write(long offset, const rt_uint8_t *buf, size_t size);
  261. static int fal_flash_erase(long offset, size_t size);
  262. /* 注意:本设备未被注册进 FAL 分区表(fal_cfg.h 使用的是 fal_flash_stm32f1_port.c
  263. * 的 stm32f1_onchip_flash,基址 0x08000000 才能与 bl/app 分区表对齐)。
  264. * 此处基址 0x8020000 仅为 APP 视角,如未来启用需同步调整分区表。 */
  265. 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} };
  266. static int fal_flash_read(long offset, rt_uint8_t *buf, size_t size)
  267. {
  268. return stm32_flash_read(stm32_onchip_flash.addr + offset, buf, size);
  269. }
  270. static int fal_flash_write(long offset, const rt_uint8_t *buf, size_t size)
  271. {
  272. return stm32_flash_write(stm32_onchip_flash.addr + offset, buf, size);
  273. }
  274. static int fal_flash_erase(long offset, size_t size)
  275. {
  276. return stm32_flash_erase(stm32_onchip_flash.addr + offset, size);
  277. }
  278. #endif
  279. #endif /* BSP_USING_ON_CHIP_FLASH */