File Menu
Edit Menu
Speed Menu
Window Menu
Help Menu
- About H8
-
Displays a descriptive dialog box. Note that the emulator will continue to run normally under this window. The window is closed by pressing a key or clicking anywhere on the screen.
The following statistics are shown:
- instructions/scond
-
(instructions / milliseconds) * 1000
Instructions and milliseconds are reset to zero whenever a selection is made from the Speed menu.
- % with interrups off
-
(interrupts off instructions / instructions) * 100
Interrupts-off instructions and instructions are reset to zero whenever a selection is made from the Speed menu.
- characters to console
-
A count of all characters output to the H-19 by the H8. The maximum value is 999,999,999 which allows for over 138 hours of non-stop output at the console's maximum speed.
- characters to printer
-
A count of all data characters output to the printer by the H8. Special session control characters (open new print job, close print job, etc.) are not included in this count. The maximum value is 999,999,999.
- Reads and Writes, by drive
-
Count of all completed sector reads and writes, per drive. The maximum value is 999,999,999 each.
These stats will generally not match HDOS's own statistics, as HDOS counts read and write operations, which may be multiple-sector operations. The statistics here count all sectors read and written, individually.
The statistics are refreshed approximately every two seconds when the About window is open.
- Hide Window (command-W)
-
Hide the front emulator window. The next window down, if any, will become the active, front window. The hidden window can be redisplayed by selecting the window on the Window menu.
- Close Print Job
-
If you cancel a program that's printing to the LP: driver, and HDOS clears the file channel rather than closing the file channel, or if you reset the H8 system while an application is printing, the LP: driver won't be notified and can't cause the emulator to close the temporary spool file.
When this happens, you can use this menu item to close the print job manually.
This menu item is enabled only when there is a channel open to the LP: driver.
- Use Modem
-
Opens the Macintosh serial modem port driver and makes the modem available to the H8 on serial port 330Q. Any characters written to the port before the modem is "used" will be lost.
Once the modem opens, this menu item will change to Release Modem. When you are through using the modem, you should release it so that it is available without interference to other Mac programs.
- Open PAM Input Tape
-
Open a Mac file that holds a dumped memory image, for use with the PAM/8 Load key. Please refer to PAM/8 Operation for more information on Load/Dump.
- Open PAM Output Tape
Open a Mac file to hold a dumped memory image, for use with the PAM/8 Dump key. Please refer to PAM/8 Operation for more information on Load/Dump.
- Save H-19 buffer...
Save the content of the 500-line H-19 terminal scroll-back buffer and active screen on the Mac as an ASCII text file. Line 25 is also saved, if it is enabled. Please refer to H-19 Terminal Keyboard Map and User Guide for more information.
- Quit (command-Q)
-
Quit the emulator. You will be prompted to confirm the quit command. If you confirm, the disks will be removed from the drives, auto-saved if so configured (or you will be prompted for each if you have unchecked auto-save), and the emulator will quit.
Technically, you do not have to shut down HDOS with the "bye" command before quitting the emulator. But be aware that you may be leaving the disks in an odd state and might even corrupt individual H8 files if you do this. This is no different than switching off the power on a real H8 without first shutting down and removing the disks.
Edit Menu
None of the standard Edit menu items are suppored by the emulator at this time.
- Copy
-
If the H-19 window is front and any text is selected, this item will be enabled. Select Copy to copy the text to the clipboard.
- Paste
-
If the H-19 window is front and there is text in the clipboard, this item will be enabled. If you select Paste, the text in the clipboard will be input to the H8 as if it were being typed at the keyboard. The input rate is 200 characters per second.
Caution: Certain applications may not be able to keep up with a sustained data rate of 200 cps. We know that the Pie editor, running at a speed of less than 8mhz, cannot take more than about 80 pasted characters before it starts to lose data.
A paste in progress can be stopped by selecting Cancel Paste (see below) from the Edit menu, or typing Control-.
- Cancel Paste
-
If there is a paste in progress, it can be canceled by selecting this item, or typing Command-v, or typing Command-.
- Select All
-
If the H-19 window is front, this item will be enabled. Select All will select all the text in the scroll-back buffer from the first non-blank line through line 24 of the active screen.
See H-19 Terminal Keyboard Map and User Guide for more information on text selection.
- H-17 Preferences
-
Allows you to specify the diskette image to be inserted in each of the three disk drives when the emulator is first started. The possibilities are:
- None - There will be no disk inserted into the drive when the emulator starts. The file name area will show <no disk inserted>.
- Last Mounted - The disk, if any, that was in the drive when the emulator was last quit will be inserted when the emulator is next started. The file name area will show the currently mounted disk, which will be the disk next mounted on the drive if you quit the emulator now. If there is no disk currently mounted on the drive the file name area will show <no disk inserted>.
- Specific Disk - A specific, named disk will be inserted in the drive when the emulator starts. The disk's file name is displayed.
The preferences dialog also lets you specify which drives are to support 80-track disks. If you are using the original HDOS 2.0 SY: driver, these must be left unchecked.
If you are using the HUG SY: driver (available at the project web site), these settings must match the settings ("SET SYn: 40TRK" and "SET SYn: 80TRK") in the SY: driver on all of your bootable disks. If there is a mismatch, you will find that you are unable to read 40-track disks mounted on 80-track drives. (The emulator uses these settings to correctly mount a 40-track disk on an 80-track drive so that the SY: driver can mount and read it in "compatibility mode." See the HUG SY: driver documentation for details.)
These preferences, when changed, have no immediate effect on the drives; they take effect when the emulator is next started.
In order for the Last Mounted or Specific Disk options to work, the diskette images must be on the Macintosh startup disk. If the diskette is moved or deleted, an error dialog will appear during startup and the preference will be changed to None.
If you want to be able to insert a disk by opening it with the Finder, make sure you leave a drive empty for this purpose.
- Emulator Preferences
-
Displays the following dialog box:
This allows you to specify:
-
the cursor type to be used by default on the H-19 Terminal: underline or block. Application programs can change the cursor type with escape sequences, but when the terminal is reset, this is the cursor that is displayed. This setting takes effect the next time the H-19 is reset.
-
the PAM ROM image to be used; check the box for the PAM/GO ROM, and leave it unchecked for the original ROM. This setting takes effect, and the ROM is reloaded, the next time the H8 is reset.
-
the start-up processor speed: 2 mhz, 4 mhz, 8 mhz or Turbo. The speed can subsequently be changed on the Speed menu; this setting is only used to select the initial system speed when the emulator is started.
Note that you should not change from the default of 2 mhz unless you are using the HUG replacement disk driver (available on the project web site), as the default HDOS 2.0 disk driver will not boot correctly at speeds in excess of 2 mhz.
-
the file creator code for Mac files created by copying them to the AT: drive, and for the saved H-19 screen buffer. If you don't know the 4-character code, click on the "Like this file..." button and open any file that has the creator that you want. The file type will be 'TEXT' in both cases. This setting takes effect the next time a file is written to the Mac.
If the creator of the H-19 screen buffer is 'ttxt' (SimpleText), the emulator adds a 'STYL' resource to the dump file telling SimpleText to use 10-point Heath font to display the file. Thus the Mac file will look identical to the H-19 screen, with the exception of inverse video.
-
printer page margins. These are specified in points; there are 72 points to the inch. The default values are 36, or 1/2 inch. These values take effect the next time a file is printed.
If the values are too small to print on your printer without clipping, you will be prompted to allow the emulator to adjust the too-small values or cancel the print job (ref: error message). Clicking OK will increase only the too-small values to the minimum values acceptable to your printer.
Note that there really isn't a right margin in this release of the emulator. The right margin size is maintained and validated, but not used at this time.
As noted above, all but system speed take effect during this H8 session.
Click the "Defaults" button to reset all preferences to their default values, after confirmation. Caution: this takes effect immediately; subsequently clicking "Cancel" will not restore your previous values.
-
- 2 mhz
-
When this item is checked, the processor is paced to perform like a standard H8 system with an 8080A processor - 2.048 million instruction cycles per second. This is the default setting.
- 4 mhz
-
When this item is checked, the processor is paced to operate at 4 mhz, approximately twice the speed of a standard H8 system - 4.096 million instruction cycles per second.
- 8 mhz
-
When this item is checked, the processor is paced to operate at 8 mhz, approximately four times the speed of a standard H8 system - 8.192 million instruction cycles per second.
- Turbo
-
When this item is checked, the emulator is operating unpaced; it will run as fast as the host Macintosh will drive it.
The system clock speed can be changed at any time.
On the author's 300 mhz G3, Turbo operates about twice as fast as the 8 mhz setting. But slower Macintosh host systems may not see any difference between Turbo and a slower clock setting. See the Performance page in the Design section of the project web site for more information.
Caution: The standard Heath SY: driver has a poorly implemented "ready" function that will fail if the processor speed exceeds normal speeds. (This was fixed in the HUG enhanced SY: driver.) This comes into play when you are mounting disks or running software that uses low-level driver calls to check the ready status of a disk drive. In addition, the INIT program will appear to "hang" with interrupts disabled when operating faster than 2 mhz.
In these cases, you must run at the normal, 2 mhz speed. Other software may exhibit different failures at higher speeds; we offer no guarantees that your favorite software will operate at speeds higher than 2 mhz.
If you have odd, hard to explain problems with any particular piece of software while using one of the higher speeds, go back to 2 mhz and try again. The software may be incompatible with a very fast 8080A processor.
go to top- H8 Front Panel (command-8)
-
If the front panel GUI window is hidden or not front, make it visible and the front window.
- H-19 Terminal (command-T)
-
If the H-19 terminal window is hidden or not front, make it visible and the front window. (This is automatic the first time HDOS writes to the H-19 after the emulator is started.)
- Reset H-19 (active only when window is front)
-
Reset the H-19 terminal emulator to its power-up configuration: 25th line off, preferred cursor, hold-mode disabled, normal video, no graphics. The screen is cleared and the cursor homed. A 'transmit page' or 'transmit line 25' operation in progress is halted early by sending Carriage Return and ringing the bell.
(This menu item performs the same functions as when you send esc-z from the H8, but operation is local to the H-19 terminal.)
- H-17 Management (command-M)
-
Allows you to mount an old H-17 disk, create a new one, or remove a disk from a drive. Please refer to the figure.
In the manage window:
- click the "Insert" button to mount an existing diskette file on a drive;
- click the "New" button to create a new diskette file on the drive (remember to run init.abs!);
- click the "Reset" button to make HDOS believe that the disk has been removed then inserted back into the drive (simulates opening then closing the drive door);
- click the "Remove" button to remove a disk from the drive.
An inserted, formatted disk will have its volume number, Mac file name, and HDOS label displayed. An inserted, unformatted disk will only show the Mac file name.
If the HDOS label is one continuous string of characters without spaces, it will be displayed on one line and will be truncated if need be at the right margin of the window. Otherwise, the name will be word-wrapped into a two-line display as shown in the figure above.
Check "Write Protect" if you want the diskette to be write protected in the H8 environment. Uncheck "Auto-Save" if you want to be prompted to save a diskette image to the Mac disk after it has been changed.
If the "Write Protect" check box is checked and dim, this disk is locked and you can't remove write protection.
Select "Save in portable format?" at the bottom of the window to save each disk image as a text file. This applies only to disks removed while this feature is selected. Unselect this feature to save each disk image in a compressed format. (Ref: Emulator Features)
If you click the 'reset' button or insert a disk into a drive, hole detection will be suppressed for 300 milliseconds, long enough for HDOS to recognize that the disk has been removed from the drive, then another inserted. This enables the easy use of the 'reset' HDOS command: you can either swap disks, or click the Reset button to simulate removing and inserting the same disk.
You can hide the dialog by clicking the "close" box on the title bar or by using the Hide Window item on the File menu. However, the emulator will continue to operate normally if this window is left open.
When this item is checked, the current positions of the Front Panel, H-19 and H-17 Management windows are saved in the preferences file. When the emulator is next started, the windows will open in their saved positions.
This menu item setting is saved as well; if the emulator is quit with "remember" unchecked, it will be unchecked on the next launch, and the windows will all open in their standard positions.
If for some reason you want to forget the saved positions and reset to the standard positions, simply uncheck this menu item and restart the emulator.
go to top- H-19 Keyboard Map
-
Displays the H-19 Keyboard Map and User Guide page from this help system. This page can also be displayed by typing command-? or pressing the Help key on an Apple extended keyboard.
- H8 Emulation Help
-
Displays this help system.
go to top