# SequenceX

**Repository Path**: max-uuc/SequenceX

## Basic Information

- **Project Name**: SequenceX
- **Description**: SequenceX-Studio：一款现代化的工业自动化控制终端。利用 QML 构建响应式 UI，后端基于 Modern C++ 构建。支持串口协议栈，内置高性能绘图模块，旨在为嵌入式开发者提供高效、可靠的上位机控制方案。
- **Primary Language**: C++
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-20
- **Last Updated**: 2026-07-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

1. # 🚀 SequenceX-Studio

   **SequenceX-Studio** 是一款面向现代工业生产与实验室测试的高性能自动化控制终端。系统基于 `Modern C++` 构建强劲稳定的底层通讯与调度核心，前端采用 `QML` 打造流畅、响应式的工业级 UI。

   系统集成了**多通道实时智能示波器**、**可编程自动化流程引擎**、**底层硬件级状态映射**以及**本地数据追溯中心**。旨在为硬件测试、产线老化、电源序列控制提供开箱即用、安全可靠的上位机解决方案。

![输入图片说明](file/image.png)
   ## ✨ 核心特性 (Core Features)

   - 🎨 **现代响应式 UI**：告别传统 WinForm/MFC 的僵硬感，QML 提供电竞级的丝滑交互与极致的数据可视化。
   - ⚡ **高性能通讯栈**：C++ 编写的底层异步串口协议栈，平滑交错轮询算法，保障指令下发“零延迟”。
   - 🛡️ **工业级安全机制**：内置软硬件双重互锁、二次确认与全局复位机制，杜绝车间误操作引发的安全事故。
   - 📈 **极速图表引擎**：最高支持 4 通道并发的实时波形绘制，支持无极缩放、平移与长达 1 小时的历史回溯。
   - 🗄️ **本地追溯数据库**：内建本地数据库，自动生成测试报表与系统级错误日志，测试结果有迹可循。

   ## 🧩 功能模块详解 (Modules)

   ### 1. 🤖 自动化引擎 (Automation Engine)

   专为产线批量测试设计。在此模式下，测试脚本处于**严格只读模式**，杜绝运行过程中的人为篡改。

   - **🛡️ 智能互锁与安全启动**：仅当系统成功解析有效脚本后，“启动”按钮才允许交互。任何紧急停止操作均需“二次确认”。
   - **🔄 全局复位净化 (Hardware Reset)**：每次启动自动化前，系统强制下发全局复位指令（切断所有电源输出、断开所有继电器），确保测试环境的绝对“干净”与安全。
   - **⏳ 阻塞级条件等待 (WaitInput)**：支持严谨的顺序状态机。当步骤要求“等待被测信号”时，系统将安全挂起并持续毫秒级轮询，条件满足即刻放行，逻辑滴水不漏。
   - **💡 硬件状态真实映射 (WYSIWYG)**：拒绝“UI 盲目亮灯”。界面上的继电器与电源指示灯，只有在 C++ 调度器**确切收到硬件底层返回的 ACK (成功响应)** 后才会同步点亮，确保屏幕与物理世界 100% 同步。

   ### 2. 🎛️ 手动控制模式 (Manual Control)

   专为研发调试、设备检修与异常排查打造的“上帝模式”。

   - **全矩阵独立控制**：操作员可脱离脚本，直接对 3 路程控电源（电压/使能）和 16 路继电器阵列进行点动控制。
   - **最高抢占优先级**：底层协议栈对该模式下的指令赋予最高优先级，实现“秒开秒关”的极致跟手体验。

![输入图片说明](file/image1.png)

   ### 3. 📝 流程编排中心 (Script Editor)

   高度自由化的“无代码”测试流程编排中枢，让产线工程师轻松构建复杂测试序列。

   - **积木式可视化编辑**：支持按步骤添加测试参数，支持自由拖拽调整执行顺序、一键剔除无效步骤。（注：为保障逻辑严密，采用“增删替改”逻辑，杜绝行内误触修改）。
   - **热更新与资产管理**：支持将测试序列序列化为 `JSON` 文件持久化保存至本地，或随时反序列化加载。点击 [应用到自动化]，剧本即刻热重载至测试引擎，无缝切换。

![输入图片说明](file/image2.png)

   ### 4. 📊 数据中心与追溯 (Data Center)

   测试不仅要跑得通，更要存得下、查得到。内置本地数据库（SQLite），为每一次测试提供坚实的数据背书。

   - **近期测试数据看板**：自动记录每一次自动化运行的脚本名称、启动时间、运行时长以及最终的 `PASS / FAIL` 判定结果。支持一键导出 CSV 报表供 MES 系统或品质部门分析。
   - **系统异常追踪日志**：底层通讯超时、流程执行中断、急停触发等关键事件，均带有 `WARN` 或 `FATAL` 级别标签并永久存档，让设备的每一次“罢工”都有据可查。
![输入图片说明](file/image3.png)
![输入图片说明](file/image4.png)


   ## 🔌 硬件拓扑与通讯规范

   为保证底层协议栈的吞吐能力与稳定性，请严格按照以下规范部署下位机硬件：

   1. **总线拓扑**：RS485 总线请务必采用标准的“手拉手” (Daisy-chain) 串联接法，终端需匹配 120Ω 电阻，**严禁使用星型接法**。
   2. **设备站号寻址映射 (Address Mapping)**：
      - `ID: 1` ➡️ 16路继电器控制板
      - `ID: 2` ➡️ CH1 程控电源模块
      - `ID: 3` ➡️ CH2 程控电源模块
      - `ID: 4` ➡️ CH3 程控电源模块

   *(开发建议：在波特率配置上，推荐使用 38400或以上波特率以支撑示波器的高频数据回传)*

   ## 🛠️ 技术栈与编译指引

   - **GUI 框架**: Qt 6.x (QML / Qt Quick)
   - **后端语言**: ISO C++ 17
   - **图表组件**: Qt Charts / 自定义 OpenGL 渲染器
   - **数据持久化**: SQLite & nlohmann/json
   - **编译器推荐**: MSVC 2019+ (Windows) / GCC 9.0+ (Linux)