Iec 61506 1997

NORME INTERNATIONALE CEI IEC INTERNATIONAL STANDARD 61506 Première édition First edition 1997 02 Numéro de référence Reference number CEI/IEC 61506 1997 Mesure et commande dans les processus industrie[.]

NORME INTERNATIONALE CEI IEC 61506 INTERNATIONAL STANDARD Première édition First edition 1997-02 Industrial-process measurement and control – Documentation of application software Numéro de référence Reference number CEI/IEC 61506: 1997 LICENSED TO MECON Limited - RANCHI/BANGALORE FOR INTERNAL USE AT THIS LOCATION ONLY, SUPPLIED BY BOOK SUPPLY BUREAU Mesure et commande dans les processus industriels – Documentation des logiciels d'application Validité de la présente publication Validity of this publication Le contenu technique des publications de la CEI est constamment revu par la CEI afin qu'il reflète l'état actuel de la technique The technical content of IEC publications is kept under constant review by the IEC, thus ensuring that the content reflects current technology Des renseignements relatifs la date de reconfirmation de la publication sont disponibles auprès du Bureau Central de la CEI Information relating to the date of the reconfirmation of the publication is available from the IEC Central Office Les renseignements relatifs ces révisions, l'établissement des éditions révisées et aux amendements peuvent être obtenus auprès des Comités nationaux de la CEI et dans les documents ci-dessous: Information on the revision work, the issue of revised editions and amendments may be obtained from IEC National Committees and from the following IEC sources: • IEC Bulletin • Annuaire de la CEI • IEC Yearbook Publié annuellement • Catalogue des publications de la CEI Published yearly • Catalogue of IEC publications Publié annuellement et mis jour régulièrement Published yearly with regular updates Terminologie Terminology En ce qui concerne la terminologie générale, le lecteur se reportera la CEI 50: Vocabulaire Electrotechnique International (VEI), qui se présente sous forme de chapitres séparés traitant chacun d'un sujet défini Des détails complets sur le VEI peuvent être obtenus sur demande Voir également le dictionnaire multilingue de la CEI For general terminology, readers are referred to IEC 50: International Electrotechnical Vocabulary (IEV), which is issued in the form of separate chapters each dealing with a specific field Full details of the IEV will be supplied on request See also the IEC Multilingual Dictionary Les termes et définitions figurant dans la présente publication ont été soit tirés du VEI, soit spécifiquement approuvés aux fins de cette publication The terms and definitions contained in the present publication have either been taken from the IEV or have been specifically approved for the purpose of this publication Symboles graphiques et littéraux Graphical and letter symbols Pour les symboles graphiques, les symboles littéraux et les signes d'usage général approuvés par la CEI, le lecteur consultera: For graphical symbols, and letter symbols and signs approved by the IEC for general use, readers are referred to publications: – la CEI 27: Symboles littéraux utiliser en électrotechnique; – IEC 27: Letter symbols to be used in electrical technology; – la CEI 417: Symboles graphiques utilisables sur le matériel Index, relevé et compilation des feuilles individuelles; – IEC 417: Graphical symbols for use on equipment Index, survey and compilation of the single sheets; – la CEI 617: Symboles graphiques pour schémas; et pour les appareils électromédicaux, – IEC 617: Graphical symbols for diagrams; and for medical electrical equipment, – la CEI 878: Symboles graphiques pour équipements électriques en pratique médicale – IEC 878: Graphical symbols for electromedical equipment in medical practice Les symboles et signes contenus dans la présente publication ont été soit tirés de la CEI 27, de la CEI 417, de la CEI 617 et/ou de la CEI 878, soit spécifiquement approuvés aux fins de cette publication The symbols and signs contained in the present publication have either been taken from IEC 27, IEC 417, IEC 617 and/or IEC 878, or have been specifically approved for the purpose of this publication Publications de la CEI établies par le même comité d'études IEC publications prepared by the same technical committee L'attention du lecteur est attirée sur les listes figurant la fin de cette publication, qui énumèrent les publications de la CEI préparées par le comité d'études qui a établi la présente publication The attention of readers is drawn to the end pages of this publication which list the IEC publications issued by the technical committee which has prepared the present publication LICENSED TO MECON Limited - RANCHI/BANGALORE FOR INTERNAL USE AT THIS LOCATION ONLY, SUPPLIED BY BOOK SUPPLY BUREAU • Bulletin de la CEI NORME INTERNATIONALE CEI IEC 61506 INTERNATIONAL STANDARD Première édition First edition 1997-02 LICENSED TO MECON Limited - RANCHI/BANGALORE FOR INTERNAL USE AT THIS LOCATION ONLY, SUPPLIED BY BOOK SUPPLY BUREAU Mesure et commande dans les processus industriels – Documentation des logiciels d'application Industrial-process measurement and control – Documentation of application software  IEC 1997 Droits de reproduction réservés  Copyright - all rights reserved Aucune partie de cette publication ne peut être reproduite ni utilisée sous quelque forme que ce soit et par aucun procédé, électronique ou mécanique, y compris la photocopie et les microfilms, sans l'accord écrit de l'éditeur No part of this publication may be reproduced or utilized in any form or by any means, electronic or mechanical, including photocopying and microfilm, without permission in writing from the publisher International Electrotechnical Commission 3, rue de Varembé Geneva, Switzerland Telefax: +41 22 919 0300 IEC web site http: //www.iec.ch e-mail: inmail@iec.ch Commission Electrotechnique Internationale International Electrotechnical Commission CODE PRIX PRICE CODE XA Pour prix, voir catalogue en vigueur For price, see current catalogue –2– 61506 © CEI: 1997 SOMMAIRE Pages AVANT-PROPOS INTRODUCTION Articles Domaine d'application 14 Références normatives 14 Définitions 16 Abréviations 16 Assurance de la qualité, vérification et validation 18 5.1 Généralités 18 5.3 Validation 18 5.4 Procédures de modification 20 5.5 Gestion de la configuration 20 Structure et adaptation de la documentation 20 6.1 Structures générales 22 6.2 Identification des documents 28 6.3 Structure des documents en fonction du cycle de vie 28 6.4 Documentation spécifique un projet/produit normalisé 34 6.5 Documentation du logiciel système/logiciel d'application 34 6.6 Compilation de sous-ensembles de documents 34 6.7 Liste des documents 36 Cahier des charges 36 7.1 Objectif 36 7.2 Résumé 38 7.3 Référence l'annexe 38 Description des fonctions 38 8.1 Objectif 38 8.2 Résumé 38 8.3 Référence l'annexe 38 Description de la conception 38 9.1 Objectif 38 9.2 Résumé 40 9.3 Référence l'annexe 40 10 Liste des codes 40 10.1 Objectif 40 10.2 Résumé 40 10.3 Référence l'annexe 40 11 Documents d'exploitation 40 11.1 Objectif 40 11.2 Résumé 40 11.3 Référence aux annexes 42 LICENSED TO MECON Limited - RANCHI/BANGALORE FOR INTERNAL USE AT THIS LOCATION ONLY, SUPPLIED BY BOOK SUPPLY BUREAU 5.2 Vérification 18 61506 © IEC: 1997 –3– CONTENTS Page FOREWORD INTRODUCTION Clause Scope 15 Normative references 15 Definitions 17 Abbreviations 17 Quality assurance, verification and validation 19 5.1 General 19 5.2 Verification 19 5.3 Validation 19 5.4 Modification procedures 21 5.5 Configuration management 21 Documentation structure and tailoring 21 6.1 General structures 23 6.2 Identification of documents 29 6.3 Life cycle related document structure 29 6.4 Project specific versus standard product documentation 35 6.5 Documentation of system software versus application software 35 6.6 Compilation of document subsets 35 6.7 List of documents 37 Requirement specification 37 7.1 Objective 37 7.2 Summary 39 7.3 Reference to annex 39 Function description 39 8.1 Objective 39 8.2 Summary 39 8.3 Reference to annex 39 Design description 39 9.1 Objective 39 9.2 Summary 41 9.3 Reference to annex 41 Code list 41 10.1 Objective 41 10.2 Summary 41 10.3 Reference to annex 41 11 Operational documents 41 11.1 Objective 41 11.2 Summary 41 11.3 Reference to annexes 43 10 LICENSED TO MECON Limited - RANCHI/BANGALORE FOR INTERNAL USE AT THIS LOCATION ONLY, SUPPLIED BY BOOK SUPPLY BUREAU –4– 61506 © CEI: 1997 12 Documents de test 42 12.1 Objectif 42 12.2 Résumé 42 12.3 Référence aux annexes 44 13 Documents de maintenance 44 13.1 Objectif 44 13.2 Résumé 44 13.3 Référence aux annexes 44 14 Documents de formation 46 14.1 Objectif 46 14.2 Résumé 46 A Cahier des charges 48 B Description des fonctions 62 C Description de la conception 70 D Liste des codes 78 E Consignes d'exploitation 82 F Journal d'exploitation 86 G Spécification de test 90 H Compte rendu de test 94 J Journal de test 98 K Instruction de maintenance 102 L Journal de maintenance et de modification 108 M Description de la formation 112 N Bibliographie 118 LICENSED TO MECON Limited - RANCHI/BANGALORE FOR INTERNAL USE AT THIS LOCATION ONLY, SUPPLIED BY BOOK SUPPLY BUREAU 14.3 Référence l'annexe 46 Annexes 61506 © IEC: 1997 12 13 14 –5– Test documents 43 12.1 Objective 43 12.2 Summary 43 12.3 Reference to annexes 45 Maintenance documents 45 13.1 Objective 45 45 13.3 Reference to annexes 45 Training documents 47 14.1 Objective 47 14.2 Summary 47 14.3 Reference to annex 47 Annexes A Requirement specification 49 B Function description 63 C Design description 71 D Code list 79 E Operating instructions 83 F Operational log 87 G Test specification 91 H Test report 95 J Test log 99 K Maintenance instruction 103 L Maintenance and modification log 109 M Training description 113 N Bibliography 119 LICENSED TO MECON Limited - RANCHI/BANGALORE FOR INTERNAL USE AT THIS LOCATION ONLY, SUPPLIED BY BOOK SUPPLY BUREAU 13.2 Summary –6– 61506 © CEI: 1997 COMMISSION ÉLECTROTECHNIQUE INTERNATIONALE _ MESURE ET COMMANDE DANS LES PROCESSUS INDUSTRIELS – DOCUMENTATION DES LOGICIELS D’APPLICATION AVANT-PROPOS 2) Les décisions ou accords officiels de la CEI concernant les questions techniques, représentent, dans la mesure du possible un accord international sur les sujets étudiés, étant donné que les Comités nationaux intéressés sont représentés dans chaque comité d’études 3) Les documents produits se présentent sous la forme de recommandations internationales Ils sont publiés comme normes, rapports techniques ou guides et agréés comme tels par les Comités nationaux 4) Dans le but d'encourager l'unification internationale, les Comités nationaux de la CEI s'engagent appliquer de faỗon transparente, dans toute la mesure possible, les Normes internationales de la CEI dans leurs normes nationales et régionales Toute divergence entre la norme de la CEI et la norme nationale ou régionale correspondante doit être indiquée en termes clairs dans cette dernière 5) La CEI n’a fixé aucune procédure concernant le marquage comme indication d’approbation et sa responsabilité n’est pas engagée quand un matériel est déclaré conforme l’une de ses normes 6) L’attention est attirée sur le fait que certains des éléments de la présente Norme internationale peuvent faire l’objet de droits de propriété intellectuelle ou de droits analogues La CEI ne saurait être tenue pour responsable de ne pas avoir identifié de tels droits de propriété et de ne pas avoir signalé leur existence La Norme internationale CEI 61506 a été établie par le comité d'études 65 de la CEI: Mesure et commande dans les processus industriels Le texte de cette norme est issu des documents suivants : FDIS Rapport de vote 65/210/FDIS 65/212/RVD Le rapport de vote indiqué dans le tableau ci-dessus donne toute information sur le vote ayant abouti l'approbation de cette norme Les annexes A, B, C, D, E, F, G, H, J, K, L, M font partie intégrante de cette norme L’annexe N est donnée uniquement titre d’information LICENSED TO MECON Limited - RANCHI/BANGALORE FOR INTERNAL USE AT THIS LOCATION ONLY, SUPPLIED BY BOOK SUPPLY BUREAU 1) La CEI (Commission Electrotechnique Internationale) est une organisation mondiale de normalisation composée de l'ensemble des comités électrotechniques nationaux (Comités nationaux de la CEI) La CEI a pour objet de favoriser la coopération internationale pour toutes les questions de normalisation dans les domaines de l'électricité et de l'électronique A cet effet, la CEI, entre autres activités, publie des Normes Internationales Leur élaboration est confiée des comités d'études, aux travaux desquels tout Comité national intéressé par le sujet traité peut participer Les organisations internationales, gouvernementales et non gouvernementales, en liaison avec la CEI, participent également aux travaux La CEI collabore étroitement avec l'Organisation Internationale de Normalisation (ISO), selon des conditions fixées par accord entre les deux organisations 61506 © IEC: 1997 –7– INTERNATIONAL ELECTROTECHNICAL COMMISSION –––––––– INDUSTRIAL-PROCESS MEASUREMENT AND CONTROL – DOCUMENTATION OF APPLICATION SOFTWARE FOREWORD 2) The formal decisions or agreements of the IEC on technical matters express, as nearly as possible, an international consensus of opinion on the relevant subjects since each technical committee has representation from all interested National Committees 3) The documents produced have the form of recommendations for international use and are published in the form of standards, technical reports or guides and they are accepted by the National Committees in that sense 4) In order to promote international unification, IEC National Committees undertake to apply IEC International Standards transparently to the maximum extent possible in their national and regional standards Any divergence between the IEC Standard and the corresponding national or regional standard shall be clearly indicated in the latter 5) The IEC provides no marking procedure to indicate its approval and cannot be rendered responsible for any equipment declared to be in conformity with one of its standards 6) Attention is drawn to the possibility that some of the elements of this International Standard may be the subject of patent rights The IEC shall not be held responsible for identifying any or all such patent rights International Standard IEC 61506 has been prepared by IEC technical committee 65: Industrial process measurement and control The text of this standard is based on the following documents: FDIS Report on voting 65/210/FDIS 65/212/RVD Full information on the voting for the approval of this standard can be found in the report on voting indicated in the above table Annexes A, B, C, D, E, F, G, H, J, K, L, M form an integral part of this standard Annex N is for information only LICENSED TO MECON Limited - RANCHI/BANGALORE FOR INTERNAL USE AT THIS LOCATION ONLY, SUPPLIED BY BOOK SUPPLY BUREAU 1) The IEC (International Electrotechnical Commission) is a worldwide organization for standardization comprising all national electrotechnical committees (IEC National Committees) The object of the IEC is to promote international co-operation on all questions concerning standardization in the electrical and electronic fields To this end and in addition to other activities, the IEC publishes International Standards Their preparation is entrusted to technical committees; any IEC National Committee interested in the subject dealt with may participate in this preparatory work International, governmental and non-governmental organizations liaising with the IEC also participate in this preparation The IEC collaborates closely with the International Organization for Standardization (ISO) in accordance with conditions determined by agreement between the two organizations –8– 61506 © CEI: 1997 INTRODUCTION Les logiciels sont rapidement devenus un élément essentiel des systèmes de mesure et de commande de processus industriels Les fonctions de ces systèmes sont mises en oeuvre en code dans des systèmes électroniques programmables (PES) Les logiciels sont utilisés pour réaliser des fonctions de mesure et de commande dans les processus industriels Le système peut également assurer des fonctions telles que l'optimisation des processus, l'information de la direction, la logistique, la fabrication et l'ordonnancement La technologie logicielle est une discipline en plein développement qui élabore ses propres traditions de documentation dans une large mesure en fonction des besoins des programmeurs La documentation des fonctions de commande de processus s'est par ailleurs développée partir de la réalisation matérielle des fonctions Il existe en outre des normes CEI bien établies, tandis que d'autres sont en cours de développement L'objet de la présente Norme internationale est de définir des structures pour la documentation des logiciels des systèmes de mesure et de commande de processus et de définir des «types de documents» (future CEI 61355, voir bibliographie) La documentation doit être structurée de manière s'intégrer naturellement la documentation complète des équipements et des usines Il doit être possible de suivre les signaux et les informations issues du processus travers le matériel, dans le logiciel, puis vers l'interface homme-machine et vice versa Il existe différentes catégories de logiciels différents niveaux de la hiérarchie des logiciels système La présente norme n'a pas pour objet la documentation des logiciels des systèmes informatiques, sauf au niveau de leur interface avec le logiciel de la fonction de commande de processus Les fonctions des logiciels des systèmes informatiques sont par exemple – le système d'exploitation; – les communications avec l'opérateur de l'ordinateur (pas l'opérateur du système de commande et de processus); – les fonctions de diagnostic de l'ordinateur; – le système de gestion de base de données; – les modules de commande de périphériques du système d'exploitation (par exemple modules de gestion d'imprimantes, d'écrans de contrôle, de lecteurs de disques); – le mécanisme de communication avec le processus; – le mécanisme de communication avec d'autres ordinateurs; – les compilateurs; – les assembleurs La présente norme porte sur le niveau immédiatement supérieur de la structure logicielle, savoir le logiciel d'application LICENSED TO MECON Limited - RANCHI/BANGALORE FOR INTERNAL USE AT THIS LOCATION ONLY, SUPPLIED BY BOOK SUPPLY BUREAU Des efforts ont été faits dans différentes normes internationales et nationales afin de définir des règles de documentation des logiciels Ces efforts n'étant pas coordonnés, ils ont conduit des difficultés dans la coordination de la documentation des systèmes de mesure et de commande de processus La terminologie concernant la documentation n'est pas établie, ce qui entrne des confusions, des problèmes de compréhension et une mauvaise qualité des systèmes