EK-OmniProbe

一个开源的嵌入式开发五合一工具，集成固件烧录、源码级调试、RTT 实时输出、串口终端和BLE 蓝牙功能。基于 Tauri + React + Rust 技术栈开发，使用 probe-rs 作为底层调试库。

项目维护 此前由左岚独立开发，现已移交至 EmbeddedKit Organization，由左岚作为主要成员继续维护。

🔗 作者与项目

作者：左岚
作者 Bilibili：https://space.bilibili.com/27619688
项目 GitHub：https://github.com/EmbeddedKitOrg/EK-OmniProbe

👥 贡献者

左岚
_{功能规划与整体代码书写优化
全功能实现与 Windows 调试
Bilibili}

N1netyNine99
_{功能规划与代码优化
Linux 端调试与报错信息修复}

✨ 核心特性

五种工作模式

🔥 烧录模式 - 专业的固件烧录工具

支持 ELF/HEX/BIN/AXF/OUT/IHEX 格式固件烧录
全片擦除、扇区擦除、Flash 读取、校验功能
支持从 CMSIS-Pack 导入自定义 Flash 算法
自定义 ROM 地址配置（Keil 风格）
实时进度显示和详细日志

📟 RTT 调试模式 - 高速实时调试输出

通过 SWD/JTAG 直接读取目标内存，无需额外串口
实时数据图表可视化（波形示波器、FFT、折线图、柱状图、散点图、XY 散点图）
图表工作台采用“主图 + 右侧字段栏 + 下方控制条”结构，便于一边看波形一边管理字段
图表工作台支持弹出为独立窗口，主窗口继续保留日志/终端工作流
智能配置：一键检测数据格式（单数值/XY/CSV/JSON）
ANSI 颜色支持和自定义颜色标记
多通道支持、关键字搜索、数据导出

🐞 调试模式 - 源码级 Cortex-M 调试器（参考 J-Link Ozone）

Attach / Detach、Run / Halt / Reset、单步 In / Over / Out 完整执行控制
加载 ELF 后用 object + addr2line + gimli 解析符号表与 DWARF 行表，PC↔(file:line) 双向映射
9 块面板可自由 dock / 浮动 / 合并 tab：Symbols（虚拟滚动）、Source（CodeMirror 6 + lang-cpp + 断点 gutter + PC 箭头）、Registers、Locals（全局变量 hex）、Watch（符号名 / 地址 / name:N 表达式，localStorage 持久化）、Memory、Call Stack（PC + LR 两帧）、Breakpoints、Output
顶部「视图」下拉（Keil 风格）任意显隐面板 + 一键重置布局
硬断点支持：源码 gutter 点击 toggle / 按地址添加；命中后 ~300ms 自动停机并刷新所有面板
源码断点 per-ELF localStorage 持久化，下次 attach 同一 ELF 自动恢复

🔌 串口终端模式 - 多功能串口工具

支持本地串口（COM 口）和 TCP 远程串口（ser2net、ESP-Link）
同时提供日志视图和终端视图，支持收发分屏、文本/HEX 切换
复用 RTT 的颜色解析、波形示波器和 FFT 频谱功能
发送历史记录、终端本地回显和常用控制键快捷发送
日志三档复制：Ctrl+C 纯文本 / Ctrl+Shift+C 含时间戳和方向 / 右键弹菜单临时切换
完整串口参数配置（波特率、数据位、停止位、校验位、流控制）

📶 蓝牙模式 - 跨平台 BLE 调试工具 + 经典蓝牙 SPP 入口

BLE 中央设备：扫描附近设备、查看 RSSI、点击连接，自动识别 Nordic UART Service（NUS）一键定位 RX/TX 特征值
手动浏览所有 GATT 服务，按属性（Read / Write / Notify / Indicate）选择 Notify 与 Write 特征值
订阅 notify 后字节流复用现有解析链：颜色标记、波形示波器、FFT、CSV/JSON 字段拆分
支持文本 / HEX 两种发送模式，可配置编码、换行符与是否需要响应（Write / Write Without Response）
经典蓝牙 SPP：列出系统已配对的蓝牙虚拟 COM，一键跳转到串口模式直接复用收发分屏、终端、波形、发送历史等全部能力
与烧录、RTT、串口完全独立，无须探针即可使用

探针和接口支持

探针类型：CMSIS-DAP（DAPv1 HID / DAPv2 WinUSB）
- 自动识别并显示 DAP 版本标记
- 理论上支持 probe-rs 兼容的其他探针（J-Link、ST-Link 等），但未经测试
调试接口：SWD / JTAG
时钟速度：100kHz - 10MHz（默认 1MHz）
连接模式：正常模式 / 复位下连接
复位方式：软件复位 / 硬件复位

智能管理功能

自动断开连接：可配置无操作自动断开（5-300 秒），RTT 运行时自动禁用
实时状态显示：连接状态、芯片信息、DAP 版本、数据统计
完整日志系统：操作日志记录，支持不同级别（info/warn/error/success）
MD3 风格界面：Material Design 3 风格分层表面、柔和阴影与模式切换动画
多配色主题：内置多套可切换主题方案，支持 Default、Sakura Pink、Ocean Blue、Forest Green、Twilight Violet、Amber Orange 等
设置中心：顶部统一收口主题配色、更新入口、启动工作台、RTT/串口默认视图、默认波形域和日志面板高度
关于作者入口：顶部提供“关于作者”按钮，可直接查看左岚信息、Bilibili 和项目 GitHub
应用自动更新：启动时检查更新，支持自动下载和安装

🎯 支持的芯片

probe-rs 原生支持（内置）

以下芯片由 probe-rs 原生支持，无需导入 Pack 即可使用：

厂商	系列	数量	说明
ST	STM32F0/F1/F2/F3/F4	80+	完整支持
ST	STM32G0/G4	15+	完整支持
ST	STM32L0/L4	20+	完整支持
兆易创新	GD32F0/F1/F2/F3/F4	30+	完整支持
兆易创新	GD32E, GD32L	10+	完整支持
武汉芯源	CW32F003/F030/F103	5+	完整支持
武汉芯源	CW32L031/L052	3+	完整支持
Nordic	nRF51822, nRF52832/52833/52840	6+	完整支持
Raspberry Pi	RP2040	1	完整支持
Espressif	ESP32-C3/C6/S3	3	完整支持

详细型号列表

STM32 系列（点击展开）

STM32F0：F030, F031, F042 系列
STM32F1：F100, F101, F103 全系列（C/R/V/Z 封装）
STM32F2：F205 全系列
STM32F3：F301, F302 系列
STM32F4：F401, F405, F407, F411 系列
STM32G0：G030, G031 全系列
STM32G4：G431 全系列
STM32L0：L010, L011 系列
STM32L4：L412, L431 系列

GD32 系列（点击展开）

GD32F0：GD32F150, GD32F190
GD32F1：GD32F103（兼容 STM32F1）
GD32F2：GD32F205, GD32F207
GD32F3：GD32F303, GD32F305, GD32F307
GD32F4：GD32F405, GD32F407, GD32F450
GD32E：GD32E103, GD32E230
GD32L：GD32L233（低功耗系列）

⚠️ 注意：GD32F470 系列虽在内置列表中，但需要导入对应的 CMSIS-Pack 才能完整使用 Flash 算法。

CW32 系列（点击展开）

CW32F0：CW32F003, CW32F030
CW32F1：CW32F103
CW32L：CW32L031, CW32L052（低功耗系列）

扩展支持（需要导入 Pack）

对于以下情况，需要导入 Keil CMSIS-Pack：

不在内置列表中的芯片：如 STM32H7、STM32U5、GD32F470 等新系列
需要特殊 Flash 算法的芯片：某些芯片的 Flash 算法需要从 Pack 中提取
厂商定制芯片：各厂商的定制型号或特殊系列

如何导入 Pack

从 Keil 官网下载所需芯片的 Pack 文件（.pack）
在侧边栏找到"CMSIS-Pack 管理"卡片
点击"导入 Pack"按钮或直接拖放 .pack 文件
导入成功后，芯片列表将包含 Pack 中的所有设备

Pack 管理功能：

显示 Pack 详细信息（厂商、版本、设备数）
支持批量导入多个 Pack
自动提取 Flash 算法并集成到 probe-rs
生成扫描报告，显示算法覆盖情况

🛠️ 技术栈

前端

框架：React 18 + TypeScript
样式：Tailwind CSS
状态管理：Zustand
UI 组件：Radix UI + Lucide Icons
图表层：Recharts + 自定义 Canvas 波形引擎
布局：react-resizable-panels

后端

框架：Tauri 2.0
语言：Rust
调试库：probe-rs 0.31
串口库：serialport 4.3
异步运行时：tokio
Pack 解析：quick-xml + zip

📁 项目结构

EK-OmniProbe/
├── src/                          # React 前端源码
│   ├── components/               # UI 组件
│   │   ├── layout/              # 布局组件（TopBar, Sidebar, ModeSwitch）
│   │   ├── modes/               # 模式组件
│   │   │   ├── flash/           # 烧录模式组件
│   │   │   ├── RttMode.tsx      # RTT 模式
│   │   │   ├── SerialMode.tsx   # 串口模式
│   │   │   └── BluetoothMode.tsx # 蓝牙 BLE 模式
│   │   ├── rtt/                 # RTT 组件（面板、查看器、波形/FFT 图表）
│   │   ├── serial/              # 串口组件（面板、查看器、发送栏）
│   │   ├── bluetooth/           # 蓝牙组件（面板、扫描列表、特征值选择、发送栏）
│   │   ├── log/                 # 日志面板
│   │   ├── config/              # 配置组件（PackManager）
│   │   └── ui/                  # 基础 UI 组件（shadcn/ui）
│   ├── stores/                  # Zustand 状态管理
│   │   ├── appStore.ts          # 应用模式状态
│   │   ├── probeStore.ts        # 探针状态
│   │   ├── chipStore.ts         # 芯片状态
│   │   ├── flashStore.ts        # 烧录状态
│   │   ├── rttStore.ts          # RTT 状态
│   │   ├── serialStore.ts       # 串口状态
│   │   ├── bluetoothStore.ts    # 蓝牙 BLE 状态
│   │   └── logStore.ts          # 日志状态
│   ├── hooks/                   # React Hooks
│   │   ├── useRttEvents.ts      # RTT 事件监听
│   │   ├── useSerialEvents.ts   # 串口事件监听
│   │   ├── useBluetoothEvents.ts # 蓝牙事件监听
│   │   └── useUserActivity.ts   # 用户活动检测
│   ├── lib/                     # 工具库和类型定义
│   │   ├── rttColorParser.ts    # RTT 颜色解析引擎
│   │   ├── chartAutoConfig.ts   # 图表智能配置
│   │   └── types.ts             # TypeScript 类型定义
│   ├── App.tsx                  # 主应用组件
│   └── main.tsx                 # 入口文件
├── src-tauri/                   # Rust 后端源码
│   ├── src/
│   │   ├── commands/            # Tauri 命令
│   │   │   ├── probe.rs         # 探针管理
│   │   │   ├── flash.rs         # 烧录操作
│   │   │   ├── memory.rs        # 内存操作
│   │   │   ├── rtt.rs           # RTT 调试
│   │   │   ├── serial.rs        # 串口操作
│   │   │   ├── ble.rs           # BLE 蓝牙操作
│   │   │   └── config.rs        # 芯片配置
│   │   ├── serial/              # 串口模块
│   │   │   ├── mod.rs           # DataSource trait 定义
│   │   │   ├── local.rs         # 本地串口实现
│   │   │   └── tcp.rs           # TCP 串口实现
│   │   ├── ble/                 # BLE 蓝牙模块（基于 btleplug）
│   │   │   └── mod.rs           # BLE 状态、扫描、连接、订阅
│   │   ├── pack/                # CMSIS-Pack 处理
│   │   │   ├── manager.rs       # Pack 管理器
│   │   │   ├── parser.rs        # PDSC 解析器
│   │   │   └── flash_algo.rs    # Flash 算法提取
│   │   ├── state.rs             # 应用状态管理
│   │   ├── error.rs             # 错误定义
│   │   └── lib.rs               # 库入口
│   ├── Cargo.toml               # Rust 依赖
│   └── tauri.conf.json          # Tauri 配置
├── RTTBSP/                      # SEGGER RTT 库文件（可直接复制到工程）
│   ├── SEGGER_RTT.c
│   ├── SEGGER_RTT.h
│   ├── SEGGER_RTT_Conf.h
│   └── SEGGER_RTT_printf.c
├── examples/                    # 目标固件示例工程
│   └── gd32-rtt/                # STM32F407 / GD32F407 + Keil 的 RTT 示例
├── docs/                        # 用户文档
│   ├── README.md                # 文档索引
│   ├── RTT_USER_MANUAL.md       # RTT 用户手册
│   ├── RTT_CHART_GUIDE.md       # RTT 图表功能指南
│   └── RTT_XY_SCATTER_GUIDE.md  # XY 散点图指南
├── packs/                       # 用户导入的 Pack 存放目录
├── package.json                 # Node.js 依赖
├── README.md                    # 本文件
├── CHANGELOG.md                 # 更新日志
└── CLAUDE.md                    # 项目开发规范

🚀 开发环境搭建

前置要求

Node.js 18+
Rust 1.70+
pnpm（推荐）或 npm

安装依赖

# 安装前端依赖
pnpm install

# Rust 依赖会在首次构建时自动安装

开发模式运行

pnpm tauri dev

Windows PowerShell 也可以直接运行：

.\dev.ps1

.\dev.ps1 会自动探测一组可用的前端开发端口；如果默认端口被系统保留或已被占用，会继续往后尝试，不需要手动改 vite / tauri 配置。

可选参数：

-NoInstall：跳过依赖安装检查
其余参数会透传给 tauri dev

推送前本地检查

如果你想在推送前先跑一遍接近 CI 的本地检查，可以直接执行：

.\check.ps1

默认会执行：

pnpm install --frozen-lockfile --ignore-scripts（依赖一致性检查）
pnpm exec tsc --noEmit
pnpm build
cargo check --manifest-path src-tauri/Cargo.toml

常用参数：

-NoInstall：跳过依赖安装检查
-ExpectedVersion 0.9.5：额外检查版本号、README 徽章和 CHANGELOG 条目是否一致
-ReleaseLike：额外执行一遍本机 Windows 目标的 tauri build，更接近正式发布流程

构建发布版本

pnpm tauri build

Windows PowerShell 也可以直接运行：

.\build.ps1

可选参数：

-NoInstall：跳过依赖安装检查
其余参数会透传给 tauri build

构建产物位于 src-tauri/target/release/bundle/ 目录：

nsis/ - Windows NSIS 安装包
msi/ - Windows MSI 安装包（可选）

Tauri 自动更新签名（可选）

tauri.conf.json 启用了 updater，build 时会额外生成签名 updater 包。build.ps1 按以下顺序定位私钥：

已设的 TAURI_SIGNING_PRIVATE_KEY 环境变量
项目根目录的 .tauri-signing.local.ps1（已加入 .gitignore，本地填密码）
自动探测 ~/.tauri/ek-omniprobe.key（兼容旧路径 ~/.tauri/zuolandaplink.key）

最简单的做法是复制样例文件并填入密码：

Copy-Item .tauri-signing.local.ps1.example .tauri-signing.local.ps1
# 编辑 .tauri-signing.local.ps1，把 your_password_here 换成你的 minisign 密码

如果没有配置签名，build.ps1 不会因签名步骤失败而报错——msi/nsis 安装包仍然会照常产出，只是不生成 updater 签名包。这种情况适合"只走 GitHub Release 手动下载"的发布方式。

📖 使用说明

快速开始

1. 连接探针

将 DAPLINK/CMSIS-DAP 探针连接到电脑 USB
点击"刷新"按钮检测探针
从下拉列表选择探针（会显示 DAP 版本：DAPv1 HID 或 DAPv2 WinUSB）

2. 选择目标芯片

在芯片搜索框输入芯片型号（如 STM32F103C8、GD32F103C8、CW32F030C8）
从搜索结果中选择正确的芯片
系统会自动加载芯片配置信息

3. 配置接口

接口类型：SWD（推荐）或 JTAG
时钟速度：默认 1MHz，可选 100kHz - 10MHz
连接模式：正常模式或复位下连接
复位方式：软件复位或硬件复位

4. 选择工作模式

使用顶部工具栏或快捷键切换模式：

Ctrl+1：烧录模式
Ctrl+2：RTT 模式
Ctrl+3：串口模式
Ctrl+4：蓝牙模式
Ctrl+L：清空当前模式数据
Ctrl+F：聚焦当前模式搜索框
Space：在 RTT 模式下暂停/恢复图表

烧录模式使用

点击"打开"按钮选择固件文件（支持 .bin/.hex/.elf/.axf/.out/.ihex）
点击"连接"按钮连接目标
点击"烧录"按钮开始烧录
等待烧录完成，查看日志确认结果

其他操作：

擦除：全片擦除或自定义范围擦除
校验：校验 Flash 内容与文件一致
读取：读取 Flash 内容到文件
复位：复位目标芯片

自定义 ROM 地址（Keil 风格）：

勾选"自定义 ROM 地址"复选框
配置 IROM1 起始地址（如 0x08000000）
配置 IROM1 大小（如 0x100000 = 1MB）
或点击"使用芯片默认值"按钮自动填充

RTT 模式使用

基础使用

连接探针和目标芯片
点击 RTT 面板的"启动"按钮
实时查看目标输出的日志
使用工具栏功能：
- 直接使用 波形 / FFT 快捷入口进入时域或频域分析
- 使用 仅文本 / 分屏 / 仅图表 切换主视图
- 搜索关键字
- 通过 更多 打开文本/HEX、自动滚动、图表配置、颜色设置和导出

图表可视化

RTT 支持实时数据图表，适合查看传感器数据、波形等：

支持的数据格式：

// 1. 单数值（波形示波器）
printf("%d\n", value);

// 2. XY 数据（XY 散点图）
printf("%d,%d\n", x, y);

// 3. CSV 格式（多系列波形）
printf("%.1f,%.1f,%.1f\n", temp, humi, press);

// 4. JSON 格式（多系列波形）
printf("{\"temp\":%.1f,\"humi\":%.1f}\n", temp, humi);

使用步骤：

启动 RTT 后点击 智能启用，或在工具栏 更多 中打开 图表配置
选择 波形示波器 或其他图表类型
也可以直接点击 RTT / 串口工具栏里的 波形 或 FFT 快捷入口
查看实时更新的图表
在右侧字段栏查看实时解析值，必要时把字段加入曲线并修改显示名称
在下方控制条调整缓冲区上限、可视点数和采样率
在波形模式下使用 Time / FFT 切换时域与频域
需要更大视野时，可将整个图表工作台弹出为独立窗口
使用缩放、拖动、悬停查看细节和统计信息

图表类型：

波形示波器：适合连续数值流，支持真实时间轴、缩放、拖拽和平移
FFT：复用波形数据做频谱分析，适合查看主频和谐波
折线图：适合一般业务趋势图
柱状图：适合离散数据对比
散点图：X 轴为索引
XY 散点图：真正的 XY 坐标，适合参数曲线、李萨如图形

详细使用方法请参考 RTT 用户手册 和 RTT 图表指南。

设置中心

顶部状态栏提供统一的 设置 入口，用来收口常用全局偏好：

切换界面配色主题
设置应用启动后默认进入的工作台
设置 RTT / 串口默认视图
设置 RTT / 串口波形默认观察域（Time / FFT）
调整并记住底部日志面板高度

如果你更常用 RTT 或串口，建议先在设置中心把默认工作台和默认视图配置好，这样每次启动都会更贴近自己的工作流。

详细说明请参考 设置中心使用指南。

目标固件要求

RTT 功能需要目标固件集成 SEGGER RTT 库。本项目已在 RTTBSP/ 目录提供所需文件，可直接复制到工程中使用。

💡 在 RTT 模式工具栏点击「接入指南」按钮，可以直接在应用内看到完整的代码示例与常见坑。一个开箱即用的最小工程见 examples/gd32-rtt/。

CMSIS-DAP 注意事项

使用 CMSIS-DAP/DAPLINK 探针时，RTT 读取需要暂停目标芯片才能安全访问内存。

影响：

RTT 读取时目标芯片会被短暂暂停（约 1-2ms），然后恢复运行
对于大多数应用没有明显影响
对于时序敏感的应用（如高速通信、精确定时），可能会有轻微影响

重要配置：

必须配置为非阻塞模式，否则缓冲区满时目标会卡死
轮询间隔默认 10ms，可根据需要调整

串口模式使用

连接串口

本地串口：

在侧边栏选择"本地串口"
从下拉列表选择 COM 口
配置串口参数（波特率、数据位、停止位、校验位、流控制）
点击"连接"按钮

TCP 远程串口：

在侧边栏选择"TCP 串口"
输入服务器地址和端口（如 192.168.1.100:23）
点击"连接"按钮

查看数据

日志 / 终端双视图：日志视图适合搜日志、分流和导出，终端视图适合持续命令交互
收发分屏：日志视图下可左侧显示接收（RX），右侧显示发送（TX）
显示模式：日志视图下可切换文本/HEX 模式
时间戳：显示/隐藏时间戳（精确到毫秒）
收发前缀：可选显示 RX / TX 前缀，方便在合并视图中快速区分方向
图表视图：复用 RTT 的波形示波器、FFT 和普通图表功能
分屏方向切换：RTT / 串口的文本与图表分屏支持上下或左右布局
图表快捷操作：支持暂停、清空数据、清除曲线和导出
图表工作台：右侧实时显示解析字段，可按需加入曲线并改名；下方可直接调缓冲区、可视点数和采样率
独立图表窗口：可将整个图表工作台弹出为额外窗口，适合双屏或需要更大绘图区的场景，并支持随时收回主界面
波形 / FFT 快捷入口：可直接从串口工具栏切入时域或频域分析
更多菜单：日志视图可集中配置收发分屏、时间戳、RX/TX 前缀、文本/HEX；终端视图可集中配置本地回显和控制键拦截

发送数据

日志视图下，可在底部发送栏输入数据
需要切换发送模式时，点击发送栏左侧 选项
在弹出面板中选择发送模式：
- 文本模式：支持 UTF-8/GBK 编码
- HEX 模式：输入十六进制（如 48 65 6C 6C 6F）
选择换行符：LF / CRLF / CR / None
点击"发送"按钮或按 Enter

发送历史：

自动保存最近 20 条发送记录
在发送栏 选项 面板里点击历史记录快速重发

终端视图补充：

点击终端区域后即可直接输入，不再依赖底部输入框
本地回显默认关闭；仅在设备不回显时再开启，避免字符双写
默认（直通模式）支持 Enter、方向键、Ctrl+C、Ctrl+D、Tab、Esc 和粘贴直发
行编辑模式：在工具栏「终端选项」开启后，键盘输入先在本地累积成一行（带 > 提示符），回车整行发送；↑/↓ 翻发送历史，Esc 清空，粘贴会进入缓冲而非立即发送。适合调命令时反复编辑的场景
复制选区：选中文字后 Ctrl+C 即复制（无选区时才发送 SIGINT），或 Ctrl+Shift+C 强制复制；Ctrl+Shift+V 强制粘贴
终端区会处理常见的 CR、LF 和退格回写，适合 MCU CLI、Bootloader 命令台和串口 shell

蓝牙模式使用

蓝牙模式提供两种工作方式，由左侧顶部「工作模式」卡片切换：

BLE：扫描、连接、订阅 Notify、写入特征值（默认）
经典蓝牙 SPP：列出系统已配对设备的虚拟 COM，一键跳转到串口模式

连接 BLE 设备

切换到蓝牙模式（顶栏「蓝牙」按钮或 Ctrl+4）。蓝牙模式不依赖调试探针。
在左侧「设备扫描」卡片点击「扫描」，等待 6 秒后会列出发现的设备（按是否有名称、信号强度排序）。
点击目标设备一项即可连接。连接成功后程序会自动发现 GATT 服务并优先尝试匹配 Nordic UART Service。

选择特征值

如果设备实现了 NUS：连接完成后 RX/TX 特征值会自动配置好，可直接点击「开始接收 (Notify)」。
否则在「特征值」卡片里浏览所有服务，按需点击：
- 作为 Notify：把当前特征值设为接收订阅源（仅支持 Notify / Indicate 的特征值可选）
- 作为 Write：把当前特征值设为发送目标（仅支持 Write / Write Without Response 的特征值可选）

接收与发送

点击「开始接收 (Notify)」后底部会持续刷新 BLE 数据；可在工具栏切换 仅文本 / 分屏 / 仅图表，或一键进入 波形 / FFT。
底部发送栏支持文本与 HEX，可在「选项」里切换编码、换行符以及「写入响应」（自动 / Write / Write Without Response）。
数据流复用 RTT / 串口的颜色解析、波形示波器与 FFT 工作台，同样可以解析 CSV / JSON 数值。

经典蓝牙 SPP

适合 HC-05/06、串口蓝牙模块、车载 OBD 等老设备。SPP 设备配对后操作系统会自动把它映射成虚拟 COM 口，因此 EK-OmniProbe 直接复用串口模式：

在系统蓝牙设置中和目标设备完成配对
在蓝牙模式左侧「工作模式」选择 经典蓝牙 SPP
「SPP 虚拟串口」卡片会自动列出所有蓝牙虚拟 COM；如果没列出请点「刷新」
点击目标端口右侧「连接」，应用会用当前串口默认参数连上并跳转到串口工作台

SPP 进入串口模式后，所有串口能力（终端 / 收发分屏 / HEX / 发送历史 / 波形 / FFT）都可直接使用。如需调整波特率，请先到串口模式调整再连。

平台说明

Windows 10 1809+ 直接使用系统 BLE 栈，无需驱动。
Linux 需要 BlueZ 5.x，普通用户进程即可扫描；权限不足时请按发行版指引把账户加入 bluetooth 组。SPP 设备需要先 rfcomm bind 才会出现 /dev/rfcommN。
macOS 需要在「系统设置 → 隐私与安全 → 蓝牙」中授予 EK-OmniProbe 蓝牙权限。

详细使用方法请参考 蓝牙用户手册。

自动断开配置（可选）

在侧边栏"自动断开"卡片中：

启用/禁用：点击按钮切换
超时时间：可选 5/10/30/60/120/300 秒
说明：无操作超时后自动断开连接，RTT 运行时不会断开

⚠️ 已知限制

ESP32 系列：需要特殊的烧录流程，当前支持有限
目标 IDCODE：受 probe-rs API 限制，无法直接读取（需通过 Keil 等工具查看）
CMSIS-DAP RTT：读取时需要暂停目标芯片（1-2ms），可能影响时序敏感应用
大数据量图表：图表数据点超过 1000 时建议使用采样
图表导出：仅支持 CSV 格式（图片导出待实现）
蓝牙模式：BLE 仅支持 Central 角色，不支持 PIN 配对绑定与自定义 MTU；SPP 走系统虚拟 COM 路由（不在应用内做配对，需先在系统蓝牙设置中配对）；macOS 首次扫描需在系统设置中给予蓝牙权限

🆕 更新日志

查看完整的更新日志请访问 CHANGELOG.md

v0.9.3 (2026-04-06)

新增与改进

✨ 关于作者弹窗 - 顶栏新增“关于作者”按钮，可在软件内查看左岚、Bilibili 和项目 GitHub 入口
✨ 串口终端视图 - 串口文本区新增“日志 / 终端”双视图，终端模式更适合 CLI 和 shell 式交互
🔧 串口方向前缀 - 串口终端支持显示 【RX】 / 【TX】 前缀，合并视图中更容易区分收发方向
🔧 开发脚本自动探测端口 - .\dev.ps1 会自动跳过被系统保留或占用的端口，并动态同步到 Vite / Tauri
🔧 本地检查脚本 - 新增 .\check.ps1，推送前可一键执行 TypeScript、前端构建与 Rust 检查
🔧 工作台继续紧凑化 - RTT / 串口首屏收口低频操作，把更多空间还给文本区和图表区

界面收口

🔧 工具栏低频操作收口 - RTT / 串口的自动滚动、文本 / HEX、图表配置、颜色设置和导出统一收进 更多
🔧 串口发送栏精简 - 发送历史和 HEX 切换移入 选项 弹出层，仅保留发送主操作
🔧 日志面板可折叠 - 工作台底部日志区支持一键折叠，默认高度进一步收紧

延续优化

🚀 自动端口排查更稳 - 即使默认端口不可用，开发模式也能继续往后寻找可用端口并启动
🚀 串口查看可读性增强 - 时间戳、方向前缀和正文按统一文本流排版，避免错位

v0.7.1 (2026-01-25)

新增功能

✨ Linux udev 权限管理 - 新增 udev 规则文件和自动安装脚本，解决 Linux 下探针权限问题
✨ 应用配置模块 - 新增应用配置和 Pack 路径管理功能
✨ 权限提示对话框 - 友好提示用户配置 Linux 权限

性能优化

🚀 串口性能深度优化 - 解决高速数据流导致界面卡顿问题
🚀 RTT 性能优化（Linux） - 解决 Linux 上 RTT 轮询耗时 7-8 秒的问题，大幅提升使用体验

修复

🐛 修复 Linux 端 Pack 芯片识别问题 - 解决 Linux 平台无法正确识别 Pack 中芯片的问题
🐛 修复串口模块编译警告 - 清理代码，消除编译警告

v0.7.0 (2026-01-25)

新增功能

✨ 烧录前重载固件 - 烧录前自动重新读取固件文件，确保使用最新编译结果
✨ 固件文件大小显示 - 选择和烧录时显示固件文件大小
✨ Flash 设置持久化 - 校验、复位、擦除模式等设置自动保存到本地

改进

🔧 HID/WinUSB 合并显示 - 同时支持 HID 和 WinUSB 的设备合并为一个条目显示
🔧 日志面板性能优化 - 解决烧录时拖动卡死问题
🔧 默认关闭烧录校验 - 加快烧录速度，用户可手动开启

依赖升级

📦 probe-rs 0.27 → 0.31 - 底层调试库重大升级，新增 ESP32、CH32F1、STM32WB0/U3 等芯片支持

v0.6.0 (2026-01-25)

🚀 串口终端模式 - 新增第三种工作模式，支持本地 COM 口和 TCP 串口服务器
✨ 收发分屏显示 - 左右分屏显示 RX 和 TX 数据
✨ 复用 RTT 能力 - 复用颜色解析、图表绘制等功能

v0.5.0 (2026-01-24)

🚀 模式切换架构重构 - 独立的烧录模式和 RTT 模式
✨ 键盘快捷键 - Ctrl+1（烧录）、Ctrl+2（RTT）、Ctrl+3（串口）
✨ 固件/Pack 拖放导入 - 支持直接拖放文件

查看完整更新日志 →

📄 开源协议

MIT License

🙏 致谢

probe-rs - Rust 嵌入式调试库
Tauri - 跨平台桌面应用框架
React - 用户界面库
Radix UI - 无样式 UI 组件
Tailwind CSS - CSS 框架
Recharts - React 图表库
Clion-Waveform-Plotter - 波形示波器与 FFT 交互设计参考
Entrance - 界面视觉与动效设计参考

📮 反馈与贡献

欢迎提交 Issue 和 Pull Request！

Made with ❤️ by EmbeddedKit Organization

Name		Name	Last commit message	Last commit date
Latest commit History 154 Commits
.github		.github
RTTBSP		RTTBSP
docs		docs
examples		examples
src-tauri		src-tauri
src		src
.gitignore		.gitignore
.prettierignore		.prettierignore
.prettierrc.json		.prettierrc.json
.tauri-signing.local.ps1.example		.tauri-signing.local.ps1.example
99-zuolan-daplink.rules		99-zuolan-daplink.rules
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
README.md		README.md
build.ps1		build.ps1
check.ps1		check.ps1
dev.ps1		dev.ps1
index.html		index.html
install-udev-rules.sh		install-udev-rules.sh
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
postcss.config.js		postcss.config.js
project.yaml		project.yaml
tailwind.config.js		tailwind.config.js
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
verify-release.ps1		verify-release.ps1
vite.config.ts		vite.config.ts

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

EK-OmniProbe

🔗 作者与项目

👥 贡献者

✨ 核心特性

五种工作模式

探针和接口支持

智能管理功能

🎯 支持的芯片

probe-rs 原生支持（内置）

详细型号列表

扩展支持（需要导入 Pack）

如何导入 Pack

🛠️ 技术栈

前端

后端

📁 项目结构

🚀 开发环境搭建

前置要求

安装依赖

开发模式运行

推送前本地检查

构建发布版本

Tauri 自动更新签名（可选）

📖 使用说明

快速开始

1. 连接探针

2. 选择目标芯片

3. 配置接口

4. 选择工作模式

烧录模式使用

RTT 模式使用

基础使用

图表可视化

设置中心

目标固件要求

CMSIS-DAP 注意事项

串口模式使用

连接串口

查看数据

发送数据

蓝牙模式使用

连接 BLE 设备

选择特征值

接收与发送

经典蓝牙 SPP

平台说明

自动断开配置（可选）

⚠️ 已知限制

🆕 更新日志

最新版本 v0.9.5 (2026-04-06)

新增与改进

修复

v0.9.3 (2026-04-06)

新增与改进

界面收口

延续优化

v0.7.1 (2026-01-25)

新增功能

性能优化

修复

v0.7.0 (2026-01-25)

新增功能

改进

依赖升级

v0.6.0 (2026-01-25)

v0.5.0 (2026-01-24)

📄 开源协议

🙏 致谢

📮 反馈与贡献

About

Resources

Uh oh!

Stars

Watchers

Forks

Packages