ASAM MCD-1 (XCP) Protocol Layer Specification Base Standard

Transcription

1 ASAM MCD-1 (XCP) Universal Measurement and Calibration Protocol Protocol Layer Specification Version Date: Base Standard by ASAM e.v., 2017

2 Disclaimer This document is the copyrighted property of ASAM e.v. Any use is limited to the scope described in the license terms. The license terms can be viewed at

3 Figure Directory Table of Contents 1 Foreword 9 2 Introduction 10 3 Relations to Other Standards Backward Compatibility to Earlier Releases The XCP Protocol Layer Version Number The Compatibility Matrix References to other Standards CCP and XCP 12 4 XCP Features And Concepts Synchronous Data Transfer DAQ, STIM and ODT ODT Entry Object Descriptor Table DAQ List Event Channels Dynamic DAQ Configuration DAQ Configuration Storing and Power-up Data Transfer DAQ Configuration Storing Without Power-up Data Transfer DAQ Configuration Storing With Power-up Data Transfer (RESUME Mode) DAQ List Prioritization ODT Optimization DAQ Packed Mode DAQ List Behavior Event Channel Timestamps Error Handling Bitwise Stimulation Synchronous Data Acquisition Synchronous Data Stimulation Measurement Modes Polling Synchronous Data Transfer, DAQ direction, Burst, Standard Synchronous Data Transfer, DAQ direction, Burst, Improved Synchronous Data Transfer, DAQ direction, Alternating Bypassing Delayed Bypassing Bypass Activation Bypassing Startup Plausibility Checks Bypassing Consistency Event Channel Relations DTO CTR Event Channel Properties DTO CTR Field 40 XCP Universal Measurement and Calibration Protocol Version

4 DTO CTR Check Examples Minimum Separation Time Online Calibration SECTOR, SEGMENT and PAGE Logical Layout: SEGMENT Accessibility - PAGE Calibration Data Page Switching Calibration Data Page Freezing Addressing Action Master-Slave Action Page-Page Action Flash Programming Physical Layout: SECTOR General Absolute Access Mode - Access by Address Functional Access Mode - Access by Flash Area Checksum Control and Program Verify End of Flash Session Time Correlation Introduction XCP Slave s Clock Subsystem Scenario 1: one observable clock - free running XCP slave clock Scenario 2: one observable clock - single XCP slave clock, synchronized to a grandmaster clock Scenario 3: one observable clock - single XCP slave clock, syntonized to a grandmaster clock Scenario 4: two observable clocks - free running XCP slave clock combined with a globally synchronized clock Scenario 5: two observable clocks - free running XCP slave clock combined with an ECU clock Scenario 6: three observable clocks Scenario 7: ECU clock only ECU States Introduction Transferring the State Information to the XCP Master A2L Semantic Consistency 68 5 The XCP Protocol Topology The XCP Communication Models The Standard Communication Model The Block Transfer Communication Model The Interleaved Communication Model State Machine Protection Handling The XCP Message (Frame) Format 77 6 The Limits of Performance Generic Performance Parameters DAQ/STIM Specific Performance Parameters 78

5 Figure Directory DAQ Specific Parameters STIM Specific Parameters ECU Resource Consumptions ECU RAM Consumption CPU Execution Time 82 7 The XCP Protocol Layer The XCP Packet The XCP Packet Types The XCP Packet Format The Identification Field The Counter Field The Timestamp Field The Data Field The CTO Packets Command Packet Command Response Packet Error Packet Event Packet Service Request Packet The DTO Packets Data Acquisition Packet Synchronous Data Stimulation Packet The XCP Packet Identifiers Master -> Slave Slave -> Master Event Codes Service Request Codes Command Codes Description of Commands Standard Commands Set up Connection With Slave Get Version Information Disconnect From Slave Get Current Session Status From Slave Synchronize Command Execution After Timeout Get Communication Mode Info Get Identification From Slave Request to Save to Non-volatile Memory Get Seed for Unlocking a Protected Resource Send Key for Unlocking a Protected Resource Set Memory Transfer Address in Slave Upload From Slave to Master Upload From Slave to Master (short version) Build Checksum Over Memory Range Refer to Transport Layer Specific Command Refer to User-defined Command Calibration Commands Download From Master to Slave Download From Master to Slave (Block Mode) Download From Master to Slave (Fixed Size) Download From Master to Slave (Short Version) Modify Bits Page Switching Commands 146 XCP Universal Measurement and Calibration Protocol Version

6 Set Calibration Page Get Calibration Page Get General Information on PAG Processor Get Specific Information for a SEGMENT Get Specific Information for a PAGE Set Mode for a SEGMENT Get Mode for a SEGMENT Copy Page Data Acquisition and Stimulation Commands Set Pointer to ODT Entry Write Element in ODT Entry Set Mode for DAQ List Start/Stop/Select DAQ List Start/Stop DAQ Lists (Synchronously) Write Multiple Elements in ODT Set DAQ List Packed Mode Get DAQ List Packed Mode Read Element From ODT Entry Get DAQ Clock From Slave Get General Information on DAQ Processor Get General Information on DAQ Processing Resolution Get Mode From DAQ List Get Specific Information for an Event Channel DTO CTR Properties Clear DAQ List Configuration Get Specific Information for a DAQ List Clear Dynamic DAQ Configuration Allocate DAQ Lists Allocate ODTs to a DAQ List Allocate ODT Entries to an ODT Non-Volatile Memory Programming Indicate the Beginning of a Programming Sequence Clear a Part of Non-volatile Memory Program a Non-volatile Memory Segment Indicate the End of a Programming Sequence Get General Information on PGM Processor Get Specific Information for a SECTOR Prepare Non-volatile Memory Programming Set Data Format Before Programming Program a Non-volatile Memory Segment (Block Mode) Program a Non-volatile Memory Segment (fixed size) Program Verify Time Correlation Time Correlation Properties Communication Error Handling Definitions Error Pre-Action Action Error Severity Timeout Handling Standard Communication Model Block Communication Model Interleaved Communication Model Time-Out Manipulation Error Code Handling Description of Events Start in Resume Mode End of DAQ Clearing 257

7 Figure Directory End of DAQ Storing End of CAL Storing Request to Restart Time-out Detection Indication of DAQ Overload Indication of Autonomous Disconnect Transfer of Timestamp and Synchronization Indication of Timeout at STIM Entering Sleep Mode Leaving Sleep Mode ECU State Changed User-defined Event Transport Layer Specific Event Interface to ASAM MCD-2 MC Description File Overview ASAM MCD-2 MC AML for XCP (Common_Parameters) Protocol Layer and Transport Layer Parts (XCP_definitions.aml) Combining the Parts to an XCP Communication Stack (XCP_vX_Y.aml) Structure of an IF_DATA XCP Structure of an IF_DATA XCPplus ASAM MCD-2 MC Description File Containing an IF_DATA XCP and XCPplus Example ASAM MCD-2 MC Example of IF_DATA XCPplus Example A2L File Consistency Between ASAM MCD-2 MC and Slave Interface to an External Seed&Key Function Function XCP_GetAvailablePrivileges Function XCP_ComputeKeyFromSeed Interface to an External Checksum Function Interface to an External A2L Decompression/Decrypting Function Examples Configuration Examples Examples for GET_ID Identification Strings Example Communication Sequences Setting up a Session Calibrating Synchronous Data Transfer Getting Information About the Slave s DAQ List Processor Preparing the DAQ Lists Configuring the DAQ Lists Starting the Data Transfer Stopping the Data Transfer 289 XCP Universal Measurement and Calibration Protocol Version

8 Preparing a DAQ List for Packed Mode Reprogramming the Slave Closing a Session Time Correlation Symbols and Abbreviated Terms Bibliography 301 Figure Directory 302 Table Directory 304

9 Foreword 1 FOREWORD XCP is short for Universal Measurement and Calibration Protocol. The main purpose is the data acquisition and calibration access from electronic control units. Therefore a generic protocol layer is defined. As transport medium different physical busses and networks can be used. For each authorized transport medium a separate transport layer is defined. This separation is reflected in standard document structure, which looks like follows: One Base Standard Associated Standards for each physical bus or network type The Base standard describes the following content: Protocol Layer Interface to ASAM MCD-2 MC Interface to an external SEED&KEY function Interface to an external Checksum function Interface to an external A2L Decompression/Decrypting function Example Communication sequences For each transport layer exist an own associated standard. For the version in hand the following transport layers are defined XCP on CAN XCP on Ethernet (TCP/IP, UDP/IP) XCP on SxI (SPI, SCI) XCP on USB XCP on FlexRay The "X" inside the term XCP generalizes the "various" transportation layers that are used by the members of the protocol family. Because XCP is based on CCP the "X" shall also show that the XCP protocol functionality is extended compared to CCP. XCP Universal Measurement and Calibration Protocol Version