DragonPyEmulator 0.6.0.dev0

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)

(DragonPy_env)~/DragonPy_env$ bin/python src/dragonpy/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:

(DragonPy_env)~/DragonPy_env$ bin/python src/dragonpy/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.

by foot

e.g.:

# Create virtualenv:
.../$ python3 -Im venv DragonPy

# activate created virtualenv:
.../$ cd DragonPy
.../DragonPy$ source bin/activate

# update pip before install:
(DragonPy) .../DragonPy$ pip install -U pip
...

# Install DragonPy:
(DragonPy) .../DragonPy$ pip install DragonPyEmulator
Collecting DragonPyEmulator
...
Installing collected packages: click, six, dragonlib, pygments, MC6809, DragonPyEmulator
Successfully installed DragonPyEmulator-0.5.3 MC6809-0.5.0 click-6.7 dragonlib-0.1.7 pygments-2.2.0 six-1.11.0

# start Emulator
(DragonPy) .../DragonPy$ DragonPy

Linux

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

Get the bootstrap file:

/home/FooBar$ wget https://raw.githubusercontent.com/jedie/DragonPy/master/boot_dragonpy.py

There are tree types of installation:

e.g.:

/home/FooBar$ python3 boot_dragonpy.py ~/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

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

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

(DragonPy_env)~/DragonPy_env$ DragonPy --help

Windows

There are several ways to install the project under windows.

The following is hopeful the easiest one:

• Install Python 3, e.g.: https://www.python.org/downloads/

• Download the DragonPy git snapshot from Github: master.zip

• Extract the Archive somewhere

• Maybe, adjust paths in boot_dragonpy.cmd

• Run boot_dragonpy.cmd

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

run unittests

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

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

or:

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

create coverage report

install coverage for python 2:

~$ sudo pip2 install coverage

...path/to/env/src/dragonpy$ coverage2 run --source=dragonpy setup.py test
...path/to/env/src/dragonpy$ coverage2 coverage2 html
# e.g.:
...path/to/env/src/dragonpy$ firefox htmlcov/index.html

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.

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

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.

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

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

requirements

dragonlib Dragon/CoCO Python Library

• Author: Jens Diemer

• https://pypi-hypernode.com/pypi/DragonLib/

• https://github.com/6809/dragonlib

• License: GNU GPL v3

MC6809 Implementation of the MC6809 CPU in Python

• Author: Jens Diemer

• https://pypi-hypernode.com/pypi/MC6809

• https://github.com/6809/MC6809

• License: GNU GPL v3

pygments generic syntax highlighter

• Author: Georg Brandl

• https://pypi-hypernode.com/pypi/Pygments

• http://pygments.org/

• License: BSD License