diff --git a/GRID 1550/1550 Keyboard Project.pdf b/GRID 1550/1550 Keyboard Project.pdf index 4d074fe..35f425f 100644 Binary files a/GRID 1550/1550 Keyboard Project.pdf and b/GRID 1550/1550 Keyboard Project.pdf differ diff --git a/GRID 1550/1550_PC_Version.ino b/GRID 1550/1550_PC_Version.ino new file mode 100644 index 0000000..306e1da --- /dev/null +++ b/GRID 1550/1550_PC_Version.ino @@ -0,0 +1,500 @@ +/* Copyright 2019 Frank Adams + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + http://www.apache.org/licenses/LICENSE-2.0 + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +*/ +// This software implements a GRID 1550 Laptop Keyboard Controller using a Teensy LC +// for use with a Windows PC. +// +// Revision History +// Initial Release Dec 12, 2019 - Created from Linux version, uses alt codes for \ and | which are not +// compatible with Linux +// +#define MODIFIERKEY_FN 0x8f // give Fn key a fake HID code +#define CAPS_LED 13 // Teensy LED on IO#13 shows Caps-Lock +#define NUM_LED 0 // Teensy IO#0 shows Num-Lock (wire to anode of new LED) +// +const byte rows_max = 11; // sets the number of rows in the matrix +const byte cols_max = 13; // sets the number of columns in the matrix +// +// Load the normal key matrix with the Teensyduino key names +// described at www.pjrc.com/teensy/td_keyboard.html +// A zero indicates no normal key at that location. +int normal[rows_max][cols_max] = { + {0,0,0,0,0,KEY_F1,KEY_F2,KEY_F3,KEY_F4,KEY_F5,0,KEY_F9,0}, + {0,0,0,0,KEY_SPACE,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,KEY_ESC,KEY_1,0,KEY_F6,KEY_F7,KEY_F8,KEY_F10,0}, + {0,0,0,0,0,KEY_TAB,KEY_Q,KEY_W,KEY_2,KEY_3,0,KEY_6,0}, + {0,0,0,0,0,KEY_CAPS_LOCK,KEY_A,KEY_S,KEY_E,KEY_4,KEY_5,KEY_7,0}, + {0,0,0,KEY_LEFT,0,0,0,KEY_Z,KEY_F,KEY_D,KEY_8,KEY_9,0}, + {0,0,0,KEY_DOWN,0,0,KEY_X,KEY_C,KEY_G,KEY_R,KEY_T,KEY_0,0}, + {0,0,0,KEY_NUM_LOCK,0,KEY_SCROLL_LOCK,KEY_V,KEY_B,KEY_H,KEY_Y,KEY_U,KEY_MINUS,0}, + {0,0,0,KEY_TILDE,0,KEY_UP,KEY_N,KEY_M,KEY_J,KEY_K,KEY_I,KEY_INSERT,0}, + {0,0,0,KEY_BACKSLASH,0,KEY_RIGHT_BRACE,KEY_COMMA,KEY_BACKSPACE,KEY_L,KEY_DELETE,KEY_O,KEY_EQUAL,0}, + {0,0,0,KEY_RIGHT,0,KEY_ENTER,KEY_SLASH,KEY_PERIOD,KEY_QUOTE,KEY_SEMICOLON,KEY_LEFT_BRACE,KEY_P,0} + +}; +// Load the numlock key matrix with key names at the correct row-column location. +// This matrix is the same as the normal matrix except for the number pad keys +// A zero indicates no numlock key at that location. +int numlock[rows_max][cols_max] = { + {0,0,0,0,0,KEY_F1,KEY_F2,KEY_F3,KEY_F4,KEY_F5,0,KEY_F9,0}, + {0,0,0,0,KEY_SPACE,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,KEY_ESC,KEY_1,0,KEY_F6,KEY_F7,KEY_F8,KEY_F10,0}, + {0,0,0,0,0,KEY_TAB,KEY_Q,KEY_W,KEY_2,KEY_3,0,KEY_6,0}, + {0,0,0,0,0,KEY_CAPS_LOCK,KEY_A,KEY_S,KEY_E,KEY_4,KEY_5,KEYPAD_7,0}, + {0,0,0,KEY_LEFT,0,0,0,KEY_Z,KEY_F,KEY_D,KEYPAD_8,KEYPAD_9,0}, + {0,0,0,KEY_DOWN,0,0,KEY_X,KEY_C,KEY_G,KEY_R,KEY_T,KEYPAD_ASTERIX,0}, + {0,0,0,KEY_NUM_LOCK,0,KEY_SCROLL_LOCK,KEY_V,KEY_B,KEY_H,KEY_Y,KEYPAD_4,KEY_MINUS,0}, + {0,0,0,KEY_TILDE,0,KEY_UP,KEY_N,KEY_M,KEYPAD_1,KEYPAD_2,KEYPAD_5,KEY_INSERT,0}, + {0,0,0,KEY_BACKSLASH,0,KEY_RIGHT_BRACE,KEYPAD_0,KEY_BACKSPACE,KEYPAD_3,KEY_DELETE,KEYPAD_6,KEY_EQUAL,0}, + {0,0,0,KEY_RIGHT,0,KEY_ENTER,KEYPAD_SLASH,KEYPAD_PERIOD,KEY_QUOTE,KEYPAD_PLUS,KEY_LEFT_BRACE,KEYPAD_MINUS,0} + +}; +// Load the modifier key matrix with key names at the correct row-column location. +// A zero indicates no modifier key at that location. +int modifier[rows_max][cols_max] = { + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {MODIFIERKEY_LEFT_SHIFT,MODIFIERKEY_FN,MODIFIERKEY_RIGHT_SHIFT,0,0,0,0,0,0,0,0,0,MODIFIERKEY_LEFT_ALT}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,MODIFIERKEY_LEFT_CTRL,0,0,0,0,0,0,0}, + {0,0,0,0,0,MODIFIERKEY_RIGHT_ALT,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0} + +}; +// Load the media key matrix with Fn key names at the correct row-column location. +// A zero indicates no media key at that location. +int media[rows_max][cols_max] = { + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,KEY_HOME,0,0,0,0,0,0,0,0,0}, + {0,0,0,KEY_PAGE_DOWN,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,KEY_PAUSE,0,0,0,0,0,0,0}, + {0,0,0,0,0,KEY_PAGE_UP,0,0,0,0,0,KEY_F11,0}, + {0,0,0,0,0,0,0,0,0,KEY_F12,0,0,0}, + {0,0,0,KEY_END,0,0,0,0,0,0,0,0,0} + +}; +// Initialize the old_key matrix with one's. +// 1 = key not pressed, 0 = key is pressed +boolean old_key[rows_max][cols_max] = { + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1} + +}; +// +// Define the Teensy LC I/O numbers (translated from the FPC pin #) +// Row FPC pin # 04,06,08,10,12,14,16,18,20,22,24 +// Teensy I/O # 01,02,03,04,05,06,07,08,09,10,11 +int Row_IO[rows_max] = {1,2,3,4,5,6,7,8,9,10,11}; // Teensy LC I/O numbers for rows +// +// Column FPC pin # 01,03,05,07,09,11,13,15,17,19,21,23,26 +// Teensy I/O # 23,22,24,21,25,20,19,18,17,16,15,14,12 +int Col_IO[cols_max] = {23,22,24,21,25,20,19,18,17,16,15,14,12}; // Teensy LC I/O numbers for columns + +// Declare variables that will be used by functions +boolean slots_full = LOW; // Goes high when slots 1 thru 6 contain normal keys +// slot 1 thru slot 6 hold the normal key values to be sent over USB. +int slot1 = 0; //value of 0 means the slot is empty and can be used. +int slot2 = 0; +int slot3 = 0; +int slot4 = 0; +int slot5 = 0; +int slot6 = 0; +// +int mod_shift_l = 0; // These variables are sent over USB as modifier keys. +int mod_shift_r = 0; // Each is either set to 0 or MODIFIER_ ... +int mod_ctrl_l = 0; +int mod_ctrl_r = 0; +int mod_alt_l = 0; +int mod_alt_r = 0; +int mod_gui = 0; +// +// Function to load the key name into the first available slot +void load_slot(int key) { + if (!slot1) { + slot1 = key; + } + else if (!slot2) { + slot2 = key; + } + else if (!slot3) { + slot3 = key; + } + else if (!slot4) { + slot4 = key; + } + else if (!slot5) { + slot5 = key; + } + else if (!slot6) { + slot6 = key; + } + if (!slot1 || !slot2 || !slot3 || !slot4 || !slot5 || !slot6) { + slots_full = LOW; // slots are not full + } + else { + slots_full = HIGH; // slots are full + } +} +// +// Function to clear the slot that contains the key name +void clear_slot(int key) { + if (slot1 == key) { + slot1 = 0; + } + else if (slot2 == key) { + slot2 = 0; + } + else if (slot3 == key) { + slot3 = 0; + } + else if (slot4 == key) { + slot4 = 0; + } + else if (slot5 == key) { + slot5 = 0; + } + else if (slot6 == key) { + slot6 = 0; + } + if (!slot1 || !slot2 || !slot3 || !slot4 || !slot5 || !slot6) { + slots_full = LOW; // slots are not full + } + else { + slots_full = HIGH; // slots are full + } +} +// +// Function to load the modifier key name into the appropriate mod variable +void load_mod(int m_key) { + if (m_key == MODIFIERKEY_LEFT_SHIFT) { + mod_shift_l = m_key; + } + else if (m_key == MODIFIERKEY_RIGHT_SHIFT) { + mod_shift_r = m_key; + } + else if (m_key == MODIFIERKEY_LEFT_CTRL) { + mod_ctrl_l = m_key; + } + else if (m_key == MODIFIERKEY_RIGHT_CTRL) { + mod_ctrl_r = m_key; + } + else if (m_key == MODIFIERKEY_LEFT_ALT) { + mod_alt_l = m_key; + } + else if (m_key == MODIFIERKEY_RIGHT_ALT) { + mod_alt_r = m_key; + } + else if (m_key == MODIFIERKEY_GUI) { + mod_gui = m_key; + } +} +// +// Function to load 0 into the appropriate mod variable +void clear_mod(int m_key) { + if (m_key == MODIFIERKEY_LEFT_SHIFT) { + mod_shift_l = 0; + } + else if (m_key == MODIFIERKEY_RIGHT_SHIFT) { + mod_shift_r = 0; + } + else if (m_key == MODIFIERKEY_LEFT_CTRL) { + mod_ctrl_l = 0; + } + else if (m_key == MODIFIERKEY_RIGHT_CTRL) { + mod_ctrl_r = 0; + } + else if (m_key == MODIFIERKEY_LEFT_ALT) { + mod_alt_l = 0; + } + else if (m_key == MODIFIERKEY_RIGHT_ALT) { + mod_alt_r = 0; + } + else if (m_key == MODIFIERKEY_GUI) { + mod_gui = 0; + } +} +// +// Function to send the modifier keys over usb +void send_mod() { + Keyboard.set_modifier(mod_shift_l | mod_shift_r | mod_ctrl_l | mod_ctrl_r | mod_alt_l | mod_alt_r | mod_gui); + Keyboard.send_now(); +} +// +// Function to send the normal keys in the 6 slots over usb +void send_normals() { + Keyboard.set_key1(slot1); + Keyboard.set_key2(slot2); + Keyboard.set_key3(slot3); + Keyboard.set_key4(slot4); + Keyboard.set_key5(slot5); + Keyboard.set_key6(slot6); + Keyboard.send_now(); +} +// +// Function to set a pin to high impedance (acts like open drain output) +void go_z(int pin) +{ + pinMode(pin, INPUT); + digitalWrite(pin, HIGH); +} +// +// Function to set a pin as an input with a pullup +void go_pu(int pin) +{ + pinMode(pin, INPUT_PULLUP); + digitalWrite(pin, HIGH); +} +// +// Function to send a pin to a logic low +void go_0(int pin) +{ + pinMode(pin, OUTPUT); + digitalWrite(pin, LOW); +} +// +// Function to send a pin to a logic high +void go_1(int pin) +{ + pinMode(pin, OUTPUT); + digitalWrite(pin, HIGH); +} +// +//----------------------------------Setup------------------------------------------- +void setup() { + for (int a = 0; a < cols_max; a++) { // loop thru all column pins + go_pu(Col_IO[a]); // set each column pin as an input with a pullup + } +// + for (int b = 0; b < rows_max; b++) { // loop thru all row pins + go_z(Row_IO[b]); // set each row pin as a floating output + } +} +// +boolean Fn_pressed = HIGH; // Initialize Fn key to HIGH = "not pressed" +extern volatile uint8_t keyboard_leds; // 8 bits sent from Pi to Teensy that give keyboard LED status. Caps lock is bit D1. +// +//---------------------------------Main Loop--------------------------------------------- +// +void loop() { +// Scan keyboard matrix with an outer loop that drives each row low and an inner loop that reads every column (with pull ups). +// The routine looks at each key's present state (by reading the column input pin) and also the previous state from the last scan +// that was 30msec ago. The status of a key that was just pressed or just released is sent over USB and the state is saved in the old_key matrix. +// The keyboard keys will read as logic low if they are pressed (negative logic). +// The old_key matrix also uses negative logic (low=pressed). +// + for (int x = 0; x < rows_max; x++) { // loop thru the rows + go_0(Row_IO[x]); // Activate Row (send it low) + delayMicroseconds(10); // give the row time to go low and settle out + for (int y = 0; y < cols_max; y++) { // loop thru the columns +// **********Modifier keys including the Fn special case + if (modifier[x][y] != 0) { // check if modifier key exists + if (!digitalRead(Col_IO[y]) && (old_key[x][y])) { // Read column to see if key is low (pressed) and was previously not pressed + if (modifier[x][y] != MODIFIERKEY_FN) { // Exclude Fn modifier key + if (Fn_pressed) { // only send modifier keys if Fn key is not currently held down + load_mod(modifier[x][y]); // function reads which modifier key is pressed and loads it into the appropriate mod_... variable + send_mod(); // function sends the state of all modifier keys over usb including the one that just got pressed + old_key[x][y] = LOW; // Save state of key as "pressed" + } + else { // Fn key is already held down so check if right alt key is pressed and send print screen if yes + if (modifier[x][y] == MODIFIERKEY_RIGHT_ALT) { + Keyboard.press(KEY_PRINTSCREEN); + delay(5); + Keyboard.release(KEY_PRINTSCREEN); + delay(5); + } + } + } + else { + Fn_pressed = LOW; // Fn status variable is active low + old_key[x][y] = LOW; // old_key state is "pressed" (active low) + } + } + else if (digitalRead(Col_IO[y]) && (!old_key[x][y])) { //check if key is not pressed and was previously pressed + if (modifier[x][y] != MODIFIERKEY_FN) { // Exclude Fn modifier key + clear_mod(modifier[x][y]); // function reads which modifier key was released and loads 0 into the appropriate mod_... variable + send_mod(); // function sends all mod's over usb including the one that just released + old_key[x][y] = HIGH; // Save state of key as "not pressed" + } + else { + Fn_pressed = HIGH; // Fn is no longer active + old_key[x][y] = HIGH; // old_key state is "not pressed" + } + } + } +// ***********end of modifier section +// +// ***********Normal keys and media keys in this section + else if ((normal[x][y] != 0) || (media[x][y] != 0)) { // check if normal or media key exists at this location in the array + if (!digitalRead(Col_IO[y]) && (old_key[x][y]) && (!slots_full)) { // check if key pressed and not previously pressed and slots not full + old_key[x][y] = LOW; // Save state of key as "pressed" + if (Fn_pressed) { // Fn_pressed is active low so it is not pressed and normal key needs to be sent + if (keyboard_leds & 1) { // test if Num Lock is turned on + load_slot(numlock[x][y]); //update first available slot with key name from numlock matrix + send_normals(); // send all slots over USB including the key that just got pressed + } + else { + load_slot(normal[x][y]); //update first available slot with key name from normal matrix + send_normals(); // send all slots over USB including the key that just got pressed + } + } + else if (media[x][y] != 0) { // Fn is pressed so send media if a key exists in the matrix + Keyboard.press(media[x][y]); // media key is sent using keyboard press function per PJRC + delay(5); // delay 5 milliseconds before releasing to make sure it gets sent over USB + Keyboard.release(media[x][y]); // send media key release + } + else if (normal[x][y] == KEY_Z) { // Fn is pressed but no media key so check if KEY_Z is pressed +// if using this keyboard on a Raspberry Pi, comment out the following Alt code section and uncomment the unicode section +// *******Windows PC Alt Code sequence to give a backslash is Alt 92******************************* + Keyboard.press(MODIFIERKEY_LEFT_ALT); // Push and hold Left Alt + delay(5); + Keyboard.press(KEYPAD_9); // Push 9 + delay(5); + Keyboard.release(KEYPAD_9); // Release 9 + delay(5); + Keyboard.press(KEYPAD_2); // Push 2 + delay(5); + Keyboard.release(KEYPAD_2); // Release 2 + delay(5); + Keyboard.release(MODIFIERKEY_LEFT_ALT); // Release Left Alt + delay(5); +// *******Raspberry Pi Unicode sequence to give a backslash is Control+Shift+u 5c Enter***************************** +/* Keyboard.press(MODIFIERKEY_LEFT_CTRL); // Push and hold Left Control + delay(5); + Keyboard.press(MODIFIERKEY_LEFT_SHIFT); // Push and hold Left Shift + delay(5); + Keyboard.press(KEY_U); // Push u + delay(5); + Keyboard.release(KEY_U); // Release u + delay(5); + Keyboard.release(MODIFIERKEY_LEFT_CTRL); // Release Left Control + delay(5); + Keyboard.release(MODIFIERKEY_LEFT_SHIFT); // Release Left Shift + delay(5); + Keyboard.press(KEY_5); // Push 5 + delay(5); + Keyboard.release(KEY_5); // Release 5 + delay(5); + Keyboard.press(KEY_C); // Push c + delay(5); + Keyboard.release(KEY_C); // Release c + delay(5); + Keyboard.press(KEY_ENTER); // Push Enter + delay(5); + Keyboard.release(KEY_ENTER); // Release Enter + delay(5); +*/ + } + else if (normal[x][y] == KEY_X) { // Fn is pressed but no media key so check if KEY_X is pressed +// if using this keyboard on a Raspberry Pi, comment out the following Alt code section and uncomment the unicode section +// *******Windows PC Alt Code sequence to give a | is Alt 124******************************* + Keyboard.press(MODIFIERKEY_LEFT_ALT); // Push and hold Left Alt + delay(5); + Keyboard.press(KEYPAD_1); // Push 1 + delay(5); + Keyboard.release(KEYPAD_1); // Release 1 + delay(5); + Keyboard.press(KEYPAD_2); // Push 2 + delay(5); + Keyboard.release(KEYPAD_2); // Release 2 + delay(5); + Keyboard.press(KEYPAD_4); // Push 4 + delay(5); + Keyboard.release(KEYPAD_4); // Release 4 + delay(5); + Keyboard.release(MODIFIERKEY_LEFT_ALT); // Release Left Alt + delay(5); +// *******Raspberry Pi Unicode sequence to give a | is Control+Shift+u 7c Enter***************************** +/* Keyboard.press(MODIFIERKEY_LEFT_CTRL); // Push and hold Left Control + delay(5); + Keyboard.press(MODIFIERKEY_LEFT_SHIFT); // Push and hold Left Shift + delay(5); + Keyboard.press(KEY_U); // Push u + delay(5); + Keyboard.release(KEY_U); // Release u + delay(5); + Keyboard.release(MODIFIERKEY_LEFT_CTRL); // Release Left Control + delay(5); + Keyboard.release(MODIFIERKEY_LEFT_SHIFT); // Release Left Shift + delay(5); + Keyboard.press(KEY_7); // Push 7 + delay(5); + Keyboard.release(KEY_7); // Release 7 + delay(5); + Keyboard.press(KEY_C); // Push c + delay(5); + Keyboard.release(KEY_C); // Release c + delay(5); + Keyboard.press(KEY_ENTER); // Push Enter + delay(5); + Keyboard.release(KEY_ENTER); // Release Enter + delay(5); +*/ + } + } + else if (digitalRead(Col_IO[y]) && (!old_key[x][y])) { //check if key is not pressed, but was previously pressed + old_key[x][y] = HIGH; // Save state of key as "not pressed" + if (Fn_pressed) { // Fn is not pressed + if (keyboard_leds & 1) { // test if Num Lock is turned on + clear_slot(numlock[x][y]); //clear slot with key name from numlock matrix + send_normals(); // send all slots over USB including the key that just got released + } + else { + clear_slot(normal[x][y]); //clear slot with key name from normal matrix + send_normals(); // send all slots over USB including the key that just got released + } + } + } + } +// **************end of normal and media key section +// + } + go_z(Row_IO[x]); // De-activate Row (send it to hi-z) + } +// +// **********keyboard scan complete +// +// Turn on the LED on the Teensy for Caps Lock based on bit 1 in the keyboard_leds variable controlled by the USB host computer +// + if (keyboard_leds & 1<<1) { // mask off all bits but D1 and test if set + go_1(CAPS_LED); // turn on the LED + } + else { + go_0(CAPS_LED); // turn off the LED + } +// +// Turn on the LED on the Teensy for Num Lock based on bit 0 in the keyboard_leds variable controlled by the USB host computer +// + if (keyboard_leds & 1) { // mask off all bits but D0 and test if set + go_1(NUM_LED); // turn on the Num Lock LED + } + else { + go_0(NUM_LED); // turn off the Num Lock LED + } +// + delay(25); // The overall keyboard scanning rate is about 30ms +} diff --git a/GRID 1550/1550_Pi_Version.ino b/GRID 1550/1550_Pi_Version.ino new file mode 100644 index 0000000..154736b --- /dev/null +++ b/GRID 1550/1550_Pi_Version.ino @@ -0,0 +1,501 @@ +/* Copyright 2019 Frank Adams + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + http://www.apache.org/licenses/LICENSE-2.0 + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +*/ +// This software implements a GRID 1550 Laptop Keyboard Controller using a Teensy LC +// for use with a Raspberry Pi or similar Linux computer. +// +// Revision History +// Initial Release Sept 15, 2019 +// Revision Dec 8, 2019 - Increased delays from 5ms to 25ms for the Alt 92 key codes to give backslash +// Revision Dec 11, 2019 - Added Unicode method to give backslash and pipe since Alt codes don't work for Linux +// +#define MODIFIERKEY_FN 0x8f // give Fn key a fake HID code +#define CAPS_LED 13 // Teensy LED on IO#13 shows Caps-Lock +#define NUM_LED 0 // Teensy IO#0 shows Num-Lock (wire to anode of new LED) +// +const byte rows_max = 11; // sets the number of rows in the matrix +const byte cols_max = 13; // sets the number of columns in the matrix +// +// Load the normal key matrix with the Teensyduino key names +// described at www.pjrc.com/teensy/td_keyboard.html +// A zero indicates no normal key at that location. +int normal[rows_max][cols_max] = { + {0,0,0,0,0,KEY_F1,KEY_F2,KEY_F3,KEY_F4,KEY_F5,0,KEY_F9,0}, + {0,0,0,0,KEY_SPACE,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,KEY_ESC,KEY_1,0,KEY_F6,KEY_F7,KEY_F8,KEY_F10,0}, + {0,0,0,0,0,KEY_TAB,KEY_Q,KEY_W,KEY_2,KEY_3,0,KEY_6,0}, + {0,0,0,0,0,KEY_CAPS_LOCK,KEY_A,KEY_S,KEY_E,KEY_4,KEY_5,KEY_7,0}, + {0,0,0,KEY_LEFT,0,0,0,KEY_Z,KEY_F,KEY_D,KEY_8,KEY_9,0}, + {0,0,0,KEY_DOWN,0,0,KEY_X,KEY_C,KEY_G,KEY_R,KEY_T,KEY_0,0}, + {0,0,0,KEY_NUM_LOCK,0,KEY_SCROLL_LOCK,KEY_V,KEY_B,KEY_H,KEY_Y,KEY_U,KEY_MINUS,0}, + {0,0,0,KEY_TILDE,0,KEY_UP,KEY_N,KEY_M,KEY_J,KEY_K,KEY_I,KEY_INSERT,0}, + {0,0,0,KEY_BACKSLASH,0,KEY_RIGHT_BRACE,KEY_COMMA,KEY_BACKSPACE,KEY_L,KEY_DELETE,KEY_O,KEY_EQUAL,0}, + {0,0,0,KEY_RIGHT,0,KEY_ENTER,KEY_SLASH,KEY_PERIOD,KEY_QUOTE,KEY_SEMICOLON,KEY_LEFT_BRACE,KEY_P,0} + +}; +// Load the numlock key matrix with key names at the correct row-column location. +// This matrix is the same as the normal matrix except for the number pad keys +// A zero indicates no numlock key at that location. +int numlock[rows_max][cols_max] = { + {0,0,0,0,0,KEY_F1,KEY_F2,KEY_F3,KEY_F4,KEY_F5,0,KEY_F9,0}, + {0,0,0,0,KEY_SPACE,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,KEY_ESC,KEY_1,0,KEY_F6,KEY_F7,KEY_F8,KEY_F10,0}, + {0,0,0,0,0,KEY_TAB,KEY_Q,KEY_W,KEY_2,KEY_3,0,KEY_6,0}, + {0,0,0,0,0,KEY_CAPS_LOCK,KEY_A,KEY_S,KEY_E,KEY_4,KEY_5,KEYPAD_7,0}, + {0,0,0,KEY_LEFT,0,0,0,KEY_Z,KEY_F,KEY_D,KEYPAD_8,KEYPAD_9,0}, + {0,0,0,KEY_DOWN,0,0,KEY_X,KEY_C,KEY_G,KEY_R,KEY_T,KEYPAD_ASTERIX,0}, + {0,0,0,KEY_NUM_LOCK,0,KEY_SCROLL_LOCK,KEY_V,KEY_B,KEY_H,KEY_Y,KEYPAD_4,KEY_MINUS,0}, + {0,0,0,KEY_TILDE,0,KEY_UP,KEY_N,KEY_M,KEYPAD_1,KEYPAD_2,KEYPAD_5,KEY_INSERT,0}, + {0,0,0,KEY_BACKSLASH,0,KEY_RIGHT_BRACE,KEYPAD_0,KEY_BACKSPACE,KEYPAD_3,KEY_DELETE,KEYPAD_6,KEY_EQUAL,0}, + {0,0,0,KEY_RIGHT,0,KEY_ENTER,KEYPAD_SLASH,KEYPAD_PERIOD,KEY_QUOTE,KEYPAD_PLUS,KEY_LEFT_BRACE,KEYPAD_MINUS,0} + +}; +// Load the modifier key matrix with key names at the correct row-column location. +// A zero indicates no modifier key at that location. +int modifier[rows_max][cols_max] = { + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {MODIFIERKEY_LEFT_SHIFT,MODIFIERKEY_FN,MODIFIERKEY_RIGHT_SHIFT,0,0,0,0,0,0,0,0,0,MODIFIERKEY_LEFT_ALT}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,MODIFIERKEY_LEFT_CTRL,0,0,0,0,0,0,0}, + {0,0,0,0,0,MODIFIERKEY_RIGHT_ALT,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0} + +}; +// Load the media key matrix with Fn key names at the correct row-column location. +// A zero indicates no media key at that location. +int media[rows_max][cols_max] = { + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,0,0,0,0,0,0,0,0}, + {0,0,0,KEY_HOME,0,0,0,0,0,0,0,0,0}, + {0,0,0,KEY_PAGE_DOWN,0,0,0,0,0,0,0,0,0}, + {0,0,0,0,0,KEY_PAUSE,0,0,0,0,0,0,0}, + {0,0,0,0,0,KEY_PAGE_UP,0,0,0,0,0,KEY_F11,0}, + {0,0,0,0,0,0,0,0,0,KEY_F12,0,0,0}, + {0,0,0,KEY_END,0,0,0,0,0,0,0,0,0} + +}; +// Initialize the old_key matrix with one's. +// 1 = key not pressed, 0 = key is pressed +boolean old_key[rows_max][cols_max] = { + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1}, + {1,1,1,1,1,1,1,1,1,1,1,1,1} + +}; +// +// Define the Teensy LC I/O numbers (translated from the FPC pin #) +// Row FPC pin # 04,06,08,10,12,14,16,18,20,22,24 +// Teensy I/O # 01,02,03,04,05,06,07,08,09,10,11 +int Row_IO[rows_max] = {1,2,3,4,5,6,7,8,9,10,11}; // Teensy LC I/O numbers for rows +// +// Column FPC pin # 01,03,05,07,09,11,13,15,17,19,21,23,26 +// Teensy I/O # 23,22,24,21,25,20,19,18,17,16,15,14,12 +int Col_IO[cols_max] = {23,22,24,21,25,20,19,18,17,16,15,14,12}; // Teensy LC I/O numbers for columns + +// Declare variables that will be used by functions +boolean slots_full = LOW; // Goes high when slots 1 thru 6 contain normal keys +// slot 1 thru slot 6 hold the normal key values to be sent over USB. +int slot1 = 0; //value of 0 means the slot is empty and can be used. +int slot2 = 0; +int slot3 = 0; +int slot4 = 0; +int slot5 = 0; +int slot6 = 0; +// +int mod_shift_l = 0; // These variables are sent over USB as modifier keys. +int mod_shift_r = 0; // Each is either set to 0 or MODIFIER_ ... +int mod_ctrl_l = 0; +int mod_ctrl_r = 0; +int mod_alt_l = 0; +int mod_alt_r = 0; +int mod_gui = 0; +// +// Function to load the key name into the first available slot +void load_slot(int key) { + if (!slot1) { + slot1 = key; + } + else if (!slot2) { + slot2 = key; + } + else if (!slot3) { + slot3 = key; + } + else if (!slot4) { + slot4 = key; + } + else if (!slot5) { + slot5 = key; + } + else if (!slot6) { + slot6 = key; + } + if (!slot1 || !slot2 || !slot3 || !slot4 || !slot5 || !slot6) { + slots_full = LOW; // slots are not full + } + else { + slots_full = HIGH; // slots are full + } +} +// +// Function to clear the slot that contains the key name +void clear_slot(int key) { + if (slot1 == key) { + slot1 = 0; + } + else if (slot2 == key) { + slot2 = 0; + } + else if (slot3 == key) { + slot3 = 0; + } + else if (slot4 == key) { + slot4 = 0; + } + else if (slot5 == key) { + slot5 = 0; + } + else if (slot6 == key) { + slot6 = 0; + } + if (!slot1 || !slot2 || !slot3 || !slot4 || !slot5 || !slot6) { + slots_full = LOW; // slots are not full + } + else { + slots_full = HIGH; // slots are full + } +} +// +// Function to load the modifier key name into the appropriate mod variable +void load_mod(int m_key) { + if (m_key == MODIFIERKEY_LEFT_SHIFT) { + mod_shift_l = m_key; + } + else if (m_key == MODIFIERKEY_RIGHT_SHIFT) { + mod_shift_r = m_key; + } + else if (m_key == MODIFIERKEY_LEFT_CTRL) { + mod_ctrl_l = m_key; + } + else if (m_key == MODIFIERKEY_RIGHT_CTRL) { + mod_ctrl_r = m_key; + } + else if (m_key == MODIFIERKEY_LEFT_ALT) { + mod_alt_l = m_key; + } + else if (m_key == MODIFIERKEY_RIGHT_ALT) { + mod_alt_r = m_key; + } + else if (m_key == MODIFIERKEY_GUI) { + mod_gui = m_key; + } +} +// +// Function to load 0 into the appropriate mod variable +void clear_mod(int m_key) { + if (m_key == MODIFIERKEY_LEFT_SHIFT) { + mod_shift_l = 0; + } + else if (m_key == MODIFIERKEY_RIGHT_SHIFT) { + mod_shift_r = 0; + } + else if (m_key == MODIFIERKEY_LEFT_CTRL) { + mod_ctrl_l = 0; + } + else if (m_key == MODIFIERKEY_RIGHT_CTRL) { + mod_ctrl_r = 0; + } + else if (m_key == MODIFIERKEY_LEFT_ALT) { + mod_alt_l = 0; + } + else if (m_key == MODIFIERKEY_RIGHT_ALT) { + mod_alt_r = 0; + } + else if (m_key == MODIFIERKEY_GUI) { + mod_gui = 0; + } +} +// +// Function to send the modifier keys over usb +void send_mod() { + Keyboard.set_modifier(mod_shift_l | mod_shift_r | mod_ctrl_l | mod_ctrl_r | mod_alt_l | mod_alt_r | mod_gui); + Keyboard.send_now(); +} +// +// Function to send the normal keys in the 6 slots over usb +void send_normals() { + Keyboard.set_key1(slot1); + Keyboard.set_key2(slot2); + Keyboard.set_key3(slot3); + Keyboard.set_key4(slot4); + Keyboard.set_key5(slot5); + Keyboard.set_key6(slot6); + Keyboard.send_now(); +} +// +// Function to set a pin to high impedance (acts like open drain output) +void go_z(int pin) +{ + pinMode(pin, INPUT); + digitalWrite(pin, HIGH); +} +// +// Function to set a pin as an input with a pullup +void go_pu(int pin) +{ + pinMode(pin, INPUT_PULLUP); + digitalWrite(pin, HIGH); +} +// +// Function to send a pin to a logic low +void go_0(int pin) +{ + pinMode(pin, OUTPUT); + digitalWrite(pin, LOW); +} +// +// Function to send a pin to a logic high +void go_1(int pin) +{ + pinMode(pin, OUTPUT); + digitalWrite(pin, HIGH); +} +// +//----------------------------------Setup------------------------------------------- +void setup() { + for (int a = 0; a < cols_max; a++) { // loop thru all column pins + go_pu(Col_IO[a]); // set each column pin as an input with a pullup + } +// + for (int b = 0; b < rows_max; b++) { // loop thru all row pins + go_z(Row_IO[b]); // set each row pin as a floating output + } +} +// +boolean Fn_pressed = HIGH; // Initialize Fn key to HIGH = "not pressed" +extern volatile uint8_t keyboard_leds; // 8 bits sent from Pi to Teensy that give keyboard LED status. Caps lock is bit D1. +// +//---------------------------------Main Loop--------------------------------------------- +// +void loop() { +// Scan keyboard matrix with an outer loop that drives each row low and an inner loop that reads every column (with pull ups). +// The routine looks at each key's present state (by reading the column input pin) and also the previous state from the last scan +// that was 30msec ago. The status of a key that was just pressed or just released is sent over USB and the state is saved in the old_key matrix. +// The keyboard keys will read as logic low if they are pressed (negative logic). +// The old_key matrix also uses negative logic (low=pressed). +// + for (int x = 0; x < rows_max; x++) { // loop thru the rows + go_0(Row_IO[x]); // Activate Row (send it low) + delayMicroseconds(10); // give the row time to go low and settle out + for (int y = 0; y < cols_max; y++) { // loop thru the columns +// **********Modifier keys including the Fn special case + if (modifier[x][y] != 0) { // check if modifier key exists + if (!digitalRead(Col_IO[y]) && (old_key[x][y])) { // Read column to see if key is low (pressed) and was previously not pressed + if (modifier[x][y] != MODIFIERKEY_FN) { // Exclude Fn modifier key + if (Fn_pressed) { // only send modifier keys if Fn key is not currently held down + load_mod(modifier[x][y]); // function reads which modifier key is pressed and loads it into the appropriate mod_... variable + send_mod(); // function sends the state of all modifier keys over usb including the one that just got pressed + old_key[x][y] = LOW; // Save state of key as "pressed" + } + else { // Fn key is already held down so check if right alt key is pressed and send print screen if yes + if (modifier[x][y] == MODIFIERKEY_RIGHT_ALT) { + Keyboard.press(KEY_PRINTSCREEN); + delay(5); + Keyboard.release(KEY_PRINTSCREEN); + delay(5); + } + } + } + else { + Fn_pressed = LOW; // Fn status variable is active low + old_key[x][y] = LOW; // old_key state is "pressed" (active low) + } + } + else if (digitalRead(Col_IO[y]) && (!old_key[x][y])) { //check if key is not pressed and was previously pressed + if (modifier[x][y] != MODIFIERKEY_FN) { // Exclude Fn modifier key + clear_mod(modifier[x][y]); // function reads which modifier key was released and loads 0 into the appropriate mod_... variable + send_mod(); // function sends all mod's over usb including the one that just released + old_key[x][y] = HIGH; // Save state of key as "not pressed" + } + else { + Fn_pressed = HIGH; // Fn is no longer active + old_key[x][y] = HIGH; // old_key state is "not pressed" + } + } + } +// ***********end of modifier section +// +// ***********Normal keys and media keys in this section + else if ((normal[x][y] != 0) || (media[x][y] != 0)) { // check if normal or media key exists at this location in the array + if (!digitalRead(Col_IO[y]) && (old_key[x][y]) && (!slots_full)) { // check if key pressed and not previously pressed and slots not full + old_key[x][y] = LOW; // Save state of key as "pressed" + if (Fn_pressed) { // Fn_pressed is active low so it is not pressed and normal key needs to be sent + if (keyboard_leds & 1) { // test if Num Lock is turned on + load_slot(numlock[x][y]); //update first available slot with key name from numlock matrix + send_normals(); // send all slots over USB including the key that just got pressed + } + else { + load_slot(normal[x][y]); //update first available slot with key name from normal matrix + send_normals(); // send all slots over USB including the key that just got pressed + } + } + else if (media[x][y] != 0) { // Fn is pressed so send media if a key exists in the matrix + Keyboard.press(media[x][y]); // media key is sent using keyboard press function per PJRC + delay(5); // delay 5 milliseconds before releasing to make sure it gets sent over USB + Keyboard.release(media[x][y]); // send media key release + } + else if (normal[x][y] == KEY_Z) { // Fn is pressed but no media key so check if KEY_Z is pressed +// if using this keyboard on a Windows PC, uncomment the following Alt code section and comment out the unicode section +// *******Windows PC Alt Code sequence to give a backslash is Alt 92******************************* +/* Keyboard.press(MODIFIERKEY_LEFT_ALT); // Push and hold Left Alt + delay(5); + Keyboard.press(KEYPAD_9); // Push 9 + delay(5); + Keyboard.release(KEYPAD_9); // Release 9 + delay(5); + Keyboard.press(KEYPAD_2); // Push 2 + delay(5); + Keyboard.release(KEYPAD_2); // Release 2 + delay(5); + Keyboard.release(MODIFIERKEY_LEFT_ALT); Release Left Alt + delay(5); +*/ +// *******Raspberry Pi Unicode sequence to give a backslash is Control+Shift+u 5c Enter***************************** + Keyboard.press(MODIFIERKEY_LEFT_CTRL); // Push and hold Left Control + delay(5); + Keyboard.press(MODIFIERKEY_LEFT_SHIFT); // Push and hold Left Shift + delay(5); + Keyboard.press(KEY_U); // Push u + delay(5); + Keyboard.release(KEY_U); // Release u + delay(5); + Keyboard.release(MODIFIERKEY_LEFT_CTRL); // Release Left Control + delay(5); + Keyboard.release(MODIFIERKEY_LEFT_SHIFT); // Release Left Shift + delay(5); + Keyboard.press(KEY_5); // Push 5 + delay(5); + Keyboard.release(KEY_5); // Release 5 + delay(5); + Keyboard.press(KEY_C); // Push c + delay(5); + Keyboard.release(KEY_C); // Release c + delay(5); + Keyboard.press(KEY_ENTER); // Push Enter + delay(5); + Keyboard.release(KEY_ENTER); // Release Enter + delay(5); + } + else if (normal[x][y] == KEY_X) { // Fn is pressed but no media key so check if KEY_X is pressed +// if using this keyboard on a Windows PC, uncomment the following Alt code section and comment out the unicode section +// *******Windows PC Alt Code sequence to give a | is Alt 124******************************* +/* Keyboard.press(MODIFIERKEY_LEFT_ALT); // Push and hold Left Alt + delay(5); + Keyboard.press(KEYPAD_1); // Push 1 + delay(5); + Keyboard.release(KEYPAD_1); // Release 1 + delay(5); + Keyboard.press(KEYPAD_2); // Push 2 + delay(5); + Keyboard.release(KEYPAD_2); // Release 2 + delay(5); + Keyboard.press(KEYPAD_4); // Push 4 + delay(5); + Keyboard.release(KEYPAD_4); // Release 4 + delay(5); + Keyboard.release(MODIFIERKEY_LEFT_ALT); Release Left Alt + delay(5); +*/ +// *******Raspberry Pi Unicode sequence to give a | is Control+Shift+u 7c Enter***************************** + Keyboard.press(MODIFIERKEY_LEFT_CTRL); // Push and hold Left Control + delay(5); + Keyboard.press(MODIFIERKEY_LEFT_SHIFT); // Push and hold Left Shift + delay(5); + Keyboard.press(KEY_U); // Push u + delay(5); + Keyboard.release(KEY_U); // Release u + delay(5); + Keyboard.release(MODIFIERKEY_LEFT_CTRL); // Release Left Control + delay(5); + Keyboard.release(MODIFIERKEY_LEFT_SHIFT); // Release Left Shift + delay(5); + Keyboard.press(KEY_7); // Push 7 + delay(5); + Keyboard.release(KEY_7); // Release 7 + delay(5); + Keyboard.press(KEY_C); // Push c + delay(5); + Keyboard.release(KEY_C); // Release c + delay(5); + Keyboard.press(KEY_ENTER); // Push Enter + delay(5); + Keyboard.release(KEY_ENTER); // Release Enter + delay(5); + } + } + else if (digitalRead(Col_IO[y]) && (!old_key[x][y])) { //check if key is not pressed, but was previously pressed + old_key[x][y] = HIGH; // Save state of key as "not pressed" + if (Fn_pressed) { // Fn is not pressed + if (keyboard_leds & 1) { // test if Num Lock is turned on + clear_slot(numlock[x][y]); //clear slot with key name from numlock matrix + send_normals(); // send all slots over USB including the key that just got released + } + else { + clear_slot(normal[x][y]); //clear slot with key name from normal matrix + send_normals(); // send all slots over USB including the key that just got released + } + } + } + } +// **************end of normal and media key section +// + } + go_z(Row_IO[x]); // De-activate Row (send it to hi-z) + } +// +// **********keyboard scan complete +// +// Turn on the LED on the Teensy for Caps Lock based on bit 1 in the keyboard_leds variable controlled by the USB host computer +// + if (keyboard_leds & 1<<1) { // mask off all bits but D1 and test if set + go_1(CAPS_LED); // turn on the LED + } + else { + go_0(CAPS_LED); // turn off the LED + } +// +// Turn on the LED on the Teensy for Num Lock based on bit 0 in the keyboard_leds variable controlled by the USB host computer +// + if (keyboard_leds & 1) { // mask off all bits but D0 and test if set + go_1(NUM_LED); // turn on the Num Lock LED + } + else { + go_0(NUM_LED); // turn off the Num Lock LED + } +// + delay(25); // The overall keyboard scanning rate is about 30ms +}