gokul/lora-device

docs/manufacturer-models.md

# Manufacturer model status

Version 0.1.5 renames the public project to `gokul/lora-device` and replaces 20 of the 55 fitted component models with manufacturer-published geometry. **The request to use manufacturer models for every component is not yet complete.** The remaining 35 models retain their previous provenance; they have not been relabelled as manufacturer CAD.

The v0.1.5 CAD-only release preserved revision-B fabrication geometry. Version 0.1.6 now contains the revision-C manufacturing corrections documented in `validation/fabrication-report.md`; the 20 verified manufacturer model assets remain unchanged. Removing passive silkscreen changes the capacitor footprint model identifiers to the `_nosilkscreen` variants, which remain nominal library models. The source board title and package name are `lora-device`.

## Replaced models

| References | Model source |
| --- | --- |
| U1 | [Espressif ESP32-S3-WROOM-1 STEP](https://www.espressif.com/sites/default/files/3dmodel/ESP32-S3-WROOM-1_20211021.STEP), linked from its official datasheet |
| U4 | Wio-SX1262 module subassembly from [Seeed's official STEP archive](https://files.seeedstudio.com/products/SenseCAP/Wio_SX1262/Wio-SX1262_for_XIAO_3D_file.rar), linked from [Seeed's resource page](https://wiki.seeedstudio.com/xiao_esp32s3_%26_wio_SX1262_kit_for_meshtastic/). Includes the onboard IPEX connector; excludes the carrier board and external cable. |
| L1 | [Coilcraft XFL4020 STEP](https://www.coilcraft.com/getmedia/9393b6cc-0e44-4d4b-85c1-c610bb73d2d7/XFL4020.STEP), selected through Coilcraft's mechanical-model selector |
| R1–R17 | Exact MPN downloads linked from YAGEO's official specification sheets, served by its KEMET component-documentation service. All eight resistor part-number downloads were retrieved. |

Exact download URLs and SHA-256 hashes are in `validation/manufacturer-model-sources.json`. Original STEP files were tessellated with OpenCascade (`occt-import-js`) and stored as JSCAD geometry for tscircuit rendering. This is format conversion and coordinate alignment, not a replacement shape drawn from scratch. A manufacturer-supplied model may itself be simplified; its source does not guarantee production tolerances.

Transformations, in millimetres:

- ESP32: translate the model by (-9, -8.9053573, 0) to align its existing terminal rows with the unchanged footprint. Preserve the antenna geometry.
- Inductor: map STEP (x,y,z) to (x,-z,y+0.1), placing its contact plane on the board.
- Radio: extract the manufacturer's named `Wio-SX1262` subassembly, meshes 4–6, and map (x,y,z) to (-y-125.685014,x-114.4016,z-0.8515764). This removes carrier-board assembly offsets and aligns the module with the unchanged footprint. The official carrier KiCad layout provides the module orientation.
- Resistors: map (x,y,z) to (x-0.828064516129032,-z-0.45,y+0.0154), keeping the two terminations along the footprint's X axis.

## Outstanding models

| References | Parts | Current state / missing requirement |
| --- | --- | --- |
| U2, U3, U7, U8 | BQ24074RGTR, TPS63021DSJR, TPS22918DBVR, SN74LVC2G125DCUR | Existing EasyEDA/KiCad models retained. TI directs CAD downloads to Ultra Librarian; the inspected BQ24074 download requires accepting its terms and completing a CAPTCHA. Direct, ungated manufacturer STEP files were not obtained. |
| J2 | JST B3B-PH-K-S | Existing KiCad model retained. JST's Japanese CAD download requires a usage agreement and contact details; its displayed conditions restrict reproduction/disclosure to third parties. The US site was blocked by a security check. A manufacturer file with suitable public-project permission is still needed. |
| C2, C3–C6, C8–C12, C14, C16, C17 | Murata GRM188R61A105KA61D, GRM21BR61C106KE15L, GRM21BR61A226ME44L | Existing generic capacitor models retained. The official CAD route opens product search behind an agreement screen. No exact manufacturer model was downloaded. |
| C1, C7, C13, C15, C18–C21 | KEMET C0603C104K5RACTU | Existing generic model retained. The exact official specification sheet links to a manufacturer-branded CAD service that asks which model to build; an existing STEP download was not obtained. |
| U5 | u-blox SAM-M10Q-00B | Existing nominal envelope retained. No direct manufacturer CAD link found on the official product page. Third-party listings are not proof of manufacturer authorship. |
| D1–D3 | Lite-On LTST-C190KGKT, LTST-C190KFKT, LTST-C190TBKT | Existing EasyEDA models retained. No verified direct manufacturer STEP files obtained. |
| J1 | HRO TYPE-C-31-M-12 | Existing EasyEDA model retained. The [manufacturer's product page](https://en.krhro.com/Product-Details/726.html) directs 3D requests to customer service and requires consent for use/reproduction; no request was sent. |
| SW1–SW3 | XUNPU TS-1088-AR02016 | Existing EasyEDA models retained. The official part page could not be retrieved successfully; no manufacturer STEP file obtained. |

No vendor was contacted, no account was created, and no gated agreement was accepted. Complete manufacturer coverage requires the remaining exact files and, where applicable, permission to include their geometry in this public package.

## Verification

TypeScript passed. Top, bottom and side GLB renders were reviewed. The source board title is the only changed non-CAD Circuit JSON field. All electrical, schematic and PCB geometry records are identical to v0.1.4. Fifty protected routing, fabrication, placement and schematic files are byte-identical to the baseline; see `validation/manufacturer-model-audit.json`. No routing algorithm was run or layout regenerated.