PREH TouchKey
Description
Version 1.1.0.2
This
File describes the usage of the PREH MCI TouchKey. It shows the parameters of the
XML Files. These parameters are necessary in order for the TouchKey
and PC to work together.
File TouchKey.xml
<Device>
Start of
TouchKey.xml. Always necessary.
<Serialnumber>
This
field includes the serial number of the TouchKey. The serial number
is situated at
the back of the TouchKey on the label.
<Contrast>
The
TouchKey is set to the value in the contrast field at the start of the
server. The value ranges from 0 to 255.
<Backlight>
The
TouchKey is set to the value in the backlight field at the start of the server. The value
ranges from 0 to 255.
<NumberOfLayers>
Number
of layout files displayed on the TouchKey. For each layout you need
to create its own layout file.
<NumberOfGraphics>
Number
of graphics displayed on the TouchKey. One or more graphics can be
displayed in a layer, a text field or as an own layer.
<NumberOfText>
Number
of text fields displayed on the TouchKey. One or more text fields can be
displayed in a layer, a graphic or as stand alone.
<Layer>
The
layer name. This name must be the same name as the according layer file. E. g.
layer name is "main" the according XML-File is "main.xml". More than one name
can be defined.
<graphic>
The
graphic name. This name must be the same name as the according graphic file.
Description see <Layer>.
<txt>
The
text name. This name must be the same name as the according text name.
Description see <Layer>.
File <Layername>.xml
<Layer>
The
xlmns attribute contains the name of the XML schema. This schema validates the
<Layername>.xml file. If an incorrect <Layername>.xml file was loaded
the server stops with an error.
<name>
The
name of the layer.
<index>
The
index of the layer. The first layer in the list described in TouchKey.xml has
the index 0.
<keytostart>
The
POS-Key which starts this layer. A POS Key can be programmed with the
WIN-Programmer on a key of the keyboard side (right side of the TouchKey
device).
<buttondata>
Button
data describes all parameters of one key of the TouchKey.
<beep>
Creates
a key click for the key.
Frequency of key click. Range from 0 to 255. There are 4
frequency ranges.
Range 0 to 15, frequency of 4800 Hz
Range 16 to 31, frequncy of 2400 Hz
Range 32 to 63, frequency of 1200 Hz
Above 64, frequency 600 Hz
<beepduration>
Duration of key click. Ranges from 0 to 255.
Value * 8,3 ms = Duration of key click
<inverse>
Shows
the inverses the key color if pressed. Normal state when key is released.
<keyboard
output>
The
TouchKey sends the key code as keyboard output.
<xpixel>
Set
the x coordinate of the button. Maximum x value is (320 pixel).
<ypixel>
Set
the y coordinate of the button. Maximum y display value is (240 pixel).
<wpixel>
Set
the width of the button. Maximum w value is (320 pixel).
<hpixel>
Set
the height of the button. Maximum value is (240 pixel).
Set the text
of the button. Special characters must be defined as code sequence (e. g. new
line ).
<textmode>
Set the text mode of the button. The following description defines the HEX
value for text mode. The value is in the range 0 to 255.
Bit 0 |
Center text horizontally |
Bit 1 |
Center text vertically |
Bit 2 |
Right justify text |
Bit 3 |
Bottom justify text |
Bit 4 |
Do not word wrap text |
Bit 5 |
Add horizontal space for border |
Bit 6 |
Add vertical space for border |
Bit 7 |
Turn alignment on |
<framemode>
Set
the frame mode of the button. The following description defines the HEX value of
the frame mode. The value is in the range 0 to 255.
Bit 0 |
The rectangle is drawn with rounded corner |
Bit 1 |
A shadow is drawn at the right and bottom |
Bit 2 |
Blank pixels are drawn outside the rectangle |
Bit 3 |
The inner part of the rectangle will be erased |
Bit 4 |
Erasing of the inner part is done with the inverse setting |
<font>
Set
the index of the font. The fonts have to be flashed before working with
TouchKey. The fonts are user defined. The manufactory settings are:
index |
Font |
0 |
Verdana 8 pt fat |
1 |
Verdana 8 pt |
2 |
Verdana 20 pt fat |
3 |
Verdana 12 pt fat |
4 |
MS Sans Serif 18 pt fat |
5 |
MS Sans Serif 12 pt |
6 |
Verdana 10 pt fat |
7 |
Verdana 14 pt fat |
8 |
Verdana 16 pt fat |
<touchindex>
Defines
the touch file's index. The value must be in the range 0 to 63. A value of HEX
FF uses the next free index.
<press>
Value
= "true" key code is sent while pressing; value ="false" key
code is sent when released.
<startlayer>
The
name of the layer which will be started when pressing this button.
<buttonvalue>
Virtual
key codes and scan codes are defined in this section. The end of a
button value
section marks a zero key code and a zero scan code package.
<vk_code>
See list key codes.
<make>
Value
is "true" for make code and "false" for break code.
<scan_code>
See list key codes. A
scan code 0 must be set as end tag.
File <Text>.xml
<name>
The name of the
Text file.
<showinlayer>
Defines the layer in which the text field will be displayed.
<keytostart>
The
POS-Key which starts this text field. A POS Key can be programmed with the
WIN-Programmer on a key of the keyboard side (right side of the TouchKey
device ).
<erasedisplay>
Erase
the complete LCD area.
<textfield>
One
or more text fields follow.
<xpixel>
X
position in pixel of the text field.
<ypixel>
Y position in pixel of the text field.
<wpixel>
Width of
the text field This value is used to erase the text field before writing again.
<hpixel>
Height of
the text field This value is used to erase the text field before writing again.
<font>
Set
the index of the font. The fonts have to be flashed before working with
TouchKey. The fonts are user defined. The manufactory settings are:
index |
Font |
0 |
Verdana 8 pt fat |
1 |
Verdana 8 pt |
2 |
Verdana 20 pt fat |
3 |
Verdana 12 pt fat |
4 |
MS Sans Serif 18 pt fat |
5 |
MS Sans Serif 12 pt |
6 |
Verdana 10 pt fat |
7 |
Verdana 14 pt fat |
8 |
Verdana 16 pt fat |
<inverse>
Shows
the text field inverse if pressed. Not yet supported.
<setunderline>
Underline
the text. Not yet supported.
Value
of text field.
File <Graphic>.xml
<name>
The
name of the Graphic file.
<showinlayer>
Defines In which layer the graphic will be displayed.
<keytostart>
The
POS-Key which starts this graphic. A POS Key can be programmed with the
WIN-Programmer on a key of the keyboard side (right side of the TouchKey
device).
<erasedisplay>
Erase
the complete LCD area.
<graphicfield>
One
or more graphics will be defined in this section.
<xpixel>
X
position in pixel of the graphic.
<ypixel>
Y position
in pixel of the graphic.
<index>
The
index of the graphic in the flash memory of the device. The graphic has to be flashed before
running the TouchKey Server. You need the tool "iLCD Setup & Test" from demmel
products to be able to download graphics and fonts.
<animated>
Set
value to "true" if graphic is animated otherwise "false".