1*93322749SSjoerd SimonsChromeOS EC Keyboard 2713cb680SHung-ying Tyan 3*93322749SSjoerd SimonsGoogle's ChromeOS EC Keyboard is a simple matrix keyboard implemented on 4*93322749SSjoerd Simonsa separate EC (Embedded Controller) device. It provides a message for reading 5*93322749SSjoerd Simonskey scans from the EC. These are then converted into keycodes for processing 6*93322749SSjoerd Simonsby the kernel. 7713cb680SHung-ying Tyan 8*93322749SSjoerd SimonsThis binding is based on matrix-keymap.txt and extends/modifies it as follows: 9713cb680SHung-ying Tyan 10713cb680SHung-ying TyanRequired properties: 11713cb680SHung-ying Tyan- compatible: "google,cros-ec-keyb" 12713cb680SHung-ying Tyan 13*93322749SSjoerd SimonsOptional properties: 14*93322749SSjoerd Simons- google,needs-ghost-filter: True to enable a ghost filter for the matrix 15*93322749SSjoerd Simonskeyboard. This is recommended if the EC does not have its own logic or 16*93322749SSjoerd Simonshardware for this. 17713cb680SHung-ying Tyan 18713cb680SHung-ying Tyan 19*93322749SSjoerd SimonsExample: 20713cb680SHung-ying Tyan 21713cb680SHung-ying Tyancros-ec-keyb { 22713cb680SHung-ying Tyan compatible = "google,cros-ec-keyb"; 23*93322749SSjoerd Simons keypad,num-rows = <8>; 24*93322749SSjoerd Simons keypad,num-columns = <13>; 25*93322749SSjoerd Simons google,needs-ghost-filter; 26713cb680SHung-ying Tyan /* 27713cb680SHung-ying Tyan * Keymap entries take the form of 0xRRCCKKKK where 28713cb680SHung-ying Tyan * RR=Row CC=Column KKKK=Key Code 29713cb680SHung-ying Tyan * The values below are for a US keyboard layout and 30713cb680SHung-ying Tyan * are taken from the Linux driver. Note that the 31713cb680SHung-ying Tyan * 102ND key is not used for US keyboards. 32713cb680SHung-ying Tyan */ 33713cb680SHung-ying Tyan linux,keymap = < 34713cb680SHung-ying Tyan /* CAPSLCK F1 B F10 */ 35*93322749SSjoerd Simons 0x0001003a 0x0002003b 0x00030030 0x00040044 36713cb680SHung-ying Tyan /* N = R_ALT ESC */ 37713cb680SHung-ying Tyan 0x00060031 0x0008000d 0x000a0064 0x01010001 38713cb680SHung-ying Tyan /* F4 G F7 H */ 39713cb680SHung-ying Tyan 0x0102003e 0x01030022 0x01040041 0x01060023 40713cb680SHung-ying Tyan /* ' F9 BKSPACE L_CTRL */ 41713cb680SHung-ying Tyan 0x01080028 0x01090043 0x010b000e 0x0200001d 42713cb680SHung-ying Tyan /* TAB F3 T F6 */ 43713cb680SHung-ying Tyan 0x0201000f 0x0202003d 0x02030014 0x02040040 44713cb680SHung-ying Tyan /* ] Y 102ND [ */ 45713cb680SHung-ying Tyan 0x0205001b 0x02060015 0x02070056 0x0208001a 46713cb680SHung-ying Tyan /* F8 GRAVE F2 5 */ 47713cb680SHung-ying Tyan 0x02090042 0x03010029 0x0302003c 0x03030006 48713cb680SHung-ying Tyan /* F5 6 - \ */ 49713cb680SHung-ying Tyan 0x0304003f 0x03060007 0x0308000c 0x030b002b 50713cb680SHung-ying Tyan /* R_CTRL A D F */ 51713cb680SHung-ying Tyan 0x04000061 0x0401001e 0x04020020 0x04030021 52713cb680SHung-ying Tyan /* S K J ; */ 53713cb680SHung-ying Tyan 0x0404001f 0x04050025 0x04060024 0x04080027 54713cb680SHung-ying Tyan /* L ENTER Z C */ 55713cb680SHung-ying Tyan 0x04090026 0x040b001c 0x0501002c 0x0502002e 56713cb680SHung-ying Tyan /* V X , M */ 57713cb680SHung-ying Tyan 0x0503002f 0x0504002d 0x05050033 0x05060032 58713cb680SHung-ying Tyan /* L_SHIFT / . SPACE */ 59713cb680SHung-ying Tyan 0x0507002a 0x05080035 0x05090034 0x050B0039 60713cb680SHung-ying Tyan /* 1 3 4 2 */ 61713cb680SHung-ying Tyan 0x06010002 0x06020004 0x06030005 0x06040003 62713cb680SHung-ying Tyan /* 8 7 0 9 */ 63713cb680SHung-ying Tyan 0x06050009 0x06060008 0x0608000b 0x0609000a 64713cb680SHung-ying Tyan /* L_ALT DOWN RIGHT Q */ 65713cb680SHung-ying Tyan 0x060a0038 0x060b006c 0x060c006a 0x07010010 66713cb680SHung-ying Tyan /* E R W I */ 67713cb680SHung-ying Tyan 0x07020012 0x07030013 0x07040011 0x07050017 68713cb680SHung-ying Tyan /* U R_SHIFT P O */ 69713cb680SHung-ying Tyan 0x07060016 0x07070036 0x07080019 0x07090018 70713cb680SHung-ying Tyan /* UP LEFT */ 71713cb680SHung-ying Tyan 0x070b0067 0x070c0069>; 72713cb680SHung-ying Tyan}; 73