Emu28 is based on the sources of Emu48 and is an emulator for the Hewlett Packard Clamshell calculators HP18C and HP28C hardware. These calculators are based on the 1LK7 Saturn CPU, the 1LP2 Centipede and 1LP4 ROM chips. The HP18C isn't tested, because I have no ROM image of it.
A big thank to Cyrille de Brebisson for his technical assistance and to Jean-Francois Garnier for his work on the HP28C. Also thanks to Sebastien Carlier for his Emu48 v1.0, without him this emulator would never have been created. And finally I want to thank all the unnamed authors for publishing material about this calculators.
You need ROM images. The ROM images are copyrighted by Hewlett Packard and I have no license to distribute them. Please don't ask me, I will not send you mine.
ROM images are valid in a packed (even address lower nibble, odd address higher nibble) or unpacked (one nibble per byte with even address first) form. They can be validated with the CHAMPCHK.EXE command line utility. To do that, start a Command Prompt while running Windows, and type:
where <image-file> is the ROM image you want to test. As result you will get a report of the ROM checksums.
To install Emu28, just unzip the emulator and the required emulator skins into an empty directory. Finally copy your ROM images into this directory and adjust the ROM image name to the name used in th corresponding KML script. When you first run Emu28, it will detect the directory in which you installed it, and will write the configuration to the registry at HKCU\Software\Emu28.
When Emu28 is installed and you have put the valid ROM image(s) into your Emu28 installation directory, you can start Emu28. You'll see a "Choose Your KML Script" box.
KML scripts in fact define the visual aspect of Emu28, the behavior of the buttons, of the keyboard, ... It's a GREAT way to customize your copy of Emu28.
Check that the path in the "Emu28 Directory" text area is correct. Modify it if the directory in which you installed Emu28 is not the directory displayed. Click the refresh button ("V") after modifying it to update the list box or use the ("...") button to start the directory browser.
Choose a KML script in the list box for your calculator ROM you put into Emu28's directory.
Available scripts from the author at the moment are:
- Christoph's Real HP28C
If you are interested in writing new scripts, get the KML 2.0 documentation from the authors Emu48 page.
Once you have selected a script, press OK to start the emulator. In most cases, when Emu28 crash after pressing the OK button, you are using an invalid ROM image. While it's running, you can use the View/Change KML Script... command to change the visual aspect of Emu28.
The command line syntax is "Emu28 [file]". The parameter sets the filename for the emulation data independent from the "LastDocument" setting. The argument is optional.
There are two ways to use the virtual keyboard on the emulated calculator:
The easiest way to use the emulated calculator is using the mouse. The KML script define buttons with an area where mouse input is active. The mouse cursor change from an arrow to a hand cursor in these areas. The state of the virtual key follow the state of your left mouse button. When the mouse cursor leaves the virtual key area the virtual button automatically release. In some cases you need to press more than one key on the emulator. For these cases press the virtual key with the right mouse button. When you release the mouse button or leave the area of the virtual key, the key is still hold. To release all hold virtual buttons, just use the left mouse botton again. A single release of a hold virtual key isn't possible.
Another convenient way is using the PC keyboard. The KML script language support a large variety of commands to implement this feature. So keyboard usage depends on your used KML script and not on the emulator. Because of this it's impossible to say what's happen when you press a key on the PC keyboard. For further details read the KML 2.0 documentation mentioned before please.
Creates a new emulation session. You're asked for a new KML script where you can select the calculator type and skin to emulate.
Opens an existing emulation session. The emulation continues at the same position where the loaded session was aborted.
Saves the current running session with the actual name.
Saves the current running session with a new name. You're also get in this dialog when you Exit a new session without a state file name.
Closes the current session without closing the emulator.
This calls the Settings dialog. This dialog has three sections: General, Disassembler and Sound.
8.6.1 General section
- Authentic Calculator Speed
When this option is checked, the emulation speed will be similar to the real calculator.
- Show Title
When this option is checked, the window title bar is visible.
- Show Menu
When this option is checked, the menu bar is enabled. If unchecked, the menu is accessible as context menu in the client area outside the calculator button definitions.
- Always On Top
When this option is checked, the emulator windows will always be the topmost one.
- Activation Follows Mouse
This option enables a X-Mouse style windows activation. When the mouse is moved over the emulator window, the emulator is getting the focus and popping up into foreground.
- Single Instance
When this option is checked, the program is only allowed to run in a single instance. If another running instance is detected, the detected instance is set into foreground as active window and get a request to change his state file to the given one by the current instance. Finally the current instance is terminated.
- Automatically Save Files
When this option is checked, the current state file will automatically saved when you change to another state file, but not when you close the emulator program.
- Automatically Save Files On Exit
When this option is checked, the current state file will be saved automatically at the end when the emulator program is closed.
- Show Load Object Warning
When this option is checked, you'll get a warning message box when you try to load an object to stack level 1 over the Load Object... menu. If this option is unchecked, the warning will be skipped.
- Always Show KML Compilation Result
When this option is checked, you see the results of the KML (Keyboard Macro Language) interpreter at every emulator startup.
8.6.2 Disassembler section
Choosing the assembler syntax:
- HP Mnemonics
This is the standard syntax used by HP.
- Class Mnemonics
Class (Clarke assembler) was written by Lutz Vieweg in 1991, at a time when HP had not published their own development tools. The syntax is very similar to the AG and STAR mnemonics used at this time.
8.6.3 Sound section
A new implementation of the sound engine made ROM patches for sound output obsolete. The new sound engine emulates the behavior of the beeper output ports and only work in connection with a sound card. Using the internal PC speaker isn't possible any more. The old beeper method with a ROM patch is still working but deprecated, it's strongly recommended to remove all beep patches from your current KML scripts to enable the new sound engine. The support of the old sound implementation by a ROM patch maybe removed in later versions of the emulator and remaining beep patches will corrupt the ROM with an illegal opcode then.
For the sound generation the calculator must know his own CPU strobe frequency. On the real calculator the speed depends on various settings like component tolerances, actual temperature, humidity and other variables. The resulting speed is measured by the calculator firmware at a cold- or at a warmstart and stored in the =CSPEED variable. The content of this calculator variable has direct influence on the resulting frequency and duration. On the emulator the CPU strobe frequency is set by the registry key HKCU\Software\Emu28\Emulator\SaturnCycles. The content of this variable multiplied with 16384 is the CPU strobe frequency in Hz used by the emulator. Because older versions of the emulator were not able to measure the CPU strobe frequency properly or the content of the SaturnCycles has been changed since the last measurement, the =CSPEED variable of this session file may contain a wrong frequency value. You easily may discover this by measuring the real duration of a 10s beep. Is the difference to 10s less than 1s everything is ok, if not, you should perform a warmstart of the calculator in this session file. Alternatively you may execute a Reset Calculator. This recalls the measuring routine and save the result in the speed variable. Both restart variants purge the stack content!
The output volume can be selected with the Volume slider relative to the Master Volume control.
By default the sound device is set to "Standard Audio", but you can also manually choose the output device. The device name is somehow cut since Window Vista, but the method of reading the device name is used for backwards compatibility to older versions of the Operating System. When you change the Standard Audio device in the Operating System settings dialog, the internal device numbering may change, and so the manually selected audio device.
8.6.4 Infrared Printer
The emulator has the ability to print data to a HP82240A/B printer simulation. The data transfer to the printer simulator is done over UDP. In this section you can the define the IPv4 address and the port the printer simulator is listening. A suitable HP82240B printer simulation can be found here.
Quit emulation. The default actions at finishing are defined in the Settings dialog. If the current session is "Untitled" you are asked for a session file name using the Save As... dialog. If you quit the emulator without a given filename, you're asked for choosing a KML script at next startup.
This is only valid for the HP28C emulation. You can load HP28C binary objects to stack level 1. Therefore the object must begin with "HPHP28-C". If the binary header isn't present, the object is loaded as string. Dropping HP objects over the emulator window will also load objects. Be sure that the emulator isn't busy before doing this.
This is only valid for the HP28C emulation. Save the current object in stack level 1 as HP28C binary object to disk.
Copy the screen content to the clipboard.
This is only valid for the HP28C emulation.
Copy a "Real Number", "Complex Number" or "String" object in stack level 1 to the clipboard. On all other objects, the command will be ignored. This prevents sending binary objects to the clipboard.
The decimal point (radix mark) of "Real Numbers" in the clipboard is equal to the calculator setting. This point maybe important when you try to paste the numbers into a program using the locale settings of the host operating system.
This is only valid for the HP28C emulation.
Paste the text field content of the clipboard to stack level 1 of the emulated calculator. If the clipboard content is representing a real number, the number will be saved as "Real Number" object. Is the content a complex number object, the number will be saved as "Complex Number" object, in all other cases as "String" object.
To import "Real or Complex Numbers" from the clipboard, the decimal point (radix mark) of the clipboard and calculator must be equal. A real or complex number is only detected in the case of valid real number characters in the clipboard. Especially heading and tailing white spaces aren't valid number characters also.
Complex numbers must be in the form (a,b) when using the point radix mark or in the form (a;b) when using the comma radix mark. The Cartesian or algebraic form a+bi is not supported.
This emulates the Reset pin of the internal CPU.
This saves the current emulator status into a backup slot. If the backup slot already contain data, it will be overwritten.
This restores a previous saved emulator status without request. If you changed the calculator model meanwhile, the emulator will switch back to the old model.
This deletes the data in the backup slot.
This allows you to change the skin of the current emulated calculator. In opposite to the New... command you see only scripts emulating the same calculator.
This is a simple disassembler.
Enter the address to disassemble in hexadecimal into the "Address (HEX)" field and press <Return>. With the "Next Address" button the next opcode is disassembled. With the "Copy Data" button you can copy all selected lines inside the list box to the clipboard.
The assembler code debugger of the emulator. For more details refer to the extra documentation of the debugger please.
The keyboard macro recorder unit.
Prompts a dialog to enter the macro file for the data to record. After accepting the confirm message, every key event is recorded into the macro file with it's time information.
Prompts a dialog box to ask for the keyboard macro file to play. The replay starts immediately after selecting the file.
Stops recording or replaying a keyboard macro file.
Settings for the Macro Replay mode
Replay macro with the original recording speed.
Replay macro with the speed set by the speed slider.
Call this document.
The version, copyright and license message...
Emu28 has an integrated DDE server to transmit data from and to the HP stack. Because only the HP28C has a stack, all DDE transfers are ignored on the other calculators. You have the same restrictions like with the commands "Load object..." and "Save Object...", that a running program may corrupt memory. In difference you can choose the stack level for the transfer in the DDE item field. Take care to transmit data only after the acknowledge of the last DDE transaction.
|Item:||1 (stack level)|
|Clipboardformat:||"CF_HPOBJ" (user defined)|
The DDE commands CONNECT, POKE and REQUEST are supported.
The structure of the clipboard format "CF_HPOBJ":
|4 Byte (length of object, LSB first)||HP object (normal HP object)|
Emu28 - A HP18C/28C Emulator
Copyright (C) 2017 Christoph Gießelink
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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.