Contents of the KEYSCOPE.DOC file
The KEYSCOPE program was written as a keyboard learning and
diagnostic tool. It was developed as an internal tool by
Pierpoint Software for studying the scan codes generated by the
keyboard and the internal processing by interrupts 9h and 16h.
It is placed into the public domain by Pierpoint Software.
Each key on your keyboard generates two scan codes (one when you
press the key and one when you release it), and on some key-
boards, a few keys generate more than two scan codes. Keyboards
with separate cursor pads generate somewhat different scan codes
depending on the manufacturer. By using KEYSCOPE, you can learn
what these scan codes are.
By using the KEYSCOPE program, you can learn:
1. The scan codes generated by each key on your keyboard.
2. The key codes generated by interrupt 16h.
3. The order in which interrupts 9h and 16h occur.
4. The state of the keyboard status byte when each
5. Whether your BIOS supports the enhanced 101-key
KEYSCOPE will run only if:
1. You are using MS-DOS or PC-DOS version 2.0 or greater.
2. You are in video modes 2, 3, or 7. These are the 80
column text video modes. If you don't know what this
means, look up the MODE command in your DOS manual.
3. If these two conditions are not met, KEYSCOPE will issue
an error message and quit.
HOW TO USE KEYSCOPE
In the upper right hand corner of the KEYSCOPE display screen,
you will see either "bios" or "XBIOS." The lowercase word "bios"
indicates that your bios does not support the enhanced 101-key
keyboard. The uppercase word "XBIOS" indicates that your
computer has an extended bios that supports the enhanced 101-key
In the upper left hand corner of the screen are the column
headings for the information presented each time you press a key:
scan code, key code, interrupt, and status. Scan and key codes
are decimal numbers, interrupts are hexadecimal numbers (a small
h is appended to them), and the keyboard status byte is decoded
into the following symbols:
Symbol Active Keys
LS Left Shift Key
RS Right Shift Key
Alt Alternate Key
Ctrl Control Key
Caps Caps Lock Key
Num Num Lock Key
Scrl Scroll Lock Key
Ins Insert Mode
The interrupts are displayed with the latest interrupt closest to
top of the screen. If you pause a second between keystrokes, a
blank line will be inserted between the interrupt packets. This
makes the display easier to read.
Press the ESC key when you are ready to exit the program.
Technically, the program looks for scan code 129, which is the
release scan code for the ESC key on almost all keyboards. If
not, you may have to hunt around to find it.
Part of the program is ram-resident. The ram-resident code is
released on normal exit. Should you happen to exit some other
way, you should reboot your computer.
You may get different responses depending on which ram-resident
programs you have in memory when you run KEYSCOPE.
Version 1.0: Original release.
Version 1.1: Increased efficiency of functions that read and
write data to the internal buffer. This should eliminate the
occasional "illegal data in buffer" error message.
In no event will Pierpoint Software be liable for any loss or
damage, including loss of profits or savings, or any other
special, incidental, or consequential damages, either direct or
indirect, arising out of the use of, or inability to use, this
software, even if Pierpoint Software has been advised of the
possibility of such damages.
Please address all suggestions and problems to the address
below. Please include SASE if a reply is desired. Because of
limited staff time, lengthy replies cannot be provided.
P.O. Box 2198
Camarillo, CA 93011-2198