Video card V1.0 — bring-up plan¶
The plan for getting a picture out of the built V1.0 card, from the bench checks to the console mirrored on a monitor.
Written 2026-10-10. The card's theory of operation is docs/cards/video.md; this document is the
order of work and the tools for each step.
Where the card stands¶
Phase A done, 2026-10-21: a picture with the CPU out. The card in the machine (the $D000 block, SV3 5-6) has every
chip fitted, the reworks below, an 11.0592 MHz crystal in Q2 with SV4 on 1-2, and the remapped character EPROM in
IC25. Through the bus tester: memory_status ALL OK with the card in, the whole 2K of display RAM passes,
crtc_regs.py ALL PASS (an MC6845), and crtc_picture.py puts the test card on a TV-rate monitor. The first crystal
was 9 MHz: at 80 columns the monitor cut about 4 characters off each edge (it shows about 72 of the 80), and 64 x 24
(R0..R9 = 94,64,75,8,31,6,24,27,0,7) sat centred. An 11.0592 MHz crystal then gave 80 x 24 with even margins:
R0..R9 = 116,80,94,9,31,6,24,27,0,7 (15.75 kHz / 60.1 Hz). That table is the standard: ROM 2026-10-21 (built,
not burned), testcard.asm and crtc_picture.py.
The card's reworks and fits, in the order they were found (docs/cards/video.md sections 4 and 5):
- The +5V/VCC rails joined by a wire (2026-09-21); RN2 back to 10k.
- RS to ADDR1: IC17 pin 24 bent out and wired to IC15 pin 41 (hardware/cards/video/docs/fix-6845-register-select.md).
- 6.1, E one-shot: 10k from IC27 pin 12 (N$3) to pin 14. C1 is 1 µF, so E lasts about 12 ms on a slow strobe:
the bus tester's per-command read samples after E has ended, so crtc_regs.py reads the 6845 with the firmware's
RDBLK instead (2026-10-21).
- The open-collector enables: 4.7k from IC2 pin 1 to pin 20 (N$16, the latch's -OC) and from IC27 pin 8 to pin 14
(N$5, /A0), 2026-10-21. Without the first the JP1 latch drove the data bus on every memory read in the machine.
IC2 is a 74LS373 (a 74LS374 was in its socket until 2026-10-21).
- 6.2, CHARCLOCK runt: resolved 2026-10-18 with IC28 a 74163 (synchronous clear): dot ÷ 6, a full one-dot
CHARCLOCK, and the 74LS166's sixth dot a blank column between characters. Register tables use ÷ 6
(tools/vidsim.py does by default).
- 6.5, LPSTB (IC17 pin 3) tied to pin 1 (GND).
- The video output's pull-up is already there: DB9 pin 7 (IC27/A) is pulled up through R11 (33 Ω) and R12 (270 Ω);
the RCA jack carries video and sync combined (docs/cards/video.md 3.6).
Why 11.0592 MHz: 80 characters must fit the 43-44 µs a TV-rate monitor shows with margins, about 0.54 µs a
6-dot character. 11.0592 MHz gives a 1.84 MHz character clock (the MC6845 is rated to about 2.5 MHz) and leaves the
character EPROM about 540 ns (the MBM2732A is a 450 ns part); 10.738635 MHz also fits, with less margin; 12 MHz leaves
the EPROM about 500 ns, too tight. A 9 MHz crystal fits 64 columns (the table above). Other tables: an IBM 5151 needs
18.4 kHz / 50 Hz (tools/vidsim.py timing checks any).
The tools¶
| Tool | Where it runs | What it does |
|---|---|---|
tests/video/video_ram_test.py |
bus tester, CPU out | display RAM $D000-$D3FF, patterns, isolation, write-through (2026-09-21) |
tests/video/crtc_regs.py [--gap S] |
bus tester, CPU out | the latch, R14/R15 write and read back, repeated accesses (finding 6.1), R12/R13 readability |
tests/video/crtc_picture.py [--regs ..] [--png] |
bus tester, CPU out | writes the test card and programs the 6845, then lets go: a picture with no CPU |
tests/video/hold_address.py D800 [--rd] |
bus tester, CPU out | parks an address for the meter (-CS, RS, E pins) |
tests/video/asm/vram.img |
CPU, monload.py --go 3000 |
the whole 2K at full speed, four patterns |
tests/video/asm/crtcreg.img |
CPU | the register path at full speed, 256 back-to-back accesses |
tests/video/asm/testcard.img |
CPU | programs the 6845 from a table at $3003 (patch it with E 3003), draws the test card |
tests/video/asm/vstress.img |
CPU (after testcard) | rolls the whole screen through the character set while the 6845 reads it; any key stops it |
tests/video/asm/estrobe.img |
CPU | an endless loop of 6845 accesses for the scope (reset stops it) |
the monitor's V commands |
CPU | VS VF VD VC VW VB VR VI VM (docs/cards/video.md section 8) |
tools/vidsim.py |
the Mac | the picture the card makes, from the emulator, a state file or the real card's RAM; timing for any crystal; the character EPROM image |
The bus-tester scripts need the bus-driver firmware on the tester (embedded/bus-tester/bus-driver; the bus-stepper
or bus-monitor is on it otherwise - embedded/bus-tester/README.md). They were written 2026-10-10 against the same
tools/busdrv.py calls as the memory and register tests; all of them ran on the machine on 2026-10-21.
Phase 0 — at the bench, power off¶
- Read the crystal Q2 and SV4 (pin 1-2 = the crystal is the dot clock, 2-3 = half of it). (Done: Q2 was
empty; a 9 MHz crystal went in on 2026-10-21, then the same day an 11.0592 MHz one; SV4 on 1-2.) That gives the dot
clock.
python3 tools/vidsim.py timing --dotclock HZshows what the ROM's table makes of it. - Read the character EPROM (IC25, a 2732) in the TL866:
Draw it with
minipro -p 2732A@DIP24 -r chargen-read.bintools/vidsim.py render ... --chargen chargen-read.bin(orrun tests/video/asm/testcard.img --chargen chargen-read.bin --png card.png). The card uses the low 512 bytes: code × 8 + row, dots in D7..D3. If it is blank, foreign or wired differently, burnfirmware/video/chargen.bin(a 2513-style 64-character set drawn for this wiring). Done 2026-10-18: the fitted chip is a 128-character ASCII set whose letters sit at $200-$2FF, beyond the card's reach (A9 grounded): letters would show blank.firmware/video/chargen-remapped.binis its own font moved into the card's layout (firmware/video/README.md) - burned 2026-10-20 into a Fujitsu MBM2732A on the T48 (21 V, 1 ms pulse; verified): fit it as IC25. To burn another:minipro -p MBM2732A@DIP24 -o vpp=21 -o pulse=1000 -w firmware/video/chargen-remapped.bin - The RS fix: bend the 6845's pin 24 out and wire it to IC15 pin 41 (ADDR1), as in
hardware/cards/video/docs/fix-6845-register-select.md. Fit the 6845. - Recommended before powering, each a single wire or part:
- 10k from IC27 pin 12 to +5V (finding 6.1)
- 4.7k from IC2 pin 1 to pin 20 and from IC27 pin 8 to pin 14 (the open-collector nets N$16 and N$5) - fitted 2026-10-21: without the N$16 pull-up the JP1 latch drives the data bus on every memory read in the machine
- IC17 pin 3 (LPSTB) to GND (6.5)
Without the 10k, phase A step 2 shows whether 6.1 bites.
Phase A — the bus tester, CPU out¶
Sequencer card out, bus tester in with the bus-driver firmware, the clock irrelevant (the 6845 runs on the card's own crystal).
python3 tests/memory/memory_status.py --rom <the chip's image>andpython3 tests/video/video_ram_test.py --quick: the memory card and the display RAM as before.python3 tests/video/crtc_regs.py:- ALL PASS: the register path works (-CS, RS on A1, E). Passed 2026-10-21 (MC6845; C1 = 1 uF).
- R14/R15 read 00 or FF: the 6845 does not answer.
hold_address.py D800andD802with a meter: IC17 pin 25 (-CS) low at both, pin 24 (RS) low at $D800 and high at $D802. With--rdand a scope, look at pin 23 (E). - Repeat failures that go away with
--gap 0.5: finding 6.1 (fit the 10k on IC27 pin 12). - R12/R13:
00 00= a Motorola MC6845,12 34= a part that reads them. Both are fine. python3 tests/video/crtc_picture.py --png expected.png --verify: the test card in the RAM and the 6845 programmed (the 80 x 24 table at 11.0592 MHz by default); the tester lets go and the 6845 keeps scanning. Done 2026-10-21: the picture on a TV-rate monitor, centred. With a scope:- DOTCLOCK at SV4 pin 2.
- CRTCCLOCK at IC17 pin 21: dot/6 (1.8432 MHz).
- CHARCLOCK at IC19 pin 8: a one-dot low pulse each character.
- HSYNC at IC17 pin 39: the line rate the timing report gives.
- VSYNC at pin 40: the frame rate.
- DE at pin 18.
- The dots at IC24 pin 13.
- The video at DB9 pin 7.
tools/vidsim.py timing prints the expected rates. --png draws what the monitor should show, and
tools/vidsim.py render STATE --raster draws the whole frame with the sync and blanking periods, for comparing
with the scope.
4. A monitor on the DB9 (see "Monitors"). Nothing at all: the sync rates against the monitor's. Sync but a blank
screen: the dots (6.2, the EPROM, DE). Garbage characters: the EPROM's contents or the code/row wiring (A3..A8 / A0..A2).
5. To change the timing without the CPU: crtc_picture.py --regs 94,64,75,8,31,6,24,27,0,7 with the numbers that
vidsim.py timing --regs ... approves.
Phase B — the CPU, at speed¶
Sequencer card back, the bus tester on bus-monitor or bus-stepper, the clock at 1 MHz (then try 6 MHz). Each program
is loaded with python3 tools/monload.py --delay 6 --go 3000 tests/video/asm/NAME.img. Its expected output on the
microcode emulator is checked in make check (tests/video/asm/run.py).
vram.img: four passes over all 2K, each endsERRORS 0000. Run it twice, with the 6845 stopped (before any CRTC programming) and running (after testcard). An error only with the 6845 running points at the IDT7134's arbitration. Passed 2026-10-21 (4 passes, 0 errors).crtcreg.img: failed at speed 2026-10-21 (every register FF) until IC1 pin 2 was tied to VCC (finding 6.1: the E one-shot never recharged); then passed. R14 and R15OK,REPEAT R15 X256: 0000 FAILED OK, R12/R13 as in phase A. Here the accesses are microseconds apart, so finding 6.1 shows harder than with the tester.testcard.img: the test card on the monitor. Its table is at $3003-$3012. Change a register with the monitor (E 3003, new bytes, Esc) andG3000again. The expected picture ispython3 tools/vidsim.py run tests/video/asm/testcard.img --png card.png: 80 x 24, a blank dot column between characters (IC28 a 74163 divides by 6). Passed 2026-10-21: the card on the monitor, programmed by the CPU.vstress.img, after testcard: the text rolls through every code and row 23 counts the passes. Watch for snow or characters that stay wrong (the two ports at once). Any key returns to the monitor. Passed 2026-10-21: no snow, the count kept rising.estrobe.imgwith the scope on IC17: -CS (pin 25) low for each access, RS (pin 24) low then high, E (pin 23) at least 450 ns (280 ns on faster grades) every time. Reset stops it.- The ROM's driver:
VS,VI(the ROM's table),VC,VW0000 HELLO, thenVM1. From then on the console's output appears on the screen too (docs/cards/video.mdsection 8). Passed 2026-10-21:VI(CRTC 01),VW0000 HELLO FROM THE YACC1at the top,VM1mirrored the monitor's output onto the screen. - When all of it works:
VIDAUTO EQU 1infirmware/monitor/monitor.asm, rebuild, burn. The card starts at reset. If the timing changed, put the new table invcrtabtoo.
Away from the machine¶
python3 tools/vidsim.py run tests/video/asm/testcard.img --png card.png: runs any program on the microcode emulator and draws the screen it leaves, with the timing report.--rasterdraws the whole frame,--chargen FILEuses a real EPROM image,--dotclock HZsets the crystal.python3 tools/vidsim.py timing --regs R0,R1,... --dotclock HZ: the raster any register table makes, checked against a TV-rate monitor, an IBM 5151 and an IBM 5153.python3 tools/vidsim.py testcard --png card.png: the test card with the card's own table.--card v1.3 --dots 6(80 x 24) or--dots 8(64 x 24, the 7-dot font) draws the v1.3 design's two modes (12 MHz, the DOTS jumper;BACKLOG.md"Video v1.3");vidsim.py chargen --card v1.3writes its two-font EPROM,firmware/video/chargen-v13.bin.python3 tools/vidsim.py timing --card v4(alsochargen,testcard,render): the V4 design (docs/cards/video-v4.md), 80 x 25 of 8 x 16 at 640 x 480, 60 Hz;--v4raster 70takes its 640 x 400, 70 Hz table. The V2.0 design'soverlay --card v2.0mode was removed with that design on 2026-11-18.- Both emulators model the card (
software/videomodel.h): -Vprints the screen.-Wlogs every CRTC write, and every write to the latch (a bus fight on the real card).-Ntakes the card away.Y1VIDSTATE=FILEwith-Vsaves the state thatvidsim.py renderdraws.Y1VID_R12READ=1models a 6845 that reads R12/R13.python3 tests/video/asm/run.pyandtests/video/emu.pycheck it all (both inmake check).
Monitors¶
The card's DB9 is wired MDA-style: pin 7 video, 8 HSYNC (positive), 9 VSYNC (positive), 1 GND. The video output is an open-collector 7416, pulled up through R11 and R12. The ROM's table is TV-rate: 15.75 kHz and 60.1 Hz from the 11.0592 MHz crystal, 80 x 24 (a TV-rate monitor showed it with even margins on 2026-10-21).
| Monitor | What it needs | With this card |
|---|---|---|
| a TV-rate TTL monitor, or a composite one through the RCA (video and sync combined) | 15.7 kHz, 60 Hz | the ROM's table: 80 x 24 at 11.0592 MHz, proven 2026-10-21 (64 x 24 with a 9 MHz crystal) |
| IBM 5153 (CGA colour) | 15.7 kHz / 60 Hz, TTL R G B I on DB9 3-6, +H 8, +V 9 | timing fits; the card's video is on pin 7, so an adapter must take it to a colour pin (e.g. 4, green) |
| IBM 5151 (MDA mono) | 18.432 kHz / 50 Hz, video 7, intensity 6, +H 8, −V 9 | the line rate needs a new table (at 11.0592 MHz: 99,80,82,9,45,1,25,40,0,7, 80 x 25, 18.432 kHz / 49.95 Hz; not tried). The VSYNC polarity is wrong (the 6845's is positive), so it may need inverting. A real MDA picture (9-dot characters, 720 dots) is the next revision's job |
tools/vidsim.py timing reports the match for each.
When it misbehaves¶
| Symptom | Look at |
|---|---|
VIDEO CARD FOUND missing at reset |
the $55/$AA probe at $D000: E D000 by hand; docs/cards/video.md section 6 |
| vram.img errors only in $D400-$D7FF | the upper 1K, never tested before: A10 (IC15 pin 40) |
| vram.img errors only with the 6845 running | the dual-port arbitration; -BUSY is not used on this card |
| R14/R15 read 00 or FF | -CS, RS (the bench fix), E: phase A step 2 |
| registers write once, then not | finding 6.1: the 10k on IC27 pin 12 |
| sync right, screen blank | finding 6.2 (CHARCLOCK at IC19 pin 8 against DOTCLOCK), the EPROM, DE at IC17 pin 18 |
| characters wrong but stable | the EPROM's contents (vidsim.py --chargen), IC23 (the code latch), RA0..2 |
| everything inverse or a solid bar | bit 7 of the bytes (inverse), the cursor registers R10/R11 |
| picture rolls or tears | the sync rates against the monitor (vidsim.py timing), R0-R7 |
| snow while vstress runs | dual-port contention on the IDT7134 |
Note: the ROM's comment calls R10 = $67 "blinking 1/16"; bits 6-5 = 11 is the 1/32 rate (harmless).
Last updated 20 November 2026