home *** CD-ROM | disk | FTP | other *** search
/ Vectronix 2 / VECTRONIX2.iso / FILES_08 / EXDOS24A.LZH / EXTENDOS.24A / TEXT / READ.ME < prev    next >
Text File  |  1996-05-26  |  22KB  |  528 lines
  1. Last minute notes on ExtenDOS Pro
  2. ---------------------------------
  3. Version:        2.4A
  4. Dated:          26 May 1996
  5.  
  6. Program versions on this diskette:
  7. CD.BOS          2.4A
  8. CDAUDIO.ACC     2.4
  9. CDAUDIO.PRG     2.4
  10. DISC.RSC        2.4
  11. EXTENDOS.PRG    2.4
  12. EXTINFO.PRG     2.4
  13. INSTALL.APP     2.4
  14. INSTALL.RSC     2.4
  15. UNIDRIVE.DOS    2.4A
  16. UNI_BDDS.DOS    2.4A
  17.  
  18. Other files on this diskette:
  19. CD_LIST7.ZIP    An archive listing over 1000 CD-ROMs you can use
  20.                 with your Atari
  21. EXTENDOS.CNF    Standard configuration file for non-TT systems
  22. EXTENDOS.TT     Standard configuration file for TT030 systems
  23. READ.ME         This very text file
  24.  
  25.  
  26.  
  27. New features that are not in the manual
  28. ---------------------------------------
  29. 1. * IMPORTANT *
  30.    UNIDRIVE.DOS will now handle most CD-ROMs; you should 'never' need
  31.    to use UNI_BDDS.DOS (although it's still provided 'just in case').
  32.    If you are upgrading from ExtenDOS, please change any references to
  33.    UNI_BDDS.DOS in your existing EXTENDOS.CNF to refer to UNIDRIVE.DOS
  34.    instead; you can do this by running the install program (see below)
  35.    if you wish.
  36.  
  37. 2. There is now an install/reconfiguration program, INSTALL.APP,
  38.    which uses a resource file INSTALL.RSC.  We suggest that you use
  39.    this instead of the manual install process, since it greatly
  40.    simplifies installation and reduces the chance of errors.  See
  41.    "Using the install program" below for further information.
  42.  
  43. 3. CDaudio has been greatly enhanced; among other features, it now
  44.    provides direct-to-disk recording (you can copy audio CD sectors
  45.    across the SCSI interface and write them to a hard disk).  Please
  46.    refer to "Using CDaudio" and "Recording with CDaudio" below for
  47.    more details.
  48.  
  49. 4. ExtenDOS Pro is now compatible with the MagxDesk desktop of MagiC4:
  50.    installed drives may be accessed via the standard drive icons
  51.    which MagxDesk will install automatically.
  52.    NOTE: unlike hard disk drives, CD-ROM drives cannot be accessed
  53.    from the U: drive of the MagxDesk desktop.
  54.  
  55. 5. ExtenDOS Pro is now compatible with even more third-party software,
  56.    including the CDPLAYxx audio CD player and the MIDI_COM networking
  57.    desk accessory (CD-ROM drives defined as C: thru P: are visible
  58.    across the network).
  59.  
  60. 6. ExtenDOS Pro now reports the volume label on a CD-ROM, where one
  61.    exists.  Any piece of software (like the MagiC4 desktop) that looks
  62.    for a volume label will be able to find one on your CD-ROM.
  63.  
  64. 7. ExtenDOS Pro now allows you to specify a LUN as well as a DMA id
  65.    for each drive in CD.BOS: this is to support CD-ROM changers such
  66.    as the Pioneer DRM-602X/604X.  See "Supporting multiple-LUN
  67.    CD-ROM drives" below for how to use this feature.
  68.  
  69. 8. Global options can now be specified to ExtenDOS Pro via the new
  70.    *OPT line in EXTENDOS.CNF.  Currently allowed values are:
  71.         P=Y/N/E
  72.           Pause at end of processing: Yes, No, or only if Error
  73.           (default is P=E)
  74.         B=Y/N
  75.           Forces use of intermediate buffer for I/O: Yes or No.
  76.           (default is B=N)
  77.         D=Y/N
  78.           Forces use of system calls e.g. Dgetdrv()/Dsetdrv():
  79.           Yes or No (default is F=N)
  80.    Examples:
  81.         . Never pause at end of processing:
  82.           *OPT P=N
  83.         . Force use of system Dgetdrv()/Dsetdrv():
  84.           *OPT D=Y
  85.         . Always pause at end of processing, and force use of system
  86.           Dgetdrv()/Dsetdrv():
  87.           *OPT P=Y D=Y
  88.    The specification of global options is fully supported by a new
  89.    'Global options' panel in INSTALL.APP.
  90.  
  91. 9. If you have multiple CD-ROM drives, you can now specify up to eight
  92.    drives per *BOS or *DOS line.  This will save the memory required
  93.    for additional copies of CD.BOS and UNIDRIVE.DOS.
  94.  
  95.    For example, if you have a CD-ROM drive at id=1 and at id=3, you
  96.    could use an EXTENDOS.CNF file with the following lines:
  97.  
  98.         *BOS, C:\EXTENDOS\CD.BOS T=20 L=32, V:3 Y:1
  99.         *DOS, C:\EXTENDOS\UNIDRIVE.DOS P=20 B=8, P:Y Q:V
  100.  
  101.    Note that the multiple drive definitions are separated by one or
  102.    more spaces.  Also note that any parameters (such as T= or P=
  103.    above) apply to all drives specified on that line.  If you need
  104.    to specify different parameters for different drives, you can
  105.    continue to use one line per drive, as before.
  106.  
  107.    If you use the install program, this is all taken care of for you
  108.    (aren't computers wonderful?)
  109.  
  110. 10. An ExtenDOS Pro cookie is now added to the cookie jar; this will
  111.    allow programs that use the drivers (e.g. for audio control) to
  112.    determine if they are present.  The cookie id is 'EPro' (note
  113.    upper/lower case mix), and the cookie value is the address of an
  114.    internal ExtenDOS Pro table.
  115.  
  116. 11. During initialisation, ExtenDOS Pro now checks for duplicate 
  117.    physical (BOS) drives and reports an error message if found.  It
  118.    also does further checking on the data returned by the initial
  119.    INQUIRY command to a drive.  This will help catch certain host
  120.    adapter problems.
  121.  
  122. 12. The following new drives are now supported:
  123.         Drive                       Device id
  124.         -----                       ---------
  125.         Apple CD600                     70
  126.         Chinon 525                      53
  127.         Chinon 535 rev S                52
  128.         Compaq 561                     110
  129.         MediaVision Reno                90
  130.         Nakamichi MBR-7                120
  131.         NEC 3Xp+                        20
  132.         NEC 4Xe                         20
  133.         NEC 73/83                       24  (single-session photoCD)
  134.         Panasonic CR-501                71  (no photoCD)
  135.         Pioneer 602x                   100
  136.         Pioneer 604x rev 2401          101
  137.         Pioneer 604x (other revs)      102
  138.         Pioneer 124X                   102
  139.         Plextor 3028                    80
  140.         Plextor 3024                    81
  141.         Plextor 4plex                   82
  142.         Sony 55S                        30
  143.         Toshiba 3201                    12  (no photoCD)
  144.         Toshiba 3501                    10
  145.         Toshiba 3601                    10
  146.         Toshiba 5201                    10
  147.         Toshiba 5301                    10
  148.    Also, single-session photoCD is now supported on the NEC25.
  149.  
  150.    NOTE: The device type for the NEC25 has been changed to 24; if
  151.    you have a NEC25 and have been specifying a device type, you must
  152.    remove it (preferable) or change it to 24 in order to access
  153.    photoCDs.
  154.  
  155. 13. If a drive isn't recognised, but identifies itself as a SCSI-2
  156.    device, it is handled in the same way as the most recent SCSI-2
  157.    capable drive from the same manufacturer.  This should provide the
  158.    maximum amount of audioCD _AND_ photoCD support for new drives as
  159.    they are introduced.
  160.  
  161. 14. ExtenDOS Pro now allows more time for accesses to a CD-ROM that
  162.    involve reading a table-of-contents, such as some photoCD and
  163.    audio operations.  This provides increased reliability at the
  164.    cost of additional time to detect that the device is genuinely
  165.    not responding.  This may slow down the boot sequence in some
  166.    circumstances.
  167.  
  168. 15. The trace program, TRACE.TTP, no longer exists.  Its function has
  169.    been replaced by EXTINFO.PRG, which is loosely patterned after the
  170.    well-known SYSINFO program.  EXTINFO.PRG automatically gathers both
  171.    system and ExtenDOS Pro data and writes it to a file EXTINFO.TXT in
  172.    the current directory.  See "Using the ExtenDOS Pro information
  173.    program" below for more details.
  174.  
  175.  
  176.  
  177. Using CDaudio
  178. -------------
  179. CDaudio has been greatly enhanced over the version described in the
  180. manual, as follows:
  181.  
  182. 1. It now uses 3D dialogs, where supported by the AES (this includes
  183.    all Falcon030s, and any system running Geneva).
  184.  
  185. 2. A 'minimised' display is available to reduce the screen space
  186.    occupied by the dialog.  The minimised display dialog is accessible
  187.    via the 'Fuller' gadget, i.e. the gadget at the top right-hand
  188.    corner of the window.
  189.  
  190. 3. Fewer redraws are issued, thereby reducing screen flicker.
  191.  
  192. 4. The FastForward/Rewind buttons are now "ballistic", i.e. if you
  193.    keep the button selected, the forward/backward skip amounts
  194.    increase continually, so you skip faster and faster.
  195.  
  196. 5. Index numbers up to 99 are supported.
  197.  
  198. 6. The volume may be changed by clicking on the volume bar, as well as
  199.    by dragging the slider.
  200.  
  201. 7. In order to reduce confusion, the drive letter shown in the dialog
  202.    is the logical device, rather than the physical device.
  203.  
  204. 8. A 'Scan' button has been added; if selected, 'Play' plays the first
  205.    10 seconds of each track rather than the entire track.  This can be
  206.    used in conjunction with REPEAT and/or SHUFFLE (you can get tired
  207.    of this combination pretty quickly!)
  208.  
  209. 9. 'Set A' & 'Set B' buttons have been added, to set the start and
  210.    end of a play segment.  This is likely to be of most use with the
  211.    direct-to-disk recording feature (see below), but can also be used
  212.    with playback.  This feature can be used together with the 'Repeat'
  213.    button.  NOTE: if 'Set A' & 'Set B' are selected, 'Scan' and
  214.    'Shuffle' will be ignored.
  215.  
  216. 10. A 'Record' button has been added for direct recording; please see
  217.    'Recording with CDaudio' below for further details.
  218.  
  219.  
  220.  
  221. Recording with CDaudio
  222. ----------------------
  223. CDaudio now provides direct-to-disk recording (you can copy audio CD
  224. sectors across the SCSI interface and write them to a hard disk).
  225. This is achieved via changes to CD.BOS and CDAUDIO.PRG/CDAUDIO.ACC.
  226. The changes to CD.BOS make it compatible with third-party audio CD
  227. programs including CDPLAYxx.  Output files from CDAUDIO.PRG/ACC are
  228. created in AVR format.
  229.  
  230. In order to access the recording dialogue, click on the new 'Record'
  231. button on the standard (non-minimised) CDaudio dialogue.  In the
  232. recording dialogue, the following buttons are available:
  233.  
  234.    . in current track/time box:
  235.         < track down
  236.           play
  237.           (inverse video) stop
  238.         > track up
  239.  
  240.    . to right of current track/time box
  241.          copy current track position to Start Time or End Time
  242.           (alternative to using Set A/Set B in the main dialogue)
  243.  
  244.    . in start track/time box
  245.           play from start time to end time
  246.  
  247.    . in end track/time box
  248.           play from (end time - 10 seconds) to end time
  249.  
  250.    . below current track/time box
  251.         Stereo/Mono
  252.           select mode
  253.         16-bit/8-bit
  254.           select resolution
  255.         50066/44100/25033
  256.           select recording speed
  257.        
  258.    . at bottom right
  259.         Record A-B
  260.           start recording (you will be prompted for filename)
  261.         Cancel
  262.           return to main dialogue
  263.  
  264. Note that you will need LOTS of disk space for digital recording
  265. (around 10MB/minute for 16-bit stereo at 50066 Hz).
  266.  
  267. *** IMPORTANT ***
  268. The direct-to-disk recording feature requires a CD-ROM drive that is
  269. capable of reading audio sectors as data, and support for that drive
  270. in CD.BOS.  The following drives are claimed to support reading audio
  271. sectors as data:
  272.      Chinon 535 (firmware revision Q20 & later)
  273.      NEC 3X
  274.      Panasonic 8004
  275.      Pioneer 602x
  276.      Plextor 4plex
  277.      Sony 561 (and equivalents)
  278.      Toshiba 3401
  279. (later models from the same manufacturers will probably also support
  280. this function).
  281.  
  282. At this time, the following drives are known to work correctly:
  283.      Plextor 4plex
  284.      Sony 561 (and equivalents)
  285.      Toshiba 3401/4101/3601
  286.  
  287. Other recent Toshiba drives such as the 3501 & 5301 should also work
  288. but have not been tested.  The NEC 3Xp has been tested, but appears to
  289. have a firmware problem with the drive, resulting in an unacceptable
  290. 'skipping' in the output.  Other NEC drives may function better.
  291.  
  292. Although CD.BOS contains support for all the drives in the above list,
  293. we have been unable to test the Chinon, Panasonic, and Pioneer at this
  294. time.  If you have one of these drives, please let us know whether the
  295. recording function works correctly or not.  If not, an EXTINFO.TXT
  296. listing of the problem would be welcomed (see "Using the ExtenDOS Pro
  297. information program" below for how to produce this).
  298.  
  299. If you always receive the message "Can't read audio CD: error -5" when
  300. attempting to record, it is probable that your drive does not support
  301. this feature.
  302.  
  303.  
  304. Using the install program
  305. -------------------------
  306. The install program, INSTALL.APP, has two basic functions:
  307.  
  308.    . install a new version of ExtenDOS Pro by copying all the files
  309.      to the right places
  310.    . reconfigure ExtenDOS Pro by updating EXTENDOS.CNF
  311.  
  312. These functions are accomplished by a series of GEM-based dialogs,
  313. each of which has an associated Help screen.
  314.  
  315. In order to run INSTALL.APP, insert the distribution disk in your
  316. floppy drive, double-click on the drive icon, then double-click on
  317. the INSTALL.APP icon.
  318.  
  319. On startup, install checks if you have multiple EXTENDOS.CNF files (in
  320. the various allowable locations); if you do, it determines which one
  321. is being used by EXTENDOS.PRG, prepares to update that one, and issues
  322. a message to inform you.  Then a dialog is presented that allows you
  323. to choose whether you are installing a new version from diskette, or
  324. you are reconfiguring your existing version.
  325.  
  326. From then on, the screens allow you to:
  327.    . select the drives to install from and to,
  328.    . scan your DMA port(s) for CD-ROM drives and other devices,
  329.    . set global options,
  330.    . associate scsi ids with logical devices, and
  331.    . set various device-related optional parameters.
  332.  
  333. As noted above, each screen has associated Help information which
  334. describes how to use it.
  335.  
  336. Note: when you update EXTENDOS.CNF with the install program, any
  337. reference to UNI_BDDS.DOS is automatically changed to UNIDRIVE.DOS.
  338. In the _very_ unlikely event that you need to use UNI_BDDS.DOS, you
  339. will need to modify the EXTENDOS.CNF file manually.  In such a case,
  340. please feel free to call Anodyne Software for assistance.
  341.  
  342.  
  343.  
  344. Using the ExtenDOS Pro information program
  345. ------------------------------------------
  346. EXTINFO.PRG is used to gather system and ExtenDOS Pro information and
  347. write it to the EXTINFO.TXT file.  This information can be helpful in
  348. diagnosing both hardware and software problems, and you will probably
  349. need to have this information to hand when requesting help from
  350. Anodyne Software.
  351.  
  352. Here's how to run EXTINFO.PRG:
  353.    . Using INSTALL.APP, ensure that both 'Trace table size' and
  354.      'Trace data length' are set for the CD-ROM drive(s) you are
  355.      using (these are options that are settable via the Setup
  356.      dialog in INSTALL.APP).  Use a trace table size of 200 and
  357.      a trace data length of 48.
  358.    . Reboot your system, then recreate the failure.
  359.    . Run EXTINFO.PRG:
  360.      a) double-click on EXTINFO.PRG from the desktop
  361.      b) click on 'Create EXTINFO.TXT'
  362.      c) complete the displayed form specifying your name, address,
  363.         phone number, email address, etc. (this information is
  364.         saved in the EXTINFO.TXT file as a means of identifying
  365.         the file); then click on 'OK'
  366.      d) EXTINFO.PRG will copy information to the EXTINFO.TXT file
  367.         (this file is in ASCII text format so you may browse it
  368.         if you wish).
  369.  
  370. If you need to provide more than one set of debugging data, make sure
  371. that you rename EXTINFO.TXT before re-running EXTINFO.PRG, since any
  372. existing EXTINFO.TXT file will be overwritten when EXTINFO.PRG runs.
  373.  
  374.  
  375.  
  376. Supporting multiple-LUN CD-ROM drives
  377. -------------------------------------
  378. The SCSI definition allows up to eight "logical units" (known as LUN 0
  379. thru 7) to be accessed at each SCSI id.  Each logical unit can be a
  380. totally separate device.  In practice, most SCSI devices have only one
  381. logical unit (LUN 0), so earlier versions of ExtenDOS and ExtenDOS Pro
  382. automatically used LUN 0 for each SCSI (or ACSI) id defined in
  383. EXTENDOS.CNF.
  384.  
  385. However, CD-ROM changers (including the Pioneer DRM-602X and DRM-604X)
  386. typically implement the changer mechanism as several different LUNs
  387. (0 thru n) on one SCSI id, so ExtenDOS Pro has been updated to support
  388. this.  From a user's point of view, each LUN appears to be a separate
  389. drive, so multiple drives must be defined for each changer.
  390.  
  391. How do we define multiple LUNs to ExtenDOS Pro?  Since a LUN is an
  392. extension of the ACSI/SCSI id, the syntax for dma id in EXTENDOS.CNF
  393. has been extended to include LUN.  The format of the id is now:
  394.      D.L
  395. where D is the dma id as defined in earlier versions, and L is the
  396. LUN.  D must be from 0 to 15 inclusive; L is from 0 to 7 inclusive
  397. (valid values of course depend on the CD-ROM drive you are using).
  398. For traditional drives that only use LUN 0, you can omit the period
  399. and the L value; thus existing EXTENDOS.CNF files will continue to
  400. work without changes.
  401.  
  402. An example: define a Pioneer CD-ROM changer at dma id 5 to be six
  403. drives, P thru U inclusive:
  404.  
  405.   *BOS, C:\EXTENDOS\CD.BOS T=0, P:5.0 Q:5.1 R:5.2 S:5.3 T:5.4 U:5.5
  406.   *DOS, C:\EXTENDOS\UNIDRIVE.DOS P=16, P:P Q:Q R:R S:S T:T U:U
  407.  
  408. PLEASE NOTE: this feature of ExtenDOS Pro is not yet supported by the
  409. installation program.  If you have a CD-ROM that uses LUNs other than
  410. zero, you'll have to set up your EXTENDOS.CNF file manually.  Please
  411. feel free to contact Anodyne Software for assistance if required.
  412.  
  413.  
  414.  
  415. Known restrictions and incompatibilities
  416. ----------------------------------------
  417. 1. IMPORTANT: when using CDaudio to play audio CDs on your CD-ROM
  418.    drive, all audio output is from the CD-ROM drive itself, _not_
  419.    through your system's speaker(s).  Most CD-ROM drives provide
  420.    output sockets at the front (headphone) and rear (RCA jacks or
  421.    other connector).  In order to hear the output from your CD-ROM
  422.    drive, you _must_ connect one or other of these to your audio
  423.    equipment.
  424.  
  425. 2. NeoDesk users: if you get a message that "data on the disk is
  426.    corrupted or damaged" when you double click on the CD-ROM drive
  427.    icon, or open a folder, turn off the option 'check for
  428.    executable bootsector' in NeoDesk/Set Preferences/More.
  429.  
  430. 3. TT users: all of the resident components of ExtenDOS Pro
  431.    (EXTENDOS.PRG, CD.BOS, and UNIDRIVE.DOS/UNI_BDDS.DOS) must be
  432.    loaded into ST RAM for normal operation.  If you have a system
  433.    with alternate RAM, such as the TT030, do NOT set the program
  434.    flags to load these programs into alternate (TT) RAM.
  435.  
  436. 4. If a SCSI-2 drive is not recognised by ExtenDOS Pro (see item
  437.    13 of "New features"), photoCD _may_ not be supported.  This
  438.    restriction is due to the lack of a standard for photoCD
  439.    support.  If this situation occurs, please contact Anodyne
  440.    Software for support.
  441.  
  442. 5. Chinon CDS-435 audio support has not been tested.  If you have
  443.    this drive, and the audio playback is not working, please contact
  444.    Anodyne Software for assistance.
  445.  
  446. 6. The installation program INSTALL.APP does not work properly when
  447.    installing to a floppy drive.  If you have a floppy-only system,
  448.    please install by following the step-by-step instructions in the
  449.    manual.  If you have any problems doing this, please feel free to
  450.    email, write, or call Anodyne Software for assistance.
  451.  
  452. 7. We recommend that you always install ExtenDOS Pro in a folder
  453.    rather than in the 'root' of a disk; installing in the root
  454.    can cause a number of problems.  This is particularly true if
  455.    you use INSTALL.APP to do the installation.
  456.  
  457. 8. With certain drives (such as those with a lid rather than a tray
  458.    or caddy), the EJECT button on the CDaudio player program or
  459.    accessory cannot _physically_ eject the CD-ROM.  However, on many
  460.    such drives (including the NEC 25 and the NEC 3Xp), the EJECT
  461.    button will _logically_ eject the CD-ROM.  This means you will
  462.    have to open the drive door and close it again in order to access
  463.    the CD-ROM.
  464.    
  465. 9. If a CD-ROM drive is defined as one of the standard logical drives
  466.    (A through P), the CHEETAH file copier will exit with the message
  467.    "can't access BPB".  This is a Cheetah problem.  It examines each
  468.    of the drives A through P during initialisation, expecting them to
  469.    have a low-level file system with FATs and directories just like a
  470.    hard disk; this is not the case with a CD-ROM.  The problem can be
  471.    circumvented by reinstalling the CD-ROM drive as a logical drive
  472.    between Q and Z.
  473.  
  474.  
  475.  
  476. Acknowledgements
  477. ----------------
  478. I'd like to thank a number of people who have taken the time over the
  479. last couple of years to help me test ExtenDOS & ExtenDOS Pro on all
  480. kinds of hardware and software.  It's certainly a much better product
  481. due to their efforts, so I'd like to publicly thank the following
  482. intrepid beta testers (in alphabetical order):
  483.  
  484.      Kim Andersen
  485.      Lee Benjamin
  486.      Danny Bhabuta
  487.      Daron Brewood
  488.      Alexander Clauss
  489.      Jerry Coppess
  490.      Steve Deitz
  491.      Al Fasoldt
  492.      Gary Fuhrman
  493.      Steve Hammond
  494.      Graham Irvine
  495.      Bertil Jagard
  496.      Claude Labelle
  497.      Rob Perry
  498.      Doug Steever
  499.      Frank Tobiassen
  500.      Dale Wenzelburger
  501.  
  502. My apologies to anyone I've inadvertently omitted; please let me know
  503. and I'll include you in the next list.
  504.  
  505.  
  506.  
  507. If you have a problem
  508. ---------------------
  509. As always, you may contact Anodyne Software for help via telephone,
  510. electronic mail, or regular mail.  If you do so, please be prepared
  511. to provide the following information:
  512.    . your ExtenDOS Pro serial number (from the distribution diskette)
  513.    . a listing of your EXTENDOS.CNF configuration file
  514.    . a copy of the EXTINFO.TXT file produced by EXTINFO.PRG.  This
  515.      is particularly important if ExtenDOS Pro appears to install
  516.      correctly, but you have problems accessing data or audio CDs.
  517.      See "Using the ExtenDOS Pro information program" above for how
  518.      to run EXTINFO.PRG.
  519.  
  520.  
  521.  
  522. Roger Burrows
  523. ----------------------------------------------------------------------------
  524. GEnie:    R.BURROWS1
  525. Internet: anodyne@magi.com _or_ r.burrows1@genie.com
  526. Mail:     Anodyne Software, 6 Cobbler Court, Ottawa, Ontario K1V 0B8, CANADA
  527. Phone:    (613) 523-7498
  528. ----------------------------------------------------------------------------