1. Manuals
  2. Brands
  3. PrehKeyTec Manuals
  4. Keyboard
  5. MCI TouchKey
  6. Technical documentation manual

PrehKeyTec MCI TouchKey Technical Documentation Manual

Preh mci touchkey: supplementary guide
Hide thumbs Also See for MCI TouchKey:
Table of Contents

Advertisement

Quick Links

Download this manual
MCI TouchKey
Technical
Documentation
Figure shows a specific keyboard layout
Document Rev. B
PrehKeyTec GmbH
TK-TechDoc_RevB_en.doc - 2008-07-31
Page 1/40

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the MCI TouchKey and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for PrehKeyTec MCI TouchKey

Summary of Contents for PrehKeyTec MCI TouchKey

  • Page 1 MCI TouchKey Technical Documentation Figure shows a specific keyboard layout Document Rev. B PrehKeyTec GmbH TK-TechDoc_RevB_en.doc - 2008-07-31 Page 1/40...

  • Page 2: Table Of Contents

    Introduction... 3 System requirements ... 3 Structure of the MCI TouchKey ... 4 Keyboard and module...4  Touch-LCD ... 4 LCD ...4  TouchKey Server...4  Loading graphics ...5  TouchKey Programmer ... 6 General information ...6  Requirements ...6  Adding graphics into the TouchKey Programmer ...7 ...

  • Page 3: Introduction

    Introduction The TouchKey is a combination of a Touch LCD and a keyboard. The right section of the device and included modules behave like standard PrehKeyTec keyboards and as such are programmed using the WinProgrammer. On the left section of the device is a LCD Touch Panel which communicates with an application running on the PC.

  • Page 4: Structure Of The Mci Touchkey

    The TouchKey server communicates with the XML Data stored in the PC and sends this data through the TKInterface.dll to the MCI TouchKey. Changes in the XML Data are recognized by the TouchKey Server after the data is stored and the new data is displayed on the screen.

  • Page 5: Loading Graphics

    Info-Dialog: Loading graphics Graphics can be displayed on the LCD panel of the MCI TouchKey. The maximum size of a graphic that can be displayed is 320x240. Acceptable formats are *.bmp, *.jpg or *.gif. The graphics are stored in the internal memory of the LCD controller.

  • Page 6: Touchkey Programmer

    The most recent version of the TouchKey Programmer can be downloaded from our website at: http://support.PrehKeyTec.com. For getting started a flash animation shows the first steps and explains the basic usage of the MCI TouchKey. Requirements The TouchKey Programmer requires .NET Framework 2.0 or later to be installed on the system.

  • Page 7: Adding Graphics Into The Touchkey Programmer

    After creating a project and its layouts, this can be exported to the LCD using "Test Projects". However before the layouts can be viewed on the screen, the TouchKey Server has to be started. This TouchKey Server has to be installed one level above the XML folder which contains the XML files.

  • Page 8: Xml Files

    XML file and configures the content, after which the file is saved. The TouchKey Server will recognize this saving of the file and sends the updated file to the display of the MCI TouchKey. Why XML? XML offers the following advantages:...

  • Page 9: Types Of Xml Files

    Types of XML files TouchKey.xml Every MCI TouchKey has a basic configuration. This configuration is stored in "Touchkey.xml". This file can also contain information and configurations for more than one TouchKey. Differentiating the layouts for the different TouchKeys is done using the TouchKey’s serial number.
  • Page 10 <NumberOfGraphics> The number of graphics available for the TouchKey. A graphic file can contain many different graphics. Example: <NumberOfGraphics>1</NumberOfGraphics> <NumberOfText> The number of text files which are available for this TouchKey. A text file can contain multiple text fields Example: <NumberOfText>2</NumberOfText> <Layer>...
  • Page 11 </Device> </TouchKey> The above example describes an MCI TouchKey. The above example shows no serial number since there is just one device involved. The device displays 3 layouts. Additional, the layout "tables" contains one or more graphics and text fields. The layout "food"...
  • Page 12 MCI TouchKey example for two devices <?xml version="1.0" encoding="utf-8" ?> <TouchKey xmlns="http://tempuri.org/TouchKey.xsd"> <Device> <Serialnumber>1234-1234567</Serialnumber> <Contrast>160</Contrast> <Backlight>15</Backlight> <NumberOfLayers>3</NumberOfLayers> <NumberOfGraphics>1</NumberOfGraphics> <NumberOfText>2</NumberOfText> <Layers> <Layer>tables</Layer> <Layer>drinks</Layer> <Layer>food</Layer> </Layers> <graphics> <graphic>tables_gfx</graphic> </graphics> <text> <txt>drinks_txt</txt> <txt>food_txt</txt> </text> </Device> <Device> <Serialnumber>1234-1234568</Serialnumber> <Contrast>160</Contrast> <Backlight>13</Backlight> <NumberOfLayers>2</NumberOfLayers> <NumberOfGraphics>0</NumberOfGraphics> <NumberOfText>1</NumberOfText> <Layers>...

  • Page 13: Layername>.Xml

    This is a POS-Key, which can directly bring up a layer on the screen. These keys can be programmed using the WinProgrammer software on the keyboard section of the MCI TouchKey. If this is not needed, please enter the value 0. The value range is 0- Example: <keytostart>1</keytostart>...
  • Page 14 <beepfreq> Frequency of the key click. Range 0-255. 0 - 15 = ca 4800Hz 16 - 31 = ca 2400Hz 32 - 63 = ca 1200Hz from 64 = ca 600Hz Example: <beepfreq>16</beepfreq> <beepduration> Length of key click. Rane 0-255. Length = Value * 8,3ms Example: <beepduration>10</beepduration>...
  • Page 15 <text> The text written on the key. Special characters have to be written using character references as follows: "&#character;" An example for creating a new line will be "&#10;". A list of the ASCI characters is found at the end of this document. Numbers are to be written in decimal form.
  • Page 16 Describes index of the font being used. The fonts have to be loaded on the flash memory of the TouchKey before they can be used. The a user defined. The list below shows the default font found in each MCI TouchKey: 0 Verdana 8 pt fat...
  • Page 17 <scan_code> The scan code for the key. The decimal number for the value is used. This block also ends with a 0 scan code. Example: <buttonvalue> <vk_code>49</vk_code> <make>true</make> <scan_code>2</scan_code> <scan_code>0</scan_code> </buttonvalue> <buttonvalue> <vk_code>49</vk_code> <make>false</make> <scan_code>2</scan_code> <scan_code>0</scan_code> </buttonvalue> <buttonvalue> <vk_code>0</vk_code> <make>false</make> <scan_code>0</scan_code>...
  • Page 18 The XML file for the above example has the following structure <?xml version="1.0" encoding="utf-8" ?> <Layer xmlns="http://tempuri.org/layer.xsd"> <name>L1</name> <index>0</index> <keytostart>0</keytostart> <buttons> <buttondata> <beep>true</beep> <beepfreq>16</beepfreq> <beepduration>10</beepduration> <inverse>true</inverse> <keyboardoutput>true</keyboardoutput> <xpixel>45</xpixel> <ypixel>40</ypixel> <wpixel>92</wpixel> <hpixel>40</hpixel> <text>TEST</text> <textmode>131</textmode> <framemode>3</framemode> <font>6</font> <touchindex>1</touchindex> <press>true</press> <startlayer/> <buttonvalue> <vk_code>16</vk_code> <make>true</make>...
  • Page 19 <vk_code>83</vk_code> <make>true</make> <scan_code>31</scan_code> <scan_code>0</scan_code> </buttonvalue> <buttonvalue> <vk_code>83</vk_code> <make>false</make> <scan_code>31</scan_code> <scan_code>0</scan_code> </buttonvalue> <buttonvalue> <vk_code>84</vk_code> <make>true</make> <scan_code>20</scan_code> <scan_code>0</scan_code> </buttonvalue> <buttonvalue> <vk_code>84</vk_code> <make>false</make> <scan_code>20</scan_code> <scan_code>0</scan_code> </buttonvalue> <buttonvalue> <vk_code>0</vk_code> <make>false</make> <scan_code>0</scan_code> </buttonvalue> </buttondata> </buttons> </Layer> The key code sequence for this example "Test" is as follows: make SHIFT ->make ‘t’...

  • Page 20: Text>.Xml

    <keytostart> This is a POS Key that starts the Text automatically. POS keys can be programmed using the WinProgrammer on the keyboard section of the device. If this is not required, the default value 0 is used. Value range: 0-128.
  • Page 21 <xpixel> Position Horizontal. Range 0-320. Example: <xpixel>0</xpixel> <ypixel> Position Vertical. Range 0-240. Example: <ypixel>0</ypixel> <wpixel> Width of text field in pixels. Range 0-320. Example: <wpixel>138</wpixel> <hpixel> Height of text field in Pixel. Range 0-240. Example: <hpixel>200</hpixel> <font> This describes the index of the font that is being used. These fonts have to be loaded in the memory of the TouchKey before they can be used and they are user defined.
  • Page 22 <setunderline> Underlines the text. Possible values: true, false Example: <setunderline>false</setunderline> <textstring> This section holds the content of the text field. Special characters are written with character references. This is structure is as follows:"&#character reference;". For example a new line will be written as "&#10;". A list of the ASCII character is found at the end of this document.
  • Page 23 A layout sample <?xml version="1.0" encoding="utf-8" ?> <text xmlns="http://tempuri.org/Text.xsd"> <name>L1_txt</name> <showinlayer>L1</showinlayer> <keytostart>0</keytostart> <erasedisplay>false</erasedisplay> <textfield> <xpixel>45</xpixel> <ypixel>80</ypixel> <wpixel>230</wpixel> <hpixel>40</hpixel> <font>3</font> <inverse>false</inverse> <setunderline>false</setunderline> <textstring>This is a test</textstring> <textmode>131</textmode> </textfield> </text> PrehKeyTec GmbH The name for the XML file is "L1_txt.xml". This Layout contains a text field with the text "This is a test".

  • Page 24: Graphic>.Xml

    Example: <showinlayer>food</showinlayer> <keytostart> This is a POS key that can be programmed on the keyboard section of the WinProgrammer to start a graphic when pressed. This function can be turned off if not desired by entering the number 0 in the provided field.
  • Page 25 <ypixel> Position vertical. Range 0-240. Example: <ypixel>6</ypixel> <index> This index represents that of the graphic in the TouchKey device. The graphics must be loaded into the TouchKey before they can be used. Consult the section Loading graphics for more information on how to do this. Example: <index>17</index>...

  • Page 26: Startlayout.xml

    <?xml version="1.0" encoding="utf-8"?> <startlayout> <device serialnumber="987654321"> <layout>Layout</layout> </device> <device serialnumber="ID-PREH-00131154028-EA27"> <layout>Zettel</layout> </device> </startlayout> For each device that is defined in "TouchKey.xml", there is a corresponding <device> entry. Using the attribut "serial number", the serial number of the device is entered for identification purposes.

  • Page 27: Sample Project For The Touchkey Programmer

    Appendix Sample project for the TouchKey Programmer Using the TouchKey Programmer, we are going to create two layouts as a working example. The first layout contains a text field, a graphic and a programmed key (button). The second layout contains a text field and programmed key. Using the programmed key in the second layout, one could drill back to the first layout.
  • Page 28 Data for L1.xml <?xml version="1.0" encoding="utf-8" ?> <Layer xmlns="http://tempuri.org/layer.xsd"> <name>L1</name> <index>0</index> <keytostart>0</keytostart> <buttons> <buttondata> <beep>true</beep> <beepfreq>16</beepfreq> <beepduration>10</beepduration> <inverse>true</inverse> <keyboardoutput>false</keyboardoutput> <xpixel>91</xpixel> <ypixel>160</ypixel> <wpixel>138</wpixel> <hpixel>40</hpixel> <text>Layout 2</text> <textmode>131</textmode> <framemode>3</framemode> <font>0</font> <touchindex>1</touchindex> <press>true</press> <startlayer>L2</startlayer> <buttonvalue> <vk_code>0</vk_code> <make>false</make> <scan_code>0</scan_code> </buttonvalue> </buttondata> </buttons> </Layer> Data for L1_gfx <?xml version="1.0"...
  • Page 29 Data for L1_txt <?xml version="1.0" encoding="utf-8" ?> <text xmlns="http://tempuri.org/Text.xsd"> <name>L1_txt</name> <showinlayer>L1</showinlayer> <keytostart>0</keytostart> <erasedisplay>false</erasedisplay> <textfield> <xpixel>0</xpixel> <ypixel>80</ypixel> <wpixel>319</wpixel> <hpixel>40</hpixel> <font>3</font> <inverse>false</inverse> <setunderline>false</setunderline> <textstring>Scheinbergweg 10&#10;D-97638 Mellrichstadt</textstring> <textmode>131</textmode> </textfield> </text> Data for L2.xml <?xml version="1.0" encoding="utf-8" ?> <Layer xmlns="http://tempuri.org/layer.xsd"> <name>L2</name> <index>1</index> <keytostart>0</keytostart> <buttons> <buttondata>...
  • Page 30 Data for L2_txt.xml <?xml version="1.0" encoding="utf-8" ?> <text xmlns="http://tempuri.org/Text.xsd"> <name>L2_txt</name> <showinlayer>L2</showinlayer> <keytostart>0</keytostart> <erasedisplay>false</erasedisplay> <textfield> <xpixel>45</xpixel> <ypixel>40</ypixel> <wpixel>230</wpixel> <hpixel>40</hpixel> <font>7</font> <inverse>false</inverse> <setunderline>false</setunderline> <textstring>Layout 2</textstring> <textmode>131</textmode> </textfield> </text> PrehKeyTec GmbH TK-TechDoc_RevB_en.doc - 2008-07-31 Page 30/40...

  • Page 31: Opos Service Object Linedisplay

    OPOS Service Object LineDisplay The two line display previously offered for the MC family keyboards is no longer available for our MCI keyboards. Using the display of the TouchKey however, and using OPOS, it is possible to out put the two lines on the display of the TouchKey. The OPOS tool makes it possible to configure the fonts and the number of lines, and also the number of characters in each line.

  • Page 32: Configuring The Flash Memory Using Ilcd Setup

    Configuring the flash memory using iLCD Setup The most recent version of this software (iLCD Setup) can be downloaded from this location: http://www.demmel.com/ilcd/english/software.htm How it works This program is used to load graphics into the flash memory of the TouchKey. In order to load graphics, start by selecting "setup"...

  • Page 33: Ascii Character Table

    ASCII Character Table PrehKeyTec GmbH TK-TechDoc_RevB_en.doc - 2008-07-31 Page 33/40...
  • Page 34 PrehKeyTec GmbH TK-TechDoc_RevB_en.doc - 2008-07-31 Page 34/40...

  • Page 35: Scan Codes

    Scan Codes This table contains a variety of PS2-Scan codes (Scanset1). A complete list of all the PS2-Scan codes can be found in the Microsoft Translation Table in this location: http://www.microsoft.com/whdc/archive/scancode.mspx#ENB PrehKeyTec GmbH TK-TechDoc_RevB_en.doc - 2008-07-31 Page 35/40...

  • Page 36: Virtual Key Codes

    VK_UP VK_RIGHT VK_DOWN VK_SELECT VK_PRINT VK_EXECUTE VK_SNAPSHOT VK_INSERT VK_DELETE VK_HELP PrehKeyTec GmbH Value Keyboard (or mouse) equivalent (decimal) Control-break processing BACKSPACE key TAB key CLEAR key ENTER key SHIFT key CTRL key ALT key PAUSE key CAPS LOCK key ESC key...
  • Page 37 VK_NUMPAD0 VK_NUMPAD1 VK_NUMPAD2 VK_NUMPAD3 VK_NUMPAD4 VK_NUMPAD5 VK_NUMPAD6 VK_NUMPAD7 VK_NUMPAD8 VK_NUMPAD9 VK_SEPARATOR VK_SUBTRACT VK_DECIMAL VK_DIVIDE VK_F1 VK_F2 VK_F3 VK_F4 VK_F5 VK_F6 VK_F7 VK_F8 VK_F9 VK_F10 VK_F11 VK_F12 VK_F13 VK_F14 VK_F15 VK_F16 VK_F17 VK_F18 VK_F19 PrehKeyTec GmbH H key I key J key K key L key M key...
  • Page 38 VK_F20 VK_F21 VK_F22 VK_F23 VK_F24 VK_NUMLOCK VK_SCROLL VK_LSHIFT VK_RSHIFT VK_LCONTROL VK_RCONTROL VK_LMENU VK_RMENU VK_PLAY VK_ZOOM PrehKeyTec GmbH F20 key F21 key F22 key F23 key F24 key NUM LOCK key SCROLL LOCK key Left SHIFT key Right SHIFT key Left CONTROL key Right CONTROL key Left MENU key Right MENU key...

  • Page 39: Technical Data

    Technical Data Electronics: Supply voltage: Current consumption: Interface: LCD TouchKey: Backlight: Touch panel: Temperature and Environment Ratings: Operational temperature: 0°C to 50°C Air pressure: Storage & transportation: -30°C to 60°C Climatic class: Protection class: Materials: Housing: Guide frame: Switching membrane: Spring elements: Textile filter: Keys and keycaps:...

  • Page 40: Additional Help

    Additional help Recent versions of our programming software and more information can be downloaded from the support section on our website at: http://www.prehkeytec.com. Our customer support contacts are as follows: Email: support@prehkeytec.de support@prehkeytecusa.com for North and Latin America Copyright © Copyright PrehKeyTec GmbH 2008 Published by PrehKeyTec GmbH.

Table of Contents