← Back to Build Wizard

PARENT'S WIRING GUIDE

Migrating from Dupont spaghetti to the terminal block shield
Ages 8+ with parent supervision

What Are We Doing?

Your kid built a M.A.S.S. Trap with jumper wires and it works great. But those little Dupont connectors wiggle loose every time someone bumps the track. Today we're upgrading to screw terminals — the same connections, but permanent and vibration-proof.

Think of it like this: We're moving from alligator clips to bolted connections. Same circuit. Same wires. Just tighter.

⚠️ Safety First — Read This Together

💨 The Magic Smoke Rule: All electronics run on magic smoke. Once you let the smoke out, it stops working. Keeping wires in the right place keeps the smoke in. This is a real thing — not just a joke. Reversed power = released smoke = dead board.

The Game Plan

Here's the full migration, phase by phase. Each device takes one sitting.

1
Phase 1 — 5 minutes
Prep & Photo
Photograph the current wiring. Label each wire with tape. Gather tools. This is your safety net — if anything goes wrong, the photo is your map back.
2
Phase 2 — 5 minutes
Seat the Shield
Unplug the ESP32 from power. Push it into the Meshnology terminal block shield. All 38 pins must seat evenly — no bent pins, no gaps.
3
Phase 3 — 15 minutes
Migrate Wires
One wire at a time: pull the Dupont connector, strip the wire tip (if needed), insert into the matching screw terminal, tighten. The terminal numbers match the GPIO numbers.
4
Phase 4 — 5 minutes
Verify & Power On
Double-check every connection against the photo. Then power up and run diagnostics from the Build Wizard to confirm everything works.
5
Phase 5 — 5 minutes
The Shake Test
Pick up the whole assembly and shake it. Gently at first, then with intent. Nothing should come loose. That's the whole point of screw terminals. If a wire falls out, it wasn't tight enough — redo it.
🦉
Night Owl Estimated Finish
~11:30 PM

Based on a 10:45 PM start with 3 devices. Adjust if starting earlier. Coffee optional but recommended.

MIGRATION PROGRESS
0 of 5 phases complete
1
Prep & Photo Documentation
~5 minutes • No tools needed
▼
📷

Take a Photo of the Current Wiring

Grab your phone. Take a clear, well-lit photo of every wire connection on the current board. Get a shot from directly above so you can see which color wire goes to which pin. This photo is your lifeline — if you get confused during migration, look at the photo.

🎮 "Hey kid — you're the photographer. Get a good shot of every wire."
📝

Label Your Wires (Optional but Smart)

If your wires aren't color-coded, wrap a small piece of masking tape around each one and write what it connects to: "IR SIG", "GND", "3V3", "BCLK", etc. Takes 2 minutes now, saves 10 minutes of confusion later.

👥 Parent tip: Even if wires ARE color-coded, labels help your kid learn what each wire does. Make it a quiz.
🔧

Gather Your Tools

You need exactly two things:

  • Small flathead screwdriver — precision/jeweler's size. The screw terminals are tiny.
  • Wire strippers or scissors — to strip 5mm of insulation from wire tips (if using pre-made jumpers, they may already be stripped)
Why strip?
Dupont jumpers have connectors on the ends (those little plastic housings). Screw terminals need bare wire. You have two choices: (1) cut off the Dupont connector and strip 5mm of insulation, or (2) use new solid-core wire and keep the Dupont jumpers intact for future prototyping.
🔌

Unplug Everything

Pull the USB cable. Disconnect the power supply. Unplug everything. The board should have zero power before you touch any wires. Confirm the LED on the ESP32 is off. No lights = no power = safe to work.

Zero Power Rule
Never rearrange wires with power connected. Even 3.3V can fry a sensor if you accidentally short two pins. Always unplug first, wire second, power last.
2
Seat the ESP32 in the Shield
~5 minutes • Steady hands
▼
🔌

Remove All Dupont Wires from the ESP32

Gently pull each Dupont connector straight off the pin headers. Don't yank sideways — you can bend pins. Set the wires aside in order (your photo is the reference if they get mixed up).

🎮 "Pull them straight off — like unplugging headphones, not pulling out a splinter."
💻

Inspect the Shield

Look at the Meshnology terminal block shield. It has two long rows of pin sockets in the center (where the ESP32 plugs in) and screw terminals around the edges. Each screw terminal is labeled with a GPIO number.

How it works
The shield is a breakout board. Your ESP32 plugs into the center. Every GPIO pin on the ESP32 routes to a labeled screw terminal on the edge. Terminal 4 = GPIO 4. Terminal 15 = GPIO 15. No translation needed.
👉

Align and Press the ESP32 Into the Shield

Line up the ESP32's pin headers with the shield's pin sockets. The USB-C port should face outward (accessible for programming and power). Press firmly and evenly — both sides at the same time. You'll feel the pins seat.

Check for bent pins
Look at both sides before pressing. If any pin on the ESP32 is bent outward, carefully straighten it with needle-nose pliers first. A bent pin won't seat — and forcing it will break the pin.
👥 Parent tip: This step requires real force. If your kid can't seat it evenly, press it yourself. It's better to do it right than to bend 3 pins.
🔎

Verify the Seating

Look at the gap between the ESP32 board and the shield on both sides. It should be even — same height left and right. If one side is higher, the pins aren't fully seated on that side. Press down on the high side.

Success check
When properly seated: (1) No pin tips visible between the boards, (2) The gap is even on both sides, (3) The ESP32 doesn't wobble when you gently push it side to side.
3
Migrate the Wires
~15 minutes • Screwdriver required
▼
The One-Wire Rule
Do one wire at a time. Pick up the old Dupont wire, look at what it connects to (from your photo/labels), find the matching screw terminal, strip the tip if needed, insert, tighten. Don't move to the next wire until this one is solid.

Finish Gate Connections

WireFrom (Old Dupont)To (Screw Terminal)Component
Red 3.3V header pin 3V3 terminal IR Sensor VCC
Black GND header pin GND terminal IR Sensor GND
Green GPIO 4 header pin Terminal 4 IR Sensor Signal
Terminal numbers = GPIO numbers
The best thing about this shield: Terminal 4 = GPIO 4. No math. No translation table. Just find the number and screw in the wire.

Audio Connections (if your build has a speaker)

WireFrom (Old Dupont)To (Screw Terminal)Component
Red 3.3V header pin 3V3 terminal MAX98357A VIN
Black GND header pin GND terminal MAX98357A GND
Orange GPIO 15 header pin Terminal 15 I2S BCLK
Yellow GPIO 16 header pin Terminal 16 I2S LRC
Blue GPIO 17 header pin Terminal 17 I2S DIN

Start Gate Connections

WireTo (Screw Terminal)Component
Red 3V3 terminal IR Sensor VCC
Black GND terminal IR Sensor GND
Green Terminal 4 IR Sensor Signal
Teal Terminal 38 LiDAR TX (if equipped)
Teal Terminal 39 LiDAR RX (if equipped)

How to Connect a Screw Terminal

1️⃣

Strip the Wire

If using existing Dupont jumper wires: cut off the plastic Dupont connector, then strip about 5mm (¼ inch) of insulation from the end. The bare copper should be visible. If using new solid-core wire, strip the same length.

2️⃣

Open the Terminal

Use your small flathead screwdriver to turn the terminal screw counterclockwise until the slot is open wide enough for the wire. Don't unscrew it all the way — just loosen it.

3️⃣

Insert the Wire

Push the stripped end into the terminal slot. Only bare copper should go in — no insulation inside the terminal. If you see colored plastic in the slot, pull out and strip more.

4️⃣

Tighten the Screw

Turn the screw clockwise until the wire is firmly clamped. Give the wire a gentle tug — it should NOT pull out. If it does, tighten more.

🎮 "If you can pull it out, the bad guys can shake it out. Tighten it like you mean it."
Common Mistake
Don't overtighten. Screw terminals are small and the screws are tiny. If you feel strong resistance, stop — the wire is secure. Overtightening can strip the screw threads or break the terminal. Firm but not gorilla-grip.
4
Verify & Power On
~5 minutes • Moment of truth
▼
📷

Compare to Your Photo

Pull up the photo you took in Phase 1. Go wire by wire: red to 3V3? Check. Black to GND? Check. Green to Terminal 4? Check. Every wire must match. If something's different, fix it now — this is your last check before power.

🔎

Visual Inspection

Look for: bare wire touching another terminal (short circuit risk), loose wires that didn't get tightened, insulation stuffed into a terminal (no contact). Fix anything suspicious.

⚡

Power Up

Plug in the USB-C cable (or barrel jack power supply). Watch the ESP32 — the onboard LED should light up and start blinking. If you smell something burning or see smoke, UNPLUG IMMEDIATELY. No smoke? Great. Wait 10 seconds for it to boot.

Good signs
✓ LED blinks or turns solid
✓ WiFi network appears on your phone (if in AP mode)
✓ No unusual heat from any component
✓ Dashboard loads at the device's IP address
🔍

Run Diagnostics

Open the Build Wizard, select Finish Gate, scroll down to Verify Connection, enter the device IP, and hit RUN DIAGNOSTICS. You should see all green badges.

👥 Parent tip: If diagnostics show the IR sensor as "LOW" when nothing is blocking it, the signal wire might be in the wrong terminal. Check Terminal 4.
5
The Shake Test
~5 minutes • The fun part
▼
🤚

The Gentle Shake

With the device powered on and working, pick up the whole shield assembly (carefully, holding the shield edges — not the wires). Give it a gentle shake. Look at the dashboard — still connected? Still showing data? Good.

💪

The Real Shake

Now shake it like a 10-year-old accidentally kicked the table the track is sitting on. Because that will happen. Multiple times. During the most important race of the day. If the dashboard drops connection or a wire comes loose, tighten that terminal and try again.

🎮 "Shake it like you're trying to wake up a sleeping cat. If nothing falls off, you win."
🏁

Run a Test Race

The ultimate test: arm the track, roll a car through the beam, and confirm the race timer works. If you get a time reading, congratulations — migration complete!

Victory Lap
You just upgraded your M.A.S.S. Trap from prototype to production-grade. The screw terminals won't wiggle loose. The barrel jack means no USB cable dangling. This thing is built to survive science fairs, staircase races, and siblings.

🔧 Troubleshooting

🔴

"The ESP32 doesn't turn on after seating in the shield"

Check that all 38 pins are fully seated. Remove the ESP32 from the shield, inspect for bent pins, re-seat. Also verify your power source — USB cable plugged in? Barrel jack connected?

🔴

"IR sensor shows LOW when nothing is blocking the beam"

The signal wire is probably in the wrong terminal. Verify it's in Terminal 4 (not terminal 3 or 5). Also check that the IR emitter and receiver are actually facing each other and powered (red wire to 3V3, black to GND).

🔴

"The device boots but WiFi doesn't connect"

The shield doesn't affect WiFi. This is the same behavior the device had before migration. If WiFi was working before and isn't now, check that the ESP32 is fully seated (poor contact on antenna pins can weaken the signal). Also check that no wire is touching the ESP32's WiFi antenna area (the part that overhangs the PCB edge).

🔴

"A wire keeps falling out of the screw terminal"

Either not enough bare copper is exposed (strip more insulation) or the wire gauge is too thin. Try folding the stripped tip in half to make it thicker, then re-insert and tighten. Solid-core wire holds better than stranded in screw terminals.

🔴

"I smelled something burning!"

Unplug immediately. Don't panic. Common causes: (1) power and ground swapped (red/black in wrong terminals), (2) bare wire touching an adjacent terminal (short circuit), (3) wrong voltage (5V where 3.3V expected). Check every connection against the table. Fix the mistake. Components may or may not have survived — power up again after fixing and check diagnostics.

🏆 ALL DEVICES MIGRATED!

Every wire is locked down. Every terminal is tightened. The M.A.S.S. Trap fleet is production-grade.

The Dupont wires are now spare parts. Keep them — they're perfect for prototyping the next module.

Build Wizard • M.A.S.S. Trap • GitHub • Parts Store