{
  "metadata": {
    "id": "adafruit-eyespi-breakout",
    "name": "Adafruit EYESPI Breakout Board",
    "type": "connector",
    "description": "Passive 18-pin EYESPI FPC breakout that brings the full Adafruit EYESPI display connector to 0.1 inch breadboard-friendly headers for TFT and eInk display prototyping.",
    "manufacturer": "Adafruit",
    "part_number": "5613",
    "datasheet_url": "https://cdn-learn.adafruit.com/downloads/pdf/adafruit-eyespi-breakout-board.pdf",
    "tags": [
      "eyespi",
      "display",
      "breakout",
      "fpc",
      "18-pin",
      "0.5mm",
      "spi",
      "i2c",
      "breadboard",
      "tft",
      "eink"
    ],
    "schema_version": "1.4.0",
    "version": "1.0",
    "taxonomy": [
      "expansion.breakout",
      "connector.signal_connector"
    ]
  },
  "domains": [
    {
      "domain": "electrical",
      "resources": [
        {
          "id": "vin",
          "name": "VIN",
          "description": "Power input/output rail passed through the EYESPI connector.",
          "functions": [
            {
              "name": "power_in",
              "direction": "bidirectional",
              "signal_class": "power"
            }
          ],
          "connector_type": "pin_header"
        },
        {
          "id": "gnd",
          "name": "GND",
          "description": "Ground reference passed through the EYESPI connector.",
          "functions": [
            {
              "name": "ground",
              "direction": "bidirectional",
              "signal_class": "ground"
            }
          ],
          "connector_type": "pin_header"
        },
        {
          "id": "scl",
          "name": "SCL",
          "description": "I2C clock for touch or auxiliary peripherals on compatible displays.",
          "functions": [
            {
              "name": "i2c_scl",
              "direction": "bidirectional",
              "signal_class": "clock"
            }
          ],
          "connector_type": "pin_header"
        },
        {
          "id": "sda",
          "name": "SDA",
          "description": "I2C data for touch or auxiliary peripherals on compatible displays.",
          "functions": [
            {
              "name": "i2c_sda",
              "direction": "bidirectional",
              "signal_class": "data"
            }
          ],
          "connector_type": "pin_header"
        },
        {
          "id": "sck",
          "name": "SCK",
          "description": "SPI clock line for the attached display stack.",
          "functions": [
            {
              "name": "spi_sck",
              "direction": "bidirectional",
              "signal_class": "clock"
            }
          ],
          "connector_type": "pin_header"
        },
        {
          "id": "mosi",
          "name": "MOSI",
          "description": "SPI controller-out peripheral-in line.",
          "functions": [
            {
              "name": "spi_copi",
              "direction": "bidirectional",
              "signal_class": "data"
            }
          ],
          "connector_type": "pin_header"
        },
        {
          "id": "miso",
          "name": "MISO",
          "description": "SPI controller-in peripheral-out line for displays or on-board SD interfaces that support readback.",
          "functions": [
            {
              "name": "spi_cipo",
              "direction": "bidirectional",
              "signal_class": "data"
            }
          ],
          "connector_type": "pin_header"
        },
        {
          "id": "dc",
          "name": "DC",
          "description": "Display data/command select line.",
          "functions": [
            {
              "name": "display_dc",
              "direction": "bidirectional",
              "signal_class": "control"
            }
          ],
          "connector_type": "pin_header"
        },
        {
          "id": "rst",
          "name": "RST",
          "description": "Display reset line.",
          "functions": [
            {
              "name": "display_reset",
              "direction": "bidirectional",
              "signal_class": "control"
            }
          ],
          "connector_type": "pin_header"
        },
        {
          "id": "tcs",
          "name": "TCS",
          "description": "Main TFT/eInk display chip select.",
          "functions": [
            {
              "name": "display_cs_n",
              "direction": "bidirectional",
              "signal_class": "chip_select"
            }
          ],
          "connector_type": "pin_header"
        },
        {
          "id": "gp1",
          "name": "GP1",
          "description": "General-purpose auxiliary signal 1 on the EYESPI connector.",
          "functions": [
            {
              "name": "gpio_aux_1",
              "direction": "bidirectional",
              "signal_class": "data"
            }
          ],
          "connector_type": "pin_header"
        },
        {
          "id": "gp2",
          "name": "GP2",
          "description": "General-purpose auxiliary signal 2 on the EYESPI connector.",
          "functions": [
            {
              "name": "gpio_aux_2",
              "direction": "bidirectional",
              "signal_class": "data"
            }
          ],
          "connector_type": "pin_header"
        },
        {
          "id": "tscs",
          "name": "TSCS",
          "description": "Touch controller chip select for displays that route touch over SPI.",
          "functions": [
            {
              "name": "touch_cs_n",
              "direction": "bidirectional",
              "signal_class": "chip_select"
            }
          ],
          "connector_type": "pin_header"
        },
        {
          "id": "memcs",
          "name": "MEMCS",
          "description": "Auxiliary memory or QSPI flash chip select line where present on the display board.",
          "functions": [
            {
              "name": "memory_cs_n",
              "direction": "bidirectional",
              "signal_class": "chip_select"
            }
          ],
          "connector_type": "pin_header"
        },
        {
          "id": "sdcs",
          "name": "SDCS",
          "description": "MicroSD chip select on displays that expose onboard storage.",
          "functions": [
            {
              "name": "sd_cs_n",
              "direction": "bidirectional",
              "signal_class": "chip_select"
            }
          ],
          "connector_type": "pin_header"
        },
        {
          "id": "lite",
          "name": "Lite",
          "description": "Backlight enable or PWM brightness control signal where supported.",
          "functions": [
            {
              "name": "backlight_ctrl",
              "direction": "bidirectional",
              "signal_class": "control"
            }
          ],
          "connector_type": "pin_header"
        },
        {
          "id": "busy",
          "name": "BUSY",
          "description": "Busy/status line commonly used by eInk displays.",
          "functions": [
            {
              "name": "display_busy",
              "direction": "bidirectional",
              "signal_class": "status"
            }
          ],
          "connector_type": "pin_header"
        },
        {
          "id": "int",
          "name": "INT",
          "description": "Interrupt line from the display or touch controller back to the host.",
          "functions": [
            {
              "name": "display_int",
              "direction": "bidirectional",
              "signal_class": "interrupt"
            }
          ],
          "connector_type": "pin_header"
        },
        {
          "id": "eyespi_ribbon_vin",
          "name": "Ribbon VIN",
          "description": "VIN pin on the 18-pin EYESPI ribbon/FPC connector.",
          "functions": [
            {
              "name": "power_in",
              "direction": "bidirectional",
              "signal_class": "power"
            },
            {
              "name": "eyespi_ribbon_vin",
              "direction": "bidirectional",
              "signal_class": "power"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        },
        {
          "id": "eyespi_ribbon_gnd",
          "name": "Ribbon GND",
          "description": "Ground pin on the 18-pin EYESPI ribbon/FPC connector.",
          "functions": [
            {
              "name": "ground",
              "direction": "bidirectional",
              "signal_class": "ground"
            },
            {
              "name": "eyespi_ribbon_gnd",
              "direction": "bidirectional",
              "signal_class": "ground"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        },
        {
          "id": "eyespi_ribbon_scl",
          "name": "Ribbon SCL",
          "description": "I2C clock pin on the 18-pin EYESPI ribbon/FPC connector.",
          "functions": [
            {
              "name": "i2c_scl",
              "direction": "bidirectional",
              "signal_class": "clock"
            },
            {
              "name": "eyespi_ribbon_scl",
              "direction": "bidirectional",
              "signal_class": "clock"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        },
        {
          "id": "eyespi_ribbon_sda",
          "name": "Ribbon SDA",
          "description": "I2C data pin on the 18-pin EYESPI ribbon/FPC connector.",
          "functions": [
            {
              "name": "i2c_sda",
              "direction": "bidirectional",
              "signal_class": "data"
            },
            {
              "name": "eyespi_ribbon_sda",
              "direction": "bidirectional",
              "signal_class": "data"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        },
        {
          "id": "eyespi_ribbon_sck",
          "name": "Ribbon SCK",
          "description": "SPI clock pin on the 18-pin EYESPI ribbon/FPC connector.",
          "functions": [
            {
              "name": "spi_sck",
              "direction": "bidirectional",
              "signal_class": "clock"
            },
            {
              "name": "eyespi_ribbon_sck",
              "direction": "bidirectional",
              "signal_class": "clock"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        },
        {
          "id": "eyespi_ribbon_mosi",
          "name": "Ribbon MOSI",
          "description": "SPI controller-out peripheral-in pin on the 18-pin EYESPI ribbon/FPC connector.",
          "functions": [
            {
              "name": "spi_copi",
              "direction": "bidirectional",
              "signal_class": "data"
            },
            {
              "name": "eyespi_ribbon_mosi",
              "direction": "bidirectional",
              "signal_class": "data"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        },
        {
          "id": "eyespi_ribbon_miso",
          "name": "Ribbon MISO",
          "description": "SPI controller-in peripheral-out pin on the 18-pin EYESPI ribbon/FPC connector.",
          "functions": [
            {
              "name": "spi_cipo",
              "direction": "bidirectional",
              "signal_class": "data"
            },
            {
              "name": "eyespi_ribbon_miso",
              "direction": "bidirectional",
              "signal_class": "data"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        },
        {
          "id": "eyespi_ribbon_dc",
          "name": "Ribbon DC",
          "description": "Display data/command select pin on the 18-pin EYESPI ribbon/FPC connector.",
          "functions": [
            {
              "name": "display_dc",
              "direction": "bidirectional",
              "signal_class": "control"
            },
            {
              "name": "eyespi_ribbon_dc",
              "direction": "bidirectional",
              "signal_class": "control"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        },
        {
          "id": "eyespi_ribbon_rst",
          "name": "Ribbon RST",
          "description": "Display reset pin on the 18-pin EYESPI ribbon/FPC connector.",
          "functions": [
            {
              "name": "display_reset",
              "direction": "bidirectional",
              "signal_class": "control"
            },
            {
              "name": "eyespi_ribbon_rst",
              "direction": "bidirectional",
              "signal_class": "control"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        },
        {
          "id": "eyespi_ribbon_tcs",
          "name": "Ribbon TCS",
          "description": "Main display chip-select pin on the 18-pin EYESPI ribbon/FPC connector.",
          "functions": [
            {
              "name": "display_cs_n",
              "direction": "bidirectional",
              "signal_class": "chip_select"
            },
            {
              "name": "eyespi_ribbon_tcs",
              "direction": "bidirectional",
              "signal_class": "chip_select"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        },
        {
          "id": "eyespi_ribbon_gp1",
          "name": "Ribbon GP1",
          "description": "General-purpose auxiliary pin 1 on the 18-pin EYESPI ribbon/FPC connector.",
          "functions": [
            {
              "name": "gpio_aux_1",
              "direction": "bidirectional",
              "signal_class": "data"
            },
            {
              "name": "eyespi_ribbon_gp1",
              "direction": "bidirectional",
              "signal_class": "data"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        },
        {
          "id": "eyespi_ribbon_gp2",
          "name": "Ribbon GP2",
          "description": "General-purpose auxiliary pin 2 on the 18-pin EYESPI ribbon/FPC connector.",
          "functions": [
            {
              "name": "gpio_aux_2",
              "direction": "bidirectional",
              "signal_class": "data"
            },
            {
              "name": "eyespi_ribbon_gp2",
              "direction": "bidirectional",
              "signal_class": "data"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        },
        {
          "id": "eyespi_ribbon_tscs",
          "name": "Ribbon TSCS",
          "description": "Touch-controller chip-select pin on the 18-pin EYESPI ribbon/FPC connector.",
          "functions": [
            {
              "name": "touch_cs_n",
              "direction": "bidirectional",
              "signal_class": "chip_select"
            },
            {
              "name": "eyespi_ribbon_tscs",
              "direction": "bidirectional",
              "signal_class": "chip_select"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        },
        {
          "id": "eyespi_ribbon_memcs",
          "name": "Ribbon MEMCS",
          "description": "Auxiliary memory chip-select pin on the 18-pin EYESPI ribbon/FPC connector.",
          "functions": [
            {
              "name": "memory_cs_n",
              "direction": "bidirectional",
              "signal_class": "chip_select"
            },
            {
              "name": "eyespi_ribbon_memcs",
              "direction": "bidirectional",
              "signal_class": "chip_select"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        },
        {
          "id": "eyespi_ribbon_sdcs",
          "name": "Ribbon SDCS",
          "description": "microSD chip-select pin on the 18-pin EYESPI ribbon/FPC connector.",
          "functions": [
            {
              "name": "sd_cs_n",
              "direction": "bidirectional",
              "signal_class": "chip_select"
            },
            {
              "name": "eyespi_ribbon_sdcs",
              "direction": "bidirectional",
              "signal_class": "chip_select"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        },
        {
          "id": "eyespi_ribbon_lite",
          "name": "Ribbon Lite",
          "description": "Backlight control pin on the 18-pin EYESPI ribbon/FPC connector.",
          "functions": [
            {
              "name": "backlight_ctrl",
              "direction": "bidirectional",
              "signal_class": "control"
            },
            {
              "name": "eyespi_ribbon_lite",
              "direction": "bidirectional",
              "signal_class": "control"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        },
        {
          "id": "eyespi_ribbon_busy",
          "name": "Ribbon BUSY",
          "description": "Busy/status pin on the 18-pin EYESPI ribbon/FPC connector.",
          "functions": [
            {
              "name": "display_busy",
              "direction": "bidirectional",
              "signal_class": "status"
            },
            {
              "name": "eyespi_ribbon_busy",
              "direction": "bidirectional",
              "signal_class": "status"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        },
        {
          "id": "eyespi_ribbon_int",
          "name": "Ribbon INT",
          "description": "Interrupt pin on the 18-pin EYESPI ribbon/FPC connector.",
          "functions": [
            {
              "name": "display_int",
              "direction": "bidirectional",
              "signal_class": "interrupt"
            },
            {
              "name": "eyespi_ribbon_int",
              "direction": "bidirectional",
              "signal_class": "interrupt"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        },
        {
          "id": "eyespi_fpc",
          "name": "EYESPI ribbon cable connector",
          "description": "18-pin 0.5 mm pitch flip-top FPC connector that mates with Adafruit EYESPI ribbon/flex cables.",
          "functions": [
            {
              "name": "eyespi_ribbon_cable"
            },
            {
              "name": "power_in",
              "direction": "bidirectional",
              "signal_class": "power"
            },
            {
              "name": "ground",
              "direction": "bidirectional",
              "signal_class": "ground"
            },
            {
              "name": "i2c_scl",
              "direction": "bidirectional",
              "signal_class": "clock"
            },
            {
              "name": "i2c_sda",
              "direction": "bidirectional",
              "signal_class": "data"
            },
            {
              "name": "spi_sck",
              "direction": "bidirectional",
              "signal_class": "clock"
            },
            {
              "name": "spi_copi",
              "direction": "bidirectional",
              "signal_class": "data"
            },
            {
              "name": "spi_cipo",
              "direction": "bidirectional",
              "signal_class": "data"
            },
            {
              "name": "display_dc",
              "direction": "bidirectional",
              "signal_class": "control"
            },
            {
              "name": "display_reset",
              "direction": "bidirectional",
              "signal_class": "control"
            },
            {
              "name": "display_cs_n",
              "direction": "bidirectional",
              "signal_class": "chip_select"
            },
            {
              "name": "gpio_aux_1",
              "direction": "bidirectional",
              "signal_class": "data"
            },
            {
              "name": "gpio_aux_2",
              "direction": "bidirectional",
              "signal_class": "data"
            },
            {
              "name": "touch_cs_n",
              "direction": "bidirectional",
              "signal_class": "chip_select"
            },
            {
              "name": "memory_cs_n",
              "direction": "bidirectional",
              "signal_class": "chip_select"
            },
            {
              "name": "sd_cs_n",
              "direction": "bidirectional",
              "signal_class": "chip_select"
            },
            {
              "name": "backlight_ctrl",
              "direction": "bidirectional",
              "signal_class": "control"
            },
            {
              "name": "display_busy",
              "direction": "bidirectional",
              "signal_class": "status"
            },
            {
              "name": "display_int",
              "direction": "bidirectional",
              "signal_class": "interrupt"
            }
          ],
          "connector_type": "fpc_18pin_0p5mm"
        }
      ],
      "interfaces": [
        {
          "id": "eyespi_ribbon_cable",
          "name": "EYESPI ribbon cable",
          "protocol": {
            "type": "custom",
            "role": "peer"
          },
          "requires": [
            {
              "function": "eyespi_ribbon_cable",
              "count": 1
            }
          ],
          "constraints": {
            "requires_connector_type": "fpc_18pin_0p5mm"
          },
          "description": "Bundled 18-pin EYESPI ribbon/FPC cable interface as documented by the Adafruit guide."
        },
        {
          "id": "eyespi_ribbon_power",
          "name": "Ribbon power pins",
          "protocol": {
            "type": "power_supply",
            "role": "supply"
          },
          "requires": [
            {
              "function": "eyespi_ribbon_vin",
              "count": 1
            },
            {
              "function": "eyespi_ribbon_gnd",
              "count": 1
            }
          ],
          "constraints": {
            "requires_connector_type": "fpc_18pin_0p5mm"
          },
          "description": "Ribbon-side VIN and GND pins, matching the Adafruit guide's power pins section."
        },
        {
          "id": "eyespi_ribbon_i2c",
          "name": "Ribbon I2C logic pins",
          "protocol": {
            "type": "i2c",
            "role": "peer"
          },
          "requires": [
            {
              "function": "eyespi_ribbon_scl",
              "count": 1
            },
            {
              "function": "eyespi_ribbon_sda",
              "count": 1
            }
          ],
          "constraints": {
            "requires_connector_type": "fpc_18pin_0p5mm"
          },
          "description": "Ribbon-side SCL and SDA pins for touch or auxiliary I2C peripherals on compatible displays."
        },
        {
          "id": "eyespi_ribbon_spi_display",
          "name": "Ribbon SPI display pins",
          "protocol": {
            "type": "spi",
            "role": "peer"
          },
          "requires": [
            {
              "function": "eyespi_ribbon_sck",
              "count": 1
            },
            {
              "function": "eyespi_ribbon_mosi",
              "count": 1
            },
            {
              "function": "eyespi_ribbon_miso",
              "count": 1
            },
            {
              "function": "eyespi_ribbon_dc",
              "count": 1
            },
            {
              "function": "eyespi_ribbon_rst",
              "count": 1
            },
            {
              "function": "eyespi_ribbon_tcs",
              "count": 1
            }
          ],
          "constraints": {
            "requires_connector_type": "fpc_18pin_0p5mm"
          },
          "description": "Ribbon-side SPI and core display-control pins: SCK, MOSI, MISO, DC, RST, and TCS."
        },
        {
          "id": "eyespi_ribbon_gpio",
          "name": "Ribbon GPIO pins",
          "protocol": {
            "type": "gpio",
            "role": "peer"
          },
          "requires": [
            {
              "function": "eyespi_ribbon_gp1",
              "count": 1
            },
            {
              "function": "eyespi_ribbon_gp2",
              "count": 1
            }
          ],
          "constraints": {
            "requires_connector_type": "fpc_18pin_0p5mm"
          },
          "description": "Ribbon-side GP1 and GP2 pins."
        },
        {
          "id": "eyespi_ribbon_chip_selects",
          "name": "Ribbon auxiliary chip-select pins",
          "protocol": {
            "type": "custom",
            "role": "peer"
          },
          "requires": [
            {
              "function": "eyespi_ribbon_tscs",
              "count": 1
            },
            {
              "function": "eyespi_ribbon_memcs",
              "count": 1
            },
            {
              "function": "eyespi_ribbon_sdcs",
              "count": 1
            }
          ],
          "constraints": {
            "requires_connector_type": "fpc_18pin_0p5mm"
          },
          "description": "Ribbon-side TSCS, MEMCS, and SDCS pins for touch, memory, and SD-card peripherals."
        },
        {
          "id": "eyespi_ribbon_backlight",
          "name": "Ribbon backlight pin",
          "protocol": {
            "type": "custom",
            "role": "peer"
          },
          "requires": [
            {
              "function": "eyespi_ribbon_lite",
              "count": 1
            }
          ],
          "constraints": {
            "requires_connector_type": "fpc_18pin_0p5mm"
          },
          "description": "Ribbon-side Lite pin for backlight PWM or on/off control."
        },
        {
          "id": "eyespi_ribbon_status",
          "name": "Ribbon status pins",
          "protocol": {
            "type": "custom",
            "role": "peer"
          },
          "requires": [
            {
              "function": "eyespi_ribbon_busy",
              "count": 1
            },
            {
              "function": "eyespi_ribbon_int",
              "count": 1
            }
          ],
          "constraints": {
            "requires_connector_type": "fpc_18pin_0p5mm"
          },
          "description": "Ribbon-side BUSY and INT pins used by eInk status and capacitive touch interrupt signaling."
        }
      ],
      "metadata": {
        "connector_pitch_mm": 0.5,
        "connector_pin_count": 18,
        "breadboard_header_pitch_in": 0.1,
        "is_passive_breakout": true
      }
    },
    {
      "domain": "mechanical",
      "resources": [],
      "interfaces": [],
      "package_type": "PCB Module",
      "dimensions_mm": {
        "length": 25.3,
        "width": 17.7,
        "height": 3.6
      },
      "metadata": {
        "mounting_method": "through_hole_header_optional",
        "breadboard_friendly": true
      }
    }
  ],
  "design_rules": [
    "Treat the board as a pure signal breakout: it provides no voltage regulation, no level shifting, and no buffering between the FPC connector and the header pins.",
    "Match the host wiring to the attached display breakout's actual voltage and signal expectations before applying VIN or logic signals.",
    "Use the official 18-pin 0.5 mm pitch EYESPI cable orientation and connector standard; not all FPC cables with similar mechanics share the same pinout.",
    "For most SPI display use cases only the left-side subset of pins is required, but touch, storage, backlight, and eInk status functions may require the additional control lines."
  ],
  "usage_notes": "This board is a convenience breakout for Adafruit EYESPI-compatible displays. It is intended to let a solderless breadboard or custom wiring harness access the full EYESPI signal set without hand-soldering an 18-pin 0.5 mm FPC connector directly onto a prototype.",
  "application_examples": [
    "Breadboarding an EYESPI TFT display with a microcontroller.",
    "Testing EYESPI eInk panels with separate BUSY, reset, and chip-select wiring.",
    "Breaking out touch, SD, and backlight signals from a display board to custom host wiring."
  ],
  "compatibility_notes": "The breakout follows Adafruit's EYESPI 18-pin connector standard used on compatible TFT and eInk display breakouts. The official guide warns that Raspberry Pi CSI/DSI camera flex cables are not pin-compatible replacements even though the cable format looks similar.",
  "warnings": [
    "Passive breakout only: this board does not make a 1.8 V-only display safe on a 3.3 V or 5 V host by itself.",
    "Do not assume Raspberry Pi CSI or DSI flex cables are compatible with EYESPI wiring; the official Adafruit guide says they will not work as drop-in substitutes.",
    "Display, cable, and headers are separate items; the board alone does not include the mating EYESPI cable or display module."
  ]
}