main
Ray Publish 0.1.0 c7bf037
{
  "slug": "gd32f310k8u6",
  "version": "0.1.0",
  "type": "component",
  "description": "GigaDevice Semicon Beijing Microcontroller Units (MCUs/MPUs/SOCs), QFN-32-EP(5x5). Pinout cross-checked by two models against the datasheet, KiCad symbol/footprint/3D.",
  "tags": [
    "component",
    "single chip microcomputer-microcontroller",
    "gd32f310k8u6",
    "factory-2.0.0",
    "extractor-text"
  ],
  "dependencies": {},
  "hero": {
    "type": "image",
    "path": "docs/hero.png"
  },
  "files": [
    "page.json",
    "README.md",
    "gd32f310k8u6.kicad_sym",
    "gd32f310k8u6.kicad_mod",
    "gd32f310k8u6.glb",
    "gd32f310k8u6.step",
    "gd32f310k8u6.lbr",
    "docs/hero.png",
    "docs/gd32f310k8u6-datasheet.pdf",
    "viewers/symbol.html",
    "viewers/footprint.html",
    "gd32f310k8u6-hero.glb",
    "gd32f310k8u6-hero.overlay.json"
  ],
  "component": {
    "mpn": "GD32F310K8U6",
    "manufacturer": "GigaDevice Semicon Beijing",
    "package": "QFN-32-EP(5x5)",
    "pin_count": 33,
    "category": "Single Chip Microcomputer/Microcontroller",
    "subcategory": "Microcontroller Units (MCUs/MPUs/SOCs)",
    "datasheet": "https://datasheet.lcsc.com/datasheet/pdf/ddb759a3aeb6fcba8a4212a51aebcab4.pdf",
    "parts": {
      "symbol": "gd32f310k8u6.kicad_sym",
      "footprint": "gd32f310k8u6.kicad_mod",
      "model_3d": "gd32f310k8u6-hero.glb",
      "model_3d_plain": "gd32f310k8u6.glb",
      "model_3d_step": "gd32f310k8u6-etched.step",
      "model_3d_step_plain": "gd32f310k8u6.step",
      "lbr": "gd32f310k8u6.lbr"
    },
    "distributor_links": {
      "lcsc": "C5110325"
    },
    "distributor_check": {
      "checked_at": "2026-11-12T19:26:52Z",
      "source": "Component Ocean /api/assign-pns",
      "digikey": {
        "pn": null,
        "status": "no match"
      },
      "mouser": {
        "pn": null,
        "status": "no match"
      }
    },
    "pins": [
      {
        "number": "1",
        "name": "VDD",
        "type": "power_in",
        "description": "Default function VDD, the digital power supply pin."
      },
      {
        "number": "2",
        "name": "PF0-OSCIN",
        "type": "bidirectional",
        "description": "5 V tolerant (5VT) I/O port PF0 with alternate function CTC_SYNC and additional function OSCIN."
      },
      {
        "number": "3",
        "name": "PF1-OSCOUT",
        "type": "bidirectional",
        "description": "5 V tolerant (5VT) I/O port PF1 with additional function OSCOUT."
      },
      {
        "number": "4",
        "name": "NRST",
        "type": "bidirectional",
        "description": "Default function NRST, the reset pin."
      },
      {
        "number": "5",
        "name": "VDDA",
        "type": "power_in",
        "description": "Default function VDDA, the analog power supply pin."
      },
      {
        "number": "6",
        "name": "PA0-WKUP",
        "type": "bidirectional",
        "description": "I/O port PA0 with alternate functions USART1_CTS and I2C1_SCL and additional functions ADC_IN0, RTC_TAMP1 and WKUP0."
      },
      {
        "number": "7",
        "name": "PA1",
        "type": "bidirectional",
        "description": "I/O port PA1 with alternate functions USART1_RTS, I2C1_SDA and EVENTOUT and additional function ADC_IN1."
      },
      {
        "number": "8",
        "name": "PA2",
        "type": "bidirectional",
        "description": "I/O port PA2 with alternate functions USART1_TX and TIMER14_CH0 and additional function ADC_IN2."
      },
      {
        "number": "9",
        "name": "PA3",
        "type": "bidirectional",
        "description": "I/O port PA3 with alternate functions USART1_RX and TIMER14_CH1 and additional function ADC_IN3."
      },
      {
        "number": "10",
        "name": "PA4",
        "type": "bidirectional",
        "description": "I/O port PA4 with alternate functions SPI0_NSS, I2S0_WS, USART1_CK, TIMER13_CH0 and SPI1_NSS and additional function ADC_IN4."
      },
      {
        "number": "11",
        "name": "PA5",
        "type": "bidirectional",
        "description": "I/O port PA5 with alternate functions SPI0_SCK and I2S0_CK and additional function ADC_IN5."
      },
      {
        "number": "12",
        "name": "PA6",
        "type": "bidirectional",
        "description": "I/O port PA6 with alternate functions SPI0_MISO, I2S0_MCK, TIMER2_CH0, TIMER0_BKIN, TIMER15_CH0 and EVENTOUT and additional function ADC_IN6."
      },
      {
        "number": "13",
        "name": "PA7",
        "type": "bidirectional",
        "description": "I/O port PA7 with alternate functions SPI0_MOSI, I2S0_SD, TIMER2_CH1, TIMER13_CH0, TIMER0_CH0_ON, TIMER16_CH0 and EVENTOUT and additional function ADC_IN7."
      },
      {
        "number": "14",
        "name": "PB0",
        "type": "bidirectional",
        "description": "I/O port PB0 with alternate functions TIMER2_CH2, TIMER0_CH1_ON, USART1_RX and EVENTOUT and additional function ADC_IN8."
      },
      {
        "number": "15",
        "name": "PB1",
        "type": "bidirectional",
        "description": "I/O port PB1 with alternate functions TIMER2_CH3, TIMER13_CH0, TIMER0_CH2_ON and SPI1_SCK and additional function ADC_IN9."
      },
      {
        "number": "16",
        "name": "PB2",
        "type": "bidirectional",
        "description": "5 V tolerant (5VT) I/O port PB2 with default function PB2."
      },
      {
        "number": "17",
        "name": "VDD",
        "type": "power_in",
        "description": "Default function VDD, the digital power supply pin."
      },
      {
        "number": "18",
        "name": "PA8",
        "type": "bidirectional",
        "description": "5 V tolerant (5VT) I/O port PA8 with alternate functions USART0_CK, TIMER0_CH0, CK_OUT, USART1_TX, EVENTOUT and CTC_SYNC."
      },
      {
        "number": "19",
        "name": "PA9",
        "type": "bidirectional",
        "description": "5 V tolerant (5VT) I/O port PA9 with alternate functions USART0_TX, TIMER0_CH1, TIMER14_BRKIN and I2C0_SCL."
      },
      {
        "number": "20",
        "name": "PA10",
        "type": "bidirectional",
        "description": "5 V tolerant (5VT) I/O port PA10 with alternate functions USART0_RX, TIMER0_CH2, TIMER16_BRKIN and I2C0_SDA."
      },
      {
        "number": "21",
        "name": "PA11",
        "type": "bidirectional",
        "description": "5 V tolerant (5VT) I/O port PA11 with alternate functions USART0_CTS, TIMER0_CH3, EVENTOUT and SPI1_IO2."
      },
      {
        "number": "22",
        "name": "PA12",
        "type": "bidirectional",
        "description": "5 V tolerant (5VT) I/O port PA12 with alternate functions USART0_RTS, TIMER0_ETI, EVENTOUT and SPI1_IO3."
      },
      {
        "number": "23",
        "name": "PA13",
        "type": "bidirectional",
        "description": "5 V tolerant (5VT) I/O port PA13 with alternate functions SWDIO, IFRP_OUT and SPI1_MISO."
      },
      {
        "number": "24",
        "name": "PA14",
        "type": "bidirectional",
        "description": "5 V tolerant (5VT) I/O port PA14 with alternate functions USART1_TX, SWCLK and SPI1_MOSI."
      },
      {
        "number": "25",
        "name": "PA15",
        "type": "bidirectional",
        "description": "5 V tolerant (5VT) I/O port PA15 with alternate functions SPI0_NSS, I2S0_WS, USART1_RX, SPI1_NSS and EVENTOUT."
      },
      {
        "number": "26",
        "name": "PB3",
        "type": "bidirectional",
        "description": "5 V tolerant (5VT) I/O port PB3 with alternate functions SPI0_SCK, I2S0_CK and EVENTOUT."
      },
      {
        "number": "27",
        "name": "PB4",
        "type": "bidirectional",
        "description": "5 V tolerant (5VT) I/O port PB4 with alternate functions SPI0_MISO, I2S0_MCK, TIMER2_CH0 and EVENTOUT."
      },
      {
        "number": "28",
        "name": "PB5",
        "type": "bidirectional",
        "description": "5 V tolerant (5VT) I/O port PB5 with alternate functions SPI0_MOSI, I2S0_SD, I2C0_SMBA, TIMER15_BRKIN and TIMER2_CH1 and additional function WKUP5."
      },
      {
        "number": "29",
        "name": "PB6",
        "type": "bidirectional",
        "description": "5 V tolerant (5VT) I/O port PB6 with alternate functions I2C0_SCL, USART0_TX and TIMER15_CH0_ON."
      },
      {
        "number": "30",
        "name": "PB7",
        "type": "bidirectional",
        "description": "5 V tolerant (5VT) I/O port PB7 with alternate functions I2C0_SDA, USART0_RX and TIMER16_CH0_ON."
      },
      {
        "number": "31",
        "name": "BOOT0",
        "type": "input",
        "description": "Input pin with default function BOOT0, used for boot mode selection."
      },
      {
        "number": "32",
        "name": "PB8",
        "type": "bidirectional",
        "description": "5 V tolerant (5VT) I/O port PB8 with alternate functions I2C0_SCL and TIMER15_CH0."
      },
      {
        "number": "33",
        "name": "VSS, VSSA",
        "type": "power_in",
        "description": "Exposed pad (from the footprint; not named in the datasheet pin table)."
      }
    ],
    "provenance": {
      "extractor": "extract_pins 0.3",
      "factory_chain": {
        "factory": "2.0.0",
        "extractor": "extract_pins 0.3",
        "primary_model": "claude-haiku-5-5",
        "primary_mode": "text",
        "consensus_model": "claude-sonnet-5-5",
        "consensus": "agreed",
        "guards": "pin_guards 0.1: passed",
        "guard_notes": [
          "extractor flagged: Table 2-5 is titled 'GD32F310KxU6 QFP32 pin definitions' while the section is QFN32; the package is ; The QFN32 pin table lists no VSS or VSSA pin numbers. Figure 2-4 labels 'VSS, VSSA' but assigns them; The QFN32 has an exposed thermal pad (shown in the package outline on page 60) that is not numbered "
        ],
        "pages_sent": 39,
        "cost_usd": 0.0089,
        "at": "2026-11-12T19:26:38"
      },
      "datasheet": {
        "url": "https://datasheet.lcsc.com/datasheet/pdf/ddb759a3aeb6fcba8a4212a51aebcab4.pdf",
        "pages": 78,
        "sha256": "069c0d8e96165c7c",
        "source_tier": "lcsc"
      },
      "cad": "KiCad official (CC-BY-SA 4.0)",
      "model_3d_generated": {
        "generator": "factory/gen_pkg3d.py",
        "family": "QFN",
        "height_mm": 0.75,
        "height_basis": "datasheet A, nominal",
        "standoff_mm": 0.0
      },
      "pins": {
        "total": 33,
        "described": 33,
        "cites_pages": true,
        "refuses_to_fabricate": true
      }
    },
    "viewers": {
      "symbol": "viewers/symbol.html",
      "footprint": "viewers/footprint.html"
    },
    "models_3d": [
      {
        "file": "gd32f310k8u6.step",
        "role": "plain",
        "up": "Z",
        "units": "mm",
        "origin": "footprint origin = pad-pattern centre",
        "seat": "z = 0",
        "extents_mm": [
          5.02,
          5.02,
          0.75
        ],
        "zmin_mm": 0.0,
        "centre_offset_mm": 0.0,
        "footprint_binding": "identity",
        "sha256": "9bc2dcf2fae5cae10e64dd52eaa350d0755631128c8780bfc202671403205310",
        "checked": "2026-11-12",
        "checked_by": "factory/step_pose.py (Z-up, origin, seat, binding)"
      },
      {
        "file": "gd32f310k8u6-etched.step",
        "role": "eda",
        "up": "Z",
        "units": "mm",
        "origin": "footprint origin = pad-pattern centre",
        "seat": "z = 0",
        "extents_mm": [
          5.02,
          5.02,
          0.75
        ],
        "zmin_mm": 0.0,
        "centre_offset_mm": 0.0,
        "footprint_binding": "identity",
        "sha256": "d51f5ccc4684769512a5fdf57c88f188105379f6cf2ae76209ff6d2751131bfb",
        "checked": "2026-11-12",
        "checked_by": "factory/step_pose.py (Z-up, origin, seat, binding)"
      }
    ],
    "package_dims": {
      "package_code": "QFN32",
      "source_page": 68,
      "D": {
        "nom_mm": 5.0,
        "range_mm": [
          4.9,
          5.1
        ]
      },
      "E1": {
        "nom_mm": 5.0,
        "range_mm": [
          4.9,
          5.1
        ]
      },
      "e": {
        "nom_mm": 0.5,
        "range_mm": [
          null,
          null
        ]
      },
      "A": {
        "nom_mm": 0.75,
        "range_mm": [
          0.7,
          0.8
        ]
      },
      "source": "datasheet package drawing, every number found on its page (extract_pins --task dims)",
      "model_check": {
        "file": "gd32f310k8u6.step",
        "verdict": "PASS",
        "reasons": [
          "height within the datasheet's package drawing"
        ],
        "by": "factory/package_fit.py"
      }
    }
  }
}