| |
Project Download Configuration Links Author Donations: |
|
Input Configuration
Explanation of different input action types:
| x |
x is the only action assigned to the input
event. E.g. 'Winamp: play' |
| x | y |
x is the short key press action, y is the long
key press action. E.g. 'Next | FF': a short key press will play the
next song in the playlist and a long key press will fast forward the
current song. |
| x / y |
x is the first key press action, y is the second
key press action. E.g. 'Show/hide Menu': the first key press will show
the menu and the second key press will hide the menu. |
Keyboard & Winamp Keyboard
| Keyboard | Low level keyboard hook function. Use this driver for hardware keyboards. |
| Winamp Keyboard | Winamp keyboard hook function. Use this driver for 'remote control software solutions' like Girder or for programmatically sending key strokes to Winamp. |
Attention:
- the Add dialog can only be closed with the mouse, every key press will be captured and displayed in the dialog!
- 'Keyboard' is a low level keyboard hook driver and doesn't work with most 'remote control software' like Girder!
- Winamp Keyboard: the main Winamp window must have the
focus, otherwise key presses won't be detected.
WinLIRC
Originally based on WinLIRC Plugin 0.3. Enhanced with LCD functions
and key repeat thresholds.
Notes:
- x | y actions don't work
- 'Jump to number: KEY###KEY'
WinLIRC must be configured for buttons 0-9 that it sends an equivalent key name, i.e. the button name of key number 3 must be '3' etc.
This function is not yet tested, but should work...
Cfg: opens the following dialog to configure the input data format:
| Count |
The value of the repeat flag sent by the WinLIRC
server so that the key press gets recognized as a repeated key. Too complicated? Explanation: if a key gets pressed and hold down the WinLIRC server sends the same command (key xy has been pressed) over and over again to its clients. The only difference between the messages is the repeat value, i.e. how many times the button has been pressed. The intervall at which these messages are being sent are different from remote to remote... There's one problem though: the first key press is recognized as a single key press! This makes the WinLIRC input unusable for combined 'short | long keypress actions' like 'Next | Fast forward'. Workaround: assigned different keys to actions 'Winamp: Next' and 'Winamp: Fast forward'. Default = 5. Disabled = 0 |
| Delay |
Minimum time in milliseconds between key presses
below the Count value
that they get processed. If the time between key presses is shorter
than this value they get discarded. Usefull for up/down menu navigation
or volume control: the n key presses below Count will be
processed in an intervall of Delay ms,
afterward as fast as WinLIRC sends the repeated key press events. Think
of it as a simple pseudo progressiv speed up, the longer you press the
key the faster the repeated action (well, there are only slow in the
beginning and afterwards fast...). Only active if Count value is > 1 |
| Server |
WinLIRC server name or IP address. Default =
localhost or 127.0.0.1 |
| Port |
WinLIRC port. Default = 8765 |
Serial Port
Use LCD Port: shares
the serial port of the LCD display.
This option is only enabled if the active LCD driver uses a COM port
otherwise one has to specify the serial Port and the Baudrate.
Port: select the serial port and baudrate. The port settings
are No Parity, 8 Data Bit, 1 Stop Bit (not configurable).
Cfg:
opens the following dialog
to configure the input data format:
| Static
Input
Length: |
All input is of same
length, e.g. each key press sends one character. |
| Dynamic Input Length: |
The input format is of
dynamic length or contains start- and end characters. |
Configuration for PJRC keypads:
- as shown above (dynamic input length, start character = 98, end character = 13)
- there are 3 events being sent: n_up, n_down and n_repeat where n
is the key number.
_up = when the key is released
_down = when the key is pressed
_repeat = when the key is hold down
Other keypads couldn't be tested yet...
Add Button: assigning
input actions:
| Button ID: |
Input character or input
string. In above example the input string "6_repeat" will trigger the
specified action "Fast Forward" whenever key number 6 is pressed and
hold down.. |
Restrictions:
- Input is terminal based, i.e. character or string input.
Directly hooked up buttons on CTE lines etc. are not supported!
-
Input is either single character based or with start and end characters.
-
Input is case sensitive.
-
Only the PJRC keypad was successfully tested.
Parallel Port
Use LCD Port: shares the parllel port of the LCD display.
This option is only enabled if the active LCD driver uses a parallel port otherwise one has to specify the Port address and the interface type.
More information about parallel input configuration will be provided at a later time.
In the meantime most of the configuration parameters are described in hd44780_howto.txt and in the INI file gen_LCD.ini.
The input mapping (key press to a character) is defined in gen_LCD.ini, example:
[Keypad]
// directly connected keys
keydirect_1=A
keydirect_2=B
keydirect_3=C
keydirect_4=D
keydirect_5=E
// matrix layout (keymatrix_<x>_<y> where <x> is between 1 and 5, <y> between 1 and 11)
;keymatrix_1_1=1
;keymatrix_1_2=2
;keymatrix_2_1=A
;keymatrix_2_2=B
; etc
The assigned character must then be specified as the 'Button ID' in the Button Assignment dialog.
| << previous page: Plug-in
Configuration |
