DragonPyEmulator 0.7.0

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$ poetry run DragonPy --verbosity 0 --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$ make editor
# or:
.../DragonPy$ poetry run 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.

from source

~$ git clone https://github.com/jedie/DragonPy.git
~$ cd DragonPy/
~/DragonPy$ make
help                 List all commands
install-poetry       install or update poetry
install              install DragonPy via poetry
update               Update the dependencies as according to the pyproject.toml file
lint                 Run code formatters and linter
fix-code-style       Fix code formatting
tox-listenvs         List all tox test environments
tox                  Run pytest via tox with all environments
tox-py36             Run pytest via tox with *python v3.6*
tox-py37             Run pytest via tox with *python v3.7*
tox-py38             Run pytest via tox with *python v3.8*
pytest               Run pytest
update-rst-readme    update README.rst from README.creole
publish              Release new version to PyPi
download-roms        Download/Test only ROM files
profile              Profile the MC6809 emulation benchmark
benchmark            Run MC6809 emulation benchmark
editor               Run only the BASIC editor
Vectrex              Run GUI with Vectrex emulation (not working, yet!)
sbc09                Run GUI with sbc09 ROM emulation
Multicomp6809        Run GUI with Multicomp6809 ROM emulation
Simple6809           Run GUI with Simple6809 ROM emulation
CoCo2b               Run GUI with CoCo 2b emulation
Dragon32             Run GUI with Dragon 32 emulation
Dragon64             Run GUI with Dragon 64 emulation
run                  *Run the DragonPy Emulator GUI*

~/DragonPy$ make install-poetry
~/DragonPy$ make install
~/DragonPy$ make run

# use the CLI:
~/DragonPy$ poetry run DragonPy --help
~/DragonPy$ poetry run DragonPy

install in virtualenv 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

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

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/project/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/project/MC6809

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

• License: GNU GPL v3

pygments generic syntax highlighter

• Author: Georg Brandl

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

• http://pygments.org/

• License: BSD License