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 ROM.48G or Convert ROM.48S Where 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 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