io-list-ingestion

name	io-list-ingestion
description	Parser et ingérer des listes d'E/S de CAO électrique.
version	1.2.0
author	EVA
license	Privée EVA St-Étienne
platforms	["linux","macos","windows"]
metadata	{"tags":["eplan","cad","io-list","csv","excel","parsing","automation-engineering"],"related_skills":["siemens-scl-generation","rockwell-l5x-generation"]}

Ingestion et Conversion de Listes d'Entrées/Sorties CAO (EPLAN/AutoCAD)

Vue d'ensemble

Cette compétence régit l'ingestion industrielle de listes d'entrées/sorties (I/O) exportées à partir de schémas électriques (EPLAN, AutoCAD Electrical). Elle détaille l'utilisation de scripts d'ingestion automatisés pour normaliser les adresses physiques, valider la cohérence des signaux et générer les formats d'imports natifs pour TIA Portal et Studio 5000.

---

Outils Associés

Les scripts de conversion peuvent être exécutés par l'agent à l'aide de l'outil suivant :

• `execute_code` : Exécuter le script Python de conversion locale.

---

Fichier de Configuration de Mapping CAO (JSON)

Pour s'adapter aux différents formats d'exports de CAO, le script Python s'appuie sur un fichier de configuration décrivant la structure des colonnes :

{
  "csv_delimiter": ";",
  "columns": {
    "symbol": "Designation_Materiel",
    "address": "Adresse_Physique",
    "signal_type": "Nature_Signal",
    "description": "Texte_Fonctionnel",
    "voltage_range": "Plage_Tension_Courant"
  },
  "signal_mapping": {
    "DI": "BOOL",
    "DO": "BOOL",
    "AI": "INT",
    "AO": "INT"
  }
}

---

Script d'Ingestion Avancé avec Validation et Mapping de Bus (Python)

Ce script réalise le parsing, nettoie les symboles, attribue les types PLC corrects selon les plages physiques (ex: 4-20mA -> analogique INT brute ou REAL), résout les conflits et gère l'adressage multi-bus.

import csv
import json
import re
import xml.etree.ElementTree as ET

def clean_plc_symbol(symbol: str) -> str:
    """Nettoie le symbole pour être conforme aux spécifications de variables PLC."""
    s = symbol.translate(str.maketrans("àâäéèêëîïôöùûüçÀÂÄÉÈÊËÎÏÔÖÙÛÜÇ", "aaaeeeeiioouuucAAAEEEEIIOOUUUC"))
    s = re.sub(r"[^a-zA-Z0-9_]", "_", s)
    s = re.sub(r"__+", "_", s)
    return s.strip("_")

def parse_and_convert_io_list(csv_path: str, config_path: str, xml_out_path: str, csv_out_path: str):
    with open(config_path, 'r', encoding='utf-8') as cfg_f:
        cfg = json.load(cfg_f)
        
    cols = cfg['columns']
    sig_map = cfg['signal_mapping']
    
    symbols_seen = set()
    addresses_seen = {}
    valid_records = []
    
    with open(csv_path, mode='r', encoding='utf-8') as f:
        reader = csv.DictReader(f, delimiter=cfg['csv_delimiter'])
        for line_num, row in enumerate(reader, 1):
            raw_sym = row.get(cols['symbol'], ).strip()
            raw_addr = row.get(cols[], ).strip()
            raw_sig = row.get(cols[], ).strip().upper()
            desc = row.get(cols[], ).strip()
            voltage = row.get(cols[], ).strip()
            
              raw_sym   raw_addr:
                
                
            sym = clean_plc_symbol(raw_sym)
            
            
            
               voltage.upper()    voltage.upper()  raw_sig == :
                dtype =  
            :
                dtype = sig_map.get(raw_sig, )
                
            
             sym  symbols_seen:
                sym = 
            symbols_seen.add(sym)
            
            
             raw_addr  addresses_seen:
                ()
            :
                addresses_seen[raw_addr] = sym
                
            valid_records.append({
                : sym,
                : raw_addr,
                : dtype,
                :   voltage  desc
            })
            
    
    root = ET.Element()
    tag_table = ET.SubElement(root, , Name=)
    tags_node = ET.SubElement(tag_table, )
    
     rec  valid_records:
        tag = ET.SubElement(tags_node, , Name=rec[])
        ET.SubElement(tag, ).text = rec[]
        
        addr = rec[]
          addr.startswith():
            addr = 
        ET.SubElement(tag, ).text = addr
        
        comment = ET.SubElement(tag, )
        multi_lang = ET.SubElement(comment, , Lang=)
        multi_lang.text = rec[]
        
    tree = ET.ElementTree(root)
    tree.write(xml_out_path, encoding=, xml_declaration=)
    
    
     (csv_out_path, mode=, encoding=, newline=)  f:
        writer = csv.writer(f)
        writer.writerow([])
        writer.writerow([, , , , , ])
         rec  valid_records:
            desc_fmt =   rec[]  
            writer.writerow([, , rec[], rec[], desc_fmt, rec[]])

---

Bonnes Pratiques d'Ingestion EPLAN

1. Validation de la tension d'alimentation :
   • Si le signal est marqué comme DI (Digital Input) mais que la tension est notée 230VAC au lieu de 24VDC, l'agent doit insérer un avertissement dans le log d'importation pour inviter l'automaticien à vérifier la présence d'un relais de couplage dans le schéma.
2. Identification des Bus de Terrain :
   • Les adresses Profinet utilisent des topologies de type %I et %Q.
   • Les bus AS-i (Actuator Sensor Interface) utilisent souvent un format spécifique d'adresse de nœud (ex: ASI_1A_Bit0). Le script doit être configuré pour traduire ces formats vers des variables mémoires structurées.
3. Nettoyage des espaces et retours chariots :
   • Toujours nettoyer les champs textuels des caractères invisibles ou sauts de lignes pour éviter de corrompre les fichiers d'import XML/CSV finaux.