Keyboard Layout
The above image is the current keymap layout for openwrt-zipit. The numbers above each key are the designated keycodes used in the keymap file. Each key has several options depending on the modifier used and are color coded based on those modifiers:
- White: No Modifier
- Blue: Shift
- Red: Altgr
- Purple: Shift + Altgr
- Green: Shift + Control
- Black: Unused or risk of conflict with neighboring keys
The Zipit keymap is stored at /etc/z2.kmap and is a compiled keymap format which means it cannot be edited directly with a text editor. You can download the current keymap source from here, modify it to your liking and use the loadkeys utility (on a host machine) to convert it back:
loadkeys -b z2.map >z2.kmap
The ebindkeys daemon allows you to configure special key combos to run shell scripts or programs. The configuration file is located at /etc/ebindkeysrc. This is used on the Zipit for some special keyboard functions listed below:
-
power: suspend mode (runs /usr/sbin/suspend script; press again to wakeup) -
volup: volume up -
voldn: volume down -
ctrl+volup: LCD backlight up -
ctrl+voldn: LCD backlight down -
shift+volup: Key backlight up -
shift+voldn: Key backlight down -
home: onHome script (for gmenu2x) -
ctrl+options: turn on/off ebindkeys -
ctrl+prev: turn on/off LCD backlight timer
ebindkeys also contains code for a keymouse so that you can use the keyboard as a mouse with certain applications that need it. Holding ctrl while using the following keys enables these mouse functions:
-
d-pad: up, down, left, right mouse cursor movement -
stop: right-click -
play: left-click
It has also been modified with some power management features for backlight control. These brightness options can be changed in the configuration file:
- brightscrb: screen brightness when plugged in
- dimscrb: screen brightness when unplugged
- brightkeyb: key brightness when plugged in
- dimkeyb: key brightness when unplugged
- lcdtimeout: screen off timeout when unplugged
- keytimeout: key off timeout when unplugged
Another new feature of ebindkeys is the option to blink one of the Zipit notification LEDs by signaling the ebindkeys process with SIGUSR2 which is then stopped on the next keypress. You can set the LED in /etc/ebindkeysrc which defaults to the middle amber LED. The tmux package is configured to use this for the terminal bell in addition to playing a bell sound. To trigger the LED:
kill -12 `pidof ebindkeys`