doc/device-tree-bindings/input/cros-ec-keyb.txt

   1 CROS_EC Keyboard
   2
   3 The CROS_EC (Matrix Keyboard Protocol) allows communcation with a secondary
   4 micro used for keyboard, and possible other features.
   5
   6 The CROS_EC keyboard uses this protocol to receive key scans and produce input
   7 in U-Boot.
   8
   9 Required properties :
  10 - compatible : "google,cros-ec-keyb"
  11 - google,key-rows : Number of key rows
  12 - google,key-columns : Number of key columns
  13
  14 Optional properties, in addition to those specified by the shared
  15 matrix-keyboard bindings:
  16
  17 - linux,fn-keymap: a second keymap, same specification as the
  18   matrix-keyboard-controller spec but to be used when the KEY_FN modifier
  19   key is pressed.
  20 - google,repeat-delay-ms : delay in milliseconds before repeat starts
  21 - google,repeat-rate-ms : delay between each subsequent key press
  22 - google,ghost-filter : enable ghost filtering for this device
  23
  24 Example, taken from daisy:
  25
  26 cros-ec-keyb {
  27         compatible = "google,cros-ec-keyb";
  28         google,key-rows = <8>;
  29         google,key-columns = <13>;
  30         google,ghost-filter;
  31         google,repeat-delay-ms = <240>;
  32         google,repeat-rate-ms = <30>;
  33         /*
  34                 * Keymap entries take the form of 0xRRCCKKKK where
  35                 * RR=Row CC=Column KKKK=Key Code
  36                 * The values below are for a US keyboard layout and
  37                 * are taken from the Linux driver. Note that the
  38                 * 102ND key is not used for US keyboards.
  39                 */
  40         linux,keymap = <
  41                 /* CAPSLCK F1         B          F10     */
  42                 0x0001003a 0x0002003c 0x00030030 0x00040044
  43                 /* N       =          R_ALT      ESC     */
  44                 0x00060031 0x0008000d 0x000a0064 0x01010001
  45                 /* F4      G          F7         H       */
  46                 0x0102003e 0x01030022 0x01040041 0x01060023
  47                 /* '       F9         BKSPACE    L_CTRL  */
  48                 0x01080028 0x01090043 0x010b000e 0x0200001d
  49                 /* TAB     F3         T          F6      */
  50                 0x0201000f 0x0202003d 0x02030014 0x02040040
  51                 /* ]       Y          102ND      [       */
  52                 0x0205001b 0x02060015 0x02070056 0x0208001a
  53                 /* F8      GRAVE      F2         5       */
  54                 0x02090042 0x03010029 0x0302003c 0x03030006
  55                 /* F5      6          -          \       */
  56                 0x0304003f 0x03060007 0x0308000c 0x030b002b
  57                 /* R_CTRL  A          D          F       */
  58                 0x04000061 0x0401001e 0x04020020 0x04030021
  59                 /* S       K          J          ;       */
  60                 0x0404001f 0x04050025 0x04060024 0x04080027
  61                 /* L       ENTER      Z          C       */
  62                 0x04090026 0x040b001c 0x0501002c 0x0502002e
  63                 /* V       X          ,          M       */
  64                 0x0503002f 0x0504002d 0x05050033 0x05060032
  65                 /* L_SHIFT /          .          SPACE   */
  66                 0x0507002a 0x05080035 0x05090034 0x050B0039
  67                 /* 1       3          4          2       */
  68                 0x06010002 0x06020004 0x06030005 0x06040003
  69                 /* 8       7          0          9       */
  70                 0x06050009 0x06060008 0x0608000b 0x0609000a
  71                 /* L_ALT   DOWN       RIGHT      Q       */
  72                 0x060a0038 0x060b006c 0x060c006a 0x07010010
  73                 /* E       R          W          I       */
  74                 0x07020012 0x07030013 0x07040011 0x07050017
  75                 /* U       R_SHIFT    P          O       */
  76                 0x07060016 0x07070036 0x07080019 0x07090018
  77                 /* UP      LEFT    */
  78                 0x070b0067 0x070c0069>;
  79 };