# XCP-Recorder

**Repository Path**: tom-embedded/xcp-recorder

## Basic Information

- **Project Name**: XCP-Recorder
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-09-19
- **Last Updated**: 2026-09-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CANVex

**CANVex** 是一款基于 CAN 总线的 XCP 协议数据采集与标定工具，支持实时数据监控、曲线绘图、数据录制和参数标定功能。

## 主要功能

- **XCP 协议通信**：支持 CAN/CAN FD 总线连接与 ECU 通信
- **实时数据采集**：多事件、多速率变量同步采集
- **曲线显示**：实时波形绘制，支持双光标测量
- **数据录制**：支持 MDF4、CSV、MAT 等多种格式
- **变量管理**：A2L/ELF/MAP 符号文件解析
- **参数标定**：在线修改参数
- **硬件兼容性**：支持多种 CAN 接口（PCAN、Vector、Kvaser 等）

## 安装

### 主要依赖

- Python 3.8+
- PyQt5 - 图形界面框架
- pyqtgraph - 高性能实时曲线绘图
- pyxcp - XCP 协议实现
- python-can - CAN 总线通信
- asammdf - MDF4 文件读写
- numpy - 数值计算
- scipy - MAT 文件支持
- pandas - 数据处理

### 安装步骤

1. 克隆仓库：
   ```bash
   git clone https://gitee.com/prettyboyazu/canvex.git
   cd canvex
   ```

2. 安装依赖：
   ```bash
   pip install -r requirements.txt
   ```

3. 运行程序：
   ```bash
   python run_gui.py
   ```

## 使用说明

### 主要功能

- **连接配置**：设置CAN接口、通道、波特率等参数，连接到ECU。
- **变量选择**：通过A2L文件加载变量，选择需要采集的变量。
- **采集配置**：配置DAQ事件、采样率等参数。
- **数据记录**：开始/停止记录数据到指定格式的文件。
- **数据可视化**：实时显示采集到的数据曲线，支持多窗口、多变量显示。
- **标定功能**：支持通过XCP协议进行标定操作。

### 快捷操作

- **连接/断开ECU**：通过菜单或工具栏按钮连接或断开与ECU的连接。
- **加载A2L文件**：通过菜单加载A2L文件并解析变量。
- **配置采集**：设置DAQ事件和变量采样率。
- **开始/停止采集**：通过按钮开始或停止数据采集。
- **导出数据**：采集完成后，导出数据为CSV、MF4等格式。

## 文件结构

```
canvex/
├── src/
│   ├── a2l_parser.py          # A2L文件解析
│   ├── can_interface.py       # CAN总线接口
│   ├── config_manager.py      # 配置管理
│   ├── daq_manager.py         # DAQ管理
│   ├── data_exporter.py       # 数据导出
│   ├── elf_map_parser.py      # ELF/MAP文件解析
│   ├── exceptions.py          # 异常处理
│   ├── gui/                   # 图形界面模块
│   │   ├── main_window.py     # 主窗口
│   │   ├── plot_window.py     # 数据绘图
│   │   └── ...                # 其他GUI组件
│   ├── logger.py              # 日志管理
│   ├── multi_format_writer.py # 多格式数据写入
│   ├── xcp_connection.py      # XCP连接管理
│   └── xcp_recorder.py        # XCP记录核心
├── run_gui.py                 # GUI启动文件
├── main.py                    # 主程序入口
├── requirements.txt           # 依赖列表
├── LICENSE
└── README.md
```

## 许可证

本项目采用 [MIT License](https://opensource.org/licenses/MIT)，详情请查看 `LICENSE` 文件。

## 贡献

欢迎提交PR或Issue！请遵循项目代码风格并提供清晰的描述。

## 作者

**吴延辉 (Wu Yanhui)**
联系方式：13918095245

## 版权声明

Copyright © 2024-2025 吴延辉
本软件仅供学习和研究使用。
保留所有权利。

## 致谢

- 使用了 [pyxcp](https://github.com/pyxcp/pyxcp) 实现XCP协议通信。
- 使用 [python-can](https://python-can.readthedocs.io/) 支持CAN接口。