home *** CD-ROM | disk | FTP | other *** search
/ Brotikasten / BROTCD01.iso / amiga / copy1581.txt < prev    next >
Text File  |  1995-08-16  |  4KB  |  83 lines
  1.                    1581 File Reader for Amiga
  2.  
  3.                          by Kerry Gray
  4.  
  5. This program will allow you to read and copy the contents of a disk
  6. written with a CBM 1581 disk drive.  If you are among the lucky few
  7. that can run this program, you can port your files to the Amiga without
  8. messing with serial cables, RS-232 incompatibility and all the rest of
  9. those annoying details.
  10.  
  11. Before you faint from joy, however, there is one little catch to it--
  12. it works only if you are running Workbench 2.  A bug in the trackdisk
  13. device driver prevents its proper operation under earlier versions.
  14. Don't blame me, blame C-A.  There is a possibility that it will work
  15. with Workbench 1.3 if you have two floppy drives, but I haven't found
  16. anyone with this setup to test that out.
  17.  
  18. To run the program, insert your 1581 disk in a 3.5" disk drive, click on
  19. the program icon, then hold down the shift key and double-click on the
  20. disk icon ("DFx:????").  From the CLI, enter the program name and the
  21. name of the drive you will be using for the 1581 disks, e.g., "DF0:".
  22. If you don't specify a drive, you will get a requester.  You're stuck
  23. with your choice until you quit.  You can scroll through the list of files
  24. found and select files for copying.  When you're ready, click on the 
  25. "copy" gadget and your files will be copied.  The filenames are converted
  26. to ASCII, and some characters that AmigaDOS uses for other purposes will
  27. be changed.  The file's contents are NOT changed.  If you select a par-
  28. tition, you will get a new requester showing its contents.  Only selected
  29. files are copied, and if a partition is not selected, none of its files
  30. will be copied even if some of its files are selected.
  31.  
  32. All the files you select will be copied into the current directory, so
  33. don't load up the program from DF0: and expect to read a 1581 disk from
  34. there, too.  Copy it to the RAM disk.  It's certainly small enough.  As I
  35. write this, only A-3000's run Workbench 2, and there is enough room on the
  36. RAM disk to copy a full 1581 disk.
  37.  
  38. BUGS
  39. I hate buggy programs.  I hate to think I write buggy programs.  I hate
  40. to think of people cursing my name because of a buggy program.  If you
  41. find bugs or other annoyances in this program, I want to hear about it
  42. so the offending bits may be extirpated.  Keep in mind this is a hard-
  43. ware project, and since the subtleties of Amiga I/O are not well known
  44. to me (to tell the truth, this is my first serious Amiga program) there
  45. may be circumstances where things don't work too good.  Don't be surprised
  46. if bad things happen when you pull the disk out of the drive while it's
  47. reading, for instance.  There is no danger to your 1581 disks from my 
  48. program, as it does no writing to them.  The destination volumes are
  49. another story.  Don't pull them out of the drive, either. 
  50.  
  51. SHORTCOMINGS
  52. OK, so the requesters and stuff could be graphically more pleasing.  Any
  53. artists out there are welcome to propose prettier windows.  The program
  54. is not terribly "robust," as they say in the computer biz, so flaky disks
  55. may cause, well, anything to happen.  I don't try to compute the disk
  56. data checksums, mainly because I didn't feel like poring over all that
  57. ROM code to dig out the generator polynomial.  This may in fact be a
  58. positive boon since disks with errors can be copied.  The errors in them
  59. will of course not be detected.  If some error such as illegal track or
  60. sector is encountered, copying will stop for that file, and the program
  61. will proceed to the next one.  The Amiga file will contain the good data
  62. up to the bad spot.  Watch the error log window (or the CLI window if you
  63. executed it from CLI) to see which files didn't copy completely.
  64.  
  65. THE FUTURE
  66. Face it, the 8-bits ain't got no future.  However, if I am inundated with
  67. bribes I might be convinced to add new things like an Amiga-to-1581 copy
  68. program (yes, it can be done) so you can transfer files in the other 
  69. direction.
  70.  
  71. LEGAL-ESE STUFF
  72. This program is not in the public domain; it is not "shareware."  You are
  73. permitted by the author to make copies of this program for your personal
  74. use, and to distribute it to others provided you don't charge for it.  
  75. Do not distribute it unless it is accompanied by this document and
  76. this document is unedited.  You are expressly forbidden to sell this
  77. program.  I did the work, not you.
  78.  
  79. Kerry Gray
  80. 434 Chaparral St
  81. Salinas, CA  93906  USA
  82.  
  83.