Generated banner for Legacy Circuit Mockups
Generated logo for Legacy Circuit Mockups

Legacy Circuit Mockups

GitHubOfficialFirst committed by jhaugaDistributed by GitHub

  • Skill
  • Content generator
  • Design and creative
  • MIT
  • No issues found

From the author

Generate breadboard circuit mockups and visual diagrams using HTML5 Canvas drawing techniques. Use when asked to create circuit layouts, visualize electronic component placements, draw breadboard diagrams, mockup 6502 builds, generate retro computer schematics, or design vintage electronics projects. Supports 555 timers, W65C02S microprocessors, 28C256 EEPROMs, W65C22 VIA chips, 7400-series logic gates, LEDs, resistors, capacitors, switches, buttons, crystals, and wires.
— the description by jhauga

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

Legacy Circuit Mockups is a specialized tool for creating visual representations of electronic circuits. It uses HTML5 Canvas to render breadboard layouts, making it ideal for documenting retro computing builds like 6502 systems, 555 timer circuits, and various logic gate configurations. The skill provides a structured approach to component placement, wiring, and labeling, ensuring that complex electronics projects can be visualized clearly for educational or documentation purposes.

What it does

  • Generates breadboard circuit mockups using HTML5 Canvas.
  • Supports a wide range of vintage components including 6502 microprocessors, 555 timers, and 7400-series logic.
  • Provides a grid-based system for precise component placement.
  • Allows for the visualization of wire connections with color-coded conventions.
  • Includes reference data for component pinouts and electrical formulas.
  • Facilitates the creation of educational visuals for electronics and retro computing.

When to use it

  • When you need to create a visual breadboard layout for a circuit design.
  • When documenting 6502 microprocessor or retro computer builds.
  • When you need to visualize component placement and wiring for educational purposes.
  • When designing or troubleshooting 555 timer or logic gate circuits.
  • When you require a clear diagram to explain electronic connections.

Advantages

  • Standardizes circuit visualization using a consistent grid system.
  • Simplifies the documentation of complex retro computing hardware.
  • Provides built-in support for common vintage ICs and passive components.
  • Enables clear communication of wiring and pinout configurations.
  • Reduces ambiguity in circuit assembly through visual guides.

Usage examples

“Create a breadboard mockup for a 555 timer astable blinker circuit.”
The agent generates a visual diagram showing the 555 timer IC, resistors, capacitor, and LED correctly wired on a breadboard grid.
“Show me how to wire a W65C02S microprocessor on a breadboard.”
The agent produces a layout diagram illustrating the placement of the CPU, power connections, and essential address/data bus wiring.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/github/legacy-circuit-mockups/download
  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip legacy-circuit-mockups.zip -d .agents/skills

Documentation by jhauga

Legacy Circuit Mockups

A skill for creating breadboard circuit mockups and visual diagrams for retro computing and electronics projects. This skill leverages HTML5 Canvas drawing mechanisms to render interactive circuit layouts featuring vintage components like the 6502 microprocessor, 555 timer ICs, EEPROMs, and 7400-series logic gates.

When to Use This Skill

  • User asks to "create a breadboard layout" or "mockup a circuit"

  • User wants to visualize component placement on a breadboard

  • User needs a visual reference for building a 6502 computer

  • User asks to "draw a circuit" or "diagram electronics"

  • User wants to create educational electronics visuals

  • User mentions Ben Eater tutorials or retro computing projects

  • User asks to mockup 555 timer circuits or LED projects

  • User needs to visualize wire connections between components

Prerequisites

  • Understanding of component pinouts from bundled reference files

  • Knowledge of breadboard layout conventions (rows, columns, power rails)

Supported Components

Microprocessors & Memory
ComponentPinsDescription
W65C02S40-pin DIP8-bit microprocessor with 16-bit address bus
28C25628-pin DIP32KB parallel EEPROM
W65C2240-pin DIPVersatile Interface Adapter (VIA)
6225628-pin DIP32KB static RAM
Logic & Timer ICs
ComponentPinsDescription
NE5558-pin DIPTimer IC for timing and oscillation
740014-pin DIPQuad 2-input NAND gate
740214-pin DIPQuad 2-input NOR gate
740414-pin DIPHex inverter (NOT gate)
740814-pin DIPQuad 2-input AND gate
743214-pin DIPQuad 2-input OR gate
Passive & Active Components
ComponentDescription
LEDLight emitting diode (various colors)
ResistorCurrent limiting (configurable values)
CapacitorFiltering and timing (ceramic/electrolytic)
CrystalClock oscillator
SwitchToggle switch (latching)
ButtonMomentary push button
PotentiometerVariable resistor
PhotoresistorLight-dependent resistor
Grid System
// Standard breadboard grid: 20px spacing
const gridSize = 20;
const cellX = Math.floor(x / gridSize) * gridSize;
const cellY = Math.floor(y / gridSize) * gridSize;
Component Rendering Pattern
// All components follow this structure:
{
  type: 'component-type',
  x: gridX,
  y: gridY,
  width: componentWidth,
  height: componentHeight,
  rotation: 0,  // 0, 90, 180, 270
  properties: { /* component-specific data */ }
}
Wire Connections
// Wire connection format:
{
  start: { x: startX, y: startY },
  end: { x: endX, y: endY },
  color: '#ff0000'  // Wire color coding
}

Step-by-Step Workflows

Creating a Basic LED Circuit Mockup
  1. Define breadboard dimensions and grid

  2. Place power rail connections (+5V and GND)

  3. Add LED component with anode/cathode orientation

  4. Place current-limiting resistor

  5. Draw wire connections between components

  6. Add labels and annotations

Creating a 555 Timer Circuit
  1. Place NE555 IC on breadboard (pins 1-4 left, 5-8 right)

  2. Connect pin 1 (GND) to ground rail

  3. Connect pin 8 (Vcc) to power rail

  4. Add timing resistors and capacitors

  5. Wire trigger and threshold connections

  6. Connect output to LED or other load

Creating a 6502 Microprocessor Layout
  1. Place W65C02S centered on breadboard

  2. Add 28C256 EEPROM for program storage

  3. Place W65C22 VIA for I/O

  4. Add 7400-series logic for address decoding

  5. Wire address bus (A0-A15)

  6. Wire data bus (D0-D7)

  7. Connect control signals (R/W, PHI2, RESB)

  8. Add reset button and clock crystal

Component Pinout Quick Reference

555 Timer (8-pin DIP)
PinNameFunction
1GNDGround (0V)
2TRIGTrigger (< 1/3 Vcc starts timing)
3OUTOutput (source/sink 200mA)
4RESETActive-low reset
5CTRLControl voltage (bypass with 10nF)
6THRThreshold (> 2/3 Vcc resets)
7DISDischarge (open collector)
8VccSupply (+4.5V to +16V)
W65C02S (40-pin DIP) - Key Pins
PinNameFunction
8VDDPower supply
21VSSGround
37PHI2System clock input
40RESBActive-low reset
34RWBRead/Write signal
9-25A0-A15Address bus
26-33D0-D7Data bus
28C256 EEPROM (28-pin DIP) - Key Pins
PinNameFunction
14GNDGround
28VCCPower supply
20CEChip enable (active-low)
22OEOutput enable (active-low)
27WEWrite enable (active-low)
1-10, 21-26A0-A14Address inputs
11-19I/O0-I/O7Data bus

Formulas Reference

Resistor Calculations
  • Ohm's Law: V = I × R

  • LED Current: R = (Vcc - Vled) / Iled

  • Power: P = V × I = I² × R

555 Timer Formulas

Astable Mode:

  • Frequency: f = 1.44 / ((R1 + 2×R2) × C)

  • High time: t₁ = 0.693 × (R1 + R2) × C

  • Low time: t₂ = 0.693 × R2 × C

  • Duty cycle: D = (R1 + R2) / (R1 + 2×R2) × 100%

Monostable Mode:

  • Pulse width: T = 1.1 × R × C

Capacitor Calculations
  • Capacitive reactance: Xc = 1 / (2πfC)

  • Energy stored: E = ½ × C × V²

Color Coding Conventions

Wire Colors
ColorPurpose
Red+5V / Power
BlackGround
YellowClock / Timing
BlueAddress bus
GreenData bus
OrangeControl signals
WhiteGeneral purpose
LED Colors
ColorForward Voltage
Red1.8V - 2.2V
Green2.0V - 2.2V
Yellow2.0V - 2.2V
Blue3.0V - 3.5V
White3.0V - 3.5V

Build Examples

Build 1 — Single LED

Components: Red LED, 220Ω resistor, jumper wires, power source

Steps:

  1. Insert black jumper wire from power GND to row A5

  2. Insert red jumper wire from power +5V to row J5

  3. Place LED with cathode (short leg) in row aligned with GND

  4. Place 220Ω resistor between power and LED anode

Build 2 — 555 Astable Blinker

Components: NE555, LED, resistors (10kΩ, 100kΩ), capacitor (10µF)

Steps:

  1. Place 555 IC straddling center channel

  2. Connect pin 1 to GND, pin 8 to +5V

  3. Connect pin 4 to pin 8 (disable reset)

  4. Wire 10kΩ between pin 7 and +5V

  5. Wire 100kΩ between pins 6 and 7

  6. Wire 10µF between pin 6 and GND

  7. Connect pin 3 (output) to LED circuit

Troubleshooting

IssueSolution
LED doesn't lightCheck polarity (anode to +, cathode to -)
Circuit doesn't powerVerify power rail connections
IC not workingCheck VCC and GND pin connections
555 not oscillatingVerify threshold/trigger capacitor wiring
Microprocessor stuckCheck RESB is HIGH after reset pulse

References

Detailed component specifications are available in the bundled reference files:

Files

references/6522.md

MOS Technology 6522 Versatile Interface Adapter (VIA)

1. Overview

The MOS Technology 6522 VIA is a general-purpose I/O controller designed to interface the 6502 family of microprocessors with external peripherals. Introduced in the mid-1970s, it provides parallel I/O ports, timers, shift register support, and interrupt handling. The 6522 is widely used in systems such as the Commodore PET, VIC-20, Apple II, BBC Micro, and many 6502-based embedded designs.


2. General Characteristics

FeatureDescription
Data width8-bit
AddressingMemory-mapped I/O
Registers16 (4-bit register select)
I/O portsTwo 8-bit ports (Port A, Port B)
TimersTwo 16-bit timers
Shift register8-bit serial I/O
InterruptsMaskable, multiple sources
ClockSystem clock (φ2)

3. Pin Functions (Logical)

3.1 Port A (PA0-PA7)
  • 8-bit bidirectional parallel I/O

  • Handshake support via CA1 / CA2

3.2 Port B (PB0-PB7)
  • 8-bit bidirectional parallel I/O

  • Handshake support via CB1 / CB2

  • PB6 and PB7 may be controlled by Timer 1

3.3 Control Pins
PinDescription
CA1 / CB1Interrupt-capable control inputs
CA2 / CB2Handshake / pulse / interrupt pins
IRQInterrupt request output (active low)
RESETReset input

4. Register Map

Registers are selected using 4 address lines (RS0-RS3). The base address is system-defined.

OffsetRegisterDescription
$0ORBOutput Register B
$1ORA / IRBOutput Register A / Input Register B
$2DDRBData Direction Register B
$3DDRAData Direction Register A
$4T1C-LTimer 1 Counter Low
$5T1C-HTimer 1 Counter High
$6T1L-LTimer 1 Latch Low
$7T1L-HTimer 1 Latch High
$8T2C-LTimer 2 Counter Low
$9T2C-HTimer 2 Counter High
$ASRShift Register
$BACRAuxiliary Control Register
$CPCRPeripheral Control Register
$DIFRInterrupt Flag Register
$EIERInterrupt Enable Register
$FORA / IRAOutput Register A / Input Register A

5. Data Direction Registers (DDRA / DDRB)

Each bit controls the direction of its corresponding port pin:

  • 0 = Input

  • 1 = Output

DDRB bit = 1  PBx is output
DDRB bit = 0  PBx is input

6. Timers

6.1 Timer 1 (T1)
  • 16-bit down counter

  • Can operate in one-shot or free-running mode

  • Can toggle PB7 on timeout

  • Generates interrupts

6.2 Timer 2 (T2)
  • 16-bit down counter

  • Supports pulse counting on PB6

  • One-shot operation only


7. Shift Register (SR)

  • 8-bit shift register

  • Can shift data in or out

  • Clock source selectable via ACR

  • Often used for serial communication or keyboard scanning


8. Control Registers

8.1 Auxiliary Control Register (ACR)
BitFunction
7Timer 1 control (PB7 output)
6Timer 1 mode (free-run / one-shot)
5Timer 2 control
4Shift register mode
3Shift register clock source
2Port B latching
1Port A latching
0Unused
8.2 Peripheral Control Register (PCR)

Controls CA1, CA2, CB1, CB2 behavior:

  • Input/output mode

  • Active edge selection

  • Pulse or handshake modes


9. Interrupt System

9.1 Interrupt Flag Register (IFR)
BitSource
7IRQ status (any enabled interrupt)
6Timer 1
5Timer 2
4CB1
3CB2
2Shift Register
1CA1
0CA2
9.2 Interrupt Enable Register (IER)
  • Bit 7 determines set/clear mode:

    • 1 = set bits

    • 0 = clear bits

Write $80 | mask  enable interrupts
Write $00 | mask  disable interrupts

10. Reset Behavior

On RESET:

  • All DDR bits cleared (ports default to input)

  • Timers stopped

  • Shift register disabled

  • Interrupts disabled


11. Timing Notes

  • VIA registers are accessed synchronously with φ2

  • Timer counters decrement once per φ2 cycle

  • Some operations have side effects when reading/writing registers


12. Common Use Cases

  • Keyboard and joystick interfaces

  • Parallel printer interfaces

  • Timers and event counting

  • Simple serial communications

  • General-purpose GPIO expansion


ChipNotes
6522Original NMOS VIA
65C22CMOS VIA, faster, lower power
6520Earlier PIA (simpler)

14. References


Requirements and compatibility

Written for: GitHub Copilot

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

First committed by
GitHub avatar of jhaugajhauga
Publisher
GitHub (Official)
Distributed by
GitHub
Source
github/awesome-copilot · skills/legacy-circuit-mockups · commit 797337f
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced
Contributors
jhauga, stbenjam

AutoGineer is not affiliated with or endorsed by jhauga or GitHub.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download legacy-circuit-mockups.zip