diff --git a/README.md b/README.md index 659797bf..418c80f3 100644 --- a/README.md +++ b/README.md @@ -3,11 +3,11 @@ SparkFun Electronics KiCad Libraries This repository contains the SparkFun KiCad Library of commonly used parts. It is a cultivated combination of KiCad stock parts, SparkFun-unique footprints, and open-source 3D models. The main branch is generally proven out but we apologize in advance if this library has errors. Please report any issues! We'll fix them quickly. -![alt text](SparkFun_GNSS_LG290P_Breakout_3D.png) +![SparkFun LG290P Breakout 3D](./img/SparkFun_GNSS_LG290P_Breakout_3D.png) **Note:** The SparkFun KiCad components contain internal part numbers (**PROD_ID-\***) for ease of manufacture for the SparkFun SMD lines. -### Theory +## Theory KiCad is very good and has a large number of industry specified symbols and footprints. SparkFun has a large number of unique parts and components created since 2002. Rather than converting all previous [SparkFun Eagle libraries](https://github.com/sparkfun/SparkFun-Eagle-Libraries) to KiCad, we are adding new parts to this library as we need them for new projects. This gives us the opportunity to clear out old badness, but opens the door to new badness (ie, incorrect footprints) so reader beware! @@ -15,7 +15,7 @@ The SparkFun approach: when a new part needs to be added we decide whether to us Additionally, SparkFun needs to assign various unique manufacturing data (ie, internal part numbers) to parts. To alleviate this, there is a large number of components with an identical symbol each with their own production ID information. For example, capacitors: -![List of SparkFun capacitors in KiCad](Capacitor-List.png) +![List of SparkFun capacitors in KiCad](./img/Capacitor-List.png) We use the following naming conventions to create our 'bubble gum' parts: @@ -24,6 +24,36 @@ We use the following naming conventions to create our 'bubble gum' parts: * [inductance]\_[size]\_[max current] * [led color]\_[size]\_[wavelength optional] +## Installing and using these libraries + +The structure of these libraries is close to, but does not conform to the [KiCad Content libraries structure](https://dev-docs.kicad.org/en/addons/#_content_libraries). For that reason, you won't currently find these libraries in the KiCad Plugin and Content Manager. + +### Download ZIP + +You can download a copy of the library by clicking on the big green `<> Code` button above and selecting the `Download ZIP` option. Unzip the file somewhere convenient, usually in `Documents`. Open the KiCad **Symbol Editor** and select `Preferences \ Configure Paths`. Add a new Environmental Variable called `SPARKFUN_KICAD_LIBRARY` and set the Path to the `SparkFun-KiCad-Libraries` folder : + +![SPARKFUN_KICAD_LIBRARY Environment Variable](./img/Environment_Variable.png) + +Then select `Preferences \ Manage Symbol Libraries`. Click the folder button to "Add existing library to table". Navigate to the `SparkFun-KiCad-Libraries \ Symbols` folder, select all the `SparkFun-.kicad_sym` symbol files and click `Open` : + +![Adding the symbols](./img/Add_Symbols.png) + +![Added symbols](./img/Added_Symbols.png) + +Then likewise in the **Footprint Editor**, select `Preferences \ Manage Footprint Libraries`. Click the folder button to "Add existing (KiCad folder)". Navigate to the `SparkFun-KiCad-Libraries \ Footprints` folder, select everything except the `3D-Models` folder (Strictly, that one is in the wrong place. Sorry about that) and click `Select Folder` : + +![Adding the footprints](./img/Add_Footprints.png) + +![Added footprints](./img/Added_Footprints.png) + +### Using Git + +If you're familiar with GitHub and Git / [GitHub Desktop](https://desktop.github.com/download/), you can stay completely up to date by cloning this repo. + +Again, add the Symbols and Footprints Paths as described in the previous section. + +If you use the "Watch All Activity" option above, you will be notified each time we Push changes in the libraries. You can then Pull the changes to stay completely up to date. (It's what we do!) + Contents ------------------- @@ -40,3 +70,5 @@ We want bragging rights that we helped (in a very small part) to create your 8th We would like the opportunity to feature your device on our homepage. Please consider contributing back to this library or others to help the open-source hardware community continue to thrive and grow! + +- Your friends at SparkFun \ No newline at end of file diff --git a/img/Add_Footprints.png b/img/Add_Footprints.png new file mode 100644 index 00000000..297a6230 Binary files /dev/null and b/img/Add_Footprints.png differ diff --git a/img/Add_Symbols.png b/img/Add_Symbols.png new file mode 100644 index 00000000..d5e402ce Binary files /dev/null and b/img/Add_Symbols.png differ diff --git a/img/Added_Footprints.png b/img/Added_Footprints.png new file mode 100644 index 00000000..352f3403 Binary files /dev/null and b/img/Added_Footprints.png differ diff --git a/img/Added_Symbols.png b/img/Added_Symbols.png new file mode 100644 index 00000000..129f7f83 Binary files /dev/null and b/img/Added_Symbols.png differ diff --git a/Capacitor-List.png b/img/Capacitor-List.png similarity index 100% rename from Capacitor-List.png rename to img/Capacitor-List.png diff --git a/img/Environment_Variable.png b/img/Environment_Variable.png new file mode 100644 index 00000000..38faaa77 Binary files /dev/null and b/img/Environment_Variable.png differ diff --git a/SparkFun_GNSS_LG290P_Breakout_3D.png b/img/SparkFun_GNSS_LG290P_Breakout_3D.png similarity index 100% rename from SparkFun_GNSS_LG290P_Breakout_3D.png rename to img/SparkFun_GNSS_LG290P_Breakout_3D.png