dsh-stm32 0.1.3 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (221) hide show
  1. package/README.md +52 -38
  2. package/README_EN.md +44 -33
  3. package/assets/README.md +85 -0
  4. package/assets/VERSION +1 -0
  5. package/assets/device/c0/chips.json +1108 -0
  6. package/assets/device/f0/chips.json +1570 -0
  7. package/assets/device/f1/chips.json +1238 -0
  8. package/assets/device/f1/svd/100.json +943 -0
  9. package/assets/device/f1/svd/101.json +901 -0
  10. package/assets/device/f1/svd/102.json +522 -0
  11. package/assets/device/f1/svd/103.json +1139 -0
  12. package/assets/device/f1/svd/105.json +1117 -0
  13. package/assets/device/f1/svd/107.json +1195 -0
  14. package/assets/device/f2/chips.json +674 -0
  15. package/assets/device/f3/chips.json +1318 -0
  16. package/assets/device/f4/chips.json +2942 -0
  17. package/assets/device/f7/chips.json +1710 -0
  18. package/assets/device/g0/chips.json +2102 -0
  19. package/assets/device/g4/chips.json +2494 -0
  20. package/assets/device/h5/chips.json +898 -0
  21. package/assets/device/h7/chips.json +1948 -0
  22. package/assets/device/l0/chips.json +2494 -0
  23. package/assets/device/l1/chips.json +1234 -0
  24. package/assets/device/l4/chips.json +2130 -0
  25. package/assets/device/l4+/chips.json +856 -0
  26. package/assets/device/l5/chips.json +226 -0
  27. package/assets/device/u0/chips.json +688 -0
  28. package/assets/device/u3/chips.json +310 -0
  29. package/assets/device/u5/chips.json +884 -0
  30. package/assets/device/wba/chips.json +506 -0
  31. package/assets/device/wl/chips.json +184 -0
  32. package/assets/headers/f1/stm32f100xb.h +5972 -0
  33. package/assets/headers/f1/stm32f100xe.h +6587 -0
  34. package/assets/headers/f1/stm32f101x6.h +5315 -0
  35. package/assets/headers/f1/stm32f101xb.h +5446 -0
  36. package/assets/headers/f1/stm32f101xe.h +6503 -0
  37. package/assets/headers/f1/stm32f101xg.h +6713 -0
  38. package/assets/headers/f1/stm32f102x6.h +6448 -0
  39. package/assets/headers/f1/stm32f102xb.h +6570 -0
  40. package/assets/headers/f1/stm32f103x6.h +10109 -0
  41. package/assets/headers/f1/stm32f103xb.h +10240 -0
  42. package/assets/headers/f1/stm32f103xe.h +11767 -0
  43. package/assets/headers/f1/stm32f103xg.h +11951 -0
  44. package/assets/headers/f1/stm32f105xc.h +14340 -0
  45. package/assets/headers/f1/stm32f107xc.h +15253 -0
  46. package/assets/headers/f1/stm32f1xx.h +273 -0
  47. package/assets/headers/f1/system_stm32f1xx.h +96 -0
  48. package/assets/ioc/family/C0.ioc +82 -0
  49. package/assets/ioc/family/F0.ioc +71 -0
  50. package/assets/ioc/family/F2.ioc +91 -0
  51. package/assets/ioc/family/F3.ioc +94 -0
  52. package/assets/ioc/family/F4.ioc +91 -0
  53. package/assets/ioc/family/F7.ioc +102 -0
  54. package/assets/ioc/family/G0.ioc +90 -0
  55. package/assets/ioc/family/G4.ioc +110 -0
  56. package/assets/ioc/family/H5.ioc +116 -0
  57. package/assets/ioc/family/H7.ioc +133 -0
  58. package/assets/ioc/family/L0.ioc +92 -0
  59. package/assets/ioc/family/L1.ioc +87 -0
  60. package/assets/ioc/family/L4+.ioc +92 -0
  61. package/assets/ioc/family/L4.ioc +93 -0
  62. package/assets/ioc/family/L5.ioc +91 -0
  63. package/assets/ioc/family/U0.ioc +103 -0
  64. package/assets/ioc/family/U3.ioc +113 -0
  65. package/assets/ioc/family/U5.ioc +102 -0
  66. package/assets/ioc/family/WBA.ioc +100 -0
  67. package/assets/ioc/family/WL.ioc +93 -0
  68. package/assets/ioc/minimal/STM32F100C8Tx.ioc +113 -0
  69. package/assets/ioc/minimal/STM32F100RCTx.ioc +113 -0
  70. package/assets/ioc/minimal/STM32F101C4Tx.ioc +113 -0
  71. package/assets/ioc/minimal/STM32F101C8Tx.ioc +113 -0
  72. package/assets/ioc/minimal/STM32F101RCTx.ioc +113 -0
  73. package/assets/ioc/minimal/STM32F101RFTx.ioc +113 -0
  74. package/assets/ioc/minimal/STM32F102C4Tx.ioc +113 -0
  75. package/assets/ioc/minimal/STM32F102C8Tx.ioc +113 -0
  76. package/assets/ioc/minimal/STM32F103C4Tx.ioc +113 -0
  77. package/assets/ioc/minimal/STM32F103C8Tx.ioc +113 -0
  78. package/assets/ioc/minimal/STM32F103RCTx.ioc +113 -0
  79. package/assets/ioc/minimal/STM32F103RFTx.ioc +113 -0
  80. package/assets/ioc/minimal/STM32F105RCTx.ioc +113 -0
  81. package/assets/ioc/minimal/STM32F107RCTx.ioc +113 -0
  82. package/assets/ld/f1/STM32F100C8Tx_FLASH.ld +249 -0
  83. package/assets/ld/f1/STM32F100RCTx_FLASH.ld +249 -0
  84. package/assets/ld/f1/STM32F101C4Tx_FLASH.ld +249 -0
  85. package/assets/ld/f1/STM32F101C8Tx_FLASH.ld +249 -0
  86. package/assets/ld/f1/STM32F101RCTx_FLASH.ld +249 -0
  87. package/assets/ld/f1/STM32F101RFTx_FLASH.ld +249 -0
  88. package/assets/ld/f1/STM32F102C4Tx_FLASH.ld +249 -0
  89. package/assets/ld/f1/STM32F102C8Tx_FLASH.ld +249 -0
  90. package/assets/ld/f1/STM32F103C4Tx_FLASH.ld +249 -0
  91. package/assets/ld/f1/STM32F103C8Tx_FLASH.ld +249 -0
  92. package/assets/ld/f1/STM32F103RCTx_FLASH.ld +249 -0
  93. package/assets/ld/f1/STM32F103RFTx_FLASH.ld +249 -0
  94. package/assets/ld/f1/STM32F105RCTx_FLASH.ld +249 -0
  95. package/assets/ld/f1/STM32F107RCTx_FLASH.ld +249 -0
  96. package/assets/manifest.json +1130 -0
  97. package/assets/startup/f1/startup_stm32f100xb.s +407 -0
  98. package/assets/startup/f1/startup_stm32f100xe.s +449 -0
  99. package/assets/startup/f1/startup_stm32f101x6.s +322 -0
  100. package/assets/startup/f1/startup_stm32f101xb.s +338 -0
  101. package/assets/startup/f1/startup_stm32f101xe.s +423 -0
  102. package/assets/startup/f1/startup_stm32f101xg.s +439 -0
  103. package/assets/startup/f1/startup_stm32f102x6.s +330 -0
  104. package/assets/startup/f1/startup_stm32f102xb.s +346 -0
  105. package/assets/startup/f1/startup_stm32f103x6.s +348 -0
  106. package/assets/startup/f1/startup_stm32f103xb.s +364 -0
  107. package/assets/startup/f1/startup_stm32f103xe.s +470 -0
  108. package/assets/startup/f1/startup_stm32f103xg.s +466 -0
  109. package/assets/startup/f1/startup_stm32f105xc.s +463 -0
  110. package/assets/startup/f1/startup_stm32f107xc.s +472 -0
  111. package/assets/templates/family/C0.ioc +82 -0
  112. package/assets/templates/family/F0.ioc +71 -0
  113. package/assets/templates/family/F2.ioc +91 -0
  114. package/assets/templates/family/F3.ioc +94 -0
  115. package/assets/templates/family/F4.ioc +91 -0
  116. package/assets/templates/family/F7.ioc +102 -0
  117. package/assets/templates/family/G0.ioc +90 -0
  118. package/assets/templates/family/G4.ioc +110 -0
  119. package/assets/templates/family/H5.ioc +116 -0
  120. package/assets/templates/family/H7.ioc +133 -0
  121. package/assets/templates/family/L0.ioc +92 -0
  122. package/assets/templates/family/L1.ioc +87 -0
  123. package/assets/templates/family/L4+.ioc +92 -0
  124. package/assets/templates/family/L4.ioc +93 -0
  125. package/assets/templates/family/L5.ioc +91 -0
  126. package/assets/templates/family/U0.ioc +103 -0
  127. package/assets/templates/family/U3.ioc +113 -0
  128. package/assets/templates/family/U5.ioc +102 -0
  129. package/assets/templates/family/WB.ioc +81 -0
  130. package/assets/templates/family/WBA.ioc +100 -0
  131. package/assets/templates/family/WL.ioc +93 -0
  132. package/docs/reading-guide.md +37 -35
  133. package/lib/data/chips.js +3 -3
  134. package/lib/data/clock-db.js +830 -0
  135. package/lib/data/clock-f1.js +12 -45
  136. package/lib/data/cmsis-sources.js +239 -18
  137. package/lib/data/db-presets.js +252 -0
  138. package/lib/data/device-facts.js +99 -26
  139. package/lib/data/family.js +515 -0
  140. package/lib/data/firmware-packages.js +562 -0
  141. package/lib/data/install-guides.js +2 -2
  142. package/lib/data/ioc-presets.js +248 -0
  143. package/lib/data/ioc-schema.js +1058 -0
  144. package/lib/data/rm-topics/stm32c0.json +227 -0
  145. package/lib/data/rm-topics.js +103 -0
  146. package/lib/data/search-roots.js +42 -1
  147. package/lib/data/stm32f1.js +15 -14
  148. package/lib/data/svd.js +32 -16
  149. package/lib/data/toolchain-config.js +0 -14
  150. package/lib/engine/assets.js +191 -456
  151. package/lib/engine/breakpoints.js +66 -11
  152. package/lib/engine/clock-derived.js +101 -0
  153. package/lib/engine/clock-direct.js +313 -0
  154. package/lib/engine/clock-plan.js +96 -52
  155. package/lib/engine/clock-pllmn.js +319 -0
  156. package/lib/engine/cmake-sources.js +67 -13
  157. package/lib/engine/cube-mx-guard.js +44 -0
  158. package/lib/engine/cube-programmer.js +137 -0
  159. package/lib/engine/cubemx-db.js +273 -0
  160. package/lib/engine/debug-session.js +423 -17
  161. package/lib/engine/debug.js +25 -6
  162. package/lib/engine/doctor.js +160 -17
  163. package/lib/engine/facts-acquire.js +416 -0
  164. package/lib/engine/facts.js +134 -0
  165. package/lib/engine/firmware-install.js +176 -5
  166. package/lib/engine/firmware-official.js +451 -0
  167. package/lib/engine/flash.js +290 -21
  168. package/lib/engine/gdb-mi.js +476 -0
  169. package/lib/engine/generate.js +9 -2
  170. package/lib/engine/hal-chip.js +124 -41
  171. package/lib/engine/ioc-plan.js +1244 -60
  172. package/lib/engine/ioc-rules.js +698 -0
  173. package/lib/engine/ioc-verify.js +706 -0
  174. package/lib/engine/ioc.js +43 -4
  175. package/lib/engine/msys2-install.js +4 -4
  176. package/lib/engine/probe-error.js +25 -6
  177. package/lib/engine/probe-session.js +50 -14
  178. package/lib/engine/probe.js +18 -3
  179. package/lib/engine/register-clock.js +41 -0
  180. package/lib/engine/register-gpio.js +115 -0
  181. package/lib/engine/register-linker.js +12 -7
  182. package/lib/engine/register-template.js +101 -40
  183. package/lib/engine/regs.js +41 -8
  184. package/lib/engine/rm-extract.js +144 -0
  185. package/lib/engine/rm-sources.js +360 -0
  186. package/lib/engine/rm-text.js +56 -0
  187. package/lib/engine/rtt.js +188 -30
  188. package/lib/engine/scaffold.js +185 -18
  189. package/lib/engine/toolchain-gate.js +0 -4
  190. package/lib/engine/watch.js +227 -0
  191. package/lib/index.js +4 -2
  192. package/lib/skill/stm32-workflow.js +2 -2
  193. package/lib/tools/assets.js +39 -108
  194. package/lib/tools/cache.js +2 -2
  195. package/lib/tools/debug-session.js +2 -2
  196. package/lib/tools/doctor.js +55 -5
  197. package/lib/tools/firmware-install.js +31 -6
  198. package/lib/tools/flash.js +32 -4
  199. package/lib/tools/generate.js +22 -0
  200. package/lib/tools/ioc-inspect.js +1 -1
  201. package/lib/tools/ioc-plan.js +56 -2
  202. package/lib/tools/ioc-verify.js +237 -0
  203. package/lib/tools/project-create.js +41 -5
  204. package/lib/tools/regs.js +8 -8
  205. package/lib/tools/route-plan.js +1 -1
  206. package/lib/tools/rtt.js +157 -34
  207. package/lib/tools/watch.js +256 -0
  208. package/package.json +5 -4
  209. package/templates/openocd/stm32c0x.cfg +83 -0
  210. package/templates/openocd/stm32u0x.cfg +64 -0
  211. package/templates/register/CMakeLists.txt +2 -2
  212. package/templates/register/Core/Inc/rtt.h +37 -2
  213. package/templates/register/Core/Src/main.c +17 -25
  214. package/templates/register/Core/Src/rtt.c +85 -9
  215. package/templates/scaffold/RTT.md +6 -2
  216. package/templates/scaffold/STM32F103XX_FLASH.ld +3 -0
  217. package/templates/scaffold/openocd.cfg +5 -3
  218. package/templates/scaffold/vscode/launch.json +8 -4
  219. package/docs/development-notes.md +0 -2487
  220. package/docs/dsh-stm32-plugin-/350/247/204/346/240/274.md +0 -673
  221. package/docs/logic-audit.md +0 -607
@@ -0,0 +1,83 @@
1
+ # SPDX-License-Identifier: GPL-2.0-or-later
2
+ #
3
+ # 来源:openocd 上游 master 的 tcl/target/stm32c0x.cfg(0.13 语法)。
4
+ # 为跑在 openocd 0.12 上,本插件改了三处(0.13 的写法在 0.12 上加载就报错):
5
+ # 1) 删掉 `transport select swd`,改 source target/swj-dp.tcl —— 0.12 的 st-link 驱动
6
+ # 没有名为 swd 的 transport(只有 hla_swd / dapdirect_swd),写死会直接报错;
7
+ # 2) `swd newdap` 改 `swj_newdap`(0.12 没有 0.13 的 swd 子命令);
8
+ # 3) dap create 的 -tap 改 -chain-position(0.12 没有 -tap 参数)。
9
+ # 其余内容(CPUTAPID / work-area /
10
+ # flash bank 用 stm32l4x 驱动 / DBGMCU 与看门狗停机设置)与上游一致。
11
+ # script for stm32c0x family
12
+ #
13
+ # stm32c0 devices support SWD transports only.
14
+ #
15
+ source [find target/swj-dp.tcl]
16
+
17
+ source [find mem_helper.tcl]
18
+
19
+ if { [info exists CHIPNAME] } {
20
+ set _CHIPNAME $CHIPNAME
21
+ } else {
22
+ set _CHIPNAME stm32c0x
23
+ }
24
+
25
+ set _ENDIAN little
26
+
27
+ # Work-area is a space in RAM used for flash programming
28
+ # By default use 6kB
29
+ if { [info exists WORKAREASIZE] } {
30
+ set _WORKAREASIZE $WORKAREASIZE
31
+ } else {
32
+ set _WORKAREASIZE 0x1800
33
+ }
34
+
35
+ #jtag scan chain
36
+ if { [info exists CPUTAPID] } {
37
+ set _CPUTAPID $CPUTAPID
38
+ } else {
39
+ # SWD IDCODE (single drop, arm)
40
+ set _CPUTAPID 0x0bc11477
41
+ }
42
+
43
+ swj_newdap $_CHIPNAME cpu -irlen 4 -ircapture 0x1 -irmask 0xf -expected-id $_CPUTAPID
44
+ dap create $_CHIPNAME.dap -chain-position $_CHIPNAME.cpu
45
+
46
+ set _TARGETNAME $_CHIPNAME.cpu
47
+ target create $_TARGETNAME cortex_m -endian $_ENDIAN -dap $_CHIPNAME.dap
48
+
49
+ $_TARGETNAME configure -work-area-phys 0x20000000 -work-area-size $_WORKAREASIZE -work-area-backup 0
50
+
51
+ flash bank $_CHIPNAME.flash stm32l4x 0x08000000 0 0 0 $_TARGETNAME
52
+ flash bank $_CHIPNAME.otp stm32l4x 0x1fff7000 0 0 0 $_TARGETNAME
53
+
54
+ # reasonable default
55
+ adapter speed 2000
56
+
57
+ adapter srst delay 100
58
+ if {[using_jtag]} {
59
+ jtag_ntrst_delay 100
60
+ }
61
+
62
+ reset_config srst_nogate
63
+
64
+ if {![using_hla]} {
65
+ # if srst is not fitted use SYSRESETREQ to
66
+ # perform a soft reset
67
+ cortex_m reset_config sysresetreq
68
+ }
69
+
70
+ $_TARGETNAME configure -event examine-end {
71
+ # Enable DBGMCU clock
72
+ # RCC_APB1ENR |= DBGMCUEN
73
+ mmw 0x4002103C 0x08000000 0
74
+
75
+ # Enable debug during low power modes (uses more power)
76
+ # DBGMCU_CR |= DBG_STANDBY | DBG_STOP
77
+ mmw 0x40015804 0x00000006 0
78
+
79
+ # Stop watchdog counters during halt
80
+ # DBGMCU_APB1_FZ |= DBG_WDGLS_STOP | DBG_WWDG_STOP
81
+ mmw 0x40015808 0x00001800 0
82
+ }
83
+
@@ -0,0 +1,64 @@
1
+ # SPDX-License-Identifier: GPL-2.0-or-later
2
+ #
3
+ # 来源:openocd 上游 master 的 tcl/target/stm32u0x.cfg(0.13 语法)。
4
+ # 为跑在 openocd 0.12 上,本插件改了三处(0.13 的写法在 0.12 上加载就报错):
5
+ # 1) 删掉 `transport select swd`,改 source target/swj-dp.tcl —— 0.12 的 st-link 驱动
6
+ # 没有名为 swd 的 transport(只有 hla_swd / dapdirect_swd),写死会直接报错;
7
+ # 2) `swd newdap` 改 `swj_newdap`(0.12 没有 0.13 的 swd 子命令);
8
+ # 3) dap create 的 -tap 改 -chain-position(0.12 没有 -tap 参数)。
9
+ # 其余内容(CPUTAPID / work-area /
10
+ # flash bank 用 stm32l4x 驱动 / examine-end 里的低功耗与看门狗设置)与上游一致。
11
+ # Configuration file for STM32U0x series.
12
+ #
13
+ # STM32U0 devices support only SWD transport.
14
+ #
15
+ source [find target/swj-dp.tcl]
16
+
17
+ source [find mem_helper.tcl]
18
+
19
+ if { [info exists CHIPNAME] } {
20
+ set _CHIPNAME $CHIPNAME
21
+ } else {
22
+ set _CHIPNAME stm32u0x
23
+ }
24
+
25
+ # Work-area is a space in RAM used for flash programming, by default use 4 KiB.
26
+ if { [info exists WORKAREASIZE] } {
27
+ set _WORKAREASIZE $WORKAREASIZE
28
+ } else {
29
+ set _WORKAREASIZE 0x1000
30
+ }
31
+
32
+ if { [info exists CPUTAPID] } {
33
+ set _CPUTAPID $CPUTAPID
34
+ } else {
35
+ set _CPUTAPID 0x6ba02477
36
+ }
37
+
38
+ swj_newdap $_CHIPNAME cpu -irlen 4 -ircapture 0x1 -irmask 0xf -expected-id $_CPUTAPID
39
+ dap create $_CHIPNAME.dap -chain-position $_CHIPNAME.cpu
40
+
41
+ set _TARGETNAME $_CHIPNAME.cpu
42
+ target create $_TARGETNAME cortex_m -endian little -dap $_CHIPNAME.dap
43
+
44
+ $_TARGETNAME configure -work-area-phys 0x20000000 -work-area-size $_WORKAREASIZE -work-area-backup 0
45
+
46
+ flash bank $_CHIPNAME.flash stm32l4x 0x08000000 0 0 0 $_TARGETNAME
47
+ flash bank $_CHIPNAME.otp stm32l4x 0x1FFF6800 0 0 0 $_TARGETNAME
48
+
49
+ adapter speed 2000
50
+
51
+ if {![using_hla]} {
52
+ # Use SYSRESETREQ to perform a soft reset if SRST is not fitted.
53
+ cortex_m reset_config sysresetreq
54
+ }
55
+
56
+ $_TARGETNAME configure -event examine-end {
57
+ # Enable debug during low power modes (uses more power).
58
+ # DBGMCU_CR |= DBG_STANDBY | DBG_STOP
59
+ mmw 0x40015804 0x00000006 0
60
+
61
+ # Stop watchdog counters when core is halted.
62
+ # DBGMCU_APB1_FZR |= DBG_IWDG_STOP | DBG_WWDG_STOP
63
+ mmw 0x40015808 0x00001800 0
64
+ }
@@ -32,7 +32,7 @@ message("Linker script: " ${DSH_LINKER_SCRIPT})
32
32
  enable_language(C ASM)
33
33
 
34
34
  # ---------------- 可执行文件 ----------------
35
- # 编译四个源:用户 main.c、可选的 RTT(Core/Src/rtt.c)、CMSIS 的 system_stm32f1xx.c、启动文件。
35
+ # 编译四个源:用户 main.c、可选的 RTT(Core/Src/rtt.c)、CMSIS 的 system_<族>xx.c、启动文件。
36
36
  # 设备头与内核头通过下面两个 include 目录提供,全部来自下载缓存。
37
37
  #
38
38
  # RTT 是"编进来但不默认启用":模板的 main.c 里 rtt_init() 是注释掉的,工具链又开了
@@ -42,7 +42,7 @@ enable_language(C ASM)
42
42
  add_executable(${CMAKE_PROJECT_NAME}
43
43
  Core/Src/main.c
44
44
  Core/Src/rtt.c
45
- Drivers/CMSIS/Device/ST/__FAMILY_DIR__/Source/Templates/system_stm32f1xx.c
45
+ Drivers/CMSIS/Device/ST/__FAMILY_DIR__/Source/Templates/__SYSTEM_C__
46
46
  Drivers/CMSIS/Device/ST/__FAMILY_DIR__/Source/Templates/gcc/__STARTUP_FILE__
47
47
  )
48
48
 
@@ -15,10 +15,31 @@
15
15
  *
16
16
  * RAM 成本:RTT_UP_CHANNELS × RTT_BUF_SIZE = 3 × 1 KB = 3 KB(.bss)。
17
17
  * C8T6 只有 20 KB,RAM 紧就把 RTT_UP_CHANNELS 改成 1,或把 RTT_BUF_SIZE 改成 256。
18
+ * (只用到通道 0 的话,先把 RTT_UP_CHANNELS 改成 1 省 2 KB,比扩环更划算。)
18
19
  * 注意:模板默认**不调用** rtt_init(),工具链开了 --gc-sections,所以未启用时
19
20
  * 这块内存与 rtt.c 的代码都会被链接器丢掉,不占 RAM/Flash;取消了 main.c 里
20
21
  * USER CODE BEGIN 2 的注释才会真正进来。
21
22
  *
23
+ * 环能撑多久(决定会不会丢):
24
+ * 可容纳记录数 = RTT_BUF_SIZE ÷ 单条帧字节数(13 + payload;一行 70 字符的日志约 83 B)
25
+ * 撑住的时长 = 可容纳记录数 × 打印间隔
26
+ * 例:1024 ÷ 83 ≈ 12 条、每 200 ms 一条 → 约 2.4 s。宿主不读的这段时间一过,环满,
27
+ * NO_BLOCK_SKIP 会**整条丢新记录**(绝不覆盖还没被读走的数据),rtt_dropped_count() 记数。
28
+ * 所以要么让宿主持续读(stm32_rtt 的 dump 只在窗口内读),要么拉长打印间隔 / 放大环。
29
+ *
30
+ * 偏移约定(踩过坑,别改):WrOff/RdOff 必须**永远**落在 [0, RTT_BUF_SIZE)。
31
+ * 曾经发布过 wr + len 这种"只增不减"的 WrOff,一旦 >= Size,openocd 就再也算不清还剩多少、
32
+ * 不再推进 RdOff,环从此永久冻结(现象:dump 每次都是同一块字节 + 重复记录刷屏 + drop 一直涨)。
33
+ *
34
+ * 并发:rtt_write 默认在**临界区**里写环 —— 裸机是关中断(保存/恢复 PRIMASK),
35
+ * RTOS 用强符号覆盖 rtt_lock()/rtt_unlock() 换成「mutex + 关中断」(示例见 rtt.c)。
36
+ * 所以主循环和中断同时打印也不会丢 WrOff 更新。
37
+ *
38
+ * 注意 RTT **不是 SWO**:SWO 是 SWD 的 trace 引脚协议(ITM/printf 用),要配 trace 时钟、
39
+ * 抓线、算带宽;RTT 是**纯内存轮询** —— openocd 通过 SWD 直接读写目标 RAM 里的环,
40
+ * 没有线协议、没有 trace 时钟、也不走 DMA。看到「给 RTT 调中断优先级 / 用 DMA 提速 /
41
+ * 抓 SWO 波形 / 加 CRC 校验」这类建议,那是把两者搞混了,本项目不适用。
42
+ *
22
43
  * 地址怎么拿(start 时 addr 填它):
23
44
  * arm-none-eabi-nm build/<preset>/<工程名>.elf | findstr _SEGGER_RTT
24
45
  * 或 gdb 里:p &_SEGGER_RTT
@@ -72,10 +93,20 @@ void rtt_init(void);
72
93
  * 写一条记录到通道 0。level 取 RTT_LEVEL_*(越界会被夹到 1..4)。
73
94
  * text 是已经格式化好的字符串(结尾 0 会被 strlen 截掉,不写进环)。
74
95
  * 返回写进去的 payload 字节数;环满/放不下完整一条时返回 0(整条丢,不写半条)。
75
- * 可以从主循环和中断里调用;但它不加锁,多个上下文同时写会互相踩(要并发就在外面关中断)。
96
+ * 可以从主循环和中断里调用:内部已经做了临界区保护(默认裸机关中断;RTOS 覆盖
97
+ * rtt_lock/rtt_unlock 换成 mutex,见 rtt.c)。
76
98
  */
77
99
  uint32_t rtt_write(uint32_t level, const char *text);
78
100
 
101
+ /*
102
+ * 并发保护钩子(弱符号,默认实现见 rtt.c):
103
+ * 裸机默认:保存 PRIMASK → 关中断,unlock 时按原样恢复;
104
+ * RTOS:覆盖成「mutex(任务 vs 任务)+ 关中断(任务 vs ISR)」,缺一个都会漏。
105
+ * 返回的 token 由实现自己定,rtt_write 只原样回传。
106
+ */
107
+ uint32_t rtt_lock(void);
108
+ void rtt_unlock(uint32_t token);
109
+
79
110
  /*
80
111
  * printf 风格:先 vsnprintf 到内部缓冲(最多 RTT_MSG_MAX 字节),再走 rtt_write。
81
112
  *
@@ -93,7 +124,11 @@ uint32_t rtt_printf(uint32_t level, const char *fmt, ...);
93
124
  */
94
125
  uint64_t rtt_time_ms(void);
95
126
 
96
- /* 因为环满而整条丢掉的记录数(只在本地可见,dump 的 dropped 只统计按级别过滤掉的)。 */
127
+ /*
128
+ * 因为环满而整条丢掉的记录数(dump 报的 dropped 只统计「按级别过滤掉」的,两者不同)。
129
+ * 只读一个 u32,可以在中断里调用。建议在周期日志里把它打出来(例如 drop=%u),
130
+ * 这样宿主端一眼能看出「环满丢了 N 条」,不用去猜。
131
+ */
97
132
  uint32_t rtt_dropped_count(void);
98
133
 
99
134
  #ifdef __cplusplus
@@ -2,7 +2,7 @@
2
2
  * 寄存器版 main.c(dsh-stm32 生成,模板来源 templates/register/Core/Src/main.c)
3
3
  *
4
4
  * 目标芯片:__MCU_BANNER__
5
- * 板子假设:板载 LED 在 PC13(低电平点亮),引脚不同只改下面两行。
5
+ * 板子假设:板载 LED 在 PC13(低电平点亮),引脚不同改下面的 LED_PIN 与 led_init()。
6
6
  *
7
7
  * 这条路线不用 HAL、不用 CubeMX 生成物、也不需要 STM32Cube 固件包:
8
8
  * 设备头 + 启动文件 + CMSIS 内核头都在 dsh-stm32 的下载缓存里(第一次联网,之后复用)。
@@ -12,11 +12,10 @@
12
12
 
13
13
  #include <stdint.h>
14
14
 
15
- #include "stm32f1xx.h"
15
+ #include "__DEVICE_UMBRELLA__"
16
16
  #include "rtt.h" /* 模板自带的极简 RTT;不用就把这行和下面 USER CODE BEGIN 2 的示例一起删掉 */
17
17
 
18
- /* 换板子改这两行 */
19
- #define LED_PORT GPIOC
18
+ /* 换板子改这一行(PC13 是蓝丸/多数最小系统板的 LED;引脚不同见 led_init() 里的 #error 提示) */
20
19
  #define LED_PIN 13u
21
20
 
22
21
  /* 便于用 gdb / 串口观察:每闪一次 +1 */
@@ -27,6 +26,12 @@ __CLOCK_INIT__
27
26
  * clock_init() 之后 SystemCoreClock 已经是真实频率,所以不需要手动填数字。 */
28
27
  static void delay_ms(uint32_t ms)
29
28
  {
29
+ /* 保存 SysTick 现场:调用方可能已经把它当成 1 ms 时基(TICKINT 打开)。
30
+ * 早期版本结束时直接写 CTRL = 0,会把那个时基一起掐掉——这里用完原样恢复。 */
31
+ const uint32_t ctrl_save = SysTick->CTRL;
32
+ const uint32_t load_save = SysTick->LOAD;
33
+
34
+ SysTick->CTRL = 0u; /* 先停,才能安全改 LOAD/VAL */
30
35
  SysTick->LOAD = (uint32_t)(SystemCoreClock / 1000u) - 1u;
31
36
  SysTick->VAL = 0u;
32
37
  SysTick->CTRL = SysTick_CTRL_CLKSOURCE_Msk | SysTick_CTRL_ENABLE_Msk;
@@ -36,29 +41,16 @@ static void delay_ms(uint32_t ms)
36
41
  }
37
42
  }
38
43
 
39
- SysTick->CTRL = 0u;
40
- }
41
-
42
- static void led_init(void)
43
- {
44
- #if LED_PIN == 13u
45
- RCC->APB2ENR |= RCC_APB2ENR_IOPCEN;
46
- GPIOC->CRH &= ~(GPIO_CRH_MODE13 | GPIO_CRH_CNF13);
47
- GPIOC->CRH |= GPIO_CRH_MODE13_0; /* 推挽输出 10 MHz */
48
- GPIOC->BSRR = GPIO_BSRR_BS13; /* 先给高电平:PC13 低电平点亮 → LED 灭 */
49
- #else
50
- #error "只写好了 PC13 的初始化;换引脚请在 led_init() 里补对应的 CRL/CRH 设置"
51
- #endif
44
+ SysTick->CTRL = 0u; /* 停掉忙等用的配置 */
45
+ SysTick->LOAD = load_save; /* 还原现场 */
46
+ SysTick->VAL = 0u;
47
+ SysTick->CTRL = ctrl_save;
52
48
  }
53
49
 
54
- static void led_toggle(void)
55
- {
56
- #if LED_PIN == 13u
57
- GPIOC->ODR ^= GPIO_ODR_ODR13;
58
- #else
59
- #error "只写好了 PC13 的翻转;换引脚请改这里"
60
- #endif
61
- }
50
+ /* 按族生成的 GPIO 写法(F1 是 CRL/CRH,其它族是 MODER + 各自的时钟门)。
51
+ * 注意:注释里别再写占位符名字——替换是按字面量做的,注释里出现一次就会把整段代码塞进注释,
52
+ * 里层代码自带的注释结束符会提前闭合外层注释,编译报的是一堆莫名其妙的 "#else without #if"。 */
53
+ __LED_INIT__
62
54
 
63
55
  int main(void)
64
56
  {
@@ -112,6 +112,58 @@ uint32_t rtt_control_block_size(void)
112
112
  return (uint32_t)sizeof(_SEGGER_RTT);
113
113
  }
114
114
 
115
+ /* ---------------- 并发保护(弱符号:裸机与 RTOS 用同一份代码) ----------------
116
+ *
117
+ * rtt_write 在临界区里读改写 WrOff,所以写方必须互斥:主循环与中断同时打印时,
118
+ * 不保护会丢掉一次 WrOff 更新(现象是偶发丢记录,严重时把环写乱)。
119
+ *
120
+ * 默认实现 = **裸机关中断**(保存/恢复 PRIMASK):零依赖,C8T6 这种裸机直接能用。
121
+ * 有 RTOS 时用强符号覆盖这一对 —— mutex 负责"任务 vs 任务",关中断负责"任务 vs ISR",
122
+ * 两个都要,缺一个都会漏:
123
+ *
124
+ * static SemaphoreHandle_t s_rtt_mutex; (调度器起来之后再创建)
125
+ * uint32_t rtt_lock(void)
126
+ * {
127
+ * uint32_t primask = __get_PRIMASK();
128
+ * __disable_irq();
129
+ * if (s_rtt_mutex != NULL) { (void)xSemaphoreTake(s_rtt_mutex, portMAX_DELAY); }
130
+ * return primask;
131
+ * }
132
+ * void rtt_unlock(uint32_t primask)
133
+ * {
134
+ * if (s_rtt_mutex != NULL) { (void)xSemaphoreGive(s_rtt_mutex); }
135
+ * if (primask == 0u) { __enable_irq(); }
136
+ * }
137
+ *
138
+ * 三条约束:
139
+ * 1) 返回的 token 语义由实现自己定,rtt_write 只原样回传、不解释(裸机版就是 PRIMASK);
140
+ * 2) 不得在 ISR 里阻塞等待(ISR 里 take mutex 会死锁)——中断里要打印就只靠关中断那一段;
141
+ * 3) 临界区里只有 memcpy + 时间戳,vsnprintf 在锁外,不会长时间关中断。
142
+ */
143
+ __attribute__((weak)) uint32_t rtt_lock(void)
144
+ {
145
+ #if defined(RTT_HAVE_CMSIS)
146
+ uint32_t primask = __get_PRIMASK();
147
+ __disable_irq();
148
+ return primask;
149
+ #else
150
+ /* 没有 CMSIS 头(非 Cortex-M 或头文件缺失)时退化为不加锁:
151
+ * 这种配置下请自己提供 rtt_lock/rtt_unlock(照上面的示例写)。 */
152
+ return 0u;
153
+ #endif
154
+ }
155
+
156
+ __attribute__((weak)) void rtt_unlock(uint32_t token)
157
+ {
158
+ #if defined(RTT_HAVE_CMSIS)
159
+ if (token == 0u) {
160
+ __enable_irq();
161
+ }
162
+ #else
163
+ (void)token;
164
+ #endif
165
+ }
166
+
115
167
  /*
116
168
  * 往一个环里写一整块数据。返回写进去的字节数,放不下返回 0。
117
169
  * 关键顺序:先 memcpy 数据、最后写 WrOff;RdOff 只读不改(openocd 的)。
@@ -128,7 +180,9 @@ static uint32_t rtt_ring_write(rtt_buffer_desc_t *desc, const uint8_t *data, uin
128
180
  if (size == 0u || data == NULL || len == 0u) {
129
181
  return 0u;
130
182
  }
131
- used = wr - rd;
183
+ /* 偏移一律按 [0, size) 解释(SEGGER 约定,openocd 也按这个区间算剩余量)。
184
+ * 不能直接用无符号相减:RdOff 绕过一圈后可能比 WrOff 大,相减会得到天文数字。 */
185
+ used = (wr >= rd) ? (wr - rd) : (size - (rd - wr));
132
186
  if (used >= size) {
133
187
  return 0u; /* 满:整条丢掉(NO_BLOCK_SKIP),不覆盖还没被读走的数据 */
134
188
  }
@@ -145,11 +199,17 @@ static uint32_t rtt_ring_write(rtt_buffer_desc_t *desc, const uint8_t *data, uin
145
199
  if (len > first) {
146
200
  memcpy(desc->pBuffer, data + first, len - first);
147
201
  }
148
- desc->WrOff = wr + len; /* 最后一步:对端看到写指针前进时数据已经就位 */
202
+ wr += len;
203
+ if (wr >= size) {
204
+ wr -= size; /* 必须回绕:WrOff 一旦发布成 >= size,对端再也算不清还剩多少,环就永久卡死 */
205
+ }
206
+ desc->WrOff = wr; /* 最后一步:对端看到写指针前进时数据已经就位 */
149
207
  return len;
150
208
  }
151
209
 
152
- void rtt_init(void)
210
+ /* rtt_init() 的本体:**这里不拿锁** —— rtt_write 已经握着锁调它(懒初始化),
211
+ * 再进一次 rtt_lock() 在有 RTOS 的 mutex 实现下会自锁。拿锁的是下面那个 rtt_init()。 */
212
+ static void rtt_init_locked(void)
153
213
  {
154
214
  uint32_t index;
155
215
 
@@ -180,6 +240,14 @@ void rtt_init(void)
180
240
  memcpy(_SEGGER_RTT.acID, RTT_ID_TEXT, sizeof(RTT_ID_TEXT));
181
241
  }
182
242
 
243
+ void rtt_init(void)
244
+ {
245
+ uint32_t token = rtt_lock();
246
+
247
+ rtt_init_locked();
248
+ rtt_unlock(token);
249
+ }
250
+
183
251
  __attribute__((weak)) uint64_t rtt_time_ms(void)
184
252
  {
185
253
  #if defined(RTT_HAVE_CMSIS)
@@ -220,11 +288,10 @@ uint32_t rtt_write(uint32_t level, const char *text)
220
288
  uint8_t frame[RTT_FRAME_OVERHEAD + RTT_MSG_MAX];
221
289
  uint32_t payload = 0u;
222
290
  uint32_t total;
291
+ uint32_t token;
292
+ uint32_t result;
223
293
  size_t length = 0u;
224
294
 
225
- if (s_initialized == 0u) {
226
- rtt_init(); /* 忘了初始化也能用:第一条记录时补上 */
227
- }
228
295
  if (level < RTT_LEVEL_ERROR) {
229
296
  level = RTT_LEVEL_ERROR;
230
297
  }
@@ -240,16 +307,25 @@ uint32_t rtt_write(uint32_t level, const char *text)
240
307
  payload = (uint32_t)length;
241
308
  }
242
309
 
310
+ /* 组帧(长度/级别)在锁外做:strlen/memcpy 可能耗几十微秒,不该占着临界区。
311
+ * 时间戳和写环必须在锁内:rtt_time_ms() 自己有静态状态,WrOff 是读改写。 */
243
312
  total = RTT_FRAME_OVERHEAD + payload;
244
313
  rtt_put_u32(&frame[0], RTT_FRAME_MIN_BYTES + payload);
245
314
  frame[4] = (uint8_t)level;
246
- rtt_put_u64(&frame[5], rtt_time_ms());
247
315
 
316
+ token = rtt_lock();
317
+ if (s_initialized == 0u) {
318
+ rtt_init_locked(); /* 忘了初始化也能用:第一条记录时补上(已在锁内,别再拿锁) */
319
+ }
320
+ rtt_put_u64(&frame[5], rtt_time_ms());
248
321
  if (rtt_ring_write(&_SEGGER_RTT.aUp[0], frame, total) == 0u) {
249
322
  s_dropped++;
250
- return 0u;
323
+ result = 0u;
324
+ } else {
325
+ result = payload;
251
326
  }
252
- return payload;
327
+ rtt_unlock(token);
328
+ return result;
253
329
  }
254
330
 
255
331
  #if defined(RTT_HAVE_STDIO)
@@ -64,14 +64,18 @@ stm32_rtt action=stop
64
64
  - 默认 `RTT_UP_CHANNELS=3`、`RTT_BUF_SIZE=1024` → **3 KB RAM**(.bss);
65
65
  `RTT_MSG_MAX=120` 是单条 payload 上限。RAM 紧就改 `rtt.h` 的这两个宏(例如 1 个通道 512 字节)。
66
66
  - 工具链开了 `--gc-sections`:不调用 `rtt_init()` 时 `rtt.c` 的代码和那块缓冲会被链接器丢掉,不占 RAM/Flash。
67
- - 环满时**整条丢弃**(不阻塞、不覆盖还没被读走的数据),`rtt_dropped_count()` 能看丢了几条。
67
+ - 环满时**整条丢弃**(不阻塞、不覆盖还没被读走的数据),`rtt_dropped_count()` 能看丢了几条;建议照模板在周期日志里打 `drop=%u`,不然丢了也看不出来。
68
+ - 容量:可容纳条数 = `RTT_BUF_SIZE` ÷ 单条帧字节数(`13 + 正文长`),1024 缓冲 + 80 字节正文 ≈ 12 条;撑多久 = 条数 × 打印间隔(200 ms 一条 ≈ 2.4 s)。掉电前要留的关键日志,别指望环能存下。
69
+ - `WrOff`/`RdOff` 必须始终落在 `[0, RTT_BUF_SIZE)`:早期模板发布过「只增不减」的 `WrOff`,一旦越界,openocd 就算不清还剩多少、**不再推进 `RdOff`**,环灌满一次后永久冻结(现象:每次 dump 都是同一块字节 + 重复记录刷屏 + `drop` 一直涨)。现已在 `rtt_ring_write()` 里回绕并让 `used` 按环长算。
70
+ - **RTT 不是 SWO**:openocd 用 SWD 读目标 RAM 里的环,不占 ITM/引脚,也跟中断优先级无关(改 SysTick 优先级不会改变丢不丢)。
68
71
  - 时间戳默认用 DWT 周期计数器;已经有 `HAL_GetTick()` 的话覆盖弱符号更省事:
69
72
 
70
73
  ```c
71
74
  uint64_t rtt_time_ms(void) { return (uint64_t)HAL_GetTick(); }
72
75
  ```
73
76
 
74
- - 主循环和中断都能写,但它没加锁:多个上下文并发写要自己在外面关中断。
77
+ - 主循环和中断都能写:`rtt_write()` 内部已经过临界区(`rtt_lock()`/`rtt_unlock()` 弱符号,默认存/恢复 PRIMASK),**不需要自己在外面关中断**。
78
+ - 用 RTOS 时覆盖这两个弱符号即可(`rtt.h` 头注释里有 FreeRTOS 例子):拿 mutex 包住 + 里面再关中断,裸机和 RTOS 就都能用了。
75
79
  - `rtt_printf()` 用 newlib 的 `vsnprintf`,会牵进 `_sbrk`。HAL 工程本来就带 `Core/Src/syscalls.c`,不用管;
76
80
  寄存器版没有 syscalls.c,所以 `rtt.c` 里给了一份**弱符号** `_sbrk` 兜底(直接失败,等于没有堆),
77
81
  你自己实现 `_sbrk` 时那份强符号会自动覆盖它。只想要零依赖就用 `rtt_write(level, "已经格式化好的串")`。
@@ -64,6 +64,9 @@ _estack = ORIGIN(RAM) + LENGTH(RAM); /* end of RAM */
64
64
  /* Generate a link error if heap and stack don't fit into RAM */
65
65
  _Min_Heap_Size = 0x200; /* required amount of heap */
66
66
  _Min_Stack_Size = 0x400; /* required amount of stack */
67
+ /* Stack limit (MSPLIM): H5/H7 等启动文件会把 _sstack 写进 MSPLIM,取「栈底」= 栈顶 - 预留栈。
68
+ F1 的启动文件不用它;同一份链接脚本给所有族用,多一个等值别名不影响链接结果。 */
69
+ _sstack = _estack - _Min_Stack_Size;
67
70
 
68
71
  /* Define output sections */
69
72
  SECTIONS
@@ -1,7 +1,9 @@
1
- # CMSIS-DAP 探针 + SWD。stm32_project_create 生成;换 ST-Link 就把 source 换成
2
- # interface/stlink.cfg,J-Link 用 interface/jlink.cfg。adapter speed 可在 1000~5000 之间调。
3
- # transport 必须写 swd:hla_swd 只有 st-link 系适配器支持,CMSIS-DAP 会报
1
+ # CMSIS-DAP 探针 + SWD。stm32_project_create 生成(实见 ST-Link 时这里会换成
2
+ # interface/stlink-dap.cfg);J-Link 用 interface/jlink.cfg。adapter speed 可在 1000~5000 之间调。
3
+ # transport 必须写 swd:hla_swd 只有 st-link 的 hla 驱动支持,CMSIS-DAP 会报
4
4
  # 「Debug adapter doesn't support 'hla_swd' transport」直接连不上。
5
+ # ST-Link 用 stlink-dap(dapdirect)而不是 stlink.cfg(hla)——C0/U0 一类新族 target
6
+ # 脚本走的是 swj-dp.tcl,hla 会报 transport 不支持。
5
7
  source [find interface/cmsis-dap.cfg]
6
8
  transport select swd
7
9
  source [find target/stm32f1x.cfg]
@@ -12,9 +12,11 @@
12
12
  "request": "launch",
13
13
  "type": "cortex-debug",
14
14
  "servertype": "openocd",
15
+ // configFiles 只给工程自带的 openocd.cfg:里面按顺序写了 interface → transport → target
16
+ // (J-Link 必须显式 transport select swd;ST-Link/CMSIS-DAP 的 interface 自带 transport)。
17
+ // 拆成 interface + target 两条时 cortex-debug 没处插 transport,J-Link 会默认走 jtag 而连不上。
15
18
  "configFiles": [
16
- "interface/cmsis-dap.cfg",
17
- "target/stm32f1x.cfg"
19
+ "${workspaceFolder}/openocd.cfg"
18
20
  ],
19
21
  // 想看外设寄存器(可选):自己加一行 "svdPath": "<对应芯片的 .svd 绝对路径>"。
20
22
  // 不给也能调试,只是没有外设寄存器视图;插件不替你选 SVD。
@@ -33,9 +35,11 @@
33
35
  "request": "launch",
34
36
  "type": "cortex-debug",
35
37
  "servertype": "openocd",
38
+ // configFiles 只给工程自带的 openocd.cfg:里面按顺序写了 interface → transport → target
39
+ // (J-Link 必须显式 transport select swd;ST-Link/CMSIS-DAP 的 interface 自带 transport)。
40
+ // 拆成 interface + target 两条时 cortex-debug 没处插 transport,J-Link 会默认走 jtag 而连不上。
36
41
  "configFiles": [
37
- "interface/cmsis-dap.cfg",
38
- "target/stm32f1x.cfg"
42
+ "${workspaceFolder}/openocd.cfg"
39
43
  ],
40
44
  // 想看外设寄存器(可选):自己加一行 "svdPath": "<对应芯片的 .svd 绝对路径>"。
41
45
  // 不给也能调试,只是没有外设寄存器视图;插件不替你选 SVD。