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

LTL簡介

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

應(yīng)用場景

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

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

參數(shù)化測試配置

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

多實(shí)例集成

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

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

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

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

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

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

注釋頭（Comment Header）：用于定義文件說明、參數(shù)及相關(guān)信息。用戶可以通過VLS創(chuàng)建Include File模板（圖1所示）并填寫以下關(guān)鍵字內(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界面中設(shè)置。示例代碼（圖4所示）。

圖4 Parameter代碼示例

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

圖5 VLS顯示

Keyword：Instance

用于定義實(shí)例編號，用于區(qū)分同一個Include File的不同調(diào)用實(shí)例，實(shí)現(xiàn)多實(shí)例復(fù)用。示例代碼（圖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ǎn)，若邏輯順序重要時可手動調(diào)整。示例代碼（圖10-11所示）。

圖10 Positon代碼示例

圖11 Positon代碼示例

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

圖12 示例代碼

應(yīng)用案例

1.

多實(shí)例集成

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

圖13 多實(shí)例集成示例

2.

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

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

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

圖14 LED設(shè)置

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

圖15 Beep設(shè)置

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

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

圖16 inc文件示例

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

圖17 添加Include文件

總結(jié)

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

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

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

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