README.Amiga
============

This is the binary distribution package of prlink, with binaries for Amiga,
Commodore 64, Commodore 128, VIC-20, PET 8032/4032, PET 3032.

There are versions for each of the Amiga supported cables: prlink, prlink88
and transnib.

All 6502 binaries are compiled with just one type of memory expansion (PIA
expansion) if applicable, since there would be too many combinations
otherwise. You can always generate your own specific version if you want;
you will need DASM 2.02 for this.

I haven't tried all these binaries - so if they don't work you will need to
compile/assemble your own.

Here is an overview of the directory structure:

     src (dir)
	  include (dir)
	    cbmrom.lib			     petram34.lib
	    petrom3.lib 		     petrom4.lib
       basic-listing			chosen.inc
       COPYING				jmptab.inc
       MakeAll				Makefile
       options.inc			petscii.c
       pramiga.c			prcart.c
       prdisk.asm			prdisk.c
       prload.c 			prmain
       prmain.c 			prrfile.asm
       prrfile.c			prsample.asm
       prsample.c			prsave.c
       prserver.asm			prtrans.h
       prtrans2.c			prtrans4.c
       prtrans8.c			prwfile.asm
       prwfile.c			README
     amiga (dir)
	  libs (dir)
	    ixemul.library
       prmain-prlink			prmain-prlink88
       prmain-transnib
     pet3001 (dir)
       prdisk.prg			prrfile.prg
       prserver-prlink.prg		prserver-prlink88.prg
       prserver-transnib.prg		prwfile.prg
     pet4001 (dir)
       prdisk.prg			prrfile.prg
       prserver-prlink.prg		prserver-prlink88.prg
       prserver-transnib.prg		prwfile.prg
     c64 (dir)
       prdisk.prg			prrfile.prg
       prsample-prlink.prg		prserver-prlink.prg
       prserver-prlink88.prg		prserver-transnib.prg
       prwfile.prg
     vic20 (dir)
       prdisk.prg			prrfile.prg
       prserver-prlink.prg		prserver-prlink88.prg
       prserver-transnib.prg		prwfile.prg
     c128 (dir)
       prdisk.prg			prrfile.prg
       prsample-prlink.prg		prserver-prlink.prg
       prserver-prlink88.prg		prserver-transnib.prg
       prwfile.prg
  README.Amiga

You must collect the files you need from the various subdirectories named
after the machine they run on, and get the version with the name of your
cable. Rename each so that the -cabletype part is removed. So you end up
with a directory similar to this:

prmain			   21280 ----rwed Today     17:18:44
prserver.prg		     378 ----rwed Today     21:57:18
prsample.prg		      32 ----rwed Today     21:57:18
prwfile.prg		     175 ----rwed Today     21:57:03
prrfile.prg		     169 ----rwed Today     21:57:03
prdisk.prg		     477 ----rwed Today     21:57:03

To create the other commands (prcart prdisk prload prrfile prsample prsave
prwfile) you can make symbolic or hard links to prmain. If your version
of AmigaDOS does not support links (or does not support them well enough),
not to worry. You can always use a command of the form

    prmain --prsave

instead of

    prsave.


Here are some useful aliases I have set up (the disk drive in my PET 8296-D
has device number 9):

    alias prload prmain --prload
    alias prsave prmain --prsave
    alias prcart prmain --prcart
    alias prsample prmain --prsample
    alias prrfile prmain --prrfile -d 9
    alias prwfile prmain --prwfile -d 9
    alias prdisk prmain --prdisk -d 9

    alias @$0 prmain --prrfile -d 9 "$0"
    alias @$1 prmain --prrfile -d 9 "$1"

You can, if you wish to use multiple types of cables, change the aliases
a bit, to something like

    alias prrfile8 prmain-prlink88 --prrfile -l prrfile-prlink88.prg

The "Transnib" cable isn't described in the main documentation (a small
oversight on my part), so here is what pramiga.c has to say about it:

  TransNib is a cable that has only 6 bits connected:

  0-3:	  data i/o
  6:	  handshake in
  7:	  handshake out

  Because the cable is straight-through, bits 6 and 7 are swapped
  at the PET/C-64/VIC-20 side.

  The protocol is provided for people who made a cable for
  TransNib V1.00 Devised by Matt Francis (m.p.francis@newcastle.ac.uk).
  Because the cable is a subset of the prlink cable it will also work
  with that.

  Note that this protocol is not compatible with the TransNib programs!

Usage summary of the subprograms:

prload: Uploads files to a memory area on a remote computer.

Usage: prload [options] filename(s)
Options:
	-a addr Override the load address from the file
	-b bank Specify the memory bank (in hex)
	-l	Load the file as BASIC.
	-r	Performs the BASIC RUN command after the transfers.
	-j addr Jumps to the specified hex address after the transfers.
	-p port Specify the printer port (0 to 3)

prsave: Dumps a memory area on a remote computer to a file or standard output.

Usage: prsave [options] startaddress endaddress [filename]
Options:
	-b bank Specify the memory bank (in hex)
	-p port Specify the printer port (0 to 3)

prdisk: Copies a file to or from a disk accessible  from a remote computer.

Usage: prdisk [options] [filename]
Options:
	-d device	Specify the device number (0-15)
	-r	Specify read operation (default)
	-w	Specify write operation
	-l filename	Specify the filename of the client program
	-p port Specify the printer port (0 to 3)

prrfile: Dumps a file accessible from a remote computer to a file.

Usage: prrfile [options] filename [local filename]
Options:
	-d device	Specify the device number (0-15)
	-l filename	Specify the filename of the client program
	-p port Specify the printer port (0 to 3)
The filename can start with a $, in which case it is
printed as a directory, unless a local name is given.
The remote filename is converted to PETSCII.
The default local file name has / characters converted to -.
prwfile: Writes a local file to a file on a remote computer.

Usage: prwfile [options] filename [remote filename]
Options:
	-d device	Specify the device number (0-15)
	-l filename	Specify the filename of the client program
	-p port Specify the printer port (0 to 3)
The remote filename is converted to PETSCII.