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:
- 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.
- 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.
- Com a ajuda de outros plugins do KiCad, como o KiField
- 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. |
