diff --git a/bsp/stm32/docs/STM32系列BSP制作教程.md b/bsp/stm32/docs/STM32系列BSP制作教程.md
index 117a8804e9..828009bd67 100644
--- a/bsp/stm32/docs/STM32系列BSP制作教程.md
+++ b/bsp/stm32/docs/STM32系列BSP制作教程.md
@@ -117,6 +117,10 @@ BSP 的制作过程分为如下五个步骤：
 
 ![生成对应的配置代码](./figures/CubeMX_4.png)
 
+注意：在生成代码时，不要勾选以下选项（即：不让其生成单独的 .c/.h 驱动文件，直接全部更新到 rt-thread 要使用的 stm32xxx_hal_msp.c 文件中）
+
+![generate-code](figures/generate-code.png)
+
 最终 CubeMX 生成的工程目录结构如下图所示：
 
 ![CubeMX 图7](./figures/CubeMX_5.png)
diff --git a/bsp/stm32/docs/STM32系列外设驱动添加指南.md b/bsp/stm32/docs/STM32系列外设驱动添加指南.md
index 48369f1d59..d96d81f230 100644
--- a/bsp/stm32/docs/STM32系列外设驱动添加指南.md
+++ b/bsp/stm32/docs/STM32系列外设驱动添加指南.md
@@ -69,6 +69,9 @@
 - 部分驱动如果没有适配 BSP 所属的 STM32 系列，请等待 RT-Thread 团队更新。
   - 驱动文件对 STM32 系列的支持情况可以查看 [STM32系列驱动介绍文档](STM32系列驱动介绍文档.md)。
 - 对于驱动文件或文档说明，有任何建议或者意见，欢迎反馈到 [RT_Thread GitHub](https://github.com/RT-Thread/rt-thread) 网站或 [RT-Thread 官方论坛](https://www.rt-thread.org/qa/forum.php)。
+- 在生成代码时，不要勾选以下选项（即：不让其生成单独的 .c/.h 驱动文件，直接全部更新到 rt-thread 要使用的 stm32xxx_hal_msp.c 文件中）
+
+![generate-code](figures/generate-code.png)
 
 ## 5. 附录
 
diff --git a/bsp/stm32/docs/figures/generate-code.png b/bsp/stm32/docs/figures/generate-code.png
new file mode 100644
index 0000000000..5dc59c3100
Binary files /dev/null and b/bsp/stm32/docs/figures/generate-code.png differ