Difference between revisions of "Example getkey"
(→Description, Usage and Expected Behaviour) |
(→Description, Usage and Expected Behaviour) |
||
| Line 32: | Line 32: | ||
SOM-150ES carrier board with keypad | SOM-150ES carrier board with keypad | ||
| − | '''Usage for getkey''' | + | '''Usage for getkey''' |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| + | ;d:Specifies the device node. The default is <code>/dev/keypad</code> | ||
| + | ;b:Activates read blocking. The program will sleep until a key on the keypad is pressed. | ||
| + | ;g:Returns the current keypad matrix. | ||
| + | ;s:Sets the keypad matrix to that of the specified matrix file. (See project for example file <code>Key-E020-21</code>). If a matrix operation is not specified then the last key pressed is returned. | ||
'''Note''' Arguments are evaluated in order. If blocking or device specifications are used, they must be declared before the matrix arguments on the command line. | '''Note''' Arguments are evaluated in order. If blocking or device specifications are used, they must be declared before the matrix arguments on the command line. | ||
Revision as of 13:07, 20 November 2013
This procedure provides an overview of how to open, build and run the getkey C example project using the Eclipse IDE.
Contents
Opening, Building and Uploading the Project Files
1. Open the C/C++ editing perspective.
stub
2. Open the getkey project files.
stub
3. Build the getkey project.
stub
4. Upload the getkey binary to the target machine.
stub
Description, Usage and Expected Behaviour
This is an example program for mapping keypad input to a character matrix using the keypad interface on the SOM-150ES.
To use this program you will need the appropriate hardware:
- A SOM-150ES carrier board (Available from EMAC).
- A compatible SoM for that carrier board (SOM-9260M, SOM-9G20M and SOM-9X25 are all compatible and available from EMAC).
- A compatible keypad (Available from EMAC, refer to item# E20-21 or E020-25. Datasheet).
SOM-150ES carrier board with keypad
Usage for getkey
- d
- Specifies the device node. The default is
/dev/keypad - b
- Activates read blocking. The program will sleep until a key on the keypad is pressed.
- g
- Returns the current keypad matrix.
- s
- Sets the keypad matrix to that of the specified matrix file. (See project for example file
Key-E020-21). If a matrix operation is not specified then the last key pressed is returned.
Note Arguments are evaluated in order. If blocking or device specifications are used, they must be declared before the matrix arguments on the command line.
Usage Example. Mapping the Keypad to a Matrix File
./getkey -d /dev/keypad0 -s Key-E020-21
The program will map the keypad at /dev/keypad0 to the matrix file Key-E020-21.
Usage Example. Displaying the Matrix Presently Associated with the Keypad
./getkey -d /dev/keypad0 -g
The program will display the matrix presently associated with the keypad at /dev/keypad0.
File:Example getkey terminal session sample 0.png
The matrix displayed here is that of the Key-E020-21 file.
Usage Example. Displaying the Character Presently Mapped to a Key on the Keypad
./getkey -d /dev/keypad0 -b
The program will wait until a key is pressed on the keypad. When a key is pressed it will display the corresponding character mapped to that pressed key, as specified in the matrix file.
File:Example getkey terminal session sample 1.png
In this case I pressed the 5 key on the keypad.
