This website requires JavaScript.
Cupões Baixar o APP
Enviar para
Centro de Ajuda
Como Gerar Arquivos de BOM e Centroid a partir do KiCad no Linux

Como Gerar Arquivos de BOM e Centroid a partir do KiCad no Linux

Última atualização em Jan 15, 2026

Este artigo mostrará como gerar arquivos BOM (Lista de Materiais) e CPL (Lista de Posicionamento de Componentes) para o serviço SMT e soldagem manual da JLCPCB no KiCad no Linux.


O método abordado neste artigo utiliza um plugin chamado KiJLC criado por Fully Automated.


O projeto de demonstração kit-dev-coldfire-xilinx_5213 é usado neste tutorial; o projeto inteiro modificado pode ser encontrado neste repositório do GitHub.


Este tutorial foi testado no KiCad 5.1.10 no Ubuntu 18.04.


Instalar o plugin


Primeiro, você precisa baixar e instalar o plugin em seu sistema. O plugin será carregado na próxima vez que o KiCad for aberto.


Instalação manual


1. Baixe o KiJLC do GitHub.



Figura 1. Download do KiJLC


2. Descompacte e renomeie a pasta


Localize o arquivo baixado e descompacte-o; altere o nome da pasta de KiJLC-main para KiJLC.


3. Copie para o local correto


Agora copie o KiJLC para a pasta conforme mostrado na captura de tela abaixo. Se a pasta/caminho de destino não existir, você pode criá-la manualmente.



Nota
Arquivos e pastas que começam com ponto (.) estão ocultos na visualização normal. No gerenciador de arquivos do Gnome, basta pressionar CTRL+H para mostrar/ocultá-los. Se CTRL+H não funcionar, pesquise no Google ou consulte o manual do gerenciador de arquivos.


Figura 2. Plugin copiado


Instalar via git clone


Se o caminho ~/.kicad/scripting/plugins não existir, execute o seguinte comando no terminal para criá-lo:


mkdir -p ~/.kicad/scripting/plugins
									


Depois, entre na pasta e clone o plugin:


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

Adicionar um plugin de BOM ao Editor de Esquemáticos


Esta é a etapa final da instalação.


Primeiro, abra o Editor de Esquemáticos. Na barra de menus, clique em Ferramentas → Gerar Lista de Materiais:



Figura 3. Item de menu Gerar BOM


Agora aparece a caixa de diálogo Lista de Materiais.



Figura 4. Item de menu Gerar BOM


Clique no botão “+” e navegue até a pasta do plugin; selecione bom2jlc.py e clique em Abrir.



Figura 5. Localizar bom2jlc.py


Deixe o apelido inalterado e clique em OK:



Figura 6. Apelido do plugin


Altere a linha de comando para:


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


Ou o caminho completo (você pode descobrir o caminho completo executando o comando which python3 no terminal):


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


Figura 7. Linha de comando do plugin

Adicionar campos JLC e LCSC


O plugin KiJLC espera que dois campos estejam presentes: “JLC”, que deve conter o especificador de footprint da JLCSMT, e “LCSC”, que deve conter o número da peça da Biblioteca de Peças SMT da JLCPCB.


O número da peça “LCSC” é usado para correspondência precisa no sistema de pedidos; é opcional, mas é melhor tê-lo na BOM.


Atualmente, os especificadores de footprint do KiCad não estão sendo convertidos para os da JLC, mas isso pode ser implementado no futuro.


Você pode adicionar novos campos para um componente de diferentes maneiras:


  1. Clique duas vezes em um componente ou apenas passe o cursor sobre ele e pressione a tecla E para abrir a caixa de diálogo Propriedades do Símbolo e adicione os campos, veja a Figura 8.
  2. Na barra de menus, clique em Ferramentas → Editar Campos do Símbolo; assim você pode editar os campos em modo de lote, veja as Figuras 9 e 10.
  3. Com a ajuda de outros plugins do KiCad, como o KiField
  4. etc.



Figura 8. Campos JLC e LCSC adicionados para R25



Figura 9. Item de menu Editar Campos dos Símbolos



Figura 10. Tabela de Campos dos Símbolos


Exportar os arquivos


Gerar BOM


Abra o esquemático no EEschema, selecione Ferramentas → Gerar Lista de Materiais.



Figura 11. Item de menu Gerar BOM


Clique no botão Gerar para produzir a BOM.



Figura 12. Gerar BOM


Gerar CPL


Abra a placa no editor de PCB, selecione Ferramentas → Plugins Externos → Gerar Arquivos de Posicionamento JLCSMT.



Figura 13. Gerar CPL



Figura 14. CPL Gerado


Todos os arquivos gerados podem ser encontrados na pasta do projeto, conforme mostrado abaixo.



Figura 15. Arquivos BOM e CPL gerados


Agora esses arquivos podem ser enviados para JLCPCB.com para fabricação. Abaixo está a prévia de um canto da placa no sistema de pedidos.



Figura 16. Prévia no sistema de pedidos




Nota
Para fazer pedidos de SMT/soldagem manual, você também precisa produzir arquivos Gerber; para saber como fazê-lo, consulte Como gerar arquivos Gerber e de furação no KiCad 5.