Ira Goldklang's TRS-80 Revived Site

Getting Software Onto An Emulator

        


         How do I Run a File I Have Downloaded?
Step By Step Instructions on How to Use a Downloaded File (Windows)
This example is meant to be beginning to end step-by-step instructions on how to take a file which has been downloaded from the internet, and run it in a TRS-80 emulator
For purposes of this example, I will assume:
1) That you downloaded a zip file named "FILENAME.ZIP" containing the file named "FILENAME.CMD"
2) That you have a copy of PKUNZIP for DOS somewhere in your path
3) You want to put it on a disk image named "DSKIMAGE.DSK"
4) Your TRS-80 directory on your hard drive is located at "C:\TRS-80"
5) Items in BOLD should be typed as is (modified to change the assumptions in 1-3)
6) "[ENTER]" means to hit the enter key; "[TAB]" means hit the tab key; "[F9]" means hit the F9 key, etc.
7) That you know how to unzip a file, make a directory, download from the internet, and go to a DOS prompt.
8) That have obtained ROMs for the computer. I will not provide these ROMs but they can be easily found on the net.
Steps
1. Download the file you want from the internet (download to C:\TRS-80)
2. Click here to download Jeff Vavaour's File Utilities (download to C:\TRS-80)
3. Click here to download a Model 1 Boot Disk (download to C:\TRS-80)
4. Go to DOS PROMPT under Windows
5. CD\TRS-80 [ENTER]
6. PKUNZIP FILENAME [ENTER]
7. PKUNZIP JVFILES [ENTER]
8. PKUNZIP LDOS531 [ENTER]
9. VFORMAT 35 DSKIMAGE [ENTER]
(It should say 'Formatting 35 tracks. Done.')
10. VWRITE FILENAME.CMD DSKIMAGE [ENTER]
(It should say 'Writing FILENAME.CMD')
11. Start the emulator, mount the disks, reboot the emulator ...
Step Jeff Vavasour's
Model I Emulator		Matthew Reed's Model I
DOS Emulator		Dave Keil's
Model I Emulator		Matthew Reed's Model I
Windows Emulator
Run the Emulator MODEL1 [Enter]TRS [Enter]TRS81 [Enter] Doubleclick on TRS23
Mount Roms (Needs to already have been placed in emulator directory) If you get a
"ROM Image Not Found"
error, be sure to
point to your
ROM files using
OPTIONS -> ROM Image Paths.
Mount :0 ... Press the [F2] key, then hit 0Press the [F8] key, then hit 0Press the [F9] key, then hit [ENTER] Press the [F6] key
... with
LDOS1.DSK		 LDOS1 [ENTER]LDOS1 [ENTER]Use the arrows to
scroll to LDOS1
and then hit [ENTER]		 Navigate to LDOS1
and Double-Click
Mount :1 ... 11[TAB] Press the [SHIFT][F6] keys
... with
DSKIMAGE.DSK		 DSKIMAGE [ENTER]DSKIMAGE [ENTER][ENTER] Navigate to DSKIMAGE
and Double-Click
  Use the arrows
to scroll to
DSKIMAGE and
then hit [ENTER]		  
Reboot RRPress the [F10] key Press [SHIFT][F8] Keys
12. Enter a valid date and press [ENTER]
13. Enter a valid time and press [ENTER]
14. FILENAME [ENTER]
That's it ... if you want to run a BASIC program (called FILENAME/BAS) instead of a /CMD Program do the following two steps instead of Step 14 ...
14. BASIC [ENTER]
15. RUN"FILENAME/BAS:1" [ENTER]

         Step By Step Instructions on How to Use a Downloaded File (XTRS)
01. Click here to download xtrs. Install it on your machine.
02. Download the file you want from the internet to your home directory. Let's assume it's called filename.cmd.
03. Click here to download a Model 1 boot disk. Save it in your home directory.
04. Go to a shell and type cd to go to your home directory.
05. unzip -L ldos531.zip
06. ln -s ldos1.dsk disk1-0
07. Find the file utility.dsk that came with xtrs. If you aren't sure where it is, type locate utility.dsk to find it. Make a symbolic link from that file to disk1-1. That is, if the full name of the file is /usr/share/xtrs/utility.dsk, type ln -s /usr/share/xtrs/utility.dsk disk1-1.
08. mkdisk dskimage.dsk
09. ln -s dskimage.dsk disk1-2
10. Start the emulator: xtrs -model 1 -diskdir .
11. LDOS will boot. Type the next commands inside the emulator.
12. Enter a valid time and press [ENTER].
13. SET *KI KI
14. format :2
The next steps depend on whether you want to run a BASIC or a CMD file.

For a CMD File called filename/cmd...
15. import filename.cmd filename/cmd:2
16. filename:2
For a BASIC File called filename/bas...
15. import filename.bas filename/bas:2
16. basic
17. run"filename/bas:2"


         How can I get individual files on and/or off a .DSK?
Most of the TRS-80 emulators have programs for doing this. Read the instructions for your emulator to find out how to use them. Sometimes the program runs on the emulated Z-80 (a /CMD file); other times it runs on the host operating system (an .EXE file).

Getting Files Off of a DSK:
Under Jeff Vavasour's Model I Emulator, the relevant program is VREAD.EXE. Under Jeff's Model III/4 emulator, it is EXPORT/CMD. Under Matthew Reed's Model I/III emulator, the program is TRSREAD.EXE and is available only with the registered version. Under xtrs, the program is called EXPORT/CMD (not the same program as Jeff's).

Getting Files Onto a DSK:
Under Jeff Vavasour's Model I Emulator, the relevant program is VWRITE.EXE. Under Jeff's Model III/4 emulator, it is IMPORT/CMD. Under Matthew Reed's Model I/III emulator, the program is TRSWRITE.EXE and is available only with the registered version. Under xtrs, the program is called IMPORT/CMD (not the same program as Jeff's).