generate-circuit

Generate Professional KiCAD Circuit Schematic

You are generating a professional KiCAD schematic using kicad-sch-api with expert-level component placement and routing.

User's Circuit Request

Description: {{arg}}

Your task is to generate a complete, professional Python script that creates this circuit schematically.

---

⚠️ ULTRA CRITICAL: GRID ALIGNMENT (1.27mm) ⚠️

🔴 THE MOST CRITICAL RULE: ALL POSITIONS MUST BE ON 1.27mm GRID! 🔴

KiCAD uses a 1.27mm (50 mil) grid for schematic components and wires.

EVERY position MUST be a multiple of 1.27mm:

• ✅ Valid: 0, 1.27, 2.54, 3.81, 5.08, 6.35, 7.62, 8.89, 10.16, 11.43, 12.70...
• ✅ Valid: 100.33, 101.60, 102.87, 104.14, 105.41, 106.68, 107.95...
• ❌ Invalid: 100.5, 115.3, 129.540, 184.150 (OFF GRID!)

Why this matters:

• Off-grid components cause crooked wires
• Off-grid wires cause connectivity issues
• Off-grid placement looks unprofessional
• Can cause ERC (Electrical Rule Check) failures

How to ensure grid alignment:

def snap_to_grid(value, grid=1.27):
    """Snap a value to nearest grid point."""
    return round(value / grid) * grid

# Use for ALL positions
signal_y = snap_to_grid(130.0)  # Ensures exactly on grid
r1_x = snap_to_grid(180.0)
vout_x = snap_to_grid(200.0)

# Verify grid alignment
assert signal_y % 1.27 < 0.01, f"Y position {signal_y} not on 1.27mm grid!"

Pin positions and grid:

• Component centers MUST be on grid
• Pin offsets from component center may cause pins to be off-grid
• Use actual pin positions from list_component_pins() for wire endpoints (already on correct positions)
• Never manually calculate pin positions - always query them!

---

⚠️ CRITICAL: KiCAD Y-Axis Is INVERTED ⚠️

THE SECOND MOST IMPORTANT THING TO UNDERSTAND:

In KiCAD schematics, the Y-axis is INVERTED compared to normal math coordinates:

• LOWER Y values = HIGHER on screen (TOP of schematic)
• HIGHER Y values = LOWER on screen (BOTTOM of schematic)
• X-axis is normal (increases to the right)