PyCon US is happening May 14th-22nd in Pittsburgh, PA USA.  Learn more

A package to create m68k system emulators

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for cnvogelg from gravatar.com cnvogelg

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
  • Author: Christian Vogelgsang
Classifiers

Project description

travis appveyor rtfd coverall

pypi-v wheel pyver status

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 <chris@vogelgsang.org>

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

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page