6502/6502bench
1
0
Fork 0
mirror of https://github.com/fadden/6502bench.git synced 2024-12-11 13:50:13 +00:00
Code Issues Projects Releases Wiki Activity
d48ab7582f
6502bench/SourceGen/Examples
History
Andy McFadden 992e008e7d Add multi-inline extension script to tutorial 
It's useful to have an example of an extension script that handles
multiple types of things.  It's also good to show that scripts can
handle data types other than strings, and can chase an address to
format data items elsewhere in the code.

This required updating the tutorial binary, adding the new script,
and updating the tutorial text and associated screen shots.
2021-08-15 10:00:00 -07:00
..
A2-Amper-fdraw Label rework, part 7 (of 7) 2019-11-18 17:45:41 -08:00
A2-HP-CDA Update A2-HP-CDA example 2020-07-10 21:22:18 -07:00
A2-lz4fh Label rework, part 7 (of 7) 2019-11-18 17:45:41 -08:00
A2-Zippy Label rework, part 7 (of 7) 2019-11-18 17:45:41 -08:00
Scripts Rearrange the tutorial files 2019-10-30 09:49:11 -07:00
Tutorial Add multi-inline extension script to tutorial 2021-08-15 10:00:00 -07:00
README.md Update A2-HP-CDA example 2020-07-10 21:22:18 -07:00

README.md

SourceGen Examples

These are some sample projects you can play with. The binaries are accompanied by the original source code, so you can compare the SourceGen project to the original.

  • Tutorial: simple projects, intended for use with the tutorial in the manual.
  • Scripts: extension script samples.
  • A2-lz4fh: two functions for unpacking a simplified form of LZ4 compression. One is 6502, the other is 65816. This is pretty straightforward. (Full project)
  • A2-Amper-fdraw: 6502 code that provides an Applesoft BASIC interface to a machine-language graphics library. The public interface of the graphics library is defined in a .sym65 file. This example has multiple entry points in a jump table, and is used to demonstrate address table formatting in the advanced tutorial. (Full project)
  • A2-Zippy: a program for controlling an Apple IIgs CPU accelerator card. 65816 sources, with a little bit of ProDOS 8 and IIgs toolbox usage. Demonstrates how extension scripts are used during analysis. (Full project)
  • A2-HP-CDA: HardPressed Classic Desk Accessory. This original binary is in 65816 code in OMF loader format, which was then prepared with SourceGen's OMF conversion tool. (Try loading the "#b90100" file into the disassembler to see why.) (Full project)

You may be wondering why some of the example files have filenames with things like "#061d60" in them. It's a method of preserving the file type for Apple II files used by some utilities. The potential advantage for disassembly is that the file type often determines the load address, possibly removing some initial guesswork.