HP 100/200LX EMS Memory driver installation instructions
--------------------------------------------------------

This document contains instructions for installing
one of the 3 EMS drivers included in the 
HP Palmtop Nostalgia Pack 1/2GB CompactFlash card.
It contains instructions on how to install 
EMM100/200/240, TREMM and LXEMM.

All 3 EMS drivers do the same thing, and are configured
in a very similar way.
Note that you can only use one of these at the same time.
You might have to try several of the three to find the correct
one for your Palmtop, as different revisions of the
Palmtops with different memory chip configurations
can cause one or more of these EMM drivers to fail,
so you should try each of them and find the one
that works on your specific machine's memory chip configuration.

I recommend you try EMM100/200/240 first,
TREMM next, and LXEMM last.

To see if the installed driver works, just use
the DOS "mem" command after it's installed and see 
if it lists the correct amount of EMS memory your 
configured being available.

All these EMM drivers use "pages" to define the size of the EMS
memory they emulate via a data file on your C:\ ram-drive.
A page is 16KB large, so for example 16 pages is 256KB of EMS memory.

For a 1MB Palmtop, you will only be able to use a small amount 
due to the small C: ramdrive it has,
like 4 or 8 pages for 64KB or 128KB total EMS memory.

For a 2MB Palmtop, you should try create at least 512KB EMS 
memory (32 pages), or, if you have EMS using applications 
that require a lot of memory, you can create 1MB of EMS memory (64 pages).
You should'nt create more than 1MB as it's best to leave a little bit of 
space on your C: ramdrive available for other uses in the future.
Try to maximize your amount of EMS memory if you don't need the
space on your C: ram-drive.

If you plan to use the 4DOS shell (which is recommended, it's a modern
shell for MS-DOS that runs on the 200LX and provides many features 
of modern command line shells), and you have EMS memory available, 
it will use some of your EMS memory to load itself into it to avoid 
using a large amount of conventional memory as the 4DOS executable 
has quite a large memory footprint (~220KB).

Before trying any of the instructions in this document,
It is recommended you make a full backup copy of your C: drive,
then, do a reset of your Palmtop, and answer Y (yes) to
re-initialize the ram-drive to factory default settings,
giving you an empty, zero'ed out C: ramdrive.
This is the perfect time to create your EMS data file 
using the instructions below as it's easy to make a 
large contiguous file on an empty ram-drive,
that's just been initialized.
Afterwards creating the EMS data file, copy your 
backed up files back to your C: drive.

Now on to the installation instructions:

1. Creating the EMS data file
-----------------------------

A: Using EMM100, EMM200 or EMM240
---------------------------------
Use the MKEMS100 (for HP100LX Palmtops), 
MKEMS200 (for HP200LX 1MB/2MB Palmtops),
MKEMS240 (for HP200LX 4MB Palmtops)
command residing in E:\BIN to create the data file on C:\

C:\>E:\BIN\MKEMS200 8

This will create a file called C:\EMM200.DAT with a size
of 8x 16KB expanded memory pages, for a total of 128KB.

You can specify a lower or higher amount of pages if required,
just be aware that you will need a contiguous area of free space
on your C: drive to create the file.

B: Using TREMM
--------------

This works exactly like the EMM100/200/240 but instead,
but you create the data file with INSTEMM:

C:\>E:\BIN\INSTEMM 8

Just like MKEMS100/200/240,
this will create a file called C:\TREMM.SWP with a size
of 8x 16KB expanded memory pages, for a total of 128KB.

C: Using LXEMM
--------------

Again, this works exactly like the other 2 EMM drivers,
but you create the data file with LXEMINST:

C:\>E:\BIN\LXEMINST 8

Just like the other EMM drivers,
this will create a file called C:\???????? with a size
of 8x 16KB expanded memory pages, for a total of 128KB.


2. Test if the data file is contiguous
--------------------------------------

Once the data file is created, check if it is contiguous with
the MS-DOS CHKDSK command on the data file you just created:
C:\>CHKDSK C:\<EMM_DATA_FILE>

If the result of CHKDSK is "All specified file(s) are contiguous",
your file is contiguous and ready for use, and you can skip
to the next step.

If you get any other result such as:
"C:\EMM200.DAT Contains ? non-contiguous blocks",
Try the procedure again, and if it fails, try a smaller amount
of 16kb pages.

Also, make sure you made a backup of your C: drive,
reset your machine and reinitialized your C: ram-drive prior
to making the EMS data file, as explained above in the
introductory text before the installation steps.


3. Edit the CONFIG.SYS file to enable the correct EMS driver
------------------------------------------------------------

The EMS device drivers for the different palmtop models
reside in the C:\BIN directory.

Edit the C:\CONFIG.SYS file and locate the remarked section
for the specific EMS driver you made the data-file for,
and unremark the device driver line.
If the driver has an optional flag to specify the
number of 16KB pages to use, change the number
to the number of pages you used when creating
the EMS data file. (for example "32" for 512KB EMS memory)

The 3 different drivers are enabled with these lines in the config.sys file:

For the EMM100/200/240 drivers:
REM DEVICE=C:\BIN\EMM100.EXE C:\EMM100.DAT -F16
REM DEVICE=C:\BIN\EMM200.EXE C:\EMM200.DAT -F16
REM DEVICE=C:\BIN\EMM240.EXE C:\EMM240.DAT -F16
(Specify the amount of pages you created the data file 
with after with the -F flag)

For the TREMM driver:
DEVICE=C:\BIN\TREMM.EXE

For the LXEMM driver:
DEVICE=C:\BIN\LXJEX.SYS
DEVICE=C:\BIN\LXEMM.EXE

Now, after saving your new CONFIG.SYS file, 
reboot your system with CTRL+ALT+DEL, and if all went well,
you should be able to see your expanded memory with the DOS "mem" command.

If the driver generated an error message during loading at boot,
and/or there is no expanded memory listed in the output of the "mem" command,
or, there is expanded memory present, but there is 0KB of it available,
try again with another EMS driver of the 3 drivers available to try.
At least one of them should work on your HP 100/200LX.

----------------------------------------------------------------