init
This commit is contained in:
kirl committed
commit
a1cbf4a3c3
11 files changed
+460
No files matched your search
@@ -0,0 +1,173 @@
|
||||
# MSPM0G3507 LED Blink
|
||||
|
||||
基于 TI MSPM0G3507 的 LED 闪烁项目，纯命令行工具链（ARM GCC + CMake + Ninja + pyOCD），不依赖任何 IDE。
|
||||
|
||||
## 硬件
|
||||
|
||||
| 项目 | 说明 |
|
||||
|------|------|
|
||||
| 芯片 | MSPM0G3507 (Cortex-M0+, 80MHz, 128KB Flash / 32KB SRAM) |
|
||||
| 调试器 | 通用 DAPLink / CMSIS-DAP |
|
||||
| LED | PB9，低有效（低电平点亮） |
|
||||
|
||||
## 开发环境
|
||||
|
||||
| 工具 | 版本 | 用途 |
|
||||
|------|------|------|
|
||||
| arm-none-eabi-gcc | 15.2+ | 交叉编译器 |
|
||||
| CMake | 3.20+ | 构建系统 |
|
||||
| Ninja | 1.10+ | 构建后端 |
|
||||
| Python | 3.10+ | pyOCD 运行环境 |
|
||||
| pyOCD | 0.45+ | 烧录与调试 |
|
||||
| SysConfig | 1.28+ | 引脚/时钟配置生成 |
|
||||
| clangd | 18+ | LSP 语言服务器 (IntelliSense) |
|
||||
| MSPM0 SDK | 2.11+ | 驱动库与启动文件 |
|
||||
|
||||
### 快速安装
|
||||
|
||||
```powershell
|
||||
# pyOCD（含 MSPM0 Flash 算法）
|
||||
pip install pyocd
|
||||
python -m pyocd pack install MSPM0G3507
|
||||
```
|
||||
|
||||
MSPM0 SDK 和 SysConfig 需从 [TI 官网](https://www.ti.com/tool/MSPM0-SDK) 下载安装。
|
||||
|
||||
## 构建
|
||||
|
||||
```powershell
|
||||
# 配置（首次或 CMakeLists.txt 变更后）
|
||||
# PowerShell 中 .cmake 需引号包裹，否则会被拆开
|
||||
cmake -G Ninja -S . -B build "-DCMAKE_TOOLCHAIN_FILE=gcc-arm-none-eabi.cmake" -DCMAKE_EXPORT_COMPILE_COMMANDS=ON
|
||||
|
||||
# 编译
|
||||
ninja -C build
|
||||
|
||||
# 或 cd 进 build 目录后直接
|
||||
cd build
|
||||
ninja
|
||||
```
|
||||
|
||||
### LSP / IntelliSense (clangd)
|
||||
|
||||
项目根目录已配置 `.clangd`，指向 `build/compile_commands.json`。
|
||||
安装 VS Code 扩展 **clangd**（LLVM 官方）并**禁用** Microsoft C/C++ IntelliSense 即可使用。
|
||||
|
||||
## 烧录
|
||||
|
||||
一条命令搞定（自动连接、擦除、写入、校验、断开）：
|
||||
|
||||
```powershell
|
||||
python -m pyocd flash -t mspm0g3507 build/blink.elf
|
||||
```
|
||||
|
||||
输出示例：
|
||||
|
||||
```
|
||||
Erased 1024 bytes (1 sector), programmed 1024 bytes (1 page)
|
||||
```
|
||||
|
||||
## 调试（GDB）
|
||||
|
||||
需要两个终端协作，**先启动服务器再连 GDB**：
|
||||
|
||||
```powershell
|
||||
# 终端 1：启动 GDB 服务器（保持运行）
|
||||
# DAPLink 克隆版建议降频避免通信错误
|
||||
python -m pyocd gdbserver -t mspm0g3507 -f 500000
|
||||
|
||||
# 等看到 "GDB server listening on port 3333" 后，
|
||||
|
||||
# 终端 2：启动 GDB
|
||||
arm-none-eabi-gdb build/blink.elf
|
||||
```
|
||||
|
||||
GDB 内手动连接：
|
||||
|
||||
```gdb
|
||||
target remote :3333 # 连接 pyOCD 服务器
|
||||
load # 烧录固件
|
||||
monitor reset # 复位芯片
|
||||
continue # 开始运行
|
||||
```
|
||||
|
||||
常用命令：
|
||||
|
||||
```gdb
|
||||
# ── 断点 ──────────────────────────
|
||||
break main # main 函数入口断点
|
||||
break src/main.c:20 # 文件行号断点
|
||||
info breakpoints # 列出所有断点
|
||||
delete 1 # 删除 1 号断点
|
||||
|
||||
# ── 运行 ──────────────────────────
|
||||
monitor reset # 复位芯片
|
||||
continue (缩写 c) # 继续运行
|
||||
step (缩写 s) # 单步进入函数
|
||||
next (缩写 n) # 单步跳过函数
|
||||
finish (缩写 fin) # 执行到当前函数返回
|
||||
|
||||
# ── 查看 ──────────────────────────
|
||||
print DELAY # 查看变量/宏
|
||||
print/x GPIO_LED_LED_PIN # 十六进制查看
|
||||
backtrace (缩写 bt) # 调用栈
|
||||
info registers # 寄存器
|
||||
|
||||
# ── 退出 ──────────────────────────
|
||||
quit # 退出 GDB
|
||||
```
|
||||
|
||||
### 典型调试流程
|
||||
|
||||
```gdb
|
||||
target remote :3333
|
||||
load
|
||||
break main
|
||||
monitor reset
|
||||
continue
|
||||
# → 停在 main 第一行
|
||||
|
||||
next # 执行 SYSCFG_DL_init()
|
||||
next # 进入 while(1)
|
||||
print cycle # 检查 cycle 值
|
||||
continue # LED 开始闪
|
||||
|
||||
# 按 Ctrl+C 暂停
|
||||
break src/main.c:20 # 在看 CLEAR 还是 SET 的地方断
|
||||
continue # 停在断点
|
||||
next # 单步看 LED ON/OFF
|
||||
```
|
||||
|
||||
## VS Code
|
||||
|
||||
安装 [Cortex-Debug](https://marketplace.visualstudio.com/items?itemName=marus25.cortex-debug) 扩展后：
|
||||
|
||||
| 操作 | 按键 |
|
||||
|------|:--:|
|
||||
| 编译 | `Ctrl+Shift+B` |
|
||||
| 编译 + 烧录 | `Ctrl+Shift+P` → `Run Task` → **Build & Flash** |
|
||||
| 调试 | `F5`（自动启动 pyOCD → 烧录 → 停在 `main`） |
|
||||
|
||||
断点、单步、变量查看全在图形界面操作。首次 `F5` 会启动 pyOCD，之后每次自动复用已有服务器。
|
||||
|
||||
## 项目结构
|
||||
|
||||
```
|
||||
blink/
|
||||
├── .vscode/ # VS Code 配置 (纳入 Git)
|
||||
│ ├── settings.json # CMake 工具链配置
|
||||
│ ├── launch.json # Cortex-Debug F5 调试
|
||||
│ └── tasks.json # Ctrl+Shift+B 编译 / Build & Flash
|
||||
├── .clangd # clangd IntelliSense 配置
|
||||
├── .gitignore
|
||||
├── CMakeLists.txt # CMake 构建配置
|
||||
├── gcc-arm-none-eabi.cmake # ARM 交叉编译工具链
|
||||
├── blink.syscfg # SysConfig 引脚/时钟配置
|
||||
├── start_pyocd.ps1 # pyOCD 服务器自动启动脚本
|
||||
├── src/
|
||||
│ └── main.c # 应用代码
|
||||
├── include/ # 应用头文件
|
||||
├── lib/ # 第三方库
|
||||
└── build/ # 构建产物 (gitignore)
|
||||
└── blink.elf # 固件
|
||||
```
|
||||
Reference in new issue
Block a user