Archived
1
0
This repo is archived. You can view files and clone it, but cannot push or open issues or pull requests.
controller/Scan/matrix/matrix_template.h

154 lines
5.4 KiB
C
Raw Normal View History

/* 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_KEYS 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_KEYS 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_KEYS 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