← Commit history

JST playbook: series-ID table + full connector component-page pipeline (JST 3D + ds2sf sym/fp + KiCad foil + footprint-under-3D + per-system projects + Draco/GLB gotchas)

John Lauer ·78fc3fb56e ·3mo ago ·parent b98ddee
1 file changed +50
playbooks/jst.md+50
@@ -127,6 +127,56 @@ adom-chip-fetcher import <catalog>.pdf --mpn <PART> JST supplies **3D (STEP/IGES) + drawings + catalog datasheet only**. It does **NOT** supply KiCad `.kicad_sym` / `.kicad_mod`. Those come from the ladder. +## 6z. Series-ID table + full connector component-page pipeline (proven 2026-06-28)++**Series IDs** (jst-mfg.com `index.php?series=<id>`): PH **199**, XH **277**,+SH **231**, GH **105**, ZH **287**, VH **262**, SH-high-box etc. via the+alphabet search (`type=5`). Per series the 2-circuit set:++| Series | Board header | Wire housing | Crimp contact (PDF only, no STEP) | Pitch |+|---|---|---|---|---|+| PH | `B2B-PH-K-S` | `PHR-2` | `SPH-002T-P0.5S/L` (AWG 30-24) | 2.0 |+| XH | `B2B-XH-A` | `XHP-2` | `SXH-001T-P0.6N` (AWG 30-22) | 2.5 |+| SH | `SM02B-SRSS-TB` | `SHR-02V-S-B` | `SSH-003T-P0.2` (AWG 32-26) | 1.0 |+| GH | `BM02B-GHS-TBT` | `GHR-02V-S` | `SSHL-002T-P0.2` (AWG 32-28) | 1.25 |+| ZH | `B2B-ZR` | `ZHR-2` | `SZH-002T-P0.5` (AWG 32-26) | 1.5 |++**The component-page pipeline (the right way — JST 3D is always the part):**+1. **3D = JST manufacturer STEP** via the email flow (§3-4) for BOTH the board+   header and the wire housing. This is the whole point — never ship a KiCad 3D+   as the deliverable. (License: don't rehost the STEP; the viewer uses a lossy+   GLB preview + "run the skill" to fetch the real STEP.)+2. **Symbol + footprint = `ds2sf`** run on the JST datasheet+   (`adom-ds2sf extract library/<MPN> --source-tier mfr`). ds2sf **works on+   connectors** (2 pins, generic_connector_pin_function). Render its SVGs:+   `adom-ds2sf svg <dir>` (footprint) + `adom-symbol render-ds2sf --file+   <MPN>-symbol.extracted.json --out <MPN>-symbol.ds2sf.svg`.+3. **KiCad sym/fp/3D = the comparison foil only**, never the deliverable. Fetch+   the KiCad footprint/symbol (GitLab raw, §6a) + KiCad 3D (`service-kicad model+   fetch`). NOTE: KiCad has **no ZH series** (it ships ZE for 1.5 mm) — ZH is+   JST-only, footprint from ds2sf.+4. **chip-fetcher layout:** one project per mating system (`JST-<series>-system`)+   holding 3 cards — **wire housing**, **JST board** (ds2sf+KiCad sym/fp via the+   source ▾; JST "Mfr direct" 3D), and **`<MPN>-KICAD`** (KiCad-only sym/fp ++   KiCad 3D). Housings = JST 3D + PDF only (wire parts have no PCB footprint).+   Tag provenance on import: `--content-origin manufacturer --discovery-source+   jst` for JST files, `--content-origin kicad` for KiCad.+5. **Wiki component page** (`adom/<mpn-slug>`, type=component): the native 3D+   viewer's `model_3d` is a **merged comparison GLB** built with trimesh —+   KiCad model + JST model side by side, **each oriented per the user's+   chip-fetcher `chosen_up_axis` pick** (JST headers = yUp; KiCad per-part, can+   differ e.g. SH-KICAD=z), **a billboard label above each**, and **the+   footprint laid flat UNDER each model** (KiCad fp under the KiCad part, ds2sf+   fp under the JST part) so the pad layout is visible. Plus a static+   ds2sf-vs-KiCad sym/fp grid + the mating BOM table.++**GLB gotchas (critical):** step2glb emits **Draco-compressed** GLBs; the wiki+Babylon viewer **cannot fetch the Draco decoder** (CSP-blocked → "Failed to load+model"), so **decompress to plain GLB before publishing** (gltf-transform:+`mergeDocuments` + `unpartition` + dispose the `KHR_draco_mesh_compression`+extension; trimesh can't read Draco). trimesh bakes label textures **180°-rotated**+— pre-flop+flip the label PNGs. See discussion #18 on `adom/wiki` (decoder bug).+ ## 6a. Connectors: wire vs board, and the symbol/footprint source (proven 2026-06-27)  **Wire side vs board side.** A JST family has a wire-side crimp **housing**