PLC DocGen

Comprendre rapidement un programme

Lors de l’ensemble de son cycle de vie, un programme automate est susceptible d’être développé et lu par de nombreux intervenants : développeurs, metteurs en service, mainteneurs, équipes de rénovation. Tous doivent pouvoir comprendre rapidement un programme qu’ils n’ont pas développé eux-mêmes afin d’être efficaces lors de leurs interventions.

Malheureusement, le code lui-même est parfois le seul document disponible … et il est souvent relativement peu commenté. Par ailleurs, lorsqu’une analyse fonctionnelle est présente, elle constitue une vue de très haut niveau et il est difficile d’établir des liens entre son contenu et le programme. Si une documentation a été rédigée en même temps que le code, encore faut-il qu’elle ait été maintenue à jour au fur et à mesure des évolutions du programme… et qu’elle n’aie pas été égarée ou physiquement dégradée.

Des besoins tout au long du cycle de vie

Avoir à intervenir sur un code non documenté est systématiquement une source de perte de temps majeure :

• Les metteurs en service ne bénéficient pas d’un lien clair entre spécifications et programme, perdant ainsi de précieuses heures lors des phases de mise au point et de debug.
• Les mainteneurs, en poste chez des propriétaires d’installations automatisées, doivent intervenir rapidement en cas de problème avec un programme et ont donc besoin d’une vue du programme permettant de comprendre immédiatement son comportement.
• Les rénovateurs qui portent le programme existant vers un nouvel automate doivent pouvoir s’appuyer sur des documents synthétiques pour rester au plus près du comportement initial du programme.
• Enfin, les chargés d’affaires qui estiment les charges de travail à partir d’analyses fonctionnelles peuvent être confrontés à des documents parfois non représentatifs de la complexité effective du programme.

Exemple de documentation générée par l’outil PLC DocGen

Génération automatique de logigrammes

Obtenir une documentation précise et synthétique est donc indispensable à la bonne efficacité de l’ensemble des intervenants tout au long du cycle de vie des programmes automates. Or, rédiger de la documentation de façon manuelle est une tâche fastidieuse et source d’erreurs. La nécessité d’une grande cohérence dans le format de la documentation et la dimension répétitive de sa rédaction plaident pour une approche outillée; c’est ce que permet PLC DocGen.

PLC DocGen est ainsi un outil de génération automatique d’une vue orientée flux de données d’un programme automate (de type input -> output) sous forme d’équations et de logigrammes. Cette vue, qui s’abstrait du flux d’exécution séquentiel, constitue un intermédiaire idéal entre l’analyse fonctionnelle et le code lui-même.

Cette vue est indépendante du type d’automate piloté par le programme, du langage de la norme IEC 61131 utilisé (sauf pour le function block diagram) et des spécificités de la programmation. Entièrement automatique, capable de prendre en compte tous types de templates de documentations (format des cartouches, type de symboles…), assurant une cohérence dans la forme des documents, PLC DocGen est basé sur une approche technologique pertinente pour tous les automates du marché et répond aux besoins de rétro-ingénierie des différents acteurs du développement et de la maintenance des programmes automate.

Méthodologie de l’offre PLC DocGen

La génération de logigrammes prend la forme d’un service outillé et se déroule selon une méthodologie claire et rigoureuse :

• Récupération des applications à documenter et envoi des différents fichiers à Itris Automation Square.
• Définition d’un template de documentation sur le cas réel d’une des applications fournies et précisant notamment les pages de garde, cartouche, sommaires, fonds de plans, pictogrammes et numérotation. Ce template est ensuite validé formellement.
• Génération automatique de la documentation proprement dite à l’aide de PLC DocGen selon un échéancier prenant en compte les priorités exprimées.
• Validation de la documentation générée par relectures croisées.
• Livraison des documents aux formats PDF et SVG respectant le template défini initialement et restant facilement modifiable à posteriori.

Disponibilité

PLC DocGen est proposé sous la forme d'un service outillé et est disponible pour les automates suivants :

• Schneider Electric SMC
• Schneider Electric April/Orphée
• Schneider Electric TSX Série7
• Schneider Electric Unity (Premium, Quantum et M340)
• Siemens Step 7
• Siemens Step 5

Contactez nous pour utiliser PLC DocGen dès aujourd'hui !

Téléchargez la fiche produit de PLC DocGen.