如何在 Linux 中從 KiCad 生成 BOM 和中心檔
最近更新在 Jun 02, 2025
本文將介紹如何在 Linux 的 KiCad 中為 JLCPCB SMT 和手工焊接服務生成 BOM(物料清單)和 CPL(元件放置清單文檔)。
本文所轉換的方法利用了 Fully Automated 所製作的外掛程式 KiJLC。
本教程中使用了演示项目 kit-dev-coldfire-xilinx_5213,整個修改後的项目可以在這個 github储存庫中找到。
本教程已在 Ubuntu 18.04 的 KiCad 5.1.10 中進行了測試。
安裝外掛程式
首先,您需要在系統中下載並安裝外掛程式。該外掛程式將在下次打開 KiCad 時載入。
手動安裝
1. 從 github 下載 KiJLC。
圖 1.下載 KiJLC
2. 解壓縮並重新命名資料夾
找到下載的文檔並解壓,將資料夾名稱從 KiJLC-main 更改為 KiJLC。
3. 複製到正確的位置
現在,將 KiJLC 複製到該資料夾,如下截圖所示。如果目標資料夾/路徑不存在,您可以手動創建它。
注意:以點 (.) 開頭的檔案和資料夾在普通檢視中處於隱藏狀態。在 Gnome 的檔案管理員中,您只需按 CTRL+H 即可顯示/隱藏它們。如果 CTRL+H 不起作用,只需谷歌或閱讀檔管理器的手冊。
圖 2.外掛程式已複製
通過 git cloning安裝
如果路徑 ~/.kicad/scripting/plugins 不存在,請在終端中執行以下命令來創建它:
mkdir -p ~/.kicad/scripting/plugins
然後 cd 到資料夾中並克隆外掛程式:
cd ~/.kicad/scripting/plugins
git clone https://github.com/JLCPCB/KiJLC
為 Schematic Editor 添加 BOM 外掛程式
這是安裝的最後一步。
首先,打開 Schematic Layout Editor。從功能表欄中,點擊Tool → Generate Bill of Materials:
圖 3.生成 BOM 功能表
現在,將顯示 Bill of Material 框。
圖 4.Generate BOM 功能表項
點擊 "+",然後瀏覽到外掛程式資料夾,選擇 bom2jlc.py 然後點擊open 。
圖 5.流覽和查找 bom2jlc.py
保持昵稱不變,點擊OK:
圖 6.外掛程式昵稱
將命令列變更為:
python3 "/home/atommann/.kicad/scripting/plugins/KiJLC/bom2jlc.py" "%I" "%O"
或者完整路徑(可以通過在終端執行 command which python3 來知道完整路徑):
/usr/bin/python3 "/home/atommann/.kicad/scripting/plugins/KiJLC/bom2jlc.py" "%I" "%O"
圖 7.外掛程式命令行
添加 JLC 和 LCSC BOM 欄位
KiJLC 外掛程式需要兩個字段:“JLC”應包含 JLCSMT 封裝說明符,“LCSC”應包含 JLCPCB SMT 零件庫中的零件編號。
“LCSC” 零件號用於訂購系統中的精確匹配,這是可選的,但最好在 BOM 中包含它。
目前 KiCad 封裝說明符還沒有轉換為 JLC 說明符,但這可能會在未來實現。
您可以通過不同的方式為元器件添加新欄位:
1.點擊一個元器件或將游標懸停在元器件上,然後按 E 鍵調用 Symbol Properties 對話框並添加字段,參見圖 8。
2.在功能表欄上,點擊Tool → Edit Symbol Fields,這樣您就可以在批量模式下編輯欄位,參見圖 9 和 10。
3.在其他 KiCad 外掛程式的説明下,如 KiField。
4.等等
圖 8.已為 R25 添加 JLC 和 LCSC 欄位
圖 9.編輯符號欄位選項
圖 10.Symbols Fields 表
匯出檔
生成 BOM
在 EEschema 中打開原理圖,選擇 Tools → Generate Bill of Materials。
圖 11.Generate BOM 功能表項
點擊Generate 按鈕生成 BOM。
圖 12.生成 BOM
生成 CPL
在 PCB 編輯器中打開電路板,選擇 Tools →External Plugins → Generate JLCSMT Placement Files。
圖 13.生成 CPL
圖 14.生成的 CPL
所有生成的檔都可以在 project 資料夾中找到,如下所示。
圖 15.生成的 BOM 和 CPL 檔
現在,這些檔可以上傳到 JLCPCB.com 進行製造。下面是下單系統預覽的一部分。
圖 16.在訂購系統中預覽
注意:要下 SMT/手工焊接訂單,您還需要製作 Gerber 檔,具體作請參考 如何在 KiCad 5 中生成 Gerber 和 Drill文 檔 。