home *** CD-ROM | disk | FTP | other *** search
/ World of A1200 / World_Of_A1200.iso / programs / system / romtagmem / romtagmem.doc < prev    next >
Text File  |  1995-02-27  |  5KB  |  131 lines
  1. Documentation for ROMTagMem ...
  2.  
  3.  Purpose:
  4.  --------
  5.  To add non-autoconfig memory as early as possible to the memory list.
  6.  
  7.  Reason:
  8.  -------
  9.  In situations where you have only CHIP memory and non-autoconfig
  10. memory, your system will run faster and have more CHIP memory available
  11. if as many system structures as possible are not in CHIP memory.
  12.  
  13.  In situations where you have an accelerator that does not auto-config
  14. its memory (eg Ronin Hurricane accelerators), or only auto-configs some,
  15. at a lower speed (eg PPI Zeus accelerators), such memory can be faster
  16. than any other memory. The memory is accessed on a wider bus, at a faster
  17. speed, and can be cached by the processor, while some other memory,
  18. notably CHIP, can't. The system will run faster if libraries use the
  19. fastest memory available, and this program makes such memory available
  20. to as much of the actual system software as possible.
  21.  
  22.  Warning:
  23.  --------
  24.  Do not use this program if you are not aware of what the previous
  25. paragraphs mean, and are not certain that your system can use this
  26. program, and do not know the memory range that is added into your
  27. system.
  28.  
  29.  There are ways to be sure of all these things, and if you are the sort
  30. of person who should use this program, you will already know them!
  31.  
  32.  If you use this program with the wrong parameters, and tell your system
  33. it has memory which it doesn't, the system will crash - But not until it
  34. starts accessing that (non-existant) memory.
  35.  
  36.  Method:
  37.  -------
  38.  ROMTagMem adds memory, during the boot process. This is achieved via
  39. a ROMTag, initialised very early during booting. The ROMTag eats 170
  40. bytes of chip memory, but ensures that all but two libraries (exec and
  41. expansion) end up in the new memory, thus running faster.
  42.  
  43.  Usage:
  44.  ------
  45.  Usage: ROMTagMem [-I | [-R][-D] Start Size Attributes Priority]
  46. -I : Info
  47.   Says whether or not the ROMTag is already installed, and what
  48.   memory parameters it is using if so.
  49.   Does not add or modify ROMTag when this option is specified.
  50. -R : Reboot when finished
  51.   Reboot on exit (except after -I option)
  52. -D : Reboot if installing/modifying memory sizes
  53.   Only reboots if needed for the ROMTag to take effect.
  54.  
  55.  All Parameters (Start, Size, Attributes and Priority) should be
  56. entered in Hex.
  57.  
  58.  The parameters specify your needs. Start and Size are self evident, but
  59. make sure the memory you specify exists, and isn't configured in
  60. elsewhere, as Auto-Config, or by other initialisation programs. In
  61. particular, if you use this program with PPI Zeus boards, and the Init040
  62. program which accompanies them, read the manual to find how to get Init040
  63. not to add your memory (by specifying all the other options).
  64.  
  65.  Attributes specifies the characteristics of the memory. 5 is the most
  66. common value, and specifies Fast,Public memory. Don't use anything other
  67. than 5 unless you know what you are doing. In particular, do not use 3,
  68. which is the value for Chip memory, and will undoubtable cause a crash,
  69. repeating until you do a cold reboot.
  70.  
  71.  Priority can be tailored to suit. A value of 0 is the same as most
  72. autoconfig 16bit memory, higher than 0 gives the memory priority over
  73. such memory.
  74.  
  75.  Use a program such as Nic Wilson's SysInfo to find out what your current
  76. configuration is under whatever program currently adds your memory.
  77.  
  78.  In SysInfo, use the value given as 'Start Address' (without the $ sign)
  79. for 'Start', and the value obtained by the subtraction (in hex) of
  80. 'Upper Bound' - 'Start Address'
  81.  
  82. For example, on my Hurricane machine, my memory is in the top half of
  83. the Auto-config space (but is not auto-configured). SysInfo reports
  84. Start Address = $00600000, Upper Bound = $00A00000.
  85.  
  86. I enter the line -
  87.   ROMTagMem -D 600000 400000 5 5
  88. early in my startup-sequence, at which point, after a cold boot, the
  89. system reboots, and much of it then loads into this faster memory.
  90.  
  91.  
  92.  To remove the ROMTag, Cold Boot. An easier way is to specify a Size of
  93. 0, in which case the ROMTag will not do anything.
  94.  
  95.  Limitations:
  96.  ------------
  97.  ROMTagMem will only handle one contiguous memory area.
  98.  
  99.  Distribution:
  100.  -------------
  101.  This program is public domain, and is free to anyone. No charges other
  102. than media/postage are permissible, as I don't expect them to be passed
  103. back to me. Leave the program, and associated files, in their original
  104. form, or post me any modifications as well as distributing them, and
  105. leave my name in the documentation.
  106.  
  107.  Disclaimer:
  108.  -----------
  109.  Use this program at you own risk. It is not guaranteed to not damage your
  110. computer, particularly if you pass it the wrong parameters. Understand
  111. whether you need this program, and how it should be used, before you use it.
  112.  
  113.  If there is anything in the instructions that you don't understand, do
  114. not use this program.
  115.  
  116.  Support:
  117.  --------
  118.  I don't expect to support, or modify this program in future, unless
  119. specifically asked.
  120. If you have any questions, you can reach me, John Matthews, the author, at
  121.  
  122. tribble@gphs.vuw.ac.nz - Internet
  123.  
  124. or at
  125.   4 Wadham Grove
  126.   Tawa, 6203
  127.   Wellington
  128.   New Zealand
  129.  
  130. phone (64) 4 232-7805
  131.