Get the library<\/p>\n\n\n\n
On a typical kicad install, there are also symbol- and footprint-libraries installed. On a linux system they are read-only, so we can’t edit them. On windows we can change the files, but they might not be up to date with the latest version on gitlab (where all library development takes place). So what we want to do is clone<\/strong> the official repository and work with those symbols.<\/p>\n\n\n\n We also need to setup a fork of the symbols-library on gitlab where we can publish our changes. This can be done on the gitlab webpage by pressing the ‘fork’ button in the top right on the project page (https:\/\/gitlab.com\/kicad\/libraries\/kicad-symbols\/). Next we need to add this repository as a second remote<\/strong> to our local git repository.<\/p>\n\n\n\n Setup Kicad to use the git library<\/p>\n\n\n\n Next we want that Kicad also uses the library we just cloned. Depending on the operating system you are using, or even the package, there might be differences. On my system, I had to do two things.<\/p>\n\n\n\n 1. Set the path to the library in Kicad, go to Preferences->Paths<\/p>\n\n\n\n 2. Use the sym-lib-table<\/strong> from git. It resides in the config folder<\/a>. So on my system I did the following:<\/p>\n\n\n\n 3. Verify that its working. Open Kicad, go to the symbol editor and make some change, e.g. add a text to the default capacitor symbol in the Device library. After that, type git status<\/strong> and it should look something like this.<\/p>\n\n\n\n Since that was a useless change, just as a test, undo it with git restore Device.kicad_sym<\/strong>. Now you are set up do do library work. Yay!<\/p>\n\n\n\n Adding a symbol and opening a MR<\/p>\n\n\n\n Now the setup is complete, we can do some actual work. Lets assume we want to add a new symbol for a Lattice FPGA. In this case, just head over to the library editor inside Kicad and create a new symbol. When done, head back to the command line and type git diff <\/strong>so see if there are the changes you expect:<\/p>\n\n\n\n This looks good, there is exactly one hunk (= a group of changed lines) that correspond to the symbol we created in the editor. To upstream this, we need to do a few steps:<\/p>\n\n\n\n 4. Create a merge request, just use the provided link<\/p>\n\n\n\n Make sure to fill out the merge request template to the best of you knowledge. And please don’t uncheck the “Allow commits from members who can merge to the target branch<\/strong>” checkbox. It make take some time until a librarian makes a review of you contribution, we are only volunteers and short staffed. <\/p>\n\n\n\n You can repeat this process for every contribution. Make a new branch with a descriptive name for each one. You can switch around different branches using the git branch <branchname><\/strong> command.<\/p>\n\n\n\n Once your contribution gets accepted it will get merged into the master branch. You can then safely delete your local branch with git branch -D <branchname><\/strong>.<\/p>\n\n\n\n Adding changes<\/p>\n\n\n\n In quite a few cases, the library maintainers will require you to do some changes during the review. As a first step, you need to switch back to your local branch that corresponds to the MR. Next do the changes in the Kicad symbol editor, then head back to the command line to create a commit and push it. Your merge request will automatically get updated.<\/p>\n\n\n\n For some people it is rather easy to fix bugs in symbols, or create some new footprints. But the actual contributing step requires some working knowledge of git. As always with git, there are lots of different ways to reach the same goal. I will write down my preferred way, together with some explanations on … Continue reading Contributing to the Kicad-library using gitlab and git<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":294,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[116],"tags":[159,158,156,157],"_links":{"self":[{"href":"https:\/\/ca.rstenpresser.de\/blag\/wp-json\/wp\/v2\/posts\/362"}],"collection":[{"href":"https:\/\/ca.rstenpresser.de\/blag\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ca.rstenpresser.de\/blag\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ca.rstenpresser.de\/blag\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ca.rstenpresser.de\/blag\/wp-json\/wp\/v2\/comments?post=362"}],"version-history":[{"count":4,"href":"https:\/\/ca.rstenpresser.de\/blag\/wp-json\/wp\/v2\/posts\/362\/revisions"}],"predecessor-version":[{"id":371,"href":"https:\/\/ca.rstenpresser.de\/blag\/wp-json\/wp\/v2\/posts\/362\/revisions\/371"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ca.rstenpresser.de\/blag\/wp-json\/wp\/v2\/media\/294"}],"wp:attachment":[{"href":"https:\/\/ca.rstenpresser.de\/blag\/wp-json\/wp\/v2\/media?parent=362"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ca.rstenpresser.de\/blag\/wp-json\/wp\/v2\/categories?post=362"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ca.rstenpresser.de\/blag\/wp-json\/wp\/v2\/tags?post=362"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}cd \/home\/cpresser\/Documents\/KiCad\/\ngit clone git@gitlab.com:kicad\/libraries\/kicad-symbols.git<\/code><\/pre>\n\n\n\ngit remote add cpresser git@gitlab.com:cpresser\/kicad-symbols.git<\/code><\/pre>\n\n\n\n![\"\"](\"https:\/\/ca.rstenpresser.de\/wp-files\/2022\/01\/image-1.png\")
<\/figure>\n\n\n\ncd \/home\/cpresser\/.config\/kicad\/6.0\nmv sym-lib-table sym-lib-table.old\nln -s \/home\/cpresser\/Documents\/KiCad\/kicad-symbols\/sym-lib-table .<\/code><\/pre>\n\n\n\n![\"\"](\"https:\/\/ca.rstenpresser.de\/wp-files\/2022\/01\/image-2.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/ca.rstenpresser.de\/wp-files\/2022\/01\/image-3.png\")
<\/figure>\n\n\n\ngit checkout -b Add_fake_Lattice_FPGA\ngit add -p\ngit commit\ngit push cpresser Add_fake_Lattice_FPGA<\/code><\/pre>\n\n\n\n![\"\"](\"https:\/\/ca.rstenpresser.de\/wp-files\/2022\/01\/image-4-1024x211.png\")
<\/figure>\n\n\n\ngit checkout Add_fake_Lattice_FPGA\n# <now do changes in kicad symbol editor>\ngit add -p #(stage the changes for a commit)\ngit commit #(create a commit)\ngit push #(push that commit to the remote)<\/code><\/pre>\n","protected":false},"excerpt":{"rendered":"