236 lines
9.1 KiB
Text
236 lines
9.1 KiB
Text
|
||
|
||
|
||
Emu48 - A freeware HP48 Emulator for Windows 95, 98 and NT
|
||
|
||
|
||
|
||
****************
|
||
* INSTALLATION *
|
||
****************
|
||
|
||
Emu48 is now distributed in a single archive, named Emu48-1.xx.zip. This version
|
||
integrates the changed made by Christoph Giesselink in his service pack 10.
|
||
|
||
To install Emu48, just unzip Emu48-1.xx.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, 98 and NT.
|
||
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 Convert 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 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.epita.fr/~sebc/Emu48
|
||
|
||
Service packs are maintained by Christoph Gie<69>elink :
|
||
|
||
http://privat.swol.de/ChristophGiesselink/
|
||
|
||
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
|
||
|
||
Homepage:
|
||
http://www.epita.fr/~sebc
|