DWLOAD server implemented in Python (OpenSource, GPL v3 or above).
Connect your Dragon 32 into your PC and LOAD/SAVE basic listings.
~$ git clone https://github.com/6809/DwLoadServer.git
~$ cd DwLoadServer
~/DwLoadServer$ ./cli.py run --helpThe help page looks like:
usage: ./cli.py run [-h] [RUN OPTIONS]
Start the DWLOAD server.
╭─ options ────────────────────────────────────────────────────────────────────────╮
│ -h, --help show this help message and exit │
│ --root-dir PATH Root path for dwload files (default: /home/jens/dwload-files) │
│ --interface STR Use interface: "becker" or "serial" (default: becker) │
│ --ip STR IP address for the interface (default: 127.0.0.1) │
│ --port INT Port number (default: 65504) │
│ --serial-port STR Serial port for serial interface (default: /dev/ttyUSB0) │
│ -v, --verbosity Verbosity level; e.g.: -v, -vv, -vvv, etc. (repeatable) │
╰──────────────────────────────────────────────────────────────────────────────────╯
- load/save files via DWLOAD
- on-the-fly converting ASCII BASIC listing (see below)
- dynamic "AUTOLOAD.DWL" (see below)
- backup all files on save
- Support USB Adapter and Becker TCP/IP Interface.
Tested DWEEBS:
| DWEEB | example | Description |
|---|---|---|
| DLOAD | DLOAD |
Load AUTOLOAD.DWL (Used on Dragon startup) |
| SAVE | DLOAD"SAVE""MYFILE.BAS" |
Save BASIC listing |
| RESAVE | DLOAD"RESAVE""MYFILE.BAS" |
Save BASIC listing |
Implemented DriveWire Transactions:
| hex | dez | DW name | Description |
|---|---|---|---|
| $00 | 0 | OP_NOP | NOP Transaction -> ignored |
| $01 | 1 | OP_NAMEOBJ_MOUNT | Mount a file to a virtual drive number |
| $02 | 2 | OP_NAMEOBJ_CREATE | (Does in this implementation the same as OP_NAMEOBJ_MOUNT) |
| $d2 | 210 | OP_READEX | Send 256 bytes sector from the DWLOAD server to the client |
| $57 | 87 | OP_WRITE | Write 256 bytes sector of data from the client into a file on the server |
- enhance
AUTOLOAD.DWL.py, see: http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4977 - compare checksum
- write unittests
There is a general machanism to generate DLOAD responses via Python:
- Store in server root a python script, e.g.: "FOO.BAR.py"
- DLOAD the file (without .py extension) on client, e.g.:
DLOAD"FOO.BAR"
The script will be called via subprocess and it must write the Dragon DOS binary data back to stdout.
Currently, there is only one pyscript file: AUTOLOAD.DWL.py (see below)
There exist a way to generate a dynamic DWLOAD menu. Just copy the file /dwload-demo-files/AUTOLOAD.DWL.py into your server root.
The pyscript reads the server root directory and list all files into the DLOAD menu. e.g. the server root looks like this:
/HOME/FOO/DWLOAD-FILES
+--- AUTOLOAD.DWL.py
+--- HEXVIEW.BAS
+--- TEST.BAS
\--- SAVE
The generated listing looks like this:
10 CLS
20 PRINT" *** DYNAMIC MENU *** 14:11:18"
30 PRINT"/HOME/FOO/DWLOAD-FILES"
40 PRINT" 0 - HEXVIEW.BAS"
50 PRINT" 1 - TEST.BAS"
60 PRINT" 2 - SAVE"
70 PRINT"PLEASE SELECT (X FOR RELOAD) !"
80 A$=INKEY$:IF A$="" GOTO 80
90 IF A$="X" THEN DLOAD
100 IF A$="0" THEN DLOAD"HEXVIEW.BAS"
110 IF A$="1" THEN DLOAD"TEST.BAS"
120 IF A$="2" THEN DLOAD"SAVE"
130 GOTO 10
s.: http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4977
You must only call DLOAD on you Dragon to get this menu. Because a DLOAD will request AUTOLOAD.DWL and the Python server will all .py and call AUTOLOAD.DWL.py if exist.
This feature make the following file:
| /dwload_server/hooks/dynamic_dwl.py | general API to 'pyscript' files | | /dwload_server/pyscripts/autoload_dwl.py | generates the DWLOAD menu |
The server read/save ASCII BASIC listing and send/store them to the DWLOAD client on-the-fly. So you can edit listings on your PC and try them on your Dragon without any external conventions!
e.g.: save
10 PRINT"HELLO WORLD!"
DLOAD"SAVE""HELLO.BAS"
DWLOAD
!
OK
The server will create two files:
| filename | format | description |
|---|---|---|
| HELLO.DWL | raw tokenized binary | Dragon DOS Binary Format data from the Dragon (256 Bytes padded) |
| HELLO.BAS | ASCII listing | on-the-fly converted ASCII BASIC listing |
e.g. load (and execute):
DLOAD"HELLO.BAS"
!HELLO WORLD!
OK
(Note: the first ! is from DWLOAD ROM routine)
The server will read the HELLO.BAS ASCII listing and convert is on-the-fly to the needed Dragon DOS Binary Format
and send this back to the Dragon.
This feature make the following files:
| /dwload_server/hooks/read_ascii.py | read ASCII listing and send as binary to client | | /dwload_server/hooks/save_ascii.py | save binary from client as ASCII on server |
Currently just clone the project and just start the cli (that will create a virtualenv and installs every dependencies)
e.g.:
~$ git clone https://github.com/6809/DwLoadServer.git
~$ cd DwLoadServer
~/DwLoadServer$ ./cli.py --helpThe output of ./cli.py --help looks like:
usage: ./cli.py [-h] {run,version}
╭─ options ────────────────────────────────────╮
│ -h, --help show this help message and exit │
╰──────────────────────────────────────────────╯
╭─ subcommands ────────────────────────────────╮
│ (required) │
│ • run Start the DWLOAD server. │
│ • version Print version and exit │
╰──────────────────────────────────────────────╯
You can also run as cli, e.g.: Start serial DWLOAD server:
~/DwLoadServer$ ./devshell.py run serialUse the dev. CLI:s ./dev-cli.py --help looks like:
usage: ./dev-cli.py [-h] {coverage,install,lint,mypy,nox,pip-audit,publish,test,update,update-readme-history,update-test-snapshot-files,version}
╭─ options ────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ -h, --help show this help message and exit │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ subcommands ────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ (required) │
│ • coverage Run tests and show coverage report. │
│ • install Install requirements and 'dwload_server' via pip as editable. │
│ • lint Check/fix code style by run: "ruff check --fix" │
│ • mypy Run Mypy (configured in pyproject.toml) │
│ • nox Run nox │
│ • pip-audit │
│ Run pip-audit check against current requirements files │
│ • publish Build and upload this project to PyPi │
│ • test Run unittests │
│ • update Update dependencies (uv.lock) and git pre-commit hooks │
│ • update-readme-history │
│ Update project history base on git commits/tags in README.md Will be exited with 1 if the README.md │
│ was updated otherwise with 0. │
│ │
│ Also, callable via e.g.: │
│ python -m cli_base update-readme-history -v │
│ • update-test-snapshot-files │
│ Update all test snapshot files (by remove and recreate all snapshot files) │
│ • version Print version and exit │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
- v0.6.0
- 2025-12-16 - Update README
- 2025-12-16 - Migrate to UV
- 2023-09-24 - Update requirements
- v0.5.1
- 2023-05-01 - Remove Python 3.8 support and bump version to v0.5.1
- 2023-05-01 - add flake8 config
- 2023-05-01 - Update requirements
- 2022-09-11 - update git ignore
- v0.5.0
- 2022-09-11 - bugfix publishing
- 2022-09-11 - update git ignore
- 2022-09-11 - README
- 2022-09-11 - update README
- 2022-09-11 - command cli() call
- 2022-09-10 - code cleanup
- 2022-09-10 - Add "OP NOP"
- 2022-09-10 - update code style
- 2022-09-10 - bugfixes
- 2022-09-10 - Move CLI into dev-shell
- 2022-09-10 - Add editor config
- 2022-09-09 - pyupgrade
- 2022-09-09 - use dev-shell
- 2022-09-09 - Replace README.creole with markdown
- 2014-11-20 - even more info
- 2014-11-20 - more info
- v0.4.0
- 2014-11-20 - update README
- 2014-11-20 - cosmetics
- 2014-11-20 - dynamic AUTOLOAD.DWL works!
- 2014-11-14 - WIP: dynamic 'pyscript' files.
- 2014-11-20 - bugfixes
- 2014-11-19 - merge has_extension() func
- 2014-11-19 - Update README.creole
- 2014-11-19 - add TODO: dynamic "AUTOLOAD.DWL"
Expand older history entries ...
- v0.3.0
- 2014-11-19 - Bugfix for ReSt
- 2014-11-19 - fix write filename handling
- 2014-11-19 - display type of a hook
- 2014-11-19 - Bugfix: save/read ASCII BASIC listings
- 2014-11-19 - remove obsolete file
- 2014-11-19 - bugfix: missing root_logger
- 2014-11-19 - "implement" OP_NAMEOBJ_CREATE
- 2014-11-18 - add note that only python 3 is useable, yet.
- 2014-11-18 - display content on parse error
- 2014-11-18 - Bugfix save listing
- 2014-11-17 - WIP: convert ASCII file on-the-fly
- 2014-11-17 - WIP: Split the hook codes
- 2014-11-17 - backup rename before create ASCII listing
- 2014-11-17 - WIP: Sabe BASIC as ASCII listing, too.
- 2014-11-17 - remove obsolete phrase... ;)
- v0.2.0
- 2014-11-17 - add MANIFEST.in
- 2014-11-17 - update README
- 2014-11-17 - refactor:
- 2014-11-17 - update serial server
- 2014-11-16 - Bugfix: Wait until all bytes are received
- 2014-11-16 - Display checksum
- 2014-11-16 - WIP: Refactor for reconnect
- 2014-11-16 - WIP: Add becker interface support
- 2014-11-15 - repro transfer: DWLOAD -> 6809
- 2014-11-14 - Add a batch file for windows to startup the server
- v0.1.1
- 2014-11-14 - update boot scripts/README
- 2014-11-14 - +.idea
- 2014-11-14 - add git update info
- 2014-11-14 - Bugfix install as editable
- 2014-11-14 - add virtualenv
- 2014-11-14 - Bugfix: install git repro as editable
- 2014-11-14 - add missing OPs in README
- 2014-11-14 - update README
- 2014-11-14 - Add DocStrings
- 2014-11-14 - add error code handling
- 2014-11-14 - Helpfull error message
- 2014-11-14 - Bugfix CLI
- 2014-11-14 - Add missing own package ;)
- 2014-11-14 - Add working bootstrap file.
- 2014-11-13 - WIP: add bootstrap script and create real package
- 2014-11-13 - save files work
- 2014-11-12 - initial commit
| Forum Thread (en) | worldofdragon.org |
| Forum Thread (de) | forum.classic-computing.de |
| PyPi | https://pypi.python.org/pypi/dwload_server/ |
| Github | https://github.com/6809/DwLoadServer |
some project related links:
- About DWLOAD: http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4964
- DWEEBS application Thread: http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968
- Dragon 32/64 DriveWire Adapter: http://archive.worldofdragon.org/index.php?title=Dragon_32/64_Drivewire_Adapter
- Drivewire for dummies: http://archive.worldofdragon.org/index.php?title=Drivewire_for_dummies
- http://sourceforge.net/p/drivewireserver/wiki/DriveWire_Specification/
- http://sourceforge.net/p/drivewireserver/wiki/