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

Autosar官方文档
（这个因为是国外的网站，所以进入可能有些慢，实在不行切换热点）

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

![在这里插入图片描述](https://img-blog.csdnimg.cn/2f6eb493594b4b0b9ff671fffe51f27c.png

AUTOSAR文档类型

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

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

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

AUTOSAR文档之间的联系

不同的人群关注的文档可能不一样，类如：
关注架构设计的读者应该阅读AUTOSAR Template Specification（TPSs）.比如说，如果读者关注逻辑系统/ECU设计，他们应该关注Software Component template，以理解怎么去定义应用软件组件（Application Software components）以及数据交互点。
对于一些在各个Template都用的通用概念可以在Generic Structure Template中获取，但是最好通过索引参考的方式去Generic Structure Template里找，因为一下理解整个文档挑战太大。

使用UML定义的AUTOSAR Meta-model没有太大必要单独去看，因为所有相关信息和图表都会在AUTOSAR Template Specification里有。

关注AUTOSAR基础软件的读者应该去读相关基础软件模块的软件规范-Software Specification（SWS）。比如说，如果读者对ECU诊断功能感兴趣，他们应该去都AUTOSAR Diagnostic Event Manager和Diagnostic Configuration Manager规范。对所有的基础软件模块都适用的需求可在Basic Software Modules Specification里的General Requirements里获取到。

更高颗粒度层面，TPS规范里的设计需求可以追溯到需求规范文档（RS）的描述的更详细需求。同样地，SWS Specification里定义的基础软件需求也从software requirements specifications（SRS）里追溯的到。RS和SRS需求可以从更高层面的规范里追溯的到，描述General AUTOSAR features和AUTOSAR Objectives的规范就是High-level的一个例子。然后，还是建议初学者要集中关注TPS和SWS Specification，至少在一开始，TPS和SWS包含很多解释和图形以助于更好的理解AUTOSAR Features。

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