Keypad, XML file structure

Vorheriges Oben Nächstes Helps selection copy topic address english version

HMIs, human machine interfacesET-208Keypad, XML file structure

 

The X9 keyboard port has 8 ingoing pins and 4 outgoing pins, to which 32 keys can be connected. An XML-based file specifies which keycode represents which key.

 

Derived from the 8 * 4 keypad of the keyboard input and output,

 

Fgr_32_Keymatrix_Connection

the XML file for the allocation of the key code to be emulated has the following structure:

 

Based on an 8 * 4 keypad.

<?xml version="1.0" encoding="utf-16"?>

Introductory TAG for the XML version

and character coding with UTF-16.

<keyboard name="PrintecMatrix" version="1.0.0">

Opening TAG for the key data.

of the "PrintecMatrix" in version "1.0.0".

<connection first_feedback_pin="0" first_scan_pin="8">

</connection>

Declaration TAG for the consecutive configuration.

!!! Do not change !!!

1*

<matrix rows="4" columns="8" scanned_by="columns">

Opening TAG of the matrix data,

for a matrix with 8 * IN and 4 * OUT.

This determines how many key TAGS (8 columns)

are read per row (4 rows).

2*

<!-- row 0 -->

Comment row, is ignored by interpreter. Is not necessary.

3*

<key format="hex"> 0x05 </key> <!-- 'F1' -->

Declaration of the hexacdecimal-based key code "0x05" of the "F1" function key at the IN1<OUT1 connection.

~~~~~

Below a further 7 key declarations of row 1

and 8 key declarations of row 2.

<!-- row 3 -->

Comment row, is ignored by interpreter. Is not necessary.

<key format="hex"> 0x0C </key> <!-- 'F4' -->

Declaration of the hexadecimal-based key code "0x3E"

for number key "F4" at the IN1<OUT3 connection.

~~~~~

Below a further 7 key declarations of row 3

and 8 key declarations of row 4.

</matrix>

Termination TAG for the matrix data.

</keyboard>

Termination TAG for the key data.

 

Hinweis

The coloured highlights of the TAGs are for readability purposes only !

They are irrelevant for the function of the XML file and can also be kept in the same colour.

 

*1)

The "columns" parameter in the TAG instructs the interpreter

to allocate 8 "<key" TAGs to the "IN1" to"IN8" connections.

 

The "rows" parameter in the TAG instructs the interpreter to allocate the first 8 "<key"-TAGs to the "OUT1" connection, the next 8 "<key"-TAGs to the "OUT2" connection, and so on.

 

A keypad with eight function keys (see cicon2 Push buttons F1 to F8.) must therefore be declared with the parameters rows="8" and columns="1" or rows="2" and columns="4".

In the first case the interpreter expects 8 "<key" TAGs which it allocates to the connection "OUT1" and connections "IN1" to "IN8".

In the second case the interpreter expects 8 "<key" TAGs, the first four of which are allocated to connection "OUT1" and the next four to "OUT2". Both outputs OUT1 / OUT2 are allocated inputs "IN1" to "IN4".

 

A 4 * 4 keypad must be declared with the parameters rows="4" and columns="4". In this case the interpreter expects four "<key" TAGs each allocated to connections "OUT1", "OUT2, "OUT3, "OUT4" and connections "IN1" to "IN4".

*2)

Any texts within the characters "<!--" and "-->" are comments and therefore are ignored by the interpreter.

*3)

Key declaration with a code in hexadecimal format. The codes are listed in the following table.

 

Overview of key codes that can be allocated:

Key

Keycode

Explanation

F1

0x05

Function key 1, for menu control

F2

0x06

Function key 2

F3

0x04

Function key 3

F4

0x0C

Function key 4

F5

0x03

Function key 5

F6

0x0B

Function key 6

F7

0x83

Function key 7

F8

0x0A

Function key 8

F9

0x01

Function key 9

F10

0x09

Function key 10

F11

0x78

Function key 11

F12

0x07

Function key 12

F13

0x08

Function key 13

F14

0x10

Function key 14

F15

0x18

Function key 15

F16

0x20

Function key 16

 

0

0x45

Key for number "0".

1

0x16

Key for number "1".

2

0x1E

Key for number "2".

3

0x26

Key for number "3".

4

0x25

Key for number "4".

5

0x2E

Key for number "5".

6

0x36

Key for number "6".

7

0x3D

Key for number "7".

8

0x3E

Key for number "8".

9

0x46

Key for number "9".

-

0x7B

Key for character "-".

.

0x49

Key for decimal point ".".

 

Symb_ESC

0x76

Control key, ESCAPE (abort, exit)

Symb_Space

0x29

Space key

Symb_Return

0x5A

Control key for row input (ENTER)

Symb_BackQuote

0x66

Control key for one step back

Symb_Vk_Up

0x95

Control key for one step up

Symb_Vk_Left

0x96

Control key for one step to the left

Symb_Vk_Right

0x97

Control key for one step to the right

Symb_Vk_Down

0x98

Control key for one step down

 

 

See XML for:

Kapitelseite Push buttons F1 to F8

Kapitelseite Push buttons F1 to F12

 

 

<< back