home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / c128 / util / csxtra42.lzh / setram.txt < prev    next >
Encoding:
Text File  |  1990-02-12  |  5.5 KB  |  137 lines
  1.  
  2.   ├OMMAND:     ╙┼╘╥┴═ (╥┼╒+ MODIFICATIONS BY ┬RUCE ╓RIELING)
  3.  
  4.   ╙EE ALSO:    ╥─╧╞╞,╥─╔╥,╟┼╘╥┴═,╥┴═─╔╙╦,╨╒╘╥┴═,╔╬╙╘┴╠╠,╥┼═╧╓┼
  5.  
  6.   ╙YNTAX:      SETRAM BANK,ADDRESS
  7.             OR
  8.                SETRAM 1750BANK+15,NUMBERñOFñ1750ñBANKS
  9.  
  10. ***╬╧╘┼***
  11.  
  12.   ╘HE CODE WITHIN  THE ╙┼╘╥┴═ MODULE AND A LARGE  PORTION OF THIS DOCUMENTATION
  13. IS (├) ╨ARSEC (WHO  BOUGHT THE CODE  FROM ├HRIS ╙MEETS). ╔  DID NOT WRITE  THIS
  14. MODULE; ╔ ONLY MODIFIED  IT TO TAKE ADVANTAGE  OF THE EXTRA MEMORY  IN EXPANDED
  15. ╥┼╒'S.  ╔ CONSIDER  MY CHANGES  TO  STILL FALL  UNDER  ╨ARSEC'S COPYRIGHT,  AND
  16. DISTRIBUTE THE CODE FOR THIS  MODULE ONLY UNDER THE SAME CONDITIONS AS THOSE OF
  17. ├╙-─╧╙ ITSELF.
  18.  
  19. ***┼╬─ ╬╧╘┼ ***
  20.  
  21.  
  22.   ╞UNCTION:
  23.  
  24.   ╙┼╘╥┴═ ALLOCATES  A PORTION OF  THE ├128'S INTERNAL ╥┴═  OR A PORTION  OF THE
  25. 17XX ╥┴═  EXPANSION CARTRIDGE  AS A  ╥┴═  DISK. ┴NY  PROGRAMS TRANSFERRED  FROM
  26. FLOPPY TO THE ╥┴═ DISK WILL  BEHAVE LIKE BUILT IN COMMANDS. ╔F YOU'RE  FAMILIAR
  27. WITH ═╙-─╧╙, ITS AS IF THE ╥┴═ DISK WAS THE ONLY DIRECTORY ON YOUR ╨┴╘╚.
  28.  
  29.   ╔F  YOU HAVE MORE THAN  ONE DRIVE, AND  YOU DON'T MIND TYPING  A DRIVE LETTER
  30. BEFORE EACH  COMMAND, YOU CAN  GET BY WITHOUT  EVER INSTALLING A ╥┴═  DISK. ┴LL
  31. COMMANDS CAN BE RUN EITHER FROM DISK OR FROM THE ╥┴═ DISK.
  32.  
  33.   ╔F YOU HAVE  A 1750, INSTALL THE ╥┴═ DISK IN  THE 1750 (SEE BELOW) AND IGNORE
  34. THESE NEXT FEW PARAGRAPHS.
  35.  
  36.   ╔F YOU DO NOT  HAVE A ╥┴═ EXPANSION CARTRIDGE,  THEN THE BEST STRATEGY  IS TO
  37. INSTALL A SMALL 8  OR 12╦ ╥┴═ DISK IN  BANK 1 FOR THE SHORTER,  FREQUENTLY USED
  38. COMMANDS, AND RUN THE LARGER ONES LIKE ┴╥├ FROM DISK. ╘HE 1571 GETS THE COMMAND
  39. INTO ╥┴═ PRETTY FAST, SO ITS NOT WORTH TYING UP THE ╥┴═.
  40.  
  41.   ╘HE ╥┴═ DISK CAN BE INSTALLED IN ANY OF BANKS 0 THROUGH 11. ╔ DON'T KNOW WHAT
  42. ├OMMODORE  HAS PLANNED FOR  BANKS 2 AND  3, BUT  FOR THE TIME  BEING AVOID THEM
  43. SINCE ╙┼╘╥┴═ WON'T ADJUST ANY  ┬┴╙╔├ POINTERS WHEN INSTALLING A ╥┴═DISK  IN ONE
  44. OF THESE BANKS. (BANK 2 IS REALLY BANK 0 AND BANK 3 IS BANK 1)
  45.  
  46.   ┬ANKS 4  THROUGH 11 ARE INTERNAL AND  EXTERNAL ╥╧═. ╔F YOU  HAVE ACCESS TO AN
  47. ┼╨╥╧═ BURNER, YOU MAY WANT TO STICK YOUR ╥┴═ DISK IN ONE OF THESE BANKS. ┴S FAR
  48. AS THE COMMAND LINE INTERPRETER IS  CONCERNED, THERE IS NO DIFFERENCE BETWEEN A
  49. ╥┴═ DISK AND A ╥╧═ DISK, SO YOU  CAN FIDDLE AROUND WITH THINGS IN ╥┴═, AND WHEN
  50. YOU LIKE WHAT YOU SEE, JUST ╨╒╘╥┴═ TO A DISKFILE AND BURN IT INTO AN ┼╨╥╧═.
  51.  
  52.   ═ORE LIKELY, YOU'LL  BE INSTALLING YOUR  ╥┴═ DISK  IN EITHER BANK  1 OR  BANK
  53. ZERO. ╘HERE ARE A COUPLE OF THINGS TO THINK ABOUT.
  54.  
  55.   ╙OME OF  THE  COMMANDS  (┴╥├,  ═╧╓┼ AND  ├╧╨┘  FOR  NOW) USE  BANK  1  AS  AN
  56. INPUT/OUTPUT  BUFFER. ╘HE BUFFER  STARTS WHERE THE  ─╧╙ SHELL  ENDS ($4000) AND
  57. GOES UP   TO WHATEVER ADDRESS  IS SET AS ┬┴╙╔├'S  TOP OF ╥┴═ (I.E  THE START OF
  58. YOUR ╥┴═  DISK  IF IT'S IN BANK  1). ╔F THE ╥┴═  DISK GETS TOO BIG, THE  BUFFER
  59. GETS TOO  SMALL, AND  THERE WILL BE  MORE DISK  HEAD MOVEMENT  ON SINGLE  DRIVE
  60. SYSTEMS.
  61.  
  62.   ┬ANK 0 ISN'T A VERY GOOD  PLACE TO STICK THE ╥┴═  DISK. ╔T'S A LOT EASIER  TO
  63. WRITE PROGRAMS TO RUN IN BANK ZERO, SO ITS MORE LIKELY TO GET CLOBBERED BY SOME
  64. APPLICATION. ┴╥├ NEEDS ╥┴═  UP TO $├000 (49152) IN BANK ZERO, SO IF YOU PLAN TO
  65. USE ┴╥├ THAT'S THE LOWEST ADDRESS YOU CAN SELECT. (NONE OF THE COMMANDS USE ╥┴═
  66. ABOVE $├000, SO IF THAT'S ENOUGH YOUR ╥┴═ DISK WILL BE REASONABLY SAFE HERE)
  67.   ╔ WILL TRY TO LEAVE  $├000 AND ABOVE ALONE IN EITHER BANK, BUT  IN SOME CASES
  68. (╠╚┴ FOR EXAMPLE) THAT JUST  ISN'T POSSIBLE. ╬O MATTER WHAT BANK YOU'RE IN, THE
  69. ABSOLUTE LOWEST ADDRESS YOU CAN START YOUR ╥┴═ DISK AT IS $4000 (16384).
  70.  
  71.  
  72.   ╘O STICK IT IN THE 1750 THE SYNTAX IS...
  73.  
  74.     SETRAM 1ST-BANK,#-OF-BANKS
  75.  
  76.   ...WHERE BANKS 16, 17...47 CORRESPOND TO THE 1750 BANKS 0,  1...31. ╬OTE THAT
  77.   A SINGLE RAMDISK CANNOT BE LARGER THAN 512╦, OR 8 BANKS.
  78.  
  79.   ╘HUS..
  80.  
  81.     SETRAM 16,8
  82.  
  83.   WOULD USE THE FIRST 512╦ OF AN ╥┼╒,
  84.  
  85.     SETRAM 22,2
  86.  
  87.   WOULD USE ONLY THE LAST TWO BANKS OF THE FIRST 512╦, AND
  88.  
  89.     SETRAM 24,4
  90.  
  91.   WOULD USE THE FIRST 4 BANKS ┴╞╘┼╥ THE INITIAL 512╦ (ONLY ON ╥┼╒+ DEVICES).
  92.  
  93.  ┘OU CAN HAVE MORE THAN ONE ╥┴═DISK IF YOU WANT, BUT ONLY ONE CAN BE ACTIVE  AT
  94. A GIVEN TIME.
  95.  
  96.   ┬ECAUSE OF THE LENGTH OF TIME THAT IT TAKES TO LOAD A LARGE ╥┴═ DISK INTO THE
  97. 1750, ╙┼╘╥┴═ DOES NOT  INITIALIZE THE ╥┴═DISK. ╘HIS MEANS THAT WHATEVER HAPPENS
  98. TO BE THERE  IN THE 1750 IS ASSUMED  TO BE A VALID ╥┴═ DISK.  ╘HE AUTOEXEC FILE
  99. SUPPLIED WITH ├╙-─╧╙ TRIES  TO DETERMINE IF  THE ╥┴═ DISK IS  IN FACT VALID  BY
  100. ATTEMPTING  TO  RUN ├╙-─╧╙'S  ╔╞  COMMAND. ╔F  THE  ╔╞ COMMAND  IS  THERE, THEN
  101. PRESUMABLY THE ╥┴═ DISK  IS INTACT AND WE CAN  SAVE SOME TIME BY NOT  HAVING TO
  102. LOAD IT FROM DISK.
  103.  
  104.   ╔F YOU DO WANT  TO INITIALIZE THE ╥┴═ DISK, THERE ARE TWO  WAYS TO DO IT. ╧NE
  105. IS TO USE ╟┼╘╥┴═  TO LOAD A PREVIOUSLY PREPARED  ╥┴═ DISK. ╘HE OTHER IS  TO USE
  106. ┬┴╙╔├'S STASH COMMAND  TO STORE TWO ZEROS WHERE THE ╥┴═  DISK BEGINS. ┘OU WOULD
  107. NEED TO DO THIS IF YOU WERE TO BUILD UP A NEW ╥┴═ DISK FROM SCRATCH.
  108.  
  109.   ╞OR  EXAMPLE, THIS  WOULD  ESTABLISH A  ╥┴═ DISK  IN  THE 1750'S  BANK 0  AND
  110. INITIALIZE IT.
  111.  
  112.   SETRAM 16,1
  113.   POKE 4864,0:POKE 4865,0
  114.   STASH 2,4864,BANK,0
  115.  
  116.   ╫HERE BANK IS THE FIRST BANK OF THE 1750 USED BY THE ╥┴═ DISK.
  117.   (IN THIS CASE 0)
  118.  
  119.  
  120.  
  121.   ┼XAMPLES:
  122.  
  123. A:SETRAM 1,$B000         INSTALL ╥┴═ DISK IN BANK 1 AT 45056
  124.  
  125. A:SETRAM 0,49152         INSTALL ╥┴═ DISK IN BANK 0 AT $├000
  126.  
  127. A:SETRAM 8 $4000         ╥┴═  DISK IS  IN  A  CARTRIDGE.  ╔F  WHAT  IS  IN  THE
  128.                          CARTRIDGE IS  NOT A  ╥┴═ DISK,  THEN  RESULTS WILL  BE
  129.                          UNPREDICTABLE.
  130.  
  131. A:SETRAM 16,1            ╒SE ONLY THE 1ST BANK OF THE 17XX ╥┼╒
  132.  
  133. A:SETRAM 24,8            ╒SE BANKS 8-15 OF AN ╥┼╒+.
  134.  
  135. A:SETRAM 43,4            ╒SE BANKS 27-31 OF AN ╥┼╒+.
  136.  
  137.