Metadata-Version: 2.4
Name: gd32-probe
Version: 1.0.0
Summary: GD32F303 专业调试终端 PRO — 人机+AI 共用，对标 Keil 仿真
Author-email: chenyuewei <228558959@qq.com>
License: MIT
Keywords: gd32,cortex-m,debugger,dap-link,embedded,tui
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Debuggers
Classifier: Topic :: Software Development :: Embedded Systems
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: textual>=0.40.0
Requires-Dist: pyocd>=0.36.0
Requires-Dist: pyelftools>=0.30

# gd32-probe — GD32F303 调试终端 PRO

人机 + AI 智能体共用调试控制台，对标 Keil 仿真功能。

## 功能

- 📋 **RTT 日志** — 高速双向日志，不占用串口
- 📊 **外设寄存器** — 7 类外设 + SCB，位域解码，变更高亮
- 💾 **内存浏览器** — Hex/ASCII 双栏，地址跳转
- 👁 **变量监视** — ELF 符号自动解析，实时刷新
- 🧠 **CPU 核心** — 暂停/运行/单步/复位，HardFault 栈解析
- ● **硬件断点/观察点** — 读写监控
- 📡 **SWO 高速日志** — 串行线输出
- 🔥 **烧录** — ELF/HEX/BIN 一键烧录
- 🤖 **AI 指令接口** — JSON 文件驱动，Agent 可自动调用

## 安装

```bash
pip install gd32-probe
```

## 启动

```bash
gd32-debug
```

## 依赖

- Python >= 3.10
- DAPLink / CMSIS-DAP 调试器
- GD32F303 目标板

## 命令速查

| 命令 | 说明 |
|------|------|
| `reg can0` | CAN0 寄存器 + 位域 |
| `peek 0x20004000 16` | 读内存 |
| `var g_freq_hz` | 读 ELF 变量 |
| `bp add 0x0800A145` | 硬件断点 |
| `flash` | 烧录 ELF |
| `Ctrl+R` | 复位 MCU |
| `F5` | 运行 |
| `F10` | 单步 |

## License

MIT
