Switching Keyboards on Om 2007.2

From Openmoko

(Difference between revisions)
Jump to: navigation, search
m (Category changes: -Openmoko, -Techical, +Advanced End User)
(merging into manual)
 
(5 intermediate revisions by 4 users not shown)
Line 1: Line 1:
==Fix Default==
+
#REDIRECT [[Manuals/Om 2007.2]]
 
+
Due to a bug, the default keyboard supplied on the 2007.2 doesn't allow you to enter the "/" or "\" characters, which should be on the same key (0?) as "+".
+
You can instead add these characters to other keys, in this example ">" and "/" are added to the 1 key.
+
You may also insert the tab character \t, which provides tab completion.
+
The  | character may also be useful.
+
Edit <tt>/etc/multitap-pad/im-multipress.conf</tt>:
+
 
+
[keys]
+
KP_0 = +;=;/;\\
+
KP_1 = .;,;/;>;-;?;!;@;:;(;)
+
KP_2 = a;b;c;2
+
KP_3 = d;e;f;3
+
KP_4 = g;h;i;4
+
KP_5 = j;k;l;5;\t
+
KP_6 = m;n;o;6
+
KP_7 = p;q;r;s;7
+
KP_8 = t;u;v;8
+
KP_9 = w;x;y;z;9
+
KP_10 = A;B;C;2
+
KP_11 = D;E;F;3
+
KP_12 = G;H;I;4
+
KP_13 = J;K;L;5
+
KP_14 = M;N;O;6
+
KP_15 = P;Q;R;S;7
+
KP_16 = T;U;V;8
+
KP_17 = W;X;Y;Z;9
+
 
+
The buggy key is <tt>KP_0</tt> in the above file.
+
 
+
The ; character is also missing. You can add this character by adding ;\; to any of the lines above.
+
 
+
==Matchbox keyboard==
+
 
+
Another keyboard is available: matchbox-keyboard. It is a full QWERTY keyboard. This howto is based on a blog entry which can be found [http://www.ginguppin.de/node/15 here]
+
 
+
===What does the keyboard look like?===
+
 
+
[[Image:Complete_QWERTY_Keyboard_On_The_FreeRunner_screenshot.png|none|thumb|260px|Screenshot of the keyboard applet]]
+
 
+
===Considerations===
+
 
+
Pros:
+
* All keys can be generated
+
* Takes up less space than the keypad (multitap-pad), leaving more space for the application
+
 
+
Cons:
+
* You pretty much have to use a stylus.  With difficulty you can hit keys with the corner of a fingernail.
+
 
+
 
+
===How to install it?===
+
 
+
If you use a ScaredyCat release (http://buildhost.automated.it/OM2007.2/) or [http://downloads.openmoko.org/releases/Om2008.4/ Om2008.4], use the following:
+
 
+
opkg remove -force-depends multitap-pad
+
opkg install matchbox-keyboard-inputmethod
+
opkg install matchbox-keyboard-im
+
opkg install matchbox-keyboard-applet
+
 
+
Otherwise, you'll have to download the ipk files from [http://www.ginguppin.de/files/keyboard-ipk.tar.bz2 here]. Assuming you have a working internet connection on your FreeRunner, you can do the following:
+
 
+
cd /tmp
+
mkdir matchbox-keyboard
+
cd matchbox-keyboard
+
wget http://www.ginguppin.de/files/keyboard-ipk.tar.bz2
+
tar -jxf keyboard-ipk.tar.bz2
+
opkg remove -force-depends multitap-pad
+
opkg install matchbox-keyboard-inputmethod*.ipk
+
opkg install matchbox-keyboard-im*.ipk
+
opkg install matchbox-keyboard-applet*.ipk
+
cd ..
+
rm -rf matchbox-keyboard
+
 
+
After that you'll have to restart the X server:
+
/etc/init.d/xserver-nodm restart
+
 
+
===How to add a keyboard toggle button===
+
 
+
To add a button to enable showing / hiding the keyboard, edit <tt>/etc/matchbox/session</tt>. In the list of applets after <tt>--end-applets</tt>, add <tt>keyboard</tt>, and restart your X server
+
 
+
===How to switch between matchbox-keyboard and multitap-pad===
+
 
+
If you want to keep the multitap keyboard, but also be able to start up the matchbox-keyboard, you can follow these ugly instructions:
+
 
+
First you must install matchbox-keyboard.
+
opkg install matchbox-keyboard
+
 
+
Do the following (from the terminal or an ssh session with DISPLAY=:0.0):
+
killall multitap-pad
+
matchbox-keyboard > /dev/null 2>&1 &
+
 
+
(If you type the above commands with multitap, you have to leave off the redirection of matchbox-keyboard output, since several of the keys you need are missing.)
+
 
+
Caveats:  When you start the matchbox-keyboard, it stays up all the time.  This will (among other things) prevent you from unlocking, since the keyboard covers the openmoko logo at the bottom of the lock screen.  You will need to:
+
# nohup multitap-pad -d &
+
# killall matchbox-keyboard
+
to close it down, and at least get the matchbox keyboard going again.  You should do that any time you're going to leave the neo alone for any length of time, so you can unlock it later.
+
 
+
To make sure you don't end up removing all your keyboard input capability, you can create a new .desktop file in /usr/share/applications/ for starting and closing the keyboard.  This is pretty easy to do by copying and editing an existing .desktop file.
+
 
+
 
+
==Modified Matchbox Keyboard: finger friendly==
+
There is a modified Matchbox keyboard available on http://wiki.harnir.net/openmoko:keyboard-compressed .
+
The keyboard can be controlled without stylus and also includes everything needed for terminal-use.
+
 
+
==== Installation ====
+
 
+
Download one of the files below, uncompress and put it in ''/usr/share/matchbox-keyboard/'' on your Neo FreeRunner:
+
 
+
  * [http://wiki.harnir.net/_media/openmoko:file:keyboard-compressed.xml.gz?id=openmoko%3Akeyboard-compressed&cache=cache general keyboard layout]
+
  * [http://wiki.harnir.net/_media/openmoko:file:keyboard-compressed-pl.xml.gz?id=openmoko%3Akeyboard-compressed&cache=cache Polish keyboard layout]
+
 
+
If you want, you can change the name of the file to ''keyboard.xml'' or make a symlink to it. This way, ''matchbox-keyboard'' will use it automatically after next restart of the X server.
+
 
+
Note: I've installed keyboard layout from [[http://atariland.net/~dreilly/openmoko/]] before making this one. Please inform me if my layout works without these modifications, or if they are needed.
+
 
+
==== How does it look like? ====
+
 
+
=== Default layout ===
+
[[Image:Matchbox-keyboard-general.png]]
+
  * ^[ - Escape
+
  * ⇑ - Shift
+
  * ⌫ - Backspace
+
  * ⇔ - switch layout to the alternate
+
  * ^C - Control
+
  * ◆ - write a digit or symbol
+
  * ↵ - Enter
+
 
+
 
+
=== Default Polish layout ===
+
[[Image:Matchbox-keyboard-pl.png]]
+
 
+
=== Shifted Polish layout ===
+
 
+
[[Image:Matchbox-keyboard-pl-caps.png]]
+
 
+
  * ⇒ - Tab
+
  * ⇑⇑ - Caps Lock
+
 
+
If you use general layout, special characters from the top row stay the same in the shifted layout.
+
 
+
=== Digits and symbols ===
+
 
+
[[Image:Matchbox-keyboard-symbols.png]]
+
 
+
When you select a desired key in this layout, keyboard immediately returns back to the alphabet keys.
+
 
+
=== Alternate kayboard layout ===
+
 
+
[[Image:Matchbox-keyboard-alternate.png]]
+
 
+
This layout is "persistent" - when you select a key it won't disappear by itself - you need to use the <key>⇔</key> key in the bottom-left corner of the keyboard to return to the default keyboard.
+
 
+
Alternate layout is meant for easy writing of medium or long numbers (decimal or hex, hence the A-F letters), IP and MAC addresses, RGB values, etc. You can find here also direction keys (↑, ↓, ←, →) for easier movement operations.
+
 
+
 
+
==Switch back to the original Openmoko keypad==
+
 
+
If you for whatever reason need to switch back, here are the steps:
+
opkg remove matchbox-keyboard-inputmethod matchbox-keyboard-im matchbox-keyboard-applet
+
opkg install multitap-pad
+
 
+
Comment or delete the following lines in /etc/gtk-2.0/gtk.immodules :
+
#"/usr/lib/gtk-2.0/2.10.0/immodules/libmb-im-invoker.so"
+
#"matchbox-im-invoker" "Virtual Keyboard" "" "" "*"
+
 
+
Now restart the xserver:
+
/etc/init.d/xserver-nodm restart
+
 
+
[[Category:Advanced End User]]
+
[[Category:Om 2007.2]]
+

Latest revision as of 19:48, 11 February 2010

  1. REDIRECT Manuals/Om 2007.2
Personal tools

Fix Default

Due to a bug, the default keyboard supplied on the 2007.2 doesn't allow you to enter the "/" or "\" characters, which should be on the same key (0?) as "+". You can instead add these characters to other keys, in this example ">" and "/" are added to the 1 key. You may also insert the tab character \t, which provides tab completion. The | character may also be useful. Edit /etc/multitap-pad/im-multipress.conf:

[keys]
KP_0 = +;=;/;\\
KP_1 = .;,;/;>;-;?;!;@;:;(;)
KP_2 = a;b;c;2
KP_3 = d;e;f;3
KP_4 = g;h;i;4
KP_5 = j;k;l;5;\t
KP_6 = m;n;o;6
KP_7 = p;q;r;s;7
KP_8 = t;u;v;8
KP_9 = w;x;y;z;9
KP_10 = A;B;C;2
KP_11 = D;E;F;3
KP_12 = G;H;I;4
KP_13 = J;K;L;5
KP_14 = M;N;O;6
KP_15 = P;Q;R;S;7
KP_16 = T;U;V;8
KP_17 = W;X;Y;Z;9

The buggy key is KP_0 in the above file.

The ; character is also missing. You can add this character by adding ;\; to any of the lines above.

Matchbox keyboard

Another keyboard is available: matchbox-keyboard. It is a full QWERTY keyboard. This howto is based on a blog entry which can be found here

What does the keyboard look like?

Considerations

Pros:

  • All keys can be generated
  • Takes up less space than the keypad (multitap-pad), leaving more space for the application

Cons:

  • You pretty much have to use a stylus. With difficulty you can hit keys with the corner of a fingernail.


How to install it?

If you use a ScaredyCat release (http://buildhost.automated.it/OM2007.2/) or Om2008.4, use the following:

opkg remove -force-depends multitap-pad
opkg install matchbox-keyboard-inputmethod
opkg install matchbox-keyboard-im
opkg install matchbox-keyboard-applet

Otherwise, you'll have to download the ipk files from here. Assuming you have a working internet connection on your FreeRunner, you can do the following:

cd /tmp
mkdir matchbox-keyboard
cd matchbox-keyboard
wget http://www.ginguppin.de/files/keyboard-ipk.tar.bz2
tar -jxf keyboard-ipk.tar.bz2
opkg remove -force-depends multitap-pad
opkg install matchbox-keyboard-inputmethod*.ipk
opkg install matchbox-keyboard-im*.ipk
opkg install matchbox-keyboard-applet*.ipk
cd ..
rm -rf matchbox-keyboard

After that you'll have to restart the X server:

/etc/init.d/xserver-nodm restart

How to add a keyboard toggle button

To add a button to enable showing / hiding the keyboard, edit /etc/matchbox/session. In the list of applets after --end-applets, add keyboard, and restart your X server

How to switch between matchbox-keyboard and multitap-pad

If you want to keep the multitap keyboard, but also be able to start up the matchbox-keyboard, you can follow these ugly instructions:

First you must install matchbox-keyboard.

opkg install matchbox-keyboard

Do the following (from the terminal or an ssh session with DISPLAY=:0.0):

killall multitap-pad
matchbox-keyboard > /dev/null 2>&1 &

(If you type the above commands with multitap, you have to leave off the redirection of matchbox-keyboard output, since several of the keys you need are missing.)

Caveats: When you start the matchbox-keyboard, it stays up all the time. This will (among other things) prevent you from unlocking, since the keyboard covers the openmoko logo at the bottom of the lock screen. You will need to:

  1. nohup multitap-pad -d &
  2. killall matchbox-keyboard

to close it down, and at least get the matchbox keyboard going again. You should do that any time you're going to leave the neo alone for any length of time, so you can unlock it later.

To make sure you don't end up removing all your keyboard input capability, you can create a new .desktop file in /usr/share/applications/ for starting and closing the keyboard. This is pretty easy to do by copying and editing an existing .desktop file.


Modified Matchbox Keyboard: finger friendly

There is a modified Matchbox keyboard available on http://wiki.harnir.net/openmoko:keyboard-compressed . The keyboard can be controlled without stylus and also includes everything needed for terminal-use.

Installation

Download one of the files below, uncompress and put it in /usr/share/matchbox-keyboard/ on your Neo FreeRunner:

 * general keyboard layout
 * Polish keyboard layout

If you want, you can change the name of the file to keyboard.xml or make a symlink to it. This way, matchbox-keyboard will use it automatically after next restart of the X server.

Note: I've installed keyboard layout from [[1]] before making this one. Please inform me if my layout works without these modifications, or if they are needed.

How does it look like?

Default layout

Matchbox-keyboard-general.png

 * ^[ - Escape
 * ⇑ - Shift
 * ⌫ - Backspace
 * ⇔ - switch layout to the alternate
 * ^C - Control
 * ◆ - write a digit or symbol
 * ↵ - Enter


Default Polish layout

Matchbox-keyboard-pl.png

Shifted Polish layout

Matchbox-keyboard-pl-caps.png

 * ⇒ - Tab
 * ⇑⇑ - Caps Lock

If you use general layout, special characters from the top row stay the same in the shifted layout.

Digits and symbols

Matchbox-keyboard-symbols.png

When you select a desired key in this layout, keyboard immediately returns back to the alphabet keys.

Alternate kayboard layout

Matchbox-keyboard-alternate.png

This layout is "persistent" - when you select a key it won't disappear by itself - you need to use the <key>⇔</key> key in the bottom-left corner of the keyboard to return to the default keyboard.

Alternate layout is meant for easy writing of medium or long numbers (decimal or hex, hence the A-F letters), IP and MAC addresses, RGB values, etc. You can find here also direction keys (↑, ↓, ←, →) for easier movement operations.


Switch back to the original Openmoko keypad

If you for whatever reason need to switch back, here are the steps:

opkg remove matchbox-keyboard-inputmethod matchbox-keyboard-im matchbox-keyboard-applet
opkg install multitap-pad

Comment or delete the following lines in /etc/gtk-2.0/gtk.immodules :

#"/usr/lib/gtk-2.0/2.10.0/immodules/libmb-im-invoker.so"
#"matchbox-im-invoker" "Virtual Keyboard" "" "" "*"

Now restart the xserver:

/etc/init.d/xserver-nodm restart