# apm-log2excel

**Repository Path**: junzixing/apm-log2excel

## Basic Information

- **Project Name**: apm-log2excel
- **Description**: 将APM飞控的日志文件转换为Excel文件的小工具。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: V2.0
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2024-04-18
- **Last Updated**: 2025-09-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# apm-log2excel

## 介绍
将APM飞控的日志文件转换为Excel文件的小工具，支持批量处理多个日志文件。

## 主要功能
- 自动扫描当前目录下的所有".log"文件
- 批量转换多个日志文件为Excel格式
- 自动提取飞控参数文件（.param）
- GPS时间转换为北京时间
- 多实例数据处理支持
- 处理完成后提供详细的总结报告

## 开发环境设置

### 安装依赖
在项目根目录下运行以下命令安装所需的Python依赖包：

```bash
pip3 install -r requirements.txt
```

### 依赖说明
- `openpyxl>=3.0.0`: 用于Excel文件的读写操作
- `tqdm>=4.60.0`: 用于显示进度条
- `pyinstaller>=5.0.0`: 用于将Python脚本打包成exe文件（仅开发时需要）

## 打包说明

### 生成exe文件
使用项目提供的打包脚本可以轻松将Python脚本打包成exe文件：

```bash
python3 build_exe.py
```

## 使用说明

### 方法一：直接运行Python脚本
1. 使用MissionPlanner地面软件将飞控的".bin"格式的日志文件转换为".log"格式的日志文件；
2. 将此仓库中的"apm_log2excel.py"文件与".log"格式的日志文件放到任意一个相同的文件夹下；
3. 使用如下命令在上述文件夹目录下运行python脚本：
```bash
python3 apm_log2excel.py
```
4. 程序将自动扫描当前文件夹下的**所有**".log"文件，并依次进行批量处理；
5. 程序运行完成后，每个日志文件都会生成对应的Excel文件和".param"参数文件；
6. 处理完成后会显示详细的总结报告，包括处理时间、成功文件数、失败文件数等信息。

### 方法二：使用exe文件直接运行
1. 使用MissionPlanner地面软件将飞控的".bin"格式的日志文件转换为".log"格式的日志文件；
2. 将此仓库中的"APM_Log2Excel.exe"文件与".log"格式的日志文件放到任意一个相同的文件夹下；
3. 双击"APM_Log2Excel.exe"文件，将弹出一个终端界面；
4. 程序将自动扫描当前文件夹下的**所有**".log"文件，并依次进行批量处理；
5. 程序运行完成后，每个日志文件都会生成对应的Excel文件和".param"参数文件；
6. 处理完成后会显示详细的总结报告。

### 输出文件说明
- **Excel文件（.xlsx）**：包含日志数据的各个工作表，时间已转换为北京时间
- **参数文件（.param）**：飞控的参数配置文件，可用于参数对比和备份

### 批量处理特性
- ✅ 自动发现目录下所有.log文件
- ✅ 按文件名排序依次处理
- ✅ 错误处理机制，单个文件失败不影响其他文件
- ✅ 详细的进度显示和处理状态
- ✅ 完整的处理总结报告

## 更新历史

### V2.0 (最新版本)
- 🆕 **批量处理功能**：支持自动扫描并处理目录下所有.log文件
- 🆕 **处理总结报告**：显示详细的处理结果统计信息
- 🆕 **错误处理机制**：单个文件处理失败不影响其他文件
- 🆕 **进度显示优化**：显示当前处理进度和文件状态
- 🐛 **修复索引越界错误**：增强了对不完整日志行的处理能力

### V1.0
- 基础的单文件日志转换功能
- GPS时间转北京时间转换
- Excel文件生成
- 参数文件提取

## 联系方式
此程序优化建议、飞控固件开发、飞控硬件设计、无人机总体方案设计等等，请联系QQ：3500985084

## 怒飞垂云官网
<a href="http://www.nufeichuiyun.com/" target="_blank">http://www.nufeichuiyun.com/</a>

## 《无人机固件开发教程》视频教程链接
<a href="https://study.163.com/course/introduction/1209568864.htm?share=1&shareId=1448054983" target="_blank">https://study.163.com/course/introduction/1209568864.htm?share=1&shareId=1448054983</a>

## 怒飞垂云：怒而飞，其翼若垂天之云！

![](./图片/怒飞垂云-公众号.jpg)