Using the Twiddler 3
Using the Twiddler 3
From the factory, the Twiddler3 supports all languages. Understanding why it has universal language support requires an understanding as to what the Twiddler3 is doing at a low level.
Simply put, the Twiddler3 sends HID codes (this concept is important). The Twiddler3 does not send letters, like “A”, or numbers line “1”, or symbols like “!”. Your OS handles the “presentation” part to print those characters on screen.
The flow looks something like this:
* Press 0 R000 on Twiddler
* Twiddler Firmware looks up chord in config file
* Found to be HID(004) (use decimal not hex)
* Send HID Report 004 via USB/Bluetooth
* OS receives HID Report 004 and does a Language Table Lookup
* “a” printed on-screen
You are going to need a few tools:
1) This is what your keyboard looks like to the OS:
You will notice some familiar notation on some keys like “TAB” and “ESC”. There are also keys that look just like a Row and Column notation. AC01 (Alpha, row C, position 01) is where the “A” key is on most keyboards. The number in the second row of all the keys is the HID Code. So when you type that key, in “A”'s case, HID 004 is sent to the OS. The OS then prints on screen the letter associated with that HID Code. You can silk screen whatever you want on the key cap, when the OS sees HID 004 it will print “a”.
2) USB HID Usage Tables
Download and go to page 53 of the HID Usage Table. It is a pretty long and boring document about HID. There you will see all of the HID Codes available. Notice that there are only “Latin” characters commonly found on a US Keyboard. HID does not specify anything other than what you see in the Usage Name column of that table. Support for non-English characters is handled at the OS level through your region settings and language tables.
3) Keyboard Compare
The quickest and easiest way to figure our how to print a non-English character is to find out what HID code you need to issue in order to get the OS to show that character onscreen.
If you check out this link. https://en.wikipedia.org/wiki/Keyboard_layout You will see a number of different layouts for different languages.
If you would like the Twiddler to print “Ф” find it on the Ukranian keyboard. Using the notion from above, it is located at position AC01. Map that to the ANSI Keyboard - which is “A”. This tells you to use the letter “A” in your chord.