QTERM-IV/P40 User's Manual
19
Beijer Electronics Fax 801-466-8792 Web www.beijerelectronicsinc.com Phone 801-466-8770
ASCII Editor. You may use any editor to modify the
QDATA configuration file, but the output from the editor
must be in ASCII format, without any embedded codes.
Included on your QTERM distribution disk is the TED3
editor (TED3.COM), which you can use to edit the
QDATA file. The file TED3.DOC provided documentation
for the editor and its commands.
Uppercase/Lowercase. For quoted text strings, (used for
key strings), the string is assigned exactly as shown in the
QDATA file.
Comments. Comments may be added to the file as desired.
A comment starts with a semicolon, and ends at the end of a
line (at the carriage return).
Whitespace. Whitespace may be added to the file as
desired. This means you can add spaces, tabs, carriage
returns and line feeds anywhere you would like. The only
exceptions are identifiers (such as [shift mode]) with
whitespace and in quoted text strings (which are assigned to
keys); anything within the quotes will be assigned to the
key.
Since you can add and remove carriage returns, you can
place each identifier on a separate line, or you can have
several identifiers on one line, as long as the order in which
they appear is not changed.
3.4
Parameter and Key String Sections
The QDATA file has two sections: the parameter section at
the top, followed by the key string section at the bottom.
3.4.1
Parameter Section
In the parameter section, you will assign a number to each
identifier.
Numbers. The number can be specified in one of two
ways:
•
decimal numbers (49, 27)
•
hexadecimal numbers (x0D, x8C)
These numbers are always positive integer numbers within
the range specified by the comments. Hexadecimal con-
stants start with the letter “x”. Decimal and hexadecimal
constants are equivalent; use whichever one is easier at any
time.
3.4.2
Key String Section
This section follows the parameter section. The format for
the identifiers for each key is
<k#*>
- unshifted key strings
<sk#*>
- shifted key strings
<kr#*>
- unshifted key release strings
<skr#*> - shifted key release strings
where:
# = row (top = row 0)
* = column (right = column 0)
Examples of this notation:
<k21>
is for unshifted key string for row 2 and col-
umn 1
<skr32>
is for shifted key release string for row 3 and
column 2.
Since the QTERM electronics can support up to eight rows
and six columns of keys, there are identifiers for 48
unshifted and 48 shifted key strings, as well as identifiers
for 48 unshifted and 48 shifted key release strings. All of
these must remain in the file; however, you will have no
reason to assign key strings to keys that do not exist on
your keypad.
In the key string section the type of values you can assign to
a key are
•
strings enclosed in single quotes ('abcde')
•
decimal numbers (49, 27)
•
hexadecimal numbers (x0D, x8C)
•
Special Function Switches (\L, \P, \S)
•
a combination of the above, separated by commas
Strings. Text strings can contain any printable ASCII char-
acters and are enclosed in single quotes. If you need to
include a single quote in your text string, terminate the
string and specify the ASCII value as a number (x27 hexa-
decimal or 39 decimal).
Numbers. Numbers are always positive integer numbers
within the range 0 to 255. Hexadecimal numbers start with
the letter “x”. Decimal and hexadecimal numbers are
equivalent; use whichever one is easier at any time.
Special Function Switches. These special switches are
used for advanced functions such as Local Mode toggle,