td4-py

This repository is a 4bit CPU emulator written by Python.
The original is CPUの創りかた.

example

LED

Ramen Timer(10x)

features

Read from plain text files, td4 format files
Variable clock, manual clock selectable
Beep support
Runs in CLI

Install

pip3 install td4

Usage

args

td4 [-h] [-i INPUT] [-c CLOCK] [-b] file

file

File to read.
Check https://github.com/yashikota/td4-py#support-file-format for the supported format.

example

. td4 program.txt
td4 Knight2K.td4

help

Show help message and exit.

example

td4 -h

input

Any binary can be specified.
Default is 0000.

example

td4 -i 0000
td4 --input 1111

clock

Any number or manual can be specified.
Default is 10.

example

td4 -c 1
td4 --clock 10
td4 -c manual

beep

Specifies whether a beep is sounded.
Operates when the MSB of out is set to 1.
Default is False.

example

td4 -b
td4 --beep

Support file format

Input from plain text files supports several patterns.

Pattern 1

Opcode(Assembly LowerCase) + Space + Immediate data

out 0011
out 0110
out 1100
out 1000
out 1000
out 1100
out 0110
out 0011
out 0001
jmp 0000

Pattern2

Opcode(Assembly UpperCase) + Space + Immediate data

OUT 0111
ADD A,0001
JNC 0111
ADD A,0001
JNC 0011
OUT 0110
ADD A,0001
JNC 0110
ADD A,0001
JNC 1000
OUT 0000
OUT 0100
ADD 0001
JNC 1010
OUT 1000
JMP 1111

Pattern3

Opcode(binary) + Immediate data

Pattern4

Opcode(binary) + Space + Immediate data