home *** CD-ROM | disk | FTP | other *** search
/ MACD 4 / MACD4.iso / Emulatory / Over5 / doc / Over5.doc < prev    next >
Encoding:
Text File  |  1978-03-06  |  7.6 KB  |  318 lines
  1. Documentation for Over5 0.463 by Daniel Kahlin <tlr@stacken.kth.se>
  2. -----------------------------------------------------------------------------
  3.  
  4. Distribution:
  5.  
  6.   Over5 is FREEWARE (Freely-Distributable), but copyrighted by me. (NOT PD!) 
  7. None of the included files may be modified and/or removed.  Permission is
  8. given to freely distribute this program provided you include all files from
  9. the original archive, and no fee is charged in excess of reasonable media
  10. and mailing costs.  The program may not be used for commercial purposes
  11. without written permission from the author.
  12.  
  13.  
  14. Disclaimer:
  15.  
  16.   I cannot in any way be held responsible for anything this program does.
  17. You are using it entirely at your own risk.  Every effort has been made to
  18. keep this program bug free.  But, IF for example a bug exists that blows up
  19. your entire computer, don't blame me.
  20.  
  21. -----------------------------------------------------------------------------
  22.  
  23. GENERAL:
  24.  
  25.   Over5 (the successor to OverFour) is an AMIGA to/from C64 transfer program
  26. package.  It was made because of too many burnt 6526's and 8520's.  To overcome
  27. that problem I chose to use a standard RS-232 interface.
  28.  
  29. Over5 contains several commands: COPY, WRITEFILE, READFILE, WRITEMEM, READMEM,
  30. SYS, SIMPLEWRITE, SIMPLEREAD, BOOT, DIR, STATUS, COMMAND, WRITEDISK, READDISK,
  31. WRITEZIP, READZIP, TEST, SERVER, HELP.
  32.  
  33.  
  34.  
  35. Documentation:
  36.  
  37.  
  38. command COPY:
  39. -------------
  40.  
  41. TEMPLATE: Over5 COPY FROM/M,TO/A,DEBUG/S
  42.  
  43.   FROM/M    source file/files 
  44.   TO/A      destination file/path
  45.   DEBUG/S   sets debug mode (shows all packets).
  46.  
  47. copies source to destination (like AmigaDOS copy) but '8:' is the 1541.
  48. The wildcard '*' can be used. (no wildcards on amigafiles, SORRY!)
  49.  
  50. example: copy 8:disksl* ram:
  51.  
  52.  
  53. command WRITEFILE:
  54. ------------------
  55. (this is a low level command, generally you should use 'COPY' instead)
  56.  
  57. TEMPLATE: Over5 WRITEFILE FROM/A,TO/A,DEBUG/S
  58.  
  59.   FROM/A    source file 
  60.   TO/A      destination file
  61.   DEBUG/S   sets debug mode (shows all packets).
  62.  
  63. copies source file from the amiga to the destination file on the 1541.
  64.  
  65.  
  66. command READFILE:
  67. -----------------
  68. (this is a low level command, generally you should use 'COPY' instead)
  69.  
  70. TEMPLATE: Over5 READFILE FROM/A,TO/A,DEBUG/S
  71.  
  72.   FROM/A    source file 
  73.   TO/A      destination file
  74.   DEBUG/S   sets debug mode (shows all packets).
  75.  
  76. copies source file from the 1541 to the destination file on the amiga.
  77.  
  78.  
  79. command WRITEMEM:
  80. ------------------
  81.  
  82. TEMPLATE: Over5 WRITEMEM FROM/A,RUN/S,RESET/S,DEBUG/S
  83.  
  84.   FROM/A    source file 
  85.   RUN/S     execute file with 'RUN' after transfer.
  86.   RESET/S   do reset on the c64 before transfer (with special hardware)
  87.   DEBUG/S   sets debug mode (shows all packets).
  88.  
  89. Writes source file into the c64 memory.
  90.  
  91.  
  92. command READMEM:
  93. ----------------
  94.  
  95. TEMPLATE: Over5 READMEM START/A,END/A,TO/A,RESET/S,DEBUG/S
  96.  
  97.   START/A   start address
  98.   END/A     end address
  99.   TO/A      destination file 
  100.   RESET/S   do reset on the c64 before transfer (with special hardware)
  101.   DEBUG/S   sets debug mode (shows all packets).
  102.  
  103. Reads c64 memory between START and END to the destination file.
  104.  
  105.  
  106. command SYS:
  107. ------------
  108.  
  109. TEMPLATE: Over5 SYS PC/A,MEMORY,SR,AC,XR,YR,SP,RESET/S,DEBUG/S
  110.  
  111.   PC/A      programcounter
  112.   MEMORY    contents of $01  (default 0x37)
  113.   SR        status register  (default 0x00)
  114.   AC        Accumulator      (default 0x00)
  115.   XR        X index register (default 0x00)
  116.   YR        Y index register (default 0x00)
  117.   SP        Stack pointer    (default 0xff)
  118.   RESET/S   do reset on the c64 before sys (with special hardware)
  119.   DEBUG/S   sets debug mode (shows all packets).
  120.  
  121. Starts code beginning at pc.
  122.  
  123.  
  124. command SIMPLEWRITE:
  125. --------------------
  126.  
  127. TEMPLATE: Over5 SIMPLEWRITE FROM/A,OLD/S
  128.  
  129.   FROM/A    source file 
  130.   OLD/S     obsolete protocol. use for FastRS 1.1 or earlier
  131.  
  132. Writes source file into the c64 memory using the simpleprotocol.
  133. (no handshaking)
  134.  
  135.  
  136. command SIMPLEREAD:
  137. -------------------
  138.  
  139. TEMPLATE: Over5 SIMPLEREAD TO/A,OLD/S
  140.  
  141.   TO/A      destination file 
  142.   OLD/S     obsolete protocol. Use this for FastRS 1.1 or earlier.
  143.  
  144. Reads source file from the c64 memory using the simpleprotocol.
  145. (no handshaking)
  146.  
  147.  
  148. command BOOT:
  149. -------------
  150. (this is only used to transfer 'DiskSlave' or similar for the first time)
  151.  
  152. TEMPLATE: Over5 BOOT FROM/A
  153.  
  154.   FROM/A    source file 
  155.  
  156. First it relocates the source file to $c000-len and appends 'copytail',
  157. then it sends the file at 150 baud to the c64. (no handshaking)
  158. Works together with the basic program 'boot.asc'.
  159. When transferred, just type 'SYS 49152<CR>' and save to DISK or TAPE.
  160.  
  161.  
  162. command DIR:
  163. ------------
  164.  
  165. TEMPLATE: Over5 DIR DEBUG/S
  166.  
  167.   DEBUG/S   sets debug mode (shows all packets).
  168.  
  169. Reads directory from the 1541 and shows it.
  170.  
  171.  
  172. command STATUS:
  173. ---------------
  174.  
  175. TEMPLATE: Over5 STATUS DEBUG/S
  176.  
  177.   DEBUG/S   sets debug mode (shows all packets).
  178.  
  179. Gets diskstatus from 1541 and shows it.
  180.  
  181.  
  182. command COMMAND:
  183. ----------------
  184.  
  185. TEMPLATE: Over5 COMMAND COMMAND/A,DEBUG/S
  186.  
  187.   COMMAND/A diskcommand
  188.   DEBUG/S   sets debug mode (shows all packets).
  189.  
  190. Sends a diskcommand to the 1541.
  191.  
  192.  
  193. command TEST:
  194. -------------
  195. (this command is not necessary for the ordinary user)
  196.  
  197. TEMPLATE: Over5 TEST BLOCK/S,FILE/S,DEBUG/S
  198.  
  199.   BLOCK/S   test block transfer
  200.   FILE/S    test file transfer
  201.   DEBUG/S   sets debug mode (shows all packets).
  202.  
  203. Tests block transfer and/or file transfer.
  204.  
  205.  
  206.  
  207.  
  208. command WRITEDISK:
  209. ------------------
  210.  
  211. TEMPLATE: Over5 WRITEDISK FROM/A,DEBUG/S
  212.  
  213.   FROM/A    source diskimage
  214.   DEBUG/S   sets debug mode (shows all packets).
  215.  
  216. Writes the source diskimage to the 1541.  Diskimages are usually
  217. named '.dsk' or '.d64' and should be 174848 bytes in size.
  218.  
  219.  
  220. command WRITEZIP:
  221. -----------------
  222.  
  223. TEMPLATE: Over5 WRITEZIP FROM/A,DEBUG/S
  224.  
  225.   FROM/A    zipcode basename (1!<basename>, 2!<basename>, etc...)
  226.   DEBUG/S   sets debug mode (shows all packets).
  227.  
  228. Decodes the zipcode archive and writes the diskimage to the 1541.
  229.  
  230.  
  231.  
  232. command READDISK:
  233. -----------------
  234.  
  235. TEMPLATE: Over5 READDISK TO/A,DEBUG/S
  236.  
  237.   TO/A      destination diskimage 
  238.   DEBUG/S   sets debug mode (shows all packets).
  239.  
  240. Reads an entire disk from the 1541.
  241.  
  242.  
  243.  
  244. command WRITEZIP:
  245. -----------------
  246.  
  247. TEMPLATE: Over5 WRITEZIP TO/A,DEBUG/S
  248.  
  249.   TO/A      zipcode basename (1!<basename>, 2!<basename>, etc...)
  250.   DEBUG/S   sets debug mode (shows all packets).
  251.  
  252. Reads an entire disk from the 1541 and encodes it into a standard
  253. zipcode archive.
  254. This may sometimes produce shorter archives than zipcode, but the
  255. archive will unpack fine on the c64.
  256.  
  257.  
  258.  
  259. command SERVER:
  260. ---------------
  261.  
  262. TEMPLATE: Over5 SERVER DEBUG/S
  263.  
  264.   DEBUG/S   sets debug mode (shows all packets).
  265.  
  266. Sets the amiga in SERVER MODE.  Run 'SerFile' on the c64 to use it.
  267.  
  268. commands (#C"<COMMAND>" or .<COMMAND> in 'SerFile')
  269.  
  270. .DIR or .$ or $
  271.   Displays the files in the current directory.
  272.  
  273. .CD
  274.   Displays the name of the current directory.
  275.  
  276. .CD <dir>
  277.   Set the current directory to <dir>.
  278.  
  279.  
  280.  
  281.  
  282.  
  283. command HELP:
  284. -------------
  285.  
  286. TEMPLATE: Over5 HELP or Over5 ?
  287.  
  288. Shows small help text.
  289.  
  290.  
  291.  
  292. System requirements:
  293.  
  294.   Over5 should run on any system setup running OS2.04 or higher, although it
  295. has only been tested on an A3000/25 running OS3.1.  If you find bugs or have
  296. suggestions about how to make the program better please send a bugreport or
  297. a list of suggestions to the address at the end of this text.
  298.  
  299. -----------------------------------------------------------------------------
  300.  
  301. Author:
  302.  
  303.   Daniel Kahlin is a student at the Royal Institute of Technology (Stockholm)
  304. Former c64 demo programmer (1986-1988).  He is deeply involved with computers
  305. and electronics.
  306.  
  307.    InterNet:  <tlr@stacken.kth.se>
  308.  
  309.   SnailMail:  Daniel Kahlin
  310.               Vanadisvägen 6, 2tr
  311.               s-113 46 Stockholm
  312.               Sweden
  313.  
  314.       Phone:  08-34 84 73 (+468348473)
  315.  
  316. -----------------------------------------------------------------------------
  317.  
  318.