DragonPyEmulator 0.3.1

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

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)…

Dragon 32 and 64 ROMs in Text mode:

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

DragonPy is written in Python. It’s platform independent and runs with Python v2 and v3 and PyPy. It’s tested with Python 2.7.x and 3.4 and PyPy2.

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)

Vectrex

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.:

...path/to/DragonPy$ python2 DragonPy_CLI.py --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:

...path/to/DragonPy$ python2 DragonPy_CLI.py 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.

Currently the code are only differate into:

• DATA

• Strings

• Comments

• Code

TODO: parse the code, to coloring it differently.

ROMs

The Dragon ROMs can be downloaded here:

• http://archive.worldofdragon.org/archive/index.php?dir=Roms/Dragon/

There is a simple shell script to automatic download and extract the Dragon ROMs:

...path/to/DragonPy$ ./download_ROMs.sh

Quick start:

# clone the repro:
~$ git clone https://github.com/jedie/DragonPy.git

# Alternative download as .zip: https://github.com/jedie/DragonPy/archive/master.zip

~$ cd DragonPy

# Download all ROM files:
~/DragonPy$ ./download_ROMs.sh

# Start Dragon 32
~/DragonPy$ python2 DragonPy_CLI.py --machine=Dragon32 run

example

start Dragon 32:

...path/to/DragonPy$ python2 DragonPy_CLI.py --machine=Dragon32 run

start Dragon 64:

...path/to/DragonPy$ python2 DragonPy_CLI.py --machine=Dragon64 run

start CoCo with Extended Color Basic v1.1:

...path/to/DragonPy$ python2 DragonPy_CLI.py --machine=CoCo2b run

start Multicomp 6809:

...path/to/DragonPy$ python2 DragonPy_CLI.py --machine=Multicomp6809 run

start Lennart’s 6809 single board computer:

...path/to/DragonPy$ python2 DragonPy_CLI.py --machine=sbc09 run

unittests

Travis CI Status:

• https://travis-ci.org/jedie/DragonPy

run unittests

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

...path/to/DragonPy$ python -m unittest discover

All variants:

...path/to/DragonPy$ python2 -m unittest discover
...path/to/DragonPy$ python3 -m unittest discover
...path/to/DragonPy$ pypy -m unittest discover

create coverage report

install coverage for python 2:

~$ sudo pip2 install coverage

...path/to/DragonPy$ coverage2 run --source=dragonpy setup.py test
...path/to/DragonPy$ coverage2 coverage2 html
# e.g.:
...path/to/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/keyboard_map.py.

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
40 NEXT 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   |  |                         |                     |
| |             |  |                         |                     |
| +-------------+  |                         |                     |
+------------------+                         +---------------------+

performance

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.

There is a simple benchmark. Run e.g.:

...path/to/DragonPy$ python2 DragonPy_CLI.py benchmark
...path/to/DragonPy$ python3 DragonPy_CLI.py benchmark
...path/to/DragonPy$ pypy DragonPy_CLI.py benchmark
...path/to/DragonPy$ pypy3 DragonPy_CLI.py benchmark --loops 10

TODO:

1. Use bottle for http control server part

2. implement more Dragon 32 periphery

unimplemented OPs:

• RESET

• SWI / SWI2 / SWI3

• SYNC

missing 6809 unittests after coverage run:

• MUL

• BVS

PyDragon32

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:

• PyDC - Convert dragon 32 Cassetts WAV files into plain text:

  • https://github.com/jedie/DragonPy/tree/master/PyDC

• Filter Xroar traces:

  • https://github.com/jedie/DragonPy/tree/master/misc

BASIC programms:

• Simple memory HEX viewer:

  • https://github.com/jedie/DragonPy/tree/master/BASIC/HexViewer

• Test CC Registers:

  • https://github.com/jedie/DragonPy/tree/master/BASIC/TestCC_Registers

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:

Links

• Grant Searle’s Multicomp FPGA project:

  • Homepage: http://searle.hostei.com/grant/Multicomp/

  • own dragonpy/Multicomp6809/README

• Lennart Benschop 6809 Single Board Computer:

  • Homepage: http://lennartb.home.xs4all.nl/m6809.html

  • own dragonpy/sbc09/README

• Grant Searle’s Simple 6809 design:

  • Homepage: http://searle.hostei.com/grant/6809/Simple6809.html

  • own dragonpy/Simple6809/README

Some links:

• http://www.burgins.com/m6809.html

• http://www.maddes.net/m6809pm/ - Programming Manual for the 6809 microprocessor from Motorola Inc. (now Freescale)

• http://www.6809.org.uk/dragon/hardware.shtml

• http://dragondata.worldofdragon.org/Publications/inside-dragon.htm

• http://koti.mbnet.fi/~atjs/mc6809/ - 6809 Emulation Page

Source codes:

• https://github.com/naughton/mc6809/blob/master/mc6809.ts

• https://github.com/maly/6809js/blob/master/6809.js

• http://mamedev.org/source/src/mess/drivers/dragon.c.html

• http://mamedev.org/source/src/mess/machine/dragon.c.html

• http://mamedev.org/source/src/emu/cpu/m6809/m6809.c.html

• https://github.com/kjetilhoem/hatchling-32/blob/master/hatchling-32/src/no/k/m6809/InstructionSet.scala

Dragon 32 resources:

• Forum: http://archive.worldofdragon.org/phpBB3/index.php

• Wiki: http://archive.worldofdragon.org/index.php?title=Main_Page

Credits

Some code based on:

ApplePy

An Apple ][ emulator in Python

• Author: James Tauber

• https://github.com/jtauber/applepy

• License: MIT

XRoar A really cool Dragon / CoCo emulator

• Author: Ciaran Anscomb

• http://www.6809.org.uk/xroar/

• License: GNU GPL v2

included Python modules:

python-pager Page output and find dimensions of console.

• Author: Anatoly Techtonik

• License: Public Domain

• Homepage: https://bitbucket.org/techtonik/python-pager/

• Stored here: /dragonpy/utils/pager.py

srecutils.py Motorola S-Record utilities

• Author: Gabriel Tremblay

• License: GNU GPL v2

• Homepage: https://github.com/gabtremblay/pysrec

• Stored here: /dragonpy/utils/srecord_utils.py

six Six is a Python 2 and 3 compatibility library.

• https://pypi.python.org/pypi/six

• https://bitbucket.org/gutworth/six

History

• 08.10.2014 - Release as v0.3.1

• 30.09.2014 - Enhance the BASIC editor

• 29.09.2014 - Merge PyDragon32 project

• 25.09.2014 - Release v0.3.0:

  • Change Display Queue to a simple Callback

  • Reimplement Multicomp 6809 and SBC09

  • Many code refactoring and cleanup

• 14.09.2014 - Release v0.2.0 - Add a speedlimit, config dialog and IRQ: Forum post 11780

• 05.09.2014 - Release v0.1.0 - Implement pause/resume, hard-/soft-reset 6809 in GUI and improve a little the GUI/Editor stuff: v0.1.0 see also: Forum post 11719.

• 27.08.2014 - Run CoCo with Extended Color Basic v1.1, bugfix transfer BASIC Listing with 8fe24e5…697d39e see: Forum post 11696.

• 20.08.2014 - rudimenary BASIC IDE works with 7e0f16630…ce12148, see also: Forum post 11645.

• 05.08.2014 - Start to support CoCo, too with 0df724b, see also: Forum post 11573.

• 04.08.2014 - Use the origin Pixel-Font with Tkinter GUI, see: Forum post 4909 and Forum post 11570.

• 27.07.2014 - Copyrigth info from Dragon 64 ROM is alive with 543275b, see: Forum post 11524.

• 29.06.2014 - First “HELLO WORLD” works, see: Forum post 11283.

• 27.10.2013 - “sbc09” ROM works wuite well almist, see: Forum post 9752.

• 16.10.2013 - See copyright info from “Simple6809” ROM with 25a97b6 see also: Forum post 9654.

• 10.09.2013 - Start to implement the 6809 CPU with 591d2ed

• 28.08.2013 - Fork “Apple ][ Emulator” written in Python: https://github.com/jtauber/applepy to https://github.com/jedie/DragonPy

Links:

Forum	http://forum.pylucid.org/
IRC	#pylucid on freenode.net
Jabber	[e-mail]
PyPi	https://pypi.python.org/pypi/DragonPyEmulator/
Github	https://github.com/jedie/DragonPy

donation

• Send Bitcoins to 1823RZ5Md1Q2X5aSXRC5LRPcYdveCiVX6F