ISO INTERNATIONAL STANDARD 22900-2 Third edition 2022-06 Road vehicles Modular vehicle communication interface (MvcI) - Part 2: Diagnostic protocol data unit (D-PDU API) Vehicules routiers - Interface de communication modulaire du véhicule (MVCI) - Partie 2: Interface de programmation d'application d'unité de données du protocole de diagnostic (D-PDU API) Reference number IS0 22900-2:2022(E) ISO @IS02022 IS0 22900-2:2022(E) COPYRIGHT PROTECTED DOCUMENT IS02022 All rights reserved. Unless otherwise specified, or required in the context of its implementation, no part of this publication may the internet or an intranet, withoutpriorwrittenpermission.Permission can be requested from eitherIso at the addressbelow or Iso's member body in the country of the requester. ISO copyright office CP 401 · Ch. de Blandonnet 8 CH-1214Vernier,Geneva Phone: +41 22 749 01 11 Email: [email protected] Website: www.iso.org PublishedinSwitzerland i @ IS0 2022 - All rights reserved IS0 22900-2:2022(E) Contents Page Foreword vi Introduction 1 Scope 2 Normative references ..... 3 Terms, definitions and abbreviated terms... 3.1 Terms and definitions.... 3.2 Abbreviated terms... 4 Specification release version information .. 4.1 Specification release version location .... 4.2 Specification release version... 6 5 Modular vCI use cases... 5.1 OEM merger..... 6 5.2 OEM cross vehicle platform ECU(s).. h 5.3 Central source diagnostic data and exchange during EcU development 5.4 OEM franchised dealer and aftermarket service outlet diagnostic tool support...7 6 Modular vcI software architecture.... 6.1 .7 6.2 Modular vCI D-Server software.... .8 6.3 Runtime format based on ODX .... 6.4 MvCI protocol module software.. .9 6.5 MvcI protocol module configurations ... .9 7 D-PDU API use cases... .10 7.1 Overview.... 10 7.2 Usecase1:SingleMvcIprotocolmodule. ..11 7.3 Use case 2: Multiple MVCI protocol modules supported by same D-PDU API implementation... 7.4 Use case 3: Multiple MVCI protocol modules supported by different D-PDU API implementations.... 8 Diagnostic protocol data unit (D-PDU) API... .14 8.1 Software requirement... 14 8.1.1 General requirements. 14 8.1.2 Vehicle protocol requirements 15 8.1.3 Timing requirements for protocol handler messages .... 8.1.4 Serialization requirements for protocol handler messages ... .17 8.1.5 Compatibility requirements ... 8.1.6 Timestamp requirements..... 19 8.2 API function overview and communication principles .. 20 8.2.1 Terms used within the D-PDU API... .20 8.2.2 Function overview... 8.2.3 General usage..... 21 8.2.4 Asynchronous and synchronous communication.... .24 8.2.5 Usage of resource locking and resource unlocking... 8.2.6 Usage of ComPrimitives.. 25 8.3 Tool integration .. 42 8.3.1 Requirement for generic configuration.... 8.3.2 Tool integrator - 42 8.4 API functions - Interface description.... .44 @ ISO 2022 - All rights reserved ili IS0 22900-2:2022(E) 8.4.1 Overview. 44 8.4.2 8.4.3 .45 8.4.4 PDUIoCtl .46 8.4.5 PDUGetVersion.. 8.4.6 PDUGetStatus.... 8.4.7 PDUGetLastError.. ...50 8.4.8 PDUGetResourceStatus.. 8.4.9 8.4.10 PDUDestroyComLogicalLink... ..55 8.4.11 PDUConnect... 8.4.12 PDUDisconnect. 8.4.13 PDULockResource. ...60 8.4.14 PDUUnlockResource. ..61 8.4.16 PDUSetComParam... ...69 8.4.17 PDUStartComPrimitive, 8.4.19 PDUGetEventItem ... 77 8.4.20 PDUDestroyItem... ...78 ..81 8.4.23 PDUGetObjectId.. ..83 8.4.25 PDUGetResourceIds. ..86 8.4.26 PDUGetConflictingResources. ...87 8.28 PDUSetUniqueRespIdTable..... .90 8.4.29 PDUModuleConnect... ...95 8.4.30 PDUModuleDisconnect. 8.31 PDUGetTimestamp... .99 8.5 I/o control section... ...99 8.5.1 8.5.2 PDU_IOCTL_RESET. 8.5.3 PDU_IOCTL_CLEAR_TX.QUEUE.... ..102 8.5.4 PDU_IOCTL_SUSPEND_TX_QUEUE. 8.5.5 PDU_IOCTL_RESUME_TX.QUEUE... 8.5.6 PDU_IOCTL_CLEAR_RX_QUEUE 104 8.5.7 ..104 8.5.8 PDU_IOCTL_READ_VBATT 8.5.9 PDU_IOCTL_SET_PROG_VOLTAGE. 105 8.5.10 PDU_IOCTL_READ_PROG_VOLTAGE.. .106 8.5.11 PDU_IOCTL_GENERIC.. 8.5.12 PDU_IOCTL_SET_BUFFER_SIZE. 108 8.13 PDU_IOCTL_GET_CAB