dwload-server 0.3.0

DWLOAD server implemented in Python

DWLOAD server implemented in Python (OpenSource, GPL v3 or above).

features

Here a feature list:

• load/save files via DWLOAD

• on-the-fly converting ASCII BASIC listing (see below)

• backup all files on save

current state

Only tested with Python 3 !

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
$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

• compare checksum

• add support for Python 2.7

• write unittests

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.

installation

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/6809/DwLoadServer/master/boot_dwload_server.py

There are tree types of installation:

option	desciption
pypi	use Python Package Index (for all normal user!)
git_readonly	use git to get the sourcecode (for developer without write access)
dev	use git with write access

e.g.:

/home/FooBar$ python3 boot_dwload_server.py ~/DwLoadServer_env --install_type git_readonly

This creates a virtualenv in ``~/DwLoadServer_env`` and used git to checkout the needed repositories.

In this case (using –install_type=**git_readonly**) the git repository are in: …/DwLoadServer_env/src/ So you can easy update them e.g.:

/home/FooBar$ cd ~/DwLoadServer_env/src/dwload-server
/home/FooBar/DwLoadServer_env/src/dwload-server$ git pull

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 DWLOAD Server git snapshot from Github: master.zip

• Extract the Archive somewhere

• Maybe, adjust paths in boot_dwload_server.cmd

• Run boot_dwload_server.cmd

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

There are two batch files, for easy startup the server under Windows:

• /scripts/start_serial_DWLOAD_server.cmd

• /scripts/start_becker_DWLOAD_server.cmd

Copy these files into %APPDATA%\DwLoadServer_env\ and edit it for your needs. Just double click to start the server.

start by cli (windows)

There is a batch file to open a commandline with a activated virtualenv:

• /scripts/cmd_here.cmd

copy this into %APPDATA%\DwLoadServer_env\ and double click it ;)

by hand: Start cmd.exe and do this:

C:\Windows\system32>cd /d %APPDATA%\DwLoadServer_env\
C:\Users\FOO\AppData\Roaming\DwLoadServer_env>call Scripts\activate.bat
(DwLoadServer_env) C:\Users\FOO\AppData\Roaming\DwLoadServer_env>

So use the DWLOAD-Server CLI, e.g:

(DwLoadServer_env) C:\Users\FOO\AppData\Roaming\DwLoadServer_env> python.exe -m dwload_server.dwload_server_cli --root_dir=%APPDATA%\dwload-files\ --log_level=10 serial --port=COM3

Do see the CLI help page:

(DwLoadServer_env) C:\Users\FOO\AppData\Roaming\DwLoadServer_env> python.exe -m dwload_server.dwload_server_cli --help

DWLOAD Server written in Python (GNU GPL v3+) v0.2.0

usage: dwload_server_cli.py [-h] [--version] [--root_dir ROOT_DIR]
                            [--log_level {0,10,20,30,30,40,50,99,100}]
                            {becker,serial} ...

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  --root_dir ROOT_DIR   Server root directory for load/store requested files
  --log_level {0,10,20,30,30,40,50,99,100}
                        Logging level: 10=DEBUG, 20=INFO, 30=WARNING,
                        40=ERROR, 50=CRITICAL/FATAL

Interface:
  {becker,serial}
    becker              Use the Becker interface
    serial              Use the serial interface

example usage:
    dwload_server_cli.py --root_dir=./dwload-files/ serial --port=/dev/ttyUSB0
    dwload_server_cli.py --root_dir=./dwload-files/ becker

Interface help:
    dwload_server_cli.py serial --help
    dwload_server_cli.py becker --help

startup linux

There are two shell scripts, for easy startup the server under Linux:

• /scripts/start_serial_DWLOAD_server.sh

• /scripts/start_becker_DWLOAD_server.sh

Copy these files into ~/DwLoadServer_env/ and edit it for your needs.

The default DWLOAD-Server-root-directory is: ~/dwload-files/ e.g.: Download dwload-demo-files.tar.xz.zip from http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4964 and extract the files into ~/dwload-files/

start by cli (linux)

e.g.:

/home/FooBar $ cd ~/DwLoadServer_env/
/home/FooBar/DwLoadServer_env/ $ source bin/activate
(DwLoadServer_env) ~/DwLoadServer_env $ python3 -m dwload_server.dwload_server_cli --root_dir=~/dwload-files --log_level=10 serial --port=/dev/ttyUSB0

Display CLI help, e.g:

/home/FooBar $ cd ~/DwLoadServer_env/
/home/FooBar/DwLoadServer_env/ $ source bin/activate
(DwLoadServer_env) ~/DwLoadServer_env $ python3 -m dwload_server.dwload_server_cli --help

DWLOAD Server written in Python (GNU GPL v3+) v0.2.0

usage: dwload_server_cli.py [-h] [--version] [--root_dir ROOT_DIR]
                            [--log_level {0,10,20,30,30,40,50,99,100}]
                            {becker,serial} ...

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  --root_dir ROOT_DIR   Server root directory for load/store requested files
  --log_level {0,10,20,30,30,40,50,99,100}
                        Logging level: 10=DEBUG, 20=INFO, 30=WARNING,
                        40=ERROR, 50=CRITICAL/FATAL

Interface:
  {becker,serial}
    becker              Use the Becker interface
    serial              Use the serial interface

example usage:
    dwload_server_cli.py --root_dir=./dwload-files/ serial --port=/dev/ttyUSB0
    dwload_server_cli.py --root_dir=./dwload-files/ becker

Interface help:
    dwload_server_cli.py serial --help
    dwload_server_cli.py becker --help

History

• 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	http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=8&t=4946
IRC	#pylucid on freenode.net
Jabber	[e-mail]
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/