Skip to the content
4 layers257 × 117.5 mmTeacup carrier, the printed circuit board in 3D

Teacup carrier

thingino/teacup-neo1

Universal Ingenic SoC development platform: one carrier + per-SoC interposer modules (T10 through A1, any package) on a DDR4 card edge, with an ESP32-S3 BMC for autonomous LLM-driven development.

Size
257 × 117.5 mm
Copper layers
4
Thickness
1.6 mm
Parts
157
Nets
340
Pads
1,065
Tracks, vias
2,515, 190
Pours
4
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
6 Jul 2026
Updated
19 Oct 2026

Overview

Teacup carrier is an open-source printed circuit board by thingino, from the thingino/teacup-neo repository on GitHub, published under the GPL-3.0 licence. It is a 4-layer board of 257 × 117.5 mm with 157 parts on 340 nets, routed with 2,515 tracks and 190 vias.

It is built around the ESP32-S3-WROOM-1-N16R2, W25Q32JVSSIQ and TPS22990DMLR, with the TS5A3166DBV, AZ1117CH-1.8TRG1 and AZ1117CH-3.3TRG1 among its other parts. Its parts include 49 resistors, 28 capacitors, 28 connectors, 15 ICs and 3 inductors. It belongs with the microcontroller boards boards and the ESP32 boards of this library.

Main components

12

README

README.md

Teacup Neo

A universal development platform for any Ingenic SoC — T10, T20, T21, T23, T30, T31, T32, T33, T40, T41, and the A1 NVR processor — regardless of package (QFN88 / QFN96 / BGA232 / BGA356 / BGA381).

Two boards:

  • a carrier — the universal baseboard: adjustable SoC power, all peripherals, full pin breakout, and an on-board ESP32-S3 management controller so an agent (an LLM, CI, or a human) can drive the target wired or wireless — flash, reset, boot-select, console, and voltage-margin it hands-off;
  • a small per-SoC interposer — the SoC + its package fanout + clock + decoupling
    • straps (+ optional local power / boot NOR), presented on a DDR4 card-edge (UDIMM-288 desktop) socket.

Swap the interposer, keep the carrier — the package stops mattering.

The design

Full spec: docs/UNIVERSAL.md. It covers the connector choice, the power architecture (adjustable VCORE/VDDR with digipot voltage control + margining), the verified T10→A1 rail table, clock/flash/boot, the ESP32-S3 BMC and autonomous flash loop, full sensor/camera support (MIPI + DVP across the whole family), full A1 support (dual SATA 3.0 + dual GbE), dedicated camera-SoC peripherals (audio, PWM/IR-cut/IR-LED, JTAG), carrier test points, and the pin-breakout budget.

Building it: docs/BUILD.md is the agent-facing build playbook — the headless KiCad pipeline (footprints → symbols → label-driven schematics → pcbnew netlist apply → FreeRouting → manufacturing), the per-phase verification gates, and the gotchas already proven on the T41 board in old/.

Status: design / specification. No open or deferred design questions remain; the next step is the geography-first pin assignment against a carrier floorplan.

old/ — the T41 precursor

old/ holds the original single-SoC T41 (QFN96) board that proved the approach and the headless-KiCad pipeline (kicad-cli + pcbnew + FreeRouting). It's netlist-verified and ~83% auto-routed — details in old/README.md.

License: GPL-3.0 (inherited from the upstream Teacup).

Parts

157
QtyValueFootprintReferences
13100kResistor_SMD:R_0402_1005MetricR1, R3, R5, R15, R17, R20, R22, R44, R45, R46, R47, R48, R49
13TestPointTestPoint:TestPoint_Pad_D1.0mmTP1, TP2, TP3, TP4, TP5, TP6, TP7, TP8, TP9, TP10, TP11, TP12, TP13
9100nFCapacitor_SMD:C_0402_1005MetricC2, C3, C7, C12, C17, C22, C24, C25, C26
910kResistor_SMD:R_0402_1005MetricR2, R4, R7, R8, R9, R10, R11, R14, R24
810uFCapacitor_SMD:C_0805_2012MetricC6, C15, C16, C20, C21, C27, C28, C29
710.0kResistor_SMD:R_0402_1005MetricR28, R30, R32, R34, R36, R38, R40
522uFCapacitor_SMD:C_0805_2012MetricC1, C9, C10, C11, C18
54.7kResistor_SMD:R_0402_1005MetricR16, R25, R26, R41, R42
45.1kResistor_SMD:R_0402_1005MetricR12, R13, R18, R19
4MountingHole_PadMountingHole_2.7mm_M2.5_Pad_ViaH1, H2, H3, H4
32.2uHInductor_SMD:L_1210_3225MetricL1, L2, L3
21kResistor_SMD:R_0402_1005MetricR21, R23
21nFCapacitor_SMD:C_0402_1005MetricC13, C23
21uFCapacitor_SMD:C_0603_1608MetricC14, C19
2AO3401APackage_TO_SOT_SMD:SOT-23Q1, Q2
2AP62300WU-7teacup-carrier:TSOT-23-6_L2.9-W1.6-P0.95-LS2.8-BLU2, U7
2COMPUTERConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJP6, JP10
2EN_SELConnector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_Vertical_SMD_Pin1LeftJP11, JP12
2PMEG2010ERDiode_SMD:Nexperia_CFP3_SOD-123WD1, D2
2SFW15R-2STE1LFteacup-carrier:FPC-SMD_15P-P1.00_SFW15R-2STE1LFJ7, J8
2SSSS711403teacup-carrier:SW-TH_SSSS711403SW1, SW2
2TPS22990DMLRteacup-carrier:WSON-10_L3.0-W2.0-P0.50-BL-EP_TI_DMLU4, U14
2TS5A3166Package_TO_SOT_SMD:SOT-23-5U9, U10
2TYPE-C-31-M-12Connector_USB:USB_C_Receptacle_HRO_TYPE-C-31-M-12J2, J9
10.8VConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJP2
10.9VConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJP3
11.0VConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJP4
11.1VConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJP5
11.35VConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJP7
11.5VConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJP8
11.8VConnector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJP9
112.4kResistor_SMD:R_0402_1005MetricR39
11MResistor_SMD:R_0402_1005MetricR43
11uFCapacitor_SMD:C_0402_1005MetricC4
13.32kResistor_SMD:R_0402_1005MetricR27
131.6kResistor_SMD:R_0402_1005MetricR6
14.7nFCapacitor_SMD:C_0402_1005MetricC5
14.99kResistor_SMD:R_0402_1005MetricR29
16.65kResistor_SMD:R_0402_1005MetricR31
16.81kResistor_SMD:R_0402_1005MetricR35
18.25kResistor_SMD:R_0402_1005MetricR33
18.66kResistor_SMD:R_0402_1005MetricR37
1AH58893-T9B10-3Fteacup-carrier:DDR4288S0511H_UDIMM288J1
1AMP_MIC_TAPConnector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_VerticalJ38
1AP62600SJ-7teacup-carrier:QFN-12_L3.0-W2.0-P0.50-TL_AP62600SJ-7U1
1AZ1117CH-1.8TRG1Package_TO_SOT_SMD:SOT-223-3_TabPin2U6
1AZ1117CH-3.3TRG1Package_TO_SOT_SMD:SOT-223-3_TabPin2U5
1AudioJack4_GroundConnector_Audio:Jack_3.5mm_PJ320D_HorizontalJ6
1DIP-8 SocketPackage_DIP:DIP-8_W7.62mm_SocketU11
1ESP32-S3-WROOM-1-N16R2teacup-carrier:ESP32-S3-WROOM-1U8
1HDR_J20Connector_PinHeader_2.54mm:PinHeader_2x06_P2.54mm_VerticalJ20
1HDR_J21Connector_PinHeader_2.54mm:PinHeader_2x06_P2.54mm_VerticalJ21
1HDR_J22Connector_PinHeader_2.54mm:PinHeader_1x05_P2.54mm_VerticalJ22
1HDR_J23Connector_PinHeader_2.54mm:PinHeader_1x05_P2.54mm_VerticalJ23
1HDR_J24Connector_PinHeader_2.54mm:PinHeader_1x05_P2.54mm_VerticalJ24
1HDR_J25Connector_PinHeader_2.54mm:PinHeader_2x04_P2.54mm_VerticalJ25
1HDR_J26Connector_PinHeader_2.54mm:PinHeader_1x05_P2.54mm_VerticalJ26
1HDR_J27Connector_PinHeader_2.54mm:PinHeader_2x05_P2.54mm_VerticalJ27
1HDR_J28Connector_PinHeader_2.54mm:PinHeader_1x02_P2.54mm_VerticalJ28
1HDR_J29Connector_PinHeader_2.54mm:PinHeader_1x05_P2.54mm_VerticalJ29
1HDR_J30Connector_PinHeader_2.54mm:PinHeader_2x09_P2.54mm_VerticalJ30
1HDR_J31Connector_PinHeader_2.54mm:PinHeader_2x11_P2.54mm_VerticalJ31
1HDR_J32Connector_PinHeader_2.54mm:PinHeader_2x13_P2.54mm_VerticalJ32
1HDR_J33Connector_PinHeader_2.54mm:PinHeader_2x13_P2.54mm_VerticalJ33
1HDR_J34Connector_PinHeader_2.54mm:PinHeader_2x13_P2.54mm_VerticalJ34
1HDR_J35Connector_PinHeader_2.54mm:PinHeader_2x13_P2.54mm_VerticalJ35
1HDR_J36Connector_PinHeader_2.54mm:PinHeader_1x03_P2.54mm_VerticalJ36
1HDR_J37Connector_PinHeader_2.54mm:PinHeader_1x07_P2.54mm_VerticalJ37
1Hirose_DM3D-SFConnector_Card:microSD_HC_Hirose_DM3D-SFJ4
1MCP4661-104E_STPackage_SO:TSSOP-14_4.4x5mm_P0.65mmU3
1TCA9555PWRPackage_SO:TSSOP-24_4.4x7.8mm_P0.65mmU15
1TE_292303-7Connector_USB:USB_A_TE_292303-7_HorizontalJ3
1TPS2053BDRPackage_SO:SOIC-16_3.9x9.9mm_P1.27mmU12
1W25Q32JVSSPackage_SO:SOIC-8_5.3x5.3mm_P1.27mmU13
1Wuerth_694106301002Connector_BarrelJack:BarrelJack_Wuerth_6941xx301002J5

More from thingino/teacup-neo

3
  • 4 layers86.2 × 56.2 mmTeacup t41, the printed circuit board in 3D

    Teacup t41

    thingino/teacup-neo

    Universal Ingenic SoC development platform: one carrier + per-SoC interposer modules (T10 through A1, any package) on a DDR4 card edge, with an ESP32-S3 BMC for autonomous LLM-driven development.

    123 parts1GPL-3.0
  • 4 layers133.4 × 31.3 mmTeacup interposer t41, the printed circuit board in 3D

    Teacup interposer t41

    thingino/teacup-neo

    Universal Ingenic SoC development platform: one carrier + per-SoC interposer modules (T10 through A1, any package) on a DDR4 card edge, with an ESP32-S3 BMC for autonomous LLM-driven development.

    61 parts1GPL-3.0
  • 4 layers133.4 × 31.3 mmTeacup interposer, the printed circuit board in 3D

    Teacup interposer

    thingino/teacup-neo

    Universal Ingenic SoC development platform: one carrier + per-SoC interposer modules (T10 through A1, any package) on a DDR4 card edge, with an ESP32-S3 BMC for autonomous LLM-driven development.

    35 parts1GPL-3.0

Similar boards

  • 4 layers86.2 × 56.2 mmTeacup, the printed circuit board in 3D

    Teacup

    HackerComputerCompany/teacup

    Tea Cup TInker board project

    95 parts31GPL-2.0
  • 2 layers48.6 × 119.8 mmSkjold hovedkort, the printed circuit board in 3D

    Skjold hovedkort

    SebastianKristo/pult-forsterker

    Ett kort (180 × 100 mm, 2 lag) som erstatter alle modulene, og som i tillegg har USB-delingsswitch, to AUX-innganger som digitaliseres (så alt kan mikses), «smart relé» for strømmen til forsterkerdelen…

    119 partsMIT
  • 2 layers40 × 59.1 mmWeightingScales, the printed circuit board in 3D

    WeightingScales

    puddletowntom/Wscales

    The weight scales is a modern take on a kitchen scales with a more up to date display. It displays up to 3KG and the load can bear up to 5KG.

    60 partsUnlicense
  • 4 layers68 × 60 mmRoboCore, the printed circuit board in 3D

    RoboCore

    Plastal-Bot-Builders/RoboCoreDocumentation

    RoboCore is a classroom robot kit and coding platform, designed and built in Zambia by Plastal-Bot Builders (Lusaka).

    104 partsMIT
  • 4 layers99.5 × 69.3 mmUniversal Power Delivery and Control Board, the printed circuit board in 3D

    Universal Power Delivery and Control Board

    Oscyloskop444/RGB-LED-matrix

    Simple RGB led MATRIX with flexible size 10x10 - 20x20 based on WS2815F LEDs. It requires a power delivery adapter supporting 12v 2A minimum or direct 12v injection to the USB port to function.

    210 partsGPL-3.0
  • 4 layers115.9 × 51.1 mmXbx nrf, the printed circuit board in 3D

    Xbx nrf

    zuidec/xbx-nrf

    A replacement bottom board for the Xbox Series X|S controller (model 1914) built on a Nordic nRF52840, with a 2.4 GHz USB dongle instead of Xbox Wireless / Bluetooth

    91 parts

Questions

How big is the Teacup carrier PCB?

It measures 257 × 117.5 mm and has 4 copper layers, 1.6 mm thick.

What parts does the Teacup carrier use?

157 parts, built around the ESP32-S3-WROOM-1-N16R2, W25Q32JVSSIQ, TPS22990DMLR and TS5A3166DBV. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Teacup carrier KiCad files?

From the thingino/teacup-neo repository on GitHub, at the commit this page was made from: the board is hw/teacup-carrier.kicad_pcb and its schematic hw/.history/teacup-carrier.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Teacup carrier design in my own project?

Its repository publishes it under the GPL-3.0 licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).