This is a Sinclair QL Keyboard USB Interface using a Teensy USB Development board.
The keyboard is connected by two ribbon cables in a 9 x 11 matrix. The main keyboard uses rows 1 to 8 and columns 3 to 10. The modifier keys,
alt have a dedicated row, 9, which is used with columns 1, 2 and 11.
Note that the QL Technical Manual has a number of errors in the keyboard matrix diagram. Corrections to the original version are highlighted in yellow.
The physical interface is a simple design, with the QL ribbon connectors, the Teensy board, and some diodes to ensure keys can’t cross interfere.
The rows act as outputs, connected across the diodes to pins 14 to 22, and the columns act as inputs connected directly to pins 1 to 11.
I carried out some initial prototyping using a breadboard circuit. However, this was too tall to fit inside the QL case, so I moved to a hand soldered prototype circuit board.
The keyboard program runs on the Teensy and makes it look like a regular USB keyboard to the attached computer.
The inputs are set to a
high state by default. The program loop outputs a
low on each row pin in turn. When the key is pressed, this will pull the relevant input column
The USB key scancodes are stored in an array, and sent when the relevant key matrix position is pressed.
The QL keyboard is missing a number of keys found on a PC keyboard, so some combinations have been added to simulate missing keys and combinations.
- CTRL LEFT = BACKSPACE
- CTRL RIGHT = DELETE
- ALT LEFT = HOME
- ALT RIGHT = END
- ALT UP = PAGE UP
- ALT DOWN = PAGE DOWN
- CTRL ALT RIGHT = CTRL ALT DEL
- ALT F5 = SUPER (Windows) Key
- ALT 4 = RIGHT-ALT 4 – Euro sign on UK Keyboard
- ALT A E I O U = RIGHT-ALT A E I O U – This is useful to me for Irish keyboard layout
The QL keyboard has swapped the positions of @ and “, and # and £ compared to a normal UK layout. I’ve considered swapping these in the keyboard, but I think it would be better to handle these by remapping on the PC side, if desired. Please open an issue if you think I should change this, or would like mappings I’ve missed.
A number of features are planned for the future.
Although the USB interface is useful for modern computers, many retro computers support PS/2 keyboards. This would be especially useful for controlling new QL variants, most notably the Q68.
The Teensy board 24 digital IO pins (there some extra ones that could potentially be used, but they require soldering onto pads on the back of the board). 20 of these are needed for the QL keyboard ribbon connectors. Pin 13 controls the on board LED, which limits it’s use, but 3 are still available. For PS/2, only 2 IO pins are required, for clock and data, so it should be straightforward to build the physical interface. Some work would be needed to develop the software, which sends scancodes in a very different way to the USB interface. PS2 also uses completely different scancodes to USB, so those would need to be set up.
When the design is finalised, I would like to get it produced as a proper printed circuit board. I will share the PCB design, and will be happy to offer a limited number of boards to other people.