Add SN74x138 demultiplexer driver (#16217)

This commit is contained in:
Ryan 2022-02-07 04:02:45 +11:00 committed by GitHub
parent f4e3f75ecc
commit e036c19d06
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
5 changed files with 162 additions and 263 deletions

65
drivers/gpio/sn74x138.c Normal file
View File

@ -0,0 +1,65 @@
/* Copyright 2022
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#include "sn74x138.h"
#include "gpio.h"
#define ADDRESS_PIN_COUNT 3
#ifndef SN74X138_ADDRESS_PINS
# error sn74x138: no address pins defined!
#endif
static const pin_t address_pins[ADDRESS_PIN_COUNT] = SN74X138_ADDRESS_PINS;
void sn74x138_init(void) {
for (int i = 0; i < ADDRESS_PIN_COUNT; i++) {
setPinOutput(address_pins[i]);
writePinLow(address_pins[i]);
}
#if defined(SN74X138_E1_PIN)
setPinOutput(SN74X138_E1_PIN);
writePinHigh(SN74X138_E1_PIN);
#endif
#if defined(SN74X138_E2_PIN)
setPinOutput(SN74X138_E2_PIN);
writePinHigh(SN74X138_E2_PIN);
#endif
#if defined(SN74X138_E3_PIN)
setPinOutput(SN74X138_E3_PIN);
writePinLow(SN74X138_E3_PIN);
#endif
}
void sn74x138_set_enabled(bool enabled) {
#if defined(SN74X138_E1_PIN)
writePin(SN74X138_E1_PIN, !enabled);
#endif
#if defined(SN74X138_E2_PIN)
writePin(SN74X138_E2_PIN, !enabled);
#endif
#if defined(SN74X138_E3_PIN)
writePin(SN74X138_E3_PIN, enabled);
#endif
}
void sn74x138_set_addr(uint8_t address) {
for (int i = 0; i < ADDRESS_PIN_COUNT; i++) {
writePin(address_pins[i], address & (1 << i));
}
}

48
drivers/gpio/sn74x138.h Normal file
View File

@ -0,0 +1,48 @@
/* Copyright 2022
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#pragma once
#include <stdint.h>
#include <stdbool.h>
/**
* Driver for 74x138 3-to-8 decoder/demultiplexer with inverting outputs
* https://assets.nexperia.com/documents/data-sheet/74HC_HCT138.pdf
*/
/**
* Initialize the address and output enable pins.
*/
void sn74x138_init(void);
/**
* Set the enabled state.
*
* When enabled is true, pulls the E1 and E2 pins low, and the E3 pin high.
*
* \param enabled The enable state to set.
*/
void sn74x138_set_enabled(bool enabled);
/**
* Set the output pin address.
*
* The selected output pin will be pulled low, while the remaining output pins will be high.
*
* \param address The address to set, from 0 to 7.
*/
void sn74x138_set_addr(uint8_t address);

View File

@ -41,22 +41,16 @@ along with this program. If not, see <http://www.gnu.org/licenses/>.
* *
*/ */
#define MATRIX_ROW_PINS { D6, D4, F6, F7, F4, F5, F0, F1 } #define MATRIX_ROW_PINS { D6, D4, F6, F7, F4, F5, F0, F1 }
#define MATRIX_COL_PINS { } #define MATRIX_COL_PINS { C7, B6, C6, B4, B5, D7, NO_PIN, NO_PIN, NO_PIN, NO_PIN, NO_PIN, NO_PIN, NO_PIN, D3, B7, B3 } // Columns 6-12 controlled by demux
#define UNUSED_PINS #define UNUSED_PINS
/* COL2ROW, ROW2COL*/ #define SN74X138_ADDRESS_PINS { D2, D1, D0 }
#define DIODE_DIRECTION ROW2COL
// For QMK DFU // For QMK DFU
#define QMK_ESC_OUTPUT D6 #define QMK_ESC_OUTPUT D6
#define QMK_ESC_INPUT D7 #define QMK_ESC_INPUT D7
#define QMK_LED B0 #define QMK_LED B0
/*
* Split Keyboard specific options, make sure you have 'SPLIT_KEYBOARD = yes' in your rules.mk, and define SOFT_SERIAL_PIN.
*/
//#define SOFT_SERIAL_PIN D0 // or D1, D2, D3, E6
#define LED_NUM_LOCK_PIN B2 #define LED_NUM_LOCK_PIN B2
#define LED_CAPS_LOCK_PIN B0 #define LED_CAPS_LOCK_PIN B0
#define LED_SCROLL_LOCK_PIN B1 #define LED_SCROLL_LOCK_PIN B1

View File

@ -14,268 +14,66 @@ GNU General Public License for more details.
You should have received a copy of the GNU General Public License You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>. along with this program. If not, see <http://www.gnu.org/licenses/>.
*/ */
#include <stdint.h> #include <stdint.h>
#include <stdbool.h> #include <stdbool.h>
#include "wait.h"
#include "util.h"
#include "matrix.h" #include "matrix.h"
#include "debounce.h"
#include "quantum.h" #include "quantum.h"
#include "sn74x138.h"
#ifdef DIRECT_PINS
static pin_t direct_pins[MATRIX_ROWS][MATRIX_COLS] = DIRECT_PINS;
#elif (DIODE_DIRECTION == ROW2COL) || (DIODE_DIRECTION == COL2ROW)
static const pin_t row_pins[MATRIX_ROWS] = MATRIX_ROW_PINS; static const pin_t row_pins[MATRIX_ROWS] = MATRIX_ROW_PINS;
//static const pin_t col_pins[MATRIX_COLS] = MATRIX_COL_PINS; static const pin_t col_pins[MATRIX_COLS] = MATRIX_COL_PINS;
#endif
// matrix code /* col 0: C7
* col 1: B6
#ifdef DIRECT_PINS
static void init_pins(void) {
for (int row = 0; row < MATRIX_ROWS; row++) {
for (int col = 0; col < MATRIX_COLS; col++) {
pin_t pin = direct_pins[row][col];
if (pin != NO_PIN) {
setPinInputHigh(pin);
}
}
}
}
static bool read_cols_on_row(matrix_row_t current_matrix[], uint8_t current_row) {
matrix_row_t last_row_value = current_matrix[current_row];
current_matrix[current_row] = 0;
for (uint8_t col_index = 0; col_index < MATRIX_COLS; col_index++) {
pin_t pin = direct_pins[current_row][col_index];
if (pin != NO_PIN) {
current_matrix[current_row] |= readPin(pin) ? 0 : (MATRIX_ROW_SHIFTER << col_index);
}
}
return (last_row_value != current_matrix[current_row]);
}
#elif (DIODE_DIRECTION == COL2ROW)
static void select_row(uint8_t row) {
setPinOutput(row_pins[row]);
writePinLow(row_pins[row]);
}
static void unselect_row(uint8_t row) { setPinInputHigh(row_pins[row]); }
static void unselect_rows(void) {
for (uint8_t x = 0; x < MATRIX_ROWS; x++) {
setPinInputHigh(row_pins[x]);
}
}
static void init_pins(void) {
unselect_rows();
for (uint8_t x = 0; x < MATRIX_COLS; x++) {
setPinInputHigh(col_pins[x]);
}
}
static bool read_cols_on_row(matrix_row_t current_matrix[], uint8_t current_row) {
// Store last value of row prior to reading
matrix_row_t last_row_value = current_matrix[current_row];
// Clear data in matrix row
current_matrix[current_row] = 0;
// Select row and wait for row selecton to stabilize
select_row(current_row);
wait_us(30);
// For each col...
for (uint8_t col_index = 0; col_index < MATRIX_COLS; col_index++) {
// Select the col pin to read (active low)
uint8_t pin_state = readPin(col_pins[col_index]);
// Populate the matrix row with the state of the col pin
current_matrix[current_row] |= pin_state ? 0 : (MATRIX_ROW_SHIFTER << col_index);
}
// Unselect row
unselect_row(current_row);
return (last_row_value != current_matrix[current_row]);
}
#elif (DIODE_DIRECTION == ROW2COL)
/* Cols 0 - 15
* col 0: C7
* col 1: B6
* col 2: C6 * col 2: C6
* col 3: B4 * col 3: B4
* col 4: B5 * col 4: B5
* col 5: D7 * col 5: D7
* These columns use a 74HC237D 3 to 8 bit demultiplexer. *
* A0 A1 A2 * These columns use a 74HC138 3 to 8 bit demultiplexer.
* col / pin: PD2 PD1 PD0 * A2 A1 A0
* 6: 1 1 1 * col / pin: PD0 PD1 PD2
* 7: 0 1 1 * 6: 1 1 1
* 8: 1 0 1 * 7: 1 1 0
* 9: 0 0 1 * 8: 1 0 1
* 10: 1 1 0 * 9: 1 0 0
* 11: 0 1 0 * 10: 0 1 1
* 12: 1 0 0 * 11: 0 1 0
* col 13: D3 * 12: 0 0 1
* col 14: B7 *
* col 15: B3 * col 13: D3
* col 14: B7
* col 15: B3
*/ */
static void select_col(uint8_t col) { static void select_col(uint8_t col) {
switch (col) { if (col_pins[col] != NO_PIN) {
case 0: writePinLow(col_pins[col]);
writePinLow(C7); } else {
break; sn74x138_set_addr(13 - col);
case 1:
writePinLow(B6);
break;
case 2:
writePinLow(C6);
break;
case 3:
writePinLow(B4);
break;
case 4:
writePinLow(B5);
break;
case 5:
writePinLow(D7);
break;
case 6:
writePinHigh(D0);
writePinHigh(D1);
writePinHigh(D2);
break;
case 7:
writePinHigh(D0);
writePinHigh(D1);
break;
case 8:
writePinHigh(D0);
writePinHigh(D2);
break;
case 9:
writePinHigh(D0);
break;
case 10:
writePinHigh(D1);
writePinHigh(D2);
break;
case 11:
writePinHigh(D1);
break;
case 12:
writePinHigh(D2);
break;
case 13:
writePinLow(D3);
break;
case 14:
writePinLow(B7);
break;
case 15:
writePinLow(B3);
break;
} }
} }
static void unselect_col(uint8_t col) { static void unselect_col(uint8_t col) {
switch (col) { if (col_pins[col] != NO_PIN) {
case 0: setPinOutput(col_pins[col]);
writePinHigh(C7); writePinHigh(col_pins[col]);
break; } else {
case 1: sn74x138_set_addr(0);
writePinHigh(B6);
break;
case 2:
writePinHigh(C6);
break;
case 3:
writePinHigh(B4);
break;
case 4:
writePinHigh(B5);
break;
case 5:
writePinHigh(D7);
break;
case 6:
writePinLow(D0);
writePinLow(D1);
writePinLow(D2);
break;
case 7:
writePinLow(D0);
writePinLow(D1);
break;
case 8:
writePinLow(D0);
writePinLow(D2);
break;
case 9:
writePinLow(D0);
break;
case 10:
writePinLow(D1);
writePinLow(D2);
break;
case 11:
writePinLow(D1);
break;
case 12:
writePinLow(D2);
break;
case 13:
writePinHigh(D3);
break;
case 14:
writePinHigh(B7);
break;
case 15:
writePinHigh(B3);
break;
} }
} }
static void unselect_cols(void) { static void unselect_cols(void) {
//Native // Native
setPinOutput(D3); for (uint8_t x = 0; x < MATRIX_COLS; x++) {
setPinOutput(D7); if (col_pins[x] != NO_PIN) {
writePinHigh(D3); setPinOutput(col_pins[x]);
writePinHigh(D7); writePinHigh(col_pins[x]);
}
}
setPinOutput(C6); // Demultiplexer
setPinOutput(C7); sn74x138_set_addr(0);
writePinHigh(C6);
writePinHigh(C7);
setPinOutput(B3);
setPinOutput(B4);
setPinOutput(B5);
setPinOutput(B6);
setPinOutput(B7);
writePinHigh(B3);
writePinHigh(B4);
writePinHigh(B5);
writePinHigh(B6);
writePinHigh(B7);
//Demultiplexer
setPinOutput(D0);
setPinOutput(D1);
setPinOutput(D2);
writePinLow(D0);
writePinLow(D1);
writePinLow(D2);
} }
static void init_pins(void) { static void init_pins(void) {
@ -288,9 +86,9 @@ static void init_pins(void) {
static bool read_rows_on_col(matrix_row_t current_matrix[], uint8_t current_col) { static bool read_rows_on_col(matrix_row_t current_matrix[], uint8_t current_col) {
bool matrix_changed = false; bool matrix_changed = false;
// Select col and wait for col selecton to stabilize // Select col and wait for col selection to stabilize
select_col(current_col); select_col(current_col);
wait_us(30); matrix_io_delay();
// For each row... // For each row...
for (uint8_t row_index = 0; row_index < MATRIX_ROWS; row_index++) { for (uint8_t row_index = 0; row_index < MATRIX_ROWS; row_index++) {
@ -318,27 +116,20 @@ static bool read_rows_on_col(matrix_row_t current_matrix[], uint8_t current_col)
return matrix_changed; return matrix_changed;
} }
#endif
void matrix_init_custom(void) { void matrix_init_custom(void) {
// initialize key pins // initialize key pins
init_pins(); init_pins();
// initialize demultiplexer
sn74x138_init();
} }
bool matrix_scan_custom(matrix_row_t current_matrix[]) { bool matrix_scan_custom(matrix_row_t current_matrix[]) {
bool changed = false; bool changed = false;
#if defined(DIRECT_PINS) || (DIODE_DIRECTION == COL2ROW)
// Set row, read cols
for (uint8_t current_row = 0; current_row < MATRIX_ROWS; current_row++) {
changed |= read_cols_on_row(current_matrix, current_row);
}
#elif (DIODE_DIRECTION == ROW2COL)
// Set col, read rows // Set col, read rows
for (uint8_t current_col = 0; current_col < MATRIX_COLS; current_col++) { for (uint8_t current_col = 0; current_col < MATRIX_COLS; current_col++) {
changed |= read_rows_on_col(current_matrix, current_col); changed |= read_rows_on_col(current_matrix, current_col);
} }
#endif
return changed; return changed;
} }

View File

@ -18,6 +18,7 @@ RGBLIGHT_ENABLE = no # Enable keyboard RGB underglow
AUDIO_ENABLE = no # Audio output AUDIO_ENABLE = no # Audio output
CUSTOM_MATRIX = lite CUSTOM_MATRIX = lite
SRC += matrix.c VPATH += drivers/gpio
SRC += matrix.c sn74x138.c
LAYOUTS = fullsize_ansi fullsize_iso tkl_ansi tkl_iso LAYOUTS = fullsize_ansi fullsize_iso tkl_ansi tkl_iso