How to make a backup of your HP48 to use it in Emu48
----------------------------------------------------

This file is a short description how to copy the data of a real HP48 to Emu48.
Sorry, data and libraries which are saved in Port0 aren't covered by this
instruction. This file do not replace the manuals of the used programs, this
text gives only some useful (hope so) hints.

Used tools:
- CARDUPL
- ROM2EMU.EXE
- CARDCOPY.EXE
- MKE48.EXE
- Kermit server / PC Connectivity Kit
- XModem receiver / HyperTerminal

1) Save the User area

This step save the HOME directory with merged RAM cards to the PC.

- [HP48] go into HOME directory with: /-> HOME
- [HP48] save your current flag settings: RCLF 'FLAGS' STO
- [HP48] check your IO settings: wire / 9600 baud
- [HP48] dump User area: :IO:BACKUP ARCHIVE
- [PC] start a KERMIT server

You can also use the "PC Connectivity Kit" to make a backup.

For further information how to make a backup read the HP48 users manual please.

2) Save independent Card/Port memory

This step save all data of independent RAM/ROM cards to the PC. For doing this
you need the HP48 program CARDUPL. Please download CARDUPL to your HP48. Refer
to the file CARDUPL.TXT how to use this program.

2.1) Save Card1 data (only independent RAM/ROM)

- [HP48] call upload program: #1 CARDUPL
- [PC] save data in file i.e. CARD1.ROM
- [PC] convert data into emulator format with ROM2EMU.EXE CARD1.ROM CARD1.BIN

2.2) Save Card1 data (only independent RAM/ROM)

- [HP48] call upload program: #2 CARDUPL
- [PC] save data in file i.e. CARD2.ROM
- [PC] convert data into emulator format with ROM2EMU.EXE CARD2.ROM MYHP2.BIN

3) Create Emu48 state file

This step prepares Emu48 for use. For further information read the Emu48.txt
file please.

- [PC] start Emu48
- [Emu48] call File/New... and select the KML script belonging to your
  calculator
- [Emu48] answer TTRM message with NO
- [Emu48] merge the ports (if so) like on your original calculator
- [Emu48] call Edit/Load Object... and load your BACKUP archive
- [Emu48] you should have an object like "Backup HOMEDIR" on your stack, if you
  got "Free memory error" you mostly forgot to merge a RAM card
- [Emu48] call RESTORE to restore the HP data
- [Emu48] call FLAGS STOF to restore your flag settings
- [Emu48] save the Emu48 state file with File/Save As... i.e. under the name
  MYHP.E48

4) Transfer of Port0 data to Emu48

Sorry there's no direct way. You have to copy all Port0 data manually from the
calculator to Emu48 or perhaps you find a program that is doing this for you.

5) Add independent Card1 data to the Emu48 state file

Very important! Only add the content of an independent RAM/ROM card to Emu48 if
you don't merged the Port1 memory. The Card1 data must be in the emulator
format, so don't forget to use the ROM2EMU.EXE tool after the CARDUPL process.
To copy the data into the Emu48 state file you need the tool CARDCOPY.EXE. For
our example we do:

CARDCOPY.EXE CARD1.BIN MYHP.E48

For further information read the CARDCOPY.TXT file please.

6) Add independent Card2 data to the Emu48 state file

The easiest way to use always your own Port2 copy is creating a Emu48 link with:

Emu48.exe MYHP.E48 MYHP2.BIN

as command line to call Emu48 always loading the current files. For further
information how to use "shared" port2 files read the Emu48.txt file please.

7) Exceptions

You may get the error message "Non matching file size of format" in step 4)
using the CARCOPY.EXE tool. This happens when you try to add an independent 32KB
RAM/ROM card to a Emu48 state file which reserves normally 128KB for a port1
card. Because Emu48 cannot create state files with 32KB port1 size by itself,
you have to use the MKE48.EXE tool to create such a state file manually. A Emu48
state file with 32KB Port1 memory file can be created with:

HP48SX:
    MKE48.EXE S 32 32

HP48GX:
    MKE48.EXE G 128 32


Most tools which are mentioned here can be found on
http://privat.swol.de/ChristophGiesselink/emu48.htm.

01/21/02 (c) by Christoph Gießelink, cgiess@swol.de