home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C128Toolkit / CSXTRA45.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+1,NUMBERñOFñ1750ñBANKS
  9.  
  10. ***╬╧╘┼***
  11.  
  12.   ╘HE CODE WITHIN  THE ╙┼╘╥┴═ MODULE AND A LARGE  PORTION OF THIS DOCUMENTATION
  13. IS  (├)  ╨ARSEC. ╔  DID  NOT WRITE  THIS MODULE;  ╔  ONLY MODIFIED  IT  TO TAKE
  14. ADVANTAGE OF THE EXTRA MEMORY IN EXPANDED ╥┼╒'S. ╔ CONSIDER MY CHANGES TO STILL
  15. FALL UNDER  ╨ARSEC'S COPYRIGHT,  AND DISTRIBUTE THE  CODE FOR THIS  MODULE ONLY
  16. UNDER THE SAME CONDITIONS AS THOSE OF ├╙-─╧╙ ITSELF.
  17.  
  18. ***┼╬─ ╬╧╘┼ ***
  19.  
  20.  
  21.   ╞UNCTION:
  22.  
  23.   ╙┼╘╥┴═ ALLOCATES A  PORTION OF THE  ├128'S INTERNAL ╥┴═  OR A PORTION  OF THE
  24. 17XX ╥┴═  EXPANSION CARTRIDGE  AS  A ╥┴═  DISK. ┴NY  PROGRAMS TRANSFERRED  FROM
  25. FLOPPY  TO THE ╥┴═ DISK WILL BEHAVE LIKE  BUILT IN COMMANDS. ╔F YOU'RE FAMILIAR
  26. WITH ═╙-─╧╙, ITS AS IF THE ╥┴═ DISK WAS THE ONLY DIRECTORY ON YOUR ╨┴╘╚.
  27.  
  28.   ╔F  YOU HAVE MORE  THAN ONE DRIVE, AND  YOU DON'T MIND  TYPING A DRIVE LETTER
  29. BEFORE EACH COMMAND,  YOU CAN GET BY  WITHOUT EVER INSTALLING  A ╥┴═ DISK.  ┴LL
  30. COMMANDS CAN BE RUN EITHER FROM DISK OR FROM THE ╥┴═ DISK.
  31.  
  32.   ╔F YOU HAVE A 1750,  INSTALL THE ╥┴═ DISK IN THE 1750 (SEE  BELOW) AND IGNORE
  33. THESE NEXT FEW PARAGRAPHS.
  34.  
  35.   ╔F YOU DO NOT HAVE  A ╥┴═ EXPANSION CARTRIDGE,  THEN THE BEST STRATEGY IS  TO
  36. INSTALL A SMALL 8  OR 12╦ ╥┴═ DISK IN  BANK 1 FOR THE SHORTER,  FREQUENTLY USED
  37. COMMANDS, AND RUN THE LARGER ONES LIKE ┴╥├ FROM DISK. ╘HE 1571 GETS THE COMMAND
  38. INTO ╥┴═ PRETTY FAST, SO ITS NOT WORTH TYING UP THE ╥┴═.
  39.  
  40.   ╘HE ╥┴═ DISK CAN BE INSTALLED IN ANY OF BANKS 0 THROUGH 11. ╔ DON'T KNOW WHAT
  41. ├OMMODORE HAS PLANNED  FOR BANKS  2 AND 3,  BUT FOR THE  TIME BEING AVOID  THEM
  42. SINCE ╙┼╘╥┴═ WON'T  ADJUST ANY ┬┴╙╔├ POINTERS WHEN INSTALLING  A ╥┴═DISK IN ONE
  43. OF THESE BANKS. (BANK 2 IS REALLY BANK 0 AND BANK 3 IS BANK 1)
  44.  
  45.   ┬ANKS 4 THROUGH  11 ARE INTERNAL AND  EXTERNAL ╥╧═. ╔F YOU HAVE  ACCESS TO AN
  46. ┼╨╥╧═ BURNER, YOU MAY WANT TO STICK YOUR ╥┴═ DISK IN ONE OF THESE BANKS. ┴S FAR
  47. AS THE COMMAND LINE INTERPRETER IS CONCERNED, THERE IS NO  DIFFERENCE BETWEEN A
  48. ╥┴═ DISK AND A ╥╧═ DISK, SO YOU CAN FIDDLE AROUND WITH THINGS IN ╥┴═, AND  WHEN
  49. YOU LIKE WHAT YOU SEE, JUST ╨╒╘╥┴═ TO A DISKFILE AND BURN IT INTO AN ┼╨╥╧═.
  50.  
  51.   ═ORE  LIKELY, YOU'LL  BE INSTALLING YOUR  ╥┴═ DISK  IN EITHER BANK  1 OR BANK
  52. ZERO. ╘HERE ARE A COUPLE OF THINGS TO THINK ABOUT.
  53.  
  54.   ╙OME  OF THE  COMMANDS  (┴╥├,  ═╧╓┼ AND  ├╧╨┘  FOR  NOW)  USE BANK  1  AS  AN
  55. INPUT/OUTPUT BUFFER.  ╘HE BUFFER STARTS  WHERE THE  ─╧╙ SHELL ENDS  ($4000) AND
  56. GOES UP   TO WHATEVER ADDRESS  IS SET AS ┬┴╙╔├'S  TOP OF ╥┴═ (I.E  THE START OF
  57. YOUR ╥┴═  DISK  IF IT'S IN BANK  1). ╔F THE ╥┴═  DISK GETS TOO BIG,  THE BUFFER
  58. GETS TOO  SMALL, AND  THERE WILL  BE MORE  DISK HEAD  MOVEMENT ON  SINGLE DRIVE
  59. SYSTEMS.
  60.  
  61.   ┬ANK 0 ISN'T  A VERY GOOD PLACE TO  STICK THE ╥┴═ DISK. ╔T'S A  LOT EASIER TO
  62. WRITE PROGRAMS TO RUN IN BANK ZERO, SO ITS MORE LIKELY TO GET CLOBBERED BY SOME
  63. APPLICATION. ┴╥├ NEEDS ╥┴═ UP TO $├000 (49152) IN BANK ZERO, SO IF YOU  PLAN TO
  64. USE ┴╥├ THAT'S THE LOWEST ADDRESS YOU CAN SELECT. (NONE OF THE COMMANDS USE ╥┴═
  65. ABOVE $├000, SO IF THAT'S ENOUGH YOUR ╥┴═ DISK WILL BE REASONABLY SAFE HERE)
  66.  
  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.