dsh-stm32 0.1.2 → 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.
- package/README.md +92 -40
- package/README_EN.md +85 -36
- package/assets/README.md +85 -0
- package/assets/VERSION +1 -0
- package/assets/device/c0/chips.json +1108 -0
- package/assets/device/f0/chips.json +1570 -0
- package/assets/device/f1/chips.json +1238 -0
- package/assets/device/f1/svd/100.json +943 -0
- package/assets/device/f1/svd/101.json +901 -0
- package/assets/device/f1/svd/102.json +522 -0
- package/assets/device/f1/svd/103.json +1139 -0
- package/assets/device/f1/svd/105.json +1117 -0
- package/assets/device/f1/svd/107.json +1195 -0
- package/assets/device/f2/chips.json +674 -0
- package/assets/device/f3/chips.json +1318 -0
- package/assets/device/f4/chips.json +2942 -0
- package/assets/device/f7/chips.json +1710 -0
- package/assets/device/g0/chips.json +2102 -0
- package/assets/device/g4/chips.json +2494 -0
- package/assets/device/h5/chips.json +898 -0
- package/assets/device/h7/chips.json +1948 -0
- package/assets/device/l0/chips.json +2494 -0
- package/assets/device/l1/chips.json +1234 -0
- package/assets/device/l4/chips.json +2130 -0
- package/assets/device/l4+/chips.json +856 -0
- package/assets/device/l5/chips.json +226 -0
- package/assets/device/u0/chips.json +688 -0
- package/assets/device/u3/chips.json +310 -0
- package/assets/device/u5/chips.json +884 -0
- package/assets/device/wba/chips.json +506 -0
- package/assets/device/wl/chips.json +184 -0
- package/assets/headers/f1/stm32f100xb.h +5972 -0
- package/assets/headers/f1/stm32f100xe.h +6587 -0
- package/assets/headers/f1/stm32f101x6.h +5315 -0
- package/assets/headers/f1/stm32f101xb.h +5446 -0
- package/assets/headers/f1/stm32f101xe.h +6503 -0
- package/assets/headers/f1/stm32f101xg.h +6713 -0
- package/assets/headers/f1/stm32f102x6.h +6448 -0
- package/assets/headers/f1/stm32f102xb.h +6570 -0
- package/assets/headers/f1/stm32f103x6.h +10109 -0
- package/assets/headers/f1/stm32f103xb.h +10240 -0
- package/assets/headers/f1/stm32f103xe.h +11767 -0
- package/assets/headers/f1/stm32f103xg.h +11951 -0
- package/assets/headers/f1/stm32f105xc.h +14340 -0
- package/assets/headers/f1/stm32f107xc.h +15253 -0
- package/assets/headers/f1/stm32f1xx.h +273 -0
- package/assets/headers/f1/system_stm32f1xx.h +96 -0
- package/assets/ioc/family/C0.ioc +82 -0
- package/assets/ioc/family/F0.ioc +71 -0
- package/assets/ioc/family/F2.ioc +91 -0
- package/assets/ioc/family/F3.ioc +94 -0
- package/assets/ioc/family/F4.ioc +91 -0
- package/assets/ioc/family/F7.ioc +102 -0
- package/assets/ioc/family/G0.ioc +90 -0
- package/assets/ioc/family/G4.ioc +110 -0
- package/assets/ioc/family/H5.ioc +116 -0
- package/assets/ioc/family/H7.ioc +133 -0
- package/assets/ioc/family/L0.ioc +92 -0
- package/assets/ioc/family/L1.ioc +87 -0
- package/assets/ioc/family/L4+.ioc +92 -0
- package/assets/ioc/family/L4.ioc +93 -0
- package/assets/ioc/family/L5.ioc +91 -0
- package/assets/ioc/family/U0.ioc +103 -0
- package/assets/ioc/family/U3.ioc +113 -0
- package/assets/ioc/family/U5.ioc +102 -0
- package/assets/ioc/family/WBA.ioc +100 -0
- package/assets/ioc/family/WL.ioc +93 -0
- package/assets/ioc/minimal/STM32F100C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F100RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101C4Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F101RFTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F102C4Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F102C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103C4Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103C8Tx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F103RFTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F105RCTx.ioc +113 -0
- package/assets/ioc/minimal/STM32F107RCTx.ioc +113 -0
- package/assets/ld/f1/STM32F100C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F100RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101C4Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F101RFTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F102C4Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F102C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103C4Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103C8Tx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F103RFTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F105RCTx_FLASH.ld +249 -0
- package/assets/ld/f1/STM32F107RCTx_FLASH.ld +249 -0
- package/assets/manifest.json +1130 -0
- package/assets/startup/f1/startup_stm32f100xb.s +407 -0
- package/assets/startup/f1/startup_stm32f100xe.s +449 -0
- package/assets/startup/f1/startup_stm32f101x6.s +322 -0
- package/assets/startup/f1/startup_stm32f101xb.s +338 -0
- package/assets/startup/f1/startup_stm32f101xe.s +423 -0
- package/assets/startup/f1/startup_stm32f101xg.s +439 -0
- package/assets/startup/f1/startup_stm32f102x6.s +330 -0
- package/assets/startup/f1/startup_stm32f102xb.s +346 -0
- package/assets/startup/f1/startup_stm32f103x6.s +348 -0
- package/assets/startup/f1/startup_stm32f103xb.s +364 -0
- package/assets/startup/f1/startup_stm32f103xe.s +470 -0
- package/assets/startup/f1/startup_stm32f103xg.s +466 -0
- package/assets/startup/f1/startup_stm32f105xc.s +463 -0
- package/assets/startup/f1/startup_stm32f107xc.s +472 -0
- package/assets/templates/family/C0.ioc +82 -0
- package/assets/templates/family/F0.ioc +71 -0
- package/assets/templates/family/F2.ioc +91 -0
- package/assets/templates/family/F3.ioc +94 -0
- package/assets/templates/family/F4.ioc +91 -0
- package/assets/templates/family/F7.ioc +102 -0
- package/assets/templates/family/G0.ioc +90 -0
- package/assets/templates/family/G4.ioc +110 -0
- package/assets/templates/family/H5.ioc +116 -0
- package/assets/templates/family/H7.ioc +133 -0
- package/assets/templates/family/L0.ioc +92 -0
- package/assets/templates/family/L1.ioc +87 -0
- package/assets/templates/family/L4+.ioc +92 -0
- package/assets/templates/family/L4.ioc +93 -0
- package/assets/templates/family/L5.ioc +91 -0
- package/assets/templates/family/U0.ioc +103 -0
- package/assets/templates/family/U3.ioc +113 -0
- package/assets/templates/family/U5.ioc +102 -0
- package/assets/templates/family/WB.ioc +81 -0
- package/assets/templates/family/WBA.ioc +100 -0
- package/assets/templates/family/WL.ioc +93 -0
- package/docs/reading-guide.md +94 -71
- package/lib/data/chips.js +38 -51
- package/lib/data/clock-db.js +830 -0
- package/lib/data/clock-f1.js +12 -45
- package/lib/data/cmsis-sources.js +264 -17
- package/lib/data/db-presets.js +252 -0
- package/lib/data/device-facts.js +274 -0
- package/lib/data/family.js +515 -0
- package/lib/data/firmware-packages.js +562 -0
- package/lib/data/install-guides.js +2 -2
- package/lib/data/ioc-presets.js +248 -0
- package/lib/data/ioc-schema.js +1058 -0
- package/lib/data/rm-topics/stm32c0.json +227 -0
- package/lib/data/rm-topics.js +103 -0
- package/lib/data/search-roots.js +42 -1
- package/lib/data/stm32f1.js +95 -150
- package/lib/data/svd.js +643 -0
- package/lib/data/toolchain-config.js +0 -14
- package/lib/engine/assets.js +659 -0
- package/lib/engine/breakpoints.js +297 -0
- package/lib/engine/clock-derived.js +101 -0
- package/lib/engine/clock-direct.js +313 -0
- package/lib/engine/clock-plan.js +96 -52
- package/lib/engine/clock-pllmn.js +319 -0
- package/lib/engine/cmake-sources.js +67 -13
- package/lib/engine/cube-mx-guard.js +44 -0
- package/lib/engine/cube-programmer.js +137 -0
- package/lib/engine/cubemx-db.js +273 -0
- package/lib/engine/debug-session.js +576 -22
- package/lib/engine/debug.js +99 -46
- package/lib/engine/doctor.js +162 -19
- package/lib/engine/facts-acquire.js +416 -0
- package/lib/engine/facts.js +134 -0
- package/lib/engine/firmware-install.js +176 -5
- package/lib/engine/firmware-official.js +451 -0
- package/lib/engine/flash.js +317 -76
- package/lib/engine/gdb-mi.js +476 -0
- package/lib/engine/generate.js +9 -2
- package/lib/engine/hal-chip.js +124 -41
- package/lib/engine/ioc-plan.js +1247 -63
- package/lib/engine/ioc-rules.js +698 -0
- package/lib/engine/ioc-verify.js +706 -0
- package/lib/engine/ioc.js +43 -4
- package/lib/engine/msys2-install.js +4 -4
- package/lib/engine/probe-error.js +231 -0
- package/lib/engine/probe-session.js +347 -0
- package/lib/engine/probe.js +18 -3
- package/lib/engine/register-clock.js +41 -0
- package/lib/engine/register-gpio.js +115 -0
- package/lib/engine/register-linker.js +12 -7
- package/lib/engine/register-template.js +130 -45
- package/lib/engine/regs.js +43 -8
- package/lib/engine/rm-extract.js +144 -0
- package/lib/engine/rm-sources.js +360 -0
- package/lib/engine/rm-text.js +56 -0
- package/lib/engine/rtt.js +758 -0
- package/lib/engine/scaffold.js +185 -18
- package/lib/engine/toolchain-gate.js +0 -4
- package/lib/engine/watch.js +227 -0
- package/lib/index.js +12 -2
- package/lib/skill/stm32-workflow.js +2 -2
- package/lib/tools/assets.js +272 -0
- package/lib/tools/cache.js +8 -0
- package/lib/tools/debug-session.js +41 -6
- package/lib/tools/debug.js +41 -11
- package/lib/tools/doctor.js +65 -4
- package/lib/tools/firmware-install.js +31 -6
- package/lib/tools/flash.js +47 -10
- package/lib/tools/generate.js +25 -0
- package/lib/tools/ioc-apply.js +2 -0
- package/lib/tools/ioc-inspect.js +2 -0
- package/lib/tools/ioc-plan.js +59 -2
- package/lib/tools/ioc-verify.js +237 -0
- package/lib/tools/project-create.js +63 -3
- package/lib/tools/regs.js +453 -61
- package/lib/tools/route-plan.js +3 -0
- package/lib/tools/rtt.js +470 -0
- package/lib/tools/watch.js +256 -0
- package/package.json +5 -4
- package/templates/openocd/stm32c0x.cfg +83 -0
- package/templates/openocd/stm32u0x.cfg +64 -0
- package/templates/register/CMakeLists.txt +8 -2
- package/templates/register/Core/Inc/rtt.h +138 -0
- package/templates/register/Core/Src/main.c +42 -25
- package/templates/register/Core/Src/rtt.c +373 -0
- package/templates/scaffold/RTT.md +90 -0
- package/templates/scaffold/STM32F103XX_FLASH.ld +3 -0
- package/templates/scaffold/cmake/user/CMakeLists.txt +7 -0
- package/templates/scaffold/openocd.cfg +5 -3
- package/templates/scaffold/vscode/launch.json +8 -4
- package/docs/development-notes.md +0 -2116
- package/docs/dsh-stm32-plugin-/350/247/204/346/240/274.md +0 -673
- package/docs/logic-audit.md +0 -607
- package/lib/data/f1-ram.generated.js +0 -34
|
@@ -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,10 +12,10 @@
|
|
|
12
12
|
|
|
13
13
|
#include <stdint.h>
|
|
14
14
|
|
|
15
|
-
#include "
|
|
15
|
+
#include "__DEVICE_UMBRELLA__"
|
|
16
|
+
#include "rtt.h" /* 模板自带的极简 RTT;不用就把这行和下面 USER CODE BEGIN 2 的示例一起删掉 */
|
|
16
17
|
|
|
17
|
-
/*
|
|
18
|
-
#define LED_PORT GPIOC
|
|
18
|
+
/* 换板子改这一行(PC13 是蓝丸/多数最小系统板的 LED;引脚不同见 led_init() 里的 #error 提示) */
|
|
19
19
|
#define LED_PIN 13u
|
|
20
20
|
|
|
21
21
|
/* 便于用 gdb / 串口观察:每闪一次 +1 */
|
|
@@ -26,6 +26,12 @@ __CLOCK_INIT__
|
|
|
26
26
|
* clock_init() 之后 SystemCoreClock 已经是真实频率,所以不需要手动填数字。 */
|
|
27
27
|
static void delay_ms(uint32_t ms)
|
|
28
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 */
|
|
29
35
|
SysTick->LOAD = (uint32_t)(SystemCoreClock / 1000u) - 1u;
|
|
30
36
|
SysTick->VAL = 0u;
|
|
31
37
|
SysTick->CTRL = SysTick_CTRL_CLKSOURCE_Msk | SysTick_CTRL_ENABLE_Msk;
|
|
@@ -35,35 +41,46 @@ static void delay_ms(uint32_t ms)
|
|
|
35
41
|
}
|
|
36
42
|
}
|
|
37
43
|
|
|
38
|
-
SysTick->CTRL = 0u;
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
{
|
|
43
|
-
#if LED_PIN == 13u
|
|
44
|
-
RCC->APB2ENR |= RCC_APB2ENR_IOPCEN;
|
|
45
|
-
GPIOC->CRH &= ~(GPIO_CRH_MODE13 | GPIO_CRH_CNF13);
|
|
46
|
-
GPIOC->CRH |= GPIO_CRH_MODE13_0; /* 推挽输出 10 MHz */
|
|
47
|
-
GPIOC->BSRR = GPIO_BSRR_BS13; /* 先给高电平:PC13 低电平点亮 → LED 灭 */
|
|
48
|
-
#else
|
|
49
|
-
#error "只写好了 PC13 的初始化;换引脚请在 led_init() 里补对应的 CRL/CRH 设置"
|
|
50
|
-
#endif
|
|
44
|
+
SysTick->CTRL = 0u; /* 停掉忙等用的配置 */
|
|
45
|
+
SysTick->LOAD = load_save; /* 还原现场 */
|
|
46
|
+
SysTick->VAL = 0u;
|
|
47
|
+
SysTick->CTRL = ctrl_save;
|
|
51
48
|
}
|
|
52
49
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
#
|
|
56
|
-
|
|
57
|
-
#else
|
|
58
|
-
#error "只写好了 PC13 的翻转;换引脚请改这里"
|
|
59
|
-
#endif
|
|
60
|
-
}
|
|
50
|
+
/* 按族生成的 GPIO 写法(F1 是 CRL/CRH,其它族是 MODER + 各自的时钟门)。
|
|
51
|
+
* 注意:注释里别再写占位符名字——替换是按字面量做的,注释里出现一次就会把整段代码塞进注释,
|
|
52
|
+
* 里层代码自带的注释结束符会提前闭合外层注释,编译报的是一堆莫名其妙的 "#else without #if"。 */
|
|
53
|
+
__LED_INIT__
|
|
61
54
|
|
|
62
55
|
int main(void)
|
|
63
56
|
{
|
|
64
57
|
clock_init(); /* 先把频率提到芯片能跑的上限,再配外设 */
|
|
65
58
|
led_init();
|
|
66
59
|
|
|
60
|
+
/* USER CODE BEGIN 2 */
|
|
61
|
+
/*
|
|
62
|
+
* RTT 调试输出(可选,默认没开):模板里 rtt.c/rtt.h 已经就位,但 rtt_init()
|
|
63
|
+
* 不强制调用——工具链开了 --gc-sections,没调用时 rtt.c 的代码和 3 KB 控制块
|
|
64
|
+
* 缓冲会被整个丢掉,不占 RAM/Flash。要用就取消下面两行的注释:
|
|
65
|
+
*
|
|
66
|
+
* rtt_init(); // 必须在 clock_init() 之后(时间戳要用 DWT 周期计数器)
|
|
67
|
+
* rtt_printf(RTT_LEVEL_INFO, "boot: sysclk=%lu Hz", (unsigned long)SystemCoreClock);
|
|
68
|
+
*
|
|
69
|
+
* 之后在宿主侧这样读(openocd 的 rtt 命令 + TCP 端口,插件已经封装好):
|
|
70
|
+
* arm-none-eabi-nm build/<preset>/<工程名>.elf | findstr _SEGGER_RTT // 拿控制块地址
|
|
71
|
+
* stm32_rtt action=start addr=0x2000xxxx // 地址就是 nm 出来的那个,size 用默认 0x400
|
|
72
|
+
* stm32_rtt action=dump // 打印 {t, level, text} 记录
|
|
73
|
+
* stm32_rtt action=stop
|
|
74
|
+
*
|
|
75
|
+
* 代价与限制:
|
|
76
|
+
* - 3 个上行通道 × 1 KB = 3 KB RAM(C8T6 只有 20 KB)。嫌多就改 rtt.h 里的
|
|
77
|
+
* RTT_UP_CHANNELS=1、RTT_BUF_SIZE=256;
|
|
78
|
+
* - 控制块是普通 .bss 变量,地址随重链接漂移,所以别把地址写死,每次 nm 一遍;
|
|
79
|
+
* - 环满时整条记录丢弃(不阻塞、不覆盖未读数据),rtt_dropped_count() 能看丢了几条;
|
|
80
|
+
* - 主循环和中断都能写,但它没加锁:多个上下文并发写要自己关中断。
|
|
81
|
+
*/
|
|
82
|
+
/* USER CODE END 2 */
|
|
83
|
+
|
|
67
84
|
while (1) {
|
|
68
85
|
led_toggle();
|
|
69
86
|
g_led_blink_count++;
|
|
@@ -0,0 +1,373 @@
|
|
|
1
|
+
/*
|
|
2
|
+
* 极简 RTT 实现(dsh-stm32 寄存器版模板自带)——配套 rtt.h,接口与约定都写在那里面。
|
|
3
|
+
*
|
|
4
|
+
* 这里只强调三件容易被改坏的事:
|
|
5
|
+
*
|
|
6
|
+
* 1) 控制块布局必须与 SEGGER RTT 一致,否则 openocd 的 rtt setup 找不到/解析不了:
|
|
7
|
+
* char acID[16] = "SEGGER RTT" → 两个 u32 通道数 → N 个上行描述符 → 下行描述符
|
|
8
|
+
* 每个描述符 6 个 32 位字段:sName、pBuffer、SizeOfBuffer、WrOff、RdOff、Flags。
|
|
9
|
+
* 下面的 _Static_assert 把"ID 在最前""描述符 24 字节""上行数组偏移 24"钉住了,
|
|
10
|
+
* 改动结构体时编译会直接失败,而不是等烧进板子才发现 openocd 报错。
|
|
11
|
+
*
|
|
12
|
+
* 2) 帧格式必须与 src/engine/rtt.ts 的 parseRttFrames() 一致:
|
|
13
|
+
* [4B 长度 LE][1B 级别][8B 时间戳 ms LE][payload]
|
|
14
|
+
* 长度 = 9 + payload。写半条帧会让 dump 端判失步(它宁可报错也不猜)。
|
|
15
|
+
*
|
|
16
|
+
* 3) openocd 是"消费者":它读走数据后会改 RdOff。所以写数据一定要先写环、
|
|
17
|
+
* 最后才推进 WrOff;并且放不下完整一条时整条丢掉,不能覆盖还没被读走的字节。
|
|
18
|
+
*/
|
|
19
|
+
|
|
20
|
+
#include "rtt.h"
|
|
21
|
+
|
|
22
|
+
#include <stdarg.h> /* va_list / va_start:rtt_printf 用(没引 stdio 的配置下也要能编) */
|
|
23
|
+
#include <stddef.h> /* offsetof:下面的 _Static_assert 用 */
|
|
24
|
+
#include <string.h>
|
|
25
|
+
|
|
26
|
+
#if defined(__has_include)
|
|
27
|
+
# if __has_include(<stdio.h>)
|
|
28
|
+
# include <stdio.h>
|
|
29
|
+
# define RTT_HAVE_STDIO 1
|
|
30
|
+
# endif
|
|
31
|
+
# if __has_include("stm32f1xx.h")
|
|
32
|
+
# include "stm32f1xx.h"
|
|
33
|
+
# define RTT_HAVE_CMSIS 1
|
|
34
|
+
# endif
|
|
35
|
+
#endif
|
|
36
|
+
|
|
37
|
+
#if !defined(RTT_HAVE_CMSIS)
|
|
38
|
+
/* 非 F1 / 没有 CMSIS 时也能编:时间戳退化(见 rtt_time_ms)。 */
|
|
39
|
+
extern uint32_t SystemCoreClock;
|
|
40
|
+
#endif
|
|
41
|
+
|
|
42
|
+
/* ---------------- 帧格式常量(与引擎一一对应) ---------------- */
|
|
43
|
+
|
|
44
|
+
/* 4B 长度 + 1B 级别 + 8B 时间戳 */
|
|
45
|
+
#define RTT_FRAME_OVERHEAD 13u
|
|
46
|
+
/* 长度字段允许的最小值:空 payload 时 = 1 + 8 */
|
|
47
|
+
#define RTT_FRAME_MIN_BYTES 9u
|
|
48
|
+
|
|
49
|
+
/* ---------------- SEGGER RTT 控制块 ---------------- */
|
|
50
|
+
|
|
51
|
+
/* 通道描述符:必须正好 24 字节(6 个 32 位字段),否则 openocd 解析会错位。 */
|
|
52
|
+
typedef struct {
|
|
53
|
+
const char *sName; /* 通道名,给 openocd 打印用 */
|
|
54
|
+
uint8_t *pBuffer; /* 环形缓冲 */
|
|
55
|
+
uint32_t SizeOfBuffer; /* 环大小(字节) */
|
|
56
|
+
uint32_t WrOff; /* 写偏移:只由固件改 */
|
|
57
|
+
volatile uint32_t RdOff; /* 读偏移:由 openocd 改 */
|
|
58
|
+
uint32_t Flags; /* 0 = NO_BLOCK_SKIP(环满就丢新记录,不阻塞) */
|
|
59
|
+
} rtt_buffer_desc_t;
|
|
60
|
+
|
|
61
|
+
/* 控制块:ID 在最前,紧跟两个通道数,然后是上行描述符数组。
|
|
62
|
+
* MaxNumDownBuffers = 0:不做下行通道,aDown 只占位保证布局不越界。 */
|
|
63
|
+
typedef struct {
|
|
64
|
+
char acID[16];
|
|
65
|
+
uint32_t MaxNumUpBuffers;
|
|
66
|
+
uint32_t MaxNumDownBuffers;
|
|
67
|
+
rtt_buffer_desc_t aUp[RTT_UP_CHANNELS];
|
|
68
|
+
rtt_buffer_desc_t aDown[1];
|
|
69
|
+
} rtt_control_block_t;
|
|
70
|
+
|
|
71
|
+
_Static_assert(sizeof(rtt_buffer_desc_t) == 24u, "通道描述符必须 24 字节(sName/pBuffer/Size/WrOff/RdOff/Flags 各 4 字节)");
|
|
72
|
+
_Static_assert(offsetof(rtt_control_block_t, acID) == 0u, "控制块必须以 ID 开头");
|
|
73
|
+
_Static_assert(offsetof(rtt_control_block_t, MaxNumUpBuffers) == 16u, "ID 之后是上行通道数");
|
|
74
|
+
_Static_assert(offsetof(rtt_control_block_t, aUp) == 24u, "ID(16) + 两个通道数(4+4) 之后才是上行通道描述符");
|
|
75
|
+
|
|
76
|
+
/* ID 文本单独拿出来:memcpy 的时候连结尾 0 一起写(sizeof 包含它)。 */
|
|
77
|
+
static const char RTT_ID_TEXT[] = "SEGGER RTT";
|
|
78
|
+
|
|
79
|
+
/* 3 个上行通道的环形缓冲(.bss;模板默认不启用 rtt.c,--gc-sections 会把它丢掉)。 */
|
|
80
|
+
static uint8_t s_up_buf[RTT_UP_CHANNELS][RTT_BUF_SIZE];
|
|
81
|
+
|
|
82
|
+
/* 控制块本体。名字保持 _SEGGER_RTT,方便 nm / map / gdb 一眼找到地址。 */
|
|
83
|
+
__attribute__((used)) rtt_control_block_t _SEGGER_RTT;
|
|
84
|
+
|
|
85
|
+
static uint32_t s_dropped;
|
|
86
|
+
static uint8_t s_initialized;
|
|
87
|
+
#if defined(RTT_HAVE_CMSIS)
|
|
88
|
+
static uint32_t s_cycles_per_ms;
|
|
89
|
+
#endif
|
|
90
|
+
|
|
91
|
+
static const char *rtt_up_name(uint32_t index)
|
|
92
|
+
{
|
|
93
|
+
switch (index) {
|
|
94
|
+
case 0u:
|
|
95
|
+
return "Terminal";
|
|
96
|
+
case 1u:
|
|
97
|
+
return "Channel 1";
|
|
98
|
+
default:
|
|
99
|
+
return "Channel 2";
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
uint32_t rtt_control_block_addr(void)
|
|
104
|
+
{
|
|
105
|
+
return (uint32_t)(uintptr_t)&_SEGGER_RTT;
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
uint32_t rtt_control_block_size(void)
|
|
109
|
+
{
|
|
110
|
+
/* 控制块本身只有 ~120 字节,但 openocd 是按 [addr, addr+size) 扫 ID 的,
|
|
111
|
+
* 传大一点(例如 0x400)也无害,能把紧跟其后的描述符都覆盖住。 */
|
|
112
|
+
return (uint32_t)sizeof(_SEGGER_RTT);
|
|
113
|
+
}
|
|
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
|
+
|
|
167
|
+
/*
|
|
168
|
+
* 往一个环里写一整块数据。返回写进去的字节数,放不下返回 0。
|
|
169
|
+
* 关键顺序:先 memcpy 数据、最后写 WrOff;RdOff 只读不改(openocd 的)。
|
|
170
|
+
*/
|
|
171
|
+
static uint32_t rtt_ring_write(rtt_buffer_desc_t *desc, const uint8_t *data, uint32_t len)
|
|
172
|
+
{
|
|
173
|
+
uint32_t size = desc->SizeOfBuffer;
|
|
174
|
+
uint32_t wr = desc->WrOff;
|
|
175
|
+
uint32_t rd = desc->RdOff;
|
|
176
|
+
uint32_t used; /* 无符号相减:只要 used < size 就说明没追尾 */
|
|
177
|
+
uint32_t wr_pos;
|
|
178
|
+
uint32_t first;
|
|
179
|
+
|
|
180
|
+
if (size == 0u || data == NULL || len == 0u) {
|
|
181
|
+
return 0u;
|
|
182
|
+
}
|
|
183
|
+
/* 偏移一律按 [0, size) 解释(SEGGER 约定,openocd 也按这个区间算剩余量)。
|
|
184
|
+
* 不能直接用无符号相减:RdOff 绕过一圈后可能比 WrOff 大,相减会得到天文数字。 */
|
|
185
|
+
used = (wr >= rd) ? (wr - rd) : (size - (rd - wr));
|
|
186
|
+
if (used >= size) {
|
|
187
|
+
return 0u; /* 满:整条丢掉(NO_BLOCK_SKIP),不覆盖还没被读走的数据 */
|
|
188
|
+
}
|
|
189
|
+
if (len > size - used) {
|
|
190
|
+
return 0u; /* 放不下完整一条:宁可丢,也不写半条让对端失步 */
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
wr_pos = wr % size; /* 环大小是 2 的幂时编译器会把它优化成 & (size-1) */
|
|
194
|
+
first = size - wr_pos;
|
|
195
|
+
if (first > len) {
|
|
196
|
+
first = len;
|
|
197
|
+
}
|
|
198
|
+
memcpy(&desc->pBuffer[wr_pos], data, first);
|
|
199
|
+
if (len > first) {
|
|
200
|
+
memcpy(desc->pBuffer, data + first, len - first);
|
|
201
|
+
}
|
|
202
|
+
wr += len;
|
|
203
|
+
if (wr >= size) {
|
|
204
|
+
wr -= size; /* 必须回绕:WrOff 一旦发布成 >= size,对端再也算不清还剩多少,环就永久卡死 */
|
|
205
|
+
}
|
|
206
|
+
desc->WrOff = wr; /* 最后一步:对端看到写指针前进时数据已经就位 */
|
|
207
|
+
return len;
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
/* rtt_init() 的本体:**这里不拿锁** —— rtt_write 已经握着锁调它(懒初始化),
|
|
211
|
+
* 再进一次 rtt_lock() 在有 RTOS 的 mutex 实现下会自锁。拿锁的是下面那个 rtt_init()。 */
|
|
212
|
+
static void rtt_init_locked(void)
|
|
213
|
+
{
|
|
214
|
+
uint32_t index;
|
|
215
|
+
|
|
216
|
+
memset(&_SEGGER_RTT, 0, sizeof(_SEGGER_RTT));
|
|
217
|
+
_SEGGER_RTT.MaxNumUpBuffers = (uint32_t)RTT_UP_CHANNELS;
|
|
218
|
+
_SEGGER_RTT.MaxNumDownBuffers = 0u;
|
|
219
|
+
for (index = 0u; index < (uint32_t)RTT_UP_CHANNELS; index++) {
|
|
220
|
+
_SEGGER_RTT.aUp[index].sName = rtt_up_name(index);
|
|
221
|
+
_SEGGER_RTT.aUp[index].pBuffer = s_up_buf[index];
|
|
222
|
+
_SEGGER_RTT.aUp[index].SizeOfBuffer = (uint32_t)RTT_BUF_SIZE;
|
|
223
|
+
_SEGGER_RTT.aUp[index].WrOff = 0u;
|
|
224
|
+
_SEGGER_RTT.aUp[index].RdOff = 0u;
|
|
225
|
+
_SEGGER_RTT.aUp[index].Flags = 0u;
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
#if defined(RTT_HAVE_CMSIS)
|
|
229
|
+
/* DWT 周期计数器:F103 的 Cortex-M3 有,用来做毫秒时间戳(不需要额外中断)。 */
|
|
230
|
+
CoreDebug->DEMCR |= CoreDebug_DEMCR_TRCENA_Msk;
|
|
231
|
+
DWT->CYCCNT = 0u;
|
|
232
|
+
DWT->CTRL |= DWT_CTRL_CYCCNTENA_Msk;
|
|
233
|
+
s_cycles_per_ms = (uint32_t)(SystemCoreClock / 1000u);
|
|
234
|
+
#endif
|
|
235
|
+
|
|
236
|
+
s_dropped = 0u;
|
|
237
|
+
s_initialized = 1u;
|
|
238
|
+
|
|
239
|
+
/* ID 最后写:看到 "SEGGER RTT" 时通道描述符一定已经就绪。 */
|
|
240
|
+
memcpy(_SEGGER_RTT.acID, RTT_ID_TEXT, sizeof(RTT_ID_TEXT));
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
void rtt_init(void)
|
|
244
|
+
{
|
|
245
|
+
uint32_t token = rtt_lock();
|
|
246
|
+
|
|
247
|
+
rtt_init_locked();
|
|
248
|
+
rtt_unlock(token);
|
|
249
|
+
}
|
|
250
|
+
|
|
251
|
+
__attribute__((weak)) uint64_t rtt_time_ms(void)
|
|
252
|
+
{
|
|
253
|
+
#if defined(RTT_HAVE_CMSIS)
|
|
254
|
+
static uint32_t s_last_cycles;
|
|
255
|
+
static uint64_t s_ms;
|
|
256
|
+
uint32_t now = DWT->CYCCNT;
|
|
257
|
+
uint32_t delta = now - s_last_cycles; /* 无符号相减,计数器回绕也对 */
|
|
258
|
+
|
|
259
|
+
s_last_cycles = now;
|
|
260
|
+
if (s_cycles_per_ms != 0u) {
|
|
261
|
+
s_ms += (uint64_t)(delta / s_cycles_per_ms); /* 不足 1 ms 的零头在这里丢掉 */
|
|
262
|
+
}
|
|
263
|
+
return s_ms;
|
|
264
|
+
#else
|
|
265
|
+
return 0u;
|
|
266
|
+
#endif
|
|
267
|
+
}
|
|
268
|
+
|
|
269
|
+
static void rtt_put_u32(uint8_t *dst, uint32_t value)
|
|
270
|
+
{
|
|
271
|
+
dst[0] = (uint8_t)(value & 0xFFu);
|
|
272
|
+
dst[1] = (uint8_t)((value >> 8) & 0xFFu);
|
|
273
|
+
dst[2] = (uint8_t)((value >> 16) & 0xFFu);
|
|
274
|
+
dst[3] = (uint8_t)((value >> 24) & 0xFFu);
|
|
275
|
+
}
|
|
276
|
+
|
|
277
|
+
static void rtt_put_u64(uint8_t *dst, uint64_t value)
|
|
278
|
+
{
|
|
279
|
+
uint32_t index;
|
|
280
|
+
|
|
281
|
+
for (index = 0u; index < 8u; index++) {
|
|
282
|
+
dst[index] = (uint8_t)((value >> (8u * index)) & 0xFFu);
|
|
283
|
+
}
|
|
284
|
+
}
|
|
285
|
+
|
|
286
|
+
uint32_t rtt_write(uint32_t level, const char *text)
|
|
287
|
+
{
|
|
288
|
+
uint8_t frame[RTT_FRAME_OVERHEAD + RTT_MSG_MAX];
|
|
289
|
+
uint32_t payload = 0u;
|
|
290
|
+
uint32_t total;
|
|
291
|
+
uint32_t token;
|
|
292
|
+
uint32_t result;
|
|
293
|
+
size_t length = 0u;
|
|
294
|
+
|
|
295
|
+
if (level < RTT_LEVEL_ERROR) {
|
|
296
|
+
level = RTT_LEVEL_ERROR;
|
|
297
|
+
}
|
|
298
|
+
if (level > RTT_LEVEL_DEBUG) {
|
|
299
|
+
level = RTT_LEVEL_DEBUG;
|
|
300
|
+
}
|
|
301
|
+
if (text != NULL) {
|
|
302
|
+
length = strlen(text);
|
|
303
|
+
if (length > (size_t)RTT_MSG_MAX) {
|
|
304
|
+
length = (size_t)RTT_MSG_MAX; /* 超长截断:保证 record 长度可预期 */
|
|
305
|
+
}
|
|
306
|
+
memcpy(&frame[RTT_FRAME_OVERHEAD], text, length);
|
|
307
|
+
payload = (uint32_t)length;
|
|
308
|
+
}
|
|
309
|
+
|
|
310
|
+
/* 组帧(长度/级别)在锁外做:strlen/memcpy 可能耗几十微秒,不该占着临界区。
|
|
311
|
+
* 时间戳和写环必须在锁内:rtt_time_ms() 自己有静态状态,WrOff 是读改写。 */
|
|
312
|
+
total = RTT_FRAME_OVERHEAD + payload;
|
|
313
|
+
rtt_put_u32(&frame[0], RTT_FRAME_MIN_BYTES + payload);
|
|
314
|
+
frame[4] = (uint8_t)level;
|
|
315
|
+
|
|
316
|
+
token = rtt_lock();
|
|
317
|
+
if (s_initialized == 0u) {
|
|
318
|
+
rtt_init_locked(); /* 忘了初始化也能用:第一条记录时补上(已在锁内,别再拿锁) */
|
|
319
|
+
}
|
|
320
|
+
rtt_put_u64(&frame[5], rtt_time_ms());
|
|
321
|
+
if (rtt_ring_write(&_SEGGER_RTT.aUp[0], frame, total) == 0u) {
|
|
322
|
+
s_dropped++;
|
|
323
|
+
result = 0u;
|
|
324
|
+
} else {
|
|
325
|
+
result = payload;
|
|
326
|
+
}
|
|
327
|
+
rtt_unlock(token);
|
|
328
|
+
return result;
|
|
329
|
+
}
|
|
330
|
+
|
|
331
|
+
#if defined(RTT_HAVE_STDIO)
|
|
332
|
+
/*
|
|
333
|
+
* vsnprintf 会牵进 newlib 的 _sbrk(堆延伸)。寄存器版模板不带 syscalls.c,
|
|
334
|
+
* 缺了它会链接失败:undefined reference to `_sbrk'。
|
|
335
|
+
* 这里给一份**弱符号**兜底:失败返回,等于"没有堆"。你自己的 syscalls.c 里
|
|
336
|
+
* 那份强符号会自动覆盖它,malloc 照旧能用(HAL 骨架就带 Core/Src/syscalls.c)。
|
|
337
|
+
*/
|
|
338
|
+
__attribute__((weak)) void *_sbrk(ptrdiff_t increment)
|
|
339
|
+
{
|
|
340
|
+
(void)increment;
|
|
341
|
+
return (void *)-1;
|
|
342
|
+
}
|
|
343
|
+
#endif
|
|
344
|
+
|
|
345
|
+
uint32_t rtt_printf(uint32_t level, const char *fmt, ...)
|
|
346
|
+
{
|
|
347
|
+
#if defined(RTT_HAVE_STDIO)
|
|
348
|
+
char message[RTT_MSG_MAX + 1u];
|
|
349
|
+
va_list args;
|
|
350
|
+
int written;
|
|
351
|
+
|
|
352
|
+
if (fmt == NULL) {
|
|
353
|
+
return 0u;
|
|
354
|
+
}
|
|
355
|
+
va_start(args, fmt);
|
|
356
|
+
written = vsnprintf(message, sizeof(message), fmt, args);
|
|
357
|
+
va_end(args);
|
|
358
|
+
if (written < 0) {
|
|
359
|
+
return 0u;
|
|
360
|
+
}
|
|
361
|
+
/* vsnprintf 会截断并保证结尾 0;rtt_write 再按 RTT_MSG_MAX 兜一次。 */
|
|
362
|
+
return rtt_write(level, message);
|
|
363
|
+
#else
|
|
364
|
+
(void)level;
|
|
365
|
+
(void)fmt;
|
|
366
|
+
return 0u;
|
|
367
|
+
#endif
|
|
368
|
+
}
|
|
369
|
+
|
|
370
|
+
uint32_t rtt_dropped_count(void)
|
|
371
|
+
{
|
|
372
|
+
return s_dropped;
|
|
373
|
+
}
|
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
# RTT(Real Time Transfer)在 HAL 工程里怎么加
|
|
2
|
+
|
|
3
|
+
这份文件是**说明**,不是代码:HAL 工程由 CubeMX 生成,`Core/**` 是生成区,
|
|
4
|
+
往里放自己的 `.c` 会被下次 `stm32_generate` 覆盖,也违反"只改 USER CODE"的红线。
|
|
5
|
+
所以 RTT 在你自己的目录里(默认 `App/`),只通过 `cmake/user/CMakeLists.txt` 挂进构建。
|
|
6
|
+
|
|
7
|
+
寄存器版工程(`stm32_project_create route=register`)**自带** `Core/Src/rtt.c` 与
|
|
8
|
+
`Core/Inc/rtt.h`,那边不需要这个文件;本文件只讲 HAL 版。
|
|
9
|
+
|
|
10
|
+
需要的两个源文件在插件的 `templates/register/Core/Src/rtt.c` 与
|
|
11
|
+
`templates/register/Core/Inc/rtt.h`(实现是同一份:SEGGER 兼容控制块 + 通道 0 的
|
|
12
|
+
`[4B 长度 LE][1B 级别][8B 时间戳 ms LE][UTF-8 payload]` 帧)。
|
|
13
|
+
|
|
14
|
+
## 三步
|
|
15
|
+
|
|
16
|
+
1) 拷文件(在工程根目录执行):
|
|
17
|
+
|
|
18
|
+
```bash
|
|
19
|
+
mkdir -p App
|
|
20
|
+
cp <插件目录>/templates/register/Core/Src/rtt.c App/rtt.c
|
|
21
|
+
cp <插件目录>/templates/register/Core/Inc/rtt.h App/rtt.h
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
2) 挂进构建——编辑 `cmake/user/CMakeLists.txt`(CubeMX 不生成这个文件的内容):
|
|
25
|
+
|
|
26
|
+
```cmake
|
|
27
|
+
target_sources(${CMAKE_PROJECT_NAME} PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/../../App/rtt.c)
|
|
28
|
+
target_include_directories(${CMAKE_PROJECT_NAME} PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/../../App)
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
3) 在 `Core/Src/main.c` 里只碰 USER CODE 块:
|
|
32
|
+
|
|
33
|
+
```c
|
|
34
|
+
/* USER CODE BEGIN Includes */
|
|
35
|
+
#include "rtt.h"
|
|
36
|
+
/* USER CODE END Includes */
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
```c
|
|
40
|
+
/* USER CODE BEGIN 2 */
|
|
41
|
+
rtt_init(); /* 必须在 SystemClock_Config() 之后:时间戳用 DWT 周期计数器按 SystemCoreClock 换算 */
|
|
42
|
+
rtt_printf(RTT_LEVEL_INFO, "boot: sysclk=%lu Hz", (unsigned long)SystemCoreClock);
|
|
43
|
+
/* USER CODE END 2 */
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
主循环里同理,写在 `USER CODE BEGIN WHILE` 与 `USER CODE END WHILE` 之间。
|
|
47
|
+
|
|
48
|
+
## 宿主侧怎么读
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
arm-none-eabi-nm build/<preset>/<工程名>.elf | findstr _SEGGER_RTT # 控制块地址
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
```
|
|
55
|
+
stm32_rtt action=start addr=0x2000xxxx # openocd: rtt setup <addr> 0x400 / rtt start / rtt server start <port> 0
|
|
56
|
+
stm32_rtt action=dump seconds=3 level=3 # 打印 {t, level, text},level 是"保留到哪一级"的上限
|
|
57
|
+
stm32_rtt action=stop
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
`addr` 别写死:控制块是普通 `.bss` 变量,加一行代码重链接就会漂移,每次 `nm` 一遍。
|
|
61
|
+
|
|
62
|
+
## 代价与限制
|
|
63
|
+
|
|
64
|
+
- 默认 `RTT_UP_CHANNELS=3`、`RTT_BUF_SIZE=1024` → **3 KB RAM**(.bss);
|
|
65
|
+
`RTT_MSG_MAX=120` 是单条 payload 上限。RAM 紧就改 `rtt.h` 的这两个宏(例如 1 个通道 512 字节)。
|
|
66
|
+
- 工具链开了 `--gc-sections`:不调用 `rtt_init()` 时 `rtt.c` 的代码和那块缓冲会被链接器丢掉,不占 RAM/Flash。
|
|
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 优先级不会改变丢不丢)。
|
|
71
|
+
- 时间戳默认用 DWT 周期计数器;已经有 `HAL_GetTick()` 的话覆盖弱符号更省事:
|
|
72
|
+
|
|
73
|
+
```c
|
|
74
|
+
uint64_t rtt_time_ms(void) { return (uint64_t)HAL_GetTick(); }
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
- 主循环和中断都能写:`rtt_write()` 内部已经过临界区(`rtt_lock()`/`rtt_unlock()` 弱符号,默认存/恢复 PRIMASK),**不需要自己在外面关中断**。
|
|
78
|
+
- 用 RTOS 时覆盖这两个弱符号即可(`rtt.h` 头注释里有 FreeRTOS 例子):拿 mutex 包住 + 里面再关中断,裸机和 RTOS 就都能用了。
|
|
79
|
+
- `rtt_printf()` 用 newlib 的 `vsnprintf`,会牵进 `_sbrk`。HAL 工程本来就带 `Core/Src/syscalls.c`,不用管;
|
|
80
|
+
寄存器版没有 syscalls.c,所以 `rtt.c` 里给了一份**弱符号** `_sbrk` 兜底(直接失败,等于没有堆),
|
|
81
|
+
你自己实现 `_sbrk` 时那份强符号会自动覆盖它。只想要零依赖就用 `rtt_write(level, "已经格式化好的串")`。
|
|
82
|
+
|
|
83
|
+
## 报错对照
|
|
84
|
+
|
|
85
|
+
| `stm32_rtt` 报什么 | 说明 |
|
|
86
|
+
|---|---|
|
|
87
|
+
| 控制块是空的(读到全 0) | 没调用 `rtt_init()`,或者固件停/reset 过还没跑到初始化那一行 |
|
|
88
|
+
| 魔数不符(不是 "SEGGER RTT") | `addr` 指错了地址;用 `nm` 重新拿 |
|
|
89
|
+
| 连不上 RTT 通道 / 连接超时 | `rtt server start` 没起来(目标没跑起来、openocd 会话掉了),或端口被别的进程占了 |
|
|
90
|
+
| 端口占用 | `rttPort` 换一个(默认 9090) |
|
|
@@ -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
|
|
@@ -2,3 +2,10 @@
|
|
|
2
2
|
# 例:
|
|
3
3
|
# target_sources(${CMAKE_PROJECT_NAME} PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/../../App/app.c)
|
|
4
4
|
# target_include_directories(stm32cubemx INTERFACE ${CMAKE_CURRENT_SOURCE_DIR}/../../App)
|
|
5
|
+
#
|
|
6
|
+
# RTT(可选,步骤见工程根目录的 RTT.md):把插件的 templates/register/Core/{Src/rtt.c,Inc/rtt.h}
|
|
7
|
+
# 拷到 App/,然后:
|
|
8
|
+
# target_sources(${CMAKE_PROJECT_NAME} PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/../../App/rtt.c)
|
|
9
|
+
# target_include_directories(${CMAKE_PROJECT_NAME} PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/../../App)
|
|
10
|
+
# 再到 Core/Src/main.c 的 USER CODE BEGIN Includes 加 #include "rtt.h"、
|
|
11
|
+
# USER CODE BEGIN 2 加 rtt_init()。别把 rtt.c 放进 Core/Src:那是 CubeMX 生成区。
|
|
@@ -1,7 +1,9 @@
|
|
|
1
|
-
# CMSIS-DAP 探针 + SWD。stm32_project_create
|
|
2
|
-
# interface/stlink.cfg
|
|
3
|
-
# transport 必须写 swd:hla_swd 只有 st-link
|
|
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
|
-
"
|
|
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
|
-
"
|
|
38
|
-
"target/stm32f1x.cfg"
|
|
42
|
+
"${workspaceFolder}/openocd.cfg"
|
|
39
43
|
],
|
|
40
44
|
// 想看外设寄存器(可选):自己加一行 "svdPath": "<对应芯片的 .svd 绝对路径>"。
|
|
41
45
|
// 不给也能调试,只是没有外设寄存器视图;插件不替你选 SVD。
|