home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / cdrom / Player / PlayCD / InstallCDFSDemo next >
Text File  |  1995-02-05  |  13KB  |  428 lines
  1. Welcome to this release (v2.3) of the CacheCDFS!
  2.  
  3. Structure of this document
  4.  
  5. - All new features not mentioned in the manual are listed
  6. - Some tips running the software are given
  7. - All bugs that have been removed are listed
  8.  
  9.  
  10. IMPORTANT NOTE!!
  11.  
  12. The installation files "Make CD32 Floppy" and "Make HD Startup"
  13. have changed!
  14.  
  15. You MUST run these scripts again, after you upgraded to this
  16. release!
  17.  
  18.  
  19.  
  20.  
  21. NEW FEATURES
  22.  
  23.  
  24. PlayCD
  25.  
  26. Finally I've written a SCSI-II CDDA Audio player.
  27. It is very small and powerful.
  28. See the PlayCD.doc file for further details.
  29.  
  30.  
  31. Toshiba_XA
  32.  
  33. The program is no longer needed and has been removed (see below).
  34. If Toshiba_XA (or a similar program) is installed on your machine,
  35. it should be deleted!
  36.  
  37.  
  38. CDFSprefs 43.x and FileSystem 43.x
  39.  
  40.  
  41. Gadget QUIET
  42. (Similar to "Q" in Control field of mountlist entry)
  43.  
  44. Will disable warning requesters during mount.
  45. This is useful, if you have an external CD-Rom drive which is
  46. not always switched on and you wish to leave automount enabled.
  47.  
  48. Gadget AUTOLOWER
  49. (Similar to "AL" in Control field of mountlist entry)
  50.  
  51. If a CD with "real" lowercase characters is inserted, 
  52. the conversions to lowercase are temporary switched off.
  53.  
  54.  
  55. Gadget NO ROCKRIDGE
  56. (Similar to "NRR" in Control field of mountlist entry)
  57.  
  58. Disables RockRidge file names, use ISO file names instead.
  59.  
  60.  
  61. Gadget ROCKRIDGE CASE SENSITIVE
  62. (Similar to "NRR" in Control field of mountlist entry)
  63.  
  64. Enables case sensitive file name checking for RockRidge names.
  65. This is required as some Posix RR CDs may have file names which
  66. are only different in their case (e.g. Foo, foo).
  67.  
  68.  
  69. Menu AUDIO - ON
  70. (Similar to "NOAUDIO" in Control field of mountlist entry)
  71.  
  72. Specifies, if the FileSystem should take care of Audio CDs.
  73.  
  74.  
  75. Menu AUDIO - EXTERNAL / AUDIO - PATH
  76. (Similar to "AUDIO" in Control field of mountlist entry)
  77.  
  78. Here you can specify an optional external Audio player.
  79.  
  80.  
  81. The FileSystem now supports MultiSession CDs without the need of
  82. additional tools.
  83.  
  84. The FileSystem is now able to recognize Audio CDs and can play
  85. them by double clicking the CDDA icon (This only works with SCSI-II
  86. compatible CD-Rom drives!).
  87.  
  88. Each double click will play/pause the current track.
  89.  
  90. A double-double click (4 times!) will skip to the next track.
  91.  
  92. If you like to use an own icon instead of the default one, copy it
  93. to ENV:CDDA.info BEFORE starting the CacheCDFS.
  94.  
  95. With the CDFSprefs program you can define an external Audio player
  96. (e.g the new PlayCD) which will be started if you click the CDDA icon.
  97.  
  98. The FileSystem now supports XA-Disks with Toshiba CD-Roms.
  99. The Toshiba_XA program is obsolete and has been deleted from the
  100. distribution disk.
  101.  
  102. Typing "Version CD0:" now works.
  103.  
  104. ACTION_INHIBIT issued by the Workbench task is now ignored, making life
  105. much easier for a poor filesystem programmer.
  106. Thanks go to Ralph Babel for this hint.
  107.  
  108. RockRidge disks are now much better supported.
  109. You can switch between ISO and RockRidge filenames with the preferences
  110. program. Further you can decide if you wish to have RockRidge filenames
  111. case sensitive or not. Thanks go to Angela Schmidt for this suggestion.
  112.  
  113.  
  114.  
  115.  
  116. CD32-Emulator 43.x
  117.  
  118. Gadgets that are not useful for your configuartion are now ghosted 
  119. (e.g. NoFastMem on ChipMem only machines, NoDataCache on 68020 machines).
  120.  
  121. USE 68040.LIBRARY
  122. Only selectable on machines with an MC68040 or better processor.
  123. The Commodore 68040.library is only loaded, if this gadget is
  124. selected. Some programs (e.g. Oscar or Video Creator) have severe
  125. problems, if this library is loaded. Once the Emulator is initialized
  126. or SetPatch has been run, this gadget will be ghosted and the settings
  127. can't be changed anymore.
  128. If you don't wish to use the commodore 68040.library, a private "dummy" 
  129. 68040.library will be used instead.
  130. Note that this "dummy" library will always disable the DataCache to
  131. work properly with Zorro-III DMA boards.
  132.  
  133. LOAD WORKBENCH
  134. Will load the Workbench immediately BEFORE booting from a CD.
  135. This is required for the game Morph (and possibly others) to run and
  136. sometimes handy for debugging purposes.
  137.  
  138. TOOLTYPE CDWIN ENTRY
  139. This defines the stream, where any output from the startup-sequence of
  140. a CD appears while it is booted.
  141. Previous versions always used NIL: as the output stream which caused
  142. funny effects sometimes.
  143. The default is CDWIN=CON:0/0/700/600/CD-Startup/AUTO/CLOSE, meaning
  144. that the window will only open IF the startup-sequence does any
  145. output.
  146. Usually you shouldn't need to touch this!
  147. To restore default behaviour, simply delete the entry.
  148. Then start the emulator and save settings.
  149.  
  150. Any filename is allowed here.
  151. Examples: 
  152. CDWIN=NIL: will disable any output.
  153. CDWIN=CON:0/0/700/600/CD-Startup/AUTO/CLOSE/WAIT will keep the window
  154. open until you hit the close gadget.
  155. CDWIN=Harddisk:name will write the output to a file on your harddisk.
  156.  
  157.  
  158. TOOLTYPE NOAGA ENTRY
  159. For debugging only. Keep your hands off!
  160. Only documented here for all you "ToolTypeWatch" hackers. 
  161. Will disable AA/AGA modes. Works only if SetPatch hasn't been run yet.
  162. Saving settings will always discard this entry.
  163. Is of not much use for you anyway.
  164.  
  165.  
  166. CDTV DISCS
  167. If you try to boot from a CDTV disc, a warning requester will appear.
  168. You may now select, if you like to Boot with AA/AGA or ECS emulation.
  169. (Some CDTV Titles do not work correctly with AA/AGA enabled).
  170. This only works if SetPatch has not been run yet!
  171. Again: None of the CDTV specific system modules (e.g. cdtv.device) are 
  172. currently emulated!
  173. Programs using CDTV system modules will NOT work properly, even if they
  174. work with a CD32!
  175.  
  176.  
  177. Support for CDROMS faster than double speed
  178. A new gadget was added: Delay p. Block. If your CD-Rom is a triple or
  179. quadruple speed drive, you may add delays between reading of blocks.
  180. Good values should be between 50 and 100 for fast drives.
  181. Leave it to zero, if you have a single or double speed drive.
  182.  
  183.  
  184.  
  185. TIPS
  186.  
  187.  
  188. SetPatch:
  189. SetPatch 40.14 or better is required by the CD32-Emulator.
  190. SetPatch should NOT be run before you start the CD32-Emulator to get
  191. full control of all features (AA/ECS switch, 68040.library control).
  192. The Emulator will load SetPatch if you click INSTALL or BOOT.
  193. If you quit, SetPatch will not be loaded. This is no problem, as
  194. in case of your normal startup-sequence SetPatch will be loaded
  195. anyway. This strategy should always work for any configuration.
  196.  
  197.  
  198. Oktagon/ALF-III/ALF-II users:
  199. For best performance of the emulator, you should use the SoftSCSI#?.device
  200. instead of the oktagon.device or ALF.device.
  201. While installing the software, select the SoftSCSI#?.device from
  202. FindCD and click USE.
  203.  
  204.  
  205. TandemCD / bsc CD1200 users:
  206. New tandemcd#?.devices (version 41.6) are on this disk.
  207. The installer utility will automatically update the appropriate device.
  208.  
  209. Changes made:
  210.  
  211. Workaround for bug in Mitsumi FX-001D (Rev. D-02) firmware added.
  212.    
  213. This fixes the "Read-Error" problem with some Amiga CDs
  214. (e.g. Megahits 2, GigaPD Update 2).
  215. The drive has to be put in a special "recovery" mode, otherwise
  216. these CDs will cause read errors or other strange behaviour.
  217. The device driver will only switch in this special mode, if
  218. the drive fails to recover with its own built-in error correction 
  219. after 5 read retries.
  220. So, it may take about 10 seconds for the device to switch into
  221. this "special" mode.
  222. This mode will be kept active until you change the disk.
  223. (Gee, this is clever, isn't it?)
  224.  
  225. I know this really is a kludge, but reading these CDs in a clumsy,
  226. slow and non elegant way is far better than not reading them at all!
  227.  
  228. This strategy works fine with my test equipment (A4000/40, TandemCD,
  229. Mitsumi FX-001-D Rev D-02) and the speed is at least acceptable.
  230.  
  231. PLEASE LET ME KNOW IF THIS METHOD FIXES YOUR PROBLEMS!
  232.    
  233.  
  234.  
  235. 68040 users:
  236. Machine crashes before loading the CD32-Emulator:
  237.  
  238. In general, you should NOT use the Commodore 68040.library for playing
  239. CD32-Titles! Most titles do NOT work properly with the 68040.library!
  240. Make sure, that SetPatch or Enforcer are NOT run before you
  241. start the CD32-Emulator, as they WILL load the 68040.library!
  242.  
  243. First solution: Try to get the obsolete 68040.library version 37.4
  244. from Commodore (the version shipped with Workbench 3.0 is 37.10, the
  245. version shipped with Workbench 3.1 is 37.30). Version 37.4 doesn't make
  246. so much problems with CD32 games.
  247.  
  248. If your machine crashes or behaves strange while loading the emulator
  249. (which should never happen!), try the following:
  250.  
  251. - Make a Boot floppy with "Make CD32 Floppy"
  252. - Edit the startup-sequence.
  253.   Add "C:SetPatch QUIET NOCACHE" before the emulator is started.
  254.  
  255. If now all works fine, but you have titles not running correctly with
  256. the Commodore 68040.library, try this:
  257.  
  258. - Delete the 68040.library from the Boot Floppy.
  259.   Delete DF0:LIBS/68040.library
  260.  
  261. - Copy the 68040_dummy.library (locacted in your CD32 directory) to the 
  262.   LIBS: directory of the Boot Floppy and rename it to 68040.library.
  263.   Copy .../CD32/68040_dummy.library to DF0:LIBS/68040.library
  264.  
  265. Check the spelling! Do not use uppercase letters!
  266.  
  267. If the 68040_dummy.library does not work with your 68040 board, you are
  268. out of luck. Please give me a note if this happens!
  269.  
  270.  
  271.  
  272. BUG FIXES & OTHER ENHANCEMENTS
  273.  
  274.  
  275. Since the first release (Disk 1.3), the following bugs were fixed:
  276.  
  277.  
  278. CDFS Install script:
  279.  
  280. Added quotes around device name, as this is required by older mount
  281. commands.
  282.  
  283.  
  284.  
  285. CD32-Emulator (control module):
  286.  
  287. NOWININIT was broken! If NOWININIT was specified in the ToolTypes,
  288. the other tooltype settings were not interpreted correctly.
  289. This bug was reported by Keith Smith of Almathera Systems, otherwise
  290. it would have be still unnoticed.
  291. Thank you, Keith!
  292.  
  293. GAME STORE requester opened not relative to the current directory.
  294.  
  295. Now interprets the CDs startup-sequence before executing it, leaving
  296. out any commands dangerous for your system. This greatly enhances
  297. compatibility (e.g. Video Creator does not crash anymore if you
  298. click "BOOT". In fact, it was the NoReset program that crashed the
  299. machine!).
  300.  
  301. Having a seperate output stream enhances compatibility with PD-Disks
  302. (e.g. The Demo Collection) designed for the CDTV.
  303.  
  304. Booting now happens as a seperate process, allowing the emulation
  305. to free all no longer used resources after the boot sequence has been
  306. started.
  307.  
  308. Device checking is now performed in the control module (was in cd.device).
  309. Errors generated, if device is no CD-Rom or CD-Rom doesn't support SCSI-2.
  310.  
  311.  
  312.  
  313. CD32-Emulator install scripts:
  314.  
  315. Line 120 of the "Make CD32 Floppy" script was bogus.
  316.  
  317. The scripts omitted the use of the Commodore 68040.library.
  318. Bad idea, since this crashes on machines with Zorro-III DMA
  319. controllers or Second-Level cache 68040 boards.
  320. The CD32-Emulator gives you now more sophisticated control over
  321. 68040.library use (see above) by adding an own "dummy" 68040.library
  322. and should NEVER EVER crash again (hopefully)!
  323.  
  324.  
  325.  
  326. cd.device
  327.  
  328. The data direction specified in SCSI direct commands was sometimes
  329. wrong (caused by a very stupid typing mistake...). 
  330. This badly confused GVP and Fastlane controllers.
  331. Reported by almost everyone having such beasts (sigh).
  332. Fixed since Disk release 1.3b.
  333.  
  334. LUN now inserted in CDB.
  335.  
  336. Device checking moved to control module.
  337.  
  338.  
  339. freeanim.library:
  340.  
  341. Private LVOs added.
  342. Open count always 1.
  343.  
  344.  
  345.  
  346. nonvolatile.library:
  347.  
  348. Open count always 1.
  349.  
  350.  
  351.  
  352. lowlevel.library:
  353.  
  354. Open count always 1.
  355.  
  356.  
  357.  
  358. CacheCDFS
  359.  
  360. As a well behaving filesystem, CacheCDFS sometimes uses SCSIF_AUTOSENSE.
  361. This confused older Fastlane controllers (this time not my fault!).
  362. Workaround for these controllers added. Fixed since Disk release 1.3a.
  363.  
  364. Starting with version 41.x, CacheCDFS can read CDs with a logical sector
  365. size different from 2048 bytes (e.g. required by the Fish & More III CD
  366. from Xetec).
  367.  
  368. Added dynamic changes depending on the CD inserted to the fssm environment
  369. for the 42.x release.
  370. This was requested by Angela Schmidt for future development.
  371.  
  372. NOTE FOR DEVELOPERS:
  373. If the a CD is changed while the FileSystem is inhibited, the fssm
  374. enviromnemt will NOT change!
  375. If you detect a disk change, you MUST do an ACTION_INHIBIT FALSE for
  376. the environment to become valid again.
  377. The DosList must be unlocked for the change to happen immediately.
  378.  
  379.  
  380. ACTION_INHIBIT didn't behave correctly. Fixed in 42.x.
  381. (Found by Angela Schmidt, thank you for the report!)
  382.  
  383.  
  384. New Control entries:
  385.  
  386. Q (Quiet, see above)
  387.  
  388. AL (AutoLowercase, see above)
  389.  
  390. AUDIO (Defines optional external audio player, see above)
  391.  
  392. NOAUDIO (Disables all audio handling, see above)
  393.  
  394. NRR (NoRockRidge, see above)
  395.  
  396. RRCASE (RockRidge case sensitive, see above)
  397.  
  398.  
  399.  
  400.  
  401. CDFSprefs
  402.  
  403. Window now opens pointer relative.
  404.  
  405.  
  406.  
  407. FindCD
  408.  
  409. Window now opens pointer relative.
  410.  
  411. LUN now inserted in CDB.
  412.  
  413. ALF/Oktagon SoftSCSI#?.device is now included in automatic scan.
  414. ALF.device & oktagon.device are removed from automatic scan.
  415.  
  416.  
  417.  
  418. YACDP (Freeware program)
  419.  
  420. Exchanged version 1.0 with version 1.1
  421. Replaced reqtools.library with a newer version.
  422.  
  423.  
  424.  
  425.  
  426. END OF DOCUMENT
  427.  
  428.