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從傳統的數據記錄工具，躍升為可擴展、智能化的數據記錄儀。