DWLOAD server implemented in Python
Project description
DWLOAD Server
DWLOAD server implemented in Python (OpenSource, GPL v3 or above).
Connect your Dragon 32 into your PC and LOAD/SAVE basic listings.
Quickstart
~$ git clone https://github.com/6809/DwLoadServer.git
~$ cd DwLoadServer
~/DwLoadServer$ ./devshell.py run serial
features
- 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.
current state
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 |
TODO
- enhance
AUTOLOAD.DWL.py
, see: http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4977 - compare checksum
- write unittests
pyscripts
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)
dynamic "AUTOLOAD.DWL"
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 |
on-the-fly converting ASCII BASIC listing
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 |
installation
Clone sources and bootstrap via dev-shell, e.g.:
~$ git clone https://github.com/6809/DwLoadServer.git
~$ cd DwLoadServer
~/DwLoadServer$ ./devshell.py
...
Developer shell - DWLOAD Server - v0.4.0
Documented commands (use 'help -v' for verbose/'help <topic>' for details):
dev-shell commands
==================
fix_code_style poetry pytest tox
list_venv_packages publish pyupgrade update
DWLOAD Server Commands
======================
run
Uncategorized
=============
alias help history macro quit set shortcuts
(dwload_server) run --help
Usage: run [-h] [--root-dir ROOT_DIR] [--log-level {0, 10, 20, 30, 30, 40, 50, 50, 99, 100}] {becker, serial} ...
optional arguments:
-h, --help show this help message and exit
--root-dir ROOT_DIR
--log-level {0, 10, 20, 30, 30, 40, 50, 50, 99, 100}
Logging level: 10=DEBUG, 20=INFO, 30=WARNING, 40=ERROR, 50=CRITICAL/FATAL (default: 20)
Interface:
{becker, serial}
becker Use the Becker interface
serial Use the serial interface
(dwload_server) run serial
You can also run as cli, e.g.: Start serial DWLOAD server:
~/DwLoadServer$ ./devshell.py run serial
History
- dev
- ...tbc...
- 11.09.2022 - v0.5.0
- Modernize project
- Easier bootstrap via dev-shell
- 20.11.2014 - v0.4.0
- dynamic
AUTOLOAD.DWL
via Python script
- dynamic
- 19.11.2014 - v0.3.0
- Convert "ASCII BASIC listing" <-> "Dragon DOS Binary" on-the-fly while read/write
- 17.11.2014 - v0.2.0
- Support Becker and Serial interface.
- 14.11.2014 - v0.1.0 - Create bootstrap file that work under linux and windows.
- 12.11.2014 - v0.0.1 - send a file works rudimentary
- 30.09.2014 - Idea was born: Forum post 11893
Links
Forum Thread (en) | worldofdragon.org |
Forum Thread (de) | forum.classic-computing.de |
PyPi | https://pypi-hypernode.com/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/
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file dwload_server-0.5.1.tar.gz
.
File metadata
- Download URL: dwload_server-0.5.1.tar.gz
- Upload date:
- Size: 30.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | f1ce42c6113ae73f6e591dc4b1e94aec32e5a56ed6f8339e4fe8e7a16785e943 |
|
MD5 | 5cec6e9730c3e2b44c7853d6516bfaee |
|
BLAKE2b-256 | f03b0c96ea9f6c0bc20e14f7cafddae14cb287f891cec5239daf548b3525bacd |
File details
Details for the file dwload_server-0.5.1-py3-none-any.whl
.
File metadata
- Download URL: dwload_server-0.5.1-py3-none-any.whl
- Upload date:
- Size: 34.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 747436d80377ec9b8805688f2139b96c85e9662f968a27ced1b14921c1c1efdf |
|
MD5 | a320393dc17a81897f3c6569f43fb8f3 |
|
BLAKE2b-256 | 4a03b15dc6a9b9d97a02c4048370abf044b38de8935ba0bf584c5358db1ac5da |