Upload README and image resources

This commit is contained in:
LuChiChick 2025-10-14 20:51:58 +08:00
parent cfe0f0ec27
commit 0482210279
2 changed files with 71 additions and 0 deletions

BIN
Img/功能展示.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 730 KiB

71
README.md Normal file
View File

@ -0,0 +1,71 @@
## 这是个啥
`SNOOPerToCSV` 是用于将劳特巴赫 `TRACE32-SNOOPer` 录制的数据转换为CSV表格的工具你可以很方便地通过本工具快速将`SNOOPer`录制的变量数据导出为CSV表格并便捷地调整数据输出格式、时间轴等
配合示波器和MatLab可以很方便的实现对轴波形分析方便运行时数据采集
![功能展示](./Img/功能展示.png)
## 如何使用
它是一个非GUI程序所以你需要使用终端来调用它使用如下指令即可进行基础的数据转换
```shell
SNOOPerToCSV.exe <file1> <file2> ...
```
只需要提供要处理的文件本工具即可按照默认的时间轴及类型配置依次处理文件默认的时间轴从0.00s开始,而配置的默认输出格式为无符号整型,如果你希望修改输出的格式和时间轴,可以通过添加如下参数实现:
```shell
1. -f <identification> <type> 指定特定标识的数据条目输出为特定类型
2. -t <time(s)> 指定时间轴起始
```
例如我想将 `AAA.txt` 文件以 `-1.2s` 为时间轴起始,并将名称中含有 `Voltage` 的条目以单浮点类型输出,可以使用以下指令:
```shell
SNOOPerToCSV.exe AAA.txt -t -1.2 -f Voltage float
```
`<identification>` 标识变量的方式除了上述的子串名识别外还可以使用ID进行匹配这个ID会在你进行生成时输出到终端例如上面的图片终端中有16个ID劳特巴赫至多支持16个变量采样此外也可以使用识别串同时指定多个变量例如将名称中含有 `Voltage` 的条目和ID为11的条目输出为单浮点类型你可以使用如下指令
```shell
SNOOPerToCSV.exe AAA.txt -t -1.2 -f Voltage,15 float
```
即所谓识别串就是将子串名或ID以逗号英文逗号分隔的连续字符串作为 `<identification>` 输入;
要注意的是 `Voltage,15,` 这个识别串是非法的,末尾的逗号需要去掉;
在有多个文件输入时ID匹配仅识别第一个文件中的条目随后程序会记住这个ID对应的条目名称在下个文件时识别记忆的条目名而非再次以ID进行识别避免了劳特巴赫输出顺序导致的批量文件处理过程中数据格式错误
当ID与子串名同时指定了一个条目时子串名的优先级要高于ID
## 关于构建
本仓库所使用的构建平台及环境为如下:
OSWindows11 Professional 24H2 (26100.4652)
Tool Chain[mingw-w64\i686-14.2.0-release-win32-dwarf-ucrt-rt_v12-rev2](https://github.com/niXman/mingw-builds-binaries/releases/tag/14.2.0-rt_v12-rev2)
构建关系由 `Makefile` 组织,使用 `C17``C++17` 标准,但由于并未使用高级特性,构建标准可自行调整;
完善构建环境后,在工作目录下使用 `make``mingw32-make` 即可进行构建;
本工具仅使用标准库,完全具备跨平台支持,但在其他平台、环境下需要对 `Makefile` 进行少量修改;
## 主要目录及说明
Git-Storage 本仓库目录
├─.vscode 用于vscode的配置文件
│ ├─c_cpp_properties.json VsCode感知引擎配置需要C/C++插件)
│ ├─launch.json VsCode调试运行配置需要C/C++插件)
│ └─tasks.json VsCode预构建脚本
├─Inc 头文件
│ └─(...)
├─Src 源文件
│ └─(...)
├─Img 本仓库的图片资源文件
│ └─(...)
├─Test 测试用文件
│ └─Lauterbach-SNOOPer.txt 测试用文件SNOOPer输出
├─.gitignore 仓库忽略文件
└─Makefile 编译构建所用的Makefile