Documentation
Sommaire
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
Fusion sans crainte
Prêt pour l’AI
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 PatchInstaller & 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
Pour Microsoft Visual Studio Code sur les plateformes de bureau prises en charge.
Pour Cursor, Kiro, VSCodium et les IDE Code OSS compatibles utilisant le registre ouvert.
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.
| Éditeurs | Installer depuis | État |
|---|---|---|
| Visual Studio Code 1.108+ | Microsoft Marketplace | Pris en charge |
| Cursor · Kiro · VSCodium (Code OSS 1.108+) | Open VSX | Cibles de bureau prises en charge |
| Windsurf · code-server · produits Eclipse Theia | Open VSX / registre du fournisseur | Pas encore validé par CtrlLens |
Déclencheurs d’activation automatique
RSLogix5000Content/RSLogix5000Content.xml— un projet éclatéacd_sync_config.yaml— un projet configuré- tout fichier
*.l5xou*.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:
| Path | What you do | Result |
|---|---|---|
| 14-day trial | On 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-gapped | Run 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. |
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ètre | Défaut | Quand le définir |
|---|---|---|
ctrllens.logixDesignerSdkPath | vide → 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é. |
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ètre | Objectif |
|---|---|
ctrllens.defaultViewMode | Mode d’affichage par défaut : preview ou xml. |
ctrllens.validateInViewMode | Pro. 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.showReviewOnSuccess | Aprè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.historyLimit | Nombre 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). |
Nouveau / Ouvrir / Fermer un projet
Le panneau VCS Sync expose la triade universelle de l’IDE. Chaque action correspond à une commande :
| Action | Ce qu’elle fait | Plateforme |
|---|---|---|
| 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 |
| Close | Réinitialise les chemins configurés (ne supprime rien sur le disque). | Toutes plateformes |
Configuration initiale
- 1Ouvrez la barre latérale CtrlLens depuis la barre d’activités. Le panneau VCS Sync affiche « Aucun projet configuré ».
- 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é. - 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
git clone <repo-url>le dépôt du projet et ouvrez le dossier dans VS Code. - 2CtrlLens détecte la structure éclatée et propose : « Projet CtrlLens détecté. Associer un fichier ACD local ? »
- 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.
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
| Action | Saisie |
|---|---|
| Panoramique | Cliquer et faire glisser sur une zone vide du canevas |
| Zoom avant / arrière | Ctrl = / Ctrl -, ou Ctrl + défilement |
| Réinitialiser le zoom | Ctrl 0 |
| Définir le zoom exact | Cliquer 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.
É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)
| Zone | Déclencheur | Éditeur |
|---|---|---|
| Texte d’opérande | Double-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émonique | Bloc : 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érique | Double-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 —
+Branchinsère une branche à la sélection ;+BrLvlajoute 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.
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
| Composant | Comment l’ouvrir |
|---|---|
| Tag | CtrlLens: 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 |
| Task | Clic droit sur le dossier Tasks dans le Project Organizer |
| Program | Clic droit sur une Task |
| Routine | Clic droit sur un Program — choisissez Ladder, FBD, SFC ou Structured Text |
| Add-On Instruction | Clic 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.
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érande | Champs 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éfini | Bordure 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ées | Mode |
|---|---|
CAM / CAM_EXTENDED | Entièrement modifiable — ajouter/éditer/supprimer des points, éditer Master/Slave/SegmentType ; Save réécrit dans le XML du tag |
CAM_PROFILE / CAM_PROFILE_EXTENDED | Lecture 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 —Timer1trouve aussiTimer1.DNetTimer1.ACC. - Les agents obtiennent les mêmes données — l’outil MCP
ctrllens_find_referencesrenvoie des lignes identiques pour l’analyse d’impact côté IA (voir intégration IA).
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
| Bouton | Action |
|---|---|
| Push | Pousser les commits vers le dépôt distant (propose la configuration si aucun n’est défini) |
| Pull | Tirer depuis le dépôt distant (sélection de la stratégie rebase/merge) |
| Branch | Créer / changer / supprimer des branches ; propose Stash & Switch si des modifications existent |
| Restore | Abandonner tous les changements non commités (avec confirmation) |
| Stash / Pop (N) | Remiser les modifications en cours ; dépiler le stash le plus récent |
| Merge | Fusionner 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.
| Mode | Boutons |
|---|---|
| Mode ACD | Sync from ACD (ACD → L5X → Éclater → diff), Restore to ACD (Imploser → L5X → ACD), Restore to… (Enregistrer sous), Refresh |
| Mode L5X | Sync 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
- 1Saisissez un message de commit dans la zone de texte en bas du panneau.
- 2Cliquez sur Commit Changes (activé uniquement si des éléments modifiés existent).
- 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.
| Environnement | Ligne chemin ACD | Sync from ACD / Restore | Sync from L5X |
|---|---|---|---|
| Windows + SDK détecté | Visible, activé | Activé | Disponible si aucun ACD lié |
| Windows + SDK absent | Visible, désactivé avec infobulle | Désactivé, l’infobulle pointe vers ctrllens.logixDesignerSdkPath | Disponible |
| macOS / Linux | Masqué | 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.
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
- 1Cliquez sur Compare Commits (icône git-compare) dans la barre de titre du Project Organizer.
- 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. - 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 :
| Langage | Vue diff |
|---|---|
| RLL | Canevas Konva côte à côte ; ajouté vert / supprimé rouge / modifié jaune / inchangé réduit ; Toggle Unchanged, Reselect FROM/TO, contrôles de zoom |
| FBD | Canevas 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 |
| SFC | Canevas côte à côte avec un panneau Detail pliable montrant le diff textuel des corps d’Action / conditions de Transition |
| ST | Diff 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.
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 :
| Langage | Unité de fusion | Options d’acceptation |
|---|---|---|
| RLL | Rung par rung | Accept Ours / Theirs / All par rung, plus batch All Ours / All Theirs |
| FBD | Par feuille | Accept Ours / All (garder les deux) / Theirs par feuille modifiée |
| SFC | Routine entière | Accept Ours / Theirs (graphe connecté unique, pas de sélection par élément) |
- 1Cliquez sur Merge dans le panneau Sync après un pull conflictuel.
- 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. - 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é.
- 4Cliquez sur Confirm & Resolve pour écrire le résultat fusionné. Les choix en cours sont sauvegardés dans
.git/ctrllens-merge-draft.jsonet restaurés si VS Code redémarre en cours de fusion. - 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.
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.
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.
| Commande | Portée |
|---|---|
CtrlLens: Verify Routine | La 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 Controller | Le 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
MESSAGErelè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 TextFOR … DO … END_FORest une construction du langage et non l’instructionFOR: 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.
| Limite | Valeur appliquée |
|---|---|
| Profondeur d’imbrication des AOI | 16 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’AOI | 64 sur ControlLogix 5590, GuardLogix 5580 et Compact GuardLogix 5380 ; 40 ailleurs |
Portée des tags MESSAGE | Porté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.
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.
L5X éclaté · branches de fonctionnalité · Pull Requests
push → revue → Merge / Rebase → pull
Développeur A
Ingénieur PLC
Studio 5000 + CtrlLens · Windows
- 1Créer la logique (RLL / FBD / ST)Studio 5000
- 2Enregistrer le projet ACDStudio 5000
- 3Synchroniser ACD → L5X (éclater vers Git)CtrlLens
- 4Committer & pousser une branche de fonctionnalitéCtrlLens
- 5Ouvrir une Pull Request pour revueCtrlLens
- 6Tirer la branche main fusionnée, Restaurer vers ACDCtrlLens
- 7Rouvrir l'ACD pour continuer à construireStudio 5000
- 8Mise en service sur siteStudio 5000
Développeur B
Ingénieur PLC
Studio 5000 + CtrlLens · Windows
- 1Créer la logique (RLL / FBD / ST)Studio 5000
- 2Enregistrer le projet ACDStudio 5000
- 3Synchroniser ACD → L5X (éclater vers Git)CtrlLens
- 4Committer & pousser une branche de fonctionnalitéCtrlLens
- 5Ouvrir une Pull Request pour revueCtrlLens
- 6Tirer la branche main fusionnée, Restaurer vers ACDCtrlLens
- 7Rouvrir l'ACD pour continuer à construireStudio 5000
- 8Mise en service sur siteStudio 5000
Ingénieur senior
Relecteur de code
CtrlLens uniquement · tout OS
- 1Tirer la branche de la Pull RequestCtrlLens
- 2Diff visuel : RLL / FBD / SFC / STCtrlLens
- 3Commenter & demander des modificationsCtrlLens
- 4Résoudre les conflits de fusion visuellementCtrlLens
- 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.
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 :
| Fichier | Contenu |
|---|---|
PROJECT.md | Infos 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.md | Tags 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.md | Chaque 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.md | Le 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.
| Outil | Ce qu’il apporte à l’agent |
|---|---|
ctrllens_search_instructions | Recherche dans le catalogue complet d’instructions Logix par mot-clé, catégorie ou langage |
ctrllens_get_instruction | Spé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_context | Tags, signatures AOI, spécifications et patchPreconditions : empreintes exactes du projet, des routines et des barreaux. |
ctrllens_render_preview | JSON 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_verify | Validation à 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 · Pro | Ancienne é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 · Pro | Diff 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 · Pro | Ré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_map | Free · Topologie Task/Program/Main/Fault/JSR/AOI avec sources, planification et frontières Safety/protégées. |
ctrllens_search_project | Free · Recherche exacte, préfixe, floue et BM25 dans noms, tags, modules, instructions et commentaires, avec sources ; sans index cloud. |
ctrllens_get_routine_semantics | Free · 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 · Pro | Pro · Lecteurs, écritures possibles et influences amont/aval bornées, avec alias, I/O et cycles. |
ctrllens_get_change_impact · Pro | Pro · Diff Git, appels et traçage : tags affectés, repères avant/après, gravité et frontières inconnues. |
ctrllens_validate_patch | Free · Validation isolée L0/L1, diff, impact, invariants, acceptation et Studio L2 optionnel. L2 absent ou en échec : applyEligible: false. |
ctrllens_apply_patch · Pro | Pro · 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
| Outil | Comment il se connecte |
|---|---|
| Claude Code | Fusion de .mcp.json dans le dossier de session. Lecture de CLAUDE.md → AGENTS.md → contexte. |
| Codex | Fusion 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 fichiers | Lecture de AGENTS.md, du contexte et du XML. Configurez MCP selon les mécanismes du client. |
| Autres clients MCP | Connexion au serveur local stdio. Vérifiez runtime, projet et permissions ; la compatibilité de tous les clients n’est pas garantie. |
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.
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.
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
- 1Obtenez
patchPreconditionsviactrllens_get_routine_contextpour chaque cible. Utilisez les empreintes exactes et déclarez accès, appels, contraintes, invariants et tests. - 2Appelez Free
ctrllens_validate_patchavecvalidationLevel: "L2". Corrigez puis revalidez. Pour un JSON enregistré, ouvrez CtrlLens: Review and Validate Typed Patch…. - 3Révisez contrat, logique/commentaires avant/après, impact, invariants, acceptation, L0/L1/L2,
patchHashetreviewHash. Le panneau propose Apply, Reject et Export Patch. L’éligibilité ne remplace pas l’accord humain. - 4Après approbation explicite, Pro
ctrllens_apply_patchreçoitreceiptId,patchHash,reviewHashet le mêmeprojectRoot. 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
| Niveau | Contrôles |
|---|---|
| L0 | Schéma typé, périmètre/chemins, analyse RLL/ST et aller-retour implode → explode. |
| L1 | Diagnostics statiques CtrlLens, sans nouvelle erreur. Ce n’est pas une compilation. |
| L2 | Build 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.
ctrllens_apply_rung reste un chemin Pro historique L1, approuvé séparément.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.
git push. Vos données restent portables.Raccourcis clavier
Aperçu Ladder (canevas)
| Raccourci | Action |
|---|---|
| Ctrl = | Zoom avant |
| Ctrl - | Zoom arrière |
| Ctrl 0 | Réinitialiser le zoom à 100 % |
| Ctrl + scroll | Zoom avec la molette de la souris |
Mode édition
| Raccourci | Action |
|---|---|
| Ctrl Z | Annuler |
| Ctrl Y / Ctrl Shift Z | Rétablir |
| Ctrl S | Enregistrer les modifications |
| Delete | Supprimer l’instruction / le rung / la branche sélectionné(e) |
| Ctrl C / X / V / D | Copier / Couper / Coller / Dupliquer |
| Ctrl+click / Shift+click | Sélection multiple / sélection de plage de rungs |
| Ctrl+drag | Dupliquer l’instruction par glissement |
| Tab / Shift Tab | Naviguer entre les opérandes éditables |
| Enter / Escape | Confirmer / annuler l’édition en ligne ou le glissement |
Licences & plateforme
Ce qui est gratuit vs Pro
| Fonctionnalité | Free | Pro |
|---|---|---|
| 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)
| Commande | Utilisation |
|---|---|
| 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 License | Verrouiller 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 Details | Heartbeat / 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.
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.
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.