Remapping the Keyboard with KeyHelper

[qx773]

The KeyHelper program lets you customize the SL-C750 and SL-C760 and SL-C860 keyboards.  You can get it from:

http://yakty.s31.xrea.com/cgi-bin/misc/dl....1.1.2-1_arm.ipk


The accompanying Key Helper Keycode Configuration program lets you get the character codes and xml codes to modify the keyhelper.xml file to remap your keyboard:

http://yakty.s31.xrea.com/cgi-bin/misc/dl....0.3.0-1_arm.ipk


Main Keyhelper page:

http://yakty.s31.xrea.com/linuzau/keyhelper

You can use Babelfish to translate the main page from Japanese:

http://babelfish.altavista.com


You put the keyhelper.conf file in your /home/zaurus/Settings folder.  When you enter the terminal, you are already in the /home/zaurus folder, just above the Settings folder.  Here is my keyhelper.conf file:

Code: [Select]

[Global]

[Launch]

K = Applications/embeddedkonsole

M = Applications/textedit

N = Applications/netfront3

T = Applications/todo

V = theKompany.com/tkcVox_c700

The folder names correspond to the paths:

/home/QtPalmtop/apps/Applications
/home/QtPalmtop/apps/theKompany.com

You can hold down the Home key on the Zaurus keyboard and then a letter to launch an application associated with that letter.  For example, with the keyhelper.conf file above, you can press Home T to launch the ToDo application.

You also put a second file named keyhelper.xml in your /home/zaurus/Settings folder.  Here is mine, based on someone else\'s and then customized after using the KeyHelperConf program to copy the appropriate codes into the clipboard, then using vi to edit the keyhelper.xml file and inserting the clipboard contents by entering insert mode with the letter i and then clicking on the paste icon near the top of the terminal window:

Code: [Select]









  

      

  



  

      

  



  

  





  









  

  



  

      



  

      



  

    

  



  

      

      



  

      

      



  

      

      



  

      

      



  

      



  

      



  

      

  

      

      

  

      

      



  

      



  

      







  







  

      

  



  

      

  



  

      

  





Whenever you modify your keyhelper configuration files, run:

khctl reload

to reload the configuration files.  The KeyHelperConf program will stop responding if it is open when you reload the configuration files with the khctl program, so you will have to close the KeyHelperConf program.

[zbones]

Thank you so much for drawing my attention to this neat program  

This is just what I have been looking for!

I have been trying to work out how to \"undo\" the fn 5 = euro default setting for the cacko rom, this undoes all the cacko keymaps and allows me to set my own.  It is also great to finally be able to make use out of the kanji keys.

Peter.

[qx773]

You\'re welcome.  I first became aware of KeyHelper when I was searching on a different topic and found a reference to the program on:

http://viz.aset.psu.edu/ga5in/SharpZaurus.html

There is some other interesting Zaurus-related information on that site.

[2devnull]

can we put this in the How To or FAQ?

[holck]

can we put this in the How To or FAQ?

That would be nice - including keyhelper.xml files for different languages - I have a good one for Danish. /Jesper

[qx773]

I\'ve settled on a new keyhelper.xml configuration which lets you use the Menu key to select which running application that you want to run.  Just press the Menu key repeatedly until the program that you want to switch to is highlighted, then press the OK button or the Enter key.  The OK button is easier, since it is closer to the Menu key.  I discovered that you can press Shift Menu to get the original Menu key functionality, which would open up the application\'s menu at the top of the screen.  The second Japanese key to the right of the Fn key is now used for launching an application by pressing the Japanese key and then a letter specified in the keyhelper.conf file.  The following file belongs in

/home/zaurus/Settings/keyhelper.xml

You have to run

khctl reload

after modifying or replacing the keyhelper.xml file.

Code: [Select]









  

      

  



  

  



  









  

  



  

      



  

      



  

    

  



  

      

      



  

      

      



  

      

      



  

      

      



  

      

      



  

      



  

      



  

      

  

      

      

  

      

      



  

      



  

      







  













  

  



  

      

  





[.mau.]

Excuse me for the maybe dumb question: where may I find the key names and codes?
I thought that code=\"20xx\" meant Fn-xx, where xx is the ordinal number of the key: from the examples, 2015 is Fn-o and 2016 is Fn-p, but Fn-q is 2014 !!
Ditto for the names: on Fn-I my C860/Cacko-1.20 does not show the sterling key, but something like _| . (Mapping is \"English\")
TIA, .mau.

(update: I found out these mappings:
code 2014 = Fn-q
code 2015 = Fn-o
code 2016 = Fn-e
code 2017 = Fn-a
code 2018 = Fn-s
code 2019 = Fn-n
code 201a = Fn-m
code 2022 = Fn-k

key cent = Fn-u
key yen = Fn-d
key sterling = Fn-i )

[fu-ga-zi]

@qx773:

Thanks a lot for the hint to swap / and , but the version you gave does not work for me:

<!-- swap / and , -->  
   <define key=\"Comma\">  
      <map key=\"Slash\"/>  
      <map_modifier Shift=\"On\"/>  
      <map_unicode shift_unicode=\"/\"/>  
   </define>  
   <define key=\"Slash\">  
      <modifier Shift=\"On\"/>  
      <map key=\"Comma\"/>  
      <map_modifier Shift=\"Off\"/>  
   </define>  
   <define key=\"Comma\">  
      <modifier Shift=\"On\"/>  
      <map key=\"Comma\"/>  
      <map_modifier Shift=\"Off\"/>  
   </define>  

Only when I delete the third <define...>...</define> pair it does.

Regards

Peter

[qx773]

I got that part from:

http://viz.aset.psu.edu/ga5in/SharpZaurus.html

I wondered why that third <define> was there, but it works for me, so I left it alone.

[qx773]

The KeyHelperConf program will produce the names and codes that correspond to the keys that you press.  I do not know where you can find a list of all of the key codes.  Perhaps the source code will show the names.

[maslovsky]

There is a problem with KeyHelper on Cacko ROM - it conflicts with the input method. This is important for those who uses different keyboard layouts and swicthes between them.

To fix the problem, I\'ve merged the capabilites of the latest version of KeyHelper program (1.1.5) into the input method used in Cacko ROM. Download, unzip the file attached to this thread and copy it into /home/QtPalmtop/plugins/inputmethods replacing the existing link. Restart Qtopia.

You can now uninstall KetHelper - all that it supports is now handled by the input method plugin. You may want to manualy  copy the khctl script from the KeyHelper package to be able to send commands to it.

This new applet will be included in the next version of Cacko ROM.

Enjoy!

[maslovsky]

The KeyHelperConf program will produce the names and codes that correspond to the keys that you press.  I do not know where you can find a list of all of the key codes.  Perhaps the source code will show the names.

yes, the names are in the source code for the KeyHelper program.

[.mau.]

I installed the updated version of libcyrinput, but it seems that the comma key always sends a slash! Since I did not change keyhelper.xml, I wonder what happened.

[maslovsky]

I installed the updated version of libcyrinput, but it seems that the comma key always sends a slash! Since I did not change keyhelper.xml, I wonder what happened.

Try to launch Settings/Keyboard, select english layout and clock OK

[.mau.]

I already selected it.
To be more precise, now I get comma holding the shift key, even if in keyhelper.xml I set up shift as a sticky key.
ciao, .mau.