# chipdocs.org — AI-Powered Interactive 2D/3D Electronic Component Platform

> chipdocs.org is an open-source, AI-powered interactive 2D/3D electronic component portal, parametric CAD engine, and automated datasheet extraction platform. It provides hardware engineers and autonomous AI coding agents with verified IEEE-315 schematic symbols (.kicad_sym), IPC-7351B PCB footprints (.kicad_mod, Fusion 360 .lbr), parametric 3D STEP AP214 / WebGL GLB models, and structured pinouts extracted from authoritative PDF datasheets.

## Overview & Architecture
chipdocs.org indexes over 2,300+ electronic components across 64+ semiconductor manufacturers (STMicroelectronics, Espressif Systems, WCH / Nanjing Qinheng, Microchip, Texas Instruments, Kiwi Instruments, etc.). Every component is processed through an automated clean-room pipeline with zero hallucinations: all physical dimensions, pin assignments, and land patterns are anchored directly to datasheet page and figure citations.

All generated CAD assets are published under the open hardware CERN-OHL-P-2.0 license and are freely accessible via web UI and machine-readable REST APIs.

## Core Capabilities for Hardware Engineers & AI Agents
- **Deterministic IPC-7351B Land Patterns**: Pad coordinates calculated with center-to-center span normalization (C/G/Z) and 60% windowed solder paste stencils (IPC-7525) for thermal pads (EPAD).
- **Parametric 3D CAD Synthesis**: Native STEP AP214 models with industry-standard material colors (Gold, Copper, Epoxy Body, Matte Tin) and WebGL GLB models with named `PIN_{pin_number}` meshes for 3D interactive inspection.
- **Universal Multi-Format EDA Export**: Download KiCad 8 (.kicad_mod, .kicad_sym), Autodesk Fusion 360 / EAGLE (.lbr), Altium Designer scripts, and STEP AP214 3D models.
- **Datasheet Pinout Intelligence**: Extracted pin tables with electrical types (Power, Ground, I/O, Analog, Open-Drain) and 6-language translations (vi, en, zh, ja, ko, de).
- **Sub-Second Verifier Studio**: Human-in-the-loop side-by-side verification studio for instant mechanical recalculation and engineering sign-off.

## Primary Navigation Links
- [Component Directory](https://chipdocs.org/parts): Search and browse all 2,300+ indexed electronic components with 2D footprints and 3D CAD.
- [Manufacturers Index](https://chipdocs.org/manufacturers): Directory of 64 semiconductor manufacturers (ST, Espressif, WCH, Microchip, TI, etc.).
- [Package Taxonomies](https://chipdocs.org/packages): Browse by package style: QFN, DFN, BGA, LQFP, SOIC, TSSOP, Castellated Modules.
- [InstaNCAD Studio](https://chipdocs.org/instancad): Interactive 2D/3D CAD viewer and geometry verification studio.
- [Asset Distribution Hub](https://chipdocs.org/assets): Direct bulk and individual asset download hub.
- [Datasheet Upload & AI Extraction](https://chipdocs.org/upload-share): Upload any PDF datasheet to trigger the automated extraction pipeline.

## Machine-Readable REST APIs for AI Agents
All APIs are public, CORS-enabled, and require no authentication for read operations:

### 1. Catalog Search & Filter
- **Endpoint**: `GET /api/v1/components`
- **Query Parameters**:
  - `q`: Search keyword or part number (e.g. `STM32`, `ESP32`, `C22356044`)
  - `mfg`: Filter by manufacturer name (e.g. `ESPRESSIF`, `ST`, `WCH`)
  - `pkg`: Filter by package type (e.g. `QFN`, `BGA`, `LQFP`, `SOIC`)
  - `limit`: Number of items per page (default: 20, max: 100)
  - `page`: Page index (1-based)
- **Response Format**: JSON containing `components` array with metadata, pin count, pad count, package style, and asset URLs.

### 2. Full Component Technical Report
- **Endpoint**: `GET /api/v1/components/{part_id}`
- **Parameters**: `part_id` can be an LCSC Part # (e.g. `C6553339`), MPN (e.g. `ESP32-S2-SOLO-2U-N4R2`), or SEO slug.
- **Response Format**: JSON containing full `DatasheetExtractionReport`:
  - `pins`: Complete array of pin numbers, names, electrical types, and multi-language descriptions.
  - `mechanical_dimensions`: Body length $D$, body width $E$, pitch $e$, overall height $A$, lead count, pin 1 marker location.
  - `recommended_land_pattern`: Synthesized pads array with $(x, y)$ coordinates, pad widths, pad heights, center spans, and EPAD thermal dimensions.
  - `electrical_summary`: Supply voltage ranges, operating temperature ranges, maximum ratings.
  - `asset_urls`: URLs to clean-room vector SVGs, 3D models, and EDA packages.

### 3. Dense LLM Markdown Summary
- **Endpoint**: `GET /api/v1/components/{part_id}/markdown` (or append `?format=markdown`)
- **Headers**: Send `Accept: text/markdown` or `Accept: text/plain`
- **Response Format**: Pure Markdown formatted specifically for LLM context windows, containing component overview, pinout table, mechanical ratings, and direct CAD download links.

### 4. CAD & Media Asset Downloads
- **Base URL**: `https://chipdocs.org/api/v1/assets/{part_id}/`
- **Available Files**:
  - `cleanroom/kicad.zip`: Complete KiCad 8 footprint (`.kicad_mod`) and schematic symbol (`.kicad_sym`).
  - `cleanroom/fusion360.lbr`: Autodesk Fusion 360 & CadSoft EAGLE XML component library.
  - `cleanroom/model.step`: Parametric ISO 10303 STEP AP214 3D CAD model.
  - `cleanroom/model.glb`: Optimized WebGL binary GLB 3D model with named pin nodes.
  - `cleanroom/footprint.svg`: IPC-7351B 2D PCB land pattern vector diagram.
  - `cleanroom/pinout.svg`: IEEE-315 schematic pinout symbol vector diagram.
  - `extracted/representative.png`: High-resolution representative IC package photo.
  - `datasheet.pdf`: Original manufacturer datasheet PDF document.

## Top Semiconductor Manufacturers in Catalog
- **STMicroelectronics (`ST`)**: 1,325+ MCUs, linear regulators, sensors, op-amps (STM32F1/F4/L4/G4, L78xx, etc.).
- **WCH (`WCH`)**: 250+ RISC-V and USB microcontrollers (CH32V003, CH340, CH552, etc.).
- **Espressif Systems (`ESPRESSIF`)**: 227+ Wi-Fi & Bluetooth SoCs & modules (ESP32-S3, ESP32-C3, ESP8266, ESP32-S2).
- **Kiwi Instruments**: 154+ AC-DC converters, LED drivers, and power management ICs.
- **Microchip Technology**: 82+ PIC microcontrollers, EEPROMs, and oscillators (ATmega, PIC16, PIC18).
- **Texas Instruments (`TI`)**: Analog multiplexers, voltage supervisors, logic gates.

## Quick cURL Examples for AI Agents

### Search for ESP32 Modules
```bash
curl -s "https://chipdocs.org/api/v1/components?q=ESP32&pkg=MODULE" | jq .
```

### Fetch Pinout & Electrical Specs in Markdown
```bash
curl -s "https://chipdocs.org/api/v1/components/C6553339/markdown"
```

### Download KiCad 8 Library Archive
```bash
curl -O -J "https://chipdocs.org/api/v1/assets/C6553339/cleanroom/kicad.zip"
```

## Extended Documentation
- [Full LLMs Specification (llms-full.txt)](https://chipdocs.org/llms-full.txt): Comprehensive technical specifications, Master Schema JSON definitions, manufacturer lists, and full API references.
- [Robots Policy](https://chipdocs.org/robots.txt): Machine crawler access rules and explicit permissions for AI agents.
- [Sitemap](https://chipdocs.org/sitemap.xml): Complete XML sitemap for all static and component routes.