6502/py65
1
0
Fork 0
mirror of https://github.com/mnaberez/py65.git synced 2024-11-02 19:04:38 +00:00
Code Issues Projects Releases Wiki Activity
Emulate 6502-based microcomputer systems in Python
254 Commits 1 Branch 27 Tags 1.5 MiB
Python 100%
cf8d0ab394
Go to file
Mike Naberezny cf8d0ab394 Use _exit() instead of calling sys.exit directly
2012-01-04 21:22:49 -08:00
docs Prepare 0.10 release 2011-08-27 13:36:54 -07:00
examples EhBASIC 2.2: Load at $0000 and goto $FF80 to start 2012-01-02 17:25:36 -08:00
src/py65 Use _exit() instead of calling sys.exit directly 2012-01-04 21:22:49 -08:00
.gitignore Added *.swp, build/, dist/. 2009-04-07 16:33:57 -07:00
CHANGES.txt Python versions earlier than 2.6 are no longer supported 2012-01-02 18:47:34 -08:00
LICENSE.txt Update copyright year for 2012 2012-01-04 21:12:26 -08:00
MANIFEST.in Removed ez_setup.py. 2010-03-07 23:12:17 -08:00
README.markdown Note 65Org16 simulation module 2012-01-01 15:22:19 -08:00
setup.py Python versions earlier than 2.6 are no longer supported 2012-01-02 18:47:34 -08:00
TODO.txt Removed interactive assembly mode from TODO list. 2009-08-21 23:40:45 -07:00

README.markdown

Py65

Py65 provides tools for simulating hardware based on 6502-like microprocessors. It has the following goals:

  • Focus on ease of use and modularity rather than performance. Py65 is written in the Python programming language for productivity, while similar programs are written in C for performance.

  • Enable simulations to be created for systems where it might have otherwise not been practical, such as homebuilt computers.

  • Rigorously unit test all of the components. While the tools provided by Py65 may not always be perfect, their behavior is verified through tests so unexpected results are minimized.

Installation

Py65 packages are available on the Python Package Index (PyPI). You download them from there or you can use easy_install to automatically install or upgrade Py65:

$ easy_install -U py65

Alternatively, you can download a package from GitHub in .tar.gz or .zip format. After extracting the package, use the following command to install Py65:

$ python setup.py install

Devices

The following devices are simulated at this time:

  • mpu6502 simulates the original NMOS 6502 microprocessor from MOS Technology, later known as Commodore Semiconductor Group (CSG). At this time, all of the documented opcodes are supported. Support for the illegal opcodes is planned for the future.

  • mpu65c02 simulates a generic CMOS 65C02 microprocessor. There were several 65C02 versions from various manufacturers, some with more opcodes than others. This simulation is based on the W65C02S from the Western Design Center (WDC).

  • mpu65Org16 simulates the 65Org16, a 6502-like microprocessor with a 16-bit data bus and 32-bit address bus. This microprocessor is a project of the 6502.org community and a Verilog core for it has been implemented.

Monitor

Py65 includes a console-based machine language monitor (sometimes also called a debugger). This program, py65mon, allows you to interact with the simulations that you build. Its features include:

  • Commands that are largely compatible with those used in the monitor of the popular VICE emulator for Commodore computers.

  • Ability to load, dump, and fill memory.

  • Simple assemble and disassemble capability, including support for labels and labels with offsets.

Documentation

Py65 documentation is written using Sphinx and is published to http://py65.readthedocs.org/

Contributors

These people are responsible for Py65:

  • Mike Naberezny is the original author of Py65 and is the primary maintainer.

  • Oscar Lindberg started the 65C02 simulation module and contributed greatly to its implementation.

  • Ed Spittles wrote the 65Org16 simulation module and provided many useful issue reports and patches.