git.sur5r.net Git - cc65/blob - test/asm/README

   1
   2 Assembler Testcases
   3 ===================
   4
   5 Opcode Tests:
   6 -------------
   7
   8 These testcases are inspired by the ones now removed from test/assembler.
   9 The main purpose is to have each possible opcode generated at least once,
  10 either by an assembly instruction or a ".byte"-placeholder. Typically
  11 generated by disassembling a binary dump that contains data in the form
  12 of the pattern that each opcode is stated once in order followed by easy
  13 to recognise:
  14
  15 00 00 EA 00
  16 01 00 EA 00
  17 02 00 EA 00
  18 [...]
  19 fe 00 EA 00
  20 ff 00 EA 00
  21
  22 The disassembly is then put in a better readable form by replacing the
  23 leftover dummy opcode parameters with something more recognizable.
  24
  25 The testcases for 6502, 6502x, 65sc02, 65c02, 4510, and huc6280 have been
  26 put together by Sven Oliver ("SvOlli") Moll, as well as a template for the
  27 m740 instructions set.
  28
  29 Still to do is to find a way to implement an opcode testcase for the 65816
  30 processor, since it's capable of executing instructions with an 8-bit and
  31 a 16-bit operator alike, only distinguished by one processor flag.
  32
  33
  34 CPU detect Tests
  35 ----------------
  36
  37 These tests all assemble the same file "cpudetect.s" which contains several
  38 conditionals for several CPUs, only using every option known to the "--cpu"
  39 commandline switch of ca65/cl65.
  40
  41
  42 Reference (".ref") Files
  43 ------------------------
  44
  45 A hint on creating these files: when running the test, it will fail due to
  46 the missing ".ref" file. Review the output of the ".lst" very pedantic, then
  47 copy the ".bin" to the ".ref" file.
  48