Specification of Debugging in AUTOSAR AUTOSAR Release 4.2.2 Document Title Specification of Debugging in AUTOSAR Document Owner AUTOSAR Document Responsibility AUTOSAR Document Identification No 315 Document Classification Standard Document Status Final Part of AUTOSAR Release 4.2.2 Document Change History Release Changed by Change Description 4.2.2 AUTOSAR Marked the specification as obsolete Release Management 4.2.1 AUTOSAR Removed Post Buid information Release Other small modifications Management 4.1.3 AUTOSAR Editorial changes Release Updated the APIs Dbg_PostTaskHook and Management Dbg_RxIndication parameters Added missing descriptions for configuration containers Removed the type Dbg_ReturnType 4.1.2 AUTOSAR Added OS interfaces Release Removed Timing row from the scheduled Management function Editorial changes Removed chapter(s) on change documentation 4.1.1 AUTOSAR Reworked according to the new Administration SWS_BSWGeneralAdded subchapter 3.3 due to SWS General RolloutUpdated "scope" field of the configuration parameters descriptionUpdated chapter 5.3 - Corrected the wrongly placed requirement tracing tags 4.0.3 AUTOSAR Clarify interface toward "to be debugged" Administration modules Configuration for debugging variables (DbgStaticDID) is corrected and extended 3.1.5 AUTOSAR NULL pointer check for development mode Administration defined. 3.1.4 AUTOSAR Initial Release Administration 1 of 106 Document ID 315: AUTOSAR_SWS_Debugging - AUTOSAR confidential - Specification of Debugging in AUTOSAR AUTOSAR Release 4.2.2 2 of 106 Document ID 315: AUTOSAR_SWS_Debugging - AUTOSAR confidential - Specification of Debugging in AUTOSAR AUTOSAR Release 4.2.2 Disclaimer This specification and the material contained in it, as released by AUTOSAR, is for the purpose of information only. AUTOSAR and the companies that have contributed to it shall not be liable for any use of the specification. The material contained in this specification is protected by copyright and other types of Intellectual Property Rights. The commercial exploitation of the material contained in this specification requires a license to such Intellectual Property Rights. This specification may be utilized or reproduced without any modification, in any form or by any means, for informational purposes only. For any other purpose, no part of the specification may be utilized or reproduced, in any form or by any means, without permission in writing from the publisher. The AUTOSAR specifications have been developed for automotive applications only. They have neither been developed, nor tested for non-automotive applications. The word AUTOSAR and the AUTOSAR logo are registered trademarks. Advice for users AUTOSAR specifications may contain exemplary items (exemplary reference models, "use cases", and/or references to exemplary technical solutions, devices, processes or software). Any such exemplary items are contained in the specifications for illustration purposes only, and they themselves are not part of the AUTOSAR Standard. Neither their presence in such specifications, nor any later documentation of AUTOSAR conformance of products actually implementing such exemplary items, imply that intellectual property rights covering such exemplary items are licensed under the same rules as applicable to the AUTOSAR Standard. 3 of 106 Document ID 315: AUTOSAR_SWS_Debugging - AUTOSAR confidential - Specification of Debugging in AUTOSAR AUTOSAR Release 4.2.2 Table of Contents 1 Introduction and functional overview ................................................................... 7 1.1 Architectural overview ................................................................................... 7 1.1.1 Architectural view within the BSW ........................................................... 7 1.1.2 External architectural view ...................................................................... 7 1.2 Functional overview ....................................................................................... 8 2 Acronyms and abbreviations ............................................................................... 9 3 Related documentation...................................................................................... 11 3.1 Input documents .......................................................................................... 11 3.2 Related standards and norms ..................................................................... 11 3.3 Related specification ................................................................................... 12 4 Constraints and assumptions ............................................................................ 13 4.1 Limitations ................................................................................................... 13 4.1.1 Single Host Access ............................................................................... 13 4.1.2 Static configuration ............................................................................... 13 4.1.3 Security ................................................................................................. 13 4.1.4 Support for Object Code Modules ......................................................... 13 4.1.5 Impact on the basic software ................................................................ 13 4.1.6 Multi core support ................................................................................. 13 4.2 Assumptions ................................................................................................ 14 4.2.1 Assumptions on the host ....................................................................... 14 4.2.2 Assumptions on the communication ..................................................... 14 4.3 Applicability to car domains ......................................................................... 14 5 Dependencies to other modules ........................................................................ 15 5.1 File structure ................................................................................................ 15 5.1.1 Header file structure .............................................................................. 15 5.2 Requirements on the host ........................................................................... 16 5.3 Assumptions on other BSW Modules .......................................................... 17 5.4 Information of the BSW modules for the debugger ...................................... 18 6 Requirements traceability .................................................................................. 19 7 Functional specification ..................................................................................... 24 7.1 General Strategy to identify data ................................................................. 24 7.1.1 Standard DIDs ...................................................................................... 24 7.1.2 Predefined DIDs .................................................................................... 25 7.2 Buffering strategy ........................................................................................ 25 7.2.1 Static DID management ........................................................................ 26 7.2.2 Dynamic DID management ................................................................... 27 7.2.3 Data record ........................................................................................... 28 7.2.4 Data storage ......................................................................................... 29 7.3 Direct transmission ...................................................................................... 31 7.4 Information required for DIDs ...................................................................... 31 7.5 Cyclic Tracing and Tracing on Event ........................................................... 31 7.5.1 Cyclic tracing......................................................................................... 32 7.5.2 Tracing on event ................................................................................... 32 4 of 106 Document ID 315: AUTOSAR_SWS_Debugging - AUTOSAR confidential - Specification of Debugging in AUTOSAR AUTOSAR Release 4.2.2 7.5.3 Tracing on command ............................................................................ 32 7.6 Supported predefined DIDs ......................................................................... 32 7.6.1 Tracing of functions ............................................................................... 32 7.6.2 Tracing of Task switches ...................................................................... 33 7.6.3 Tracing of RTE events .......................................................................... 33 7.6.4 Transparent access to target memory .................................................. 33 7.6.5 Assignment of predefined DIDs ............................................................ 34 7.7 Timer, buffer, and buffering management ................................................... 35 7.7.1 DID collection on/off .............................................................................. 35 7.7.2 Individual DID activation on/off.............................................................. 35 7.7.3 Global timestamp on/off ........................................................................ 35 7.7.4 DID timestamp on/off ............................................................................ 36 7.7.5 DID buffering on/off