home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Netzwerk / prlink-080b.lha / prlink-0.8.0b / README.Amiga < prev    next >
Encoding:
Text File  |  1995-06-07  |  6.1 KB  |  186 lines
  1. README.Amiga
  2. ============
  3.  
  4. This is the binary distribution package of prlink, with binaries for
  5. Amiga, Commodore 64, Commodore 128, VIC-20, PET 8032/4032, PET 3032.
  6.  
  7. There are versions for each of the Amiga supported cables: prlink,
  8. prlink88 and transnib.
  9.  
  10. All 6502 binaries are compiled without support any memory expansion.
  11. Trying to use a version for memory expansion that you don't have may
  12. give unexpected results, so I supplied versions that should always work.
  13. You can always generate your own specific version if you want; you will
  14. need DASM 2.02 for this.
  15.  
  16. I haven't tried all these binaries - so if they don't work you will need
  17. to compile/assemble your own.
  18.  
  19. The version of ixemul.library included is 40.3; it's the one I'm using.
  20. If you seem to have trouble with it you should try a newer version (40.4
  21. is the newest at this moment) or perhaps a bigger stack already helps.
  22.  
  23. Here is an overview of the directory structure:
  24.  
  25.      src (dir)
  26.       include (dir)
  27.         cbmrom.lib                 petram34.lib
  28.         petrom3.lib              petrom4.lib
  29.        basic-listing            chosen.inc
  30.        COPYING                jmptab.inc
  31.        MakeAll                Makefile
  32.        options.inc            petscii.c
  33.        pramiga.c            prcart.c
  34.        prdisk.asm            prdisk.c
  35.        prload.c             prmain
  36.        prmain.c             prrfile.asm
  37.        prrfile.c            prsample.asm
  38.        prsample.c            prsave.c
  39.        prserver.asm            prtrans.h
  40.        prtrans2.c            prtrans4.c
  41.        prtrans8.c            prwfile.asm
  42.        prwfile.c            README
  43.      amiga (dir)
  44.       libs (dir)
  45.         ixemul.library
  46.        prmain-prlink            prmain-prlink88
  47.        prmain-transnib
  48.      pet3001 (dir)
  49.        prdisk.prg            prrfile.prg
  50.        prserver-prlink.prg        prserver-prlink88.prg
  51.        prserver-transnib.prg        prwfile.prg
  52.      pet4001 (dir)
  53.        prdisk.prg            prrfile.prg
  54.        prserver-prlink.prg        prserver-prlink88.prg
  55.        prserver-transnib.prg        prwfile.prg
  56.      c64 (dir)
  57.        prdisk.prg            prrfile.prg
  58.        prsample-prlink.prg        prserver-prlink.prg
  59.        prserver-prlink88.prg        prserver-transnib.prg
  60.        prwfile.prg
  61.      vic20 (dir)
  62.        prdisk.prg            prrfile.prg
  63.        prserver-prlink.prg        prserver-prlink88.prg
  64.        prserver-transnib.prg        prwfile.prg
  65.      c128 (dir)
  66.        prdisk.prg            prrfile.prg
  67.        prsample-prlink.prg        prserver-prlink.prg
  68.        prserver-prlink88.prg        prserver-transnib.prg
  69.        prwfile.prg
  70.   README.Amiga
  71.  
  72. You must collect the files you need from the various subdirectories
  73. named after the machine they run on, and get the version with the name
  74. of your cable. Rename each so that the -cabletype part is removed. So
  75. you end up with a directory similar to this:
  76.  
  77. prmain               21280 ----rwed Today     17:18:44
  78. prserver.prg             378 ----rwed Today     21:57:18
  79. prsample.prg              32 ----rwed Today     21:57:18
  80. prwfile.prg             175 ----rwed Today     21:57:03
  81. prrfile.prg             169 ----rwed Today     21:57:03
  82. prdisk.prg             477 ----rwed Today     21:57:03
  83.  
  84. To create the other commands (prcart prdisk prload prrfile prsample
  85. prsave prwfile) you can make symbolic or hard links to prmain. If your
  86. version of AmigaDOS does not support links (or does not support them
  87. well enough), not to worry. You can always use a command of the form
  88.  
  89.     prmain --prsave
  90.  
  91. instead of
  92.  
  93.     prsave.
  94.  
  95.  
  96. Here are some useful aliases I have set up (the disk drive in my PET
  97. 8296-D has device number 9):
  98.  
  99.     alias prload prmain --prload
  100.     alias prsave prmain --prsave
  101.     alias prcart prmain --prcart
  102.     alias prsample prmain --prsample
  103.     alias prrfile prmain --prrfile -d 9
  104.     alias prwfile prmain --prwfile -d 9
  105.     alias prdisk prmain --prdisk -d 9
  106.  
  107.     alias @$0 prmain --prrfile -d 9 "$0"
  108.     alias @$1 prmain --prrfile -d 9 "$1"
  109.  
  110. You can, if you wish to use multiple types of cables, change the aliases
  111. a bit, to something like
  112.  
  113.     alias prrfilevic8 prmain-prlink88 --prrfile -l prrfile-vic.prg
  114.  
  115. The "Transnib" cable isn't described in the main documentation (a small
  116. oversight on my part), so here is what pramiga.c has to say about it:
  117.  
  118.   TransNib is a cable that has only 6 bits connected:
  119.  
  120.   0-3:      data i/o
  121.   6:      handshake in
  122.   7:      handshake out
  123.  
  124.   Because the cable is straight-through, bits 6 and 7 are swapped
  125.   at the PET/C-64/VIC-20 side.
  126.  
  127.   The protocol is provided for people who made a cable for
  128.   TransNib V1.00 Devised by Matt Francis (m.p.francis@newcastle.ac.uk).
  129.  
  130.   Because the cable is a subset of the prlink cable, the protocol will
  131.   also work with the prlink cable.
  132.  
  133.   Note that this protocol is not compatible with the TransNib programs!
  134.  
  135. Usage summary of the subprograms:
  136.  
  137. prload: Uploads files to a memory area on a remote computer.
  138.  
  139. Usage: prload [options] filename(s)
  140. Options:
  141.     -a addr Override the load address from the file
  142.     -b bank Specify the memory bank (in hex)
  143.     -l    Load the file as BASIC.
  144.     -r    Performs the BASIC RUN command after the transfers.
  145.     -j addr Jumps to the specified hex address after the transfers.
  146.     -p port Specify the printer port (0 to 3)
  147.  
  148. prsave: Dumps a memory area on a remote computer to a file or standard output.
  149.  
  150. Usage: prsave [options] startaddress endaddress [filename]
  151. Options:
  152.     -b bank Specify the memory bank (in hex)
  153.     -p port Specify the printer port (0 to 3)
  154.  
  155. prdisk: Copies a file to or from a disk accessible  from a remote computer.
  156.  
  157. Usage: prdisk [options] [filename]
  158. Options:
  159.     -d device    Specify the device number (0-15)
  160.     -r    Specify read operation (default)
  161.     -w    Specify write operation
  162.     -l filename    Specify the filename of the client program
  163.     -p port Specify the printer port (0 to 3)
  164.  
  165. prrfile: Dumps a file accessible from a remote computer to a file.
  166.  
  167. Usage: prrfile [options] filename [local filename]
  168. Options:
  169.     -d device    Specify the device number (0-15)
  170.     -l filename    Specify the filename of the client program
  171.     -p port Specify the printer port (0 to 3)
  172. The filename can start with a $, in which case it is
  173. printed as a directory, unless a local name is given.
  174. The remote filename is converted to PETSCII.
  175. The default local file name has / characters converted to -.
  176.  
  177. prwfile: Writes a local file to a file on a remote computer.
  178.  
  179. Usage: prwfile [options] filename [remote filename]
  180. Options:
  181.     -d device    Specify the device number (0-15)
  182.     -l filename    Specify the filename of the client program
  183.     -p port Specify the printer port (0 to 3)
  184. The remote filename is converted to PETSCII.
  185.  
  186.