【Autosar CP通用 1.如何阅读Autosar官方文档】

很多小伙伴们可能没有全部系列的下载过Autosar官方文档，知道大家都很懒，我的下载目录下整理了所有的Autosar文档，同时进行了一个简单的分类（如下面图），大家有兴趣可以自己下载，这次的下载可能需要1元钱，收这一元钱并不是为了赚钱什么的，就是当作对自己的一个奖励，这样我才会觉得自己的价值得到认可，同时希望大家能够珍惜重视别人的劳动成果！
好的我们废话不多说，进入今天的正题：如何阅读Autosar官方文档！！！

AUTOSAR文档类型

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

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

我们可能需要关注或者是用到比较多的是上面红框的文档 SWS

文档里面的每部分内容都有它存在的道理，胡乱地翻看是很难摸清它的思路的。打开其中一个文档（例如：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 System

AUTOSAR_SRS_OS.pdf

[3] General Requirements on Basic Software Modules

AUTOSAR_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”，跟需求的溯源，即实现的功能是根据哪个需求来的，这里面有一一对应的关系。

下面是重点

7.Functional Specification 这个章节详细介绍了这个模块有哪些功能，功能的需求是什么样的，有什么要求等等，所以说读懂这个章节，你就知道这个模块是干什么用的了，实现原理是怎么样的

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”，这一章内容也非常重要，从这里能清晰地看到各种时序的动态行为，对理解这个模块是非常有帮助的。