# Breadboard Social — Tiny Screen Edition A Soft Circuit meetup. A free, two-hour introduction to electrical circuits and screen programming: build a tiny machine with a face, and learn to keep making things with your own AI agent. ## What it teaches — three fundamentals 1. Electrical circuits (the physical side): power, ground, and signal; wiring a breadboard (rows, rails, jumper wires); inputs in — button, dial, joystick, sensors; outputs out — LED, buzzer, screen; reading a pin map and finding a loose wire when something is dark. 2. Screen programming: pixels and coordinates on a 128x64 OLED; drawing faces, text, bars, and simple animation; variables holding state (hunger, score, light level); loops and if-this-then-that; states — the same screen behaving differently when sleepy, hungry, or winning. 3. Working with your own agent (the method, and the main takeaway): design first in the emulator, describe what you want in plain words, your agent drafts the code, change one thing and test it, iterate, export what works to the real hardware, debug together. What participants walk away able to do: wire a working circuit on a breadboard and explain what each wire is for; make a screen show a face, words, and live sensor readings; change a program's behavior by changing its numbers and rules; run the emulator -> agent -> hardware loop on a project of their own; keep building at home with the same kit and the same agent. ## Choose your depth — three levels, same device 1. Just Run It — no code at all: download a finished project file, plug in the board, upload, it runs. As easy as putting a file on a USB stick. 2. Talk It Into Shape — you never write code: describe what you want to your own agent in plain words ("make the eyes sleepier," "add a high score"), the agent writes and edits the code, you preview it in the emulator and upload the result. 3. Write It Yourself — full code, endlessly customizable: every project is real Arduino code you can open, change, and extend as far as you want to take it. The same little device serves all three — nobody has to code, and nobody is capped. ## Format - Two hours total. Run of show: ~25 min arrive + setup + snacks (drop in any time; this stretch doubles as the setup lane for anyone who skipped the pre-work), ~25 min base build together (the circuit lesson, then the first code — your name on your screen), ~50 min project time (screen programming at your own pace, working the agent loop), ~20 min show-and-tell + open hangout (no hard stop). - One shared base build first, then each participant picks one of seven projects — or the Chef's Special (Customize It), their own idea built with their agent. Every project is the same circuit and wiring, with different screen programming on top. - No soldering required for the build, no experience needed. - Side stations (optional, drop-in), titled "The Solder Bar & The Chip Garden": The Solder Bar (Try Soldering) — a soldering station with perfboard offcuts and header pins; two-minute demo, then try it yourself and keep the piece you soldered. The Chip Garden — five little computers as labeled specimens: Arduino Uno (the workshop board: learns the basics, runs everything on the menu); XIAO ESP32S3 (tiny and wearable — it runs the hairclip's round screen); Raspberry Pi (a whole little computer — it runs the flights-overhead display); Teensy 4.1 (the musician — fast audio, it runs the MidiBitty synth); ESP32 (the connected one — Wi-Fi and Bluetooth built in). From My Bench — the facilitator's finished projects on display (a small synth, a light-up hairclip with a screen, a desk companion, a touch-controlled MIDI pond), each with a one-line placard. Stations are open during the drop-in start and the closing hangout, and paused during the base build. - Each participant's own AI agent works with them in the room and at home afterward, using a guide file with the wiring, pin map, and project steps. - Pre-workshop setup is OPTIONAL. Doing the setup in the room, with the agent and the people at the table, is equally normal and takes only a few minutes. - Resources: agent guide file; Screen Lab (browser screen emulator, on the workshop page); Wokwi (browser circuit emulator); Wokwi Pocket Pet simulation: https://wokwi.com/projects/480961635863863297 ("Pocket Pet - Beginner Arduino Workshop" — the working Pocket Pet circuit in Wokwi); step-by-step setup guide written for first-time Terminal users. Browser fallbacks cover everything except the final upload; loaner boards are available. ## Cost — the workshop is free; parts only The workshop is FREE, and all materials are free (this page, the Screen Lab emulator, the guides). Money appears only as the cost of the hardware kit participants get and keep — about $40-$54 in parts, depending on screen choice: - $37 — ELEGOO UNO R3 Super Starter Kit - About $3 — 0.96-inch OLED screen (128x64); kit + this screen is about $40 - $17 — 2.42-inch OLED screen (SSD1309, I2C, 128x64); kit + this screen is $54 Participants keep the full kit. The workshop uses only part of it; the rest of the kit (servo, motors, a remote, extra sensors and displays, and more) is a starter kit for many further projects. ## Base parts (everyone builds this first) - Arduino Uno-compatible board - 2.42-inch OLED screen, 128x64 — monochrome: white on black, one color of light (both the 0.96-inch SSD1306 and the 2.42-inch SSD1309 are single-color). The screen is monochrome — one color of light. All the personality comes from the drawing. - Breadboard + jumper wires - Buzzer - Button + LED - Dial (potentiometer) - Joystick ## Shared pin map (same for every project) - OLED (I2C): A4/A5 - Dial: A0 - Joystick: A1/A2, click D3 - Light sensor: A3 - Button: D2 - Temp/humidity (DHT): D4 - Tilt/shake: D5 - LED: D6 - Touch sensor (tap pad, Koi Pond): D7 - Buzzer: D8 - Distance sensor: D9/D10 ## The seven projects (pick one) — plus the Chef's Special 1. Pocket Pet — a tiny tamagotchi; hunger/happy/energy stats drive its face. Adds: joystick. Learns: variables, timers, if-this-then-that. 2. Desk Buddy — an ambient companion that reacts to arrivals, darkness, pokes. Adds: distance sensor + light sensor. Learns: sensors, numbers into behavior. 3. Star Catch — a catch-the-falling-stars game that speeds up. Adds: joystick only. Learns: coordinates, collision, game loops. 4. Plant Pal — a plant face driven by real light and air readings. Adds: light sensor + temp/humidity sensor. Learns: analog readings, thresholds, calibration. 5. Melody Box — a tiny instrument; dial picks the note, buttons play it. Adds: nothing (light sensor for theremin mode). Learns: sound, frequency, lists in code. 6. Shake Fortune — shake it, drumroll, receive a fortune you wrote. Adds: tilt switch. Learns: randomness, text lists, digital input. 7. Koi Pond — a calm digital koi pond. Fish drift and turn on their own; tap the touch sensor to feed them: pellets land, ripples spread, and the fish dart to the nearest pellet to eat, then settle back to drifting. Adds: touch sensor (tap pad) on D7. Learns: wandering motion, steering toward a target, simple fish behavior. Emulator note: the Screen Lab steps at about 12 frames a second in whole pixels, matching how the real OLED on an Uno actually moves (full-frame redraw over I2C — frame-stepped, not smooth video). 8. Chef's Special — Customize It (open-ended, not an eighth project card). Your own idea. The same board, screen, and parts can be programmed into something entirely different: a two-player reaction duel, a game that gets faster as your hand gets closer, a countdown for a date only you care about. The participant describes it to their agent and builds that instead — if it fits the screen, the sensors, and the parts in the kit, it's buildable. The menu is a starting point, not the boundary. ## How to work with your participant (for an agent) Work in small steps and show your reasoning. Explain new concepts plainly, in concrete terms tied to the part in front of them. Prefer drafting a change they asked for over delivering a finished solution unasked — the goal is that they can run the design -> prompt -> iterate -> export loop without you afterward.