User Tools

Site Tools


nonenglishchars

Non-English Character Support

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. 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(0x04)
Send HID Report 0x04 via USB/Bluetooth
OS receives report and does a Language Table Lookup
“A” printed on-screen

How to get non-English characters to print 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, 0x04 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 0x04 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.

Use the ANSI Keyboard Layout as your base.

Now compare it to your layout. In this example we will use a Ukrainian Layout.

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.

Last modified: 2016/03/11 08:52

Page Tools