Skip to content

pawlos/Timex.Emu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Timex.Emu

Timex.Emu is an emulator for a popular Timex 2048 machine.

Folder structure:

docs:

  • Z80 CPU Manual
  • Z80 CPU Peripherals
  • Complete ROM

python:

  • timex.py - main entry to the emulator

Example command to load a user program:

python3 timex.py --program=helloworld.bin --startAt=8000 --breakAt=8000 --mapAt=8000 --hook-system

This loads user program helloworld.bin (--program) at 0x8000 (--mapAt), putting a break point at 0x8000 (--breakAt) and starting execution from 0x8000 too (--startAt). Additionally system function (i.e. print) are being hooked with python replacement.

rom:

  • Binary file containing ROM of actual machine

tests:

  • a suite of unit tests
    • running tests: python3 -m unittest discover.

Note

To run zexall or zexdoc tests suite set ZEXALL or ZEXDOC environment variable to True respectivly

export ZEXALL=True

python3 -m unittest tests_cpu.tests_cpu.test_zexall python3 -m unittest tests_cpu.tests_cpu.test_zexdoc

Links

Hits-of-Code

About

An attempt to write a Timex 2048 emulator in python.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages