home *** CD-ROM | disk | FTP | other *** search
/ CBM Funet Archive / cbm-funet-archive-2003.iso / cbm / c128 / utilities / reu2disk.sfx / read.me < prev    next >
Text File  |  1990-02-12  |  6KB  |  128 lines
  1.          
  2.                                   Mini-Manual
  3.                                   -----------
  4.          
  5.          The two routines, reu2disk and disk2reu appeared in the most 
  6.          recent issue of '8 Bits and Change', a CP/M magazine published 
  7.          by the User Group in Connecticut of the same name.
  8.          
  9.          The author of the article, a C128 user explained that he wrote 
  10.          the routine to make a mirror image of his 1750 (512k) REU, so 
  11.          that he could quickly reconstruct the REU for CP/M use while 
  12.          still in 128 mode.  This would be a lot faster than copying 
  13.          over all its many, many files, once operating with the CP/M 
  14.          system.  As an added benefit, he uses several 'copies' of the 
  15.          REU, each set up with its own files for specific applications.
  16.          
  17.          The routine as published would not work for me, at first, 
  18.          until I added the bank switching which were in one routine, 
  19.          but not the other.  It now works fine for a CP/M REU, and is 
  20.          especially welcome with RAMLink.  At present RL offers limited 
  21.          CP/M support.  The result: CP/M from RL runs slow.  This 
  22.          routine lets RL quickly (in seconds) construct the REU, then 
  23.          after a Boot into CP/M, profile.sub switches over to a submit 
  24.          in the already constructed REU, and things run fast.
  25.          
  26.          These routines work equally as well with CS/DOS (the 
  27.          appropriate poke to 6000 is required *before* running shell, 
  28.          to let DOS know a REU is ready).  I have not as yet tried it 
  29.          with other applications.
  30.            
  31.          It would be interesting to know if it would work equally as 
  32.          well with GEOS, Basic8 (if some of its applications could be 
  33.          changed so that they do not *always* reconstruct a REU), and 
  34.          other uses.
  35.           
  36.          Perhaps we could add additional uses to this file.
  37.          
  38.                                    How To Use
  39.                                    ----------
  40.          
  41.          Copying the REU:
  42.          ----------------
  43.          
  44.          (1)  Set up the REU as you want it to be.  In CP/M mode load 
  45.          it with the files you want.  In CS/DOS add all the files you 
  46.          may want to its RamDisk.  (I put everything in there.)
  47.          
  48.          (2)  Return to 128 mode in a way that does not alter the REU.  
  49.          In CP/M pressing Control/Enter, in CS/DOS, entering Basic.
  50.          
  51.          (3)  Load 'reu2disk'.  It will write sixteen 32k files to 
  52.          disk, which will be a mirror image of the REU.  It will write 
  53.          to device # 16.  If you want to change this to another device, 
  54.          change the 'u16' that appears in line 140 to 'u8' or whatever 
  55.          other device you may want to use.  (You may want to @SAVE your 
  56.          new file configuration.)  Allow space for the 16 files which 
  57.          will have the names memblock0 thru memblock15.
  58.          
  59.          Steps 1 thru 3 have to be done only once, and should be 
  60.          followed for each mirror image of the REU that you may want.
  61.          
  62.          
  63.          
  64.          
  65.          
  66.          
  67.          
  68.          Writing back to the REU:
  69.          ------------------------
  70.          
  71.          (1)  Load and run 'disk2reu'.
  72.          
  73.          Before doing this, make any changes to the device number you 
  74.          are running it from by changing the 'u16' which appears in 
  75.          line 130 to a 'u8' or other device number.  (@SAVE your custom 
  76.          configuration.)
  77.          
  78.          (2) Run the application that uses the REU, adding any 'clues' 
  79.          to its loader to let it know it is only 're-booting' with its 
  80.          REU intact.  A poke6000,x (I forget the number right now, it 
  81.          may be 64) tells this to CS/DOS.  Nothing is required for 
  82.          CP/M.
  83.          
  84.          That's it!!
  85.          
  86.                               Other Considerations
  87.                               --------------------
  88.          
  89.          The code can be modified for those using a 1700 or 1764, as 
  90.          well as those with custom expanded REUs.  
  91.          
  92.          A REU image uses 512k of disk space for a 1750, so a 1581 
  93.          drive is required. Those using 1571 drives can modify the code 
  94.          to pause, for re-loading of another disk, or limit the image 
  95.          to 360k. Changing the banks (not the program's bank switching) 
  96.          can then save any configuration.  (For example, CS/DOS allows 
  97.          REU bank assignments.  By selecting higher REU banks for 
  98.          CS/DOS, both it and Digital's three Pocket programs can share 
  99.          the same REU.  Care must be taken since one can overwrite the 
  100.          other's usage of the REU.  With disk2reu it is not any problem 
  101.          since a new REU can be loaded for a next application.
  102.           
  103.          The author, in the article, suggests that others may wish to 
  104.          add burst load and save routines to speed up these programs.  
  105.          (This is not needed when running them from RL, since it will 
  106.          fill a REU in about 2 or so seconds.)
  107.          
  108.                                A Word of Caution
  109.                                -----------------
  110.          
  111.          These routines are used to best advantage when the REU image 
  112.          is confined to programs and their support files.  However, 
  113.          they may be used anyway you like.
  114.          
  115.          DO NOT FORGET to filecopy individual data files on the REU, 
  116.          back to disk.  Unless another disk image is made with 
  117.          reu2disk, any changes to the REU will not be there next time 
  118.          disk2reu reloads the 1750.
  119.          
  120.                                     Finally
  121.                                     -------
  122.          
  123.          If you add any useful custom enhancements to these routines, 
  124.          please consider uploading and sharing these with other users.
  125.          
  126.          Howard Herman
  127.          12/25/91
  128.