{"id":1331,"date":"2026-02-25T16:56:21","date_gmt":"2026-02-25T15:56:21","guid":{"rendered":"https:\/\/mohoyt.com\/blog\/?p=1331"},"modified":"2026-02-25T16:59:30","modified_gmt":"2026-02-25T15:59:30","slug":"cpl-generator","status":"publish","type":"post","link":"https:\/\/mohoyt.com\/blog\/2026\/cpl-generator\/","title":{"rendered":"CPL Generator"},"content":{"rendered":"\n

I always believe in building things to scratch your own itch and solving the problems that you have right here right now. So that’s what I did with this neat tool.<\/p>\n\n\n\n

Here’s the problem:<\/h3>\n\n\n\n

I had a PCB design that I wanted to manufacture and have components be automatically placed and soldered at the factory. In order to do this you need two special files: a bill of materials (BOM) file that specifies exactly what components you want placed, and a component placement list (CPL) file that specifies exactly where each component should be and what rotation it should have.<\/p>\n\n\n\n

When you design a PCB yourself in KiCad or other software you can relatively easily generate this. However, when you’re building an open source PCB you don’t always get these files and you need to make them yourself. You can do this manually, but it’s really miserably slow as it involves you measuring each component with an on screen ruler in a gerber viewer and noting down the position carefully.<\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

Or, you could build something to do this in a much more automatic and wonderful way. Which is what I did with the fabulously named gerber-cpl<\/a>. This tool allows you to upload a gerber file and a BOM csv. Then you can go through every component in the BOM and click on the gerber image to place them in the correct location. Once you’re happy with the placement, you can export the CPL CSV and you’re good to go to manufacturing!<\/p>\n\n\n\n

Some neat features that this has:<\/h4>\n\n\n\n