ISO INTERNATIONAL STANDARD 20242-5 First edition 2020-06 Industrial automation systems and integration Service interface for testing applications Part 5: Application program service interface Systemes d'automatisation industrielle et intégration - Interface de service pour controler les applications Partie 5: Interface de service des programmes d'application Reference number ISO 20242-5:2020(E) ISO @ IS0 2020 IS0 20242-5:2020(E) COPYRIGHT PROTECTED DOCUMENT @ IS0 2020 All rights reserved. Unless otherwise specified, or required in the context of its implementation, 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 below or Iso's memberbody in the country ofthe requester. ISO copyright office CP 401 · Ch. de Blandonnet 8 CH-1214 Vernier, Geneva Phone: +41 22 749 0111 Email: [email protected] Website: www.iso.org Published in Switzerland ii @ IS0 2020 - All rights reserved IS0 20242-5:2020(E) Contents Page Foreword Introduction 1 Scope 2 Normative references ... 3 Terms and definitions... 4 Symbols and abbreviated terms.. 5 Application Program Service Interface ... 5.1 Introduction. 5.2 Parameterization.. 5.3 Configuration.. 5.3.1 PID based configuration... 5.3.2 Service based and mixed configuration .... 5.4 Coordinator structure... 5.4.1 Workspace.. 5.4.2 Interface variants 5.5 Details for using APSI 5.5.1 Workspace structure.... .12 5.5.2 Callback methods and references.. 12 5.5.3 Workspace extension.... 5.5.4 Workspace transfer. .14 5.5.5 Data monitoring. 5.5.6 Data types... 5.5.7 Streaming ... 5.6 Error handling. Annex A (normative) Programmer's reference guide - Smart Access Interface .... Annex B (normative) Programmer's reference guide - Extended Access Interface .... 79 Annex C (normative) Programmer's reference guide - Full Access Interface.... ..125 Annex D (normative) Reference guide - Enums and status/ident informations ... ..222 Annex E (informative) Sequence diagrams .... ....235 Annex F (informative) Streaming ... .243 Annex G (informative) Data alignment and byte order .. Annex H (informative) Testing applications with the IS0 20242 (APSI) series and the IS0 13209 (0TX) series .. 250 Annex I (normative) Conformance test methods, criteria and reports .... ..279 Bibliography ... 283 @ IS0 2020 - All rights reserved ili IS0 20242-5:2020(E) Foreword Iso (the International Organization for Standardization) is a worldwide federation of national standards bodies (IsO member bodies). The work of preparing International Standards is normally carried out throughIsOtechnicalcommittees.Eachmemberbodyinterestedinasubjectforwhichatechnical committee has been established has the right to be represented on that committee. International organizations, governmental and non-governmental, in liaison with IsO, also take part in the work. ISO collaborates closely with the International Electrotechnical Commission (IEC) on all matters of electrotechnical standardization. The procedures used to develop this document and those intended for its further maintenance are described in the ISO/IEC Directives, Part 1. In particular, the different approval criteria needed for the different types of Iso documents should be noted. This document was drafted in accordance with the editorial rules of the ISO/IEC Directives, Part 2 (see www.iso.org/directives). Attention is drawn to the possibility that some of the elements of this document may be the subject of patent rights. IsO shall not be held responsible for identifying any or all such patent rights. Details of any patent rights identified during the development of the document will be in the Introduction and/or on the Iso list of patent declarations received (see www.iso.org/patents). Any trade name used in this document is information given for the convenience of users and does not constitute an endorsement. For an explanation of the voluntary nature of standards, the meaning of Iso