Pyntel4004

A Python software implementation of the Intel 4004 processor.

General Information

• Two pass assembler using the original mnemonics, directives and comments syntax
• Monitor facility to step through code and examine registers, memory etc

Requirements

• Python_ >= 3.8.2

Installation Instructions

Source Code

Pyntel4004’s git repo is available on GitHub, which can be browsed here and cloned using:

 
    $ git clone https://github.com/alshapton/pyntel4004 pyntel4004

Verify the installation by running unit tests:

    $ cd pyntel4004/test
    $ pytest

Questions, Answers and Issues

Please use the github discussion board for questions, to ensure the right people see them in a timely manner.

Github Pyntel4004 Discussion Board

and the github issue tracker to raise any issues.

Github Pyntel4004 Issues Board

Usage Instructions

The user instructions can be found here

Design goals

• As much of the internals as possible should be carried out using binary arithmetic and operations.
• No 3rd party libraries to be used (i.e. pure Python).
• Build a fully-working i4004 opcode emulator.
• Build a fully-working assembler which generates correct op-codes.
• Construct a fully-working software-based i4004 chip which can use the generated object code from the compiler (possibly using micro-python or circuit python on an Ardiuno Board).

Status

23-SEP-2021: Publishing releases to PyPi
10-SEP-2021: Documentation building and hosted with READTHEDOCS
12-JUN-2021: Auto-build with GITHUB Actions implemented
18-MAY-2021: Implementing full test suite
21-APR-2021: Instruction Set functionally complete Entering Testing Phase

Example

Assembler Directives and other additions

Assembler directives are not part of the program itself, but can control things like starting address, and various environmental settings.

Monitor Commands

Licence

This package is Treeware. If you use it in production, then we ask that you buy the world a tree to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.

Credits

• Intel 4004 Design Team
• Logo: LouBeLou Print Shop

.. _Python: https://www.python.org