In diesem Artikel wird beschrieben, wie man BOM-Dateien (Stücklisten - Bill of Materials) und CPL-Dateien (Component Placement List, auch Pick-and-Place-Dateien genannt) für den JLCPCB SMT- und Handlötservice mit KiCad unter Linux erstellt.

Die hier vorgestellte Methode verwendet ein Plugin namens

GitHub - fullyautomated/KiJLC: KiCad BOM and CPL export for JLCSMT

welches von Fully Automated entwickelt wurde.

Als Beispielprojekt wird in diesem Tutorial das Projekt kit-dev-coldfire-xilinx_5213 verwendet.

Das vollständig modifizierte Projekt kann unter folgendem Link gefunden werden:

GitHub - JLCPCB/kit-dev-coldfire-xilinx_5213_kijlc_demo: Modified demo project kit-dev-coldfire-xilinx_5213 for KiJLC tutorial

Dieses Tutorial wurde mit KiCad 5.1.10 unter Ubuntu 18.04 getestet.

Installation des Plugins

Zuerst müssen Sie das Plugin herunterladen und in Ihrem System installieren.

Das Plugin wird automatisch geladen, sobald KiCad das nächste Mal gestartet wird.

Manuelle Installation

1. Laden Sie das Plugin von folgendem Link herunter:

GitHub - JLCPCB/KiJLC: KiCad BOM and CPL export for JLCPCB SMT and hand soldering service.

Abbildung 1. KiJLC herunterladen

2. Entpacken und Umbenennen des Ordners

Suchen Sie die heruntergeladene Datei und entpacken Sie sie.

Ändern Sie anschließend den Ordnernamen von KiJLC-main in KiJLC.

3. In das richtige Verzeichnis kopieren

Kopieren Sie nun den Ordner KiJLC in das folgende Verzeichnis, wie im nachstehenden Screenshot gezeigt.

Falls der Zielordner bzw. der Pfad noch nicht existiert, können Sie diesen einfach manuell anlegen

Abbildung 2. Plugin kopiert

Installation per Git-Klon

Falls der Pfad ~/.kicad/scripting/plugins noch nicht existiert, können Sie diesen über das Terminal mit folgendem Befehl erstellen

mkdir -p ~/.kicad/scripting/plugins									

Wechseln Sie anschließend in das Verzeichnis und klonen Sie das Plugin:

cd ~/.kicad/scripting/plugins
git clone https://github.com/JLCPCB/KiJLC								

Ein BOM-Plugin für den Schaltplan-Editor hinzufügen

Dies ist der letzte Schritt der Installation.

First, open the Schematic Layout Editor. From the menu bar, click Tool → Generate Bill of Materials:

Öffnen Sie zunächst den Schaltplan-Editor (Schematic Layout Editor).

Wählen Sie in der Menüleiste: Werkzeuge → Stückliste erstellen (Generate Bill of Materials):

Abbildung 3. Menüpunkt „Stückliste erstellen“

Nun erscheint der Dialog zur Erstellung der Stückliste.

Abbildung 4. Menüpunkt „Stückliste erstellen“

Klicken Sie auf die Schaltfläche „+“, navigieren Sie zum Plugin-Ordner, wählen Sie die Datei „bom2jlc.py“ aus und klicken Sie anschließend auf „Öffnen“.

Abbildung 5. Durchsuchen und Datei „bom2jlc.py“ auswählen

Lassen Sie den Spitznamen (Nickname) unverändert und klicken Sie auf „OK“.

Abbildung 6. Plugin-Spitzname

Ändern Sie die Befehlszeile zu:

python3 "/home/atommann/.kicad/scripting/plugins/KiJLC/bom2jlc.py" "%I" "%O"							

oder den vollständigen Pfad (der vollständige Pfad ist durch die Ausführung des Befehls python3 im Terminal bekannt):

/usr/bin/python3 "/home/atommann/.kicad/scripting/plugins/KiJLC/bom2jlc.py" "%I" "%O"					

Abbildung 7. Plugin-Befehlszeile

JLC- und LCSC-BOM-Felder hinzufügen

Das KiJLC-Plugin erwartet, dass zwei Felder in der Stückliste vorhanden sind:

● „JLC“ — Hier wird der JLCSMT-Footprint-Spezifizierer eingetragen.

● „LCSC“ — Hier wird die Teilenummer von JLCPCB Assembly Parts Library & Component Sourcing - JLCPCB eingetragen.

Die „LCSC“ Teilenummer wird für die präzise Zuordnung im Bestellsystem verwendet.

Dieses Feld ist optional, aber es wird dringend empfohlen, es in die BOM aufzunehmen, um eine möglichst genaue Bauteilzuweisung zu gewährleisten.

Aktuell werden die KiCad-Footprint-Spezifizierer noch nicht automatisch in das JLC-Format konvertiert, dies könnte aber zukünftig implementiert werden.

Es gibt verschiedene Möglichkeiten, neue Felder für ein Bauteil hinzuzufügen:

1. Doppelklicken Sie auf ein Bauteil, oder bewegen Sie den Mauszeiger auf das Bauteil und drücken Sie die Taste E, um den Dialog Symbol Properties (Bauteileigenschaften) zu öffnen und dort die Felder hinzuzufügen. Siehe Abbildung 8.

2. Klicken Sie in der Menüleiste auf Werkzeuge → Symbolfelder bearbeiten. Mit dieser Methode können Sie die Felder im Batch-Modus (Sammelbearbeitung) bearbeiten. Siehe Abbildung 9 und 10.

3. Mit Hilfe anderer KiCad-Plugins, z. B. KiField.

4. Weitere Methoden nach individuellem Bedarf.

Abbildung 8. JLC- und LCSC-Felder wurden für R25 hinzugefügt

Abbildung 9. Menüpunkt „Symbolfelder bearbeiten“

Abbildung 10. Tabelle der Symbolfelder

Dateien exportieren

Stückliste (BOM) erzeugen

Öffnen Sie den Schaltplan in EEschema, und wählen Sie anschließend:

Werkzeuge → Stückliste erstellen (Generate Bill of Materials).

Abbildung 11. Menüpunkt „Stückliste erstellen“

Klicken Sie auf die Schaltfläche „Generieren“, um die Stückliste zu erstellen.

Abbildung 12. Stückliste generieren

CPL (Pick-and-Place-Datei) erzeugen

Öffnen Sie das Board im PCB-Editor, und wählen Sie:

Werkzeuge → Externe Plugins → JLCSMT-Platzierungsdateien erzeugen (Generate JLCSMT Placement Files).

Abbildung 13. CPL generieren

Abbildung 14. CPL-Datei erzeugt

Alle erzeugten Dateien befinden sich im Projektordner, wie unten dargestellt.

Abbildung 15. Die erzeugten BOM- und CPL-Dateien

Diese Dateien können nun auf PCB Prototype & PCB Fabrication Manufacturer - JLCPCB zur Fertigung hochgeladen werden. Unten sehen Sie eine Vorschau eines Platinenbereichs im Bestellsystem.

Abbildung 16. Vorschau im Bestellsystem