237 lines
9.2 KiB
Text
237 lines
9.2 KiB
Text
|
|
|
|
|
|
Emu48 - A freeware HP48 Emulator for Windows 95 and NT
|
|
|
|
|
|
|
|
****************
|
|
* INSTALLATION *
|
|
****************
|
|
|
|
Emu48 is distributed in 3 separate archives :
|
|
- Emu48-1.x-bin.zip All the executables files (REQUIRED)
|
|
- Emu48-1.x-src.zip The sources of Emu48 and some useful tools (OPTIONAL)
|
|
- Emu48-com.zip Files common to all 1.x versions (REQUIRES)
|
|
|
|
To install Emu48, just unzip Emu48-1.x-bin.zip and Emu48-com.zip into an empty
|
|
directory. When you first run Emu48, it will detect the directory in which you
|
|
installed it, and will write its configuration to a file named Emu48.ini in
|
|
your Windows directory.
|
|
|
|
Note:
|
|
As of version 1.0, Emu48 will only run with Windows 95 and NT.
|
|
I am working on a port to Unix (XWindow). When this is finished,
|
|
I may port it to Windows 3.1 and OS/2.
|
|
Since the source code is provided, you can add features or port it to new
|
|
plateforms, but you are required to send me your changes.
|
|
|
|
|
|
|
|
************************
|
|
* YOU NEED A ROM IMAGE *
|
|
************************
|
|
|
|
Emu48 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.
|
|
|
|
- If you have already used another HP48 emulator, you can convert the ROM with
|
|
you were using with the Conver utility.
|
|
To do that, start a Command Promt while running Windows, and type :
|
|
Convert <old-file> ROM.48G
|
|
or Convert <old-file> ROM.48S
|
|
Where <old-file> is the path to your old ROM image. This will create a file
|
|
named ROM.48G or ROM.48S, depending on the version you own.
|
|
This tool should be able to read any style of ROM image, and will also check
|
|
its validity. 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.
|
|
|
|
- If you have never used an HP48 emulator, and don't have a ROM dump, you can
|
|
either use the old ROMDump utility and then Convert your dump, or you can
|
|
use my ROMDump Wizard, which will almost automatically get the ROM from your
|
|
HP48. However, this Wizard was written without a documentation on the
|
|
transfer protocol used by the HP48 (Kermit), so I cannot guarantee that it
|
|
will work. It worked on my computer, maybe it will work on yours. Try it !
|
|
|
|
WARNING: If you use ROMDump or the ROMDump Wizard, DO NOT INTERRUPT THE
|
|
PROCESS ! Your HP48 would lock, and the only way to reset it is
|
|
through the Reset hole.
|
|
|
|
IMPORTANT: To save a lot of space, two DLLs needed by the Romdump Wizard
|
|
have not been included in the Romdump Wizard's distribution.
|
|
They are called MSVCRT40.DLL and MFC40.DLL, and are available
|
|
on the Web at the Emu48 Official Homepage :
|
|
http://www.geocities.com/CapeCanaveral/5948/index.html
|
|
These two files are freely distributable, and would be included
|
|
in this archive if they weren't so large (about 1.4Mb for both)
|
|
Note that they are NOT needed by Emu48 : only the Romdump Wizard
|
|
requires them.
|
|
|
|
* Once you have your ROM dump(s), SAVE THEM TO A FLOPPY DISK !
|
|
It will save you a lot of troubles if you were to lose them.
|
|
|
|
|
|
|
|
****************
|
|
* HOW TO START *
|
|
****************
|
|
|
|
When Emu48 is installed and you have put the ROM image(s) in its directory, you
|
|
can start Emu48. You'll see a "Choose Your KML Script" box.
|
|
|
|
KML Scripts in fact define the visual aspect of Emu48, the behaviour of the
|
|
buttons, of the keyboard... It is a GREAT way to customize your copy of Emu48.
|
|
|
|
Check that the path in the "Emu48 Directory" text area is correct. Modify it if
|
|
the directory in which you installed Emu48 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. If you have put a G/GX ROM dump in Emu48's
|
|
directory, choose a script for G/GX. If you have put a S/SX ROM dump in Emu48's
|
|
directory, choose a script for S/SX.
|
|
Several scripts are included in the common archive :
|
|
* Emu48's Default Faceplate for HP48G/GX
|
|
* Emu48's Default Faceplate for HP48S/SX
|
|
These two are simple scripts, and they use the bitmap from Win48 2.05.
|
|
* Casey's Gx with Toolbar and Touch Screen
|
|
* Casey's Sx with Toolbar and Touch Screen
|
|
These script uses many advanced features, and is a good demonstration of
|
|
the power of Emu48's scripting language, KML. Try it, it is really great !
|
|
* Floating buttons
|
|
This one looks really great.
|
|
* Small but realistic HP48 Gx
|
|
This one has been designed for small resolutions such as 640x480.
|
|
Note: some things in this script have to be be fixed.
|
|
|
|
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.
|
|
|
|
|
|
|
|
*******************
|
|
* SHARED RAM CARD *
|
|
*******************
|
|
|
|
You can add a SHARED (I'll explain later) ram card of up to 4Mb. By default, no such
|
|
card will be created when you start Emu48. The MkShared.exe utility, included in the
|
|
registered version, will allow you to create it.
|
|
The syntax is :
|
|
MkShared <filename> <size_in_kilobytes>
|
|
For example, you can create a 4Mb RAM card name SHARED.BIN (in Emu48's directory) with
|
|
the following command :
|
|
MkShared SHARED.BIN 4096
|
|
Valid sizes are 128, 256, 512, 1024, 2048 and 4096 kb.
|
|
|
|
When you have created this file, run Emu48, and use the Close menu item to close the
|
|
calculator state. Now select View/Settings. In the "Port 2" text area, type the name
|
|
of the file you created (if you don't include a path, it will be searched for in Emu48's
|
|
directory).
|
|
|
|
You can also tick the check box "Port 2 Is Shared".
|
|
When the box is cleared, only the first instance of Emu48 will allow you to use the RAM
|
|
card in Port 2.
|
|
When this box is ticked, the first instance of Emu48 will give you both read and write
|
|
access to this RAM card. If then you start Emu48 again, the RAM card in Port 2 will be
|
|
write-protected. You can thus transfer files very easily between two calculators. This
|
|
RAM card is used by both S/SX and G/GX types.
|
|
|
|
Note that you have to close Emu48 and restart it if you modify these settings.
|
|
|
|
|
|
|
|
********************
|
|
* SPECIAL FEATURES *
|
|
********************
|
|
|
|
Emu48 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.
|
|
It is also used by Emu48 when you want to save or load a new document, to restore its
|
|
old state if you cancel the operation or of something goes wrong.
|
|
|
|
|
|
|
|
********************
|
|
* 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 Emu48."
|
|
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 Emu48,
|
|
but you are trying to load the same file in both instances, which causes
|
|
a sharing violation.
|
|
|
|
|
|
|
|
***********
|
|
* SUPPORT *
|
|
***********
|
|
|
|
I cannot provide individual support for Emu48, but I will read all the mails
|
|
that you send.
|
|
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 *
|
|
***************
|
|
|
|
Emu48 - An HP48 Emulator
|
|
Copyright (C) 1997 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
|