Skip to content

About

Open pinout library: 3,600+ pinout diagrams, GPIO maps, datasheets and source records for ESP32, ESP8266, Arduino, Raspberry Pi, RP2040, RP2350, Teensy, displays and sensors. Model, revision and coverage for every board. Powers the Black Wire guide.

Topics

Resources

Contributing

Stars

23 stars

Watchers

3 watching

Forks

Repository files navigation

Black Wire logo    Valleytech Solutions logo

The Black Wire Maker's
Technical Reference Guide

Know your board. Make the connection.
A Valleytech Solutions project, made for the workbench.

Makers · Educators · Students · Hobbyists · Engineers

Download the collection · Browse boards · Source credits · Download the desktop app · Contribute a reference

Inland ESP32 original pinout in the Black Wire guide

Find a pinout, then build

Search the guide · Read the reference wiki · Browse maker modules · Get the Windows & Linux app

Board and device references for ESP32, Arduino, Raspberry Pi, RP2040/RP2350, displays, sensors, buttons, interfaces and power modules. Find physical pinout sources, supporting photos, pin-purpose tables and manufacturer documentation, with revision and coverage notes. Generic modules and documentation gaps remain visible.

The companion app provides a single Windows installer, Linux packages and in-app updates that retain downloaded references and saved workbench data. Search and previews are included; download original files inside the app for complete offline access. Install and update. The hardware collection is snapshot 2026.11.1, First Edition / 2026. How to read a pinout · Contribute or report a correction.

November 3 update / snapshot 2026.11.1

15 new listings · 3 existing listings updated · 33 saved reference attachments · 9 physical pinout images. Exact-model pinout images, board documentation and clearly marked supporting references. Review, source register and remaining gaps. First Edition / 2026 remains unchanged.

October 30 update / snapshot 2026.10.6

13 new listings · one board updated · 39 saved references · five physical pinout images. ESP32-S31 TINY, Metro P4 Hydra, new Waveshare maps, M5Stack sensor/power references and LattePanda Sigma 2 connectors. Review, source register and gaps. First Edition / 2026 remains unchanged.

Brand discovery / snapshot 2026.10.5

16 board/device records · 16 maker records · 72 references · nine physical-pinout images. XIAO STM32C5, PaperDIY, 01space and WIZnet maps, plus Adafruit breakout documentation and additional SBC/SoM references. Additions, all-brand source register and remaining gaps.

Documentation recovery / snapshot 2026.10.4

416 existing listings enriched · 571 reference attachments · 527 distinct files. Manufacturer manuals and schematics are saved with exact source links, plus nine partial physical-pinout entries. Coverage, source corrections and remaining gaps.

Waveshare, M5Stack and NodeMCU / snapshot 2026.10.3

3 new records · 6 enriched records · 11 references · 10 external terminal-purpose rows. C5 Pico and MINI-KIT pinouts rechecked; board schematics added. Scope, sources and gaps.

Vendor expansion / snapshot 2026.10.2

10 new records · 124 enriched records · 232 reference attachments · 159 sourced pin-purpose rows. Includes Seeed, M5Stack, Waveshare, Arduino, Adafruit, DFRobot and Renesas. Of the added attachments, 14 are physical pinout images. Sources, exact scope and remaining gaps.

High Boy schematic / snapshot 2026.10.1

The updated High Boy V2_03 schematic, dated September 29, 2026, is available as an eight-page original PDF. The older REV 2.2 MVP / ESP32-S3 labels remain separate. Open the schematic and review notes.

Radios and GPIO devices / snapshot 2026.09.13

34 new records · 12 enriched records · 104 reference attachments · 164 sourced pin-function rows. RAKwireless, Heltec, Elecrow, Seeed, H4M Pro, ESP32-MDK, Hat Labs, LOLIN and REYAX. Of the new attachments, 25 are physical pinout images. Exact coverage and open leads. The companion app supports pinch zoom and dragging for images and PDFs.

Wiring & protocols / snapshot 2026.09.12

15 original guides and 15 SVG diagrams. Ethernet and phone connectors, serial and differential buses, debug interfaces, and RFID/NFC module connections. Browse diagrams · Sources and scope. These do not increase physical board-pinout counts.

HaleHound and Elechouse / snapshot 2026.09.11

32 added listings · 106 reference attachments · 36 sourced pin-purpose rows. Includes the original HaleHound CYD build guide and diagram pages, QDtech base-board specifications, and 27 Elechouse board/module variants. Physical maps, wiring diagrams, labels and photos have separate coverage labels. Sources, revision conflicts and remaining gaps.

Previous Inland, DFRobot and distributor sources / snapshot 2026.09.10

118 added listings, including 67 Inland records. All 50 official DFRobot MCU-category SKUs reviewed, plus manufacturer GPIO pages for TI, Microchip and Silicon Labs. Inland currently has eight physical pinout images; other records identify supporting material and missing sheets. Coverage, sources and remaining gaps.

Collection downloads have multiple independent ZIP parts. Extract all parts into the same folder to restore the full library.

Previous search and source sweep / snapshot 2026.09.9

Six new records · 24 new references · four physical pinout-image entries. Includes ESP-Mosaico, P4X boards and FPGA references. Nine processor categories and two malformed records corrected; a damaged image retired. Full audit, sources and limits · Documentation endpoint results.

Previous Jetson, NanoPi and I/O expansion / snapshot 2026.09.8

75 additional listings · 114 reference files · 15 physical pinout-image entries. Includes FriendlyELEC NanoPi/NanoPC, NVIDIA Jetson carrier documentation, Raspberry Pi I/O boards, Olimex GPIO maps, RAK13002 and Antmicro. Sources, scope and remaining work.

Every listing now has explicit board-datasheet, manufacturer-website and visual-reference status. Supporting photos, schematics and chip datasheets retain their separate roles. Documentation inventory · Every listing in CSV.

Previous manufacturer and SBC expansion / snapshot 2026.09.7

107 additional listings · 229 additional reference entries · 127 additional physical pinout-image entries. Expanded Adafruit and SparkFun references, FPGA boards, H4M, eight LattePanda models and Milk-V Mars. Additions, source corrections and remaining gaps.

LattePanda IOTA GPIO reference with hardware documentation links

Previous quality update / snapshot 2026.09.6

Added two distinct SparkFun ESP32 Thing Plus models, their original pinout PDFs and page-rendered sheets, plus supporting references for Pro Micro RP2350, Thing Plus RP2350 and ESP32-P4-Function-EV-Board v1.5.2. The current catalog has 2,407 board/device listings, 486 maker listings, 3,011 board reference entries and 1,369 pinout image entries. Audit, evidence and remaining gaps.

Previous pin-reference expansion / snapshot 2026.09.5

Every one of the 2,891 board and maker listings now has an explicit pinout-coverage status. Linked listings may describe the same hardware. Coverage audit and remaining work.

This update adds 46 annotated manufacturer-model connector sheets covering 637 modeled contacts, 58 source pin tables containing 633 rows, and 17 additional source-image attachments. Pin details are recorded for 70 maker listings. The sheets use source-model contact positions; K keys are editorial identifiers. Signal-name purpose explanations, transcribed manufacturer facts and independent electrical approval are different evidence levels.

Of 486 maker listings, 151 have physical pinout sources, 30 have functions only, 288 have supporting references only, and 17 have no reference. Of 2,405 board listings, 875 have pinout sources, 3 have functions only, 811 have supporting references only, and 716 await documentation. No listing is independently approved as a complete all-connector reference. Five dense or ambiguous models were withheld. The primary-source intake attempted 1,499 pages; 336 retrieval failures remain recorded.

Manufacturer originals remain intact. The annotated Adafruit sheets are CC BY-SA 3.0 adaptations with attribution and exact source hashes. Other source rights remain per asset. The First Edition book is an unfinished editorial draft.

Maker expansion / September 2026

Browse displays, sensors and modules or search the parts desk. The intake has 486 records: 159 named-product records, 43 manufacturer-family records, 268 existing collection references and 16 generic families needing identification. Manufacturer documentation is recorded for 196 listings. These are source records, not 486 newly completed pinouts. Coverage and product roadmap.

A reference shelf for your next project

Find the picture that tells you which physical pin does what. This collection brings together original board pinouts, connector labels, GPIO references and supporting documents, organized by manufacturer, processor and exact board identity. The companion desktop app makes the same collection searchable offline.

First Edition · snapshot 2026.10.5 Count
Board pinout source image entries 1,610
Board reference entries 4,495
Board/device records with files 2,106
Manufacturers and source groups with board files 82
Unique board media files, including vector companions 4,321

Records include shared references, variants, devices and unreviewed source products. These counts are not a census of unique development boards. Coverage is growing; it is not complete.

The Black Wire desktop library browsing this collection

Devices & IoT

Browse 346 device records or use the new Devices & IoT tab. Find T-Embed, T-Beam, T-Deck, Cardputer, Flipper, wearables, LoRa nodes, smart displays and controllers by category, manufacturer and MCU. Missing sheets and in-development documentation are explicitly labeled.

Devices and IoT browsing in Black Wire

This update adds 15 original images, including 7 pinout/connector sheets, and six newly populated device records. First Edition policy and update details.

Find your board

Search the complete current collection in your browser on the Valleytech store. No download or installation is needed. The full-screen guide includes manufacturer/processor filters, pinout viewing and power tools.

Start at Browse manufacturers and boards. Each board page includes a preview, original-resolution downloads, model/revision notes, and source credits. ESP32-C5, C6, S3 and other variants remain separate; RP2040, RP2350, CYD, Arduino, Teensy, SBCs and devices with GPIO have their own records.

What you need Where to look
Physical board pins Board pages marked pinout image
Connector or GPIO labels GPIO reference image and board labeling image
Manuals, schematics or supporting material Original PDF / source reference; check the review label
Full-resolution originals library/media/; linked from every board page
Provenance, hashes and rights catalog/attributions.csv and library/catalog.json
Fast offline search and power tools Black Wire desktop

Original files are stored once by content hash; board pages provide the human-friendly organization. Shared images remain linked to all applicable records. Thumbnails and large-image previews are convenience derivatives, not replacements for the originals.

Use it offline

Download a versioned ZIP from this repository's collection releases. Each release includes the full reference collection, board indexes, source credits, license/rights notices and a SHA-256 checksum. Extract the whole ZIP and begin with README.md and BROWSE.md. The files work on Windows, Linux and macOS with an image/PDF viewer and a Markdown reader; no installer is needed for the collection.

The guide remains First Edition / 2026. The latest collection snapshot is 2026.09.9 — Search and source sweep; 2026.09.1 remains available unchanged. Collection snapshots and app versions are independent of the future annual book editions; see EDITION.md. The desktop repository provides application installers and states which operating systems actually have downloads.

You can also clone the current repository (about 1.8 GB of reference data). Keep the folder structure intact. Local Markdown viewers can follow the board pages; the desktop app provides the full searchable image/PDF interface. See release and checksum instructions.

git clone https://git.churchofmalware.org/Valleytech/black-wire-pinouts.git

Attribution, quality and publication

Original guide/editorial and compilation contributions are CC BY 4.0: reuse, adapt and share, including commercially, with attribution to Kal / Valleytech Solutions, a license link and a note of changes. See suggested attribution and privacy.

Read ATTRIBUTION.md and RIGHTS.md. Every image retains its recorded source, rights status and SHA-256. Attribution is not permission to relicense or commercially print an image. Many source licenses have not yet been established; any book edition needs a rights review for those images. No collection-wide open license is claimed for manufacturer artwork.

“Reviewed” means categorized against its source, not electrically bench-verified. Some references have unidentified revisions, partial maps or low resolution. Chip-package diagrams are separately labeled and excluded from the physical-board pinout count. One unreviewed reSpeaker Lite source PNG is truncated; its original is retained with a preview-error note.

Help build the field guide

Send a board reference, correction, revision clarification, a better original or verified license information through the contribution template. The long-term direction is an offline reference app, a browsable wiki and annual book editions; the digital collection, public wiki and workshop app are available today.


Created and curated by —your pal kal · @valleytechsolutions on YouTube

Black Wire and Valleytech logos belong to their creator. Manufacturer names and trademarks identify the referenced hardware; they do not imply endorsement.

Maker image update / 2026.09.4

467 of 486 maker records now have visual references, including 327 newly collected unique image files and 58 physical connector/pinout source images. Identification photos, schematics, partial pinouts and technical-review status are labeled separately. 29 power records were added. Image gaps and image provenance remain explicit. These are source references, not complete-device approvals or worldwide completeness claims. Manufacturer originals are unchanged; unknown rights are not a grant for printing or other reuse.

About

Open pinout library: 3,600+ pinout diagrams, GPIO maps, datasheets and source records for ESP32, ESP8266, Arduino, Raspberry Pi, RP2040, RP2350, Teensy, displays and sensors. Model, revision and coverage for every board. Powers the Black Wire guide.

Topics

Resources

Contributing

Stars

23 stars

Watchers

3 watching

Forks

Releases

Packages

Contributors

Languages