ISO 22900-2:2017
(Main)Road vehicles — Modular vehicle communication interface (MVCI) — Part 2: Diagnostic protocol data unit (D-PDU API)
Road vehicles — Modular vehicle communication interface (MVCI) — Part 2: Diagnostic protocol data unit (D-PDU API)
ISO 22900-2:2017 specifies the diagnostic protocol data unit application programming interface (D-PDU API) as a modular vehicle communication interface (MVCI) protocol module software interface and common basis for diagnostic and reprogramming software applications. ISO 22900-2:2017 covers the descriptions of the application programming interface (API) functions and the abstraction of diagnostic protocols, as well as the handling and description of MVCI protocol module features. Sample MVCI module description files accompany this document. The purpose of ISO 22900-2:2017 is to ensure that diagnostic and reprogramming applications from any vehicle or tool manufacturer can operate on a common software interface and can easily exchange MVCI protocol module implementations.
Véhicules 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)
General Information
Relations
Standards Content (Sample)
INTERNATIONAL ISO
STANDARD 22900-2
Second edition
2017-06
Road vehicles — Modular vehicle
communication interface (MVCI) —
Part 2:
Diagnostic protocol data unit (D-PDU
API)
Véhicules 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
©
ISO 2017
© ISO 2017, Published in Switzerland
All rights reserved. Unless otherwise specified, no part of this publication may be reproduced or utilized otherwise in any form
or by any means, electronic or mechanical, including photocopying, or posting on the internet or an intranet, without prior
written permission. Permission can be requested from either ISO at the address below or ISO’s member body in the country of
the requester.
ISO copyright office
Ch. de Blandonnet 8 • CP 401
CH-1214 Vernier, Geneva, Switzerland
Tel. +41 22 749 01 11
Fax +41 22 749 09 47
copyright@iso.org
www.iso.org
ii © ISO 2017 – All rights reserved
Contents
1 Scope . 1
2 Normative references . 1
3 Terms, definitions and abbreviated terms . 1
3.1 Terms and definitions . 1
3.2 Abbreviated terms. 2
4 Specification release version information . 4
4.1 Specification release version location . 4
4.2 Specification release version . 5
5 Modular VCI use cases . 5
5.1 OEM merger . 5
5.2 OEM cross vehicle platform ECU(s) . 5
5.3 Central source diagnostic data and exchange during ECU development . 5
5.4 OEM franchised dealer and aftermarket service outlet diagnostic tool support . 6
6 Modular VCI software architecture . 6
6.1 Overview . 6
6.2 Modular VCI D-Server software . 7
6.3 Runtime format based on ODX . 7
6.4 MVCI protocol module software . 8
6.5 MVCI protocol module configurations . 8
7 D-PDU API use cases . 9
7.1 Overview . 9
7.2 Use case 1: Single MVCI protocol module . 9
7.3 Use case 2: Multiple MVCI protocol modules supported by same D-PDU API implementation . 10
7.4 Use case 3: Multiple MVCI protocol modules supported by different D-PDU API
implementations . 11
8 Diagnostic protocol data unit (D-PDU) API . 12
8.1 Software requirements . 12
8.1.1 General requirements . 12
8.1.2 Vehicle protocol requirements . 13
8.1.3 Timing requirements for protocol handler messages . 13
8.1.4 Serialization requirements for protocol handler messages . 14
8.1.5 Compatibility requirements . 16
8.1.6 Timestamp requirements . 16
8.2 API function overview and communication principles . 16
8.2.1 Terms used within the D-PDU API . 16
8.2.2 Function overview . 17
8.2.3 General usage . 18
8.2.4 Asynchronous and synchronous communication . 21
8.2.5 Usage of resource locking and resource unlocking . 21
8.2.6 Usage of ComPrimitives . 21
8.3 Tool integration . 36
8.3.1 Requirement for generic configuration . 36
8.3.2 Tool integrator — Use case . 36
8.4 API functions — Interface description . 38
8.4.1 Overview . 38
8.4.2 PDUConstruct . 38
8.4.3 PDUDestruct . 39
8.4.4 PDUIoCtl . 40
ii-1 © ISO 2017 – All rights reserved
8.4.5 PDUGetVersion . 42
8.4.6 PDUGetStatus . 42
8.4.7 PDUGetLastError . 43
8.4.8 PDUGetResourceStatus . 44
8.4.9 PDUCreateComLogicalLink . 45
8.4.10 PDUDestroyComLogicalLink . 48
8.4.11 PDUConnect . 49
8.4.12 PDUDisconnect . 51
8.4.13 PDULockResource . 52
8.4.14 PDUUnlockResource . 53
8.4.15 PDUGetComParam . 54
8.4.16 PDUSetComParam . 61
8.4.17 PDUStartComPrimitive. 63
8.4.18 PDUCancelComPrimitive . 67
8.4.19 PDUGetEventItem . 68
8.4.20 PDUDestroyItem . 69
8.4.21 PDURegisterEventCallback . 70
8.4.22 EventCallback prototype . 72
8.4.23 PDUGetObjectId . 73
8.4.24 PDUGetModuleIds . 74
8.4.25 PDUGetResourceIds . 76
8.4.26 PDUGetConflictingResources . 77
8.4.27 PDUGetUniqueRespIdTable . 78
8.4.28 PDUSetUniqueRespIdTable . 79
8.4.29 PDUModuleConnect . 84
8.4.30 PDUModuleDisconnect . 86
8.4.31 PDUGetTimestamp . 87
8.5 I/O control section . 88
8.5.1 IOCTL API command overview . 88
8.5.2 PDU_IOCTL_RESET . 90
8.5.3 PDU_IOCTL_CLEAR_TX_QUEUE . 91
8.5.4 PDU_IOCTL_SUSPEND_TX_QUEUE . 91
8.5.5 PDU_IOCTL_RESUME_TX_QUEUE .
...








Questions, Comments and Discussion
Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.