Skip to the content
2 layers70 × 60.8 mmGpio adapter, the printed circuit board in 3D

Test library om RPI hardwarematig te testen

Size
70 × 60.8 mm
Copper layers
2
Thickness
1.6 mm
Parts
32
Nets
53
Pads
136
Tracks, vias
102, 0
Routed
Yes
KiCad
KiCad 7 (file 20221018)
Created
2 Oct 2026
Updated
6 Oct 2026

Overview

Gpio adapter is an open-source printed circuit board by frederiekberthier, from the frederiekberthier/RPI_test repository on GitHub, published under the CC0-1.0 licence. It is a 2-layer board of 70 × 60.8 mm with 32 parts on 53 nets, routed with 102 tracks and 0 vias.

Its parts include 26 resistors and 2 connectors. It belongs with the interfaces and adapters boards of this library.

README

README.md

Raspberry Pi testsoftware

Test library om RPI hardwarematig te testen

Opstelling

  • TEST-SERVER (eigen Pi 5, met scherm): stuurt de test aan en maakt het rapport.
  • TEST-CLIENT (de te testen Pi 4/5): bootet van een eigen TEST-CLIENT-SD met de agent.
  • Verbonden met: GPIO-adapter (alleen GND + GPIO's, met serieweerstanden, géén 5V/3V3) en een rechtstreekse netwerkkabel met statische IP's. De GPIO-adapter kan op breadboards (docs/opstelling.md) of als print met één koperlaag (docs/pcb.md).

Overzicht van de opstelling

Namen: de twee Pi's heten TEST-SERVER en TEST-CLIENT. Aan de scripts geef je server of client mee (./install.sh server); de hostnamen worden test-server en test-client. De namen gaan over de Pi's, niet over het netwerkprotocol: de agent op de TEST-CLIENT is technisch een HTTP-server en de TEST-SERVER roept hem aan. "Raspberry Pi tester" is de naam van de applicatie.

Installeren op een Pi: stappenplan

Eén script (install.sh) doet alles: voorcontrole, pakketten (apt), software, hostnaam, vrije GPIO-pinnen, wifi-land, scherm met kiosk (TEST-SERVER), dienst en het vaste IP-adres. Het controleert per onderdeel eerst of het er al staat, dus je kunt het veilig opnieuw uitvoeren. De stappen zijn voor de TEST-SERVER en de TEST-CLIENT-SD hetzelfde; alleen server of client verschilt.

  1. Schrijf Raspberry Pi OS Trixie (64-bit) naar een SD-kaart met Raspberry Pi Imager: met bureaublad voor de TEST-SERVER, Lite voor de TEST-CLIENT-SD. Stel in de Imager een gebruiker, wifi (land BE) en SSH in.
  2. Start de Pi met internet (via wifi, niet via de ethernetpoort die de testkabel wordt) en haal de software binnen:
    text
    sudo apt install -y git
    git clone https://github.com/frederiekberthier/RPI_test.git
    cd RPI_test
  3. Kijk wat er al op de Pi staat (optioneel, wijzigt niets):
    text
    sudo ./install.sh server --check        # of: client
  4. Installeer (voor het eerst ca. 5 tot 10 minuten):
    text
    sudo ./install.sh server                # of: client
    Het script doet eerst een voorcontrole en stopt met een duidelijke melding als er iets ontbreekt.
  5. Herstart: sudo reboot
  6. Controleer het resultaat: sudo ./image/verify.sh server (of client)
  7. Iets mis? sudo ./image/diagnose.sh verzamelt alle relevante uitvoer in één bestand om te delen.
OptieWat het doet
--checktoont per onderdeel aanwezig, ontbreekt of onbekend; wijzigt niets
--forcepast alles opnieuw toe, ook wat al aanwezig lijkt
--readonly(alleen client) maakt het bestandssysteem alleen-lezen na de installatie
--skip-preflightslaat de voorcontrole over

Bijwerken naar een nieuwe versie: git pull && sudo ./install.sh server. Het script ziet dat alleen de software verouderd is, vervangt die en herstart de dienst; de rest wordt overgeslagen.

Meer: docs/eerste-installatie.md (draaiboek voor de eerste keer, met controlelijst), docs/image.md (scherm, diensten, SD klonen, probleemoplossing) en docs/opstelling.md (onderdelen en bedrading van het breadboard).

Ontwikkelen zonder hardware

text
pip install -e .[dev]
python -m pytest
python -m rpitest --mock                                   # gezonde gesimuleerde Pi
python -m rpitest.ui --mock                                # het scherm van de TEST-SERVER, op http://127.0.0.1:8080
python -m rpitest --mock --fault stuck_low:C:5 --fault bridge:C:10:11 --fault open:7
python -m rpitest --mock --fault eth_100 --fault wifi_5g_dead --fault bt_client_tx_dead

Faalspecificaties: stuck_low|stuck_high:<S|C>:<pin>, bridge:<S|C>:<a>:<b>, open:<pin>. Systeemfouten: eth_100, eth_errors, eth_slow, eth_loss, no_wifi, wifi_5g_dead, wifi_weak, no_bt, bt_client_rx_dead, bt_client_tx_dead, server_no_wifi, server_no_bt, usb_slotN_dead|usb2|corrupt|slow (N = 1..4), usb_no_sticks, usb_overcurrent, usb_disconnect, power_undervolt, power_undervolt_history, power_hot, power_warm, power_throttle, power_cpu_error, power_ram_error, power_core_missing, power_no_sensor, power_dip, power_throttle_blip.

Stand van zaken

Klaar: skelet, agent (JSON-RPC over HTTP), mock met foutinjectie, GPIO-checks, JSON/HTML-rapport, echte GPIO-backend (libgpiod 2.x, enkel getest met een nep-gpiod), bedradingshandleiding, netwerk-, wifi-, bluetooth-, USB- en voeding/temperatuurchecks (alleen getest met simulatie en nagebootste tooluitvoer). Scherm met startknop en live resultaten (rpitest.ui), en één installatiescript voor server en TEST-CLIENT (install.sh), getest tegen nagebootste systeemopdrachten. Nog te doen: alles op echte Pi's bevestigen (ook het installatiescript).

Parts

32
QtyValueFootprintReferences
26220R_Axial_DIN0207_L6.3mm_D2.5mm_P7.62mmR2, R10, R11, R12, R13, R14, R15, R16, R17, R18, R19, R20, R21, R22, R23, R24 +10
4M3MountingHole_3.2mm_M3H1, H2, H3, H4
22x20IDC-Header_2x20_P2.54mm_Horizontal_MirroredJ1, J2

Similar boards

  • 2 layers50 × 23.2 mmAnalog, the printed circuit board in 3D

    Analog

    hoglet67/RGBtoHDMI

    Bare-metal Raspberry Pi project that provides pixel-perfect sampling of Retro Computer RGB/YUV video and conversion to HDMI

    32 parts1kGPL-3.0
  • 2 layers136.8 × 54.2 mmRetropie zero, the printed circuit board in 3D

    Retropie zero

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    32 parts915
  • 2 layersMooltipass top, the printed circuit board in 3D

    Mooltipass top

    limpkin/mooltipass

    Github repository dedicated to the mooltipass project

    32 parts531
  • 2 layers16 × 20 mmESPKey, the printed circuit board in 3D

    ESPKey

    octosavvi/ESPKey

    Wiegand data logger, replay device and micro door-controller

    32 parts353GPL-2.0
  • 2 layers82 × 40.9 mmDisplay7447, the printed circuit board in 3D

    Display7447

    zmaker/arduino_cookbook

    gli sketch del nuovo progetto Arduino Cookbook e dei video di YouTube

    32 parts269
  • 2 layers40 × 38 mmShield, the printed circuit board in 3D

    Shield

    murexrobotics/electrical

    Highly integrated electronics design and printed circuit boards (PCBs) for the MATE ROV Competition. Attempt the impossible.

    32 parts192MIT
  • 2 layers47 × 39 mmQrss clock tx, the printed circuit board in 3D

    Qrss clock tx

    swharden/AVR-projects

    A collection of standalone AVR projects written in C

    32 parts184MIT
  • 2 layers30.9 × 63 mmStm32-io extend, the printed circuit board in 3D

    Stm32-io extend

    hardenedlinux/cheap-pcb

    Cheap PCB: Better understanding the current status of hardware supply chain

    32 parts170CC0-1.0

Questions

How big is the Gpio adapter PCB?

It measures 70 × 60.8 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Gpio adapter use?

32 parts. 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 Gpio adapter KiCad files?

From the frederiekberthier/RPI_test repository on GitHub, at the commit this page was made from: the board is hardware/gpio-adapter/kicad/gpio-adapter.kicad_pcb. PCBKit opens the board in the browser, with nothing to install.

Can I use the Gpio adapter design in my own project?

Its repository publishes it under the CC0-1.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).