REXCPM Version 2 Upgrade instructions: Difference between revisions

From Bitchin100 DocGarden
Jump to navigationJump to search
Line 73: Line 73:
Use RXCINI.DO to load the Version 2 RXCMGR application into REXCPM.
Use RXCINI.DO to load the Version 2 RXCMGR application into REXCPM.


Only indicate yes to "Load REX code:".
  Only indicate yes to "Load REX code:".
 
  Indicate no to "Init REX dir :".  You have a valid directory!
Indicate no to "Init REX dir :".  You have a valid directory!


<big>'''The instructions to upgrade your REXCPM software are back on the main page'''</big>
<big>'''The instructions to upgrade your REXCPM software are back on the main page'''</big>

Revision as of 07:08, 10 January 2021

Upgrading your REXCPM from Version 1 to Version 2

If you are here, you are looking for instructions on how to upgrade your REXCPM from Version 1 to Version 2.

The process to do this upgrade is only slightly different from simply the normal upgrade process.

The reason for the change, is that the internal image directory for REXCPM has been moved to a new location in the SRAM chip. While a little annoying to need an extra step, the change aligns REX# and REXCPM so they can use the same subroutines, which is helpful for product support.

Thanks for your understanding.


Special Upgrade Process

The upgrade process consists of two steps.

Step 1: Run the utility one-time to copy your directory contents to the new location.

Step 2: Use RXCINI.DO to upgrade the new RXCMGR application.


Step 1 - Copy the Directory

As mentioned, the first step is to run a utility that copies the current directory to the new location. The utility is DIRCPY.DO

What is important here, is that the directory needs to be accurate when copied, and after you copy it, don't use RXCMGR to alter the Image directory. You want to immediately complete the upgrade so that Version 2 starts up with the correct directory.

Running DIRCPY.DO does not impair RXCMGR version 1 in any way. So, if you run the utility and decide not to do the upgrade, no problem.

You can also revert to version one if you wish.

The key thing is - the directory contents need to be accurate for either Version 1 or Version 2 of RXCMGR to work correctly.

  Notes:
  ======
  * DIRCPY.DO replicates the directory, and leaves the current one intact.
  * So, RXCMGR (version 1) can continue to be used even after you run DIRCPY.DO


When you are ready to do the upgrade to Version 2, then start by running DIRCPY.DO. Here is the utility.

Here's the software:

Utility Version File
DIRCPY 1 DIRCPY.DO


  Step 1 Instructions
  ===================
  1.  Make sure REXCPM is in default state, meaning
      a. RXCMGR is not running (use CNTL-X to remove hooks, or F7 from RXCMGR)
      b. Power cycle once, to ensure the default memory blocks are selected
      c. Optionally, cold-rebooting the laptop after a power cycle ensures a clean state. 
  2.  Load DIRCPY.DO via serial transfer, or TPDD transfer.  It is now 7 bit ASCII.
      DIRCPY.DO contains HEX ASCII encoded machine language, for more reliable transfer.   
  3.  RUN DIRCPY.DO in BASIC.
      DIRCPY.DO will make a copy of the current image directory at the new location.
  4.  Let the program run
      When complete, your directory will have been prepared for Version 2.


Again, DIRCPY is non destructive and at this point you can continue to use REXCPM if you wish. If you alter the directory however, you will need to run DIRCPY.DO again when you want to upgrade to Version 2.


Step 2 - Upgrade the software

Use RXCINI.DO to load the Version 2 RXCMGR application into REXCPM.

  Only indicate yes to "Load REX code:".
  Indicate no to "Init REX dir :".  You have a valid directory!

The instructions to upgrade your REXCPM software are back on the main page