TOHKBD FAQ
Frequently Asked Questions about TOHKBD
For Shortcuts and keycombinations look further in this answer.
Current version in store 0.5.23
Current version in OBS 0.5.23
Iijoki EA 2.1.0.9
For Early Adopters, a 2.1.0.9 rebuild is available from link below. It will be updateable through harbour when Iijoki goes public.
Up to date changelog can be found from tohkbd2 settings application about page, and from mer obs project
DEVELOPERS
If you want to contribute with keyboard layout, please start reading README here: https://github.com/kimmoli/tohkbd2/tree/master/user-daemon/config/layouts
- Q1: Why nothing happens when i attach TOH to the phone?
- Q2: Why the virtual keyboard does not disappear when i attach keyboard part?
- Q3: How can i install manually if my NFC does not work?
- Q4: I want the bleeding edge stuff, how do i get it?
- Q5: Why my ÅÄÖ does not work?
- Q6: I have AZERTY/QWERTZ layout, but i get qwerty characters when i type with it?
- Q10: The layout settings -option is grayed out in settings, why?
- Q13: Why the Symbols €, £ and µ doesn't work?
- Q7: Why it does not work in Android apps?
- Q8: I did back the Kickstarter project, when i get my tohkbd?
- Q9: Cool, this is so cool. How do i get one?
- Q11: My apps are in landscape even tohkbd is not attached, can you help?
- Q12: I dont remember what address i provided or what color combination i selected
- Q14: What if i ordered from funkyotherhalf.com ?
- Q15: How can i hide Fingerterm virtual keyboard?
- Q16: I want to use Fingerterm in position where keyboard does not block Flash but it wont turn, why?
- Q17: Keyboard keeps flashing backlight, and removed/connected notifications keep coming...
- Q18: Keyboard keeps repeating keys, not registering keypresses properly and all s#%¤ like that
- Q19: My TOHKBD does not start automatically anymore after reboot or when attaching TOH to phone
- Q20: The virtual keyboard was stuck on TOHKBD minimal layout after removing keyboard. How to restore?
- Q21: The ambience is installed, but why the keyboard does not start working when attaching TOH to phone? It works after rebooting phone.
- Q22: Why selected layout is not working in Android apps?
- Q23: When changing layout, first keypress is with previous layout
- Q24: Why some of the keys are not working properly? i can't type
@
or{
[
|
]
}
? - Q999: I have other question, where i can ask it?
Q1: Why nothing happens when i attach TOH to the phone?
A: You have issue with NFC, proceed with following:
- Check with original Jolla TOH that you hear sound when you attach
- Check from Jolla Settings -> System -> About product that you see The OtherHalf ID there
- Check that your tohd.service is not masked/disabled. First
devel-su
thensystemctl status tohd
should return green active (running) - If not, try
systemctl unmask tohd
thensystemctl enable tohd
thensystemctl start tohd
and re-attach TOH - If problem persists, and even original Jolla TOH's doesn't work, please contact care via this link: https://jolla.zendesk.com/hc/en-us/requests/new
Q2: Why the virtual keyboard does not disappear when i attach keyboard part?
A: Maliit server is not restarted. Reboot your phone, or systemctl --user restart maliit-server
Q3: How can i install manually if my NFC does not work?
Q4: I want the bleeding edge stuff, how do i get it?
A: Manual install instructionshere: https://github.com/kimmoli/tohkbd2#installing-through-mer-obs-repo
Note that when you install from mer-obs, you dont see it in Store -> My apps. The software for tohkbd is not available as a regular app in the store, it is ambience package which installs when you attach TOH to the phone.
Q5: Why my ÅÄÖ does not work?
Q6: I have AZERTY/QWERTZ layout, but i get qwerty characters when i type with it?
Q10: The layout settings -option is grayed out in settings, why?
Q13: Why the Symbols €, £ and µ doesn't work?
A: Jolla Sailfish 1.1.7. version (and older) does not support changing keyboard layout.(even it is in UI) We need to wait for sailfish update. Current layout does not support compose or special chars outside of pc-105 US layout. The settings are grayed out becaused they do not work yet.
Q7: Why it does not work in Android apps?
A: This does not work on Jolla Sailfish 1.1.6.27 version (and older). TOHKBD works with Android from 1.1.7.x and higher.
Q8: I did back the Kickstarter project, when i get my tohkbd?
A: There is no clear answer to this. There is a list of shipped orders according to Kickstarter backer number. If your number is not on the list, it is not shipped. Come to IRC to find out more. See here how to find backer number: https://together.jolla.com/question/96836/tohkbd-faq/?answer=96838#post-id-96838
Also, be aware that there seems to be some issues with emailing notifications of shipments, and you might not get such email.
Dirk did assembly most of the Scandic layout keyboards first, as the parts for them arrived first. Some of other layouts have also been arrived (at time of writing this). There is no specific order in which the manufacturing happens, it is basically controlled by the availability of material.
Also the shipment may take anything between 2 days to 2 weeks to arrive. Please be patient.
Q9: Cool, this is so cool. How do i get one?
A: Sorry, You are late, about 7 months. There are nothing left. All stocks are empty. Finito. Loppu. Slut. But keep your eyes open for if someone wants to sell his/hers ?
Q11: My apps are in landscape even tohkbd is not attached, can you help?
A: The landscape forcing logic might get stuck. Use following sequence if it happend:
- Go to TOHKBD Settings -> General settings, clear Force Landscape option.
- Disconnect TOH part from phone.
- Go to Jolla Settings -> System -> Display and change Orientation to Dynamic (propably it said Landscape?)
- Re-attach TOH
Q12: I dont remember what address i provided or what color combination i selected
A: See here how to find survey info from Kickstarter: https://together.jolla.com/question/96836/tohkbd-faq/?answer=96838#post-id-96838
Q14: What if i ordered from funkyotherhalf.com ?
A: Your order will be handled after the kickstarter orders, you will get a notification from the webshop when it is sent.
Q15: How can i hide Fingerterm virtual keyboard?
A: Fingerterm virtual keyboard can be hidden from Fingerterm menu, Top-right corner Hamburger-menu, VKB Behaviour Off
- Auto hiding coming (hopefully, PR is in)
Q16: I want to use Fingerterm in position where keyboard does not block Flash but it wont turn, why?
A: From SailfishOS version 1.1.9.28, Fingerterm rotates to both, Landscape and Inverted Landscape.
Unfortunately Fingerterm does not support Inverted Landscape. Silica version (not released) supports it, so again, patience.
Q17: Keyboard keeps flashing backlight, and removed/connected notifications keep coming...
Q18: Keyboard keeps repeating keys, not registering keypresses properly and all s#%¤ like that
A: Most propably the TOH contact pads needs to be cleaned. Easiest to do this is take TOH out from phone, take PCB out from 3d printed case (it is not fixed there so should pop out easily). Then use dry, clean paper towel/tissue and rub both of the 6-pad gold contact areas - specially the small grooves between the pads.
UPDATE Just confirmed that there seems to be RF field immunity issue when using 4G mobile data and keyboard is attached on left-side of the phone. As workaround, use 3G mobile data (or wifi) or attach keyboard on right-side of the phone.
Q19: My TOHKBD does not start automatically anymore after reboot or when attaching TOH to phone
A: Propably the TOH EEPROM contents has been corrupted.
If you have manually started daemon, please stop it systemctl stop harbour-tohkbd2
as root.
Then, keep TOH part attached to the phone, but not the kbd part, and follow instructions steps 1 to 6 on this wiki page [1]
In the EEPROM page you should see screen with following values: (if everything is ok)
Vendor ID: 1989
Product ID: 0003
Revision: 01
EEPROM Size: 0100
CFG Addr: 0040
CFG Size: 0010
UDATA Addr: 0080
UDATA Size: 0000
If all those values are correct, continue from step 14 from the wiki page. This was not the problem you had.
Typically corruption hits the first parameter(s), so you might see something like FF89
instead of 1989
. If values are incorrect, just tap and edit them to correct ones, then continue instructions from step 9 from the wiki page by writing values to EEPROM.
Now, reattach TOH part to the phone and check does the daemon start properly and does keyboard work. You can check daemon from tohkbd settings application, if About page shows version number for it, it is ok (Note that the version is read when settings app is started)
[1] = https://wiki.merproject.org/wiki/The_other_half#Use_the_I2CTool_to_write_EEPROM
Q20: The virtual keyboard was stuck on TOHKBD minimal layout after removing keyboard. How to restore?
A: If you have never set your virtual keyboard layout, the default is set by device language, but seems it is not available for TOHKBD in the way it checks it. Disconnect TOH from phone, and go to Jolla Settings > System > Text input and change the virtual keyboard layout to your preferred language (when stuck, it should show TOHKBD there)
Q21: The ambience is installed, but why the keyboard does not start working when attaching TOH to phone? It works after rebooting phone.
A: Maybe you are attaching TOH to phone wrong way... Attach TOH to phone correctly: Start by placing TOH on the USB connector end of phone, then snap it in place. This is to make the microswitch switch last, as the EEPROM is read by tohd
when microswitch is pressed. If it fails to read it (which may happen when starting from bottom edge) the daemon does not start.
Q22: Why selected layout is not working in Android apps?
A: On 1.1.9.28, the Sailfish started to support layout switching for physical keyboads. Unfortunately this change has no effect on Android apps, which still are US (QWERTY) only. Waiting for Sailfish update to fix this.
Meanwhile, community workaround is out there, which requires replacing file
/opt/alien/system/usr/keychars/Generic.kcm
with a custom one, and restart Android support.
DISCLAIMER These are courtesy of people in talk.maemo.org tohkbd2 thread, and IRC. I have not made these. I have not tested these (I do not use Android apps).
- qwertz http://www.file-upload.net/download-10910933/Generic.kcm.html
- azerty http://forum.xda-developers.com/attachment.php?attachmentid=1033639&d=1335828598
- spanish http://forum.xda-developers.com/attachment.php?attachmentid=1071555&d=1337463718
- scandic http://urjaman.dy.fi/Generic.kcm
DISCLAIMER You should really know what you are doing. TAKE BACKUP of original file before overwriting.
Note; You might also need to replace .kl file if such is provided in above links.
/opt/alien/system/usr/keylayout/Generic.kl
Q23: When changing layout, first keypress is with previous layout
A: This is a known issue, happens also with bluetooth keyboards. Mostly annoys people who switch between RU/EN layouts. Jolla knows about this but no ETA for fix.
Q24: Why some of the keys are not working properly? i can't type @
or {
[
|
]
}
?
A: There is still small issue with some symbols. This is caused by missingAltGr
key in one of the sailfish key mapping configuration files, boston.qmap.
While waiting Jolla to fix this, you can install fixed boston.qmap from OpenRepos: https://openrepos.net/content/kimmoli/boston-qmap-fix
Note, that you (most propably) need to re-install this after SFOS update.
UPDATE! Fixed boston.qmap is in SFOS update from 2.0.2.51. You'll need remove that OR package and re-install sbj-configs. For still unknown reason, OR package blocks it from updating the file, and reverts it to the older version.
Q999: I have other question, where i can ask it?
A: PLEASE come and chat with us in IRC freenode #jollatohkbd - for online client, click here
For those with non-functioning nfc (tohkbd and other toh's not seen by phone), see this for tricks to get it back working again (worked for me): https://together.jolla.com/question/73184/toh-not-installing-ambience/
(Though if you still have warranty, it may be a better idea to let care take care of it...)
ssahla ( 2015-06-21 00:40:08 +0200 )editMy keyboard is not detected. I have enabled the tohd service as described above (it was disabled because of crashes in some very old Sailfish version), and my original toh cover is detected properly (phone vibrates, switches theme, also displays toh id in About page). The keyboard toh is still not detected however. What else is there to try? The FAQ lacks an answer for "If problem persists, even though the original Jolla TOH's work" as far as I can tell?
EDIT: I looked at some images of the circuit board and it looks like there is something in the rectangle labeled NFC, but mine is just empty (both sides). Is there some kind of NFC sticker that should be there that is missing? Just a wild guess, but it looks like there are no connections to that area, so I guess NFC is just used to identify the TOH? (No, there is no loose NFC sticker or anything else loose in the box)?
EDIT2: Yes, it works with the manual installation instructions! Some odd things about the keys, but I guess that is related to other parts of the FAQ.
pellen ( 2015-06-26 11:54:38 +0200 )editWill functioning enter and backspace in terminal also have to wait for an OS upgrade? And in emacs (in terminal) it seems like Meta is permanently pressed?
pellen ( 2015-06-26 15:19:36 +0200 )editMaybe update Q8 with this (from IRC 2015-07-05):
urjaman ( 2015-07-06 02:47:54 +0200 )edit(somebody) what do you plan doing the next batch of scandinc layouts?
17:48 < dirkvl> this week
17:48 < dirkvl> probably
17:48 < dirkvl> well see how it goes
17:49 < dirkvl> 261 left
17:49 < dirkvl> like 16 stealth, which i dont have yet
17:49 < dirkvl> like 30 azerty, which is on hold till nex keypad batch
17:49 < dirkvl> rest is qwerty and scandic
17:50 < dirkvl> and maybe some qwertz
17:50 < dirkvl> ran out of brushed black, so have a pile of those that are just waiting on backplate
addition to Q6: I have QWERTZ layout,...? And I can use QWERTZ with driver 0.4.0 if I select "layout->QWERTZ". It is not grayed out. Makes typing easier for me. :-) Special characters like "ÄÖÜ" still not working, but lets wait for the next sailfishOS release.
jolladiho ( 2015-07-13 18:15:07 +0200 )edit