Keyboard Toggle

From Openmoko

Revision as of 03:42, 3 September 2008 by Ssinger (Talk | contribs)

Jump to: navigation, search

The Om 2008.8 and Om 2007.2 Openmoko distributions have been designed to bring up an on-screen keyboard which supplies keystroke information to applications. However, this requires the cooperation of the application, which is a problem for software designed with another X11 based phone stack in mind, or software which has been quickly ported from Linux desktop systems, because it will never bring up a keyboard for (possibly important) keystroke information. It is also possible that the keyboard could be brought or remain up by accident when you don't want it there, or even software specifically designed with this functionality in mind may occasionally fail or become confused when an on screen keyboard is supposed to be available.

See Om2008.8 Keyboard for details of the Om 2008.8 keyboard's usage.

Contents

Alternatives

Alternatively, you can try connecting a bluetooth keyboard or USB keyboard (Only available with a special cable, or an extra special cable in the case of the older unpowered USB units.)

Reactivating the keyboard toggle under Om 2008.8

For advanced users using the Om 2008.8 distribution, it may be worth your while to change the E17 theme information which prevents the 'qwerty' link in the upper left from showing.

On the phone

Method 1

Simply install the illume-config theme:

opkg install illume-config

Method 2

Install the tools required to decompile and recompile E17 theme code.

opkg install libevas-saver-png edje-utils cpp cpp-symlinks libembryo-tests

Decompile the theme, and edit the edc file

cd /usr/share/enlightenment/data/themes
edje_decc illume.edj
cd illume
vi freerunner.edc

Search for the text 'qwerty'. This should take you to the section which defines the small 'qwerty' button in the upper left.

  • Under 'part { name: "kbd";' change 'visible 0;' to 'visible 1;', and change 'relative: 0.0 1.0; ' to 'relative: 1.0 1.0; '
  • Under 'part { name: "kbdtext";' change 'visible 0;' to 'visible 1;'

And then recompile the .edj

sh build.sh
mv illume.edj ../illume.edj

And finally restart X to take new theme in use

/etc/init.d/xserver-nodm restart

Building a custom package

If that doesn't work, follow the instructions on building Om 2008.8 from source. Unpack the source for the package 'illume-theme', edit its edc file using the same method described above, and then finish building the ipk. You should be able to install this ipk, overiding the previous configuration.

Upgrading

If you upgrade, such as with opkg upgrade, you may have to perform the modification again.

If you've upgraded to a 2008.8-updates you need to make sure that the keyboard is enabled in illume-config.

  • Install illume-config to get the illume configuration screen (the "wrench" )
  • From the configuration page select "Keyboard"
  • Select "Default"
Personal tools

The Om 2008.8 and Om 2007.2 Openmoko distributions have been designed to bring up an on-screen keyboard which supplies keystroke information to applications. However, this requires the cooperation of the application, which is a problem for software designed with another X11 based phone stack in mind, or software which has been quickly ported from Linux desktop systems, because it will never bring up a keyboard for (possibly important) keystroke information. It is also possible that the keyboard could be brought or remain up by accident when you don't want it there, or even software specifically designed with this functionality in mind may occasionally fail or become confused when an on screen keyboard is supposed to be available.

See Om2008.8 Keyboard for details of the Om 2008.8 keyboard's usage.

Alternatives

Alternatively, you can try connecting a bluetooth keyboard or USB keyboard (Only available with a special cable, or an extra special cable in the case of the older unpowered USB units.)

Reactivating the keyboard toggle under Om 2008.8

For advanced users using the Om 2008.8 distribution, it may be worth your while to change the E17 theme information which prevents the 'qwerty' link in the upper left from showing.

On the phone

Method 1

Simply install the illume-config theme:

opkg install illume-config

Method 2

Install the tools required to decompile and recompile E17 theme code.

opkg install libevas-saver-png edje-utils cpp cpp-symlinks libembryo-tests

Decompile the theme, and edit the edc file

cd /usr/share/enlightenment/data/themes
edje_decc illume.edj
cd illume
vi freerunner.edc

Search for the text 'qwerty'. This should take you to the section which defines the small 'qwerty' button in the upper left.

  • Under 'part { name: "kbd";' change 'visible 0;' to 'visible 1;', and change 'relative: 0.0 1.0; ' to 'relative: 1.0 1.0; '
  • Under 'part { name: "kbdtext";' change 'visible 0;' to 'visible 1;'

And then recompile the .edj

sh build.sh
mv illume.edj ../illume.edj

And finally restart X to take new theme in use

/etc/init.d/xserver-nodm restart

Building a custom package

If that doesn't work, follow the instructions on building Om 2008.8 from source. Unpack the source for the package 'illume-theme', edit its edc file using the same method described above, and then finish building the ipk. You should be able to install this ipk, overiding the previous configuration.

Upgrading

If you upgrade, such as with opkg upgrade, you may have to perform the modification again.

If you've upgraded to a 2008.8-updates you need to make sure that the keyboard is enabled in illume-config.

  • Install illume-config to get the illume configuration screen (the "wrench" )
  • From the configuration page select "Keyboard"
  • Select "Default"