30 lines
1.3 KiB
Markdown
30 lines
1.3 KiB
Markdown
# Asymworks KiCad Library
|
|
|
|
## Usage
|
|
The recommended way to use this library is with `git subtree` into an `asymworks` folder under the current project, and reference it as a Project Library from KiCad.
|
|
|
|
```sh
|
|
git remote add -f asymworks-library https://git.asymworks.com/asymworks/kicad-library.git
|
|
git subtree add --prefix ./asymworks asymworks-library main --squash
|
|
```
|
|
|
|
Add the library to KiCad relative to the `${KIPRJMOD}` variable.
|
|
|
|
> [!NOTE]
|
|
> The Asymworks library currently has a mix of path specs for 3D models, most of which still use the legacy `${KICAD_USER_TEMPLATE_DIR}/asymworks-kicad-library` root rather than `${KIPRJMOD}/asymworks`. Manual intervention to change the path within `pcbnew` may be required for 3D models to show up correctly.
|
|
|
|
The library can be modified from the local project directory, and changes committed back to the main repository, using a similar syntax.
|
|
|
|
```sh
|
|
git add ./asymworks
|
|
git commit -m 'feat: added footprints XXXX'
|
|
git subtree push --prefix ./asymworks asymworks-library main
|
|
```
|
|
|
|
> [!WARNING]
|
|
> When using `git subtree` ensure that only changes within the subtree are added to a particular commit. Mixing files in a single commit between subtree and main project files may break things.
|
|
|
|
## Useful Links
|
|
[KiCad Library Conventions](https://klc.kicad.org)
|
|
|