]> git.donarmstrong.com Git - kiibohd-controller.git/blobdiff - Scan/matrix/matrix_template.h
Making sub-modules of matrix for HeathZenith and BudKeypad
[kiibohd-controller.git] / Scan / matrix / matrix_template.h
diff --git a/Scan/matrix/matrix_template.h b/Scan/matrix/matrix_template.h
new file mode 100644 (file)
index 0000000..1573af4
--- /dev/null
@@ -0,0 +1,153 @@
+/* Copyright (C) 2011 by Jacob Alexander
+ * 
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ * 
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ * 
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ */
+
+#ifndef __MATRIX_H
+#define __MATRIX_H
+
+// ----- Includes -----
+
+// Compiler Includes
+#include <stdint.h>
+
+
+
+// ----- Scan Mode Setting (See matrix_scan.h for more details) -----
+#define scanMode scanDual
+
+
+
+// ----- Key Settings -----
+
+// -- Example for scanCol --
+/*
+#define KEYBOARD_SIZE 16 // # of keys
+#define MAX_ROW_SIZE  16 // # of keys in the largest row
+#define MAX_COL_SIZE   1 // # of keys in the largest column
+*/
+
+
+// -- Example for scanRow --
+/*
+#define KEYBOARD_SIZE 16 // # of keys
+#define MAX_ROW_SIZE   1 // # of keys in the largest row
+#define MAX_COL_SIZE  16 // # of keys in the largest column
+*/
+
+
+// -- Example for scanRow_powrCol, scanCol_powrRow, and scanDual --
+/*
+#define KEYBOARD_SIZE 69 // # of keys
+#define MAX_ROW_SIZE   8 // # of keys in the largest row
+#define MAX_COL_SIZE   9 // # of keys in the largest column
+*/
+
+
+
+// ----- Matrix Configuration -----
+static const uint8_t matrix_pinout[][MAX_ROW_SIZE + 1] = {
+
+
+
+// Just layout the matrix by rows and columns
+// Usually you'll want to set the scanMode above to scanDual or scanCol_powrRow/scanRow_powrCol
+// The mode allows for optimization in the kind of scanning algorithms that are done
+// 
+// The key numbers are used to translate into the keymap table (array) (and always start from 1, not 0).
+// Thus if a row doesn't use all the key positions, you can denote it as 0, which will be ignored/skipped on each scan
+// See the keymap.h file for the various preconfigured arrays.
+
+// Scan Mode | Col 1 | Col 2 | Col 3 | Col 4 | Col 5 | ...
+// -------------------------------------------------------
+//     Row 1 | Key 1   Key 7   Key32    ...
+//     Row 2 | Key 3   Key92    ...
+//     Row 3 | Key23    ...
+//     Row 4 |  ...
+//     Row 5 |
+//      ...  |
+
+
+// -- scanCol Example --
+/*
+  { scanMode, pinF0, pinF4, pinB7, pinD3, pinF5, pinF1, pinD1, pinD2, pinF6, pinF7, pinB2, pinD0, pinB0, pinB6, pinB1, pinB3 },
+  { pinNULL,  1,     2,     3,     4,     5,     6,     7,     8,     9,     10,    11,    12,    13,    14,    15,    16    },
+*/
+
+
+// -- scanRow Example --
+/*
+  { scanMode, pinNULL },
+  { pinF0,    1       },
+  { pinF4,    2       },
+  { pinB7,    3       },
+  { pinD3,    4       },
+  { pinF5,    5       },
+  { pinF1,    6       },
+  { pinD1,    7       },
+  { pinD2,    8       },
+  { pinF6,    9       },
+  { pinF7,    10      },
+  { pinB2,    11      },
+  { pinD0,    12      },
+  { pinB0,    13      },
+  { pinB6,    14      },
+  { pinB1,    15      },
+  { pinB3,    16      },
+*/
+
+
+// -- scanRow_powrCol Example and scanCol_powrRow Example --
+// The example is the same, as the difference is whether the row or col is powered, and the other is used to detect the signal
+/*
+  { scanMode, pinF0, pinF4, pinB7, pinD3, pinF5, pinF1, pinD1, pinD2 },
+  { pinF6,    1,     2,     3,     4,     5,     6,     7,     8     },
+  { pinF7,    9,     10,    11,    12,    13,    14,    15,    16    },
+  { pinB2,    17,    20,    30,    40,    50,    60,    59,    38    },
+  { pinD0,    18,    21,    31,    41,    51,    61,    67,    39    },
+  { pinB0,    19,    22,    32,    42,    52,    62,    68,    47    },
+  { pinB6,    27,    23,    33,    43,    53,    63,    69,    48    },
+  { pinB1,    28,    24,    34,    44,    54,    64,    0,     49    }, // 0 signifies no key at that location
+  { pinB3,    29,    25,    35,    45,    55,    65,    0,     57    },
+  { pinA0,    37,    26,    36,    46,    56,    66,    0,     58    },
+*/
+
+
+// -- scanDual Example --
+// The example is the same as the previous one, but uses both columns and rows to power and detect, needed for non-NKRO matrices.
+/*
+  { scanMode, pinF0, pinF4, pinB7, pinD3, pinF5, pinF1, pinD1, pinD2 },
+  { pinF6,    1,     2,     3,     4,     5,     6,     7,     8     },
+  { pinF7,    9,     10,    11,    12,    13,    14,    15,    16    },
+  { pinB2,    17,    20,    30,    40,    50,    60,    59,    38    },
+  { pinD0,    18,    21,    31,    41,    51,    61,    67,    39    },
+  { pinB0,    19,    22,    32,    42,    52,    62,    68,    47    },
+  { pinB6,    27,    23,    33,    43,    53,    63,    69,    48    },
+  { pinB1,    28,    24,    34,    44,    54,    64,    0,     49    }, // 0 signifies no key at that location
+  { pinB3,    29,    25,    35,    45,    55,    65,    0,     57    },
+  { pinA0,    37,    26,    36,    46,    56,    66,    0,     58    },
+*/
+
+
+};
+
+
+
+#endif // __MATRIX_H
+