Porque é que o meu teclado DIY não escreve? Correções comuns
By Vortex Keyboard - Retro and Modern Style Mechanical ... | Published: 2026-10-16
Category: Guias Práticos
Diagnostique porque é que o seu teclado mecânico DIY não escreve: verifique primeiro o cabo e a porta, depois a deteção da PCB, as juntas de solda e o firmware. Correções para builds QMK, VIA e Vial.
Resposta rápida
Comece pelo cabo e pela porta: experimente um cabo de dados conhecido numa porta USB diferente antes de tocar no firmware ou na solda. Se a PCB ainda não for detetada, reflua o conector USB e verifique se há pontes de solda. Só volte a gravar o firmware depois de a placa ser detetada e, se uma ilha de solda se soltar ou o MCU estiver morto, pare e substitua a PCB ou escolha um kit hot-swap.
Primeiro: exclua o cabo, a porta e o anfitrião
Uma percentagem surpreendente de montagens 'mortas' deve-se a cabos USB apenas de alimentação ou a um hub instável. Use um cabo com o qual já tenha sincronizado dados, ligue diretamente à motherboard e teste num segundo computador. Se a placa aparecer no Gestor de Dispositivos ou nas Informações do Sistema, o problema é de firmware ou keymap, não de hardware. Se nada aparecer, passe para as verificações da PCB abaixo.
PCB não detetada: inspecione a alimentação e o conector USB
Com a placa desligada, observe os terminais do conector USB com ampliação. Uma junta rachada ou fria aqui causa deteção intermitente. Reflua cada terminal com solda nova e fluxo. Depois, verifique se há pontes de solda entre os pinos de dados e a blindagem. Se tiver um multímetro, confirme que 5V chega ao MCU e que D+ e D- não estão em curto com a massa. Uma placa que nunca enumera precisa destas correções antes de qualquer passo de firmware.
Teclas em falta ou a repetir: reflua juntas suspeitas
Se a placa escreve mas teclas específicas falham, a junta do díodo ou do interruptor para essa linha ou coluna é a causa provável. Reflua ambos os pinos do interruptor e o díodo para cada tecla afetada. Numa PCB soldável com fios, uma única junta fria pode eliminar uma linha inteira. Teste com um testador de teclas ou um editor de texto após cada refluxo para saber qual junta resolveu o problema.
Problemas de gravação de firmware: reinicie, depois regrave
Quando a PCB é detetada mas as teclas estão erradas ou mortas, entre no bootloader com o botão de reset ou a combinação de teclas que a sua placa usa e grave a disposição correta. Se o VIA ou o Vial não vir a placa, confirme que o firmware foi construído com o protocolo correspondente. Na versão M0110 QMK/VIA/Vial, o Vial ainda não foi atualizado para o protocolo V3, por isso o VIA é o configurador fiável até a documentação ser publicada.
Quando parar e mudar de rumo
Pare se uma ilha de solda se soltar, o MCU sobreaquecer ou a placa entrar em curto sempre que a liga. Estas são falhas ao nível da placa, não problemas de afinação. Uma PCB hot-swap ou um kit pré-montado elimina totalmente a variável da solda, e um serviço de montagem elimina tanto a solda como a configuração do firmware se preferir escrever a depurar.
Tabela de diagnóstico: sintoma, causa, ação, ponto de paragem
- Nenhuma deteção: Provavelmente um cabo USB apenas de alimentação, porta morta ou junta do conector USB rachada. Experimente um cabo de dados numa porta traseira da motherboard, depois reflua os terminais do conector e verifique se há pontes. Se ainda não enumerar após um refluxo limpo, o MCU ou a placa é o problema; substitua a PCB em vez de perseguir o firmware.
- Detetada mas algumas teclas mortas: Uma junta fria do interruptor ou díodo nessa linha ou coluna. Reflua ambos os pinos e o díodo para cada tecla afetada, testando após cada uma. Se o refluxo não restaurar a tecla, a ilha de solda ou a pista está danificada; pare e use uma PCB diferente ou uma placa hot-swap.
- Escreve mas caracteres ou camadas erradas: A disposição do firmware não corresponde à montagem física. Entre no bootloader e grave a disposição correta, depois remapeie no VIA ou Vial. Se o Vial não conseguir ver a placa, use o VIA; na versão M0110 QMK/VIA/Vial, o Vial ainda não foi atualizado para o protocolo V3.
- Desconexões intermitentes ao escrever: Uma junta USB solta ou um problema de tensão no cabo. Reflua o conector e use um cabo com alívio de tensão. Se as desconexões continuarem após o refluxo, pare; o conector ou o MCU está a falhar e uma PCB de substituição é o caminho mais seguro.
Opções de montagem que reduzem estes pontos de falha
- Versão M0110 QMK/VIA/Vial: M0110 QMK/VIA/Vial é certificado com base no protocolo V3, enquanto o protocolo Vial ainda não foi atualizado; no envio, o produto será apenas compatível com QMK e VIA. Se a sua montagem usar esta PCB, configure com VIA em vez de Vial para evitar um configurador que não consegue ver a placa.
- PCB soldável com fios: Isto não é um teclado totalmente montado; não pode ser devolvido ou reembolsado e não inclui uma garantia de 12 meses. Compre-o apenas se se sentir confortável a diagnosticar juntas de solda, pois não há recurso de garantia para um erro de montagem.
- Kit Vortex Model M SSK - Disposição ISO (Serviço de Montagem): Kit Vortex Model M SSK é um teclado mecânico retro inspirado, totalmente em alumínio CNC, com retroiluminação RGB, função totalmente hot-swappable, NKRO e suporte para QMK/VIA/Vial para reatribuição de teclas ou macros. As tomadas hot-swap eliminam o passo da solda que causa a maioria das falhas de 'não escrever', e o serviço de montagem trata do firmware por si.
