本文框架
- 1. 前言
- 2. ASAP2 Tool-Set系统介绍
- 2.1 ASAP2 Creator介绍
- 2.2 ASAP2 Updater介绍
- 2.3 ASAP2 Merger介绍
- 2.4 ASAP2 Comparer及Checker介绍
- 2.5 ASAP2 Modifier介绍
- 2.6 ASAP2 Studio介绍
- 3. 项目实操说明
- 3.1 项目实操建议
- 3.2 工具下载地址及使用
1. 前言
在XCP观测及标定整个开发过程中，A2l文件的生成是非常重要的一环，在前面的文章中也介绍了一些A2l相关的介绍，比如：
A2l文件的格式解析，XCP实战系列介绍02-A2L文件详尽解析，
基于ASAP2 Editor生成A2l文件过程介绍XCP实战系列介绍07-使用ASAP2 Editor生成A2l文件详解，
本文将基于vector公司的ASAP2 Tool-Set工具介绍A2l文件的生成及相关的工具进行功能性介绍，后续有时间会在实战篇中更新一篇如何在项目中更好应用及配套脚本开发的文章。
2. ASAP2 Tool-Set系统介绍
ASAP2 Tool-Set 工具是由一系列脚本工具组成，包括：ASAP2 Creator, ASAP2 Updater, ASAP2
Merger, ASAP2 Comparer, ASAP2 Checker, ASAP2 Modifier and ASAP2 Studio.
各工具使用的前后顺序如下图所示：
2.1 ASAP2 Creator介绍
ASAP2 Creator 根据代码中的特殊注释生成一个ASAP2 片段文件，注意这里需要根据工具要求在代码中添加特殊的注释，比如对于标定量，观测量等对应的注释类型是不同的，这里生成的A2l中变量的地址默认为0；
在操作前，代码中特殊标记添加特殊的记号，脚本通过识别这些符号来对应的生成，例如对于一个uint8类型的观测量sample1 需要添加的内容如下
/*
@@ SYMBOL = sample1
@@ A2L_TYPE = MEASURE
@@ DATA_TYPE = UBYTE
@@ END
*/
uint8 sample1;
对于变量类型A2L_TYPE，如观测/标定/curve/map/String等需要根据实际需要进行配置，也可以对变量配置特殊的Compu_Method，另外在ASAP2Creator.ini文件中也可以对生成的规则进行单独配置。
2.2 ASAP2 Updater介绍
ASAP2 Updater 会基于编译生成的.map文件更新A2l文件中变量或者的地址信息；
在这里可以导入.map文件或.elf文件，选择不同的文件类型需要在Updater.ini中对MAP_FORMAT进行配置。
2.3 ASAP2 Merger介绍
ASAP2 Merger 可以将多个A2l文件合并到一起，比如对于开发中应用层可能会基于matlab模型生成一个a2l，BSW部分开发也会生成一个A2l，这样就可以基于ASAP2 Merger将两个A2l文件合并到一起，生成一个最终可用的A2l文件；
2.4 ASAP2 Comparer及Checker介绍
ASAP2 Comparer 可以用于比较两个A2l文件；
ASAP2 Checker 可用于校验A2l文件，对给定的ASAP2文件执行语法检查及合理性检查；
目前两个工具已经被集成在ASAP2 Studio中，可以通过ASAP2 Studio对A2l文件进行检查及对比。
2.5 ASAP2 Modifier介绍
ASAP2 Modifier 可对A2l文件进行修改；
2.6 ASAP2 Studio介绍
ASAP2 Studio 相对于项目的众多脚本文件，其是一个可视化的工具，A2l中的所有的信息都能被看到，目前也集成了一些前面的功能，例如在15.0版本中集成了ASAP2 Checker，ASAP2 Modifier及ASAP2 Updater.
3. 项目实操说明
3.1 项目实操建议
在实际项目中推荐大家按工具的使用流程，熟悉工具的约束及使用规则，毕竟ASAP2 Tool-Set是封装好的工具，先熟悉规则再应用落地；
在开发中可开发配套的代码symbol（特殊标记）生成的脚本，再将脚本进行封装，后面也可以跟大家分享一下这块的开发思路；
最后一个就是在特殊标记添加中，可能会遇到很多复杂特殊处理，如结构体多层嵌套，特殊计算方法的使用等，在使用该工具时可能会稍微复杂些。
3.2 工具下载地址及使用
工具下载链接：
Vector下载中心 ASAP2 Tool-Set
在下载安装完成后可以在安装文件夹中看到对应的demo示例，如：C:\Program Files\Vector\ASAP2 Tool-Set 15.0\Examples
另外在安装文件夹中也有对工具的详细使用指导，如配置项设置，不同类型的变量如何添加对应的symbol信息等，本文仅仅是简单的抛砖引玉，帮大家推荐一个额外的A2l生成及检查方案。
注：工具的使用需要跟vector申请购买相应的license。
最后如您对XCP实战部分有其他需求，可移步到XCP实战专栏，看是否有您需要的内容，实战系列导读快速链接：XCP实战系列导读
