Aprender

Prototipe a matriz do seu teclado personalizado antes de soldar

Avançado

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Pro Micro: uma matriz 4 x 3 com diodosao vivo0.000 s 0.00x
Aperte Rodar e depois clique nas teclas
Clique nas teclas, segure a tecla do canto inferior esquerdo para o NAV e gire o botão giratório. O monitor serial mostra cada relatório de [Keyboard] e [Mouse].

Todo teclado personalizado, de um macropad de três teclas a um teclado ergonômico dividido, começa com o mesmo circuito: uma grade de teclas, um diodo em cada uma e um controlador que examina a grade centenas de vezes por segundo. Acerte a matriz e o resto é configuração. Coloque um diodo ao contrário ou uma linha no pino errado e você só descobre depois de uma noite inteira de solda.

O teclado numérico acima é uma matriz completa para experimentar isso: doze teclas em quatro linhas e três colunas, um 1N4148 em cada tecla, um encoder rotativo, uma fita de LEDs RGB, um por tecla, e um Pro Micro. Aperte as teclas enquanto ele roda e o monitor serial mostra o que o teclado digitaria, camada por camada.

Duas coisas que você precisa saber. O Mokxi não simula a conexão USB com um computador, então a biblioteca Keyboard imprime cada relatório como uma linha [Keyboard] em vez de digitar. E o firmware é um sketch legível, não QMK nem KMK. Ele faz as mesmas tarefas principais, o escaneamento, o debounce, as camadas, o encoder e a iluminação, para você testar um layout e um plano de ligação e depois levá-los para o firmware que vai gravar de verdade.

Quer a versão passo a passo? A aula "Linhas, colunas e o escaneamento" percorre tudo isso com checkpoints.

Abrir a aula

Por que um teclado é uma matriz

Um pino por tecla acaba rápido: um teclado ortolinear de 48 teclas precisaria de 48 pinos, e um Pro Micro tem 18. Uma matriz coloca cada tecla onde um fio de linha cruza um fio de coluna, então os pinos necessários são linhas mais colunas. Quatro linhas por três colunas são 12 teclas em 7 pinos; quatro por doze são 48 teclas em 16 pinos.

Para ler a matriz, o firmware coloca uma linha em LOW, deixa as outras linhas flutuando e lê todas as colunas com o pull-up ativado. Uma coluna que lê LOW tem uma tecla pressionada naquela linha. Depois ele passa para a próxima linha, e uma volta completa pela grade leva bem menos de um milissegundo.

Fantasmas e o diodo em cada tecla

Sem diodos, segure três teclas nos cantos de um retângulo e o quarto canto também aparece como pressionado: a corrente encontra um caminho de volta pelos três interruptores fechados. Isso é o ghosting. O curso tem um teclado de membrana sem diodos onde você pode provocar esse efeito e ver que o firmware não consegue distinguir o fantasma de um pressionamento real.

Um diodo em série com cada tecla bloqueia o caminho de volta, então cada tecla lê corretamente não importa quantas estejam pressionadas. A direção importa. Com as linhas em LOW e as colunas com pull-up, a corrente flui da coluna para a linha, então a faixa do diodo, o cátodo, fica voltada para a linha. O QMK chama isso de COL2ROW, e a documentação dele diz o mesmo: a marca preta voltada para as linhas, entre a tecla e a linha.

Com diodos, a matriz em si não tem limite de rollover. O relatório USB pode ter: um relatório padrão de teclado boot, como o que a biblioteca Keyboard do Arduino envia, comporta seis teclas ao mesmo tempo.

Montando a matriz na protoboard

O modelo usa uma meia protoboard por linha de teclas, empilhadas como as linhas de um teclado. Cada tecla atravessa o canal central da sua placa, então as pernas esquerda dela ligam a faixa acima do canal à faixa abaixo: esse par de faixas é a coluna da tecla, e um jumper a leva para a placa seguinte. As pernas direitas da tecla passam pelo diodo até a faixa da linha, e jumpers curtos unem as faixas de linha de uma placa em uma única linha. As colunas aparecem como linhas retas descendo a pilha e as linhas como uma trilha ao longo de cada placa.

Em uma montagem com fios diretos, o mesmo circuito é fio nu: um fio de coluna descendo por uma perna de cada tecla e as pernas dos diodos dobradas ao longo de cada linha formando o fio da linha.

Camadas, um encoder e RGB por tecla

O mapa de teclas é uma tabela por camada, organizada do jeito que as teclas estão. MO(NAV) mantém uma camada ativa enquanto a tecla estiver pressionada, TG alterna uma, e uma tecla transparente passa para a camada de baixo, com a camada ativa mais alta vencendo, que é como o QMK também resolve as camadas. O sketch decide cada tecla no pressionamento e a mantém até a soltura, então soltar antes a tecla de camada nunca deixa uma tecla presa.

O encoder faz algo diferente em cada camada: a roda do mouse na camada base, setas no NAV, desfazer e refazer no EDIT, como um mapa de encoders no QMK. Os LEDs são um WS2812B por tecla na ordem de leitura, cada um na cor da sua camada, piscando quando a tecla é pressionada.

Uma camada, do modelo
{  // 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)},
},

Seguindo para QMK, KMK e teclados divididos

Quando o layout e a ligação estiverem resolvidos aqui, escreva-os no firmware que você vai gravar. O QMK é escrito em C e roda em muitos microcontroladores, incluindo o ATmega32U4 de um Pro Micro; o KMK é escrito em CircuitPython para placas como a RP2040. Os dois pedem as mesmas informações que você acabou de testar: os pinos de linha e coluna, a direção dos diodos, as camadas e o que o encoder faz.

Um teclado dividido são duas matrizes, uma por metade, com as metades conversando por um link serial ou I2C em um cabo TRRS. A documentação do QMK avisa para desconectar o USB antes de conectar ou desconectar esse cabo. A matriz de cada metade é exatamente o circuito desta página.

Abra este circuito no editor. Pro Micro: uma matriz 4 x 3 com diodos, ligada como está rodando no topo desta página. Troque um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

Preciso de um diodo em cada tecla?

Para um teclado em que várias teclas são pressionadas juntas, sim: sem eles, três teclas em um retângulo criam um quarto fantasma. Um macropad pequeno em que só uma tecla é pressionada por vez pode dispensá-los, mas a maioria das montagens os inclui.

Para que lado vão os diodos?

Para COL2ROW, que é o que este modelo usa, a faixa (o cátodo) fica voltada para a linha, entre a tecla e o fio da linha. O firmware precisa estar configurado para corresponder ao jeito que os diodos estão montados.

Isto é QMK?

Não. É um sketch de Arduino legível que faz as mesmas tarefas principais: escaneamento, debounce, camadas, um encoder e iluminação. Use-o para validar a matriz e o layout e depois configure o QMK ou o KMK para a montagem real.

O Mokxi digita no meu computador?

Não. A conexão USB não é simulada, então as bibliotecas Keyboard e Mouse imprimem cada relatório no monitor serial. Grave o sketch em um Pro Micro de verdade e os mesmos relatórios vão pelo USB.

Monte isto de verdade

Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.