Adom KiCad Library

@@ -1,18 +1,79 @@ # Adom KiCad Library  KiCad footprints, schematic symbols, and 3D STEP models for Adom machine pins and-machine contacts, distributed through KiCad's Plugin and Content Manager.+machine contacts. -## Install+Machine pins are the metal pins that let a workcell mechanically grab and place a+molecule, and they double as electrical connections. Machine contacts are the+female flexures on the other side of that connection. Both come in medium and+large sizes. -Add this URL in KiCad under **Plugin and Content Manager** -> **Manage...** ->-**+**, then pick the repository from the dropdown and install from the-**Libraries** tab:+Requires **KiCad 8 or newer**. Tested on KiCad 9 and 10.++---++## Install into KiCad++### Step 1: copy this URL  ``` https://wiki.adom.inc/adom/adom-kicad-library/render/pcm/repository.json ``` +### Step 2: add it as a repository++1. Open KiCad (the main project-manager window, not the schematic or PCB editor).+2. Go to **Tools** -> **Plugin and Content Manager**.+3. Click **Manage...** in the top-right corner.+4. In the "Manage Repositories" dialog, click the **+** button.+5. Paste the URL from Step 1 and click **OK**.+6. Click **Save** to close the dialog.++### Step 3: install the library++1. Back in the Plugin and Content Manager, use the dropdown at the top-left to+   select **Adom KiCad Repository**.+2. Click the **Libraries** tab. You should see **Adom KiCad Library** listed.+3. Select it and click **Install**.+4. Click **Apply Pending Changes** at the bottom of the window.+5. Switch to the **Installed** tab to confirm it is there.++### Step 4: use the parts++The library registers itself, so there is nothing to add by hand.++- **Schematic editor**: press `A` (Add Symbol) and search for `MachinePin` or+  `MachineContact`.+- **PCB editor**: press `O` (Add Footprint) and search the same terms, or assign+  footprints from the symbol fields.++Symbols live in `adom-kicad-footprint-library`. Footprints live in the+`adom-kicad-footprint-library` footprint library. The 3D models are already+attached to each footprint, so they appear in the 3D viewer (`Alt+3`) with no+extra setup.++### Updating++KiCad checks the repository on its own. When a new version is published, the+Plugin and Content Manager shows an update for the library, and **Update All**+takes it.++---++## Installing without the repository URL++If you cannot reach the URL, or you want to pin an exact version:++1. Download the `.zip` from+   [Releases](https://wiki.adom.inc/adom/adom-kicad-library) on this page.+2. In KiCad, go to **Tools** -> **Plugin and Content Manager**.+3. Click **Install from File...** at the bottom and pick the zip.++This installs the same package. The tradeoff is that KiCad will not tell you when+a newer version exists.++---+ ## What is in it  | Footprint | Ref | Drill | Pad OD | Min pitch |@@ -24,28 +85,63 @@ https://wiki.adom.inc/adom/adom-kicad-library/render/pcm/repository.json | `MachineContactMedium` | `MC` | 0.78 mm | 1.3 mm | 2 mm | | `MachineContactLarge` | `MC` | 2.62 mm | 4.4 mm | 6 mm | -Two symbols cover all six: `MachinePin` and `MachineContact`. `Short` and-`Standard` differ only in tail length, so their pads are identical and they are-interchangeable on the board.+`Short` and `Standard` differ only in tail length. The pad geometry is identical,+so they are interchangeable on the board and differ only in the 3D model.++Two schematic symbols cover all six: `MachinePin` and `MachineContact`.++Each footprint carries a silkscreen ring just outside the pad, a courtyard sized+to the minimum pitch, and an `F.Fab` square marking the keep-clear envelope.++### Fit -Drills are line-to-line with the pin shoulder rather than press-fits. The medium-pin's shoulder is 1.2 mm in diameter, hence the 1.20 mm drill.+Medium pins use a 1.20 mm drill against a 1.2 mm pin shoulder, so the fit is+nominally line-to-line and retention comes from the solder joint rather than+interference. Large pins remain press-fit, with a 3.6 mm shoulder in a 3.45 mm+hole for 0.15 mm of diametral interference. -## What this page is+Per-part detail, including 3D insertion views, lives on the component pages:+[machinepinmediumshort](https://wiki.adom.inc/adom/machinepinmediumshort),+[machinepinmediumstandard](https://wiki.adom.inc/adom/machinepinmediumstandard),+[machinepinlargeshort](https://wiki.adom.inc/adom/machinepinlargeshort),+[machinepinlargestandard](https://wiki.adom.inc/adom/machinepinlargestandard),+[machinecontactmedium](https://wiki.adom.inc/adom/machinecontactmedium),+[machinecontactlarge](https://wiki.adom.inc/adom/machinecontactlarge). -This page is the **public distribution mirror**. It carries only the PCM feed-(`pcm/repository.json`, `pcm/packages.json`) and the release zip.+--- -Source, history, and the release tooling live in the private GitHub repository-`adom-inc/adom-kicad-library`, which is also where the geometry is edited. That-repository is private, and `raw.githubusercontent.com` will not serve a private-repository to an unauthenticated client like KiCad, which is why distribution-happens here instead.+## If it does not work -Dimensions originate further upstream still, in the tscircuit source library-`adom-inc/adom-tsci-library`. This release derives from-`@tsci/adom-inc.library` v1.2.0.+**"Unable to parse packages metadata"** means KiCad rejected the feed's schema.+Every field is validated, and one bad value fails the whole repository rather than+a single package, so no libraries appear at all. This was fixed in v1.2.1. If you+see it, you are on an older cached copy: remove the repository and re-add it. -The package identifier is `com.github.adom-inc.adom-kicad-library`, matching the-GitHub feed, so KiCad treats the two as the same package rather than as two+**The library does not appear in the Libraries tab.** Check the dropdown at the+top-left is set to "Adom KiCad Repository" and not the default KiCad repository.++**Nothing downloads.** The feed and the zip are both served from `wiki.adom.inc`+and need no login. If your network blocks it, use the install-from-file route+above.++---++## Where this comes from++Dimensions originate in the tscircuit source library+[`adom-inc/adom-tsci-library`](https://github.com/adom-inc/adom-tsci-library)+(`lib/src/globals.ts`), published as `@tsci/adom-inc.library`. The KiCad source,+release tooling, and history live in+[`adom-inc/adom-kicad-library`](https://github.com/adom-inc/adom-kicad-library).+Both repositories are private and need org access.++This page is the public distribution mirror. It carries the PCM feed+(`pcm/repository.json`, `pcm/packages.json`) and the release zip, which is why+installing works without a login.++The package identifier is `com.github.adom-inc.adom-kicad-library`. It matches the+GitHub-hosted feed, so KiCad treats the two as the same package rather than as two parallel installs.++The same parts for Fusion 360 Electronics are at+[adom/adom-machine-pins-fusion-lbr](https://wiki.adom.inc/adom/adom-machine-pins-fusion-lbr).