Difference between revisions of "Dweebs"

From The Dragon Archive
(SAVE/RESAVE)
 
(13 intermediate revisions by 2 users not shown)
Line 14: Line 14:
  
 
   DLOAD"VLOAD""MYIMAGE.VDK""MYFILE.BAS"
 
   DLOAD"VLOAD""MYIMAGE.VDK""MYFILE.BAS"
 
 
   DLOAD"DOS"
 
   DLOAD"DOS"
 
 
   DLOAD"LROM""GAME.ROM"
 
   DLOAD"LROM""GAME.ROM"
  
 
== How do you install them? ==
 
== How do you install them? ==
  
To do ...
+
Normally, dweebs live in the top directory of your Drivewire server - simply unzip the archive and put the files in there. However, you can create subdirectories in your Drivewire directory, for example:
 +
 
 +
  DLOAD"DWEEB/DATE"
 +
  DLOAD"VDK/VDIR""DISK.VDK"
 +
 
 +
You can also use variables with your dweebs, for example:
 +
 
 +
  D$="DWEEB/DATE"
 +
  DLOADD$
  
 
== The Dweeb Directory ==
 
== The Dweeb Directory ==
Line 27: Line 33:
 
This is a list of the known Dweebs, extracted from posts on the forum. Please feel free to add any others to this list.  
 
This is a list of the known Dweebs, extracted from posts on the forum. Please feel free to add any others to this list.  
 
''Note:'' CocoSDC users will use DWLOAD instead of DLOAD for all these examples.
 
''Note:'' CocoSDC users will use DWLOAD instead of DLOAD for all these examples.
 +
 +
=== File Manipulation Dweebs ===
 +
 +
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&p=12300&hilit=LDAF#p12300 LDAF] ====
 +
Allows the user to load an ASCII basic file.
 +
  DLOAD"LDAF""HELLO.BAS"
 +
''Note:'' See [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&hilit=LDAF&start=50#p14791 this post]] for the latest version. Also note that LDA (and the original version of LDAF) '''only''' work with DOS files.
  
 
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968#p12106 LROM] ====
 
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968#p12106 LROM] ====
 
Allows the user to load (and run) any ROM file.
 
Allows the user to load (and run) any ROM file.
 
   DLOAD"LROM""ROMName (no need to put the .ROM extension)
 
   DLOAD"LROM""ROMName (no need to put the .ROM extension)
 +
 +
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&hilit=CAS&start=50#p13706 CAS] ====
 +
A simple CAS parser to load CAS files directly from the DriveWire server.
 +
  DLOAD"CAS""MYFILE.CAS"
 +
 +
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4964 SAVE/RESAVE] ====
 +
Save a basic program to the DriveWire server. ''Note:'' The commonly used Java based DW4 server currently doesn't support saving to a new file. In this case, use RESAVE to save over the top of an existing, possibly empty, file.
 +
  DLOAD"SAVE""MYFILE.BAS"
 +
  DLOAD"RESAVE""MYFILE.BAS"
 +
 +
=== Disk Manipulation Dweebs ===
  
 
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&hilit=FLO2V#p12107 FLO2V] ====
 
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&hilit=FLO2V#p12107 FLO2V] ====
 
Allows copying a floppy from the default Dragon drive to a new VDK file in the PC Windows file system so you can save a backup of the disk and use it on XRoar as well.
 
Allows copying a floppy from the default Dragon drive to a new VDK file in the PC Windows file system so you can save a backup of the disk and use it on XRoar as well.
 
   DLOAD"FLO2V""VDKName.VDK"
 
   DLOAD"FLO2V""VDKName.VDK"
'Note:"" See [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&hilit=VLOAD&start=40#p13154 this post]] for the latest version
+
''Note:'' See [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&hilit=VLOAD&start=40#p13154 this post]] for the latest version
  
 
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&hilit=V2FLO#p12107 V2FLO] ====
 
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&hilit=V2FLO#p12107 V2FLO] ====
 
Allows copying an VDK to a floppy on the default Dragon drive to restore a previous backup or simply to transfer a XRoar disk to the real Dragon drives.
 
Allows copying an VDK to a floppy on the default Dragon drive to restore a previous backup or simply to transfer a XRoar disk to the real Dragon drives.
 
   DLOAD"V2FLO""VDKName.VDK"
 
   DLOAD"V2FLO""VDKName.VDK"
''Note:"" See [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&hilit=VLOAD&start=40#p13154 this post]] for the latest version
+
''Note:'' See [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&hilit=VLOAD&start=40#p13154 this post]] for the latest version
  
 
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&hilit=VDIR#p12108 VDIR] ====
 
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&hilit=VDIR#p12108 VDIR] ====
Line 52: Line 76:
 
''Note:'' Also see [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&hilit=VLOAD&start=30#p13037 this post] for the latest version.
 
''Note:'' Also see [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&hilit=VLOAD&start=30#p13037 this post] for the latest version.
  
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&p=12300&hilit=LDAF#p12300 LDAF] ====
+
=== Drivewire and other Dweebs ===
Allows the user to load an ASCII basic file.
+
 
   DLOAD"LDAF""HELLO.BAS"
+
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4964 DATE] ====
''Note:'' See [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&hilit=LDAF&start=50#p14791 this post]] for the latest version. Also note that LDA (and the original version of LDAF 'only' work with DOS files]]
+
Displays date and time from the DW4 server
 +
   DLOAD"DATE"
  
 
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&hilit=DW&start=10#p12164 DW] ====
 
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&hilit=DW&start=10#p12164 DW] ====
 
Sends requests to the DriveWire server.
 
Sends requests to the DriveWire server.
 
   DLOAD"DW""DW SERVER STATUS"
 
   DLOAD"DW""DW SERVER STATUS"
 
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4968&hilit=CAS&start=50#p13706 CAS] ====
 
A simple CAS parser to load CAS files directly from the DriveWire server.
 
  DLOAD"CAS""MYFILE.CAS"
 
 
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4964 SAVE/RESAVE] ====
 
Save a basic program to the DriveWire server. ''Note:'' The commonly used java based DW4 server doesn't support saving files. In this case, use RESAVE to save over the top of an existing, possibly empty, file.
 
  DLOAD"SAVE""MYFILE.BAS"
 
  DLOAD"RESAVE""MYFILE.BAS"
 
  
 
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4964 DOS] ====
 
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4964 DOS] ====
Boot from disk 0 on DW4 server (for launching NitrOS-9)
+
Boot from disk 0 on DW4 server (for launching [[NitrOS-9]])
 
   DLOAD"DOS"
 
   DLOAD"DOS"
  
==== [http://archive.worldofdragon.org/phpBB3/viewtopic.php?f=5&t=4964 DATE] ====
+
[[Category:Documentation]][[Category:Drivewire]]
Displays date and time from the DW4 server
 
  DLOAD"DATE"
 

Latest revision as of 15:23, 3 June 2016

What are dweebs?

They're 'DWLOAD Extensible Execution Blocks', a method for extending the functionality of DWLOAD, a tool used to access DriveWire.

How do they work?

The DWLOAD client is relatively simple, due to the space constraints in the ROM. The dweeb is a mechanism to dynamically extend the functionality of DWLOAD. The dweeb is loaded from the server like any other program, but accesses the I/O routines of DWLOAD. It also reads its command parameters from the DWLOAD command line.

The best example is the "SAVE" dweeb. There is not enough room in the ROM to include support for saving files over DriveWire. However, this functionality can be loaded on demand. DLOAD"SAVE""MYFILE.BAS" saves a BASIC program to the DriveWire server. The SAVE functionality is only temporarily loaded into RAM and used during this invocation.

Since a dweeb uses the I/O routines of the calling DWLOAD, it is independent of the real transport being used, which makes development with for instance the Becker interface in XRoar very convenient.

Examples:

  DLOAD"VLOAD""MYIMAGE.VDK""MYFILE.BAS"
  DLOAD"DOS"
  DLOAD"LROM""GAME.ROM"

How do you install them?

Normally, dweebs live in the top directory of your Drivewire server - simply unzip the archive and put the files in there. However, you can create subdirectories in your Drivewire directory, for example:

  DLOAD"DWEEB/DATE"
  DLOAD"VDK/VDIR""DISK.VDK"

You can also use variables with your dweebs, for example:

  D$="DWEEB/DATE"
  DLOADD$

The Dweeb Directory

This is a list of the known Dweebs, extracted from posts on the forum. Please feel free to add any others to this list. Note: CocoSDC users will use DWLOAD instead of DLOAD for all these examples.

File Manipulation Dweebs

LDAF

Allows the user to load an ASCII basic file.

  DLOAD"LDAF""HELLO.BAS"

Note: See this post] for the latest version. Also note that LDA (and the original version of LDAF) only work with DOS files.

LROM

Allows the user to load (and run) any ROM file.

  DLOAD"LROM""ROMName (no need to put the .ROM extension)

CAS

A simple CAS parser to load CAS files directly from the DriveWire server.

  DLOAD"CAS""MYFILE.CAS"

SAVE/RESAVE

Save a basic program to the DriveWire server. Note: The commonly used Java based DW4 server currently doesn't support saving to a new file. In this case, use RESAVE to save over the top of an existing, possibly empty, file.

  DLOAD"SAVE""MYFILE.BAS"
  DLOAD"RESAVE""MYFILE.BAS"

Disk Manipulation Dweebs

FLO2V

Allows copying a floppy from the default Dragon drive to a new VDK file in the PC Windows file system so you can save a backup of the disk and use it on XRoar as well.

  DLOAD"FLO2V""VDKName.VDK"

Note: See this post] for the latest version

V2FLO

Allows copying an VDK to a floppy on the default Dragon drive to restore a previous backup or simply to transfer a XRoar disk to the real Dragon drives.

  DLOAD"V2FLO""VDKName.VDK"

Note: See this post] for the latest version

VDIR

Produces a directory list of the disk image.

  DLOAD"VDIR""DiskName"

Note: See this post for the latest version

VLOAD

Allows the user to load and run/execute any program contained in any VDK image

  DLOAD"VLOAD""DiskName""FileName.Ext"

Note: Also see this post for the latest version.

Drivewire and other Dweebs

DATE

Displays date and time from the DW4 server

  DLOAD"DATE"

DW

Sends requests to the DriveWire server.

  DLOAD"DW""DW SERVER STATUS"

DOS

Boot from disk 0 on DW4 server (for launching NitrOS-9)

 DLOAD"DOS"