Comment générer des fichiers BOM et Centroid depuis KiCad sous Linux
Dernière mise à jour le Jan 13, 2026
Cet article explique comment générer des fichiers BOM (Bill of Materials – nomenclature) et CPL (Component Placement List – fichier de placement des composants) pour le service d'assemblage SMT et de soudure manuelle de JLCPCB à l'aide de KiCad sous Linux.
La méthode présentée ici utilise un plugin appelé KiJLC développé par Fully Automated.
Le projet de démonstration utilisé est kit-dev-coldfire-xilinx_5213, et le projet complet modifié est disponible dans ce dépôt GitHub.
Ce tutoriel a été testé avec KiCad 5.1.10 sous Ubuntu 18.04.
Installer le plugin
Tout d'abord, vous devez télécharger et installer le plugin sur votre système. Il sera chargé automatiquement lors du prochain démarrage de KiCad.
Installation manuelle
1. Téléchargez KiJLC depuis GitHub.

Figure 1. Télécharger KiJLC
2. Décompressez et renommez le dossier
Trouvez le fichier téléchargé et décompressez-le, puis changez le nom du dossier de KiJLC-main en KiJLC.
3. Copier au bon emplacement
Copiez maintenant le dossier KiJLC dans le dossier indiqué sur la capture d’écran suivante. Si le dossier/cible n’existe pas, vous pouvez simplement le créer manuellement.
Remarque: les fichiers et dossiers commençant par un point (.) sont cachés. Dans le gestionnaire de fichiers GNOME, utilisez CTRL+H pour les afficher. Si cela ne fonctionne pas, référez-vous à la documentation du gestionnaire de fichiers.
Figure 2. Plugin copié
Installation via git clone
Si le dossier ~/.kicad/scripting/plugins n'existe pas, ouvrez un terminal et exécutez:
mkdir -p ~/.kicad/scripting/pluginsEnsuite, rendez-vous dans ce dossier et clonez le plugin :
cd ~/.kicad/scripting/plugins
git clone https://github.com/JLCPCB/KiJLCAjouter le plugin BOM dans l'éditeur de schéma
C’est la dernière étape de l’installation.
Tout d’abord, ouvrez l’éditeur de schéma (Schematic Layout Editor). Dans la barre de menu, cliquez sur Outils → Générer la nomenclature (Tool → Generate Bill of Materials).

Figure 3. Élément de menu Générer la nomenclature
La fenêtre de Bill of Materials (nomenclature) apparaît maintenant.

Figure 4. Élément de menu Générer la nomenclature
Cliquez sur le bouton « + », naviguez jusqu’au dossier du plugin, sélectionnez bom2jlc.py, puis cliquez sur Ouvrir.

Figure 5. Parcourir et trouver bom2jlc.py
Laissez le surnom inchangé, puis cliquez sur OK.

Figure 6. Surnom du plugin
Modifiez la ligne de commande comme suit :
python3 "/home/atommann/.kicad/scripting/plugins/KiJLC/bom2jlc.py" "%I" "%O"
Ou le chemin complet (vous pouvez connaître le chemin complet en exécutant la commande which python3 dans le terminal) :
/usr/bin/python3 "/home/atommann/.kicad/scripting/plugins/KiJLC/bom2jlc.py" "%I" "%O"
Figure 7. Ligne de commande du plugin
Ajouter les champs BOM JLC et LCSC
Le plugin KiJLC nécessite la présence de deux champs : « JLC », qui doit contenir le spécificateur d’empreinte JLCSMT, et « LCSC », qui doit contenir le numéro de pièce issu de la bibliothèque de composants SMT de JLCPCB.
Le numéro de pièce « LCSC » est utilisé pour une correspondance précise dans le système de commande. Il est facultatif, mais il est fortement recommandé de l’inclure dans la nomenclature (BOM).
Actuellement, les spécificateurs d’empreintes KiCad ne sont pas convertis en spécificateurs JLC, mais cette fonctionnalité pourrait être implémentée à l’avenir.
Vous pouvez ajouter de nouveaux champs à un composant de plusieurs manières :
1. Double-cliquez sur un composant, ou placez simplement le curseur dessus puis appuyez sur la touche E pour ouvrir la boîte de dialogue Propriétés du symbole et ajouter les champs (voir Figure 8).
2. Dans la barre de menu, cliquez sur Outils → Modifier les champs des symboles ; cette méthode permet de modifier les champs en mode groupé (voir Figures 9 et 10).
3. À l’aide d’autres plugins KiCad, comme KiField.
4. Etc.

Figure 8. Les champs JLC et LCSC ont été ajoutés pour R25

Figure 9. Élément de menu Modifier les champs des symboles

Figure 10. Tableau des champs des symboles
Exporter les fichiers
Générer la nomenclature (BOM)
Ouvrez le schéma dans EEschema, puis sélectionnez Outils → Générer la nomenclature.

Figure 11. Élément de menu Générer la nomenclature
Cliquez sur le bouton Générer pour produire la nomenclature (BOM).

Figure 12. Génération de la nomenclature (BOM)
Générer le fichier CPL
Ouvrez la carte dans l’éditeur PCB, puis sélectionnez Outils → Plugins externes → Generate JLCSMT Placement Files.

Figure 13. Génération du CPL

Figure 14. CPL généré
Tous les fichiers générés se trouvent dans le dossier du projet, comme illustré ci-dessous.

Figure 15. Les fichiers BOM et CPL générés
Ces fichiers peuvent maintenant être téléversés sur JLCPCB.com pour la fabrication. Ci-dessous se trouve un aperçu d’un coin de la carte dans le système de commande.

Figure 16. Aperçu dans le système de commande
Remarque
Pour passer des commandes d’assemblage SMT ou de soudure manuelle, vous devez également générer les fichiers Gerber. Pour savoir comment procéder, veuillez consulter Comment générer des fichiers Gerber et de perçage dans KiCad 5.
