开发阶段提示

FST 目前处于高速开发阶段，可能存在不稳定的情况。如果大家在使用中遇到问题，欢迎及时反馈给我们。

功能教程

FST 使用教程

这份教程按 FST 当前代码里的真实功能来写：从串口收发开始，到日志筛选、批量命令、示波器曲线、协议分段解析、数据转换和固件烧录，重点说明每个功能应该怎么用。

01

先认识界面入口

FST 的主界面分成三块：左侧是连接配置，中间是接收区和发送区，右侧是可按需打开的扩展功能页。右侧页签右上角的 + 可以勾选功能模块，关闭页签时对应功能也会取消勾选。

  • 左侧连接页支持串口、网络和蓝牙；网络覆盖 UDP、TCP 客户端、TCP 服务端，蓝牙覆盖 SPP 与 BLE GATT。
  • 中间接收区默认显示 Serial Receive，也可以通过文件打开或拖拽文本文件生成新的接收来源页签。
  • 右侧扩展页包括关键词过滤、多条发送、固件烧录、示波器、协议解析和数据转换。
  • 顶部菜单的文件功能用于打开/保存接收文本、新开窗口和进入设置；帮助菜单用于更新、授权、关于和反馈。
连接 Serial

端口、波特率、数据位、校验位、流控

主工作区 Receive / Send

接收显示、查找、保存、分享、文本发送、HEX 发送

扩展页 +

关键词、多条发送、烧录、示波器、协议解析、数据转换

02

连接串口

在左侧串口页选择端口和波特率，点 Search 刷新端口，点 Open 打开。高级串口参数可以展开设置，包含数据位、停止位、校验位和流控。

端口选择设备对应的 COM 口；打开失败时先检查是否被其他串口工具占用。
波特率常用值可直接选，选择 Custom 可以维护自定义波特率列表。
数据位支持 5、6、7、8，普通 MCU 调试通常使用 8。
停止位支持 1、1.5、2，常见配置为 1。
校验位支持 NONE、ODD、EVEN、MARK、SPACE，常见配置为 NONE。
流控支持 NONE、HARDWARE、SOFTWARE，普通串口调试通常使用 NONE。

端口打开后，状态栏会显示端口状态、接收/发送累计字节数和实时速率。固件烧录需要串口时，FST 会临时释放当前串口，烧录结束后再尝试重新打开。

03

收发数据

中间上方是接收区，下方是发送输入框。发送按钮右侧的菜单和顶部菜单里的收发设置是同步的，适合按当前协议临时切换收发方式。

接收显示

  • HEX show 会把收到的字节显示成大写 HEX，例如 AA 55 0D 0A。
  • Add timestamp 会在接收行前加毫秒级时间戳。
  • Timeout Split 会在超过指定毫秒没有新数据时自动换行，适合没有换行符的连续数据流。
  • 设置页开启 ANSI 颜色后，终端日志里的 SGR 颜色、粗体、斜体、下划线等会尽量保留。

发送方式

  • HEX Send 会把输入按 HEX 字节发送，支持 AA 55、0xAA55 这类写法。
  • Show in Receive 会把发送内容用 <- 标记同步写入接收区，便于复盘请求和响应。
  • Add \r\n 会在发送末尾追加回车换行，适合 AT 指令或行协议。
  • Timed Send 会按指定毫秒间隔重复发送当前输入内容。

发送快捷键可在菜单中二选一：Enter to Send 或 Ctrl+Enter to Send。文本发送和 HEX/字符串转换会使用设置页里的文本编码。

Serial Receive

-> [10-50-21-415] boot state BOOT image=APP2 watchdog=enabled

<- AT+TEMP?

-> sensor sample temp=32.16C hum=54.00% vbat=3.86V

-> packet payload=96 bytes CRC 0x4B2E

-> WARNING retry window=64ms channel=0 recovered

04

使用接收区

接收区右上角菜单提供清除、打开、保存、复制和分享。打开文本文件后会新建一个接收来源页签，关键词过滤可以在串口数据和打开的文本之间切换定位。

  • Clear 清空当前接收内容，同时会重置主界面的收发统计。
  • Open 会把当前内容保存成临时 TXT 后交给外部工具打开；可在设置页选择 Notepad++ 或系统默认程序。
  • Save 把当前接收内容保存为 TXT；顶部 File / Save 也执行同类操作。
  • Copy 复制纯文本内容；Share 会生成 TXT 文件并放入剪贴板，到微信、钉钉等窗口直接粘贴即可发送文件。
  • 接收区支持 Ctrl+F 查找，F3 下一个，Shift+F3 上一个，Esc 关闭查找面板。
  • 接收区和关键词结果区支持 Ctrl + 鼠标滚轮 调整字号，字号会写入配置。
05

关键词过滤与高亮

打开右侧 Keyword Filter 后，下方维护关键词列表，上方显示命中的行。新接收的数据会实时高亮；已经存在的历史文本可以点 Reapply Filter 重新过滤。

  • 右键关键词列表可添加、删除、清空、导入和导出 JSON，列表支持拖拽排序。
  • 每条关键词可以单独启用/禁用，支持区分大小写和全词匹配。
  • 颜色按钮会自动生成可读的前景色和背景色；标准版默认只开放红色，高级版可使用完整色板。
  • Select All 和 Deselect All 用于快速启用或停用全部规则。
  • 双击过滤结果中的一行，会跳回原始接收文本对应位置；原始文本已清空时会提示无法定位。
  • 底部折叠按钮可以隐藏关键词列表，只保留过滤结果区域。
Error Warning PASS TEMP CRC
FST 关键词过滤动态演示
06

多条发送

Multiple Send 用来保存常用命令，适合设备初始化、产测步骤、协议回归和重复验证。每一行都有发送内容、备注、HEX 开关、\r\n 开关和单独的发送按钮。

  • 右键列表可以在上方/下方插入命令、删除命令、清空列表、导入和导出 JSON。
  • 拖拽列表项可以调整命令顺序，关闭软件前会保存当前命令列表。
  • 勾选 HEX 后，该行会按 HEX 字节发送；勾选 \r\n 后会在该行末尾追加回车换行。
  • 发送时同样遵循主界面的 Show in Receive 选项，便于在接收区看到哪条命令触发了响应。
发送内容备注HEXCRLF操作
AT+RST复位设备否是
AA 55 01 00 56读取状态是否
AT+MODE=AUTO切换自动模式否是
07

示波器：把串口数据画成曲线

示波器不是直接读取任意文本画图，而是先配置一条或多条“数据格式规则”。串口新收到的数据会同步进入示波器，示波器按 HEAD 和 TAIL 找到完整帧，再把中间的数据项转换成曲线点。

配置一条 ASCII 曲线规则

  1. 打开右侧 Wave Display，在右侧规则列表中右键添加一条规则，或编辑已有规则。
  2. 类型选择 ASCII，填写 HEAD、Data Counts 和 TAIL。
  3. 点 Apply 生成数据项，再给每个 Data0、Data1 设置备注、线型和颜色。
  4. 点 Save 保存规则，随后串口收到完整帧就会开始绘制。
ASCII 示例

规则：HEAD=TEMP、Data Counts=2、TAIL=END。设备发送 TEMP,32.00,54.00,END 时，FST 会把 32.00 和 54.00 分别画到两条曲线。

配置一条 HEX 曲线规则

  1. 类型选择 HEX，HEAD 和 TAIL 都按 HEX 写，例如 AA 55、0D 0A。
  2. 选择小端或大端；这会影响 int16、uint32、float32、double64 等多字节字段。
  3. 点 Apply 后，为每个字段选择类型。支持 int8、uint8、int16、uint16、int32、uint32、int64、uint64、float32、double64。
  4. 给字段填写备注后，曲线图例和导出名称会优先使用备注。

查看、标记和导出

  • Follow Latest 让视图跟随最新数据；手动拖拽、滚轮或框选放大时会自动停止跟随。
  • Time-based 以接收时间为 X 轴，显示宽度单位是秒；Point-based 以点数为 X 轴，显示宽度单位是 counts。
  • Y 轴可以自动缩放，也可以手动设置最大值和最小值。
  • Zoom In 开启后拖拽框选区域放大，Zoom Out 回到上一层视图，Display Reset 重置到跟随最新。
  • Mark 开启后点击曲线点添加坐标标记，双击标记删除，Clear All Mark 清空全部标记。
  • Clear Graph 清空曲线和统计，Export 可选择曲线导出 CSV，并选择是否带 X 轴、标题以及数字输出为整数或浮点。

示波器只处理开启后新收到的串口数据。如果需要重放历史数据，可以让设备重新发送，或后续补充“从文件重放”的功能。

FST 示波器五路曲线动态演示
08

协议解析：按字段拆包并校验

Protocol Parse 适合看二进制协议。打开页签后，新收到的串口字节会进入解析器；解析器按分段表从接收缓冲区寻找完整帧，在实时预览中用不同颜色标出每段字节，并在下一行列出字段值。

分段表怎么填

Name字段角色，支持 HEAD、LENGTH、DATA、CHECKSUM、TAIL、FIXED。
Data TypeHEAD/TAIL/FIXED 可用 hex_string 或 string；普通字段可用 uint8、uint16、uint32、string、hex_string、bytes；校验字段支持 SUM8、XOR8、CRC16_MODBUS。
Value固定字段的期望内容。hex_string 用 HEX 写，例如 AA 55。
Endian影响 uint16 和 uint32 的数值读取，可选小端或大端。
LengthDATA 的字节数。可以写固定数字，也可以写表达式。
Check Start / End校验范围，从帧起点计数，End 不包含在校验范围内。
Color / NoteColor 用于预览高亮，Note 用于给字段值加说明。

表达式规则

  • $HEAD 表示 HEAD 这个字段占用的字节数。
  • #LENGTH 表示 LENGTH 字段解析出来的数值。
  • 表达式支持加减法，例如 $HEAD+$LENGTH+#LENGTH。
  • 分段可以用 Add Segment 菜单添加，也可以用 Up、Down、拖拽调整顺序。
协议解析示例

假设设备发送 AA 55 03 01 02 03 08 0D 0A，其中 AA 55 是头，03 是长度，后 3 字节是数据，08 是前 6 字节 SUM8 的低 8 位，0D 0A 是尾。

HEADData Type 选 hex_string，Value 填 AA 55。
LENGTHData Type 选 uint8。
DATAData Type 选 bytes，Length 填 #LENGTH。
CHECKSUMData Type 选 SUM8，Check Start 填 0，Check End 填 $HEAD+$LENGTH+#LENGTH。
TAILData Type 选 hex_string，Value 填 0D 0A。

协议解析页更适合检查“字段是否对、长度是否对、校验是否过”。如果只是要连续观察数值变化，用示波器；如果要把同一串字节拆成 HEAD/LENGTH/DATA/CHECKSUM/TAIL，用协议解析。

09

数据转换

Data Conversion 是调试时的辅助工具。左侧选择工具，右侧输入内容，点 Convert 或按 Ctrl+Enter 转换。输出可以复制、交换到输入区，或直接作为下一次输入。

通信类HEX 与字符串互转、Base64 编解码、URL 编解码、Unicode 转义、JSON 格式化/压缩/字符串转义。
数字类2/8/10/16 进制转换、大小端反转、float/double 与 HEX 互转、ASCII 查询、有符号/无符号解释。
时间类时间戳和时间字符串互转，支持秒、毫秒、微秒、纳秒，也支持 UTC 与本地时间转换。
  • HEX 相关工具支持 0x 前缀、空格、逗号、分号、下划线等分隔写法。
  • 字符串和 HEX 互转使用设置页的当前文本编码，中文场景可按设备编码选择 GBK 或 UTF-8。
  • Ctrl+L 可快速清空输入和输出。
  • 进制和有符号转换可选择 8/16/32/64 位宽，适合寄存器、协议字段和位掩码分析。
10

固件烧录

Firmware Burner 把多种芯片烧录入口集中在右侧页签里。烧录前先在左侧选择串口；点击烧录时，FST 会申请当前串口，必要时临时关闭主串口连接，烧录结束后再尝试恢复。

STM32选择 .bin 或 .hex，设置基地址、波特率、全片擦除、校验、烧录后运行、DTR 控 BOOT0、RTS 控 RESET。
GD32共用 STM32 串口 Bootloader 流程，适合使用类似协议的 GD32 设备。
ESP32多镜像地址表，连接波特率和烧录波特率分开设置，支持 Stub、MD5 校验、整片擦除、自动 BOOT/RESET。
STC内置 STC 后端，支持协议选择、握手波特率、传输波特率、频率微调、自动复位、只擦除和调试日志。
BES(P)选择 BES DLD 工具、芯片版本、APP/OTA BOOT 镜像，可配置擦除、重启、关机、校准和工厂区信息。
  • STM32/GD32 的基地址默认按 0x08000000 这类格式填写；勾选自动 BOOT 时按 DTR/RTS 控制进入 Bootloader。
  • ESP32 的镜像表每一行包含地址和固件文件，至少要有一个有效镜像；地址需要按 4 字节对齐。
  • STC 的 Erase only 只擦除时可以不选择固件；普通烧录需要选择 .bin、.hex 或 .ihx。
  • BES(P) 的工厂区更新只有勾选后才会启用 BT/BLE 名称、地址、TWS 地址和校准值。
  • 烧录过程中按钮会变成 Stop，日志区会显示步骤和错误信息，失败时按日志先检查串口占用、接线、复位脚和固件路径。
ESP32多镜像地址表、双波特率、Stub 与 MD5 校验
Firmware BurnerESP32
STM32ESP32GD32STCBES(P)
地址
固件
0x10000
C:/Workspace/Project/APP1.bin
...
0x80000
C:/Workspace/Project/APP2.bin
...
0xF000
C:/Workspace/Project/OTA.bin
...
连接波特率 115200 烧录波特率 921600
使用 Stub 加载器校验 MD5烧录后复位自动 BOOT / RESET
0%
烧录
11

设置、更新、授权与反馈

设置页分成 Display、Send and Receive、Third party 和 Other。修改主题、语言、保存日志等选项可能需要重启，FST 会在保存时提示。

Display调整主题、颜色可读性策略、语言、界面字体、接收区字号和关键词结果字号。
Send and Receive选择文本编码，开启或关闭接收区 ANSI 颜色支持。
Third party设置接收文本打开方式，可用 Notepad++ 自动检测/手动路径，也可改成系统默认程序。
Other选择在线更新源，开启本地调试日志，查看并清理接收文件缓存，或恢复出厂设置。
  • Update 会检测 Gitee、GitHub 或备用服务器，自动选择可用通道，只下载变更文件并校验完整性。
  • License 支持离线授权：复制设备号到授权网站，拿到 License Key 后粘贴并激活。
  • Feedback 可选择 Bug、优化建议、功能需求、兼容性、文档/使用问题等分类，每天最多发送 5 条。
  • Factory Reset 会清空普通配置并恢复默认值，执行后需要重启。