The following is an expanded reworking of Fanoush's KBDD directions which I made principally for my own use a year or two ago. You may wish to extract from it anything further of use to you.

"After you have downloaded and extracted kbdd.tgz, you will have a resulting kbdd directory which contains the necessary files and scripts. Some of these will require manipulation, editing and/or execution, none of which is very complicated. For ease of any file modification, access via ssh is recommended. However, certain actions, especially execution, require initiation directly through xterm on the device. Where this is recommended or required, it will be mentioned in the appropriate instruction.

HOWTO

1. Copy kbdd.tgz to the device and extract it somewhere.

Nokia770-45:~# tar zxvf kbdd.tgz

Then cd to the newly-created directory, kbdd, and list the files (ls -la) within that directory so that you will be aware of what files it contains. Note that within the kbdd directory there is also a kbdd file, which you will later need to briefly refer to (via a "cat" command).

2. Utilizing the vi editor (or any other text editor you may have installed on the device) create or edit the btkbd.conf file found in your kbdd directory, in order to insert specific designations regarding the keyboard address and type relevant to your particular keyboard .

This file will look initially somewhat as follows (which you may first choose to examine via "cat" prior to bringing it up in your editor):

BDADDR="00:00:00:00:00:00"
KBTYPE=btfoldable
PORTNUM=2

Should there be any # designation before any of the above, you may safely remove it.

BDADDR is where you need to insert the keyboard address of your own particular keyboard. You can find this address by making your keyboard discoverable through pressing whatever button turns it on. (A LED should start blinking.) Then execute 'hcitool scan' as root or './btkbd scan' as user in the xterm for the appropriate address numbers to be shown. (If you attempt this via ssh, it probably won't work.) Then substitute those numbers for the zeros on the BDADDR line in the btkbd.conf file.

KBTYPE is kbdd keyboard type, and you will probably need to replace the btfoldable' designation. Execute a cat kbdd' command and scroll to the top for a listing of the keyboard types and appropriate designations in text form at the head of the file. Locate your particular keyboard in the list and as appropriate substitute its designation on the KBTYPE line in the btkbd.conf file. (Should your keyboard be a Freedom Bluetooth keyboard, the default is for a French keyboard layout. If you prefer an English/American keyboard layout, then download the separate binary, extract its kbdd file, and substitute that one for the current one.)

PORTNUM is bluetooth rfcomm port number on n770 side. Port 0 may be used
for your mobile phone so it's advisable to choose a number bigger than 0.

3. (Option A) If your method of gaining access to root is through the preferred sudo gainroot' command, make the keyboard discoverable again by turning it on and execute the btkbd script. Do not attempt to initiate this command vis ssh as it probably won't work.

Nokia770-45:~/kbdd# ./btkbd

Ascertain that the keyboard has accepted the connection. The LED may merely blink at a different frequency to show this, or it may require a "pairing" this first time. In such a case, a pop up dialog may be displayed on the N770 display after the btkbd command has been executed which may require some input from you.

3. (Option B) If your method of gaining access to root is instead through the sudo su' command, you must first make simple edits in the btkbd,' install_shortcut.sh' and remove_shortcut.sh' scripts. If such are required, merely substitute sudo su' for sudo gainroot' as appropriate. Then proceed to execute the btkbd command as described in (Option A) above.

4. Execute the btkbd script again to disconnect the keyboard. There should be some indication on the keyboard and/or on the screen that the connection has been terminated.

5. If the keyboard has thus successfully functioned, you can then add the menu shortcut. Just execute the install_shortcut.sh script from within the kbdd directory again not via ssh."

Good luck.