Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Emulator for 6809 CPU based system like Dragon 32 / CoCo written in Python...

Project Description

Dragon/CoCO emulator written in Python

DragonPy is a Open source (GPL v3 or later) emulator for the 30 years old homecomputer Dragon 32 and Tandy TRS-80 Color Computer (CoCo)…

The MC6809 project is used to emulate the 6809 CPU.

Dragon 32 with CPython 3 under Linux:

CoCo with Extended Color Basic v1.1 in Text mode (running with PyPy under Windows):

DragonPy is written in Python. It’s platform independent and runs with Python and PyPy under Linux/Windows/OSX/… It’s tested with Python 2.7.x and 3.4, PyPy2 and PyPy3.

DragonPy will not be a second XRoar written in Python. This project is primarily to lean and understand.

Future goals are:

  • Implement a integrated development environment for BASIC programs

A full featured Dragon / CoCo emulator is XRoar.

Current state

The Dragon 32 / 64 and CoCo ROMs works in Text mode. Also the “single board computer” ROMs sbc09, Simple6809 and Multicomp6809 works well.

There is a rudimentary BASIC editor with save/load BASIC programm listings direct into RAM.

Looks like this:

(older version of the editor)


The Vectrex (Wikipedia) is a vector display-based video game console. The Hardware are only the 6809 CPU, a 6522 Versatile Interface Adapter and the AY-3-8912 sound chip.

Current state is completely not usable. The 6522 is only a dummy implementation. It makes only sense to display some trace lines, e.g.:

(DragonPy_env)~/DragonPy_env$ bin/python src/dragonpy/ --verbosity 5 --machine=Vectrex run --trace --max_ops 1

BASIC Editor

Use “BASIC editor / open” in the main menu to open the editor.

You can load/save ASCII .bas files from you local drive or just type a BASIC listing ;) With “inject into DragonPy” you send the current listing from the Editor to the Emulator and with “load from DragonPy” back from emulator to editor. Note: The is currently no “warning” that un-saved content will be “overwritten” and there is no “auto-backup” ;)

The “renumbering” tool can be found in the editor window under “tools”

You can also run the BASIC Editor without the Emulator:

(DragonPy_env)~/DragonPy_env$ bin/python src/dragonpy/ editor

A rudimentary BASIC source code highlighting is available and looks like this:

Special feature: The Line number that are used in GOTO, SOGUB etc. are extra marked on the left side.


IMPORTANT: The PyPi package name is DragonPyEmulator and not only “DragonPy”!!!


The is a virtualenv bootstrap file, created with bootstrap_env, for easy installation.

Get the bootstrap file:

/home/FooBar$ wget

There are tree types of installation:

option desciption
pypi use Python Package Index (for all normal user!)
git_readonly use git to get the sourcecode (for developer without write access)
dev use git with write access


/home/FooBar$ python3 ~/DragonPy_env --install_type git_readonly

This creates a virtualenv in ``~/DragonPy_env`` and used git to checkout the needed repositories.

In this case (using –install_type=**git_readonly**) the git repository are in: …/DragonPy_env/src/ So you can easy update them e.g.:

/home/FooBar$ cd ~/DragonPy_env/src/dragonpy
/home/FooBar/DragonPy_env/src/dragonpy$ git pull

start DragonPy

The is a simple “starter GUI”, just call the cli without arguments:


Or call it in a activated environment, e.g.:

/home/FooBar$ cd DragonPy_env
/home/FooBar/DragonPy_env$ source bin/activate
(DragonPy_env)~/DragonPy_env$ DragonPy

It is possible to start machines directly:

(DragonPy_env)~/DragonPy_env$ DragonPy --machine=Dragon32 run

more info:

(DragonPy_env)~/DragonPy_env$ DragonPy --help


There are several ways to install the project under windows.

The following is hopeful the easiest one:

The default boot_dragonpy.cmd will install via Python Package Index (PyPi) into %APPDATA%\DragonPy_env

start DragonPy

The is a simple “starter GUI”, just call the cli without arguments:


It looks like this:


All needed ROM files, will be downloaded automatically.

The files will be downloaded from:

Dragon 32 + 64
CoCo 2b

sbc09 and vectrex ROMs are included.

All ROM files and download will be checked by SHA1 value, before use.


run unittests

You can run tests with PyPy, Python 2 and Python 3:

(DragonPy_env)~/DragonPy_env/src/dragonpy$ python -m unittest discover


(DragonPy_env)~/DragonPy_env/src/dragonpy$ ./ test

create coverage report

install coverage for python 2:

~$ sudo pip2 install coverage
...path/to/env/src/dragonpy$ coverage2 run --source=dragonpy test
...path/to/env/src/dragonpy$ coverage2 coverage2 html
# e.g.:
...path/to/env/src/dragonpy$ firefox htmlcov/index.html

more screenshots

“sbc09” ROM in Tkinter window:

“Simple6809” ROM in Tkinter window:

Dragon Keyboard

The keyboard mapping is stored into dragonpy/Dragon32/

Some notes:

  • “CLEAR” is mapped to “Home” / “Pos 1” key
  • “BREAK” is mapped to “Escape” button
  • “LEFT” is mapped to left cursor key and to normal backspace, too.

A “auto shift” mode is implemented. So normal lowercase letters would be automaticly converted to uppercase letters.

paste clipboard

It is possible to paste the content of the clipboard as user input in the machine. Just copy (Ctrl-C) the follow content:

10 CLS
20 FOR I = 0 TO 255:
30 POKE 1024+(I*2),I
50 I$ = INKEY$:IF I$="" THEN 50

Focus the DragonPy window and use Ctrl-V to paste the content.

Looks like:

Then just RUN and then it looks like this:

DragonPy schematic

+------------------+                         +---------------------+
|                  |                         |                     |
| +-------------+  |                         |       6809 CPU      |
| |             |  |                         |       +     ^       |
| |     GUI     |  |                         |       |     |       |
| |             |  | Display RAM callback    |    +--v-----+--+    |
| |  .--------------------------------------------+   Memory  |    |
| |  |          |  |                         |    +--+-----^--+    |
| |  |          |  |                         |       |     |       |
| |  |          |  |                         | +-----v-----+-----+ |
| |  |          |  |                         | |    Periphery    | |
| |  |          |  |     Keyboard queue      | |   MC6883 SAM    | |
| |  |          +--------------------------------->MC6821 PIA    | |
| |  |          |  |                         | |                 | |
| +--+-----^----+  |                         | |                 | |
|    |     |       |                         | +-----------------+ |
|    |     |       |                         |                     |
| +--v-----+----+  |                         |                     |
| |             |  |                         |                     |
| |   Display   |  |                         |                     |
| |             |  |                         |                     |
| +-------------+  |                         |                     |
+------------------+                         +---------------------+


The current implementation is not really optimized.

With CPython there is round about 490.000 CPU cycles/sec. in console version. This is half as fast as the real Hardware.

With PyPy round about 6.900.000 - 8.000.000 CPU cycles/sec. In other words with PyPy it’s 8 times faster as the real Hardware.

e.g. The Dragon 32 6809 machine with a 14.31818 MHz crystal runs with: 0,895MHz (14,31818Mhz/16=0,895MHz) in other words: 895.000 CPU-cycles/sec.


  1. implement more Dragon 32 periphery

missing 6809 unittests after coverage run:

  • MUL
  • BVS


Some Python/BASIC tools/scripts around Dragon32/64 / CoCo homecomputer.

All script are copyleft 2013-2014 by Jens Diemer and license unter GNU GPL v3 or above, see LICENSE for more details.

Python scripts:

BASIC programms:

Input/Output Tests

/BASIC/InputOutput/keyboard.bas Display memory Locations $0152 - $0159 (Keyboard matrix state table)

Example screenshow with the “Y” key is pressed down. You see that this is saved in $0153:

Example with “U” is hold down:


Some code based on:


An Apple ][ emulator in Python

XRoar A really cool Dragon / CoCo emulator

included Python modules:

python-pager Page output and find dimensions of console. Motorola S-Record utilities


dragonlib Dragon/CoCO Python Library

MC6809 Implementation of the MC6809 CPU in Python

pygments generic syntax highlighter


Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
DragonPyEmulator-0.5.3-py2.py3-none-any.whl (375.6 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Aug 24, 2015
DragonPyEmulator-0.5.3-py3.4.egg (351.3 kB) Copy SHA256 Checksum SHA256 3.4 Egg Aug 24, 2015
DragonPyEmulator-0.5.3.tar.gz (1.5 MB) Copy SHA256 Checksum SHA256 Source Aug 24, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting