MediaWiki:Sitenotice:
2024-03-02: The wiki ran out of disk space, so things were not working. This has been resolved by adding another 5GB of quota ;-) Thanks to Tim Lindner for reporting the issues. 2020-05-17: If a page gives you an error about some revision not being found, just EDIT the page and the old page should appear in the editor. If it does, just SAVE that and the page should be restored. OS-9 Al (talk) 12:22, 17 May 2020 (CDT)

Getting Started with DriveWire: Difference between revisions

From CoCopedia - The Tandy/Radio Shack Color Computer Wiki
Jump to navigation Jump to search
m (fix some typos)
(Added pyDriveWire section with permission from Michael R. Furman)
(44 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 
{{NavDriveWire}}
 
A brief history and information guide to both DriveWire3 and DriveWire4 including separate installation guides for DW3 & DW4
== Forward ==
== Forward ==


DriveWire is a server side application used in Windows, MacOS (or Linux for DriveWire 4) to provide a disk emulation server for the Tandy/TRS-80 Color Computer series of home computers manufactured during the '80s & '90s.
DriveWire is a server side application used in Windows, MacOS (and Linux for DriveWire 4) to provide a disk emulation server for the Tandy/TRS-80 Color Computer series of home computers manufactured during the '80s & '90s.


DriveWire allows the mounting of virtual disk images on a PC style computer, to provide floppy disk emulation. Real floppy disk hardware is becoming difficult to find these days, so applications like DriveWire provide CoCo users a much needed for enjoying their Color Computers again. This Wiki page will attempt to provide the basic information needed to configure a DriveWire system for your CoCo.
DriveWire allows the mounting of virtual disk images on a PC style computer, to provide floppy disk emulation. Real floppy disk hardware is becoming difficult to find these days, so applications like DriveWire provide CoCo users a much needed storage method for enjoying their Color Computers again. This Wiki page will attempt to provide the basic information needed to configure a DriveWire system for your CoCo.


Out of respect for software authors, this Wiki page will not host or directly link to any files - links will only take you to the webpages where these files already exist, and can be downloaded from.  
Out of respect for software authors, this Wiki page will not host or directly link to any files - links will only take you to the webpages where these files already exist, and can be downloaded from.  


Also, DriveWire 4 is a 100% drop in replacement for DriveWire 3. DriveWire 4 simply (or not so simply) adds far more capability to an already excellent application.
Also, DriveWire 4 is a 100% drop in replacement for DriveWire 3. DriveWire 4 simply (or not so simply) adds far more capability to an already excellent application.
One more thing to keep in mind - DriveWire 3 and 4 can be used as a floppy disk emulator. However, there are some software packages that simply will not run when using floppy emulation. This is due to the author creating their own disk access routines, instead of using the RS-DOS DSKCON routines or in some cases, using a ROM/RAM copy routine that wipes Coco client side HDBDOS/DW3DOS from memory when they're running from disk or cassette. Until a successful hardware emulator is created that can accurately emulate the WD1773, then we are stuck with this situation.




----
----


One of the first things you will need is a cable. In order to connect your CoCo to a PC being used as a DriveWire server, you will need a bit-banger to DB-9 serial cable. Again, [http://www.cloud9tech.com Cloud9] sells these cables. Conversely, you may build your own based upon the following diagram:
== DriveWire Server ==
 
There are a number of DriveWire servers available. Your choice of server largely depends on the features you want and the requirements of your server operating system.
 
=== DriveWire 3 ===
 
{{GameInfoBox |
| picture= DriveWire3_Screenshot.jpg
| year= (?)
| media = Windows & Mac executable file
| requires = PC running Windows or Mac OSX
| graphic = PC/Mac Graphics
| publisher = [http://cloud9tech.com/Software/DriveWire3.html Cloud9 Technologies]
| author = Boisy Pitre
| notes = Server side software for PC or Mac with a serial connection to the Color Computer 3
}}
 
DriveWire 3 acted solely as a virtual disk server for a CoCo. Written by Boisy Pitre and sold thru [http://www.cloud9tech.com Cloud9], DriveWire3 is a great tool for those needing just a virtual disk server. The DriveWire 3 PC server software can be freely downloaded [http://www.frontiernet.net/~mmarlette/Cloud-9/Software/DriveWire3.html Here].
 
*[[DriveWire 3 Quick-Start Guide]]
*[[DriveWire 3 Troubleshooting]]
 
<br clear=all>
 
=== DriveWire 4 ===
 
{{GameInfoBox |
| picture= DriveWire4_Server.jpg
| year= (?)
| media = Windows, Linux & Mac executable file (Java based)
| requires = PC running Windows, Linux or Mac OSX (plus others)
| graphic = PC/Linux/Mac Graphics
| publisher = [https://sites.google.com/site/drivewire4/ CocoCoding/DriveWire4]
| author = Open Source
| notes = Server side software for PC, Linux, Mac, or any machine capable of running a JavaVM for serial connection to the Color Computer 1, 2, or 3
}}
 
DriveWire 4 is a Java version of DriveWire moved to an Open Source project, and has similar functionality to DriveWire 3. However, the developers have added many other features including: mounting of Internet based disk images, TCP, web server, MIDI control, print to a PC printer (emulates Epson MX-80 from CoCo side, compatible with most Epson and generic printer drivers for the CoCo) and many more.
 
To use DriveWire 4, you'll need Java version 8 - as DriveWire 4 is written in Java, it is OS agnostic; meaning it should run on anything that runs a Java 8 VM, including a Raspberry Pi running Linux. You can get a [http://www.java.com/en/download/manual.jsp JavaVM (here)] for most any type of popular operating system. However, if your operating system requires a more recent version of Java, you may need to try one of the other DriveWire server options.
 
You get get the most recent version or DriveWire 4 by visiting the [https://sites.google.com/site/drivewire4/ DriveWire4 distribution site] and following the links. As you'll soon see, DriveWire 4 supports several computing platforms including all versions of the CoCo. The documentation Wiki for DW4 can be found here: [http://sourceforge.net/apps/mediawiki/drivewireserver/index.php?title=Main_Page DW4 Wiki].
 
<br clear=all>
 
=== pyDriveWire ===
 
{{GameInfoBox |
| picture= PyDriveWire_Screenshot.jpg
| year= 2016
| media = Python source, Binary Package, Docker
| requires = Installers for Raspberry Pi 3,4, Linux, Windows, or macOS
| graphic = Web-based user interface
| publisher = [https://github.com/n6il/pyDriveWire n6il]
| author = Michael R. Furman
| notes = Python Implementation of DriveWire 4 and EmCee Protocols
}}
PyDriveWire is a nearly complete DriveWire4 Server written in Python. The goal is to eventually implement all of the features available. The server also implements additional features that are not available in DriveWire4.
 
PyDriveWire also has support for the EmCee Protocol for use with MCX Basic on the TRS-80 MC-10.
 
DriveWire 4 and EmCee Procotols can be used simultaneously on the server without reconfiguration.
 
*[https://github.com/n6il/pyDriveWire/blob/master/README.md The pyDriveWire README]
*[https://github.com/n6il/pyDriveWire/blob/master/docs/The%20pyDriveWire%20Manual.md#ch2 The pyDriveWire Manual v0.5c]
 
<br clear=all>
 
== The DriveWire Cable ==
 
Before you can use DriveWire 3 or 4, you will need to connect your CoCo to a computer being used as a DriveWire server. You will need a Coco Serial (bit-banger) to DB-9 serial cable. Again, [http://www.cloud9tech.com Cloud9] sells these cables. Conversely, you may build your own based upon the following diagram:
 


[[File:CoCo-serial-cable.png|center]]


[[File:Coco_to_pc_cable.gif]]


Also, if you have a more modern PC, it's most likely not to have the needed DB-9 serial port. As an alternative, you can puchase USB to Serial (DB-9) converters. These range in price from about $10 - $20 and can be purchased from most any electronics supply house. If they don't have it on the shelf, ask someone and they can most likely order it for you.  You will still need the cable above as this is just an adapter to be able to connect it to PC's with no DB-9 serial port.
Alternatively, you can also still purchase an add-on PCI or PCIx serial card. TigerDirect and NewEgg still stock a large selection of these cards. The internal serial cards tend to offer better data transfer rates than the USB to Serial adapters in testing.


----


== HDBDOS & DriveWire ==
== Drive Wire 3 ==


DriveWire 3 act solely as a virtual disk server for a CoCo. Written by Boisy Pitre and sold thru [http://www.cloud9tech.com Cloud9], DriveWire3 is a great tool for those needing just a virtual disk server. The DriveWire 3 PC server software can be downloaded [http://www.frontiernet.net/~mmarlette/Cloud-9/Software/DriveWire3.html Here].
(WIP)


Once you have downloaded the DriveWire software and connected the CoCo to your PC with the correct cable, you'll need to boot the CoCo with an HDB-DOS ROM image. This can be done with a ROM Pak with an HDB-DOS EPROM from Cloud9 (or someone else); loading thru the cassette port (from either a real cassette player or as a .wav file from a PC), an EPROM placed in a floppy controller or even an HDB-DOS ROM loaded from a .BIN file. Again, all of the files can be downloaded from the [http://www.frontiernet.net/~mmarlette/Cloud-9/Software/DriveWire3.html Cloud9] DriveWire3 page.
Once you have downloaded the DriveWire software and connected the CoCo to your PC with the correct cable, you'll need to boot the CoCo with an HDB-DOS ROM image. This can be done with a ROM Pak with an HDB-DOS EPROM from Cloud9 (or someone else); loading thru the cassette port (from either a real cassette player or as a .wav file from a PC), an EPROM placed in a floppy controller or even an HDB-DOS ROM loaded from a .BIN file. Again, all of the files can be downloaded from the [http://www.frontiernet.net/~mmarlette/Cloud-9/Software/DriveWire3.html Cloud9] DriveWire3 page.


*Contents of the [[DRIVEWIRE.ZIP]], containing the Rom files from the Cloud9 site.


----
== NitrOS-9 & DriveWire ==


(WIP)


== DriveWire 4 ==
NitrOS-9 cannot be booted directly, you need to bootstrap it from another DOS like HDB-DOS. Use the disk image that has _dw in the name.


DriveWire 4 is a Java version of DriveWire, written by Aaron Wolfe, and has similar functionality to DriveWire 3. However, Aaron has added many other features including: mounting of internet based disk images; TCP, web server, MIDI control and many more.
== Beginner's Guide to Installing DriveWire4, HDBDOS, and NitrOS-9 ==
by Bill Pierce


To use DriveWire 4, you still need the cable shown above. Next, you'll need a recent version of Java - as DriveWire 4 is written in Java, it is OS agnostic; meaning it should run on anything that runs a Java VM, including a Raspberry Pi.
(WIP)
*[[DW4 Installation Guide]] : A step by step guide to installing the "JavaVM", "DriveWire4", "HDBDOS", and "NitrOS-9 for DW4"


You get get the most recent version or DriveWire 4 by visiting [https://sites.google.com/site/drivewire4/ Aaron's website] and following the links. As you'll soon see, DriveWire 4 supports several computing platforms including all versions of the CoCo.
== Troubleshooting DriveWire ==


(WIP)


== MORE TO COME ==
== DriveWire, HDBDOS, & NitrOS-9 FAQs ==


(WIP)




----
----
MORE TO COME Soon

Revision as of 12:29, 28 April 2020

WELCOME
Looking for CoCo help? If you are trying to do something with your old Color Computer, read this quick reference. Want to contribute to this wiki? Be sure to read this first. This CoCo wiki project was started on October 29, 2004. --OS-9 Al

See Recent Changes. | About this site. | Join the E-Mail List or Facebook Group. | Contact me with updates/questions.

This page was last updated on 04/28/2020. Total Pages: 728. Total Files: 992.


Home / DriveWire - Getting Started with DriveWire


A brief history and information guide to both DriveWire3 and DriveWire4 including separate installation guides for DW3 & DW4

Forward

DriveWire is a server side application used in Windows, MacOS (and Linux for DriveWire 4) to provide a disk emulation server for the Tandy/TRS-80 Color Computer series of home computers manufactured during the '80s & '90s.

DriveWire allows the mounting of virtual disk images on a PC style computer, to provide floppy disk emulation. Real floppy disk hardware is becoming difficult to find these days, so applications like DriveWire provide CoCo users a much needed storage method for enjoying their Color Computers again. This Wiki page will attempt to provide the basic information needed to configure a DriveWire system for your CoCo.

Out of respect for software authors, this Wiki page will not host or directly link to any files - links will only take you to the webpages where these files already exist, and can be downloaded from.

Also, DriveWire 4 is a 100% drop in replacement for DriveWire 3. DriveWire 4 simply (or not so simply) adds far more capability to an already excellent application.

One more thing to keep in mind - DriveWire 3 and 4 can be used as a floppy disk emulator. However, there are some software packages that simply will not run when using floppy emulation. This is due to the author creating their own disk access routines, instead of using the RS-DOS DSKCON routines or in some cases, using a ROM/RAM copy routine that wipes Coco client side HDBDOS/DW3DOS from memory when they're running from disk or cassette. Until a successful hardware emulator is created that can accurately emulate the WD1773, then we are stuck with this situation.



DriveWire Server

There are a number of DriveWire servers available. Your choice of server largely depends on the features you want and the requirements of your server operating system.

DriveWire 3

Getting Started with DriveWire
Getting Started with DriveWire
Year (?)
Publisher Cloud9 Technologies
Author Boisy Pitre
Media Windows & Mac executable file
Requires PC running Windows or Mac OSX
Graphic mode PC/Mac Graphics
Notes Server side software for PC or Mac with a serial connection to the Color Computer 3

DriveWire 3 acted solely as a virtual disk server for a CoCo. Written by Boisy Pitre and sold thru Cloud9, DriveWire3 is a great tool for those needing just a virtual disk server. The DriveWire 3 PC server software can be freely downloaded Here.


DriveWire 4

Getting Started with DriveWire
Getting Started with DriveWire
Year (?)
Publisher CocoCoding/DriveWire4
Author Open Source
Media Windows, Linux & Mac executable file (Java based)
Requires PC running Windows, Linux or Mac OSX (plus others)
Graphic mode PC/Linux/Mac Graphics
Notes Server side software for PC, Linux, Mac, or any machine capable of running a JavaVM for serial connection to the Color Computer 1, 2, or 3

DriveWire 4 is a Java version of DriveWire moved to an Open Source project, and has similar functionality to DriveWire 3. However, the developers have added many other features including: mounting of Internet based disk images, TCP, web server, MIDI control, print to a PC printer (emulates Epson MX-80 from CoCo side, compatible with most Epson and generic printer drivers for the CoCo) and many more.

To use DriveWire 4, you'll need Java version 8 - as DriveWire 4 is written in Java, it is OS agnostic; meaning it should run on anything that runs a Java 8 VM, including a Raspberry Pi running Linux. You can get a JavaVM (here) for most any type of popular operating system. However, if your operating system requires a more recent version of Java, you may need to try one of the other DriveWire server options.

You get get the most recent version or DriveWire 4 by visiting the DriveWire4 distribution site and following the links. As you'll soon see, DriveWire 4 supports several computing platforms including all versions of the CoCo. The documentation Wiki for DW4 can be found here: DW4 Wiki.


pyDriveWire

Getting Started with DriveWire
Getting Started with DriveWire
Year 2016
Publisher n6il
Author Michael R. Furman
Media Python source, Binary Package, Docker
Requires Installers for Raspberry Pi 3,4, Linux, Windows, or macOS
Graphic mode Web-based user interface
Notes Python Implementation of DriveWire 4 and EmCee Protocols

PyDriveWire is a nearly complete DriveWire4 Server written in Python. The goal is to eventually implement all of the features available. The server also implements additional features that are not available in DriveWire4.

PyDriveWire also has support for the EmCee Protocol for use with MCX Basic on the TRS-80 MC-10.

DriveWire 4 and EmCee Procotols can be used simultaneously on the server without reconfiguration.


The DriveWire Cable

Before you can use DriveWire 3 or 4, you will need to connect your CoCo to a computer being used as a DriveWire server. You will need a Coco Serial (bit-banger) to DB-9 serial cable. Again, Cloud9 sells these cables. Conversely, you may build your own based upon the following diagram:



Also, if you have a more modern PC, it's most likely not to have the needed DB-9 serial port. As an alternative, you can puchase USB to Serial (DB-9) converters. These range in price from about $10 - $20 and can be purchased from most any electronics supply house. If they don't have it on the shelf, ask someone and they can most likely order it for you. You will still need the cable above as this is just an adapter to be able to connect it to PC's with no DB-9 serial port.

Alternatively, you can also still purchase an add-on PCI or PCIx serial card. TigerDirect and NewEgg still stock a large selection of these cards. The internal serial cards tend to offer better data transfer rates than the USB to Serial adapters in testing.


HDBDOS & DriveWire

(WIP)

Once you have downloaded the DriveWire software and connected the CoCo to your PC with the correct cable, you'll need to boot the CoCo with an HDB-DOS ROM image. This can be done with a ROM Pak with an HDB-DOS EPROM from Cloud9 (or someone else); loading thru the cassette port (from either a real cassette player or as a .wav file from a PC), an EPROM placed in a floppy controller or even an HDB-DOS ROM loaded from a .BIN file. Again, all of the files can be downloaded from the Cloud9 DriveWire3 page.

  • Contents of the DRIVEWIRE.ZIP, containing the Rom files from the Cloud9 site.

NitrOS-9 & DriveWire

(WIP)

NitrOS-9 cannot be booted directly, you need to bootstrap it from another DOS like HDB-DOS. Use the disk image that has _dw in the name.

Beginner's Guide to Installing DriveWire4, HDBDOS, and NitrOS-9

by Bill Pierce

(WIP)

  • DW4 Installation Guide : A step by step guide to installing the "JavaVM", "DriveWire4", "HDBDOS", and "NitrOS-9 for DW4"

Troubleshooting DriveWire

(WIP)

DriveWire, HDBDOS, & NitrOS-9 FAQs

(WIP)



MORE TO COME Soon