REX Manager User Guide for REXsharp - Revision history

Sadolph: /* Quick Menu Features */

2023-02-09T13:05:08Z

Quick Menu Features

← Older revision		Revision as of 06:05, 9 February 2023
Line 87:		Line 87:

	Summary of commands:		Summary of commands:
	* <CNTL-O>: Switch Option ROM - REX will display available Option ROMs, and the user can use arrow keys to move the cursor to the desired selection. <ENTER> to activate the new selection and start that ROM. <ESC> to exit. The Active Option ROM is indicated with a *.		* '''<CNTL-O>''': Switch Option ROM - REX will display available Option ROMs, and the user can use arrow keys to move the cursor to the desired selection. <ENTER> to activate the new selection and start that ROM. <ESC> to exit. The Active Option ROM is indicated with a *.
	* <CNTL-B>: Back up RAM - REX# will prompt the user to confirm, and if confirmed will copy RAM to the active RAM image, performing a backup.		* '''<CNTL-B>''': Back up RAM - REX# will prompt the user to confirm, and if confirmed will copy RAM to the active RAM image, performing a backup.
	* <CNTL-R>: Restore RAM - REX# will prompt the user to confirm, and if confirmed will copy the active RAM image to RAM, performing a restore.		* '''<CNTL-R>''': Restore RAM - REX# will prompt the user to confirm, and if confirmed will copy the active RAM image to RAM, performing a restore.
	* <CNTL-A>: Activates REX Manager.		* '''<CNTL-A>''': Activates REX Manager.
	* <CNTL-X>: Hooks removal - REX# will prompt the user to confirm, and if confirmed will remove all hooks relating to REXMGR from the laptop operating system, effectively disabling REX#. REXMGR remains in the MENU, so REX# can be easily reinstalled. Also, the Active Option ROM is accessible using the usual ROM start procedures. This feature is useful when it is desired to run the Option ROM without REX# active.		* '''<CNTL-X>''': Hooks removal - REX# will prompt the user to confirm, and if confirmed will remove all hooks relating to REXMGR from the laptop operating system, effectively disabling REX#. REXMGR remains in the MENU, so REX# can be easily reinstalled. Also, the Active Option ROM is accessible using the usual ROM start procedures. This feature is useful when it is desired to run the Option ROM without REX# active.
	* <CNTL-V>: For M100/T102, this allows control over installation and use of MVT100 drivers, which enable external serial video supporting 80x24 screen. This function emulates the BASIC commands for the original Disk-Video Interface (video only, not disk).		* '''<CNTL-V>''': For M100/T102, this allows control over installation and use of MVT100 drivers, which enable external serial video supporting 80x24 screen. This function emulates the BASIC commands for the original Disk-Video Interface (video only, not disk).
	* <CNTL-N>: For M100/T102/T200, this function allows the user to edit the file name under the cursor in MENU.		* '''<CNTL-N>''': For M100/T102/T200, this function allows the user to edit the file name under the cursor in MENU.
	* <CNTL-K>: For M100/T102, this function allows the user to kill (delete) the file under the cursor in MENU.		* '''<CNTL-K>''': For M100/T102, this function allows the user to kill (delete) the file under the cursor in MENU.


	==Multi-Bank Operation==		==Multi-Bank Operation==

Sadolph: /* Introduction */

2023-02-09T13:03:58Z

Introduction

← Older revision		Revision as of 06:03, 9 February 2023
Line 2:		Line 2:

	Ok, so you've followed the Quickstart guide, and got your REX# installed, and you want to get the most out of your unit. Or maybe you are having problems, and need further guidance. This guide will cover both topics. Before you begin, however, make sure that you have properly installed REX# as per the installation instructions. If you cannot install REX# due to some unforseen issue, the second half of this guide will walk you through the steps to re-flashing your REX# chip.		Ok, so you've followed the Quickstart guide, and got your REX# installed, and you want to get the most out of your unit. Or maybe you are having problems, and need further guidance. This guide will cover both topics. Before you begin, however, make sure that you have properly installed REX# as per the installation instructions. If you cannot install REX# due to some unforseen issue, the second half of this guide will walk you through the steps to re-flashing your REX# chip.



	~~'''requires update for REX#/REXCPM Version 2.2 software'''~~

	= Using REX# =		= Using REX# =

Sadolph: /* Using OPTION ROM Images */

2023-02-09T13:03:40Z

Using OPTION ROM Images

← Older revision		Revision as of 06:03, 9 February 2023
Line 70:		Line 70:

	TS-DOS* ------		TS-DOS* ------



	Jan 01, 2023 01:01		Jan 01, 2023 01:01
	Help Save Copy Kill Name Cksm DeIn Exit		Help Save Copy Kill Name Cksm DeIn Exit

Sadolph: /* Using RAM Images */

2023-02-09T13:03:30Z

Using RAM Images

← Older revision		Revision as of 06:03, 9 February 2023
Line 55:		Line 55:

	backup WORK* ------		backup WORK* ------



	Jan 01, 2023 01:01		Jan 01, 2023 01:01
	Help Save Copy Kill Name DeIn Exit		Help Save Copy Kill Name DeIn Exit

Sadolph: /* Using REX# */

2023-02-09T13:03:16Z

Using REX#

← Older revision		Revision as of 06:03, 9 February 2023
Line 34:		Line 34:

	backup* ------		backup* ------



	Jan 01, 2023 01:01		Jan 01, 2023 01:01
	Help Save Copy Kill Name DeIn Exit		Help Save Copy Kill Name DeIn Exit

Sadolph: /* Using REX# */

2023-02-09T13:02:48Z

Using REX#

← Older revision		Revision as of 06:02, 9 February 2023
Line 36:		Line 36:



	Jan 01, 2023 01:01		Jan 01, 2023 01:01
	Help Save Copy Kill Name DeIn Exit		Help Save Copy Kill Name DeIn Exit

Sadolph: /* Using REX# */

2023-02-09T13:02:20Z

Using REX#

← Older revision		Revision as of 06:02, 9 February 2023
Line 18:		Line 18:
	[S] = Toggle sort order		[S] = Toggle sort order
	[I] = Display version information		[I] = Display version information
			[W] = Toggle write protection on RAM image (RAM images only)
	[F1] = Access built in REX help file		[F1] = Access built in REX help file
	[F2] = save Image under cursor to TPDD device or load image from TPDD		[F2] = save Image under cursor to TPDD device or load image from TPDD
Line 23:		Line 24:
	[F4] = Kill (delete) a block, freeing memory		[F4] = Kill (delete) a block, freeing memory
	[F5] = Change block name		[F5] = Change block name
			[F6] = Deactivate active option ROM image (ROM images only)
	[F7] = De-install, used to uninstall your REX		[F7] = De-install, used to uninstall your REX
	[F8] = Exit REX Manager		[F8] = Exit REX Manager
Line 29:		Line 31:
	Ok, now that you've got a cheat sheet in front of you, let's play around and see what we can do. First off, you should see (if you haven't touched anything) a screen that looks like this (block, date and time will differ):		Ok, now that you've got a cheat sheet in front of you, let's play around and see what we can do. First off, you should see (if you haven't touched anything) a screen that looks like this (block, date and time will differ):

	REX#1.0 Group<TAB>: RAM FREE 18		REX#2.2 Group<TAB>: RAM FREE 18

	backup* ------		backup* ------



	~~08/04/09~~ 01:01		Jan 01, 2023 01:01

	Help Save Copy Kill Name DeIn Exit		Help Save Copy Kill Name DeIn Exit

Line 42:		Line 44:
	Below, we get to the important stuff. You see a RAM image called 'backup'. This is the built in default RAM image, which you can refresh at anytime by SAVEing to it. Next to it is a blank block '------'. Below this are the date and time, and the standard Model 100/102 Function key menu, as detailed above.		Below, we get to the important stuff. You see a RAM image called 'backup'. This is the built in default RAM image, which you can refresh at anytime by SAVEing to it. Next to it is a blank block '------'. Below this are the date and time, and the standard Model 100/102 Function key menu, as detailed above.

	Now go ahead and hit <TAB>. The screen changes to the ROM group, as indicated up top. This should show you the active TS-DOS ROM block(indicated by the asterix), and a blank block of empty space '------'. Tabbing again will show you the OS menu, which just shows a blank block. This grouping is for special option roms that operate ~~independantly~~ from the main ROM, like CP/M for example. A ~~seperate~~ entry on the wiki will detail this at a later date.		Now go ahead and hit <TAB>. The screen changes to the ROM group, as indicated up top. This should show you the active TS-DOS ROM block(indicated by the asterix), and a blank block of empty space '------'. Tabbing again will show you the OS menu, which just shows a blank block. This grouping is for special option roms that operate independently from the main ROM, like CP/M for example. A separate entry on the wiki will detail this at a later date.

	== Using RAM Images ==		== Using RAM Images ==
Line 50:		Line 52:
	Let's try it. Cursor over to the '------' field and hit [ENTER]. REX asks you 'Create new backup (Y/N)?'. Hit 'Y' and REX will ask you 'New Name?', this being the name your new block will be listed as. Enter a six character name, and hit [ENTER] again. We'll call ours 'WORK' (see figure below) After a few seconds, REX will create a new RAM block with the current contents of your Model 100's memory, and selecting the new block as the active one, denoted by a '*'. Simple, no?		Let's try it. Cursor over to the '------' field and hit [ENTER]. REX asks you 'Create new backup (Y/N)?'. Hit 'Y' and REX will ask you 'New Name?', this being the name your new block will be listed as. Enter a six character name, and hit [ENTER] again. We'll call ours 'WORK' (see figure below) After a few seconds, REX will create a new RAM block with the current contents of your Model 100's memory, and selecting the new block as the active one, denoted by a '*'. Simple, no?

	REX#1.0 Group<TAB>: RAM FREE 18		REX#2.2 Group<TAB>: RAM FREE 18

	backup WORK* ------		backup WORK* ------



	~~08/04/09~~ 01:08		Jan 01, 2023 01:01

	Help Save Copy Kill Name DeIn Exit		Help Save Copy Kill Name DeIn Exit

Line 65:		Line 67:
	== Using OPTION ROM Images ==		== Using OPTION ROM Images ==

	REX#1.0 Group<TAB>: ROM FREE 18		REX#2.2 Group<TAB>: ROM FREE 18

	TS-DOS* ------		TS-DOS* ------


	~~08/04/09~~ 01:01
			Jan 01, 2023 01:01
	Help Save Copy Kill Name Cksm DeIn Exit		Help Save Copy Kill Name Cksm DeIn Exit

	Now hit [TAB] again, and let's delve into the real power of REX, switching Option ROM images. Let me give you an example of why this is such a big deal. I'll use myself as an example. I regularly use (as I am right now) the Ultimate ROM II for word processing and the occasional BASIC program, because I love the 60 column font option. In the past, this caused one very annoying problem: using URII occupied my ~~optionROM~~ socket, and prevented me from using a real TS-DOS ROM. I had to choose between Teeny (which is small but very basic and it must be load via serial cable from a PC) and the RAM loaded URII TS-DOS, which was buggy, unreliable, and a memory hog. Not so good. With REX, those days are over. I user URII to write my articles. When I'm done, I simply run REXMGR, and swap out URII with TS-DOS. Two seconds later (it's that fast), and I'm in TS-DOS and I save the file to my NADSBox's flash card. Then, I swap back to UR-II and keep writing, all of which is faster than loading URIIs crappy RAM based TS-DOS. Pretty useful, huh?		Now hit [TAB] again, and let's delve into the real power of REX, switching Option ROM images. Let me give you an example of why this is such a big deal. I'll use myself as an example. I regularly use (as I am right now) the Ultimate ROM II for word processing and the occasional BASIC program, because I love the 60 column font option. In the past, this caused one very annoying problem: using URII occupied my option ROM socket, and prevented me from using a real TS-DOS ROM. I had to choose between Teeny (which is small but very basic and it must be load via serial cable from a PC) and the RAM loaded URII TS-DOS, which was buggy, unreliable, and a memory hog. Not so good. With REX, those days are over. I user URII to write my articles. When I'm done, I simply run REXMGR, and swap out URII with TS-DOS. Two seconds later (it's that fast), and I'm in TS-DOS and I save the file to my NADSBox's flash card. Then, I swap back to UR-II and keep writing, all of which is faster than loading URIIs crappy RAM based TS-DOS. Pretty useful, huh?

	First off, make sure you know what the ROM menu looks like (see figure above). The Group tab needs to display ROM, and not 'RAM'. If you are in any other menu when you try to load an option ROM, it will not work. Remember, you change groups by hitting [TAB].		First off, make sure you know what the ROM menu looks like (see figure above). The Group tab needs to display ROM, and not 'RAM'. If you are in any other menu when you try to load an option ROM, it will not work. Remember, you change groups by hitting [TAB].
Line 82:		Line 84:
	What's that, you say? You don't know how? We'll, let's use it as practice. You should be in the ROM group of the REX manager program. If you are not, get there now. See the block labeled 'TS-DOS'? Select it and hit [ENTER]. REX# will ask you 'Install Option ROM (Y/N)?'. Hit [Y], and a second or two later, you will be in TS-DOS. How's that for simple? Go ahead and switch to your TPDD via [F4] (in TS-DOS) and select the directory you unzipped those option ROM files to and [F8] to exit, and re-run REXMGR. [TAB] back to the ROM group, and select the blank '------' block. See how the menu changes from SAVE to LOAD for the [F2] key? That means you are ready to go.		What's that, you say? You don't know how? We'll, let's use it as practice. You should be in the ROM group of the REX manager program. If you are not, get there now. See the block labeled 'TS-DOS'? Select it and hit [ENTER]. REX# will ask you 'Install Option ROM (Y/N)?'. Hit [Y], and a second or two later, you will be in TS-DOS. How's that for simple? Go ahead and switch to your TPDD via [F4] (in TS-DOS) and select the directory you unzipped those option ROM files to and [F8] to exit, and re-run REXMGR. [TAB] back to the ROM group, and select the blank '------' block. See how the menu changes from SAVE to LOAD for the [F2] key? That means you are ready to go.

	Hit [F2] now. REX# will ask you the name of the ~~optionROM~~ file you want to load. Let's use my favorite Ultimate ROM II, so go ahead and type 'UR2100', which is the file name for the ultimate ROM. REX will tell you to hit any key when your TPDD drive is ready, so when it is, hit [SPACE]. If you've followed the above directions, then thirty seconds or so later, you will have a new block of memory named after the Option ROM you just loaded. Switch to it by selecting it and hitting [ENTER]. Deleting blocks is identical to deleting RAM blocks, as detailed above. You can also save an option ROM to disk by selecting a used block and hitting [F2].		Hit [F2] now. REX# will ask you the name of the option ROM file you want to load. Let's use my favorite Ultimate ROM II, so go ahead and type 'UR2100', which is the file name for the ultimate ROM. REX will tell you to hit any key when your TPDD drive is ready, so when it is, hit [SPACE]. If you've followed the above directions, then thirty seconds or so later, you will have a new block of memory named after the Option ROM you just loaded. Switch to it by selecting it and hitting [ENTER]. Deleting blocks is identical to deleting RAM blocks, as detailed above. You can also save an option ROM to disk by selecting a used block and hitting [F2].

	== Quick Menu Features ==		== Quick Menu Features ==
Line 97:		Line 99:
	* <CNTL-N>: For M100/T102/T200, this function allows the user to edit the file name under the cursor in MENU.		* <CNTL-N>: For M100/T102/T200, this function allows the user to edit the file name under the cursor in MENU.
	* <CNTL-K>: For M100/T102, this function allows the user to kill (delete) the file under the cursor in MENU.		* <CNTL-K>: For M100/T102, this function allows the user to kill (delete) the file under the cursor in MENU.


	==Multi-Bank Operation==		==Multi-Bank Operation==

	Unlike Model 100 and Tandy 102, multi-bank machines PC-8201, T200 have an advantage in that the user has up to 3 distinct memory spaces to work with. Without ~~Mulit~~-bank support, all of those banks would have the same Option ROM active. Multi-bank machines now may access unique active RAM images and active OPTION ROM images on a per-bank basis. For example, TS-DOS, UR-2 and R2C can be assigned to each bank, and each bank can have an associated RAM image. This means the user can simply TAB between spaces and quickly use different Option ROMs, and each RAM space can be backed up separately.		Unlike Model 100 and Tandy 102, multi-bank machines PC-8201, T200 have an advantage in that the user has up to 3 distinct memory spaces to work with. Without Multi-bank support, all of those banks would have the same Option ROM active. Multi-bank machines now may access unique active RAM images and active OPTION ROM images on a per-bank basis. For example, TS-DOS, UR-2 and R2C can be assigned to each bank, and each bank can have an associated RAM image. This means the user can simply TAB between spaces and quickly use different Option ROMs, and each RAM space can be backed up separately.

	In REX Manager, images are marked with '*' next to the name when that image is ACTIVE in the current BANK. Images that are ACTIVE in OTHER BANKS are marked with '#'. Pressing B or b in REX Manager will indicate the BANK associated with an image, as well as the block number the image occupies in REX flash memory.		In REX Manager, images are marked with '*' next to the name when that image is ACTIVE in the current BANK. Images that are ACTIVE in OTHER BANKS are marked with '#'. Pressing B or b in REX Manager will indicate the BANK associated with an image, as well as the block number the image occupies in REX flash memory.

			==Write Protection==

			A user suggested improvement was requested to add in the ability to mark a RAM images as READ-ONLY, meaning under no circumstances is the indicated RAM image able to be modified. Great idea! There were actually scenarios where accidental or undesired updates to the active RAM image were being forced, which wasn't great.

			To mark a block for write protection, move the cursor over the desired image and press W. This will add an ! character to the end of the name, indicating the image is now protected. Press W again to clear the write protection.

Sadolph: /* Quick Menu Features */

2023-02-09T12:50:38Z

Quick Menu Features

← Older revision		Revision as of 05:50, 9 February 2023
Line 92:		Line 92:
	* <CNTL-B>: Back up RAM - REX# will prompt the user to confirm, and if confirmed will copy RAM to the active RAM image, performing a backup.		* <CNTL-B>: Back up RAM - REX# will prompt the user to confirm, and if confirmed will copy RAM to the active RAM image, performing a backup.
	* <CNTL-R>: Restore RAM - REX# will prompt the user to confirm, and if confirmed will copy the active RAM image to RAM, performing a restore.		* <CNTL-R>: Restore RAM - REX# will prompt the user to confirm, and if confirmed will copy the active RAM image to RAM, performing a restore.
			* <CNTL-A>: Activates REX Manager.
	* <CNTL-X>: Hooks removal - REX# will prompt the user to confirm, and if confirmed will remove all hooks relating to REXMGR from the laptop operating system, effectively disabling REX#. REXMGR remains in the MENU, so REX# can be easily reinstalled. Also, the Active Option ROM is accessible using the usual ROM start procedures. This feature is useful when it is desired to run the Option ROM without REX# active.		* <CNTL-X>: Hooks removal - REX# will prompt the user to confirm, and if confirmed will remove all hooks relating to REXMGR from the laptop operating system, effectively disabling REX#. REXMGR remains in the MENU, so REX# can be easily reinstalled. Also, the Active Option ROM is accessible using the usual ROM start procedures. This feature is useful when it is desired to run the Option ROM without REX# active.
			* <CNTL-V>: For M100/T102, this allows control over installation and use of MVT100 drivers, which enable external serial video supporting 80x24 screen. This function emulates the BASIC commands for the original Disk-Video Interface (video only, not disk).
			* <CNTL-N>: For M100/T102/T200, this function allows the user to edit the file name under the cursor in MENU.
			* <CNTL-K>: For M100/T102, this function allows the user to kill (delete) the file under the cursor in MENU.

	==Multi-Bank Operation==		==Multi-Bank Operation==

Sadolph: /* Introduction */

2023-02-09T12:45:57Z

Introduction

← Older revision		Revision as of 05:45, 9 February 2023
Line 2:		Line 2:

	Ok, so you've followed the Quickstart guide, and got your REX# installed, and you want to get the most out of your unit. Or maybe you are having problems, and need further guidance. This guide will cover both topics. Before you begin, however, make sure that you have properly installed REX# as per the installation instructions. If you cannot install REX# due to some unforseen issue, the second half of this guide will walk you through the steps to re-flashing your REX# chip.		Ok, so you've followed the Quickstart guide, and got your REX# installed, and you want to get the most out of your unit. Or maybe you are having problems, and need further guidance. This guide will cover both topics. Before you begin, however, make sure that you have properly installed REX# as per the installation instructions. If you cannot install REX# due to some unforseen issue, the second half of this guide will walk you through the steps to re-flashing your REX# chip.



			'''requires update for REX#/REXCPM Version 2.2 software'''

	= Using REX# =		= Using REX# =

Sadolph: /* Using REX# */

2023-02-09T12:45:44Z

Using REX#

← Older revision		Revision as of 05:45, 9 February 2023
Line 4:		Line 4:

	= Using REX# =		= Using REX# =


	~~requires update for REX#/REXCPM Version 2.2 software~~