1 概述
1.1 介紹
使用CCP和XCP作爲測量和校準協議的一個先決條件是有一個ASAP2描述文件。可以使用ASAP2工具集來創建和檢查這種文件。這些六個控制檯程序是使用初始化文件配置的,因此可以很容易地集成到批處理中進行處理。ASAP2編輯器還爲您提供了一個額外的便捷工具,可以通過基於對話框的用戶界面來輸入和編輯所有信息。
> 自動基於C代碼的註釋,生成ASAP2文件。
> 在ASAP2文件中更新地址和數據類型信息。
> 將多個ASAP2文件合併到一個聯合文件中。
> 比較兩個ASAP2文件,並以不同的格式輸出結果文檔。
> 檢查ASAP2文件的句法和語義錯誤。
> 使用搜索過濾器對ASAP2文件進行特定的修改和優化。
> 編輯器是創建和查看標準化的ECU描述文件的簡單方案。
1.2 優勢的概述
> 在編輯A2L格式的ECU描述文件中,ASAP2工具集提供了廣泛和簡單的支持。
> 可以將程序集成到Makefile過程中。
> 可以將警告和錯誤消息存儲在日誌文件中。通過退出代碼來檢查運行結果。
> 在ASAP2編輯器中使用基於對話框的用戶界面,可以方便地創建、修改和更新ECU描述文件。
> 可以讀取ASAM發佈的所有版本,包括最新的1.70版本。因而,支持UTF8和UTF16編碼的文件。可以生成1.40版本和更高版本的ASAP2格式文件。
> 從鏈接器映射文件或調試文件中,容易地得到地址和數據類型信息。
> 甚至對不符合標準的A2L文件,在調節範圍內能夠讀取。
> 基於指定的元語言,對ASAP2文件的接口規範進行了一般性的解析,這樣就不存在對支持的IF_DATA類型的限制。
圖1:使用ASAP2 Creator、Updater和Merger的自動ASAP2生成過程。
使用ASAP2 Comparer和Modifier,來比較和具體的修改ASAP2文件。
使用ASAP2 Checker來檢查ASAP2文件的語法和語義錯誤。
1.3系統需求
> Windows 10/8.1/8/7/Vista (Vista僅32位)
2 功能
2.1 ASAP2 Creator
使用ASAP2 Creator的先決條件是,必須在C代碼中插入註釋。在這些註釋中,定義了ASAP2相關的信息,如數據類型、轉換規則、min-max條件、結構、數組等。
> 可以通過使用宏來集中存儲信息值。
> ASAP2 Creator會讀取這些補充信息,並且根據這些信息針對註釋所描述的對象來生成ASAP2片段。
> 這個解決方案的一個關鍵優勢在於單一來源的原則,因爲補充信息是一併存儲在代碼的參數定義部分。
> 集成的合併功能確保了,會考慮到在後續的生成過程中,對自動生成的ASAP2片段的修改。
> 通過支持結構和其它變體,極大地減少了在代碼註釋中的描述工作量。
2.2 ASAP2 Updater
ASAP2 Updater讀取ASAP2源文件,根據鏈接器映射文件中的條目,來更新所有地址和數據類型信息,並從該信息生成一個新的ASAP2文件。
> 支持當前最流行的鏈接器映射文件和調試文件格式,例如IEEE、COFF、ELF/DWARF、EXE/DWARF和許多編譯器的ASCII映射格式。
> 地址信息會被更新到所有的測量和校準參數、內存段和基於指針的校準方法,以及不同的編碼。
> 您可以使用集成的過濾器功能,來隱藏某些對象或對象組。
> 可以對鏈接器映射文件,在可配置的地址範圍,生成額外的ASAP2對象。
> 對於枚舉變量,可以從映射文件的信息,自動生成轉換方法。
> 通過刪除冗餘信息,可以最小化生成的ASAP2文件的大小。
2.3 ASAP2 Merger
ASAP2 Meger將幾個ASAP2文件合併到一個普通的ASAP2文件中。其中一個源文件必須被確定爲主文件,其他源文件是從文件。主文件的所有的信息都被用到最終ASAP2文件,從文件則只有測量和校準對象、轉換規則、功能、組和記錄的佈局會被考慮。對於每個從文件,必須定義每個模塊必須鏈接到主文件的哪個模塊。在生成的ASAP2文件中,有一個用於接收後綴的選項,該後綴表示這些對象來自哪個源文件。還可以檢查名稱衝突,並在必要時生成新的惟一名稱。源文件的包含結構可以保存到生成的ASAP2文件中。
2.4 ASAP2 Comparer
您可以使用ASAP2 Comparer對兩個ASAP2文件進行快速簡單的比較。對相同命名的對象,可以通過一個初始化文件來指定對內容的比較方式。在同義詞典的幫助下,可以比較不同名稱的測量和參數對象。比較結果可以記錄在文本、CSV、XML或Excel格式的文件中。對兩個A2L文件的比較也包括所引用的對象。
2.5 ASAP2 Checker
並非每個A2L文件都符合標準。爲了保證整個工具鏈的高可靠性,根據標準對A2L文件進行校驗,並指出偏差。除了語法檢查外,還可以執行更廣泛的語義可信性檢查。
ASAP2 Checker自動糾正一系列語義錯誤,生成一個新的、正確的ASAP2文件。語法檢查和語義可信性檢查的結果,會呈現爲組織清晰的HTML格式的報告。
2.6 ASAP2 Modifier
ASAP2 Modifier允許用戶以特定的方式修改ASAP2文件。一些支持的修改是:
> 根據任何需要的搜索條件(名稱、註釋、地址、對象屬性等),對ASAP2文件進行復雜的過濾。對搜索過濾的結果可以從ASAP2文件中刪除,也可以被提取到一個單獨的文件中,該文件自動鏈接到主文件。
> ASAP2文件的配置優化(通過刪除冗餘信息減少文件大小)。
> 校正功能(從ASAP2文件中刪除無效的關鍵字和引用,可以替換對象名稱中的無效字符)。
> 在ASAP2文件中刪除信息(逐步的:註釋、頭、AML、IF_DATA等)。
> 對象屬性的修改(如地址偏移、寫保護等)。
> 在模式的幫助下重命名變量。
2.7 ASAP2 Editor
便利的ASAP2 Editor用於創建、修改和更新ASAP2版本1.x格式的ECU描述文件。ASAP2 Editor在開發過程中是最佳集成的。例如,當使用ASAP2 Editor創建數據庫對象時,可以從鏈接器映射文件或調試文件中獲取地址和數據類型信息。ASAP2 Editor是集成在CANape中的“獨立”版本的數據庫編輯器。
ASAP2 Editor提供以下功能:
> 所有信息都可以在Windows對話框中輸入和更改。
> ECU描述可以在ASAP2和CANape格式中讀取,也可以保存在這些格式中。
> 宏和模板文件還可以用於導出,任何想要的用戶自定義的ASCII格式的ECU描述。
> 可以選擇導出單個數據庫對象,就像可以從其它ASAP2文件導入單個對象。
> 可以使用鏈接映射文件或調試文件,自動更新地址和數據類型信息。所有常用的鏈接映射文件和調試格式都被支持,如IEEE、ELF/DWARF、COFF和PDB。
> 加密保存的A2L文件,可以保護數據免受未經授權的更改,即使是其它的工具。
> 以可配置的容忍度,(非標準一致性)A2L文件也可以被讀取。
> 各種可信性檢查可以檢測到,諸如地址重疊、重複對象名稱、無效引用等錯誤。
> 集成比較功能允許用戶確定ASAP2文件的差異。
> 在對對象名稱進行分析時,自動生成軟件結構,便於導航。
> 許多操作都允許用戶同時選擇多個對象,並將其屬性一併更改,從而加速了工作流程。
> 所有的有適合的AML描述的IF_DATA信息,都可以在編輯器中進行編輯。
> 可以通過拖放操作,從Windows資源管理器中打開A2L文件。
> 可以讀入壓縮的ASAP2文件。
> 用戶自定義的過濾器來簡化導航。
圖2:ASAP2 Editor中的特徵映射的配置。
轉載: