docs: 添加README,说明Windows/Linux跨平台编译方法

This commit is contained in:
iorebuild
2026-04-30 12:53:05 +08:00
parent 7e3593c898
commit 74edf51a75

63
README.md Normal file
View File

@@ -0,0 +1,63 @@
# AiAnalysis - 16通道AI数据UDP实时采集分析工具
## 功能
- UDP端口监听实时接收数据包
- 解析16通道逗号分隔的ADC数据格式: `val0,val1,...,val15`
- 实时波形绘制深色主题16条独立颜色曲线
- 数据自动保存为CSV存到 `data_端口号/` 目录)
- 支持打开历史CSV文件回放查看
- 滚轮缩放、右键拖拽平移、双击恢复自动范围
- 通道可见性切换、显示点数可调
## 跨平台支持
✅ Linux ✅ Windows ✅ macOS
代码纯Qt5编写无平台特定依赖。
---
## Windows 编译 & 运行
### 准备工作
1. 下载安装 **Qt 5.15** (MinGW 或 MSVC 版本均支持): https://download.qt.io/archive/qt/5.15/
- 安装时勾选 `MinGW` 编译器 或 `MSVC` 编译器
2. 下载安装 **CMake** (3.14+): https://cmake.org/download/
- 安装时勾选 "Add CMake to system PATH"
### 编译(命令行)
```powershell
# 在项目目录下
mkdir build
cd build
cmake .. -G "MinGW Makefiles"
mingw32-make -j4
# 或使用 MSVC:
# cmake .. -G "Visual Studio 17 2022"
```
### 编译Qt Creator
1. 打开 Qt Creator
2. File → Open File or Project → 选择 `CMakeLists.txt`
3. 选择对应的 KitMinGW 64-bit 或 MSVC
4. 点击构建 → 运行
### 直接运行
编译完成后,`build/AiAnalysis.exe` 即为可执行文件。
---
## Linux 编译
```bash
sudo apt install qtbase5-dev cmake g++
mkdir build && cd build
cmake ..
make -j$(nproc)
./AiAnalysis
```
## 使用说明
1. 输入UDP端口号点击「开始监听」
2. 下位机通过UDP发送逗号分隔的16通道数据
3. 右侧面板可切换通道显示/隐藏
4. 「打开文件」可加载历史CSV数据回放
5. 鼠标滚轮缩放Y轴右键拖拽平移双击恢复自动范围