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

需积分: 14 199 浏览量更新于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 RTE模块配置技术手册：通用API与RH850芯片

DaVinCi配置BswM模块技术参考手册

DaVinCi PduR模块配置技术手册：RH850芯片通用接口详解

DaVinCi 配置 Com模块的技术手册

DaVinCi 配置 IoHwAb模块的技术手册

DaVinCi 配置 ComM模块的技术手册

DaVinCi 配置 BswM模块的技术手册

DaVinCi 配置 CanNM模块的技术手册

DaVinCi 配置 DEM模块的技术手册

DaVinCi 配置 CAN模块的技术手册

最新资源