6502-BAS

BASIC program listings for the A.C. Wright 6502 family of computer systems.

Each listing lives in its own directory as a .txt source file and can be tokenized into a .prg and packaged onto a CompactFlash disk image for the system's BASIC interpreter.

📖 Guide: AC6502 Documentation — the user's and programmer's guide for the whole family. The dialect these listings are written in is taught in the BASIC guide.

Building Programs

Each listing directory contains its own Makefile. To build a listing, navigate to its directory and use make.

Prerequisites

bastok

Install from NPM:

npm install -g bastok

The bastok tool tokenizes BASIC source text into the .prg program images the interpreter loads and runs, and can detokenize them back to text.

For more information, see the bastok project.

cffs

Install from NPM:

npm install -g cffs-image-tool

The cffs tool is used to create CompactFlash disk images and add files to them. It's required for the make cf target.

For more information, see the cffs project.

6502 CLI

Installed via the 6502-EMULATOR app's Settings → Command Line → Install. Required for the make run target.

Available Targets

• make or make all - Tokenize the listing and build a CompactFlash image containing it
• make build - Tokenize the listing into a .prg
• make view - Display hexdump of the tokenized .prg
• make cf - Create a CompactFlash image and add the .prg to it
• make run - Launch the emulator app with the tokenized listing loaded
• make clean - Remove build artifacts

Example

cd RKPAPSC
make        # Tokenize the listing and build the CF image
make view   # View the hexdump
make run    # Launch the emulator

Usage

The .txt source in each directory is a plain-text BASIC listing and can also be typed directly into the interpreter by hand if you'd rather not build it. Program listings load at $0800, matching the system's PROGRAM_START.

Related

• 6502-ACE — the hardware, and the index of the whole family
• 6502-BIOS — the BASIC dialect these listings are written in
• 6502-EMULATOR — run a listing without hardware (make run)
• 6502-ASM — the same idea for assembly language programs
• bastok / cffs — the tools behind make build and make cf
• 6502-DOCS — the documentation site: the BASIC guide and the printable reference cards

License

MIT License — see LICENSE.