如何阅读AUTOSAR官方文档

注： 本文首发于微信公众号“嵌入式软件实战派”，关注获得更多内容。

AUTOSAR有哪些标准文档

Classic Platform

AUTOSAR Classic Platform体系结构在运行在微控制器上的三个软件层之间的最高抽象层上有所区别：应用程序，运行时环境（RTE）和基本软件（BSW）。

应用软件层主要与硬件无关。
软件组件之间的通信以及通过RTE访问BSW。
RTE代表应用程序的完整接口。
BSW分为三个主要层和复杂的驱动程序：Services, ECU (Electronic Control Unit) abstraction和microcontroller abstraction。
服务进一步分为代表系统，内存和通信服务基础架构的功能组。

Adaptive Platform

AUTOSAR Adaptive Platform为Adaptive Applications（ARA）实现AUTOSAR运行时。 提供两种类型的接口：Service和API。 该平台由按服务和Adaptive AUTOSAR基础分组的功能集群组成。

Foundation

Foundation标准的目的是增强AUTOSAR平台之间的互操作性。
Foundation包含在AUTOSAR平台之间共享的通用要求和技术规范（例如协议）。

AUTOSAR Acceptance Test

AUTOSAR Acceptance Test 是在总线级别以及在应用程序级别的系统测试，目的是验证AUTOSAR Stack 相对于应用程序软件组件以及通信总线的行为。
验收测试可用于验证网络中不同AUTOSAR Stack的互操作性。 AUTOSAR提供的测试用例涵盖RTE要求、基本软件服务、库以及总线行为和总线协议。
另外，AUTOSAR提供了一种方法，用户可以使用它来扩展标准测试套件。

Application Interface

AUTOSAR在以下六个车辆领域的语法和语义方面对大量的应用程序接口进行了标准化：车身和舒适性，动力总成发动机，动力总成传动系统，底盘控制，乘员和行人安全以及HMI，多媒体和远程信息处理。

重点是完善应用程序的接口规范，以强调软件重用和交换，这被认为是AUTOSAR的主要要求之一。标准化应用程序接口的部署是重复使用应用程序的关键因素。

如何下载AUTOSAR标准文档

这里以Classic Platform为例。

下载最新版本

在Classic Platform页面上，点击框架图上的你想下载部分的模块的文档，例如System Service

然后勾选你想要下载的具体的文档，最后点击下载

下载历史版本

点击你想下载的版本的链接如下图：

然后选择你想下载的模块的文档。

以上文档，请在官方网站下载，如果下载有困难，可以关注“嵌入式软件实战派”公众号，回复“AUTOSAR Doc”获得下载链接。

文档的类型

先看看文档的名字，是不是好像有分类的，SRS、SWS、TR……

这些各代表什么意思呢？
以下我对这些名称缩写做了个总结：

缩写	全称	相关解释
CP	CLASSIC PLATFORMAUTOSAR	经典平台，相对于ADAPTIVE PLATFORM而言
EXP	EXPLANATORY DOCUMENTS	更详细的介绍论题MODMODEL介绍建模的原理
RS	REQUIREMENTS SPECIFICATION	详细描述需求
SRS	SOFTWARE REQUIREMENT SPECIFICATION	所有软件模块的规格描述
SWS	SOFTWARE SPECIFICATION	软件模块设计和实现的规格
TPS	TEMPLATE SPECIFICATION	模板详细介绍
TR	TECHNICAL REPORT	技术规格详细介绍

文档里面的每部分内容都有它存在的道理，胡乱地翻看是很难摸清它的思路的。打开其中一文档（例如：AUTOSAR_SWS_OS.pdf）看看，它里面有哪些内容，以下简单挑几个讲解下：

“1 Introduction and functional overview”，这个是概览性的，即这个文档大概有什么内容或功能，达到什么目的等等，看这个就你可以大概了解这个文档是不是你想看的那个，有没有你要获取的内容。

This document describes the essential requirements on the AUTOSAR OperatingSystem to satisfy the top-level requirements presented in the AUTOSAR SRS [2].

“ 3 Related documentation”，这个文档的功能需要参考哪些文档或者依赖哪些文档。

3.1 Input documents[1] Layered Software ArchitectureAUTOSAR_EXP_LayeredSoftwareArchitecture.pdf[2] Requirements on Operating SystemAUTOSAR_SRS_OS.pdf[3] General Requirements on Basic Software ModulesAUTOSAR_SRS_BSWGeneral.pdf……

“ 5 Dependencies to other modules”，这一章节描述的是当前文档的内容会依赖其他哪些模块，与那些模块会有怎样的管理，即使当前文档不强制依赖其他模块，也会讲一些相关联的内容，如这个OS的文档。

There are no forced dependencies on other modules, however:
* It is assumed that the operating system may use timer units directly to drive counters.
* If the user needs to drive scheduling directly from global time, then a global time interrupt is required.
* If the user needs to synchronize the processing of a schedule table to a global time, the operating system needs to be told the global time using the SyncScheduleTable() service.

“ 6 Requirements Traceability”，跟需求的溯源，即实现的功能是根据哪个需求来的，这里面有一一对应的关系。

“ 8 API specification”，这个内容是比较重要的，里面详细描述了该文档的数据类型定义、宏定义、错误码含义，以及函数接口的详细描述和约束。

This chapter contains the APIs offered by the operating system. Note that not all services are available in all scalability classes, and that the behavior of some services is extended for specific scalability classes. For example, API to relatively start a schedule table has an additional check if the schedule table allows implicitsynchronization. This check is only performed in SC2 and SC4 where synchronization of schedule tables is supported.

“ 9 Sequence diagrams”，这一章内容也非常重要，从这里能清晰地看到各种时序的动态行为，对理解这个模块是非常有帮助的。

“ 11 Generation of the OS”，OS模块的生成关系，即一些关于工具和OS模块的配置生成相关的内容。

……

标准模块被实现后的文档

以上，这些是AUTOSAR官方的定义的理论内容，还要实施这些理论，一般做这个事的有Vector、EB等大企业。以Vector的为例，当你要做一个AUTOSAR项目的时候，需要从Vector那里购买SIP包，从这个SIP包里面可以找到一些参考文档，叫“TechnicalReference”文档。这些文档讲的是Vector是如何实现这些AUTOSAR标准的，以及给用户提供一些使用指导说明。还是以这个OS为例：

它会告诉你当前你阅读的这个文档对应的模块是处于AUTOSAR哪个位置层次的。

还有一些具体的Vector实现这个OS的详细的概念描述和使用指导等等