【ETAS CP AUTOSAR工具链】ARXML文件详解

本篇文章首先对ARXML这种文件格式做了一个概述,叙述了这种标签语言的基本语法(如果您用HTML做过网页,那么这种格式您一定不会陌生),然后对ARXML文件都会包含的一些基本信息做了详细的解读,最后基于使用ISOLAR-AB从A到B的开发过程,将涉及到的ARXML文件进行了详细的解析。

文中对ARXML实例的解析希望能帮助读者更直观的了解ARXML文件(ARXML文件的内容构成和文件内属性相互引用的关系本身就是对AUTOSAR标准的实现),从而更好的理解AUTOSAR标准。

目录

ARXML概述

ARXML解读 

ISOLAR A:ARXML文件实例分析

应用组件类型

系统

FlatMap 

部件类型

ISOLAR B:ARXML文件实例分析

模块配置

服务软件实例描述

基础软件实例描述


ARXML概述

ARXML文件实质是一个XML(Extensible Markup Language)文件,通过AUTOSAR标准的XSD(XML Schema Definition)文件进行约束,XML文档必须包含根元素。该元素是所有其他元素的父元素。XML 文档中的元素形成了一棵文档树。这棵树从根部开始,并扩展到树的最底端。
所有的元素都可以有子元素。下面是一个XML的树形结构和对应的文档示例(例子来自菜鸟教程)。

<bookstore>
    <book category="COOKING">
        <title lang="en">Everyday Italian</title>
        <author>Giada De Laurentiis</author>
        <year>2005</year>
        <price>30.00</price>
    </book>
    <book category="CHILDREN">
        <title lang="en">Harry Potter</title>
        <author>J K. Rowling</author>
        <year>2005</year>
        <price>29.99</price>
    </book>
    <book category="WEB">
        <title lang="en">Learning XML</title>
        <author>Erik T. Ray</author>
        <year>2003</year>
        <price>39.95</price>
    </book>
</bookstore>

针对ARXML文件,虽然ISOLAR-AB工具不仅提供了可视化的界面用于配置与生成,并且提供了AUTOSAR Explorer用于查看和编辑具体的ARXML文件,但是作为我们经常打交道的文件,照葫芦画瓢难免落得一个一知半解的结果,下面我们基于规范《AUTOSAR_TPS_GenericStructureTemplate.pdf》来理解一下ARXML文件的内容。


ARXML解读 

内容第一行是文档的声明,包含文档版本和文档字符编码。

<?xml version="1.0" encoding="UTF-8"?>

文件第一级元素是根元素,每个文档有且只有一个根元素,元素由开始标签、元素内容、结束标签组成。

<AUTOSAR xmlns="http://autosar.org/schema/r4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://autosar.org/schema/r4.0 AUTOSAR_4-2-2.xsd">
...元素内容...
</AUTOSAR>

 标签中的属性完成了XSD与命名空间的绑定,标签其中包含一下属性说明如下。

  • xmlns:xml NameSpace的缩写,表明文档元素的命名空间,避免命名冲突。命名空间的声明是默认的,元素前不用添加前缀。
  • xmlns:xsi:又定义了一个命名空间,前缀为xsi ,对应http://www.w3.org/2001/XMLSchema-instance,其通常作为XSD的命名空间。
  • xsi:schemaLocation:xsi命名空间下schemaLocation属性,后边跟的两个值分别为命名空间 命名空间对应的XSD。

第二级为AUTOSAR包集合,里边包含了各个定义在此文件内的AUTOSAR包。

<AR-PACKAGES>
...
</AR-PACKAGES>

第三级为AUTOSAR包,AUTOSAR包中包含了AUTOSAR的元素,AUTOSAR包中同样可以再包含AUTOSAR包集合,如下所示。UUID为全局唯一标识符。

<AR-PACKAGE UUID="fe961ec7-0abe-508e-3e6a-54993ef5a69e">
    <SHORT-NAME>AUTOSAR_XXX</SHORT-NAME>
    ...包其他内容...
    <AR-PACKAGES>
        <AR-PACKAGE>
            ...包内容...
        </AR-PACKAGE>
      </AR-PACKAGES>
</AR-PACKAGE>

arxml注释为<!-- 注释内容 --> 。

<ELEMENTS> 标签内可以包含ARElement与FibexElement,它是一个可以独立定义的元素,即不属于另一个元素(当然PACKAGE除外)。下图包含所有ARElement的种类。

下图包含了所有的FibexElement的种类。

下图为ARXML的顶层架构。


ISOLAR A:ARXML文件实例分析

应用组件类型

下图为一个应用组件及其内部包含的Attribute。

我们来分别说明一下属性包含的内容信息。

  • ShortName:组件名称。
  • AdiminData:AdminData表示元素所管理的信息。此管理信息将被视为元数据,如修订ID或文件的状态等。
    <ADMIN-DATA>
        <SDGS>
            <SDG GID="Master">
                <SD>true</SD>
            </SDG>
        </SDGS>
    </ADMIN-DATA>
  • Ports:此SwComponentType可通过定义的Port进行通信.
    <PORTS>
        <P-PORT-PROTOTYPE UUID="6c3821e7-083e-4107-aabe-78e2b3fec89a">
            <SHORT-NAME>PPortPrototype_0</SHORT-NAME>
            <PROVIDED-INTERFACE-TREF DEST="SENDER-RECEIVER-INTERFACE">/SenderReceiverInterface/SenderReceiverInterface_0</PROVIDED-INTERFACE-TREF>
        </P-PORT-PROTOTYPE>
    </PORTS>
  • internalBehavior:描述了软件组件相对于RTE的相关方面的内容,即Runnable Entitities和它们响应的RTE Event。
    <INTERNAL-BEHAVIORS>
    	<SWC-INTERNAL-BEHAVIOR UUID="6131a7d7-2eb4-443c-af46-b440c9e69731">
    	  <SHORT-NAME>IB_Base_SWC</SHORT-NAME>
    	  <DATA-TYPE-MAPPING-REFS>
    		<DATA-TYPE-MAPPING-REF DEST="DATA-TYPE-MAPPING-SET">/DataTypeMapping/DataTypeMappingSet_0</DATA-TYPE-MAPPING-REF>
    	  </DATA-TYPE-MAPPING-REFS>
    	  <EVENTS>
    		<TIMING-EVENT UUID="53fe7a8e-aacc-4a45-b555-e33f1061ac74">
    		  <SHORT-NAME>TimingEvent_0</SHORT-NAME>
    		  <START-ON-EVENT-REF DEST="RUNNABLE-ENTITY">/Base_SWC/Test1/IB_Base_SWC/RunnableEntity_0</START-ON-EVENT-REF>
    		  <PERIOD>1.0</PERIOD>
    		</TIMING-EVENT>
    	  </EVENTS>
    	  <RUNNABLES>
    		<RUNNABLE-ENTITY UUID="31408035-5651-4258-a999-72d54c796e74">
    		  <SHORT-NAME>RunnableEntity_0</SHORT-NAME>
    		  <DATA-SEND-POINTS>
    			<VARIABLE-ACCESS UUID="c85b3d4b-2b73-4991-868e-c59bca22fb3f">
    			  <SHORT-NAME>DSP_TestState_0</SHORT-NAME>
    			  <ACCESSED-VARIABLE>
    				<AUTOSAR-VARIABLE-IREF>
    				  <PORT-PROTOTYPE-REF DEST="P-PORT-PROTOTYPE">/Base_SWC/Test1/PPortPrototype_0</PORT-PROTOTYPE-REF>
    				  <TARGET-DATA-PROTOTYPE-REF DEST="VARIABLE-DATA-PROTOTYPE">/SenderReceiverInterface/SenderReceiverInterface_0/TestState</TARGET-DATA-PROTOTYPE-REF>
    				</AUTOSAR-VARIABLE-IREF>
    			  </ACCESSED-VARIABLE>
    			</VARIABLE-ACCESS>
    		  </DATA-SEND-POINTS>
    		  <SYMBOL>RunnableEntity_0_func</SYMBOL>
    		</RUNNABLE-ENTITY>
    	  </RUNNABLES>
    	</SWC-INTERNAL-BEHAVIOR>
    </INTERNAL-BEHAVIORS>

系统

下图为一个ECU抽取之后,生成的系统以及其内部包含的Attribute。其为系统描述的顶层元素,系统描述定义了五个主要元素:拓扑、软件、通信、映射和映射约束。

我们来分别说明一下属性包含的内容信息。

  • ShortName:系统名称。
  • Category:类别是专门用于可识别语义的关键字。它影响属性的预期存在性和约束的适用性。
  • ecuExtractVersion:如果系统类别为SYSTEMEXTRACT或ECU EXTRACT,则应定义executeExtractVersion属性
  • fibexElement:引用指定通信和拓扑的ASAM FIBEX元素。系统应该引用所有出现在DBC_SysDesc.arxml中与抽取Ecu相关的Fibex元素。
    <FIBEX-ELEMENTS>
    	<FIBEX-ELEMENT-REF-CONDITIONAL>
    	  <FIBEX-ELEMENT-REF DEST="I-SIGNAL">/DBC_SysDesc_Can_Network_ECAN/Pkg_ISignal/CHK12_Mcu</FIBEX-ELEMENT-REF>
    	</FIBEX-ELEMENT-REF-CONDITIONAL>
    	<FIBEX-ELEMENT-REF-CONDITIONAL>
    	  <FIBEX-ELEMENT-REF DEST="CAN-CLUSTER">/DBC_SysDesc_Can_Network_ECAN/Pkg_Cluster/Can_Network_ECAN</FIBEX-ELEMENT-REF>
    	</FIBEX-ELEMENT-REF-CONDITIONAL>
    	<FIBEX-ELEMENT-REF-CONDITIONAL>
    	  <FIBEX-ELEMENT-REF DEST="CAN-FRAME">/DBC_SysDesc_Can_Network_ECAN/Pkg_Frame/DV_Test_Message_1</FIBEX-ELEMENT-REF>
    	</FIBEX-ELEMENT-REF-CONDITIONAL>
    	<FIBEX-ELEMENT-REF-CONDITIONAL>
    	  <FIBEX-ELEMENT-REF DEST="I-SIGNAL-I-PDU">/DBC_SysDesc_Can_Network_ECAN/Pkg_Pdus/DV_Test_Message_1</FIBEX-ELEMENT-REF>
    	</FIBEX-ELEMENT-REF-CONDITIONAL>
    	<FIBEX-ELEMENT-REF-CONDITIONAL>
    	  <FIBEX-ELEMENT-REF DEST="I-SIGNAL">/DBC_SysDesc_Can_Network_ECAN/Pkg_ISignal/KL15_MON_MCU</FIBEX-ELEMENT-REF>
    	</FIBEX-ELEMENT-REF-CONDITIONAL>
    	<FIBEX-ELEMENT-REF-CONDITIONAL>
    	  <FIBEX-ELEMENT-REF DEST="CAN-FRAME">/DBC_SysDesc_Can_Network_ECAN/Pkg_Frame/Rx_Test_Message_01</FIBEX-ELEMENT-REF>
    	</FIBEX-ELEMENT-REF-CONDITIONAL>
    	<FIBEX-ELEMENT-REF-CONDITIONAL>
    	  <FIBEX-ELEMENT-REF DEST="I-SIGNAL-I-PDU">/DBC_SysDesc_Can_Network_ECAN/Pkg_Pdus/Rx_Test_Message_01</FIBEX-ELEMENT-REF>
    	</FIBEX-ELEMENT-REF-CONDITIONAL>
    	<FIBEX-ELEMENT-REF-CONDITIONAL>
    	  <FIBEX-ELEMENT-REF DEST="I-SIGNAL">/DBC_SysDesc_Can_Network_ECAN/Pkg_ISignal/Rx_Test_Signal_01</FIBEX-ELEMENT-REF>
    	</FIBEX-ELEMENT-REF-CONDITIONAL>
    	<FIBEX-ELEMENT-REF-CONDITIONAL>
    	  <FIBEX-ELEMENT-REF DEST="I-SIGNAL">/DBC_SysDesc_Can_Network_ECAN/Pkg_ISignal/Rx_Test_Signal_02</FIBEX-ELEMENT-REF>
    	</FIBEX-ELEMENT-REF-CONDITIONAL>
    	<FIBEX-ELEMENT-REF-CONDITIONAL>
    	  <FIBEX-ELEMENT-REF DEST="ECU-INSTANCE">/DBC_SysDesc_Can_Network_ECAN/Pkg_Ecu/Test</FIBEX-ELEMENT-REF>
    	</FIBEX-ELEMENT-REF-CONDITIONAL>
    	<FIBEX-ELEMENT-REF-CONDITIONAL>
    	  <FIBEX-ELEMENT-REF DEST="CAN-FRAME">/DBC_SysDesc_Can_Network_ECAN/Pkg_Frame/Tx_Test_Message_01</FIBEX-ELEMENT-REF>
    	</FIBEX-ELEMENT-REF-CONDITIONAL>
    	<FIBEX-ELEMENT-REF-CONDITIONAL>
    	  <FIBEX-ELEMENT-REF DEST="I-SIGNAL-I-PDU">/DBC_SysDesc_Can_Network_ECAN/Pkg_Pdus/Tx_Test_Message_01</FIBEX-ELEMENT-REF>
    	</FIBEX-ELEMENT-REF-CONDITIONAL>
    	<FIBEX-ELEMENT-REF-CONDITIONAL>
    	  <FIBEX-ELEMENT-REF DEST="I-SIGNAL">/DBC_SysDesc_Can_Network_ECAN/Pkg_ISignal/Tx_Test_Signal_01</FIBEX-ELEMENT-REF>
    	</FIBEX-ELEMENT-REF-CONDITIONAL>
    	<FIBEX-ELEMENT-REF-CONDITIONAL>
    	  <FIBEX-ELEMENT-REF DEST="I-SIGNAL">/DBC_SysDesc_Can_Network_ECAN/Pkg_ISignal/Tx_Test_Signal_02</FIBEX-ELEMENT-REF>
    	</FIBEX-ELEMENT-REF-CONDITIONAL>
    	<FIBEX-ELEMENT-REF-CONDITIONAL>
    	  <FIBEX-ELEMENT-REF DEST="I-SIGNAL">/DBC_SysDesc_Can_Network_ECAN/Pkg_ISignal/VBAT_MON_MCU</FIBEX-ELEMENT-REF>
    	</FIBEX-ELEMENT-REF-CONDITIONAL>
    </FIBEX-ELEMENTS>
  • mapping:所有映射方面的聚合(软件组件到ECU的映射,数据元素到信号的映射以及映射约束)。
    <MAPPINGS>
    	<SYSTEM-MAPPING>
    	  <SHORT-NAME>SystemMapping</SHORT-NAME>
    	  <DATA-MAPPINGS>
    		<SENDER-RECEIVER-TO-SIGNAL-MAPPING>
    		  <DATA-ELEMENT-IREF>
    			<CONTEXT-COMPONENT-REF DEST="SW-COMPONENT-PROTOTYPE">/TopLevelComposition/TopLevelComposition/CPT_Test1</CONTEXT-COMPONENT-REF>
    			<CONTEXT-COMPOSITION-REF DEST="ROOT-SW-COMPOSITION-PROTOTYPE">/System/System/RootSwCompositionPrototype</CONTEXT-COMPOSITION-REF>
    			<CONTEXT-PORT-REF DEST="R-PORT-PROTOTYPE">/Base_SWC/Test1/RPortPrototype_0</CONTEXT-PORT-REF>
    			<TARGET-DATA-PROTOTYPE-REF DEST="VARIABLE-DATA-PROTOTYPE">/Interfaces/SenderReceiverInterface_uint16/VDP_uint16</TARGET-DATA-PROTOTYPE-REF>
    		  </DATA-ELEMENT-IREF>
    		  <SYSTEM-SIGNAL-REF DEST="SYSTEM-SIGNAL">/DBC_SysDesc_Can_Network_ECAN/Pkg_Signal/Rx_Test_Signal_01</SYSTEM-SIGNAL-REF>
    		</SENDER-RECEIVER-TO-SIGNAL-MAPPING>
    	  </DATA-MAPPINGS>
    	  <SW-MAPPINGS>
    		<SWC-TO-ECU-MAPPING>
    		  <SHORT-NAME>SwcToEcuMapping_1</SHORT-NAME>
    		  <COMPONENT-IREFS>
    			<COMPONENT-IREF>
    			  <CONTEXT-COMPOSITION-REF DEST="ROOT-SW-COMPOSITION-PROTOTYPE">/System/System/RootSwCompositionPrototype</CONTEXT-COMPOSITION-REF>
    			  <TARGET-COMPONENT-REF DEST="SW-COMPONENT-PROTOTYPE">/TopLevelComposition/TopLevelComposition/CPT_Test1</TARGET-COMPONENT-REF>
    			</COMPONENT-IREF>
    			<COMPONENT-IREF>
    			  <CONTEXT-COMPOSITION-REF DEST="ROOT-SW-COMPOSITION-PROTOTYPE">/System/System/RootSwCompositionPrototype</CONTEXT-COMPOSITION-REF>
    			  <TARGET-COMPONENT-REF DEST="SW-COMPONENT-PROTOTYPE">/TopLevelComposition/TopLevelComposition/CPT_Test2</TARGET-COMPONENT-REF>
    			</COMPONENT-IREF>
    		  </COMPONENT-IREFS>
    		  <ECU-INSTANCE-REF DEST="ECU-INSTANCE">/DBC_SysDesc_Can_Network_ECAN/Pkg_Ecu/Test</ECU-INSTANCE-REF>
    		</SWC-TO-ECU-MAPPING>
    	  </SW-MAPPINGS>
    	</SYSTEM-MAPPING>
    </MAPPINGS>
  • rootSoftwareComposition:聚合的根软件部件,包含系统中所有软件组件的层次结构。当系统描述用于network-only情况时,不需要此元素。
    <ROOT-SOFTWARE-COMPOSITIONS>
    	<ROOT-SW-COMPOSITION-PROTOTYPE>
    	  <SHORT-NAME>CPT_Test_FlatView</SHORT-NAME>
    	  <FLAT-MAP-REF DEST="FLAT-MAP">/Test_FlatView/Test_FlatMap</FLAT-MAP-REF>
    	  <SOFTWARE-COMPOSITION-TREF DEST="COMPOSITION-SW-COMPONENT-TYPE">/Test_FlatView/SwComponentTypes/Test_FlatView</SOFTWARE-COMPOSITION-TREF>
    	</ROOT-SW-COMPOSITION-PROTOTYPE>
    </ROOT-SOFTWARE-COMPOSITIONS>
  • systemVersion:系统描述的版本号。

FlatMap 

包含对软件对象引用的平面列表。此列表用于标识实例和解决名称冲突。引用范围由使用它的RootSwCompositionPrototype给出,即它可以应用于系统、系统提取或ECU提取。
FlatMap的实例也可用于前期的ARXML中,例如在集成到系统中之前的软件组件的ARXML中。在这种情况下,它不是由RootSwCompositionPrototype给出。

 我们来分别说明一下属性包含的内容信息。

  • ShortName:FlatMap名称。
  • instance:平面映射中描述符实例的聚合。
    • FlatInstanceDescriptor:表示软件系统实例树的一个节点(例如,组件实例或数据元素)。这个元素的用途是将这个实例的各种嵌套关系映射到一个平面表示,并为其分配一个惟一的名称(shortName)。
      <FLAT-INSTANCE-DESCRIPTOR>
        <SHORT-NAME>CPT_Test1</SHORT-NAME>
        <UPSTREAM-REFERENCE-IREF>
      	<CONTEXT-ELEMENT-REF DEST="ROOT-SW-COMPOSITION-PROTOTYPE">/System/System/RootSwCompositionPrototype</CONTEXT-ELEMENT-REF>
      	<TARGET-REF DEST="SW-COMPONENT-PROTOTYPE">/TopLevelComposition/TopLevelComposition/CPT_Test1</TARGET-REF>
        </UPSTREAM-REFERENCE-IREF>
        <ECU-EXTRACT-REFERENCE-IREF>
      	<CONTEXT-ELEMENT-REF DEST="ROOT-SW-COMPOSITION-PROTOTYPE">/System_EcuExtract/EXTR_Test/CPT_Test_FlatView</CONTEXT-ELEMENT-REF>
      	<TARGET-REF DEST="SW-COMPONENT-PROTOTYPE">/Test_FlatView/SwComponentTypes/Test_FlatView/CPT_Test1</TARGET-REF>
        </ECU-EXTRACT-REFERENCE-IREF>
      </FLAT-INSTANCE-DESCRIPTOR>
      <FLAT-INSTANCE-DESCRIPTOR>
        <SHORT-NAME>TestState</SHORT-NAME>
        <SW-DATA-DEF-PROPS>
      	<SW-DATA-DEF-PROPS-VARIANTS>
      	  <SW-DATA-DEF-PROPS-CONDITIONAL>
      		<SW-REFRESH-TIMING>
      		  <CSE-CODE>6</CSE-CODE>
      		  <CSE-CODE-FACTOR>1</CSE-CODE-FACTOR>
      		</SW-REFRESH-TIMING>
      	  </SW-DATA-DEF-PROPS-CONDITIONAL>
      	</SW-DATA-DEF-PROPS-VARIANTS>
        </SW-DATA-DEF-PROPS>
        <UPSTREAM-REFERENCE-IREF>
      	<CONTEXT-ELEMENT-REF DEST="ROOT-SW-COMPOSITION-PROTOTYPE">/System/System/RootSwCompositionPrototype</CONTEXT-ELEMENT-REF>
      	<CONTEXT-ELEMENT-REF DEST="SW-COMPONENT-PROTOTYPE">/TopLevelComposition/TopLevelComposition/CPT_Test1</CONTEXT-ELEMENT-REF>
      	<CONTEXT-ELEMENT-REF DEST="P-PORT-PROTOTYPE">/Base_SWC/Test1/PPortPrototype_0</CONTEXT-ELEMENT-REF>
      	<TARGET-REF DEST="VARIABLE-DATA-PROTOTYPE">/SenderReceiverInterface/SenderReceiverInterface_0/TestState</TARGET-REF>
        </UPSTREAM-REFERENCE-IREF>
        <ECU-EXTRACT-REFERENCE-IREF>
      	<CONTEXT-ELEMENT-REF DEST="ROOT-SW-COMPOSITION-PROTOTYPE">/System_EcuExtract/EXTR_Test/CPT_Test_FlatView</CONTEXT-ELEMENT-REF>
      	<CONTEXT-ELEMENT-REF DEST="SW-COMPONENT-PROTOTYPE">/Test_FlatView/SwComponentTypes/Test_FlatView/CPT_Test1</CONTEXT-ELEMENT-REF>
      	<CONTEXT-ELEMENT-REF DEST="P-PORT-PROTOTYPE">/Base_SWC/Test1/PPortPrototype_0</CONTEXT-ELEMENT-REF>
      	<TARGET-REF DEST="VARIABLE-DATA-PROTOTYPE">/SenderReceiverInterface/SenderReceiverInterface_0/TestState</TARGET-REF>
        </ECU-EXTRACT-REFERENCE-IREF>
      </FLAT-INSTANCE-DESCRIPTOR>

部件类型

部件类型聚合了软件组件类型以及Sw Connector,后者主要用于将SwComponentPrototype彼此连接并连接。通过这种方法,可以创建软件组件的层次结构。

我们来分别说明一下属性包含的内容信息。

  • ShortName:部件名称。
  • Ports:此文件为抽取出来的连接系统信号的端口。
    <PORTS>
    	<R-PORT-PROTOTYPE>
    	  <SHORT-NAME>RPortPrototype_System_0</SHORT-NAME>
    	  <REQUIRED-INTERFACE-TREF DEST="SENDER-RECEIVER-INTERFACE">/Interfaces/SenderReceiverInterface_uint32</REQUIRED-INTERFACE-TREF>
    	</R-PORT-PROTOTYPE>
    </PORTS>
  • component:构成此部件的实例化组件。
    <COMPONENTS>
    	<SW-COMPONENT-PROTOTYPE>
    	  <SHORT-NAME>CPT_Test1</SHORT-NAME>
    	  <TYPE-TREF DEST="APPLICATION-SW-COMPONENT-TYPE">/Base_SWC/Test1</TYPE-TREF>
    	</SW-COMPONENT-PROTOTYPE>
    	<SW-COMPONENT-PROTOTYPE>
    	  <SHORT-NAME>CPT_Test2</SHORT-NAME>
    	  <TYPE-TREF DEST="APPLICATION-SW-COMPONENT-TYPE">/CDD_SWC/Test2</TYPE-TREF>
    	</SW-COMPONENT-PROTOTYPE>
    </COMPONENTS>
  • connector:连接表征在组件间通过端口建立的关系。连接分为ASSEMBLY-SW-CONNECTOR与DELEGATION-SW-CONNECTOR。一个表征组件间的连接,一个表征组件与ECU通信信号的连接。
    <CONNECTORS>
    	<ASSEMBLY-SW-CONNECTOR>
    	  <SHORT-NAME>ASC_CPT_Test1_PPortPrototype_0_CPT_Test2_RPortPrototype_0</SHORT-NAME>
    	  <PROVIDER-IREF>
    		<CONTEXT-COMPONENT-REF DEST="SW-COMPONENT-PROTOTYPE">/Test_FlatView/SwComponentTypes/Test_FlatView/CPT_Test1</CONTEXT-COMPONENT-REF>
    		<TARGET-P-PORT-REF DEST="P-PORT-PROTOTYPE">/Base_SWC/Test1/PPortPrototype_0</TARGET-P-PORT-REF>
    	  </PROVIDER-IREF>
    	  <REQUESTER-IREF>
    		<CONTEXT-COMPONENT-REF DEST="SW-COMPONENT-PROTOTYPE">/Test_FlatView/SwComponentTypes/Test_FlatView/CPT_Test2</CONTEXT-COMPONENT-REF>
    		<TARGET-R-PORT-REF DEST="R-PORT-PROTOTYPE">/CDD_SWC/Test2/RPortPrototype_0</TARGET-R-PORT-REF>
    	  </REQUESTER-IREF>
    	</ASSEMBLY-SW-CONNECTOR>
    	<DELEGATION-SW-CONNECTOR>
    	  <SHORT-NAME>DelegationSwConnector_0_0</SHORT-NAME>
    	  <INNER-PORT-IREF>
    		<R-PORT-IN-COMPOSITION-INSTANCE-REF>
    		  <CONTEXT-COMPONENT-REF DEST="SW-COMPONENT-PROTOTYPE">/Test_FlatView/SwComponentTypes/Test_FlatView/CPT_Test1</CONTEXT-COMPONENT-REF>
    		  <TARGET-R-PORT-REF DEST="R-PORT-PROTOTYPE">/Base_SWC/Test1/RPortPrototype_System_0</TARGET-R-PORT-REF>
    		</R-PORT-IN-COMPOSITION-INSTANCE-REF>
    	  </INNER-PORT-IREF>
    	  <OUTER-PORT-REF DEST="R-PORT-PROTOTYPE">/Test_FlatView/SwComponentTypes/Test_FlatView/RPortPrototype_System_0</OUTER-PORT-REF>
    	</DELEGATION-SW-CONNECTOR>
    </CONNECTORS>


ISOLAR B:ARXML文件实例分析

模块配置

模块可以是BSW模块以及RTE和ECU基础模块,Ecuc Module Configuration Values元素有两个不同的角色:

  • recommendedConfiguration包含BSW模块供应商推荐的参数值。
  • preconfiguredConfiguration包含的参数值是由实现固定的,不能更改。

我们来分别说明一下属性包含的内容信息。

  • ShortName:模块名称。
  • DefinitionRef:模块定义的引用,这个标签会引用到..\Config\BSW\ParamDefs目录下的模块参数定义。
  • implementationConfigVariant:指定此Ecu Module ConfigurationValues元素提供的配置信息是在软件开发到使用的哪个阶段内生效的。
  • container:一组相关配置形成一个容器,容器还能包含子容器,子容器同样还能继续包含子容器。

下图是CanIf第一层容器包含的内容,根据箭头可以找到与BSW Editor的对应关系,首先CanIf包含了五个子容器,打开CanIfInitCfg子容器,里边包含一个参数CanIfInitCfgSet和四个子容器。

下图可以看到针对子容器CanIfInitHohCfg,它下面包含的三个子容器的关系。

下图可以看到针对子容器CanIfHrhCfg的一个参数和两个引用与BSW Editor中的关系。

可以看出直接看ARXML包含关系不是很直观,并且因为他们的容器内参数引用的为..\Config\BSW\ParamDefs目录下的模块参数定义并且是可以分裂定义(同一种引用针对不同实例重复定义),建议BSW基础模块在BSW Editor中进行配置和理解,BSW Editor会将相同的参数引用聚合到一起,并形成可视化的层级关系,帮助我们更好的完成BSW等基础模块的配置 。


服务软件实例描述

我们以ComM_Cfg_SWCD.arxml文件为例,来讲解SWCD一般包含那些内容。

我们分别介绍一下这四个PACKAGE都包含的内容。

  • SwcImplementation: 对单个软件组件或模块实现的描述。下面的例子描述了组件的编程语言以及组件类型等信息。
    <SWC-IMPLEMENTATION>
      <SHORT-NAME>ComM_Imp</SHORT-NAME>
      <CODE-DESCRIPTORS>
    	<CODE>
    	  <SHORT-NAME>ComM_Imp_Code</SHORT-NAME>
    	  <ARTIFACT-DESCRIPTORS>
    		<AUTOSAR-ENGINEERING-OBJECT>
    		  <SHORT-LABEL>Code</SHORT-LABEL>
    		  <CATEGORY>SWSRC</CATEGORY>
    		</AUTOSAR-ENGINEERING-OBJECT>
    	  </ARTIFACT-DESCRIPTORS>
    	</CODE>
      </CODE-DESCRIPTORS>
      <PROGRAMMING-LANGUAGE>C</PROGRAMMING-LANGUAGE>
      <BEHAVIOR-REF DEST="SWC-INTERNAL-BEHAVIOR">/AUTOSAR_ComM/SwComponentTypes/ComM/ComM_Int</BEHAVIOR-REF>
    </SWC-IMPLEMENTATION>
  • ImplementationDataTypes:描述属于本组件的ImplementationData。这通常对应于C代码中的typedef,是对基本数据类型的一层封装。下面的例子描述了结构体数据类型的ComM_UserHandleArrayType,结构体包含一个uint8类型的numberOfRequesters以一个ComM_UserHandleType类型的数组handleArray。

    <IMPLEMENTATION-DATA-TYPE>
      <SHORT-NAME>ComM_UserHandleArrayType</SHORT-NAME>
      <CATEGORY>STRUCTURE</CATEGORY>
      <SUB-ELEMENTS>
    	<IMPLEMENTATION-DATA-TYPE-ELEMENT>
    	  <SHORT-NAME>numberOfRequesters</SHORT-NAME>
    	  <CATEGORY>TYPE_REFERENCE</CATEGORY>
    	  <SW-DATA-DEF-PROPS>
    		<SW-DATA-DEF-PROPS-VARIANTS>
    		  <SW-DATA-DEF-PROPS-CONDITIONAL>
    			<IMPLEMENTATION-DATA-TYPE-REF DEST="IMPLEMENTATION-DATA-TYPE">/AUTOSAR_Platform/ImplementationDataTypes/uint8</IMPLEMENTATION-DATA-TYPE-REF>
    		  </SW-DATA-DEF-PROPS-CONDITIONAL>
    		</SW-DATA-DEF-PROPS-VARIANTS>
    	  </SW-DATA-DEF-PROPS>
    	</IMPLEMENTATION-DATA-TYPE-ELEMENT>
    	<IMPLEMENTATION-DATA-TYPE-ELEMENT>
    	  <SHORT-NAME>handleArray</SHORT-NAME>
    	  <CATEGORY>ARRAY</CATEGORY>
    	  <ARRAY-SIZE-SEMANTICS>FIXED-SIZE</ARRAY-SIZE-SEMANTICS>
    	  <SUB-ELEMENTS>
    		<IMPLEMENTATION-DATA-TYPE-ELEMENT>
    		  <SHORT-NAME>handleArrayElement</SHORT-NAME>
    		  <CATEGORY>TYPE_REFERENCE</CATEGORY>
    		  <ARRAY-SIZE SHORT-LABEL="size">1</ARRAY-SIZE>
    		  <SW-DATA-DEF-PROPS>
    			<SW-DATA-DEF-PROPS-VARIANTS>
    			  <SW-DATA-DEF-PROPS-CONDITIONAL>
    				<IMPLEMENTATION-DATA-TYPE-REF DEST="IMPLEMENTATION-DATA-TYPE">/AUTOSAR_ComM/ImplementationDataTypes/ComM_UserHandleType</IMPLEMENTATION-DATA-TYPE-REF>
    			  </SW-DATA-DEF-PROPS-CONDITIONAL>
    			</SW-DATA-DEF-PROPS-VARIANTS>
    		  </SW-DATA-DEF-PROPS>
    		</IMPLEMENTATION-DATA-TYPE-ELEMENT>
    	  </SUB-ELEMENTS>
    	</IMPLEMENTATION-DATA-TYPE-ELEMENT>
      </SUB-ELEMENTS>
    </IMPLEMENTATION-DATA-TYPE>
  • SwComponentTypes:软件组件类型,包括ApplicationSwComponentType、ServiceProxySwComponentType、SensorActuatorSwComponentType、ComplexDeviceDriverSwComponentType、ServiceSwComponentType、EcuAbstractionSwComponentType这几种类型,下面截图的为服务软件组件类型,它同样由端口和组件内部行为构成,组件内部行为包含了Runnables(实体)以及EVENTS(事件)以及DataTypeMappingRefs(应用数据与实现数据映射引用)。

  • PortInterfaces:端口接口类型,包括SenderReceiverInterface、NvDataInterface、ParameterInterface、ModeSwitchInterface、ClientServerInterface、TriggerInterface这几种类型,下面的arxml定义了一个SenderReceiverInterface。
    <SENDER-RECEIVER-INTERFACE>
      <SHORT-NAME>ComM_CurrentChannelRequest</SHORT-NAME>
      <IS-SERVICE>true</IS-SERVICE>
      <DATA-ELEMENTS>
    	<VARIABLE-DATA-PROTOTYPE>
    	  <SHORT-NAME>fullComRequestors</SHORT-NAME>
    	  <TYPE-TREF DEST="IMPLEMENTATION-DATA-TYPE">/AUTOSAR_ComM/ImplementationDataTypes/ComM_UserHandleArrayType</TYPE-TREF>
    	</VARIABLE-DATA-PROTOTYPE>
      </DATA-ELEMENTS>
    </SENDER-RECEIVER-INTERFACE>

基础软件实例描述

我们以ComM_Cfg_BSWMD.arxml,来讲解以下BSWMD都包含哪些内容。

我们下面来看一下八个PACKAGE都包含了什么内容。

  • ApplicationDataTypes:应用数据类型定义,如下图为例,第一个为原始类型数据ComM_uint8_App,它可以跟一个计算方法和数据约束绑定下例中还包含数组与结构体,他们都需要引用原始数据类型。

  • BswImplementations:其中除了通用规范(BswModule Definition和BswBehavior)外,还包含特定于实现的信息。

  • BswModuleDescriptions:用于描述单个BSW模块或BSW集群的根元素。在描述BSW模块的情况下该元素的短名称等于BSW模块的名称。下图中包含了模块的需要的变量(基于定义的应用数据类型和应用类型到实现类型映射)以及可运行实体与事件信息。

  • DataConstraints:数据约束,针对应用数据约束它的上下限以及单位引用等。

  • DataTypeMappingSets:应用数据到实现数据的映射。

  • ImplementationDataTypes:描述属于本组件的ImplementationData,它引用了AUTOSAR提供的几种基本的ImplementationData,如果工程中没有需要在ISOLAR_PlatformTypes.arxml补充相应的定义。

  • Units:与该数据对象的语义相关联的物理单元定义。如果未指定compuMethod,则此属性适用。如果指定了compuMethod,则两种定义应保持一致。

  • PhysicalDimensions:单元对应的物理维度信息,可以被Units引用。


 十六宿舍 原创作品,转载必须标注原文链接。

©2023 Yang Li. All rights reserved.

欢迎关注 『十六宿舍』,大家喜欢的话,给个👍,更多关于嵌入式相关技术的内容持续更新中。

### Autosar 入门到精通 学习资料 100讲 Autosar( Automotive Open System Architecture)是一种标准化的汽车嵌入式系统架构,旨在提高车载电子控制单元(ECU)之间的互操作性和可重用性。以下是关于学习 Autosar 的全面教程或课程建议: #### 一、基础概念与框架 Autosar 主要分为两类:Classic Platform (CP) 和 Adaptive Platform (AP)[^2]。 - **Classic Platform (CP)** 是面向传统 ECU 开发的经典平台,适用于实时性强的应用场景。 - **Adaptive Platform (AP)** 则是为了满足未来自动驾驶和车联网需求而设计的新一代平台。 对于初学者来说,可以从 CP 平台入手,逐步了解 AP 的特性及其应用场景。 --- #### 二、推荐的学习路径 ##### 1. 理论学习 - 阅读官方文档:Autosar 官方网站提供了丰富的规范和技术文档,这是最权威的学习资源[^3]。 - 参考书籍: - 《基于 AUTOSAR 规范的车用电机控制器软件开发》——适合国内开发者,重点介绍了 Davinci 工具链的应用。 - 《AUTOSAR 规范与车用控制器软件开发》——涵盖了更广泛的工具链支持,尤其是 ETAS 方面的内容。 ##### 2. 实践项目 通过实际案例加深理解,例如实现简单的 RTE 或 BSW 功能模块的设计与配置。可以尝试以下练习: - 设计一个带有睡眠唤醒功能的小型 ECU 控制器[^4]。 - 使用 Davinci Configurator Pro 进行 ARXML 文件的手动编辑与验证。 ##### 3. 在线课程 根据引用中的内容,《AutoSAR 从入门到精通实战系列课程》是一个非常系统的自学笔记集合,覆盖了理论知识以及 EB/Davinci 工具的具体应用方法[^1]。此课程不仅包含了基础知识讲解,还涉及源码分析部分,能够帮助学员深入了解 Autosar 的内部机制。 --- #### 三、具体章节规划 如果目标是完成类似于“Autosar 入门到精通 学习资料 100 讲”的计划,则可以根据以下几个方面来划分内容结构: | 序号 | 类别 | 内容概览 | |------|--------------------|--------------------------------------------------------------------------| | 1 | 基础篇 | Autosar 架构介绍;RTE, BSW 层次关系解析 | | 2 | 工具使用 | Davinci/EB Tresos Toolchain 上手指南 | | 3 | 核心组件详解 | Swc, PortInterface, DataMapping 等核心概念 | | 4 | 实战演练 | 如何构建第一个 Autosar Project | | 5 | 高级主题探讨 | OS Task Scheduling; NvM Flash Management | 每节都应附带相应的实验指导书以便于动手实践巩固所学知识点。 --- ```python # 示例代码片段:展示如何利用 Python 解析 XML 数据文件(如 ARXML) import xml.etree.ElementTree as ET def parse_arxml(file_path): tree = ET.parse(file_path) root = tree.getroot() for child in root: print(f"{child.tag}: {child.attrib}") if __name__ == "__main__": arxml_file = 'example.arxml' parse_arxml(arxml_file) ``` 以上脚本可用于初步探索 Autosar 中常见的 ARXML 结构形式。 ---
评论 6
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值