Include File解锁Vector Logger Suite高阶功能

Include File（inc文件）是Vector Logger Suite（VLS）中使用LTL代码片段的关键机制。通过Include File，用户可以在LTL代码中灵活定义参数、触发条件和信号处理逻辑，并可通过图形化界面（GUI）进行配置，将其集成到VLS的主配置文件（glc文件）中。借助inc文件，用户可以实现更复杂、更灵活的功能配置，满足多样化的应用需求。

LTL简介

LTL（全称Log Task Language）是VLS编译配置文件时采用的核心编程语言，专为Logger设备设计。VLS提供图形化界面，帮助用户轻松连接并配置GL Logger，实现高效的数据记录。在大多数场景下用户可以通过VLS快速完成设备配置。对于更加复杂，个性化的需求，用户则可以通过编辑LTL代码实现高度定制化的功能。

应用场景

复杂触发逻辑的封装

将多个触发条件组合在一个文件中，便于统一管理和复用，提高配置效率。

参数化测试配置

支持定义输入参数、返回参数和实例参数，适用于不同测试场景的快速切换，提升测试灵活性。

多实例集成

在同一个项目中多次调用同一个inc文件，通过实例参数区分不同用途，实现资源复用。

信号处理与事件触发

利用返回参数与信号值，实现基于总线数据的事件触发机制，满足复杂逻辑需求。

应用方式与文件结构

在VLS中，用户可以通过界面便捷地添加、新建、替换或移除Include File。

Include File主要组成：注释头（Comment Header）和核心代码区（Code Section）。

注释头（Comment Header）：用于定义文件说明、参数及相关信息。用户可以通过VLS创建Include File模板（图1所示）并填写以下关键字内容：

图1 Include File模板

Keyword：Purpose/Purpose End

用于说明文件的功能，内容会显示在VLS界面中。示例代码（图2所示）。

图2 Purpose代码示例

VLS界面显示“This is a sample for test”（图3所示）。

图3 VLS显示

Keyword：Parameter

用于定义参数，占位符%1%可以通过VLS界面中设置。示例代码（图4所示）。

图4 Parameter代码示例

Parameter参数值可以设置为常量值或信号值，信号值会以原始形式传递给Include File（图5所示）。

图5 VLS显示

Keyword：Instance

用于定义实例编号，用于区分同一个Include File的不同调用实例，实现多实例复用。示例代码（图6所示）。

图6 Instance代码示例

VLS示例（图7所示）。

图7 VLS显示

Keyword：Return

用于声明返回参数。Include File中定义的变量可作为返回值被VLS调用。一个Include File可包含多个返回参数，支持多输出场景。参数包括LTL脚本变量名，界面显示名称以及函数返回值说明。示例代码（图8所示）。

图8 Return代码示例

VLS示例（图9所示）。

图9 VLS显示

Keyword：Position

用于指定Include File在LTL代码中的插入位置。系统通常自动确定最佳插入点，若逻辑顺序重要时可手动调整。示例代码（图10-11所示）。

图10 Positon代码示例

图11 Positon代码示例

核心代码区（Code Section）：用户可根据LTL语言规则编写逻辑，实现各类功能模块。例如下面的代码，可实现串口（UART）数据采集，每8个字节打包并以CAN总线方式存储。示例代码（图12所示）。

图12 示例代码

应用案例

1.

多实例集成

用户需要GL Logger同时采集两个通道的串口数据，可以在VLS中将同一Include File加载两次，并根据实际采集需求对参数进行实例化，实现多通道采集的灵活配置。示例如图13所示。

图13 多实例集成示例

2.

复杂触发逻辑触发

用户需要GL Logger长时间记录数据，并希望实时监控内存卡使用情况。当存储空间达到95%时，LED1指示灯应点亮以提示状态。客户还注意到在触发事件时记录仪可发出Beep声，于是希望在存储空间接近满载（Almost Full）时，同时点亮LED4并发出提示音。

VLS软件中，用户可以在LED选项下直接配置存储空间达到95%时，指定LED点亮（图14所示），但是无法直接配置同时发出Beep。

图14 LED设置

客户注意到当设置条件触发记录时，记录仪在事件触发时可以发出Beep声提示（图15所示），客户希望内存使用达到95%的时候LED点亮并发出提示音。

图15 Beep设置

针对该需求，通过VLS无法进行直接设置。用户可以通过加载自定义Include File文件，利用LTL代码实现VLS标准界面无法覆盖的功能。

编写LTL代码并保存成inc格式文件（图16所示）。

图16 inc文件示例

在VLS中加载该文件，即可实现当硬盘存储接近满载时，LED4点亮且发出Beep声（图17所示）。

图17 添加Include文件

总结

Include File是Vector Logger Suite实现高级功能与逻辑复用的核心机制。

通过参数化定义、多实例支持、返回值声明及灵活的嵌入式脚本结构，用户可在VLS 中轻松构建复杂的触发逻辑与定制化采集功能，显著提升配置灵活性和可维护性。

除了多实例集成与事件触发外，Include File还广泛用于Channel Mapping、TCP/UDP、DLT、ADB数据采集等高级配置场景。结合VLS图形化界面，Include File有效降低了重复开发与脚本维护成本。

对于需要应对复杂逻辑控制、跨项目复用或特殊测试需求的工程师而言，Include File是连接标准化配置与个性化定制的关键桥梁，使VLS从传统的数据记录工具，跃升为可扩展、智能化的数据记录仪。