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.

Install Suite8080 from PyPI with the command:

$ pip install suite8080

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.

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.

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.

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

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

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

Suite8080 is a personal learning project. I like devising solutions to problems, designing and implementing new features, and planning the evolution of the system. This is part of the learning journey, as well as fun.

So, although you're welcome to modify the code and I appreciate your work, I may not merge your changes or implement the features you suggest.

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