From c83b850f42769c4b27c4518702f1df8dab0a5faf Mon Sep 17 00:00:00 2001
From: tungnguyentu <nguyentutung24@gmail.com>
Date: Fri, 15 May 2026 02:05:59 +0700
Subject: [PATCH] feat: add SparkFun MicroMod RP2040 Processor board
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Implements the SparkFun MicroMod RP2040 Processor in the MicroMod M.2
Key E form factor (22.86mm × 22.86mm). Includes RP2040 QFN-56 MCU,
W25Q128JV 128Mbit QSPI flash, 12MHz crystal, decoupling capacitors,
USB series resistors, MicroMod 75-pin edge connector, and BOOT button
with pull-up resistor.

Closes #175
---
 .../README.md                                 |  43 ++
 .../RP2040.tsx                                | 139 +++++++
 ...kFun-MicroMod-RP2040-Processor.circuit.tsx | 376 ++++++++++++++++++
 .../W25Q128JV.tsx                             |  30 ++
 .../index.tsx                                 |   3 +
 5 files changed, 591 insertions(+)
 create mode 100644 boards/SparkFun-MicroMod-RP2040-Processor/README.md
 create mode 100644 boards/SparkFun-MicroMod-RP2040-Processor/RP2040.tsx
 create mode 100644 boards/SparkFun-MicroMod-RP2040-Processor/SparkFun-MicroMod-RP2040-Processor.circuit.tsx
 create mode 100644 boards/SparkFun-MicroMod-RP2040-Processor/W25Q128JV.tsx
 create mode 100644 boards/SparkFun-MicroMod-RP2040-Processor/index.tsx

diff --git a/boards/SparkFun-MicroMod-RP2040-Processor/README.md b/boards/SparkFun-MicroMod-RP2040-Processor/README.md
new file mode 100644
index 00000000..9c0d9868
--- /dev/null
+++ b/boards/SparkFun-MicroMod-RP2040-Processor/README.md
@@ -0,0 +1,43 @@
+# SparkFun MicroMod RP2040 Processor
+
+SparkFun product page: https://www.sparkfun.com/sparkfun-micromod-rp2040-processor.html
+
+## Overview
+
+The SparkFun MicroMod RP2040 Processor board features the Raspberry Pi RP2040 
+dual-core ARM Cortex-M0+ microcontroller in the MicroMod M.2 Key E form factor.
+
+## Key Components
+
+| Reference | Part | Description |
+|-----------|------|-------------|
+| U1 | RP2040 | Dual-core ARM Cortex-M0+ MCU, QFN-56 |
+| U2 | W25Q128JV | 128Mbit QSPI Flash, SOIC-8 |
+| Y1 | 12 MHz Crystal | External oscillator for USB clock |
+| J1 | M.2 Key E 75-pin | MicroMod edge connector to carrier board |
+
+## MicroMod Pin Mapping (RP2040 → M.2)
+
+| M.2 Signal | RP2040 GPIO | Function |
+|-----------|-------------|---------|
+| UART_TX1 | GPIO0 | UART TX |
+| UART_RX1 | GPIO1 | UART RX |
+| I2C_SDA | GPIO4 | I2C data |
+| I2C_SCL | GPIO5 | I2C clock |
+| SPI_CIPO | GPIO16 | SPI RX |
+| SPI_CS | GPIO17 | SPI chip select |
+| SPI_SCK | GPIO18 | SPI clock |
+| SPI_COPI | GPIO19 | SPI TX |
+| A0 | GPIO26/ADC0 | Analog input 0 |
+| A1 | GPIO27/ADC1 | Analog input 1 |
+| PWM0 | GPIO21 | PWM output 0 |
+| PWM1 | GPIO22 | PWM output 1 |
+| D0 | GPIO6 | Digital I/O |
+| D1 | GPIO7 | Digital I/O |
+| G0–G5 | GPIO8–13 | General purpose I/O |
+
+## Resources
+
+- [RP2040 Datasheet](https://datasheets.raspberrypi.com/rp2040/rp2040-datasheet.pdf)
+- [MicroMod Interface Specification](https://cdn.sparkfun.com/assets/learn_tutorials/1/2/0/6/SparkFun_MicroMod_Interface_v1.0_-_Pin_Descriptions.pdf)
+- [SparkFun MicroMod Getting Started](https://learn.sparkfun.com/tutorials/getting-started-with-micromod)
diff --git a/boards/SparkFun-MicroMod-RP2040-Processor/RP2040.tsx b/boards/SparkFun-MicroMod-RP2040-Processor/RP2040.tsx
new file mode 100644
index 00000000..055ecc76
--- /dev/null
+++ b/boards/SparkFun-MicroMod-RP2040-Processor/RP2040.tsx
@@ -0,0 +1,139 @@
+import type { ChipProps } from "@tscircuit/props"
+
+const pinLabels = {
+  // GPIO and ADC (left side)
+  pin1: "IOVDD",
+  pin2: "GPIO0",
+  pin3: "GPIO1",
+  pin4: "GPIO2",
+  pin5: "GPIO3",
+  pin6: "GPIO4",
+  pin7: "GPIO5",
+  pin8: "GPIO6",
+  pin9: "GPIO7",
+  pin10: "GPIO8",
+  pin11: "GPIO9",
+  pin12: "GPIO10",
+  pin13: "GPIO11",
+  pin14: "GPIO12",
+  pin15: "GPIO13",
+  pin16: "GPIO14",
+  pin17: "GPIO15",
+  pin18: "GPIO16",
+  pin19: "GPIO17",
+  pin20: "GPIO18",
+  pin21: "GPIO19",
+  pin22: "GPIO20",
+  pin23: "GPIO21",
+  pin24: "GPIO22",
+  pin25: "GPIO23",
+  pin26: "GPIO24",
+  pin27: "GPIO25",
+  pin28: "GPIO26_ADC0",
+  pin29: "GPIO27_ADC1",
+  pin30: "GPIO28_ADC2",
+  pin31: "GPIO29_ADC3",
+  pin32: "ADC_AVDD",
+  pin33: "VREG_VIN",
+  pin34: "VREG_VOUT",
+  pin35: "USB_DM",
+  pin36: "USB_DP",
+  pin37: "USB_VDD",
+  pin38: "XIN",
+  pin39: "XOUT",
+  pin40: "SWCLK",
+  pin41: "SWD",
+  pin42: "RUN",
+  // QSPI flash interface
+  pin43: "QSPI_SD3",
+  pin44: "QSPI_SCLK",
+  pin45: "QSPI_SD0",
+  pin46: "QSPI_SD2",
+  pin47: "QSPI_SD1",
+  pin48: "QSPI_SS_N",
+  // Power
+  pin49: "DVDD",
+  pin50: "DVDD2",
+  pin51: "GND",
+  pin52: "GND2",
+  pin53: "IOVDD2",
+  pin54: "IOVDD3",
+  pin55: "IOVDD4",
+  pin56: "TESTEN",
+} as const
+
+export const RP2040 = (props: ChipProps<typeof pinLabels>) => (
+  <chip
+    manufacturerPartNumber="RP2040"
+    {...props}
+    pinLabels={pinLabels}
+    schPinArrangement={{
+      leftSide: {
+        direction: "top-to-bottom",
+        pins: [
+          "pin1",
+          "pin2",
+          "pin3",
+          "pin4",
+          "pin5",
+          "pin6",
+          "pin7",
+          "pin8",
+          "pin9",
+          "pin10",
+          "pin11",
+          "pin12",
+          "pin13",
+          "pin14",
+          "pin15",
+          "pin16",
+          "pin17",
+          "pin18",
+          "pin19",
+          "pin20",
+          "pin21",
+          "pin22",
+          "pin23",
+          "pin24",
+          "pin25",
+          "pin26",
+          "pin27",
+          "pin28",
+        ],
+      },
+      rightSide: {
+        direction: "top-to-bottom",
+        pins: [
+          "pin56",
+          "pin55",
+          "pin54",
+          "pin53",
+          "pin52",
+          "pin51",
+          "pin50",
+          "pin49",
+          "pin48",
+          "pin47",
+          "pin46",
+          "pin45",
+          "pin44",
+          "pin43",
+          "pin42",
+          "pin41",
+          "pin40",
+          "pin39",
+          "pin38",
+          "pin37",
+          "pin36",
+          "pin35",
+          "pin34",
+          "pin33",
+          "pin32",
+          "pin31",
+          "pin30",
+          "pin29",
+        ],
+      },
+    }}
+  />
+)
diff --git a/boards/SparkFun-MicroMod-RP2040-Processor/SparkFun-MicroMod-RP2040-Processor.circuit.tsx b/boards/SparkFun-MicroMod-RP2040-Processor/SparkFun-MicroMod-RP2040-Processor.circuit.tsx
new file mode 100644
index 00000000..404c2836
--- /dev/null
+++ b/boards/SparkFun-MicroMod-RP2040-Processor/SparkFun-MicroMod-RP2040-Processor.circuit.tsx
@@ -0,0 +1,376 @@
+import { sel } from "@tscircuit/core"
+import { RP2040 } from "./RP2040"
+import { W25Q128JV } from "./W25Q128JV"
+
+// RP2040 pin-number → signal name reference (QFN-56, datasheet Table 2)
+// pin2=GPIO0  pin3=GPIO1  pin28=GPIO26/ADC0  pin29=GPIO27/ADC1
+// pin35=USB_DM  pin36=USB_DP  pin38=XIN  pin39=XOUT  pin42=RUN
+// pin43=QSPI_SD3  pin44=QSPI_SCLK  pin45=QSPI_SD0
+// pin46=QSPI_SD2  pin47=QSPI_SD1   pin48=QSPI_SS_N
+
+// MicroMod M.2 Key E edge connector (75-pin, SparkFun MicroMod spec v1.0)
+const MicroModEdge = (props: any) => (
+  <chip
+    manufacturerPartNumber="MicroMod_M2_Key_E_75P"
+    footprint="edge_connector_75p_m2_key_e"
+    pinLabels={{
+      pin1: "GND",
+      pin2: "3V3",
+      pin3: "USB_VIN",
+      pin4: "3V3_EN",
+      pin5: "GND",
+      pin6: "RESET",
+      pin7: "GND",
+      pin8: "BOOT",
+      pin9: "GND",
+      pin10: "USB_DM",
+      pin11: "GND",
+      pin12: "USB_DP",
+      pin13: "GND",
+      pin14: "NC",
+      pin15: "GND",
+      pin16: "UART_TX1",
+      pin17: "GND",
+      pin18: "UART_RX1",
+      pin19: "GND",
+      pin20: "UART_RTS1",
+      pin21: "GND",
+      pin22: "UART_CTS1",
+      pin23: "GND",
+      pin24: "I2C_SDA",
+      pin25: "GND",
+      pin26: "I2C_SCL",
+      pin27: "GND",
+      pin28: "I2C_INT",
+      pin29: "GND",
+      pin30: "I2C1_SDA",
+      pin31: "GND",
+      pin32: "I2C1_SCL",
+      pin33: "GND",
+      pin34: "SPI_CS",
+      pin35: "GND",
+      pin36: "SPI_SCK",
+      pin37: "GND",
+      pin38: "SPI_COPI",
+      pin39: "GND",
+      pin40: "SPI_CIPO",
+      pin41: "GND",
+      pin42: "SPI1_CS",
+      pin43: "GND",
+      pin44: "SPI1_SCK",
+      pin45: "GND",
+      pin46: "SPI1_COPI",
+      pin47: "GND",
+      pin48: "SPI1_CIPO",
+      pin49: "GND",
+      pin50: "A0",
+      pin51: "GND",
+      pin52: "A1",
+      pin53: "GND",
+      pin54: "BATT_VIN3",
+      pin55: "GND",
+      pin56: "PWM0",
+      pin57: "GND",
+      pin58: "PWM1",
+      pin59: "GND",
+      pin60: "D0",
+      pin61: "GND",
+      pin62: "D1",
+      pin63: "GND",
+      pin64: "G0",
+      pin65: "GND",
+      pin66: "G1",
+      pin67: "GND",
+      pin68: "G2",
+      pin69: "GND",
+      pin70: "G3",
+      pin71: "GND",
+      pin72: "G4",
+      pin73: "GND",
+      pin74: "G5",
+      pin75: "GND",
+    }}
+    schPinArrangement={{
+      rightSide: {
+        direction: "top-to-bottom",
+        pins: [
+          "pin2",
+          "pin3",
+          "pin4",
+          "pin6",
+          "pin8",
+          "pin10",
+          "pin12",
+          "pin16",
+          "pin18",
+          "pin20",
+          "pin22",
+          "pin24",
+          "pin26",
+          "pin28",
+          "pin30",
+          "pin32",
+          "pin34",
+          "pin36",
+          "pin38",
+          "pin40",
+          "pin42",
+          "pin44",
+          "pin46",
+          "pin48",
+          "pin50",
+          "pin52",
+          "pin54",
+          "pin56",
+          "pin58",
+          "pin60",
+          "pin62",
+          "pin64",
+          "pin66",
+          "pin68",
+          "pin70",
+          "pin72",
+          "pin74",
+        ],
+      },
+    }}
+    {...props}
+  />
+)
+
+const SparkFunMicroModRP2040Processor = () => (
+  <board width="22.86mm" height="22.86mm">
+    {/* RP2040 dual-core ARM Cortex-M0+ MCU */}
+    <RP2040
+      name="U1"
+      footprint="qfn56_7x7mm_p0.4mm"
+      pcbX={0}
+      pcbY={2}
+      schX={0}
+      schY={0}
+    />
+
+    {/* 128Mbit QSPI flash — connected via pins 43-48 (QSPI interface) */}
+    <W25Q128JV
+      name="U2"
+      footprint="soic8_3.9x4.9mm_p1.27mm"
+      pcbX={6}
+      pcbY={2}
+      schX={14}
+      schY={0}
+      connections={{
+        pin1: sel.U1.pin48, // QSPI_SS_N
+        pin2: sel.U1.pin47, // QSPI_SD1
+        pin3: "net.3V3",
+        pin4: "net.GND",
+        pin5: sel.U1.pin45, // QSPI_SD0
+        pin6: sel.U1.pin44, // QSPI_SCLK
+        pin7: sel.U1.pin43, // QSPI_SD3
+        pin8: "net.3V3",
+      }}
+    />
+
+    {/* 12 MHz crystal for USB PLL reference */}
+    <chip
+      name="Y1"
+      manufacturerPartNumber="12MHz_Crystal"
+      footprint="crystal_3.2x2.5mm_p1.2mm"
+      pinLabels={{ pin1: "IN", pin2: "GND_L", pin3: "OUT", pin4: "GND_R" }}
+      schPinArrangement={{
+        leftSide: { direction: "top-to-bottom", pins: ["pin1", "pin2"] },
+        rightSide: { direction: "top-to-bottom", pins: ["pin3", "pin4"] },
+      }}
+      schX={-10}
+      schY={6}
+      pcbX={-5}
+      pcbY={7}
+      connections={{
+        pin1: sel.U1.pin38, // XIN
+        pin3: sel.U1.pin39, // XOUT
+        pin2: "net.GND",
+        pin4: "net.GND",
+      }}
+    />
+
+    {/* Crystal load capacitors (15 pF) */}
+    <capacitor
+      name="C1"
+      capacitance="15pF"
+      footprint="0402"
+      schX={-13}
+      schY={4}
+      pcbX={-7}
+      pcbY={5.5}
+      connections={{ pin1: sel.U1.pin38, pin2: "net.GND" }}
+    />
+    <capacitor
+      name="C2"
+      capacitance="15pF"
+      footprint="0402"
+      schX={-13}
+      schY={8}
+      pcbX={-7}
+      pcbY={8.5}
+      connections={{ pin1: sel.U1.pin39, pin2: "net.GND" }}
+    />
+
+    {/* VREG output decoupling (pin34 = VREG_VOUT) */}
+    <capacitor
+      name="C3"
+      capacitance="100nF"
+      footprint="0402"
+      schX={4}
+      schY={10}
+      pcbX={2}
+      pcbY={-5}
+      connections={{ pin1: sel.U1.pin34, pin2: "net.GND" }}
+    />
+    <capacitor
+      name="C4"
+      capacitance="1uF"
+      footprint="0402"
+      schX={6}
+      schY={10}
+      pcbX={3}
+      pcbY={-5}
+      connections={{ pin1: sel.U1.pin34, pin2: "net.GND" }}
+    />
+
+    {/* IOVDD / 3V3 bulk decoupling */}
+    <capacitor
+      name="C5"
+      capacitance="100nF"
+      footprint="0402"
+      schX={8}
+      schY={10}
+      pcbX={-2}
+      pcbY={-5}
+      connections={{ pin1: "net.3V3", pin2: "net.GND" }}
+    />
+    <capacitor
+      name="C6"
+      capacitance="100nF"
+      footprint="0402"
+      schX={10}
+      schY={10}
+      pcbX={-3}
+      pcbY={-5}
+      connections={{ pin1: "net.3V3", pin2: "net.GND" }}
+    />
+    <capacitor
+      name="C7"
+      capacitance="1uF"
+      footprint="0402"
+      schX={12}
+      schY={10}
+      pcbX={-4}
+      pcbY={-5}
+      connections={{ pin1: "net.3V3", pin2: "net.GND" }}
+    />
+
+    {/* ADC supply decoupling (pin32 = ADC_AVDD) */}
+    <capacitor
+      name="C8"
+      capacitance="100nF"
+      footprint="0402"
+      schX={4}
+      schY={12}
+      pcbX={4}
+      pcbY={-6}
+      connections={{ pin1: sel.U1.pin32, pin2: "net.GND" }}
+    />
+
+    {/* USB series resistors for signal integrity (27 Ω) */}
+    <resistor
+      name="R1"
+      resistance="27"
+      footprint="0402"
+      schX={-6}
+      schY={-8}
+      pcbX={-3}
+      pcbY={-8}
+      connections={{ pin1: sel.U1.pin35, pin2: "net.USB_DM_EXT" }}
+    />
+    <resistor
+      name="R2"
+      resistance="27"
+      footprint="0402"
+      schX={-6}
+      schY={-10}
+      pcbX={-3}
+      pcbY={-9}
+      connections={{ pin1: sel.U1.pin36, pin2: "net.USB_DP_EXT" }}
+    />
+
+    {/* MicroMod M.2 Key E edge connector */}
+    <MicroModEdge
+      name="J1"
+      schX={28}
+      schY={0}
+      pcbX={10}
+      pcbY={0}
+      connections={{
+        pin2: "net.3V3",
+        pin6: sel.U1.pin42, // RUN / nRESET
+        pin8: "net.BOOT",
+        pin10: "net.USB_DM_EXT",
+        pin12: "net.USB_DP_EXT",
+        pin16: sel.U1.pin2, // GPIO0 → UART_TX1
+        pin18: sel.U1.pin3, // GPIO1 → UART_RX1
+        pin24: sel.U1.pin6, // GPIO4 → I2C_SDA
+        pin26: sel.U1.pin7, // GPIO5 → I2C_SCL
+        pin34: sel.U1.pin21, // GPIO17 → SPI_CS
+        pin36: sel.U1.pin22, // GPIO18 → SPI_SCK
+        pin38: sel.U1.pin23, // GPIO19 → SPI_COPI
+        pin40: sel.U1.pin20, // GPIO16 → SPI_CIPO
+        pin50: sel.U1.pin28, // GPIO26/ADC0 → A0
+        pin52: sel.U1.pin29, // GPIO27/ADC1 → A1
+        pin56: sel.U1.pin25, // GPIO21 → PWM0
+        pin58: sel.U1.pin26, // GPIO22 → PWM1
+        pin60: sel.U1.pin8, // GPIO6 → D0
+        pin62: sel.U1.pin9, // GPIO7 → D1
+        pin64: sel.U1.pin10, // GPIO8 → G0
+        pin66: sel.U1.pin11, // GPIO9 → G1
+        pin68: sel.U1.pin12, // GPIO10 → G2
+        pin70: sel.U1.pin13, // GPIO11 → G3
+        pin72: sel.U1.pin14, // GPIO12 → G4
+        pin74: sel.U1.pin15, // GPIO13 → G5
+      }}
+    />
+
+    {/* BOOT button — pulls BOOT net low to force USB bootloader */}
+    <pushbutton
+      name="SW1"
+      footprint="pushbutton_smd_4mm"
+      schX={-8}
+      schY={-14}
+      pcbX={-8}
+      pcbY={-2}
+      connections={{ pin1: "net.BOOT", pin2: "net.GND" }}
+    />
+
+    {/* 10 kΩ pull-up keeps BOOT high during normal operation */}
+    <resistor
+      name="R3"
+      resistance="10k"
+      footprint="0402"
+      schX={-4}
+      schY={-14}
+      pcbX={-6}
+      pcbY={-2}
+      connections={{ pin1: "net.3V3", pin2: "net.BOOT" }}
+    />
+
+    {/* Power net labels */}
+    <netlabel net="3V3" anchorSide="bottom" connection="U1.pin1" />
+    <netlabel net="3V3" anchorSide="bottom" connection="U1.pin53" />
+    <netlabel net="3V3" anchorSide="bottom" connection="U1.pin54" />
+    <netlabel net="3V3" anchorSide="bottom" connection="U1.pin55" />
+    <netlabel net="3V3" anchorSide="bottom" connection="U1.pin37" />
+    <netlabel net="3V3" anchorSide="bottom" connection="U1.pin33" />
+    <netlabel net="GND" anchorSide="top" connection="U1.pin51" />
+    <netlabel net="GND" anchorSide="top" connection="U1.pin52" />
+  </board>
+)
+
+export default SparkFunMicroModRP2040Processor
diff --git a/boards/SparkFun-MicroMod-RP2040-Processor/W25Q128JV.tsx b/boards/SparkFun-MicroMod-RP2040-Processor/W25Q128JV.tsx
new file mode 100644
index 00000000..70bfefad
--- /dev/null
+++ b/boards/SparkFun-MicroMod-RP2040-Processor/W25Q128JV.tsx
@@ -0,0 +1,30 @@
+import type { ChipProps } from "@tscircuit/props"
+
+const pinLabels = {
+  pin1: "CS",
+  pin2: "DO",
+  pin3: "WP",
+  pin4: "GND",
+  pin5: "DI",
+  pin6: "CLK",
+  pin7: "HOLD",
+  pin8: "VCC",
+} as const
+
+export const W25Q128JV = (props: ChipProps<typeof pinLabels>) => (
+  <chip
+    manufacturerPartNumber="W25Q128JV"
+    {...props}
+    pinLabels={pinLabels}
+    schPinArrangement={{
+      leftSide: {
+        direction: "top-to-bottom",
+        pins: ["pin1", "pin2", "pin3", "pin4"],
+      },
+      rightSide: {
+        direction: "top-to-bottom",
+        pins: ["pin8", "pin7", "pin6", "pin5"],
+      },
+    }}
+  />
+)
diff --git a/boards/SparkFun-MicroMod-RP2040-Processor/index.tsx b/boards/SparkFun-MicroMod-RP2040-Processor/index.tsx
new file mode 100644
index 00000000..3ebb6f02
--- /dev/null
+++ b/boards/SparkFun-MicroMod-RP2040-Processor/index.tsx
@@ -0,0 +1,3 @@
+import SparkFunMicroModRP2040Processor from "./SparkFun-MicroMod-RP2040-Processor.circuit"
+
+export default SparkFunMicroModRP2040Processor