Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
59 changes: 59 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
name: CI

on:
push:
branches: [main]
pull_request:

permissions:
contents: read

concurrency:
group: ci-${{ github.ref }}
cancel-in-progress: true

env:
QT_VERSION: "6.12.0"
AQT_SOURCE: "git+https://github.com/miurahr/aqtinstall.git"

jobs:
build-and-test:
name: Build and test (${{ matrix.os }})
runs-on: ${{ matrix.os }}
strategy:
fail-fast: false
matrix:
os: [ubuntu-24.04, windows-2022, macos-15]
steps:
- name: Check out sources and submodules
uses: actions/checkout@v6
with:
submodules: recursive

- name: Install Linux dependencies
if: runner.os == 'Linux'
run: |
sudo apt-get update
sudo apt-get install -y ninja-build libgl1-mesa-dev libxcb-cursor0 libxkbcommon-x11-0

- name: Install Qt
uses: jurplel/install-qt-action@v4
with:
version: ${{ env.QT_VERSION }}
aqtsource: ${{ env.AQT_SOURCE }}
modules: "qt5compat qtserialport"
cache: true

- name: Configure Windows
if: runner.os == 'Windows'
run: cmake -S . -B build/ci -G "Visual Studio 17 2022" -A x64 -DBUILD_TESTING=ON

- name: Configure macOS and Linux
if: runner.os != 'Windows'
run: cmake -S . -B build/ci -G Ninja -DCMAKE_BUILD_TYPE=Release -DBUILD_TESTING=ON

- name: Build
run: cmake --build build/ci --config Release --parallel 2

- name: Test
run: ctest --test-dir build/ci -C Release --output-on-failure --no-tests=error
20 changes: 20 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,26 @@

本项目遵循面向用户的变更记录格式。版本号在正式发布前可能继续调整。

## [0.1.29] - 2026-11-17

### 新增

- 协议模板可定义载荷字段的类型、字节序、倍率、加值和设备地址;新增实时解析窗口,按模板、地址、字段查看数值,勾选即可比较多个设备的曲线,对应 [#20](https://github.com/txp666/FluentSerialAssistant/issues/20)。
- 协议编辑器与曲线窗口共用模板字段和解析规则;“创建曲线”带入当前模板与样例,保存同名模板后同步关联曲线并清空旧数据。

### 改进

- 协议编辑器始终显示字节图和右侧模板设置,字段列表用对应颜色展示字节与解析值,支持拖动数据字段调整顺序;解析窗口可收起左侧配置区。
- 按字段类型和协议配置自动生成匹配样例并重算长度、校验。手动粘贴或“最新接收”的样例在编辑配置时保留,清空后继续编辑可恢复自动生成。
- 协议解析与曲线共用断帧逻辑,支持分批接收和连续多帧;已断帧的数据块可跳过长度越界的残缺候选。

### 修复

- 串口断开、重新连接时丢弃未收齐的半帧,避免不同连接的数据拼接;已采集的曲线保留。
- 保存其他模板时不再覆盖当前曲线使用的模板草稿。
- 修复 Qt 6.12.0 下数值输入框在窄布局后恢复宽度仍不显示数值,以及 macOS 辅助功能访问动态表格时可能崩溃的问题。
- 更新 FluentQtWidgets,补齐表格排序箭头资源。

## [0.1.28] - 2026-11-15

### 新增
Expand Down
31 changes: 29 additions & 2 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,17 @@ cmake_minimum_required(VERSION 3.21)

project(
FluentSerialAssistant
VERSION 0.1.28
VERSION 0.1.29
DESCRIPTION "A Fluent Qt serial assistant prototype"
LANGUAGES CXX
)

if(APPLE)
enable_language(OBJCXX)
set(CMAKE_OBJCXX_STANDARD 17)
set(CMAKE_OBJCXX_STANDARD_REQUIRED ON)
endif()

include(GNUInstallDirs)

set(CMAKE_CXX_STANDARD 17)
Expand Down Expand Up @@ -131,6 +137,10 @@ add_executable(FluentSerialAssistant
src/app/view/plot_parser_dialog.h
src/app/view/protocol_template_window.cpp
src/app/view/protocol_template_window.h
src/app/view/protocol_payload_editor.cpp
src/app/view/protocol_payload_editor.h
src/app/view/protocol_analysis_window.cpp
src/app/view/protocol_analysis_window.h
src/app/view/quick_plot_window.cpp
src/app/view/quick_plot_window.h
src/app/view/settings_page.cpp
Expand Down Expand Up @@ -200,6 +210,12 @@ target_link_libraries(FluentSerialAssistant
FluentSerialPlotParser
)

if(APPLE AND Qt6_VERSION VERSION_EQUAL "6.12.0")
target_sources(FluentSerialAssistant PRIVATE src/app/core/macos_accessibility_fix.mm)
set_source_files_properties(src/app/core/macos_accessibility_fix.mm PROPERTIES COMPILE_OPTIONS "-fno-objc-arc")
target_link_libraries(FluentSerialAssistant PRIVATE "-framework AppKit")
endif()

if(WIN32)
target_link_libraries(FluentSerialAssistant PRIVATE shell32)
endif()
Expand All @@ -219,14 +235,25 @@ if(BUILD_TESTING)
)
get_target_property(workbench_test_libraries FluentSerialAssistant LINK_LIBRARIES)
target_link_libraries(FluentSerialTestSupport PUBLIC ${workbench_test_libraries})
foreach(test_name IN ITEMS data_table_model frame_codecs plot_value_parser control_service workbench_data_table workbench_quick_plot workbench_reliability protocol_windows terminal_view terminal_colors
foreach(test_name IN ITEMS data_table_model frame_codecs plot_value_parser control_service workbench_data_table workbench_quick_plot workbench_reliability protocol_windows protocol_analysis terminal_view terminal_colors
auto_reply virtual_serial_pair virtual_serial_workbench update_downloader update_installer
update_ui update_manager main_window)
add_executable(tst_${test_name} tests/tst_${test_name}.cpp)
target_link_libraries(tst_${test_name} PRIVATE FluentSerialTestSupport Qt6::Test)
add_test(NAME ${test_name} COMMAND tst_${test_name})
set_tests_properties(${test_name} PROPERTIES ENVIRONMENT "QT_QPA_PLATFORM=offscreen" TIMEOUT 120)
endforeach()
if(APPLE AND Qt6_VERSION VERSION_EQUAL "6.12.0")
add_executable(tst_macos_accessibility
tests/tst_macos_accessibility.mm
src/app/core/macos_accessibility_fix.mm
)
target_include_directories(tst_macos_accessibility PRIVATE src)
target_compile_options(tst_macos_accessibility PRIVATE -fno-objc-arc)
target_link_libraries(tst_macos_accessibility PRIVATE Qt6::Widgets Qt6::Test "-framework AppKit")
add_test(NAME macos_accessibility COMMAND tst_macos_accessibility)
set_tests_properties(macos_accessibility PROPERTIES ENVIRONMENT "QT_QPA_PLATFORM=cocoa" TIMEOUT 120)
endif()
endif()

add_executable(fluentserial-cli
Expand Down
18 changes: 16 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,9 @@ Fluent 串口助手提供现代 Fluent 风格的串口终端,覆盖连接、
<td width="50%"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/protocol-editor-zh-dark.png"><img src="docs/images/protocol-editor-zh-light.png" alt="帧协议编辑器"></picture><p align="center">帧协议编辑器:字节结构、字段和校验一目了然</p></td>
<td width="50%"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/data-table-zh-dark.png"><img src="docs/images/data-table-zh-light.png" alt="数据表格"></picture><p align="center">数据表格:按帧查看 HEX、文本和校验结果</p></td>
</tr>
<tr>
<td colspan="2"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/protocol-analysis-zh-dark.png"><img src="docs/images/protocol-analysis-zh-light.png" alt="协议解析:按地址查看三个设备的实时字段,并在同一张图上比较曲线"></picture><p align="center">协议解析:按地址查看三个设备的实时字段,并在同一张图上比较曲线</p></td>
</tr>
</table>

## 下载安装
Expand Down Expand Up @@ -70,6 +73,7 @@ macOS 版本未经 Apple 公证,首次打开被系统阻止时,请在“系
### 协议与工具

- 帧协议模板:在可视化编辑器中定义帧头、长度、命令、载荷、校验和帧尾,校验可从指定偏移开始计算,用样例或最新接收帧检查解析结果;启用后接收记录会标注命令和校验状态。
- 协议解析窗口:在模板中定义载荷字段和设备地址,直接查看实时数值,勾选字段即可在同一张图上比较不同设备、不同模板的曲线。
- 校验工具:CRC16-Modbus、CRC16-CCITT、CRC32、LRC、XOR、SUM8,可手动计算或在发送时自动追加;可跳过开头和末尾的字节(如帧头、帧尾),校验码插在末尾跳过的字节和换行符之前。
- Modbus RTU:生成常用读写请求、自动追加 CRC,并解析响应摘要。

Expand Down Expand Up @@ -100,15 +104,25 @@ macOS 版本未经 Apple 公证,首次打开被系统阻止时,请在“系
1. 选择串口并设置波特率、数据位、校验位、停止位和流控,点击“连接”。
2. 在终端查看收发记录;需要时开启时间戳、自动断帧或切换 HEX 显示。
3. 在发送区输入文本或 HEX,选择行结束符和编码后发送;可勾选校验自动追加或循环发送。
4. 点击终端工具栏的曲线图标,选择解析协议并确认,即可新建一个曲线窗口。
5. 在左侧“协议模板”中点击“编辑协议”定义帧格式,保存并启用后,接收记录会显示解析结果。
4. 点击终端工具栏的曲线图标,确认解析设置即可新建曲线窗口;当前协议模板已定义数据字段时,会直接带入模板和字段。
5. 在左侧“协议模板”中点击“编辑协议”定义帧格式和载荷字段,保存后勾选“启用”,直接打开数据与曲线解析窗口。
6. 用常用包、宏命令、自动应答或脚本插件把重复操作自动化。
7. 点击终端工具栏最左侧的扫把按钮,同时清空终端和收发计数;用 TXT、CSV、BIN 导出记录。

### 协议解析窗口

1. 点击“编辑协议”,在“字段解析”区域按 1 / 2 / 4 / 8 B 或 Float32 / Float64 添加数据字段;字段按整帧字节顺序排列,同一行显示类型、整帧位置、原始 HEX、解析值和状态。选中一行后,在固定的右侧属性区设置名称、载荷内起点、数值类型、字节序、倍率和加值;右侧“模板设置”常驻显示,集中提供新建、切换、保存和删除操作;下方通过字段选择框配置帧头、长度、设备地址、命令、校验和帧尾。
可上下拖动数据字段调整顺序,载荷偏移随之更新。字段值按“原始值 × 倍率 + 加值”换算,保存后生效。字节图始终显示,字段列表的色块和 HEX 底色与字节图对应;点击字节图或列表中的字段可联动查看属性;新建或切换到没有保存样例的模板、修改协议配置时,会自动生成匹配样例,并重算长度和校验;也可直接粘贴 HEX 或使用“最新接收”分析实际数据;这类样例在修改名称、倍率等配置时保留原始字节,清空样例后继续编辑可恢复自动生成。样例缺少数据时明确显示缺失字节数。
2. 同一总线上有多个设备时,设置地址字节数和地址在整帧中的偏移,解析窗口会按地址的 HEX 字节分组;不区分地址时选择“不区分设备地址”。同一个模板最多定义 32 个载荷字段,未定义时按载荷字节显示 CH1、CH2 等。
3. 勾选左侧协议模板的“启用”即可打开解析窗口;关闭窗口后可点击“解析数据与曲线”再次打开,沿用当前协议和曲线勾选。需要解析多种帧格式时,在窗口中勾选多个模板。
4. 列表显示各设备字段的当前值和更新时间,勾选“曲线”即可绘制,共用以秒为单位的时间轴。点击窗口顶部“配置”可收起或展开左侧模板与字段列表,收起后继续采集和绘图,并显示图例以区分设备曲线。窗口最多显示 256 个数据字段,同时绘制 32 条曲线;曲线保留最近 12,000 个点。关闭后再次打开或重启应用会保留曲线勾选。
5. 暂停、隐藏、最小化或关闭窗口时停止采集;清空后保留字段和勾选,更改参与解析的模板或保存模板修改后清空历史。校验失败的帧不更新数值,缺少的字段显示“—”。原始串口流按模板长度字段或固定载荷长度重组分批接收的数据;没有长度信息时,请在接收设置中先配置断帧。已断帧的数据块会跳过长度越界的残缺候选,继续解析后续帧;原始流仍等待声明长度,避免误切载荷中的帧头。

### 曲线窗口

- 每次确认都会新建一个独立窗口,可同时打开多个窗口分别绘制不同字段;窗口左上角的按钮显示当前协议,点击可修改解析设置。
- 用文本或 HEX 样例预览解析结果;二进制字段可配置类型、字节偏移、大小端、比例和偏移,并从完整帧或协议模板载荷中取数。
- 协议编辑器中的“创建曲线”直接带入当前模板、字段和样例;终端工具栏也会优先使用当前已配置数据字段的模板。模板模式共用字段定义、收帧与校验逻辑,按设备地址分别绘图,可通过“编辑协议”返回编辑器。保存同名模板后,关联曲线同步字段并清空旧数据,开始重新采样。
- 点击工具栏的“通道数据”可展开或隐藏右侧面板,隐藏后曲线占满空间,数据接收和通道设置继续保留。列表显示各通道的颜色和最新值,勾选通道控制曲线显隐;拖动中间分隔条可调整列表宽度。
- “通道设置”默认收起,点击可单独展开或隐藏。选中通道后设置倍率和偏移,按“显示值 = 解析值 × 倍率 + 偏移”同步更新已有曲线、新数据和 CSV 导出;解析值保留,可用“重置当前通道”恢复。二进制字段先应用解析设置中的比例和加值,再应用这里的倍率和偏移。
- 每个窗口的通道设置独立,清空数据后按通道名称保留;更换解析配置或载荷模板后重置,关闭窗口后不保留。
Expand Down
Loading
Loading