Memtest for the Commodore PET 2001 / CBM 3001 series
Go to file
s3lph ffcaf47395
/ build (push) Successful in 22s Details
feat: migrate from woodpecker to forgejo actions
2023-11-13 20:36:42 +01:00
.forgejo/workflows feat: migrate from woodpecker to forgejo actions 2023-11-13 20:36:42 +01:00
pics Add output interpretation image 2022-02-08 12:18:08 +01:00
src Add cycle limit to CI emulator test 2022-02-10 10:12:29 +01:00
.gitignore Restructure project, build 4K, 8K, 16K and 32K memtest variants 2022-02-07 09:41:15 +01:00
.woodpecker.yml Migrate from Gitlab CI to Woodpecker 2022-11-03 13:00:50 +01:00
LICENSE Add LICENSE 2022-02-08 11:27:03 +00:00
Makefile Add cycle limit to CI emulator test 2022-02-10 10:12:29 +01:00
README.md Fix typo 2022-02-08 12:25:24 +01:00

README.md

Commodore CBM 3001 Memtest

Memtest running on a Commodore CBM 3016, finding lots of faulty memory.

Memtest for the Commodore PET 2001 / CBM 3001 series

This is a memtest routine written in MOS 6502 assembly. Its purpose is to detect faulty RAM in Commodore PET 2001 / CBM 3001 computers.

In order to test the entire memory range, this routine must be executed directly when the CPU resets, i.e. if loaded e.g. via a BASIC SYS command, it will overwrite memory used by the BASIC interpreter and KERNAL, leading to undefined behaviour.

Instead, the test routine should be flashed to an ((E)E)PROM, which can then be inserted in the ROM socket mapped to $F000:$FFFF (the one which normally holds the KERNAL code).

The test routine only uses the 7 first bytes of memory to store its state, the entire remaining memory range starting at $0007 can be tested. The memory is tested in multiple passes, using different patterns.

USE AT YOUR OWN RISK

Getting Started

  • Install the xa65 toolchain.
  • Clone this repository.
  • Run make. This will produce (among other) the following files in the out/ directory:
    • memtest*k-f000.901465.bin: 4K, 8K, 16K and 32K variants of the binary you'll later flash to an ((E)E)PROM.
    • memtest4k-f000-ascii.emu6502.bin: The same code, but text is rendered as ASCII instead of PETSCII. Used by the emulator.
    • emu6502: A MOS 6502 emulator for testing.

Testing in the Emulator

The emulator uses Fake6502 to emulate the MOS 6502 CPU. The following memory regions are mapped into the emulator's address space, compatible with the PET 2001 / CBM 3001 memory map:

  • $0000:$0fff: RAM with simulated failures (4K only for faster testing)
  • $8000:$8fff: Video buffer, printed to stdout after each instruction
  • $f000:$ffff: The memtest-f000.901465+ascii.bin ROM

Run out/emu6502.

Run on a Real PET / CBM

  • Figure out how much memory your device has. Choose the appropriate image (memtest4k, memtest8k, memtest16k or memtest32k).
  • Flash the out/memtest*k-f000.901465.bin image to a ((E)E)PROM compatible to the MOS 901465 ROM chip.
    • Most parallel ROMs of at least 4KiB should be usable, just short the excess uppermost address pins to GND and ensure pin compatibility, e.g. through an adapter PCB.
  • Remove the KERNAL ROM (the one mapped to $f000:$ffff) from your PET / CBM.
  • Place the memtest ROM into the same socket.
  • Power up the computer. It should immediately start testing the memory.
  • In case there are too many memory errors and they are already overwritten on screen before you can analyze them, you can trigger a hardware NMI, which will stop the memtest routine. Though afterwards you'll have to start over by triggering a reset.

Output Interpretation

After starting up, most of the screen will be empty.

  • In the top left you can see a # character. This is the cursor. If more defects are found than fit on the screen, the output will start over at the top, overwriting previous entries. The cursor indicates the position after the last printed output.
  • Each faulty memory access looks like this: DEAD>BEEF.
    • The part left of the > sign is the memory address at which the fault occured.
    • The part right of the > sign is two bytes: First the byte that was written to this address, then the byte that was returned when reading from the same address.
    • If the delimiter is X instead of >, the byte that was written is the XOR of the high and low bytes of the address, i.e. (DE xor AD). If you only see X faults, there may be a fault in the address lines, rather than individual memory cells or output lines.
  • In the bottom right you can see 3 quickly alternating characters. The first two chars are the textual (PETSCII characters, not hexdumped) representation of the memory address currently being tested. The third char is the character written to said memory address in the current pass.
    • When all memtest passes have completed, there will be an additional = character left of these chars.
    • When the memtest routine was interrupted by an NMI, there will be a ! instead.
  • When the screen is not cleared (filled with random characters), and the first line starts with ZF***ZF (* being other seemingly random characters), a fault in the first few bytes of the zero page were detected. Since the memtest uses this area to store its state, the test is terminated prematurely.
    • The three characters in between the two ZFs are, from left to right, the zeropage address byte, the value written, the value read back.

Output Interpretation