home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / commodore-scene-files / Retroreplay / README.TXT < prev    next >
Text File  |  2019-04-13  |  11KB  |  281 lines
  1. Cyberpunx Flash Utility README.TXT  ------ REALLY ! README !!!!
  2.  
  3. For Retro Replay and Action Replay compatibles only!
  4.  
  5. This document belongs to the Retro Replay site - http://www.ar.c64.org
  6.  
  7. ----------------------------------------------------
  8. Using this utility will destroy the initial
  9. contents of your Retro Replay cartridge !!!
  10. Please be aware of this and read the notes
  11. precisely. Also backup the initial contents
  12. of the Flashrom, since we cannot guarantee
  13. that your transfers from the internet to
  14. your c64 (probably using a PC) are successful.
  15. We recommend the use of 1581copy (0.53+),
  16. Starcommander and similar software to transfer
  17. your downloads. Just make sure it's reliable. :)
  18. ----------------------------------------------------
  19.  
  20. To avoid confusion:
  21. -------------------
  22.  
  23. Your Retro Replay has a 128kb FlashROM split up into 2 banks of 64kb each selectable with a jumper.
  24. These 64kb banks are referred to as banks by me, since thats a logical name from the point of view
  25. when looking at the FlashROM device.
  26. From the C64 point of view and naming ideas, the various 8kb chunks which fill up the 32kb and
  27. 64kb ROMs are named BANKS aswell.
  28. This may lead to confusion whenever not being aware of it. :)
  29.  
  30.  
  31.  
  32. Revision History
  33. ----------------
  34.  
  35. 0.01  -  Initital release. Shipped to the masses with
  36.          the TOOL command on the 2nd bank of the new
  37.      RR.
  38.  
  39. 0.02  -  (04-Okt-2001) 
  40.          - Fixed the docs ... :)
  41.      - Slightly improved error-handling
  42.      - MAJOR speed improvements :
  43.  
  44.        V0.01 - flashing 64kb with stock 1581 as drive - 9:47 mins (yieks!)
  45.        V0.02 - flashing 64kb with stock 1581 as drive - 4:51 mins (better)
  46.        V0.02 - flashing 64kb with PC-parallel receiver- 1:11 mins
  47.  
  48.        While flashing, the written bytes are also verified.
  49.        Now most of the time is spent on loading the data to flash, as
  50.        you can see. Similar speeds as my par-receiver can be
  51.        achieved using a CMD HD attached parallel to a JD-equipped C64.
  52.        See the todo-list for more.
  53.  
  54. 0.03   -  unreleased
  55.  
  56. 0.04   -  (finished 16.12.2001)
  57.  
  58.           - added SilverSurfer Flash-Support (along with the RR Utility from Groepaz)
  59.       - improved Clear FlashROM to work on AMD29f010 normal, A and B versions (B was unable to clear)
  60.       - aligned SilverSurfer receive routines to 0.4beta version of Groepaz' RR.exe utility
  61.  
  62. 0.05   -  (finished 30.04.2002)
  63.  
  64.       - added better filename routines
  65.       - added configuration menu for RR-ROMs (3.8alpha and up only!)
  66.         future FlushUtil Versions will have more options ! But the preferences design
  67.         is backward compatible
  68.       - Added ProgramFlash Editor and Creator !!!
  69.         (Read more below !)
  70.       - Updated the SilverSurfer Routines. Whenever the program is waiting for a serial
  71.         transfer it can be aborted using RUN/STOP aswell now.
  72.  
  73. Documentation
  74. -------------
  75.  
  76. Dealing with the FlashROM -
  77.  
  78. First of all: your new little AMD FlashROM toy can very hardly be destroyed, so don't
  79.           worry if your drive fails to load a file and therefore flashing fails.
  80.           Similar scenarios can quickly come to mind. :)
  81.  
  82.           --- CLOSE BOTH JUMPERS WHEN RUNNING THIS PROGRAM ! ---
  83.           --- CLOSE BOTH JUMPERS WHEN RUNNING THIS PROGRAM ! ---
  84.           --- CLOSE BOTH JUMPERS WHEN RUNNING THIS PROGRAM ! ---
  85.  
  86. I noticed that sometimes when powering on my computer with the cartridge in flashmode
  87. (both jumpers closed) my C128 shows 30719 free bytes instead of 38911 basic bytes free.
  88. RESET YOUR MACHINE if you encounter a similar READY.-Screen
  89.  
  90. Whenever something strange happens, write down any screen output which could be related to
  91. the error, SHUT DOWN THE POWER OF THE 64, turn it on again. Now reload the Flash Utility
  92. and note if any of the tests fails. Whenever you get to the menu without problems, you may
  93. clear the bank which failed to flash completely and re-try.
  94.  
  95. If you encounter bugs along the initial tests, MOVE THE JUMPERS FORTH AND BACK.
  96. This improves the connection usually. Make sure to only use pure alcohol and
  97. NO contact sprays to clean the contacts of your retro replay !
  98.  
  99.  
  100. Using the program -
  101.  
  102. When loading and running the program, a couple of tests will be executed.
  103. Old Action Replay compatibles are detected by measuring the size of the additional
  104. RAM. Since there is not much use for this utility on old cartridges, you will only
  105. be prompted to try a ROM dump to disk then.
  106. The written ROM file may be used on the Retro Replay then. If using it on the new
  107. hardware fails, please mail me a copy of the file you tried to flash.
  108.  
  109. The new Retro Replay hardware will be detected by the 32kb RAM and by reading
  110. out the manufacturer code of the FlashROM. Furthermore the setting of the
  111. FlashROM Jumper is controlled. After checking the additional RR-RAM a little closer,
  112. you will be asked to continue.
  113.  
  114. The main menu gives you a couple of choices.
  115. The most important ones are dumping the ROMs to disk, clearing the FlashROM and ofcourse
  116. programming the FlashROM contents, which should be self-explaning.
  117.  
  118.  
  119. THE PROGRAM-FLASHER !
  120.  
  121. Versions 0.05+ of the FlashUtility have a new feature, which allows you to create
  122. a bootmenu for various programs. This bootmenu can start programs which are stored inside
  123. the 64kb sized ROM. The FlashUtility allows you to create a new bootmenu or edit
  124. an existing bootmenu. When editing an existing bootmenu you are able to either add
  125. a program or delete the last program on the menu.
  126. Up to 9 programs can be added to the menu and whenever the 64kb are full, ofcourse, no more
  127. are possible aswell. Deleting the first and only program on a menu doesn't work. We want you
  128. to delete the bank completely using the F5 option from the main menu !
  129.  
  130. The programs may reside between $0334 and $ffff. You will be prompted on some start-options
  131. like the start SYS (or RUN) and $01 value. The bootmenu itself has a reserved space of $0500
  132. bytes and therefore you are able to flash up to $faff bytes into the ROM (minus $10 security buffer).
  133. We are planning on adding an option to include 4k and 8k ROMs here aswell, but this needs more testing.
  134.  
  135.  
  136. ATTENTION! Before we misunderstand: when having a ROM with the bootmenu on, you will
  137. not have the Retro Replay capabilities. If you want to run a program like TASS and have
  138. RR capabilities enabled you will have to change jumpers, reset the cartridge and SYS $9000
  139. or so again. Using e.g. the turbolinker on a program ran by the bootmenu (e.g. for Amica Paint
  140. Slideshow or so) is only possible whenever the program is resettable and restartable.
  141.  
  142. Whenever the contents of the FlashROM are changed, on pressing the exit-key, the new menu
  143. will be written.
  144.  
  145.  
  146. USING THE BOOT MENU !
  147.  
  148. While resetting or powering up a PrgFlasher-ROM you may hold RUN/STOP to go directly to basic.
  149. On a C128 you will have to hold CBM aswell to get to 64 mode. The probably coming up
  150. 'PRESS PLAY ON TAPE' can be aborted with RUN/STOP again.
  151. Avoiding this behaviour can only be reached by applying the 128-resetpatch to your RR-hardware.
  152. The patch will be available whenever we found it to be as good as possible.
  153.  
  154. The keys to use on the boot menu are 1-9, cursor up/down, return and RUN/STOP.
  155. Find out how to use them. :)
  156.  
  157. Incase there is just one program on the menu, it will be executed immediately !
  158. The bootmenu is immediately disabling the Freeze-Button aswell to avoid crashing
  159. a running program when it is pressed accidently.
  160.  
  161. The boot menu was written by WVL/Xenon. The editor was done by Count Zero.
  162. There is some space left on this menu. If you have additional ideas, let us know.
  163.  
  164.  
  165.  
  166. Flashing Techniques -
  167.  
  168. When flashing a new ROM to the chip, 8 banks of $2000 bytes each will be written.
  169. 32kb ROMs will be written twice to the chip. Once to the lower part of a 64kb bank and
  170. then again to the upper part. (This is not necessary, but eases proper detection.)
  171. Detection of the size of the currently used ROM is done by comparing upper and lower
  172. bank.
  173.  
  174. 64kb ROMs will be written in sequential order to the chip.
  175.  
  176. All ROM files you are about to write to the chip need to have the startadress ***REMOVED***.
  177. If you are planning to write old eprom dumps of yours to the flashrom, make sure
  178. to have 32768 bytes ($8000) for 32kb ROMs and 65536 bytes ($10000) for 64kb ROMs.
  179. The fileselector will try to determine the size of the files. You can only select
  180. files either having 130 or 259 blocks.
  181.  
  182.  
  183. Aborting from most prompts can be done using RUN/STOP.
  184. You should NOT abort flashing, clearing or dumping a ROM using run/stop-restore,
  185. reset or freeze !
  186.  
  187.  
  188. Utilizing the SilverSurfer
  189. --------------------------
  190.  
  191. From Version 0.04 on it is possible to use a serial cable attached to a PC
  192. to flash a new ROM to the cartridge.
  193. The command you will have to use is:
  194.  
  195. dosbox>  rr.exe flash rr-rom.bin
  196.  
  197.  
  198. For sending programs to the ProgramFlasher menu you will be prompted to
  199. use the command:
  200.  
  201. dosbox>  rr.exe load filename.prg
  202.  
  203.  
  204.  
  205. The RR-PC-Software can be found on the website! Get it ! :)
  206.  
  207.  
  208. That's it ... happy flashing ..
  209.  
  210. ----------------------------------------------------
  211.  
  212. Known Bugs:
  213.  
  214. - Sometimes the Status-Display routine crashes. Even if the Discdrive wasn't even
  215.   used and the FlashROM was filled from Serial. To be checked.
  216.  
  217. - The fileselector crashes if no disk is inserted. To be fixed.
  218.  
  219.  
  220. To Do:
  221.  
  222. - Improve file handling
  223. - Allow load/save to use the Serial-FileServer
  224. - Improve drive detection - a lot :)
  225. - Add 8k/4k ROM Support to PrgFlasher ?
  226.  
  227. - HEY ! If you ported some of your own ROM-ware or so to the RR platform,
  228.   need help, examples or want support from the FlashUtil ... TELL US !
  229.   Maybe someone would like to port over the SuperSnapshot ? Should be pretty
  230.   similar ... :)
  231.  
  232. -----------------------------------------------------
  233.  
  234. Retro Replay Compatibility Chart
  235. --------------------------------
  236.  
  237. I quickly tested the files from oldcarts.zip (check http://ar.c64.org) for
  238. compatibility with the new Retro Replay hardware. Mainly just some basic
  239. testing was done, so this is not 100% reliable. :)
  240.  
  241. The names used here are the same as on oldcarts.zip.
  242.  
  243.  
  244. ar-42pal              - working
  245. ar-50ntsc             - working
  246. ar-50triumwyrat       - working
  247. ar-60pal              - working
  248. ar-60pal_german       - working
  249. ar-6-triad            - working
  250. ar-70pal-Derko        - working
  251. ar-73pal-Atrax        - working
  252. ar-75hacked           - working
  253. AtomicPower11         - NOT working, to be patched
  254. NordicPower10_german  - NOT working, to be patched
  255.  
  256. and ofcourse
  257.  
  258. all CPX Replay Betas  - working... 
  259.  
  260.  
  261. ---------------------------------------------------------
  262.  
  263. This document belongs to the Retro Replay site - http://www.ar.c64.org
  264.  
  265. Contact me at: count0@c64.org for further details and questions
  266.  
  267. The Retro Replay can be obtained from:
  268.  
  269. Jens Schoenfeld
  270. Individual Computers
  271. Roermonder Str. 228
  272. 52072 Aachen
  273.  
  274. Phone: +49 241 12077
  275.  
  276. Fax: +49 241 12088
  277.  
  278. email: jens@schoenfeld.de
  279.  
  280. ---------------------------------------------------------
  281.