home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / cdrom / nvram_tools.lha / NVRAM_Tools.doc < prev    next >
Encoding:
Text File  |  1994-12-09  |  3.2 KB  |  104 lines
  1.                                INTRODUCTION
  2.                                ~~~~~~~~~~~~
  3. Are you disappointed by the tiny amount of CD32 non volatile RAM -- NVRAM
  4. for short -- available to save your cool high scores?
  5.  
  6. Are you supposed to delete your "Pinball Fantasies" high score to save a
  7. single game (sigh!) from "Simon The Sorcerer" or "Liberation"?
  8.  
  9. Well, I do and so I've spent a couple of afternoons coding two Shell
  10. commands aptly named DumpNVRAM and RestoreNVRAM:  Guess what they are
  11. for! ;-)
  12.  
  13.  
  14.  
  15.                               WHAT DO YOU NEED
  16.                               ~~~~~~~~~~~~~~~~
  17. But I'm getting ahead of myself, so let me tell you what do you need if
  18. you'd like to giv'em a try:
  19.  
  20.    a bootable, reset proof CD32 and the SX-1;
  21.  
  22. or:
  23.  
  24.    a bootable, reset proof CD32 networked to any other Amiga;
  25.  
  26. and:
  27.  
  28.    a keyboard (either real or "faked") to type commands from;
  29.  
  30.  
  31.  
  32.  
  33.                     HOW TO SAVE AND RESTORE NVRAM CONTENTS
  34.                     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  35. It's just a matter of making DumpNVRAM and RestoreNVRAM available on the
  36. CD32, so you'll have to copy them to a floppy, hard disk or RAM:.  Once
  37. they are in the CD32 search path, they are completely yours --  Well, for
  38. your own use and enjoyment, that is! ;-)
  39.  
  40. WARNING!!! These commands are Shell only!  In other words, you *CAN'T*
  41. attach an icon to them and double-click'em from the Workbench!  If you
  42. do, you're really asking for troubles (i.e., a System Failure)!
  43.  
  44. DumpNVRAM <outfile>
  45.  
  46.    Scans the NVRAM contents and if it finds one or more saved games, asks
  47.    which one you want to copy to <outfile>.
  48.  
  49.  
  50. RestoreNVRAM <infile>
  51.  
  52.    Reads the file <infile> (created by DumpNVRAM) and asks which saved
  53.    game you want to restore to NVRAM.
  54.    Note: make sure to unlock any locked saved games first!
  55.  
  56.  
  57.  
  58.                                LEGAL STATUS
  59.                                ~~~~~~~~~~~~
  60. DumpNVRAM and RestoreNVRAM are Copyright © 1994-1995 Werther 'Mircko'
  61. Pirani but are Freely Distributable as long as the banners with the
  62. copyright notice are left intact and no money is asked for their
  63. distribution, except for the usual small fee to recover media and
  64. distribution costs.  Briefly, the usual distribution guidelines for
  65. Freely Distributable software apply.
  66.  
  67.  
  68.  
  69.                                 DISCLAIMER
  70.                                 ~~~~~~~~~~
  71. DumpNVRAM and RestoreNVRAM were coded using SAS C 6.51 and the 3.1 NDK,
  72. so I'd say they are 100% OS compliant.  Although they're definitely small
  73. (i.e., not bloated like many assembly coders still believe) I didn't use
  74. any dirty trick to cut down their size.
  75.  
  76. However, to put it simply, this software is provided "AS IS" and you are
  77. using it at your own risk, OK? ;-)
  78.  
  79.  
  80.  
  81.  
  82.                                  FEEDBACK
  83.                                  ~~~~~~~~
  84. I know, a lot more could have been done and a gadtools based GUI would be
  85. nice, for instance.  Not only it would be a lot more user friendly, but it
  86. could be used as well to lock/unlock/delete saved games.
  87.  
  88. Do you think it would be really worthwile to put more effort in it?  Just
  89. drop me a line and, if I see there's enough people interested, I'll start
  90. coding right away! ;-)
  91.  
  92.  
  93. e-mail:
  94.  
  95.   werther@karunko.nervous.com
  96.  
  97.  
  98. Snail Mail:
  99.  
  100.   Werther 'Mircko' Pirani
  101.   Via Mario Torresi, 74
  102.   60128 Ancona
  103.   Italy
  104.