Kablix

English version

Extension en cours de developpement. Et si vous trouvez que j'écris comme une IA c'est surement parce qu'il y a du vrai.

Une application Gauloise de simulation de microcontrôleurs (Arduino Uno/Raspberry Pi Pico) directement dans VS Code,

• 100 % Offline
• 100 % Gratuit
• 100 % Libre
• 100 % Sans télémétrie

La simulation s’appuie sur deux moteurs open-sources embarqués dans l’extension : avr8js (ATmega328P) et rp2040js (RP2040), tous deux sous licence MIT.

Tests

Ma bilothèque de test est disponible : TestKablix

Utilisation

1. Pour démarrer, cliquer sur l’icône dans la barre d’activité à gauche ;
   • Ou dans un dossier de projet, double cliquer sur un fichier projix ;
   • Ou si vous avez fait l’association, dans l’explorateur Windows double cliquer sur un fichier projix.

1. Construire son montage : Glisser/poser un composant à partir de la bibliothèque à gauche. Relier les broches en direct et clique sur le bouton autoroutage (route les composants sélectionnés ou tout le montage si aucun n’est sélectionné).

1. Exécuter son code : Associer un fichier de code (attention les codes ino doivent être dans un dossier de même nom) puis ▶ « démarrer» :

   • .ino/.c/.cpp → compilation via la toolchain locale ;
   • .py → MicroPython sur le Pico simulé (firmware .uf2 requis, voir ci-dessous) ;
   • .hex / .uf2/.elf / .bin → chargé directement sans compilation.

2. Enregistrer son montage : « Kablix : Enregistrer le projet (.projix) » ; un .projix se rouvre ensuite d’un double-clic dans l’explorateur. Import/export au format Wokwi (diagram.json) également disponibles.

Fonctionnalités

• ✅ Atelier visuel : routage automatique.
• ✅ Créateur de composants : Possibilité de créer des composant « Perso » via ce créateur ou mieux, faire un fork, utiliser la doc pour ajouter le composant et faire une PR (demande de publication) il sera dans la version suivante pour tout le monde et merci de fournir aussi le fichier de test (pico + arduino).
• ✅ Export SVG.
• ✅ Bibliothèque de 63 composants rangés en 9 catégories, chacun avec sa fiche d’aide illustrée (bouton ❔) et ses deux montages de test, Arduino et Pico — liste complète.
• ✅ Cartes de développements prises en charge : Arduino Uno, Nano, Mega 2560 et Raspberry Pi Pico/Pico W, enfichables sur platine d’essai.
• ✅ Flash RP2040 réel.
• ✅ Chargement direct d’artefacts : .hex, .uf2, .elf, .bin compilés ailleurs, chargés sans recompilation
• ✅ Compilation du code réel C/C++
• ✅ Moniteur série bidirectionnel : sortie temps réel + champ d’envoi vers le microcontrôleur.
• ✅ Traceur de courbes : tracé en direct, plus des sondes posées sur une broche pour visualiser sa tension
• ✅ Simulation physique : luminosité selon la résistance série, les LED sans résistance grillent, les servomoteurs ne démarrent pas, l’alimentation tient compte du courant…
• ✅ Capteurs interactifs : curseurs et boutons pour flamme, gaz, son, lumière, température et mouvement, pilotant l’entrée du montage en direct.
• ✅ Intégrable à Windows.

📖 Guide complet : docs/fr/USAGE.md (français)/ docs/en/USAGE.md (English) — interface, câblage, création de composants personnalisés (avec prompt IA), format .kablix-part.json, sources de composants existants.

Ajouter un composant à Kablix (contributeurs, sur GitHub uniquement) : docs/fr/Creating-components.md (français) / docs/en/Creating-components.md (English) — du dessin dans Composants.svg au composant simulé, testé et documenté, à la main ou avec une IA.

🌍 Interface bilingue : français si VS Code est en français, anglais sinon. Le mécanisme est extensible à d’autres langues — voir Internationalisation.

Bibliothèque de composants

63 composants posables à la souris, rangés dans l’ordre de la palette. Chacun a sa fiche d’aide illustrée (bouton ❔ de l’inspecteur, hors-ligne, FR et EN) et deux montages de test prêts à simuler dans testkablix — un en C sur Arduino, un en MicroPython sur Pico.

À quoi s’ajoutent les composants personnalisés : dessinés dans le créateur intégré, ou importés au format .kablix-part.json.

Internationalisation

L’interface suit la langue de VS Code (vscode.env.language) : français si elle commence par fr, anglais sinon (langue de repli). La traduction repose sur trois registres indépendants, parce qu’ils traduisent des choses de nature différente :

L’aide n’est plus une copie HTML figée dans le code : c’est le guide lui-même qui s’affiche, images comprises — donc jamais en retard sur la documentation. Les captures lourdes (GIF de démo, logo) restent hors du .vsix et sont servies depuis GitHub ; toutes les autres sont embarquées, donc lisibles sans connexion.

Les trois registres utilisent la même résolution : le code base de la langue (fr-FR → fr) sélectionne l’entrée correspondante, et l’anglais sert de repli quand elle est absente.

Ajouter une langue (ex. allemand, de)

À faire aux trois registres — une langue déclarée à un seul endroit ne sera traduite qu’en partie :

1. Webview — dans src/webview/i18n.mts : créer le dictionnaire const DE = { … } (mêmes clés anglaises que FR) puis l’ajouter à DICTS → { fr : FR, de : DE }. Les clés non traduites retombent automatiquement sur l’anglais.
2. Extension — copier package.nls.json en package.nls.de.json et l10n/bundle.l10n.fr.json en l10n/bundle.l10n.de.json, puis traduire les valeurs (les clés restent identiques). VS Code choisit le fichier tout seul.
3. Aide — créer docs/de/ : le guide USAGE.md et le dossier composants/ (mêmes NOMS de fichiers que docs/fr/, seul le contenu est traduit ; les images sont mutualisées dans docs/img/). Élargir ensuite docLang() dans src/guide.ts et src/partHelp.ts — une fiche absente retombe déjà sur une autre langue.

Aucune autre modification de logique n’est nécessaire : la sélection et le repli sont gérés par initLocale() (webview) et docLang() (aide). npm run verify:docs contrôle que les guides et les fiches restent complets, illustrés et embarqués dans le paquet.

Crédits

Kablix est développé par Frank SAURET et s’appuie sur les bibliothèques open sources suivantes :

Le format de projet et les composants importés sont compatibles avec Wokwi (format ouvert diagram.json).

Licence

MIT — le bootrom RP2040 embarqué est © Raspberry Pi (Trading) Ltd, licence BSD-3-Clause.