AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

legacy-circuit-mockups

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.

Original source
github
License
MIT
Pinned revision
5269f7ea2d6c3a9bfda5ed878b6726cf509121fd

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

Ask your assistant

Use Agentic Memory skills to read github--legacy-circuit-mockups at revision 5269f7ea2d6c3a9bfda5ed878b6726cf509121fd, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 21

references/emulator-6522.md

6522 VIA (Versatile Interface Adapter) Emulation Specification

A technical Markdown specification for emulating the MOS Technology / WDC 6522 VIA, suitable for 6502-family emulators, SBC simulators, and retrocomputing software environments.


1. Scope

This document defines the functional behavior required to emulate:

  • MOS Technology 6522 VIA
  • WDC 65C22 VIA (CMOS variant, where noted)

Out of scope:

  • Analog electrical characteristics
  • Bus contention and propagation delay
  • Undocumented silicon race conditions

2. Chip Overview

Core Features

| Feature | Description | | ---------------- | ------------------------------------ | | I/O Ports | Two 8-bit bidirectional ports (A, B) | | Timers | Two programmable timers | | Shift Register | 8-bit serial shift register | | Interrupt System | Maskable, prioritized | | Handshaking | CA1/CA2, CB1/CB2 control lines |


3. External Signals (Logical Model)

| Signal | Direction | Purpose | | -------- | --------- | ------------------------ | | PA0-PA7 | I/O | Port A | | PB0-PB7 | I/O | Port B | | CA1, CA2 | I/O | Control lines A | | CB1, CB2 | I/O | Control lines B | | IRQ | Output | Interrupt request to CPU | | CS1, CS2 | Input | Chip select | | R/W | Input | Read / write | | RS0-RS3 | Input | Register select |


4. Register Map

Registers are selected using RS3-RS0.

| Address | Name | R/W | Description | | ------- | ----------- | --- | -------------------------------- | | 0 | ORB / IRB | R/W | Output/Input Register B | | 1 | ORA / IRA | R/W | Output/Input Register A | | 2 | DDRB | R/W | Data Direction Register B | | 3 | DDRA | R/W | Data Direction Register A | | 4 | T1C-L | R | Timer 1 Counter Low | | 5 | T1C-H | R | Timer 1 Counter High | | 6 | T1L-L | W | Timer 1 Latch Low | | 7 | T1L-H | W | Timer 1 Latch High | | 8 | T2C-L | R | Timer 2 Counter Low | | 9 | T2C-H | R | Timer 2 Counter High | | 10 | SR | R/W | Shift Register | | 11 | ACR | R/W | Auxiliary Control Register | | 12 | PCR | R/W | Peripheral Control Register | | 13 | IFR | R/W | Interrupt Flag Register | | 14 | IER | R/W | Interrupt Enable Register | | 15 | ORA (no HS) | R/W | Output Register A (no handshake) |


5. Data Direction Registers

  • Bit = 1  Output
  • Bit = 0  Input
output = ORx & DDRx
input  = external & ~DDRx

6. Port Behavior

Read

  • Returns input pins for bits configured as input
  • Returns output latch for bits configured as output

Write

  • Updates output latch only
  • Actual pin value depends on DDR

7. Timers

Timer 1 (T1)

  • 16-bit down counter
  • Can generate interrupts
  • Optional PB7 toggle

Timer 2 (T2)

  • 16-bit down counter
  • One-shot or pulse counting (CB1)

Timer Emulation Rules

  • Decrement once per CPU cycle
  • Reload from latch when appropriate
  • Set interrupt flag on underflow

8. Shift Register (SR)

Modes controlled via ACR:

  • Disabled
  • Shift in under CB1 clock
  • Shift out under system clock

Emulator requirements:

  • 8-bit shift
  • Correct bit order
  • Optional external clock handling

9. Control Registers

Auxiliary Control Register (ACR)

Controls:

  • Timer 1 mode
  • Timer 2 mode
  • Shift register mode
  • PB7 behavior

Peripheral Control Register (PCR)

Controls:

  • CA1/CB1 edge sensitivity
  • CA2/CB2 handshake / pulse / output modes

10. Interrupt System

Interrupt Flag Register (IFR)

| Bit | Source | | --- | -------------------------- | | 0 | CA2 | | 1 | CA1 | | 2 | Shift Register | | 3 | CB2 | | 4 | CB1 | | 5 | Timer 2 | | 6 | Timer 1 | | 7 | Any interrupt (logical OR) |

Interrupt Enable Register (IER)

  • Bit 7 = set/clear mode
  • Bits 0-6 enable individual sources

IRQ Logic

IRQ = (IFR & IER & 0x7F) != 0

11. Handshaking Lines

CA1 / CB1

  • Edge-detect inputs
  • Trigger interrupts

CA2 / CB2

  • Input or output
  • Pulse or handshake modes

Emulator must:

  • Track pin state
  • Detect configured edges

12. Reset Behavior

On reset:

  • DDRx = $00
  • ORx = $00
  • Timers stopped
  • IFR cleared
  • IER cleared
  • IRQ inactive

13. Read/Write Side Effects

| Register | Side Effect | | ----------- | ------------------------ | | ORA/ORB | Clears handshake flags | | T1C-H write | Loads and starts Timer 1 | | IFR write | Clears written bits | | IER write | Sets or clears enables |


14. Emulation Timing Levels

| Level | Description | | -------------- | ------------------------- | | Functional | Correct register behavior | | Cycle-based | Timers tick per CPU cycle | | Cycle-accurate | Matches real VIA timing |


15. Integration with 6502 Emulator

CPU cycle  VIA tick  update timers  update IRQ
  • VIA must be clocked in sync with CPU
  • IRQ line sampled by CPU at instruction boundaries

16. Testing and Validation

Recommended Tests

  • VIA timer test ROMs
  • Port read/write tests
  • Interrupt priority tests

Validation Checklist

  • Timers count correctly
  • IRQ asserts and clears properly
  • DDR behavior correct
  • Side effects implemented

17. Differences: 6522 vs 65C22 (Summary)

| Feature | 6522 | 65C22 | | -------------- | ------ | -------- | | Power | Higher | Lower | | Decimal quirks | N/A | Fixed | | Timer accuracy | NMOS | Improved |


18. Reference Links


Document Scope: Software emulation of the 6522 VIA Audience: Emulator developers, SBC designers Status: Stable technical reference