1
0
mirror of https://github.com/TomHarte/CLK.git synced 2024-11-26 23:52:26 +00:00
CLK/OSBindings/Mac/Clock SignalTests/68000 Comparative Tests
Thomas Harte c6c6213460 Bifurcate the fetch-operand flow.
Address calculation will be the same, but the fetch will differ. I don't think there's a neat costless way to factor out the address calculations, alas, but I'll see whether macros can save the day.
2022-05-19 10:27:51 -04:00
..
abcd_sbcd.json Correct all [A/S/N]BCD tests. 2022-05-13 16:18:58 -04:00
add_sub.json
addi_subi_cmpi.json
addq_subq.json
addx_subx.json
bcc.json
btst_bchg_bclr_bset.json
chk.json Correct all [A/S/N]BCD tests. 2022-05-13 16:18:58 -04:00
cmp.json
dbcc_scc.json
divu_divs.json Switch to same tests, run through a more modern emulator. 2022-05-15 16:33:08 -04:00
eor_and_or.json Correct all [A/S/N]BCD tests. 2022-05-13 16:18:58 -04:00
eori_andi_ori.json
exg.json Correct all [A/S/N]BCD tests. 2022-05-13 16:18:58 -04:00
ext.json Correct all [A/S/N]BCD tests. 2022-05-13 16:18:58 -04:00
jmp_jsr.json
lea.json
link_unlk.json
lslr_aslr_roxlr_rolr.json
move_tofrom_srccr.json
move.json
movem.json
movep.json
moveq.json
mulu_muls.json
nbcd_pea.json Bifurcate the fetch-operand flow. 2022-05-19 10:27:51 -04:00
neg_not.json
negx_clr.json
readme.md Improve README. 2022-05-13 16:28:56 -04:00
rtr.json
rts.json
swap.json
tas.json
tst.json

68000 Comparative Tests

Tests contained in this folder are original to Clock Signal. All are JSON.

Tests assume a test machine consisting of a vanilla 68000 with 16mb of RAM. For each test either:

  1. start from a reset, e.g. if you have a prefetch queue you need to fill; or
  2. just apply the entire initial state, which indicates the proper PC and A7 for itself.

Then execute to the end of a single instruction (including any generated exception).

Each file contains an array of dictionaries. Each dictionary is a single test and includes:

  • a name;
  • initial memory contents;
  • initial register state;
  • any changes to memory that occur during the test; and
  • the final register state.

Both the initial and final memory arrays specify bytes and are in the form:

[address, value, address, value ..., -1]

All tests are randomly generated, and the end results were achieved empirically using a believed-good 68000 emulation. Some have subsequently been patched as and when 68000 emulation faults are found. JSON formatting is not guaranteed to be consistent.

Nothing here is intelligent or crafted, it's merely an attempt to get a lot of coverage with limited effort.

Methodology

Neither file names nor test names are necessarily accurate; process was:

  • look up an instruction encoding in the 68000 Programmer's Reference Manual, starting from page 8-5 (p561 of the PDF I'm using);
  • that'll look something like: ORI -> 0000 0000 SS MMM RRR where SS = size, MMM = mode, RRR = register;
  • therefore, generate the 256 possible 16-bit words that match that pattern; and
  • for each one that passes a does-this-instruction-exist test, produce a test case.

Since the 68000 isn't fully orthogonal in its instruction encodings — in the ORI example above some modes and some sizes are illegal, those opcodes being used for other instructions — the tests labelled ORI will include both: (i) all valid ORIs; and (ii) some other instructions. I didn't consider this worth fixing.

Every generated opcode is followed by three words of mostly-random data; this data — and almost all other random numbers — never has the lowest bit set, and contains 00 where the size field would be if used for an An + Xn + d addressing mode.

All initial register contents are random except that the lowest bit is never set, to avoid accidental address errors.

So the output is very scattergun approach, with a lot of redundancy.

Questionable Results

Values for the undocumented flags of DIVU and DIVS have not yet been verified, due to a lack of documentation.