DaVinCi RTE模块技术手册：RTE功能与API接口详解

需积分: 14 171 浏览量更新于2024-06-28 收藏 2.59MB PDF 举报

DaVinCi配置RTE模块的技术手册是一份针对基于RH850芯片的诊断模块的专业指南，适用于汽车电子领域，特别是在CAN Autosar标准下。这份文档详细介绍了RTE（Runtime Environment）的功能模块，以及其在系统中的应用。RTE模块作为关键组件，提供了运行时支持和服务，如与硬件的交互、数据通信和任务管理。该手册的版本4.20.0由Vector Informatik GmbH发布，其内容涵盖了RTE模块从早期版本的持续演进过程。起初，文档是在2005年11月由Bernd Sigle进行彻底重构，并适应了AUTOSAR标准，这是汽车行业软件开发的重要框架。随后的版本增加了API接口的描述，比如Rte_IRead/Rte_IWrite用于读写操作，以及Rte_Receive/Rte_Send用于接收和发送数据，这些接口与RTESWS（Runtime Environment Service）1.0.0 Final相兼容。 2006年，文档进一步扩展了功能，如引入了客户端/服务器通信机制，支持序列化通信，使得多任务处理更加高效。此外，对数组数据类型的支持也在此时加入，增强了数据处理的灵活性。2007年，手册重点在于添加了专用的执行区域（exclusive areas），同时移除了对Target Packages的描述，这可能是为了更好地关注RTE的核心职责和性能优化。值得注意的是，尽管这份文档最初是针对RH850芯片设计，但其内容和接口设计是标准化和通用的，可以被广泛应用于不同类型的汽车电子系统中，体现了高度的移植性和可扩展性。通过阅读这份技术手册，开发人员能够深入理解如何利用DaVinCi配置RTE模块来构建安全、可靠的汽车控制系统，确保满足严格的行业规范和性能需求。

Technical Reference MICROSAR RTE 
© 2019 Vector Informatik GmbH  Version 4.20.0  16 
based on template version 3.5 
12.2  Rte_Result ..................................................................................... 112 
13  Indirect API .................................................................................................... 113 
13.1  Rte_Ports ....................................................................................... 113 
13.2  Rte_NPorts .................................................................................... 114 
13.3  Rte_Port ......................................................................................... 115 
14  RTE Lifecycle API .......................................................................................... 116 
14.1  Rte_Start ........................................................................................ 116 
14.2  Rte_StartTiming ............................................................................. 116 
14.3  Rte_Stop ........................................................................................ 117 
14.4  Rte_InitMemory .............................................................................. 117 
15  SchM Lifecycle API ........................................................................................ 119 
15.1  SchM_Init ....................................................................................... 119 
15.2  SchM_Deinit................................................................................... 119 
15.3  SchM_GetVersionInfo .................................................................... 120 
16  VFB Trace Hooks ........................................................................................... 121 
16.1  Rte_[<client>_]<API>Hook_<cts>_<ap>_Start ............................... 121 
16.2  Rte_[<client>_]<API>Hook_<cts>_<ap>_Return ............................ 122 
16.3  SchM_[<client>_]<API>Hook_<Bsw>_<ap>_Start ......................... 123 
16.4  SchM_[<client>_]<API>Hook_<Bsw>_<ap>_Return ...................... 124 
16.5  Rte_[<client>_]ComHook_<SignalName>_SigTx ........................... 125 
16.6  Rte_[<client>_]ComHook_<SignalName>_SigIv ............................ 126 
16.7  Rte_[<client>_]ComHook_<SignalName>_SigGroupIv .................. 127 
16.8  Rte_[<client>_]ComHook_<SignalName>_SigRx........................... 128 
16.9  Rte_[<client>_]ComHook<Event>_<SignalName> ......................... 129 
16.10  Rte_[<client>_]Task_Activate ......................................................... 130 
16.11  Rte_[<client>_]Task_Terminate ...................................................... 130 
16.12  Rte_[<client>_]Task_Dispatch ........................................................ 131 
16.13  Rte_[<client>_]Task_SetEvent ....................................................... 132 
16.14  Rte_[<client>_]Task_WaitEvent ...................................................... 132 
16.15  Rte_[<client>_]Task_WaitEventRet ................................................ 133 
16.16  Rte_[<client>_]Runnable_<cts>_<r>_Start .................................... 133 
16.17  Rte_[<client>_]Runnable_<cts>_<r>_Return ................................. 134 
17  RTE Interfaces to BSW .................................................................................. 135 
17.1  Interface to COM / LDCOM ............................................................ 135 
17.2  Interface to Transformer ................................................................. 136 
17.3  Interface to OS ............................................................................... 137 
17.4  Interface to NVM ............................................................................ 138 
17.5  Interface to XCP ............................................................................. 138 
17.6  Interface to SCHM.......................................................................... 140 
17.7  Interface to DET ............................................................................. 140 

Technical Reference MICROSAR RTE 
© 2019 Vector Informatik GmbH  Version 4.20.0  17 
based on template version 3.5 
RTE Configuration .................................................................................................... 141 
1  Configuration Variants .................................................................................... 141 
2  Lifecycle Configuration ................................................................................... 141 
3  Task Configuration ......................................................................................... 142 
4  Memory Protection and Multicore Configuration ............................................. 143 
5  NV Memory Mapping ..................................................................................... 146 
6  RTE Generator Settings ................................................................................. 147 
7  Measurement and Calibration ........................................................................ 148 
8  Optimization Mode Configuration ................................................................... 152 
9  VFB Tracing Configuration ............................................................................. 153 
10  Exclusive Area Implementation ...................................................................... 154 
11  Periodic Trigger Implementation ..................................................................... 155 
12  Resource Calculation ..................................................................................... 157 
Glossary and Abbreviations .................................................................................... 158 
1  Glossary ........................................................................................................ 158 
2  Abbreviations ................................................................................................. 158 
Additional Copyrights .............................................................................................. 160 
Contact ...................................................................................................................... 161 
 

Technical Reference MICROSAR RTE 
© 2019 Vector Informatik GmbH  Version 4.20.0  18 
based on template version 3.5 
Illustrations 
Figure 2-1   AUTOSAR architecture ............................................................................. 26 
Figure 2-2   Interfaces to adjacent modules of the RTE ............................................... 28 
Figure 4-1   RTE Include Structure............................................................................... 55 
Figure 4-2   SWC Include Structure ............................................................................. 56 
Figure 4-3   BSW Include Structure ............................................................................. 57 
Figure 4-4   Trusted RTE Partitioning example ............................................................ 65 
Figure 4-5   Non-trusted RTE Partitioning example ...................................................... 66 
Figure 6-1   Mapping of Runnables to Tasks .............................................................. 142 
Figure 6-2   Assignment of a Task to an OS Application ............................................. 144 
Figure 6-3   OS Application Configuration .................................................................. 145 
Figure 6-4   Mapping of Per-Instance Memory to NV Memory Blocks ........................ 146 
Figure 6-5   RTE Generator Settings .......................................................................... 147 
Figure 6-6   Measurement and Calibration Generation Parameters ........................... 148 
Figure 6-7   SWC Calibration Support Parameters..................................................... 150 
Figure 6-8   CalibrationBufferSize Parameter ............................................................. 151 
Figure 6-9   A2L Include Structure ............................................................................. 151 
Figure 6-10   Optimization Mode Configuration ............................................................ 152 
Figure 6-11   VFB Tracing Configuration ...................................................................... 153 
Figure 6-12   Exclusive Area Implementation Configuration ......................................... 154 
Figure 6-13   Periodic Trigger Implementation Configuration ....................................... 155 
Figure 6-14   HTML Report .......................................................................................... 156 
Figure 6-15   Configuration of platform settings ........................................................... 157 
Tables 
Table 1-1   History of the document ............................................................................ 10 
Table 1-2   Reference documents ............................................................................... 11 
Table 1-1   Component history.................................................................................... 24 
Table 3-1   Supported AUTOSAR standard conform features ..................................... 31 
Table 3-2   Not supported AUTOSAR standard conform features ............................... 33 
Ta ble 3-3   Features provided beyond the AUTOSAR standard .................................. 33 
Table 3-4   Service IDs ............................................................................................... 42 
Table 3-5   Errors reported to DET.............................................................................. 43 
Table 3-6   Dirty Flag Handling ................................................................................... 44 
Table 4-1   Generated Files of RTE Generation Phase ............................................... 46 
Table 4-2   DVCfgCmd Command Line Options ......................................................... 48 
Table 4-3   RTE Generator Command Line Options ................................................... 50 
Table 4-4   Generated Files of RTE Contract Phase ................................................... 51 
Table 4-5   Generated Files of RTE Template Code Generation ................................. 53 
Ta ble 4-6   Generated Files of VFB Trace Hook Code Generation ............................. 54 
Table 4-7   Compiler abstraction and memory mapping .............................................. 60 
Table 4-8   Compiler abstraction and memory mapping for non-cacheable variables . 60 
Table 5-1   Abbreviations for API Name Placeholders ................................................ 74 
Table 7-1   Glossary ................................................................................................. 158 
Table 7-2   Abbreviations .......................................................................................... 159 
Table 8-1   Free and Open Source Software Licenses.............................................. 160 
 

Technical Reference MICROSAR RTE

based on template version 3.5

1 Component History

The component history gives an overview over the important milestones that are supported

in the different versions of the component.

Component Version

New Features

2.3

 Complex hierarchical data types like arrays of records

 Optimization: Depending on the configuration the Rte_Read API is

generated as macro if possible

2.4

 String data type (Encoding ISO-8859-1)

 SWC local calibration parameters (Rte_CData)

 Optimization: Depending on the configuration the Rte_Write API is

generated as macro if possible

 Generation of unmapped client runnables enabled

 Asynchronous C/S communication (Rte_Result)

2.5

 Support of AUTOSAR 3.0 Revision 0001

 Access to calibration element prototypes of calibration components

(Rte_Calprm)

 Access to Per-Instance Memory (Rte_Pim)

 SWC implementation template generation (command line option -g i)

and Contract Phase generation (command line option -g c) for a

complete ECU

2.6

 Intra-ECU timeout handling for synchronous C/S communication

 Parallel access of synchronous and asynchronous server calls to an

operation of one server port

 Generation of an ASAM MCD 2MC / ASAP2 compatible A2L file

fragment for calibration parameters and Per-Instance Memory

2.7

 Multiple instantiation of software components

 Compatibility mode

 Object code software components

2.8

 Indirect APIs (Rte_Ports, Rte_NPorts and Rte_Port)

 Port API Option 'EnableTakeAddress'

 Platform dependent resource calculation.

2.9

 Memory protection (OS with scalability class SC3/SC4)

2.10

 Mode management including mode switch triggered runnable entities

and mode dependent execution of runnable entities. (Rte_Switch,

Rte_Mode and Rte_Feedback for mode switch acknowledge)

 Data element invalidation (Rte_Invalidate and Rte_IInvalidate)

 Data reception error triggered runnable entities for invalidated and

outdated data elements

 Multiple cyclic triggers per runnable entity

 Multiple OperationInvokedEvent triggers for the same runnable entity

with compatible operations

 Extended A2L file generation for calibration parameters and Per-

Instance Memory for user defined attributes (A2L-ANNOTATION)

2.11

 Signal Fan-In

Technical Reference MICROSAR RTE

based on template version 3.5

Component Version

New Features

 Unconnected provide ports

 Generation of unreferenced data types

 Evaluation of COM return codes

2.12

 Basic task support (automatically selection)

 Several optimizations (e.g. unneeded interrupt locks and Schedule()

call removed)

 Enhanced error reporting with help messages (-v command line

option)

 Support of acknowledgement only mode for transmission and mode

switch notification

 Usage of compiler library functions (e.g. memcpy) removed

 Template file update mechanism also introduced for Rte_MemMap.h

and Rte_Compiler_Cfg.h

2.13

 Unconnected require ports

 Basic task support (manual selection)

 Init-Runnables no longer have name restrictions

 Automatic periodic trigger generation can be disabled e.g. useful for

Schedule Table support

 HTML Report including resource usage

 Explicit selection of task role (Application / BSW Scheduler / Non Rte)

 Runnables with CanBeInvokedConcurrently set to false no longer

require a mapping, if they are not called concurrently.

2.14

 Support composite data types where not all primitive members require

an invalid value

 Support inclusion of user header file 'Rte_UserTypes.h'

2.15

 Optimized runnable scheduling to reduce latency times

 Allow implementation template generation for service components,

complex device drivers and EcuAbstraction components

 Optimization mode (minimize RAM consumption / minimize execution

time)

2.16

 MinimumStartInterval attribute (runnable de-bouncing)

 Measurement support for S/R communication, Interrunnable variables

and mode communication. Extended A2L File generation and support

of new ASAM MCD 2MC / ASAP2 standard. Measurement with

XcpEvents

 Com Filter (NewDiffersOld, Always)

 Invalid value accessible from application

 Support of second array passing variant

2.17

 Online calibration support

 Support transmission error detection

 Support of extended record data type compatibility for S/R

communication with different record layout on sender and receiver side

2.18

 Enhanced implicit communication support

2.19

 Support of AUTOSAR 3.2 Revision 0001

 Support never received status

剩余160页未读，继续阅读

&春风有信

粉丝: 1w+
资源: 37

DaVinCi RTE模块技术手册：RTE功能与API接口详解

DaVinCi 配置 CAN模块的技术手册

DaVinCi 配置 DEM模块的技术手册

DaVinCi 配置 PduR模块的技术手册

DaVinCi 配置 DCM模块的技术手册

DaVinCi 配置 Com模块的技术手册

DaVinCi 配置 CanNM模块的技术手册

DaVinCi 配置 BswM模块的技术手册

DaVinCi 配置 OS模块的技术手册

DaVinCi 配置 IoHwAb模块的技术手册

DaVinCi 配置 ComM模块的技术手册

最新资源