Como gerar automaticamente ficheiros BOM e CPL no Eagle CAD
Última atualização em Jun 27, 2025
Neste tutorial, mostramos os passos necessários para gerar os ficheiros BOM (Bill of Materials, ou Lista de Materiais) e CPL (Component Placement List, também conhecido como ficheiro de Centroid, Pick and Place, XY, etc.) para o serviço JLCSMT no Eagle CAD.
Este tutorial foi escrito para a versão Eagle CAD 9.6.2.
O Método com ULP
O Eagle ULP (User Language Programs) pode ser utilizado para aceder às estruturas de dados do Eagle e criar uma grande variedade de ficheiros de saída.
Portanto, é possível automatizar a exportação dos ficheiros usando esse método.
Os ficheiros BOM e CPL para o serviço de montagem SMT da JLCPCB podem ser gerados facilmente utilizando o ULP "jlcpcb-eagle", desenvolvido por OXullo Intersecans e outros contribuidores.
Instalação
Primeiro, é necessário fazer o download deste ULP a partir do GitHub e instalá-lo no seu sistema.
'
Figura 1. Fazer o download do ULP
Windows
1. Extraia o ficheiro ZIP.
2. Copie o ficheiro "ulps/jlcpcb_smta_exporter.ulp" para a pasta:
"Users\o_seu_utilizador\Documents\EAGLE\ulps"
GNU/Linux
1. Extraia o ficheiro ZIP.
2. Copie o ficheiro "ulps/jlcpcb_smta_exporter.ulp" para a pasta:
"/home/o_seu_utilizador/EAGLE/ulps"
Exportar os Ficheiros
1. Abra o projeto Eagle com o qual deseja trabalhar e mude para o editor da placa (board editor).
2. Clique no botão “Executar ULP” (Run ULP).
Figura 2. Executar o ULP
Agora selecione o ficheiro "jlcpcb_smta_exporter.ulp" e clique em "OK".
Figura 3. Selecionar o ULP
Irá aparecer uma janela pop-up a solicitar que escolha a camada a processar (topo ou fundo).
Figura 4. Selecionar a Camada
Selecione a camada desejada e clique em "OK".
De seguida, o ULP pedirá para escolher uma pasta onde exportar os ficheiros BOM e Centroid. Pode criar uma nova pasta chamada, por exemplo, smt-files.
(É uma boa prática guardar os ficheiros exportados numa pasta separada, para evitar desorganizar os ficheiros do projeto.)
Figura 5. Ficheiros Exportados
Os ficheiros foram agora exportados com sucesso para a pasta especificada.
Pode abrir os ficheiros num programa de folhas de cálculo (como o LibreOffice ou Excel) para os inspecionar.
Os dois ficheiros terão os nomes:
● <nome_da_placa>_<lado>_bom.csv
● <nome_da_placa>_<lado>_cpl.csv
Figura 6. Ficheiro BOM exibido no LibreOffice
Figura 7. Ficheiro Centroid exibido no LibreOffice
Uma Última Palavra sobre Rotações
Depois de carregar os ficheiros, o visualizador online apresentará uma renderização da sua PCB, permitindo-lhe inspecionar as rotações dos componentes, entre outros detalhes.
No entanto, atualmente o sistema online não permite rodar os componentes interativamente. Eis uma solução alternativa que pode utilizar:
Se verificar que as rotações estão incorretas, pode ajustar manualmente os valores de rotação no ficheiro Centroid e voltar a carregá-lo até que a orientação esteja correta.
Nota:
Outra opção é alterar diretamente o ângulo zero do componente na biblioteca utilizada no projeto.
O Atributo LCSC_PART
O ULP consegue extrair os códigos de encomenda das peças LCSC a partir dos atributos dos pacotes (footprints).
O atributo deve chamar-se LCSC_PART e deve conter o código de encomenda tal como listado na biblioteca de componentes SMT da JLCPCB (por exemplo: C25804).