Aprender

Prototipa tu matriz de teclado personalizada antes de soldar

Avanzado

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
Pro Micro: una matriz de 4 x 3 con diodosen vivo0.000 s 0.00x
Presiona Ejecutar y luego oprime las teclas
Oprime las teclas, mantén oprimida la de abajo a la izquierda para NAV y gira la perilla. El monitor serie muestra cada reporte de [Keyboard] y [Mouse].

Todo teclado personalizado, desde un macropad de tres teclas hasta un teclado ergonómico dividido, empieza con el mismo circuito: una cuadrícula de interruptores, un diodo en cada uno y un controlador que escanea la cuadrícula cientos de veces por segundo. Si la matriz queda bien, el resto es configuración. Si un diodo queda al revés o una fila en el pin equivocado, te enteras después de una noche de soldadura.

El teclado numérico de arriba es una matriz completa para probarlo: doce interruptores en cuatro filas y tres columnas, un 1N4148 en cada tecla, un codificador rotatorio, una tira de LEDs RGB por tecla y un Pro Micro. Oprime las teclas mientras se ejecuta y el monitor serie muestra lo que el teclado escribiría, capa por capa.

Dos cosas que debes saber. Mokxi no simula la conexión USB a una computadora, así que la biblioteca Keyboard imprime cada reporte como una línea [Keyboard] en lugar de escribir. Y el firmware es un sketch legible, no QMK ni KMK. Hace los mismos trabajos centrales, el escaneo, el antirrebote, las capas, el codificador y la iluminación, para que puedas probar una distribución y un plan de cableado, y luego llevarlos al firmware que en realidad vas a grabar.

¿Quieres la versión paso a paso? La lección "Filas, columnas y el escaneo" te guía por esto con puntos de control.

Abrir la lección

Por qué un teclado es una matriz

Un pin por tecla se acaba rápido: un teclado ortolineal de 48 teclas necesitaría 48 pines, y un Pro Micro tiene 18. Una matriz pone cada tecla donde un cable de fila cruza un cable de columna, así que los pines necesarios son filas más columnas. Cuatro filas por tres columnas son 12 teclas en 7 pines; cuatro por doce son 48 teclas en 16 pines.

Para leerla, el firmware pone una fila en LOW, deja las demás filas flotando y lee cada columna con su pull-up activado. Una columna que lee LOW tiene una tecla oprimida en esa fila. Luego pasa a la siguiente fila, y una vuelta completa por la cuadrícula toma bastante menos de un milisegundo.

Fantasmas y el diodo en cada tecla

Sin diodos, si mantienes tres teclas en las esquinas de un rectángulo, la cuarta esquina también aparece como oprimida: la corriente encuentra un camino de regreso a través de los tres interruptores cerrados. Eso es el efecto fantasma. El curso tiene un teclado de membrana sin diodos donde puedes provocarlo y ver que el firmware no puede distinguir el fantasma de una pulsación real.

Un diodo en serie con cada tecla bloquea el camino inverso, así que cada tecla se lee correctamente sin importar cuántas estén oprimidas. La dirección importa. Con filas en LOW y columnas con pull-up, la corriente fluye de la columna a la fila, así que la banda del diodo, el cátodo, apunta hacia la fila. QMK llama a esto COL2ROW, y su documentación lo dice igual: la marca negra mirando hacia las filas, entre el interruptor y la fila.

Con diodos, la matriz no tiene un límite propio de rollover. El reporte USB sí puede tenerlo: un reporte estándar de teclado boot, que es el que envía la biblioteca Keyboard de Arduino, admite seis teclas a la vez.

Armar la matriz en la protoboard

La plantilla usa una protoboard media por cada fila de teclas, apiladas como las filas de un teclado. Cada interruptor atraviesa el canal central de su placa, así que sus patas izquierdas unen la tira de arriba del canal con la de abajo: ese par de tiras es la columna de la tecla, y un jumper la lleva hacia la siguiente placa. Las patas derechas del interruptor pasan por el diodo hacia la tira de la fila, y jumpers cortos unen las tiras de fila de una placa en una sola fila. Las columnas se ven como líneas rectas bajando por el apilado y las filas como una línea a lo largo de cada placa.

En un armado con cableado directo, el mismo circuito es cable pelado: un cable de columna a lo largo de una pata de cada interruptor, y las patas de los diodos dobladas a lo largo de cada fila formando el cable de la fila.

Capas, un codificador y RGB por tecla

El mapa de teclas es una tabla por capa, ordenada como están las teclas. MO(NAV) mantiene una capa mientras su tecla está oprimida, TG alterna una, y una tecla transparente cae a la capa de abajo, ganando la capa activa más alta, que es como QMK también resuelve las capas. El sketch decide cada tecla al pulsarla y la mantiene hasta soltarla, así que soltar primero la tecla de capa nunca deja una tecla atascada.

El codificador hace algo distinto en cada capa: la rueda del mouse en la capa base, flechas en NAV, deshacer y rehacer en EDIT, como un mapa de codificadores en QMK. Los LEDs son un WS2812B por tecla en orden de lectura, cada uno del color de su capa, parpadeando cuando se oprime su tecla.

Una capa, de la plantilla
{  // NAV, held on the bottom-left key
  {KEY_HOME, KEY_UP_ARROW, KEY_PAGE_UP},
  {KEY_LEFT_ARROW, KEY_ESC, KEY_RIGHT_ARROW},
  {KEY_END, KEY_DOWN_ARROW, KEY_PAGE_DOWN},
  {____, KEY_BACKSPACE, TG(EDIT)},
},

Seguir con QMK, KMK y teclados divididos

Cuando la distribución y el cableado estén resueltos aquí, escríbelos en el firmware que vas a grabar. QMK está escrito en C y corre en muchos microcontroladores, incluido el ATmega32U4 de un Pro Micro; KMK está escrito en CircuitPython para placas como la RP2040. Ambos piden los mismos datos que acabas de probar: los pines de filas y columnas, la dirección de los diodos, las capas y lo que hace el codificador.

Un teclado dividido son dos matrices, una por mitad, con las mitades comunicándose por un enlace serie o I2C en un cable TRRS. La documentación de QMK advierte desconectar el USB antes de conectar o desconectar ese cable. La matriz de cada mitad es exactamente el circuito de esta página.

Abre este circuito en el editor. Pro Micro: una matriz de 4 x 3 con diodos, cableada tal como se ejecuta arriba en esta página. Cambia un componente o un valor y ejecútalo de nuevo.

Abrir el circuito

Preguntas

¿Necesito un diodo en cada tecla?

Para un teclado donde se oprimen varias teclas a la vez, sí: sin ellos, tres teclas en un rectángulo crean un cuarto fantasma. Un macropad diminuto donde solo se oprime una tecla a la vez puede omitirlos, pero la mayoría de los armados los incluyen.

¿Hacia qué lado van los diodos?

Para COL2ROW, que es lo que usa esta plantilla, la banda (el cátodo) apunta hacia la fila, entre el interruptor y el cable de la fila. El firmware debe configurarse para coincidir con la orientación de los diodos.

¿Esto es QMK?

No. Es un sketch legible de Arduino que hace los mismos trabajos centrales: escaneo, antirrebote, capas, un codificador e iluminación. Úsalo para comprobar la matriz y la distribución, y luego configura QMK o KMK para el armado real.

¿Mokxi escribe en mi computadora?

No. La conexión USB no está simulada, así que las bibliotecas Keyboard y Mouse imprimen cada reporte en el monitor serie. Graba el sketch en un Pro Micro real y los mismos reportes irán por USB.

Ármalo en la vida real

Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.