


	Emu38 v1.01 - A freeware HP38 Emulator for Windows 95 and NT


        ****************
        * PRESENTATION *
        ****************


Emu38 is based on Emu48 by Sebastien Carlier.
Some modifications have been made by Jean-Yves Avenard in order
to emulate the HP38G. It can still emulate the HP48S and HP48G(+) (not SX or GX)
Since the changes are quite insignificant compared to the great job that
Sebastien has done, Emu38 is still under his Copyright.
For any information or comment about this program, you can write to J-Y Avenard
at: avenar_j@epita.fr , http://www.epita.fr/~avenar_j

For more informations about Emu48's author, please check at the bottom of this file.


	****************
	* INSTALLATION *
	****************


To install Emu38, just unzip Emu38.zip into an empty directory.
When you first run Emu38, it will detect the directory in which you
installed it, and will write its configuration to a file named Emu38.ini in
your Windows directory.

Note:
	As of version 1.0, Emu48 will only run with Windows 95 and NT.

	************************
	* YOU NEED A ROM IMAGE *
	************************

Emu38 needs an image of the ROM of YOUR calculator to be able to run.
Since the ROM is copyrighted by HP, I won't give you mine, and you should not
give yours or make it freely available.
To use the ROM software of a calculator, you must be the owner of this
calculator.

- To upload the ROM of your HP38G, you will need a special aplet called
  "ROM UPLOAD", available at http://www.epita.fr/~avenar_j/hp
  Once you've uploaded the ROM, you have to convert it using the Convert
  utility.
  To do that, start a Command Prompt while running Windows, and type :
	Convert <rom-file> ROM.38G
  Where <rom-file> is the path to your ROM image. This will create a file
  named ROM.38G.
  This tool will also check its validity.
  For the A version (the only one available) the CRCs are:
  CRC0: 04C9
  CRC1: 300B
  Note than if you run it with only one parameter, no file will
  be written, but it will still check the validity of the ROM.
 
* Once you have your ROM dump(s), SAVE THEM TO A FLOPPY DISK !
  It will save you a lot of time if you were to lose them, but remember
  DO NOT DISTRIBUTE THEM !



	****************
	* HOW TO START *
	****************

When Emu38 is installed and you have put the ROM image(s) in its directory, you
can start Emu38. You'll see a "Choose Your KML Script" box.

KML Scripts in fact define the visual aspect of Emu38, the behaviour of the
buttons, of the keyboard... It is a GREAT way to customize your copy of Emu38.

Check that the path in the "Emu38 Directory" text area is correct. Modify it if
the directory in which you installed Emu38 is not the directory displayed.
Click the refresh button ("V") after modifying it to update the list box.

Choose a KML script in the list box. Actually, only one is provided with this
archive. It's ugly, then if anybody wants to send me a new one, please do it!:

    If you want other great scripts, visit Casey's Emu48 homepage :
	http://www.gulftel.com/~pattersc/emu48/

    And if you are interested in writting new scripts, you'll want the KML 2.0
    documentation, available on Casey's page and on my page :
	http://www.geocities.com/CapeCanaveral/5948/kmlind.htm

Once you have selected a script, press Ok to start the emulator. While it is
running, you can use the View/Change Kml Script to change the visual aspect
of Emu48.



	********************
	* SPECIAL FEATURES *
	********************

Emu38 includes a backup feature (in the View menu). It save the complete state of the
calculator in the computer's memory. You might want to use it before doing something
risky, and if you don't want to save to the disk. It provides some kind of Undo feature.



	********************
	* TROUBLE SHOOTING *
	********************

Q: The emulator display the keyboard, but the screen stays blank or is filled
   with garbage.
A: Your ROM image is probably wrong. Check it with the Convert utility, and if
   it says that the CRC is wrong, you should try to download your ROM again.

Q: What does this message mean :
	"This file is missing or already loaded in another instance of Emu38."
A: Maybe you deleted or moved the files that the emulator tries to load when
   starting (the last files you saved).
   The other possibility is that you are running several instances of Emu38,
   but you are trying to load the same file in both instances, which causes
   a sharing violation.



	***********
	* SUPPORT *
	***********

Sebastien Carlier won't provide any support to this program, but you can send him some
emails.

All informations about Emu48 will be on the Emu48 Official Homepage on the Web :

	http://www.geocities.com/CapeCanaveral/5948/index.html

Other graphics and scripts are available at Casey's Emu48 Graphics Page :
	http://www.gulftel.com/~pattersc/emu48/



	***************
	* LEGAL STUFF *
	***************

    Emu38 - An HP38 Emulator
    Copyright (C) 1997-1998 Sebastien Carlier

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.



	**************
	* The Author *
	**************

Paper Mail:
	Sebastien Carlier
	10 Allee des bergeronnettes
	35340 LIFFRE
	FRANCE

E-Mail:
	sebc@epita.fr
	sebc@anet.fr

Homepage:
	http://www.geocities.com/CapeCanaveral/5948/index.html
