CtrlLensCtrlLens

Documentation

Sommaire
Vue d’ensemble

Ce que fait CtrlLens

Git a été conçu pour le texte. Un projet Studio 5000 est un binaire propriétaire (.ACD) ou un seul fichier XML dense (.L5X) — Git brut ne donne donc ni diff, ni revue, ni fusion. CtrlLens comble cet écart : il éclate le projet en une arborescence par routine, rend chaque changement visuellement, résout les conflits de fusion rung par rung et maintient un briefing toujours à jour sur le disque pour votre assistant AI.

CtrlLens n’est pas un remplacement de Studio 5000 — il est complémentaire. Studio 5000 gère la configuration matérielle, la compilation, le téléchargement et la supervision en ligne. CtrlLens prend en charge la couche génie logiciel que Studio 5000 laisse ouverte : contrôle de version, revue de code, collaboration multi-développeurs, CI/CD et accès multiplateforme.

Diffs lisibles

Ladder, FBD, SFC et ST rendus sur un canevas — ajouts en vert, suppressions en rouge, modifications en jaune. Plus de blocs XML bruts.

Fusion sans crainte

Conflits résolus rung par rung avec un seul clic Accept Ours / Accept Theirs, revalidés avant le commit.

Prêt pour l’AI

Contexte de projet généré automatiquement pour que tout agent orienté fichiers parte de la vérité terrain, pas de suppositions.
Freemium. L’aperçu L5X et la synchronisation ACD ↔ L5X sont gratuits pour tous. Git VCS, Visual Diff, l’édition interactive, Merge UI et le contexte AI nécessitent CtrlLens Pro. Voir Licences & plateforme pour la répartition complète.

Comprendre, réviser et modifier la logique PLC

Utilisez 15 outils MCP locaux pour explorer la logique, suivre ses effets possibles et réviser les modifications validées avant toute écriture.

Retrouver la logique et ses sources

Explorez tâches, programmes et définitions AOI. Examinez les branches RLL dans l’ordre source, les liaisons de paramètres ou une vue texte en lecture seule, avec références et inconnues explicites.

Évaluer les effets possibles

Pro suit les lecteurs, les écritures possibles et les chemins d’influence bornés. L’analyse combine le diff Git et les appels, avec les frontières I/O, Motion, Safety et opaques.

Valider, réviser, appliquer

Validez Standard RLL/ST dans une copie isolée. Révisez les schémas Ladder RLL côte à côte, le texte exact, les commentaires et les contrôles, puis approuvez Pro Apply avec un reçu Studio Build valide.

Les requêtes et L1 fonctionnent sur plusieurs plateformes. L2 et Apply exigent Windows, Logix Designer SDK 2.2 et un projet Studio 5000 v37+ pris en charge. Aucun outil ne se connecte au contrôleur ni n’y télécharge de code.

Lire le guide Typed Patch
Commencer

Installer & activer l’extension

Installez CtrlLens via Microsoft Marketplace pour VS Code / Cursor, ou Open VSX pour Kiro, VSCodium et les éditeurs compatibles. Free ne nécessite pas de compte. L’extension se charge en présence de fichiers Logix.

Le bouton ? du titre VCS Sync et le lien Documentation de l’accueil sans projet ouvrent ce guide dans le navigateur, sans projet ouvert, licence Pro ni SDK.

Choisir votre marketplace

VS Code / Code OSS 1.108.0 ou supérieur requis. Choisissez le registre utilisé par votre éditeur.

Compatibilité des éditeurs

La compatibilité API et l’accès au registre sont nécessaires. Une cible de paquet ne garantit pas sa validation à l’exécution ; consultez les statuts ci-dessous.

ÉditeursInstaller depuisÉtat
Visual Studio Code 1.108+Microsoft MarketplacePris en charge
Cursor · Kiro · VSCodium (Code OSS 1.108+)Open VSXCibles de bureau prises en charge
Windsurf · code-server · produits Eclipse TheiaOpen VSX / registre du fournisseurPas encore validé par CtrlLens

Déclencheurs d’activation automatique

  • RSLogix5000Content/RSLogix5000Content.xml — un projet éclaté
  • acd_sync_config.yaml — un projet configuré
  • tout fichier *.l5x ou *.L5X

Activate Pro

Free needs nothing. To unlock Pro (Git, Visual Diff, editing, Merge UI, AI Context) you activate a license once — pick the path that matches your machine:

PathWhat you doResult
14-day trialOn the Activate page in your dashboard, click Start 14-day trial — it's free.Full Pro for 14 days on this machine, then it reverts to Free.
Online (default)In the extension, run CtrlLens: Activate License and paste your key (or click Activate in your dashboard). Your browser confirms it's you and the license is sent back to the editor automatically — no files to handle.Pro unlocked. The extension re-checks every ~12 h while online; one active device at a time (activating elsewhere takes over the slot).
Offline / air-gappedRun CtrlLens: Export Activation Request, carry it to a connected PC, issue a signed license.dat on the Activate page, copy it back, then run CtrlLens: Import License File.Pro works fully offline until the license expires — no network ever.
Switching a machine to offline is deliberate and binds the license file to that PC — but it's reversible: re-activate online anytime to return. For temporary offsite work, borrow the license (7 / 14 / 30 days) instead.

Prérequis

  • Git doit être installé — les fonctions de contrôle de version, de diff et de fusion en dépendent. Si vous ne l’avez pas déjà, téléchargez-le et installez-le depuis git-scm.com (la plupart des automaticiens/électriciens n’ont pas encore Git ; les options d’installation par défaut conviennent).
  • Aucun outil CLI à installer — l’éclatement/implosion L5X et toutes les opérations Git s’exécutent entièrement à l’intérieur de l’extension sur toutes les plateformes, sans aucune configuration.
  • Aperçu, Git, diff/merge, édition, requêtes IA et L1 : Windows, macOS et Linux. Conversion ACD et Typed Patch L2/Apply : Windows et SDK ; L2 exige aussi un projet Studio 5000 v37+ pris en charge.

Paramètres de l’extension

CtrlLens fonctionne avec zéro configuration. L’éclatement/implosion et Git s’exécutent dans le processus — il n’y a aucun chemin CLI à définir. Le convertisseur ACD ↔ L5X (ctrllens-acd, Windows uniquement) est livré dans l’extension et résolu automatiquement ; vous n’avez jamais à le pointer. Le seul paramètre optionnel est l’emplacement du SDK, et même celui-ci est détecté automatiquement :

ParamètreDéfautQuand le définir
ctrllens.logixDesignerSdkPathvide → détecté automatiquement (Windows)Uniquement si Studio 5000 / le SDK est installé à un emplacement non standard. Renseigné automatiquement au premier lancement lorsqu’il est trouvé.
Rien à configurer pour les outils principaux. L’éclatement/implosion L5X et Git s’exécutent à l’intérieur de l’extension, et le convertisseur ctrllens-acd est intégré et résolu automatiquement — il n’y a aucun chemin CLI à définir, et une mise à niveau ne casse jamais un chemin codé en dur.

Logix Designer SDK (Windows uniquement) — version 2.2.x requise (le ctrllens-acd intégré est compilé pour le client 2.2.1109 et doit correspondre au backend SDK 2.2 installé). Exemple d’emplacement d’installation par défaut :

C:\Program Files (x86)\Rockwell Software\Studio 5000\Logix Designer SDK

CtrlLens le détecte automatiquement au lancement et renseigne le paramètre pour vous. S’il n’est pas trouvé, CtrlLens affiche une invite unique avec les options install / set-path — ou définissez ctrllens.logixDesignerSdkPath manuellement.

Paramètres de comportement et d’affichage

ParamètreObjectif
ctrllens.defaultViewModeMode d’affichage par défaut : preview ou xml.
ctrllens.validateInViewModePro. Valider les routines en direct pendant leur simple consultation (mise en évidence rouge des opérandes invalides et du fil de rung). Désactivé par défaut — le mode édition valide toujours, indépendamment de ce paramètre.
ctrllens.merge.showReviewOnSuccessAprès un git merge sans conflit, afficher un panneau Merge Review résumant les changements de routines sur le point d’être commités (défaut : true).
ctrllens.git.historyLimitNombre maximal de commits récupérés pour les requêtes d’historique git — historique de routine, sélecteur de branch et liste de commits du repo (défaut : 100).
Commencer

Nouveau / Ouvrir / Fermer un projet

Le panneau VCS Sync expose la triade universelle de l’IDE. Chaque action correspond à une commande :

ActionCe qu’elle faitPlateforme
New Project…Un sélecteur unifié pour un .ACD ou un .L5X. Un .L5X est éclaté directement (sans SDK) → git init → commit initial. Un .ACD est converti automatiquement (acd2l5x) → éclaté → commité..L5X : toutes plateformes. .ACD : Windows + SDK
Open Project…Rattache un dossier éclaté existant ; valide le marqueur RSLogix5000Content/, propose git init si nécessaire, et lie automatiquement l’ACD depuis acd_sync_config.yaml si présent.Toutes plateformes — ne touche jamais au SDK
CloseRéinitialise les chemins configurés (ne supprime rien sur le disque).Toutes plateformes

Configuration initiale

  1. 1Ouvrez la barre latérale CtrlLens depuis la barre d’activités. Le panneau VCS Sync affiche « Aucun projet configuré ».
  2. 2Cliquez sur New Project… et choisissez un .L5X (fonctionne partout, sans SDK) ou un .ACD (converti automatiquement sous Windows + SDK) — ou Open Project… pour rattacher un dossier déjà éclaté.
  3. 3L’ACD est une propriété optionnelle par projet. Sans ACD lié, le panneau fonctionne en mode L5X (Sync from L5X) ; les actions spécifiques à l’ACD restent désactivées avec une infobulle explicative jusqu’à ce qu’un ACD soit lié ou généré.

Rejoindre un projet existant (onboarding clone)

  1. 1git clone <repo-url> le dépôt du projet et ouvrez le dossier dans VS Code.
  2. 2CtrlLens détecte la structure éclatée et propose : « Projet CtrlLens détecté. Associer un fichier ACD local ? »
  3. 3Cliquez sur Select ACD File pour lier votre ACD local, ou Later pour ignorer et travailler en mode L5X.

Configuration manuelle des chemins

Si l’invite d’onboarding a été rejetée, configurez les chemins directement dans le panneau VCS Sync : cliquez sur ... à côté de GIT REPO pour parcourir le dossier du projet, et ... à côté de ACD pour parcourir le fichier ACD.

Explorer un projet

Aperçu des diagrammes — RLL, FBD, SFC, ST

Cliquez sur une routine dans le Project Organizer pour l’ouvrir. Les langages graphiques (RLL/FBD/SFC) se rendent sur un canevas Konva ; Structured Text s’ouvre dans l’éditeur natif Monaco de VS Code avec une coloration syntaxique conforme PM007 (100+ instructions Rockwell, accès bit, repli de région, fonctions de conversion).

Navigation sur le canevas

ActionSaisie
PanoramiqueCliquer et faire glisser sur une zone vide du canevas
Zoom avant / arrièreCtrl = / Ctrl -, ou Ctrl + défilement
Réinitialiser le zoomCtrl 0
Définir le zoom exactCliquer sur le pourcentage dans la barre d’état et saisir une valeur (30%–300%)

Barre d’outils & barre d’état

  • Fil d’Ariane — chemin Task > Program > Routine, avec des badges pour le type de routine et le nombre de rungs.
  • Bouton Edit — bascule entre le mode Preview ↔ Edit (projets éclatés uniquement). Voir Édition interactive.
  • Bouton </> XML — expose la source de la routine aux outils AI. Voir Contexte AI.
  • Barre d’état — informations sur le rung et indicateur de modification à gauche, contrôles du zoom à droite.
Explorer un projet

Table des tags

Cliquez sur Controller Tags (N) ou Local Tags (N) pour ouvrir une table de tags dans le style Studio 5000.

ColonneDescription
NameNom du tag (monospace, bleu)
ValueValeur du tag, ou {...} pour les tableaux/structures
StyleRadix / style d’affichage
Data Typeex. DINT, BOOL, MyUDT
DescriptionCommentaire du tag
External AccessRead/Write, Read Only ou None
ConstantCoche si constant
Alias ForNom du tag source si aliasé
Tag TypeBase, Alias, etc.
  • Filtre — saisissez dans la zone de recherche pour filtrer par nom (temps réel, insensible à la casse).
  • Redimensionner les colonnes — faites glisser la bordure de tout en-tête de colonne (minimum 40px).
  • Clic droit sur le dossier Tags pour les options de diff et d’historique (voir Visual diff).
Éditer & inspecter · Pro

Édition interactive

Basculez le bouton Edit dans la barre d’outils pour entrer en mode édition. L’édition est disponible uniquement pour les projets éclatés (pas les fichiers .L5X uniques) et nécessite une licence Pro.

Édition en ligne — trois zones de déclenchement (RLL)

ZoneDéclencheurÉditeur
Texte d’opérandeDouble-clic sur l’étiquette de l’opérandeÉditeur de tag avec autocomplétion depuis les tags du projet + liste déroulante Tag Browser (Ctrl Space / Alt ↓)
Barre de titre mnémoniqueBloc : double-clic au-dessus du fil. Contact/Coil/Res : double-clic sur la bande graphiqueÉditeur mnémonique avec autocomplétion depuis le catalogue Rockwell complet + AOIs du projet ; les opérandes sont conservés par position
Cellule valeur numériqueDouble-clic sur la cellule valeur-sous sur une ligne hauteÉditeur de valeur sur une ligne ; persiste dans le XML du tag à la sauvegarde

Appuyez sur Enter ou Tab pour confirmer (Tab avance aussi vers l’opérande suivant en mode édition de tag) ; Escape annule. Double-cliquez sur la ligne de commentaire au-dessus d’un rung pour un éditeur de commentaire multi-ligne.

Sélection, glisser-déposer, menu contextuel

  • Sélectionner — cliquez sur une instruction ou un numéro de rung ; Ctrl+clic pour une sélection multiple ; Shift+clic sur un numéro de rung pour une plage ; cliquez sur un nœud de branche (Start/Middle/End) pour limiter la portée à la branche ou au chemin.
  • Faire glisser une instruction pour la déplacer (au sein d’un rung ou entre rungs) ; Ctrl+glisser pour dupliquer ; faire glisser un numéro de rung pour réordonner les rungs.
  • Clic droit sur une instruction, un numéro de rung ou un nœud de branche pour Cut / Copy / Paste / Duplicate / Delete (plus Insert Rung After sur les rungs).
  • Édition de branches — +Branch insère une branche à la sélection ; +BrLvl ajoute un chemin parallèle. La suppression de l’avant-dernier chemin désenveloppe automatiquement la branche.

Édition du corps d’action SFC / Transition

Dans l’éditeur SFC, double-cliquez sur un corps d’Action ou une condition de Transition pour ouvrir son code ST dans un onglet Monaco latéral (un fichier virtuel .st). Éditez, Ctrl S, et le contenu revient dans le XML SFC — le canevas se rafraîchit automatiquement. Comme le fichier virtuel est un vrai document, les outils AI peuvent lire et écrire ces corps directement.

Flux de sauvegarde

  • Ctrl S (ou le bouton Save) exécute une validation aller-retour (parse → sérialisation → parse) avant d’écrire le XML éclaté.
  • La fermeture d’un onglet modifié déclenche la fenêtre modale native de VS Code « Voulez-vous enregistrer les modifications ? » — Save / Don’t Save / Cancel.
  • Le déclenchement de Sync from ACD, un changement de branch ou Merge avec des routines non sauvegardées regroupe tous les onglets modifiés en une invite de sauvegarde combinée ; Cancel abandonne proprement l’opération en amont.
Éditer & inspecter · Pro

Créer des composants

CtrlLens crée de nouveaux tags, tâches, programmes, routines et Add-On Instructions via des boîtes de dialogue de style Studio 5000 et les écrit directement dans l’arborescence éclatée — un nouveau composant est donc un changement Git ordinaire que vous pouvez differ, passer en revue et annuler. Nécessite un projet éclaté et une licence Pro.

Où se trouve chaque boîte de dialogue

ComposantComment l’ouvrir
TagCtrlLens: Create Tag depuis la palette de commandes, ou faites un clic droit sur un opérande non résolu du canevas et choisissez New Tag
TaskClic droit sur le dossier Tasks dans le Project Organizer
ProgramClic droit sur une Task
RoutineClic droit sur un Program — choisissez Ladder, FBD, SFC ou Structured Text
Add-On InstructionClic droit sur le dossier Add-On Instructions ; la boîte de dialogue Definition du nouvel AOI s’ouvre dès sa création

Ce que les boîtes de dialogue refusent

Chaque champ est vérifié par rapport à ce que Studio 5000 accepte réellement à l’import, si bien que CtrlLens ne peut pas produire un projet que vous seriez ensuite incapable d’ouvrir. Les valeurs sont validées à chaque frappe et Create reste désactivé tant que la raison affichée à l’écran n’est pas levée.

  • Les noms suivent la règle d’identifiant IEC 61131-3 appliquée par Studio 5000 — commencer par une lettre ou un unique underscore, uniquement lettres/chiffres/underscores, 40 caractères au maximum, jamais deux underscores consécutifs, jamais d’underscore final. L’erreur nomme la règle exacte que vous avez enfreinte.
  • Task — Period 0.1 … 2,000,000 ms, Watchdog 1 … 2,000,000 ms, Priority 1 … 15.
  • La logique d’une Add-On Instruction est en Ladder, Function Block Diagram ou Structured Text — le SFC peut appeler un AOI mais ne peut pas en implémenter un. Choisir la classe Safety restreint le choix au Ladder.
  • Révision d’AOI — majeure 1 … 65535, mineure 0 … 65535.
  • Les types de données à portée Controller uniquement (AXIS_*, MOTION_GROUP, COORDINATE_SYSTEM) ne peuvent pas être créés en programme-local.

Après la création d’un tag

Les routines ouvertes le prennent en compte d’elles-mêmes : la mise en évidence rouge du tag non défini disparaît, et le tag apparaît dans le Tag Browser et dans l’autocomplétion des opérandes sans rien rouvrir. Depuis la palette de commandes c’est immédiat ; créé sur le canevas, cela suit en une demi-seconde environ.

Un agent AI passe par la même porte. Les outils MCP et commandes qu’un agent pilote passent exactement par la même validation que les boîtes de dialogue : les composants créés par un agent sont donc tenus aux mêmes règles qu’un humain — il n’existe pas de chemin distinct et plus permissif.
Éditer & inspecter

Aperçu des tags, références croisées, valeurs en direct & Cam Editor

Popup de survol de tag

Survolez tout élément porteur d’un tag pendant 500 ms pour voir une infobulle de style Studio 5000, disponible dans RLL, FBD, SFC et ST. L’ensemble des champs s’adapte au type d’opérande :

Type d’opérandeChamps affichés
Tag simple (MyBit, Servo)Tag · Data Type · Scope · Usage · Alias For · Valeur · Description
Accès membre (MyTimer.PRE)Élément du tag · Data Type du tag (tag de base) · Usage · Scope · Alias For · Valeur résolue · Description
Slots sans tag (JSR / JMP / LBL / FOR / EVENT / SFR / GSV)Étiquettes dédiées — Routine:, Label:, Task:, Step:, Class/Instance/Attribute:
Tag non définiBordure rouge + Undefined Tag: <name>
Drapeau d’état système (S:FS, S:MINOR …)Status Flag · Nom · Accès (lecture seule / lecture-écriture) · Description — tapez s: dans un éditeur de tag pour autocompléter les sept drapeaux ; les emplacements d’écriture ne proposent que les drapeaux inscriptibles

Le popup est en lecture seule et ne bloque jamais les clics ni les glissements. Se déplacer vers un autre opérande réarme le délai de 500 ms afin d’éviter le scintillement.

Valeurs de tags en direct & flux de puissance

  • Instructions de bloc — chaque ligne d’opérande numérique affiche la valeur résolue dans une boîte de valeur sous le texte de l’opérande (style moniteur de données Studio 5000).
  • Mise en évidence BOOL — les lignes d’opérande BOOL reçoivent un carré vert sur le bord droit quand la valeur est 1.
  • Flux de puissance Contact / Coil — quand le BOOL sous-jacent est 1, les tronçons de fil gauche/droit sont mis en évidence en vert.
  • Édition des valeurs (mode Edit, RLL) — double-cliquez sur une cellule de valeur, tapez, Enter, puis Ctrl S. CtrlLens réécrit dans le XML du tag en suivant les règles de portée programme-local puis controller ; annulation/rétablissement maintient la logique et les valeurs en cohérence.

Cam Editor (opérandes Motion CAM)

Les lignes d’opérande de bloc qui acceptent un tag de la famille CAM affichent une affordance …. Cliquez dessus pour ouvrir le Cam Editor de style Studio 5000 :

Type de donnéesMode
CAM / CAM_EXTENDEDEntièrement modifiable — ajouter/éditer/supprimer des points, éditer Master/Slave/SegmentType ; Save réécrit dans le XML du tag
CAM_PROFILE / CAM_PROFILE_EXTENDEDLecture seule — le cache polynomial L5K est généré par MCCP à l’exécution

Les courbes Position / Vitesse / Accélération / Jerk sont tracées avec une spline cubique naturelle (dérivées analytiques), stylisées pour correspondre aux propriétés graphiques de Studio 5000, avec panoramique/zoom et une table de points redimensionnable.

Cross Reference (Pro)

Le flux Cross Reference de Studio 5000, dans CtrlLens. En mode édition, faites un clic droit sur tout élément portant un tag — une instruction RLL, un IRef / ORef / bloc FBD, un Step ou une Transition SFC — et choisissez Cross Reference For "<tag>". Un onglet Cross Reference s’ouvre avec la table « By Logic » de Studio 5000 : une ligne par occurrence dans toutes les routines RLL, FBD, SFC et ST du projet, y compris les définitions d’Add-On Instructions — avec les ancres Container / Routine / Location, le tag de base de l’alias, la description du tag et une colonne Destructive (Y l’instruction peut écrire le tag · N lecture seule · ? inconnu).

  • Double-cliquez sur une ligne pour y sauter — la routine s’ouvre avec l’instruction / l’élément référençant sélectionné ; les références ST ouvrent la source .st à la ligne.
  • Filtrez et triez — Show bascule All / Destructive / Non-Destructive, la case Name accepte un chemin de membre (Timer1.DN) ou un joker de préfixe avec * final (Mot*), et les en-têtes de colonnes trient. Une requête sur le tag de base inclut les références aux membres — Timer1 trouve aussi Timer1.DN et Timer1.ACC.
  • Les agents obtiennent les mêmes données — l’outil MCP ctrllens_find_references renvoie des lignes identiques pour l’analyse d’impact côté IA (voir intégration IA).
Contrôle de version · Pro

Panneau VCS Sync

Le panneau VCS Sync est le hub central pour toutes les opérations de synchronisation et Git. Quand il est configuré, il affiche les chemins GIT REPO & ACD, la branch courante, l’heure du dernier commit, le statut de synchronisation avance/retard (ex. ↑2 ↓1) et l’URL du dépôt distant.

Bannière ACD Modifié

CtrlLens interroge le temps de modification du fichier ACD toutes les 10 secondes. Quand Studio 5000 sauvegarde l’ACD, une bannière jaune ACD Modifié — synchronisation nécessaire apparaît.

Opérations Git

BoutonAction
PushPousser les commits vers le dépôt distant (propose la configuration si aucun n’est défini)
PullTirer depuis le dépôt distant (sélection de la stratégie rebase/merge)
BranchCréer / changer / supprimer des branches ; propose Stash & Switch si des modifications existent
RestoreAbandonner tous les changements non commités (avec confirmation)
Stash / Pop (N)Remiser les modifications en cours ; dépiler le stash le plus récent
MergeFusionner une autre branch ; affiche Abort en cours de fusion

Opérations de synchronisation

Le panneau s’adapte au mode du projet, déterminé selon qu’un ACD est lié et que le SDK est disponible.

ModeBoutons
Mode ACDSync from ACD (ACD → L5X → Éclater → diff), Restore to ACD (Imploser → L5X → ACD), Restore to… (Enregistrer sous), Refresh
Mode L5XSync from L5X (sans SDK, toutes plateformes), Generate ACD (mise à niveau optionnelle une fois le SDK disponible), Refresh

Table de contenu

Affiche l’état des changements par composant après la synchronisation — Nom (Programme / Tags / DataTypes / Modules / Tâches), Statut (Synced / Modified / Untracked), et un résumé des changements au niveau rung (ex. +2 ~1 -0 rungs). Cliquez sur l’en-tête Content pour réduire/développer ; l’état persiste.

Commit

  1. 1Saisissez un message de commit dans la zone de texte en bas du panneau.
  2. 2Cliquez sur Commit Changes (activé uniquement si des éléments modifiés existent).
  3. 3CtrlLens commite tous les changements dans le répertoire du projet éclaté.

Détection du SDK & restriction de plateforme

La conversion .ACD nécessite le Logix Designer SDK (Windows uniquement) ; le chemin .L5X est sans SDK sur toutes les plateformes. New Project… / Open Project… / Refresh ne sont jamais bloqués — seuls les boutons spécifiques à l’ACD le sont.

EnvironnementLigne chemin ACDSync from ACD / RestoreSync from L5X
Windows + SDK détectéVisible, activéActivéDisponible si aucun ACD lié
Windows + SDK absentVisible, désactivé avec infobulleDésactivé, l’infobulle pointe vers ctrllens.logixDesignerSdkPathDisponible
macOS / LinuxMasquéMasquéDisponible

La détection automatique vérifie d’abord votre chemin configuré, puis les emplacements d’installation Rockwell standard ; le répertoire détecté est réécrit dans le paramètre afin d’apparaître dans l’interface Paramètres. Remplacez-le via Fichier → Préférences → Paramètres → « ctrllens » — le panneau Sync se rafraîchit immédiatement, sans rechargement nécessaire.

Contrôle de version · Pro

Visual diff & revue de code

Mode diff par défaut (HEAD vs arbre de travail)

Le Project Organizer décore les nœuds par rapport au dernier commit : ~M modifié (jaune), +A ajouté (vert), -D supprimé (rouge). Cliquez sur un nœud décoré pour ouvrir son diff.

Diff commit à commit

  1. 1Cliquez sur Compare Commits (icône git-compare) dans la barre de titre du Project Organizer.
  2. 2Choisissez les commits FROM et TO (ou « Working Tree »). Le sélecteur couvre toutes les branches ; les sommets de branch affichent des étiquettes de référence comme HEAD -> main.
  3. 3L’arborescence se met à jour avec des badges de décoration. Cliquez sur le bouton Home pour revenir à HEAD vs Working Tree.

Diff au niveau routine

Clic droit sur une Routine pour View Diff — Compare Two Commits ou Show Routine Commit History. Chaque langage a sa propre vue de diff :

LangageVue diff
RLLCanevas Konva côte à côte ; ajouté vert / supprimé rouge / modifié jaune / inchangé réduit ; Toggle Unchanged, Reselect FROM/TO, contrôles de zoom
FBDCanevas côte à côte avec couleurs de statut sur les bordures des éléments, éléments inchangés estompés, navigateur de changements et sélecteur de feuille
SFCCanevas côte à côte avec un panneau Detail pliable montrant le diff textuel des corps d’Action / conditions de Transition
STDiff structurel au niveau bloc (IF/FOR/WHILE/CASE) plus un bouton Open Monaco Diff pour un diff natif ligne par ligne

Diff des tags & programmes

  • Clic droit sur un dossier Tags pour View Tags Diff — Compare Two Commits ou l’historique — tags ajoutés/supprimés/modifiés avec nom, type, valeur et changements de commentaire.
  • Clic droit sur un Programme pour Diff All Routines in Program vs HEAD — un résumé de chaque changement de routine dans le programme.
Contrôle de version · Pro

Visual merge & résolution des conflits

Quand une fusion Git entre en conflit dans une routine graphique, CtrlLens ouvre une vue de fusion visuelle côte à côte. Il lit les trois étapes d’index Git (base / ours / theirs) directement plutôt que d’analyser les marqueurs de conflit, de sorte que les deux côtés se rendent toujours comme des diagrammes valides. La granularité dépend du langage :

LangageUnité de fusionOptions d’acceptation
RLLRung par rungAccept Ours / Theirs / All par rung, plus batch All Ours / All Theirs
FBDPar feuilleAccept Ours / All (garder les deux) / Theirs par feuille modifiée
SFCRoutine entièreAccept Ours / Theirs (graphe connecté unique, pas de sélection par élément)
  1. 1Cliquez sur Merge dans le panneau Sync après un pull conflictuel.
  2. 2Les routines en conflit apparaissent dans l’arborescence avec le statut U (non résolu) ; cliquez sur l’une d’elles pour ouvrir la vue Merge correspondante.
  3. 3Choisissez un gagnant par unité. Pour FBD, l’amorçage automatique basé sur la base pré-résout les feuilles modifiées d’un seul côté.
  4. 4Cliquez sur Confirm & Resolve pour écrire le résultat fusionné. Les choix en cours sont sauvegardés dans .git/ctrllens-merge-draft.json et restaurés si VS Code redémarre en cours de fusion.
  5. 5Les conflits que CtrlLens ne peut pas rendre (ST, définitions de tags, add/add sans base) retombent dans l’éditeur de fusion natif de VS Code. Abort Merge revient à l’état avant-fusion.
La granularité au niveau élément (par bloc / par action) est intentionnellement différée — FBD résout au niveau feuille et SFC au niveau routine pour éviter de corrompre les IDs d’éléments graphiques et les références de fils.

Merge Review lors d’une fusion sans conflit

Même quand un git merge se termine sans conflit, CtrlLens affiche un panneau Merge Review résumant les changements de routines sur le point d’être commités — de sorte qu’une fusion automatisée ou en avance rapide ne passe jamais inaperçue. Désactivez-le avec ctrllens.merge.showReviewOnSuccess: false.

Contrôle de version · Pro

Vérifier, valider & la porte de pré-commit

CtrlLens valide statiquement un projet par rapport au catalogue d’instructions et aux règles de portée Studio 5000, en faisant remonter les problèmes dans le panneau Problems natif de VS Code.

CommandePortée
CtrlLens: Verify RoutineLa routine ouverte (aussi sur la barre d’outils d’édition Ladder / FBD / SFC — utilise le instantané du canevas non sauvegardé, les modifications en cours sont donc vérifiées)
CtrlLens: Verify ControllerLe projet entier — aussi dans le menu clic droit sur la racine Controller <name> du Project Organizer (Pro)

Ce qui est vérifié

  • Les références de tags se résolvent dans les quatre portées (Programme-local / Controller / Paramètre AOI / Tag local AOI)
  • Type / Format / énumération exhaustive des opérandes, depuis le catalogue d’instructions complet extrait des htm
  • Pas de numéros de rung en double ; noms de routines uniques au sein d’un Programme ; pas de noms de tags en double inter-portées
  • Blocs orphelins FBD ; alternance Step ↔ Transition SFC
  • Estimation statique du chevauchement de tâches périodiques (nombre de rungs × 10 µs vs taux de tâche)
  • Compatibilité instruction ↔ langage éditeur (RLL / FBD / ST) ; syntaxe ST (appariement des crochets, orthographe des mots-clés)
  • Règles d’accès des drapeaux d’état système (S:FS, S:N, S:Z, S:V, S:C, S:MINOR, S:R) — un drapeau en lecture seule utilisé comme cible d’une instruction d’écriture déclenche une erreur précise, exactement comme le verify de Studio 5000

Règles de définition des Add-On Instructions

Une définition d’AOI est vérifiée dans son ensemble, pas seulement rung par rung. Les AOI chiffrés sont ignorés — Studio 5000 les a validés au moment de leur scellement et leur corps n’est pas inspectable.

  • Les paramètres Input et Output doivent être d’un type atomique ; les structures, chaînes, tableaux et MESSAGE relèvent d’un paramètre InOut.
  • Les tags locaux ne peuvent pas être de type MODULE / MESSAGE / ALARM / Motion, ni des tableaux multidimensionnels.
  • Les instructions que Studio 5000 interdit dans un AOI sont rejetées dans toutes les routines de mode de scan — Logic, Prescan, Postscan et EnableInFalse : BRK EOT EVENT FOR IOT JSR JXR MAOC PATT PCLF PCMD PDET POVR RET SBR SFP SFR. Une boucle Structured Text FOR … DO … END_FOR est une construction du langage et non l’instruction FOR : elle est laissée telle quelle.
  • Les chaînes d’appels d’AOI circulaires sont une erreur ; une imbrication au-delà de 8 niveaux est un avertissement.
  • Les instructions transitionnelles (ONS, OSR, OSF, MSG, PXRQ, SRT) dans un AOI dépourvu de routine EnableInFalse déclenchent un avertissement.
  • Les AOI de sécurité doivent utiliser une logique Ladder Diagram.

Des limites qui suivent votre contrôleur

Plusieurs limites Rockwell ne sont pas un nombre unique — elles varient selon la famille de contrôleurs et la version de Logix Designer. CtrlLens lit le type de processeur et la révision majeure du projet lui-même et applique celle qui correspond : vous n’êtes donc jamais averti d’un plafond que votre contrôleur n’a pas. Un numéro de catalogue non reconnu saute la vérification au lieu de deviner une famille.

LimiteValeur appliquée
Profondeur d’imbrication des AOI16 sur ControlLogix 5590 ; 25 jusqu’à Logix Designer v28 et 16 à partir de v29 sur 5580 / 5380 / 5480 ; aucune limite fixe sur 5570 / 5370
Paramètres InOut d’AOI64 sur ControlLogix 5590, GuardLogix 5580 et Compact GuardLogix 5380 ; 40 ailleurs
Portée des tags MESSAGEPortée Controller uniquement sur 5570 / 5370 ; programme-local également autorisé sur 5380 / 5480 / 5580 / 5590

Navigation, retour en direct & porte

  • Cliquez sur une entrée Problems pour ouvrir la routine et faire défiler le canevas jusqu’au rung / bloc / élément incriminé ; F8 parcourt nativement.
  • Mise en évidence rouge en direct — un fil de rung devient rouge dès qu’un opérande est invalide et récupère quand vous tapez un tag valide ou Ctrl Z ; les formes FBD/SFC se bordent de rouge de la même façon. Activé par défaut en mode édition uniquement — le mode visualisation reste propre car un L5X importé est déjà valide pour Studio 5000, donc tout rouge en mode visualisation serait un faux positif du validateur. Les utilisateurs Pro peuvent activer la mise en évidence en mode visualisation avec ctrllens.validateInViewMode ; les commandes Verify à la demande rapportent au panneau Problems quel que soit le mode.
  • Porte de pré-commit — avant un commit via le panneau Sync, les problèmes de sévérité erreur affichent une fenêtre modale : Commit Anyway continue, Fix First saute au panneau Problems.
Collaborer & automatiser

Workflow d’équipe multi-développeurs

Studio 5000 crée la logique ; CtrlLens transforme chaque projet en un repo Git avec branches et revues. Deux ingénieurs PLC travaillent en parallèle, pendant qu’un ingénieur senior examine et fusionne leurs pull requests — sans jamais installer Studio 5000, sur n’importe quel OS. Chaque étape ci-dessous est étiquetée avec l’outil qui l’exécute, afin de voir exactement où CtrlLens prend le relais de Studio 5000.

Outil par étape : CtrlLens Studio 5000
Dépôt Git partagé

L5X éclaté · branches de fonctionnalité · Pull Requests

push → revue → Merge / Rebase → pull

chaque rôle pousse et tire sur le même dépôt

Développeur A

Ingénieur PLC

Studio 5000 + CtrlLens · Windows

  1. 1Créer la logique (RLL / FBD / ST)Studio 5000
  2. 2Enregistrer le projet ACDStudio 5000
  3. 3Synchroniser ACD → L5X (éclater vers Git)CtrlLens
  4. 4Committer & pousser une branche de fonctionnalitéCtrlLens
  5. 5Ouvrir une Pull Request pour revueCtrlLens
  6. 6Tirer la branche main fusionnée, Restaurer vers ACDCtrlLens
  7. 7Rouvrir l'ACD pour continuer à construireStudio 5000
  8. 8Mise en service sur siteStudio 5000

Développeur B

Ingénieur PLC

Studio 5000 + CtrlLens · Windows

  1. 1Créer la logique (RLL / FBD / ST)Studio 5000
  2. 2Enregistrer le projet ACDStudio 5000
  3. 3Synchroniser ACD → L5X (éclater vers Git)CtrlLens
  4. 4Committer & pousser une branche de fonctionnalitéCtrlLens
  5. 5Ouvrir une Pull Request pour revueCtrlLens
  6. 6Tirer la branche main fusionnée, Restaurer vers ACDCtrlLens
  7. 7Rouvrir l'ACD pour continuer à construireStudio 5000
  8. 8Mise en service sur siteStudio 5000

Ingénieur senior

Relecteur de code

CtrlLens uniquement · tout OS

  1. 1Tirer la branche de la Pull RequestCtrlLens
  2. 2Diff visuel : RLL / FBD / SFC / STCtrlLens
  3. 3Commenter & demander des modificationsCtrlLens
  4. 4Résoudre les conflits de fusion visuellementCtrlLens
  5. 5Approuver & fusionner vers mainCtrlLens

Effectuez la revue de code PLC, le contrôle de version et les fusions à tout moment, sur n'importe quel OS — même sur une machine sans Windows ni Studio 5000 installé.

Configuration locale

Les chemins spécifiques à la machine de chaque développeur se trouvent dans acd_sync_config.yaml à la racine du projet. Il est git-ignoré intentionnellement :

# CtrlLens — local sync config (git-ignored)
source_acd_path: D:\Projects\MyProject.ACD
source_l5x_path: D:\Projects\MyProject.L5X
last_sync_timestamp: 1743465600000

Un projet porte la clé de chemin correspondant à son mode ; un projet en mode L5X mis à niveau via Generate ACD gagne une source_acd_path. last_sync_timestamp pilote la détection de changement ACD toutes les 10 secondes qui lève la bannière « ACD Modifié ».

Restaurer vers un nouvel ACD

Si vous avez cloné un projet sans ACD local, cliquez sur Restore to…, nommez un nouveau .ACD dans la boîte de dialogue Enregistrer sous — CtrlLens implode le projet → L5X → ACD — puis ouvrez le résultat dans Studio 5000.

Collaborer & automatiser · Free + Pro

Intégration AI — l’agent connaît déjà votre projet

CtrlLens est conçu pour fonctionner aux côtés des outils de codage AI (Claude Code, Copilot, Cursor). Quatre couches coopèrent pour que l’agent lise, modifie et étende un projet Logix en toute sécurité — fichiers de contexte, un pont XML, la validation croisée entre vues et un serveur d’outils MCP intégré — sans que CtrlLens n’appelle jamais une API AI lui-même.

Le pont </> XML

Les outils AI ne peuvent pas voir un canevas Konva — seulement les fichiers ouverts dans l’éditeur de texte. Le bouton </> XML dans le fil d’Ariane ouvre le XML sous-jacent de la routine afin que tout agent dans l’IDE puisse le lire. Après que l’agent sauvegarde, un observateur de fichiers re-rend le canevas en moins de 300 ms.

Le bundle de contexte

À la synchronisation / ouverture / Refresh Now, CtrlLens régénère un instantané markdown déterministe sous <gitDir>/.ctrllens/context/, réparti en quatre fichiers :

FichierContenu
PROJECT.mdInfos controller, l’arborescence Tâches → Programmes → Routines, règles pour l’édition assistée par AI, contraintes de portée controller et la procédure d’attribution de portée
TAGS.mdTags Controller / programme-local / AOI sous forme de tables alphabétisées, plus un Guide de création de tags avec des exemples XML de tags en direct et les conventions de nommage détectées
TYPES.mdChaque UDT avec les signatures de membres et chaque AOI avec les métadonnées, paramètres, tags locaux et routines (AOI chiffrés signalés 🔒)
InstructionIndex.mdLe catalogue d’instructions complet — chaque mnémonique et alias, par catégorie, avec un ✓ sur chaque instruction déjà utilisée par ce projet — pour que l’IA confirme qu’un mnémonique existe dans Logix 5000 avant de l’écrire ; le détail des opérandes reste dans ctrllens_get_instruction

Contrats de comportement au scan. PROJECT.md détaille aussi les règles sur lesquelles un AI Model se trompe systématiquement quand il n’a que ses données d’entraînement : en quoi les deux opérateurs d’affectation Structured Text diffèrent selon les modes de scan ([:=] se réinitialise au prescan, := conserve sa dernière valeur), quand S:FS se déclenche réellement, et le piège du timer scanné conditionnellement, qui peut faire perdre silencieusement jusqu’à 69.9 minutes. La section sur les conventions de nommage explique désormais aussi ce que signifie conventionnellement chaque préfixe détecté dans votre projet, au lieu de se contenter de le lister.

Tout est local uniquement et git-ignoré. À la première synchronisation, CtrlLens propose (une fois, refusable) d’écrire un AGENTS.md à la racine — la norme indépendante du fournisseur lue par Cursor / Copilot / Codex — ainsi qu’un mince CLAUDE.md qui l’importe. Écrivez vos politiques spécifiques au projet dans AGENTS.md ; CtrlLens ne le retouche plus jamais. Le modèle d’AGENTS.md inclut aussi une section Projets d’exemple : enregistrez vos projets de référence une seule fois (chemin + une ligne chacun) et chaque session d’agent saura où ils se trouvent — l’agent peut les lire directement ou pointer les outils MCP vers un exemple via projectRoot. Une section Style Guide fonctionne de la même façon : listez vos documents de normes de codage une seule fois (conventions de nommage, patterns de machine à états, style de commentaires) et les agents les lisent avant de générer ou de revoir la logique — un markdown ou un PDF lisible par votre agent suffit.

Validation croisée & Tag Browser

Si l’AI référence un tag qui n’existe pas dans la portée, chaque forme qui l’affiche devient rouge dans les trois vues ; quand l’AI crée le tag dans un répertoire surveillé, la mise en évidence disparaît en 2 secondes — pas de rechargement manuel. Le Tag Browser de style Studio 5000 s’ouvre depuis tout éditeur en ligne (Ctrl Space / Alt ↓) avec défilement virtuel pour les projets à 5000+ tags.

15 outils MCP : comprendre, valider, réviser, appliquer

Le serveur MCP local stdio fournit des requêtes étayées par les sources et un workflow Typed Patch en deux phases. CtrlLens n’appelle aucune API d’IA ; votre agent gère sa connexion au modèle et sa politique de données.

OutilCe qu’il apporte à l’agent
ctrllens_search_instructionsRecherche dans le catalogue complet d’instructions Logix par mot-clé, catégorie ou langage
ctrllens_get_instructionSpécifications d’opérandes exactes — types, formats, indicateurs requis, les formes de mots-clés enum que Studio 5000 sérialise réellement (avec leurs synonymes entiers), signatures ST et notes d’utilisation vérifiées à la main
ctrllens_get_routine_contextTags, signatures AOI, spécifications et patchPreconditions : empreintes exactes du projet, des routines et des barreaux.
ctrllens_render_previewJSON structuré de la disposition ladder d’un rung candidat ou d’une routine existante — l’agent voit la structure avant que quoi que ce soit ne soit écrit
ctrllens_verifyValidation à blanc (dry-run) de la logique générée par rapport aux tags, portées et signatures d’instructions de votre projet — le ladder et le ST passent chacun par le bon moteur
ctrllens_apply_rung · ProAncienne écriture Pro d’un barreau RLL vérifié en L1, approuvée séparément, atomique et réversible en cas d’échec. Sans Build L2 ni reçu Typed Patch.
ctrllens_get_commit_diff · ProDiff Git sémantique avec repères, ST avant/après, champs des tags et changements de sérialisation/EOL. Sans arguments : HEAD contre fichiers de travail ; deux refs : comparaison de commits.
ctrllens_find_references · ProRéférence croisée à l’échelle du projet pour un tag : chaque occurrence dans RLL / FBD / SFC / ST, y compris les définitions d’AOI, avec les ancres routine et emplacement, le tag de base de l’alias et un indicateur lecture/écriture (Destructive). Les chemins de membre et les jokers avec * final correspondent — conçu pour l’analyse d’impact « quoi d’autre touche ce tag » avant une modification
ctrllens_get_project_mapFree · Topologie Task/Program/Main/Fault/JSR/AOI avec sources, planification et frontières Safety/protégées.
ctrllens_search_projectFree · Recherche exacte, préfixe, floue et BM25 dans noms, tags, modules, instructions et commentaires, avec sources ; sans index cloud.
ctrllens_get_routine_semanticsFree · Conditions/effets RLL, connexions FBD, topologie SFC et indices lexicaux ST ; candidats de machines à états RLL/ST expérimentaux. Inclut aussi les routines de définition AOI, les liaisons RLL, les branches dans l’ordre source et une projection texte optionnelle en lecture seule.
ctrllens_trace_signal · ProPro · Lecteurs, écritures possibles et influences amont/aval bornées, avec alias, I/O et cycles.
ctrllens_get_change_impact · ProPro · Diff Git, appels et traçage : tags affectés, repères avant/après, gravité et frontières inconnues.
ctrllens_validate_patchFree · Validation isolée L0/L1, diff, impact, invariants, acceptation et Studio L2 optionnel. L2 absent ou en échec : applyEligible: false.
ctrllens_apply_patch · ProPro · Application approuvée avec reçu L2 valide à usage unique ; contrôle des empreintes, sauvegarde, écriture atomique et restauration si les contrôles échouent.

Privilégiez Typed Patch pour la nouvelle logique. Validez une copie, révisez contrat/diff/impact et contrôles, puis approuvez Apply. L1 seul ne permet pas l’application typée. Les deux chemins refusent les sources Safety, protégées et encodées.

Révision avec références source. Combinez ctrllens_get_commit_diff, ctrllens_get_change_impact et le contexte des routines. MAY_IMPACT exprime un effet possible, pas un comportement d’exécution prouvé.

Annoter les anciennes routines. ctrllens_apply_rung, approuvé séparément, peut conserver le texte et ajouter des commentaires. Vérifiez le diff : les barreaux non concernés sont préservés, mais les séparateurs XML peuvent changer de fin de ligne. Typed Patch teste séparément corps et commentaires. Aucune écriture Safety.

Lancez CtrlLens: Set Up AI Agent Tools (Client and Project Binding). Choisissez Codex ou Claude Code, le dossier de session et le projet PLC par défaut. Examinez la fusion avant Write configuration ; les autres serveurs et paramètres sont conservés. Rechargez MCP ou démarrez une session dans ce dossier, puis vérifiez les outils.

Relancez la configuration après une mise à jour ou un déplacement du projet. projectRoot explicite prime sur le défaut ; une liaison invalide produit une erreur. CtrlLens: Show AI Tools Configuration and Binding Status décrit la configuration, sans garantir une connexion active.

Comprendre à partir des sources

Commencez par get_project_map, puis search_project et get_routine_semantics. Pro trace_signal suit des influences possibles bornées. Les résultats portent un instantané et une certitude exact, conservative ou unknown. L’analyse d’états SFC reflète la structure native ; les candidats RLL/ST sont expérimentaux et ne prouvent ni accessibilité ni ordre de scan.

Ouvrez navigation.openUri dans l’éditeur hébergeant CtrlLens : après contrôle de l’instantané, XML/ST s’ouvre en lecture seule. Sinon, utilisez Developer: Open URL avec l’URI exacte. Il s’agit de la source, pas d’une sélection du canevas. Les preuves anciennes, absentes, périmées ou protégées peuvent être indisponibles.

Outils AI pris en charge

OutilComment il se connecte
Claude CodeFusion de .mcp.json dans le dossier de session. Lecture de CLAUDE.md → AGENTS.md → contexte.
CodexFusion de .codex/config.toml dans le dossier de session et liaison indépendante du projet PLC. Lecture de AGENTS.md.
GitHub Copilot (mode agent)Fournisseur MCP natif lié au projet courant ; vérifiez la découverte côté client.
Cursor / agents lisant les fichiersLecture de AGENTS.md, du contexte et du XML. Configurez MCP selon les mécanismes du client.
Autres clients MCPConnexion au serveur local stdio. Vérifiez runtime, projet et permissions ; la compatibilité de tous les clients n’est pas garantie.
9 outils Free, 6 Pro. Catalogue, contexte, carte/recherche/sémantique, aperçu, vérification et validation typée sont gratuits. Diff, impact, références, traçage et les deux Apply sont Pro. Le contexte AI Context généré est Pro ; Open Raw XML est gratuit. Les prérequis L2 sont communs aux deux offres.
IA et outils agents · Free

Comprendre la structure des routines et les appels AOI

ctrllens_get_routine_semantics inspecte une routine Program ou AOI existante avec références source, instantané et certitude explicite. Ces fonctions utilisent l’outil existant sans ajouter de droit d’écriture.

Ordre source RLL et branches

orderedLogic conserve tout le texte du barreau et, si l’analyse stricte réussit, un arbre imbriqué de séries, branches parallèles et instructions. Les chemins partagent les mêmes références source. L’ordre décrit le parcours du document, pas l’exécution. Une analyse incomplète conserve le texte et explique l’incertitude.

conditionAnalysis produit une expression locale au barreau uniquement pour des contacts XIC/XIO BOOL scalaires de base suivis d’un seul OTE terminal. État interne, écritures intermédiaires, appels, alias, membres, tableaux et instructions non prises en charge restent inconnus. Aucun état final de sortie ni comportement d’exécution n’est établi.

Définitions AOI et liaisons de paramètres

Indiquez exactement un des champs program ou aoi, ainsi que routine. Une définition AOI utilise ses propres paramètres et tags locaux. Le code interne protégé ou encodé est indisponible. Les cibles AOI ne réutilisent pas l’inférence de machine à états Program.

aoiBinding décrit instance, portée, ordre des paramètres et directions Input/Output/InOut. La correspondance positionnelle précise couvre les arguments Required des appels RLL. Les paramètres optionnels décrivent le stockage d’instance ; les autres langages et liaisons ambiguës, dynamiques ou via alias conservent des correspondances inconnues. Cela ne prouve pas quelles opérations internes s’exécutent.

Ouvrir le texte en lecture seule

Lancez CtrlLens: Open Read-only Routine Text, puis choisissez une routine Program ou AOI du projet ouvert. includeText: true renvoie aussi une textProjection pour la page courante, avec le même instantané et les mêmes repères. ST reste limité à des extraits lexicaux. Cette vue ne peut pas être enregistrée comme logique PLC. Si la source change, un message STALE/indisponible remplace le contenu ; rouvrez la vue pour la régénérer.

Exemple pour ctrllens_get_routine_semantics : remplacez PumpUnit et Logic par vos noms. Pour une routine Program, utilisez program au lieu de aoi.

{
  "aoi": "PumpUnit",
  "routine": "Logic",
  "includeText": true,
  "evidenceFormat": "compact"
}

Preuves compactes et sources actuelles

evidenceFormat: "compact" réduit les données de navigation répétées. Résolvez navigation.ref dans la navigationTable de cette réponse ; les entrées disponibles héritent du projet et de l’instantané de navigationContext. Si un suffixe existe, concaténez exactement openUriPrefix et openUriSuffix. Les IDs sont propres à chaque page. Conservez requête et format pour la pagination ; recommencez si l’instantané change.

Les requêtes répétées peuvent réutiliser le projet analysé, mais chaque requête recalcule l’empreinte de toutes les sources XML/ST et vérifie la cohérence après analyse. Une modification ou un changement de projet déclenche une nouvelle analyse. Aucun réglage de cache ; protections et contrôles d’obsolescence restent actifs.

Édition assistée par IA

Typed Patch : valider → réviser → appliquer

PlcPatchSetV1 déclare la modification et ses contrôles en données PLC. La validation utilise une copie temporaire ; l’écriture attend l’approbation des éléments réellement examinés.

Sans L2, aucun Typed Apply. Windows, Logix Designer SDK 2.2 et un projet Studio 5000 v37+ pris en charge sont requis. SDK absent, Build échoué ou projet antérieur à v37 : applyEligible: false, sans repli silencieux vers L1.

Modifications prises en charge

Projets décomposés hors ligne, routines Standard Program uniquement : insertion/remplacement/suppression de barreaux RLL ou remplacement complet d’une routine ST. Maximum 50 opérations sur des cibles déclarées. Exclus : écritures FBD/SFC, Safety, sources protégées/encodées, schémas Tag/UDT/AOI et configuration matérielle/tâches/programmes/mouvement.

De la proposition à l’écriture approuvée

  1. 1Obtenez patchPreconditions via ctrllens_get_routine_context pour chaque cible. Utilisez les empreintes exactes et déclarez accès, appels, contraintes, invariants et tests.
  2. 2Appelez Free ctrllens_validate_patch avec validationLevel: "L2". Corrigez puis revalidez. Pour un JSON enregistré, ouvrez CtrlLens: Review and Validate Typed Patch….
  3. 3Révisez contrat, logique/commentaires avant/après, impact, invariants, acceptation, L0/L1/L2, patchHash et reviewHash. Le panneau propose Apply, Reject et Export Patch. L’éligibilité ne remplace pas l’accord humain.
  4. 4Après approbation explicite, Pro ctrllens_apply_patch reçoit receiptId, patchHash, reviewHash et le même projectRoot. Contrôlez le diff final.

Réviser les schémas Ladder préparés

Les modifications RLL validées utilisent le même affichage de diff en lecture seule que les comparaisons ordinaires. Le texte exact, les commentaires, les exigences, l’impact avec ses inconnues, les contrôles et les empreintes restent visibles. ST conserve sa révision textuelle. Apply reste lié au même reçu à usage unique et aux contrôles d’instantané.

Niveaux de validation

NiveauContrôles
L0Schéma typé, périmètre/chemins, analyse RLL/ST et aller-retour implode → explode.
L1Diagnostics statiques CtrlLens, sans nouvelle erreur. Ce n’est pas une compilation.
L2Build Studio 5000 de la cible par défaut sur un ACD temporaire. Ne prouve pas le comportement en exécution.

Le reçu expire, est à usage unique, lié au projet et invalidé au redémarrage MCP. Apply recontrôle instantané et empreintes, sauvegarde dans .ctrllens/backups/, écrit atomiquement et restaure en cas d’échec. Si les fichiers changent, obtenez de nouvelles préconditions et revalidez.

Commentaires et acceptation

Les tests de texte acceptent scope: "body" ou scope: "comments". Un remplacement RLL fournit le commentaire complet : conservez explicitement l’ancien texte ; l’omission ou une valeur vide l’efface. Les changements de commentaires et de fins de ligne XML restent visibles.

Contrôles statiques et Build hors ligne, sans preuve de sûreté en exécution. Aucune connexion, lecture ou écriture de programme sur un contrôleur. ctrllens_apply_rung reste un chemin Pro historique L1, approuvé séparément.
Collaborer & automatiser

Pipeline CI/CD & tout hôte Git

Le L5X éclaté est du texte clair, votre projet n’est donc qu’un dépôt Git standard — poussez-le vers n’importe quel hôte CI/CD (GitHub Actions, Azure Pipelines, GitLab CI, …) et la protection de branche, la revue de Pull Request et l’historique fonctionnent tous d’emblée. La porte Verify vérifie statiquement les types d’opérandes, la portée des tags et les signatures d’instructions par rapport au catalogue d’instructions Rockwell complet au moment du commit, bloquant les régressions avant qu’elles n’atteignent un controller.

Pas de verrouillage fournisseur. CtrlLens utilise Git standard. Poussez vers GitHub, Azure DevOps, GitLab (cloud ou auto-hébergé), Bitbucket, Gitea ou un serveur nu — tout ce qui comprend git push. Vos données restent portables.
Référence

Raccourcis clavier

Aperçu Ladder (canevas)

RaccourciAction
Ctrl =Zoom avant
Ctrl -Zoom arrière
Ctrl 0Réinitialiser le zoom à 100 %
Ctrl + scrollZoom avec la molette de la souris

Mode édition

RaccourciAction
Ctrl ZAnnuler
Ctrl Y / Ctrl Shift ZRétablir
Ctrl SEnregistrer les modifications
DeleteSupprimer l’instruction / le rung / la branche sélectionné(e)
Ctrl C / X / V / DCopier / Couper / Coller / Dupliquer
Ctrl+click / Shift+clickSélection multiple / sélection de plage de rungs
Ctrl+dragDupliquer l’instruction par glissement
Tab / Shift TabNaviguer entre les opérandes éditables
Enter / EscapeConfirmer / annuler l’édition en ligne ou le glissement
Référence

Licences & plateforme

Ce qui est gratuit vs Pro

FonctionnalitéFreePro
Aperçu L5X (Ladder / FBD / SFC / ST / Tags)
Project Organizer + coloration syntaxique ST
Synchronisation ACD ↔ L5X
Git VCS (commit / push / pull / branch / stash / merge)
Visual Diff (RLL / FBD / SFC / Tags / ST)
Éditeur interactif + écriture Cam Editor
Création de Tag / Task / Program / Routine / Add-On Instruction
Interface de résolution des conflits de fusion
Bundle de contexte AI (.ctrllens/context/, pont AGENTS/CLAUDE)
MCP Free — catalogue, contexte, carte, recherche, sémantique, aperçu, vérification
MCP — ancienne écriture de barreau L1
Outils MCP pour agents — revue de commits/diffs
Cross Reference (panneau + MCP find_references)
Validation Typed Patch (L2 : Windows + SDK + v37+)
MCP — traçage et impact des changements
Typed Patch Apply (L2 réussi + approbation)

Un utilisateur Free qui déclenche une fonctionnalité Pro reçoit une invite de mise à niveau unique par session — rien n’est bloqué silencieusement.

Activation de Pro

Démarrez un essai de 14 jours ou achetez Pro depuis votre dashboard. Vous recevrez un license key comme CTL-XXXX-XXXX-XXXX par e-mail.

En ligne (par défaut) : exécutez CtrlLens: Activate License dans l’extension (ou cliquez sur Activate dans votre dashboard). Votre navigateur vérifie la propriété et la licence revient automatiquement dans l’éditeur — rien à télécharger ni à importer. Air-gapped : émettez un license.dat signé sur la page Activate et exécutez CtrlLens: Import License File à la place.

Licence concurrent (floating)

Une licence détient un seul slot en ligne actif. Installez sur autant de machines que vous le souhaitez ; activer ailleurs prend le slot, et la machine précédente passe aux fonctionnalités gratuites à son prochain refresh.

Pour un travail hors ligne ou sur site, empruntez la licence pour une utilisation hors ligne (7 / 14 / 30 jours), puis retournez-la tôt ou laissez-la expirer automatiquement.

Commandes de licence (Palette de commandes)

CommandeUtilisation
Activate License…Saisir votre clé + étiquette machine ; ouvre le dashboard pour autoriser
Import License File…Importer un license.dat téléchargé depuis le dashboard (aussi le chemin hors ligne)
Export Activation Request (Offline)…Produire une demande à porter sur une machine connectée (OT isolé)
Borrow / Return LicenseVerrouiller sur cet appareil pour 7 / 14 / 30 jours, ou retourner tôt
Take License Back to This Device…Récupérer le slot en ligne quand il est actif ailleurs
Refresh / Deactivate / Show DetailsHeartbeat / libérer le slot / inspecter l’état actuel

La barre d’état affiche l’état actuel — Free / Pro / Grace / Borrowed / Active Elsewhere / Expired ; cliquer sur un badge « Active Elsewhere » propose de récupérer le slot.

ACD Sync (gratuit, Windows uniquement)

ACD Sync convertit les binaires ACD en L5X à la sauvegarde et inversement — vous commitez donc L5X dans Git et continuez à ouvrir l’ACD natif dans votre outil d’ingénierie. Gratuit pour tous. Sa seule dépendance est le Logix Designer SDK (Windows, détecté automatiquement ; livré avec Studio 5000) — pas Studio 5000 lui-même. Git, diff, fusion, aperçu et édition fonctionnent tous sans lui sur toutes les plateformes.

Aperçu, Git, diff/merge, édition, requêtes IA et L1 : Windows, macOS et Linux. Conversion ACD et Typed Patch L2/Apply : Windows et SDK ; L2 exige aussi un projet Studio 5000 v37+ pris en charge.
FAQ

Questions fréquemment posées

Les fonctionnalités gratuites nécessitent-elles un compte ?

Non. L’aperçu L5X, l’organisateur de projet, le rendu ladder / FBD / SFC, la coloration syntaxique ST, le tag browser, la validation d’opérandes en direct et la synchronisation ACD ↔ L5X fonctionnent 100 % localement sans compte ni réseau.

Fonctionne-t-il dans Cursor et Kiro ?

Installez CtrlLens via Microsoft Marketplace pour VS Code / Cursor, ou Open VSX pour Kiro, VSCodium et les éditeurs compatibles. Free ne nécessite pas de compte. L’extension se charge en présence de fichiers Logix. VS Code / Code OSS 1.108.0 ou supérieur requis. Choisissez le registre utilisé par votre éditeur.

Comment fonctionne la licence concurrent ?

Une licence = un slot en ligne actif. Installez sur autant de machines que vous le souhaitez ; activer sur une nouvelle machine prend le slot et la machine précédente passe aux fonctionnalités gratuites à son prochain refresh. Empruntez pour 7 / 14 / 30 jours pour un travail hors ligne ou isolé.

Fonctionne-t-il hors ligne ou sur des réseaux isolés ?

Oui. Après une activation unique, la licence se vérifie hors ligne ; l’activation manuelle hors ligne est prise en charge pour les machines totalement isolées, et l’extension ne tente un refresh bihebdomadaire que lorsqu’elle a accès au réseau.

Où trouver mon machine ID ?

Dans VS Code ou Cursor, exécutez CtrlLens: Copy Machine ID depuis la palette de commandes et collez la valeur dans le dashboard lors du démarrage d’un essai ou de l’activation.

Quels outils AI sont pris en charge ?

Copilot utilise le fournisseur natif ; la configuration prend en charge Codex et Claude Code avec des dossiers client et PLC distincts. Les autres agents lisent le contexte ou configurent MCP. Les 15 outils couvrent compréhension, validation, analyses Pro et écritures approuvées. CtrlLens n’appelle aucune API d’IA.

Collectez-vous de la télémétrie ?

Zéro telemetry. Pas d’analyses, de rapports de plantage ni de suivi d’utilisation. L’extension ne contacte nos serveurs que pour l’activation de licence et le refresh bihebdomadaire. Votre code PLC ne quitte jamais votre machine.

Témoignage client — à venir.
Témoignage client — à venir.
Témoignage client — à venir.

Besoin d’aide ?

Des tutoriels complets et des exemples de projets sont en cours de rédaction. En attendant, envoyez un e-mail à [email protected] et nous répondrons directement.