IEC-61506-1997.pdf

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 industriels Documentation des logiciels d'application Industrial-process measurement and control Documentation of application software Copyright International Electrotechnical Commission Provided by IHS under license with IECLicensee=NASA Marshall Space Flight Center/9972545001 Not for Resale, 03/07/2007 01:38:40 MSTNo reproduction or networking permitted without license from IHS -,-,- Validité de la présente publication Le contenu technique des publications de la CEI est cons- tamment revu par la CEI afin qu'il reflète l'état actuel de la technique. Des renseignements relatifs à la date de reconfirmation de la publication sont disponibles auprès du Bureau Central de la CEI. Les renseignements relatifs à ces révisions, à l'établis- sement 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: Bulletin de la CEI Annuaire de la CEI Publié annuellement Catalogue des publications de la CEI Publié annuellement et mis à jour régulièrement Terminologie En ce qui concerne la terminologie générale, le lecteur se reportera à la CEI 50: Vocabulaire Electrotechnique Inter- national (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. Les termes et définitions figurant dans la présente publi- cation ont été soit tirés du VEI, soit spécifiquement approuvés aux fins de cette publication. Symboles graphiques et littéraux Pour les symboles graphiques, les symboles littéraux et les signes d'usage général approuvés par la CEI, le lecteur consultera: la CEI 27: Symboles littéraux à utiliser en électrotechnique; la CEI 417: Symboles graphiques utilisables sur le matériel. Index, relevé et compilation des feuilles individuelles; la CEI 617: Symboles graphiques pour schémas; et pour les appareils électromédicaux, la CEI 878: Symboles graphiques pour équipements électriques en pratique médicale. Les symboles et signes contenus dans la présente publi- cation 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. Publications de la CEI établies par le même comité d'études 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. Validity of this publication The technical content of IEC publications is kept under constant review by the IEC, thus ensuring that the content reflects current technology. Information relating to the date of the reconfirmation of the publication is available from the IEC Central Office. 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 IEC Yearbook Published yearly Catalogue of IEC publications Published yearly with regular updates Terminology 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. The terms and definitions contained in the present publi- cation have either been taken from the IEV or have been specifically approved for the purpose of this publication. Graphical and letter symbols For graphical symbols, and letter symbols and signs approved by the IEC for general use, readers are referred to publications: IEC 27: Letter symbols to be used in electrical technology; IEC 417: Graphical symbols for use on equipment. Index, survey and compilation of the single sheets; IEC 617: Graphical symbols for diagrams; and for medical electrical equipment, IEC 878: Graphical symbols for electromedical equipment in medical practice. 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. IEC publications prepared by the same technical committee 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. Copyright International Electrotechnical Commission Provided by IHS under license with IECLicensee=NASA Marshall Space Flight Center/9972545001 Not for Resale, 03/07/2007 01:38:40 MSTNo reproduction or networking permitted without license from IHS -,-,- NORME INTERNATIONALE CEI IEC INTERNATIONAL STANDARD 61506 Première édition First edition 1997-02 Mesure et commande dans les processus industriels Documentation des logiciels d'application Industrial-process measurement and control Documentation of application software XA Pour prix, voir catalogue en vigueur For price, see current catalogue CODE PRIX PRICE CODE International Electrotechnical Commission Telefax: +41 22 919 0300 3, rue de Varembé Geneva, Switzerland IEC web site http: /www.iec.che-mail: inmailiec.ch 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. Commission Electrotechnique Internationale International Electrotechnical Commission Copyright International Electrotechnical Commission Provided by IHS under license with IECLicensee=NASA Marshall Space Flight Center/9972545001 Not for Resale, 03/07/2007 01:38:40 MSTNo reproduction or networking permitted without license from IHS -,-,- 2 61506 © CEI: 1997 SOMMAIRE Pages AVANT-PROPOS.6 INTRODUCTION8 Articles 1Domaine d'application14 2Références normatives14 3Définitions .16 4Abréviations 16 5Assurance de la qualité, vérification et validation .18 5.1 Généralités.18 5.2 Vérification .18 5.3 Validation .18 5.4 Procédures de modification.20 5.5 Gestion de la configuration .20 6Structure 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'application34 6.6 Compilation de sous-ensembles de documents .34 6.7 Liste des documents.36 7Cahier des charges .36 7.1 Objectif.36 7.2 Résumé38 7.3 Référence à l'annexe 38 8Description des fonctions.38 8.1 Objectif.38 8.2 Résumé38 8.3 Référence à l'annexe 38 9Description de la conception38 9.1 Objectif.38 9.2 Résumé40 9.3 Référence à l'annexe 40 10Liste des codes .40 10.1 Objectif 40 10.2 Résumé40 10.3 Référence à l'annexe40 11Documents d'exploitation.40 11.1 Objectif 40 11.2 Résumé40 11.3 Référence aux annexes42 Copyright International Electrotechnical Commission Provided by IHS under license with IECLicensee=NASA Marshall Space Flight Center/9972545001 Not for Resale, 03/07/2007 01:38:40 MSTNo reproduction or networking permitted without license from IHS -,-,- 61506 © IEC: 1997 3 CONTENTS Page FOREWORD7 INTRODUCTION9 Clause 1Scope15 2Normative references .15 3Definitions.17 4Abbreviations17 5Quality assurance, verification and validation.19 5.1General.19 5.2Verification19 5.3Validation19 5.4Modification procedures .21 5.5Configuration management21 6Documentation structure and tailoring21 6.1General structures23 6.2Identification of documents.29 6.3Life cycle related document structure.29 6.4Project specific versus standard product documentation.35 6.5Documentation of system software versus application software35 6.6Compilation of document subsets35 6.7List of documents .37 7Requirement specification 37 7.1Objective.37 7.2Summary39 7.3Reference to annex39 8Function description39 8.1Objective.39 8.2Summary39 8.3Reference to annex39 9Design description 39 9.1Objective.39 9.2Summary41 9.3Reference to annex41 10Code list41 10.1Objective.41 10.2Summary41 10.3Reference to annex41 11 Operational documents .41 11.1Objective.41 11.2Summary41 11.3Reference to annexes 43 Copyright International Electrotechnical Commission Provided by IHS under license with IECLicensee=NASA Marshall Space Flight Center/9972545001 Not for Resale, 03/07/2007 01:38:40 MSTNo reproduction or networking permitted without license from IHS -,-,- 4 61506 © CEI: 1997 12Documents de test.42 12.1 Objectif 42 12.2 Résumé42 12.3 Référence aux annexes44 13Documents de maintenance.44 13.1 Objectif 44 13.2 Résumé44 13.3 Référence aux annexes44 14Documents de formation46 14.1 Objectif 46 14.2 Résumé46 14.3 Référence à l'annexe46 Annexes ACahier des charges .48 BDescription des fonctions.62 CDescription de la conception70 DListe des codes .78 EConsignes d'exploitation 82 FJournal d'exploitation.86 GSpécification de test 90 HCompte rendu de test 94 JJournal de test.98 KInstruction de maintenance 102 LJournal de maintenance et de modification. 108 MDescription de la formation 112 NBibliographie . 118 Copyright International Electrotechnical Commission Provided by IHS under license with IECLicensee=NASA Marshall Space Flight Center/9972545001 Not for Resale, 03/07/2007 01:38:40 MSTNo reproduction or networking permitted without license from IHS -,-,- 61506 © IEC: 1997 5 12Test documents43 12.1Objective.43 12.2Summary43 12.3Reference to annexes 45 13Maintenance documents.45 13.1Objective.45 13.2Summary45 13.3Reference to annexes 45 14Training documents47 14.1Objective.47 14.2Summary47 14.3Reference to annex47 Annexes ARequirement specification 49 BFunction description63 CDesign description 71 DCode list79 EOperating instructions.83 FOperational log87 GTest specification91 HTest report 95 JTest log.99 KMaintenance instruction 103 LMaintenance and modification log 109 MTraining description 113 NBibliography 119 Copyright International Electrotechnical Commission Provided by IHS under license with IECLicensee=NASA Marshall Space Flight Center/9972545001 Not for Resale, 03/07/2007 01:38:40 MSTNo reproduction or networking permitted without license from IHS -,-,- 6 61506 © CEI: 1997 COMMISSION ÉLECTROTECHNIQUE INTERNATIONALE _ MESURE ET COMMANDE DANS LES PROCESSUS INDUSTRIELS DOCUMENTATION DES LOGICIELS DAPPLICATION AVANT-PROPOS 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. 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 na fixé aucune procédure concernant le marquage comme indication dapprobation et sa responsabilité nest pas engagée quand un matériel est déclaré conforme à lune de ses normes. 6)Lattention est attirée sur le fait que certains des éléments de la présente Norme internationale peuvent faire lobjet 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 : FDISRapport de vote 65/210/FDIS65/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. Lannexe N est donnée uniquement à titre dinformation. Copyright International Electrotechnical Commission Provided by IHS under license with IECLicensee=NASA Marshall Space Flight Center/9972545001 Not for Resale, 03/07/2007 01:38:40 MSTNo reproduction or networking permitted without license from IHS -,-,- 61506 © IEC: 1997 7 INTERNATIONAL ELECTROTECHNICAL COMMISSION INDUSTRIAL-PROCESS MEASUREMENT AND CONTROL DOCUMENTATION OF APPLICATION SOFTWARE FOREWORD 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. Interna