Suite8080

Suite8080 is a suite of Intel 8080 Assembly cross-development tools written in Python.

The suite comprises the following command-line programs and more will come:

• asm80: assembler
• dis80: disassembler

This project is inspired by a series of blog posts by Brian Robert Callahan on demystifying programs that create programs. In an ongoing series of posts on my own blog I'm telling about my work on and experience with developing Suite8080.

The executable files generated and processed by the tools are supposed to run on any Intel 8080 system such as CP/M computers, both actual devices and emulated ones.

Suite8080, which is developed with Replit, requires Python 3.6 or later and depends on Pytest for unit tests.

Installation

Install Suite8080 from PyPI with the command:

$ pip install suite8080

Usage examples

Linux

To run the assembler on Linux execute:

$ asm80 file.asm

where file.asm is an Intel 8080 Assembly source file. You can disassemble the resulting program with:

$ dis80 file.com

where file.com is an executable Intel 8080 program.

Replit

To run the programs online on Replit visit the Suite8080 REPL with a browser. You first have to set up the environment by forking the REPL, opening the Shell pane, and editing ~/.bashrc to add export PYTHONPATH=.:$PYTHONPATH. Next, click Run. Finally, change to the suite8080/suite8080 directory of the source tree.

To run the assembler execute:

$ python3 -m asm80 file.asm

where file.asm is an Intel 8080 Assembly source file.

You can disassemble a program with the command:

$ python3 -m dis80 file.com

where file.com is an executable Intel 8080 program.

Documentation and sample programs

For information on how to use Suite8080 and its design see the documentation.

The asm directory of the source tree contains sample Assembly programs, some of which run on CP/M and others on a bare Intel 8080 system with no host environment. You can use the Suite8080 tools to process these programs, for example assemble the sources with asm80 and disassemble the executables with dis80.

Status

Suite8080 is in early development and some of the planned tools and features are not available yet.

Release history

See the list of releases for notes on the changes in each version.

Author

Paolo Amoroso developed Suite8080. Email: info@paoloamoroso.com

License

This code is distributed under the MIT license, see the LICENSE file.