|
Overview:
Keyboard testing software that allows users to quickly check that all the keys on their computer keyboard are functioning correctly, check the keyboard LED's, look at the internal scan codes being generated by the keyboard and measure typing speed.
The down and up stroke of each key is registered and highlighted on a graphical image of a keyboard. Each time a key is pressed a variety of state information is updated in the window and on the keyboard picture.
Possible uses of the software include testing faulty keyboards, batch mode testing of keyboard in a production line environment, a typing tutor aid to practice your typing and examining the internal key codes.
Keyboard layouts
KeyboardTest supports custom keyboard design. It is possible to create your own keyboard layouts, including the keyboard image and key definitions. Two different portable computers and one desktop computer are provided as examples. For more information see the KeyboardTest FAQ.
Download additional layouts: Additional keyboard layouts can be download from our layout download page. You'll also find instructions on this page for sending us a new layout file so that other people can see what you have developed.
Screen shots:
Click on the image for full sized screen shot.
Feature description:
Although desktop keyboards can be quickly and cheaply replaced, this is not the case for laptop computers where the keyboard is integrated into the computer itself. The failure of even a single key on a laptop computer can render the entire machine useless. (Imagine trying to use your laptop when the space bar doesn't work).
Other Keyboard test features include:
- A comprehensive help file.
- Both the down stroke and the up stroke are highlighted in different colors.
- Measurement of the keyboard repeat and depress times.
- Display of BIOS keyboard code and Windows scan codes.
- Language independent testing by using BIOS scan codes.
- Allows creation of your own custom keyboard layouts.
- Support for up to 100 keyboards.
- Downloadable keyboard layouts (see the layout download page )
- Testing of compound keys, like a ".COM" or ".WWW" key
- Batch mode testing (with the /b command line parameter)
- Logging of keyboard serial numbers, operator ID and pass / fail results to disk (in batch mode).
- Display options for testing row and column short circuits (in batch mode).
- Display options for mouse buttons. Both for mice embedded in the keyboard and external mice.
- Support for all connector types, ( PS/2, Wireless & USB keyboards).
- A function to flash the three keyboard LED, Num Lock, Caps lock and Scroll lock.
- Measurement of the delay between key presses.
Platforms: Windows 95, 98, NT4, 2000, ME, XP
Requirements: 16MB Ram, 2MB Disk space
Download Size: 697KB (3.5min @ 33kbits/sec)
Keyboard Test FAQ
Q. My License key does not seem to work.
Both the User Name and Registration Key must be correctly entered before the software turns itself into the registered version. See this step by step guide for help.
Q. We manufacturer keyboards. How can we keep a record of each keyboard tested?
There is a new batch mode test option introduced in version 2.1 of KeyboardTest. This mode allows the logging of keyboards tested, errors, serial numbers and other important details. The /b command line parameter is used to place KeyboardTest into batch mode. Once in batch mode the program flow is as follows.
Additional details on batch mode can be found the KeyboardTest help file that comes with the software.
Q. When I press both Shift keys down, only the last released shift key is registered as coming up. Why ?
When both shift keys (Windows code 0x10 or VK_SHIFT) are depressed, Windows only passes a shift KEYUP message for the last shift key released, to applications such as KeyboardTest. KeyboardTest is hence limited to detecting only the last shift key released.
Q. Is there a limit on how many custom keyboard I can have?
It is possible to add up to 100 custom keyboards for specialized user requirements.
Q. Are there any additional keyboard layouts available for download ?
Yes, see the Keyboard layout download page
Q. Can I send you my custom keyboard layout for addition to our web site ?
If you have a keyboard that is not in the list above and have made a new layout file for it. Please send it in. We will include it on this page. Make sure you send in both the layout file (xxxx.kbl) and the image file (xxx.bmp). Mail these files to
Q. How do I add a keyboard layouts?
There are some additional keyboard layouts made by other people on the, Keyboard layout download page, but you can also make your own layout files.
Create a new keyboard layout file <mylayoutname>.kbl. This file will contain all the information about all the keys on a keyboard. See the three examples (DellPortInt.kbl, DellPortUS.kbl and AT107.kbl). Kbl files are in csv format. For more information on the structure of .kbl files see "Tell me more about keyboard layout files" below.
Create a new bitmap file <mylayoutname>.bmp. This should be a 700 pixel x 340 pixel x 256 color close up picture of your new keyboard. Again, see the three examples (files DellPortInt.bmp, DellPortUS.bmp & AT107.bmp). The name of this file should be exactly the same as the .kbl file.
Make sure both of these files are placed into the KeyboardTest, installation directory. Normally, C:\Program Files\KeyboardTest.
On startup, Keyboard Test loads the first 20 .kbl files along with their corresponding bitmaps. A .kbl file with an incorrect format, or a .kbl file without the corresponding .bmp file will be flagged as an error.
Q. Tell me more about keyboard layout files.
Kbl files are comma separated variable (csv) text files. Each line of the file corresponds to one key. There should be no unnecessary white space. There are 10 mandatory values per line which define each key. These are followed by 11 optional fields that can be specified to define a compound key. A compound key is a single key on the keyboard that generates multiple key presses. For example, a keyboard generates the keys "W","W","W",".", when the compound key "WWW.", is depressed Thirty compound keys can be defined for each keyboard layout. Each value must be one of the following.
A number value.
A single character value. The character must be surrounded by single quotes. The character is converted to its ASCII code value as the file is read.
A string value. Strings must be surrounded by double quotes.
Comments can be added by using a # as the first character in a line (see sample files).
The values in the order they must appear on each line of the .kbl file are as follows.
Windows ScanCode:
Windows scan code for this key (After language translation). This can be in 3 formats, a number, a single character, or a string value denoting a predefined constant (ref. Windows key codes reference in help). If the key being defined is a compound key, the string “COMPOUND” must be used for this field. If the key being defined is a Mouse button, the strings “LMOUSE”, “MMOUSE” and "RMOUSE" must be used for the left, middle and right mouse buttons, respectively. For example:
#Mouse
"LMOUSE",0,"LMouse","true","KTSTATUSUP",0,619,13,24,27
"MMOUSE",0,"MMouse","true","KTSTATUSUP",0,644,13,7,27
"RMOUSE",0,"RMouse","true","KTSTATUSUP",0,652,13,24,27
OEMCode:
A number value which is the OEM scan code for this key (before language translation).
Name:
A string value denoting the name of the key eg "K", "Tab"
Extended Status:
A string value. "False" if part of normal keyboard, "True" if part of extended keyboard. Eg Numeric keypad
Status:
A string value denoting the test status of the key.
"KTSTATUSNOTEST" = Don't test this key
"KTSTATUSUP" = Test this key (key starts in the up position)
"KTSTATUSFAIL" = This indicator is specific to compound keys. It is used to indicate that the defined compound key should be used for automatic testing of failures such as row and column hardware shorts. Specifically, when this status is used to define a compound key, KeyboardTest will check whether the defined keys (specified by up to 10 compound key characters) are pressed in any order (ie. A hardware short) within the compound key timer limits described below.
Note 1: This compound key will be ignored when testing for the automatic pass condition,
Note 2: This key definition differs to a compound key defined with Status equal to KTSTATUSUP, which matches the keys in the order pressed.
Note 3: This indicator will be ignored when not in batch mode (no automatic failure or pass).
Reserved:
Number value. Not used, but must be present in file and must be set to 0. Reserved for future expansion.
X, Y:
Number values. The X and Y offset of the key on the keyboard image in pixels, (Top Left corner). Note: Getting these values and the width and height values correct can take some time and trial and error.
Width, Height:
Number values. The Width and Height the key on the keyboard image in pixels.
COMPOUND KEYS - OPTIONAL PARAMETERS:
The following parameters are required to define a compound key.
If the key being defined is not a compound key, the Height value (described above) must be the last entry on the line.
If the key being defined is a compound key, the Compound key timer must be specified, followed by the characters (specified as Windows ScanCode decimal numbers). At least one character must be defined for a compound key, up to a maximum of 10. Each parameter must be separated by a ",". For example, to define "WWW.", as a compound key, the following should be included in the .kbl file:
"COMPOUND",0,"WWW.","true","KTSTATUSUP",0,26,95,20,29, 250,87,87,87,190
Where 500 is the Compound key timer (described below), 87 (Hexadecimal 57) is the Scancode for "W" and 190 the Scancode for ".".
If the key being defined is a compound key for testing for failure due to hardware shorts, the Compound key timer must be specified, followed by the characters (specified as Windows ScanCode decimal numbers). At least one character must be defined for a compound key, up to a maximum of 10. Each parameter must be separated by a ",". For example, to define a short between rows 1 and 2, select one key from each row (eg “ESC” and “`”, ie. 27 and 192) and add the following to the .kbl file:
"COMPOUND",0,"Row1-2: Short","true","KTSTATUSFAIL",0,26,118,420,29,200,27,192
Compound key timer:
Number value. The Compound key timer indicates a maximum value (in ms) between characters generated by the keyboard when a compound key is depressed. For example, the maximum time allowed between one "W" and the next "W" being received. If this timer value is exceeded, the key presses will be treated as individual key presses and not a compound key.
Compound key characters - Windows scan codes:
A comma separated list of between 1 and 10 number values. Windows scan code for each of the compound key characters (after language translation), specified as a decimal number (see above example).
NOTE:
We recommend that the best way to create a custom layout file is to make a copy of one of the three existing sample files and edit the lines as necessary.
|
