Include File（inc文件）是Vector Logger Suite（VLS）中使用LTL代碼片段的關鍵機制。通過Include File，用戶可以在LTL代碼中靈活定義參數(shù)、觸發(fā)條件和信號處理邏輯，并可通過圖形化界面（GUI）進行配置，將其集成到VLS的主配置文件（glc文件）中。借助inc文件，用戶可以實現(xiàn)更復雜、更靈活的功能配置，滿足多樣化的應用需求。

LTL簡介

LTL（全稱Log Task Language）是VLS編譯配置文件時采用的核心編程語言，專為Logger設備設計。VLS提供圖形化界面，幫助用戶輕松連接并配置GL Logger，實現(xiàn)高效的數(shù)據(jù)記錄。在大多數(shù)場景下用戶可以通過VLS快速完成設備配置。對于更加復雜，個性化的需求，用戶則可以通過編輯LTL代碼實現(xiàn)高度定制化的功能。

應用場景

復雜觸發(fā)邏輯的封裝

將多個觸發(fā)條件組合在一個文件中，便于統(tǒng)一管理和復用，提高配置效率。

參數(shù)化測試配置

支持定義輸入?yún)?shù)、返回參數(shù)和實例參數(shù)，適用于不同測試場景的快速切換，提升測試靈活性。

多實例集成

在同一個項目中多次調(diào)用同一個inc文件，通過實例參數(shù)區(qū)分不同用途，實現(xiàn)資源復用。

信號處理與事件觸發(fā)

利用返回參數(shù)與信號值，實現(xiàn)基于總線數(shù)據(jù)的事件觸發(fā)機制，滿足復雜邏輯需求。

應用方式與文件結(jié)構(gòu)

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

Include File主要組成：注釋頭（Comment Header）和核心代碼區(qū)（Code Section）。

注釋頭（Comment Header）：用于定義文件說明、參數(shù)及相關信息。用戶可以通過VLS創(chuàng)建Include File模板（圖1所示）并填寫以下關鍵字內(nèi)容：

圖1 Include File模板

Keyword：Purpose/Purpose End

用于說明文件的功能，內(nèi)容會顯示在VLS界面中。示例代碼（圖2所示）。

圖2 Purpose代碼示例

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

圖3 VLS顯示

Keyword：Parameter

用于定義參數(shù)，占位符%1%可以通過VLS界面中設置。示例代碼（圖4所示）。

圖4 Parameter代碼示例

Parameter參數(shù)值可以設置為常量值或信號值，信號值會以原始形式傳遞給Include File（圖5所示）。

圖5 VLS顯示

Keyword：Instance

用于定義實例編號，用于區(qū)分同一個Include File的不同調(diào)用實例，實現(xiàn)多實例復用。示例代碼（圖6所示）。

圖6 Instance代碼示例

VLS示例（圖7所示）。

圖7 VLS顯示

Keyword：Return

用于聲明返回參數(shù)。Include File中定義的變量可作為返回值被VLS調(diào)用。一個Include File可包含多個返回參數(shù)，支持多輸出場景。參數(shù)包括LTL腳本變量名，界面顯示名稱以及函數(shù)返回值說明。示例代碼（圖8所示）。

圖8 Return代碼示例

VLS示例（圖9所示）。

圖9 VLS顯示

Keyword：Position

用于指定Include File在LTL代碼中的插入位置。系統(tǒng)通常自動確定最佳插入點，若邏輯順序重要時可手動調(diào)整。示例代碼（圖10-11所示）。

圖10 Positon代碼示例

圖11 Positon代碼示例

核心代碼區(qū)（Code Section）：用戶可根據(jù)LTL語言規(guī)則編寫邏輯，實現(xiàn)各類功能模塊。例如下面的代碼，可實現(xiàn)串口（UART）數(shù)據(jù)采集，每8個字節(jié)打包并以CAN總線方式存儲。示例代碼（圖12所示）。

圖12 示例代碼

應用案例

1.

多實例集成

用戶需要GL Logger同時采集兩個通道的串口數(shù)據(jù)，可以在VLS中將同一Include File加載兩次，并根據(jù)實際采集需求對參數(shù)進行實例化，實現(xiàn)多通道采集的靈活配置。示例如圖13所示。

圖13 多實例集成示例

2.

復雜觸發(fā)邏輯觸發(fā)

用戶需要GL Logger長時間記錄數(shù)據(jù)，并希望實時監(jiān)控內(nèi)存卡使用情況。當存儲空間達到95%時，LED1指示燈應點亮以提示狀態(tài)?？蛻暨€注意到在觸發(fā)事件時記錄儀可發(fā)出Beep聲，于是希望在存儲空間接近滿載（Almost Full）時，同時點亮LED4并發(fā)出提示音。

VLS軟件中，用戶可以在LED選項下直接配置存儲空間達到95%時，指定LED點亮（圖14所示），但是無法直接配置同時發(fā)出Beep。

圖14 LED設置

客戶注意到當設置條件觸發(fā)記錄時，記錄儀在事件觸發(fā)時可以發(fā)出Beep聲提示（圖15所示），客戶希望內(nèi)存使用達到95%的時候LED點亮并發(fā)出提示音。

圖15 Beep設置

針對該需求，通過VLS無法進行直接設置。用戶可以通過加載自定義Include File文件，利用LTL代碼實現(xiàn)VLS標準界面無法覆蓋的功能。

編寫LTL代碼并保存成inc格式文件（圖16所示）。

圖16 inc文件示例

在VLS中加載該文件，即可實現(xiàn)當硬盤存儲接近滿載時，LED4點亮且發(fā)出Beep聲（圖17所示）。

圖17 添加Include文件

總結(jié)

Include File是Vector Logger Suite實現(xiàn)高級功能與邏輯復用的核心機制。

通過參數(shù)化定義、多實例支持、返回值聲明及靈活的嵌入式腳本結(jié)構(gòu)，用戶可在VLS 中輕松構(gòu)建復雜的觸發(fā)邏輯與定制化采集功能，顯著提升配置靈活性和可維護性。

除了多實例集成與事件觸發(fā)外，Include File還廣泛用于Channel Mapping、TCP/UDP、DLT、ADB數(shù)據(jù)采集等高級配置場景。結(jié)合VLS圖形化界面，Include File有效降低了重復開發(fā)與腳本維護成本。

對于需要應對復雜邏輯控制、跨項目復用或特殊測試需求的工程師而言，Include File是連接標準化配置與個性化定制的關鍵橋梁，使VLS從傳統(tǒng)的數(shù)據(jù)記錄工具，躍升為可擴展、智能化的數(shù)據(jù)記錄儀。