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.


<beepfreq>

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).


<text>

Set the text of the button. Special characters must be defined as code sequence (e. g. new line &#10; ).


<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.


<textstring>

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".