bare68k 0.1.2

A package to create m68k system emulators

bare68k allows you to write m68k system emulators in Python 2 or 3. It consists of a CPU emulation for 68000/68020/68EC020 provided by the Musashi engine written in native C. A memory map with RAM, ROM, special function is added and you can start the CPU emulation of your system. You can intercept the running code with a trap mechanism and use powerful diagnose functions,

written by Christian Vogelgsang <[e-mail]>

under the GNU Public License V2

Features

• all emulation code written in C for fast speed

• runs on Python 2.7 and Python 3.5

• emulates CPU 68000, 68020, and 68EC020

• use a 24 or 32 bit memory map

• define memory regions for RAM and ROM with page granularity (64k)

• special memory regions that call your code for each read/write operation

• intercept m68k code by placing ALINE-opcode based traps to call your code

• event-based CPU emulation frontend does always return to Python first

• provide Python handlers for all CPU emulation events

  • RESET opcode

  • ALINE trap opcode

  • invalid memory access (e.g. write in ROM region)

  • out of memory bounds (e.g. read above memory map)

  • control interrupt acknowledgement

  • watch and break points

  • custom timers based on CPU cycles

• extensive diagnose functions

  • instruction trace

  • memory access for both CPU and Python API

  • register dump

  • memory labels to mark memory regions with arbitrary Python data

  • all bare68k components use Python logging

• rich API to configure memory and CPU state

• store/restore CPU context

Installation

• use pip:

  $ pip install bare68k

• or checkout github repository and install:

  $ python setup.py install

• use dev setup:

  $ python setup.py develop --user

Documentation

• the full documentation is hosted at ReadTheDocs