¿Por qué mi teclado DIY no escribe? Soluciones comunes
By Vortex Keyboard - Retro and Modern Style Mechanical ... | Published: 2026-10-16
Category: Guías prácticas
Diagnostica por qué tu teclado mecánico DIY no escribe: revisa primero el cable y el puerto, luego la detección de la PCB, las uniones de soldadura y el firmware. Soluciones para builds de QMK, VIA y Vial.
Respuesta rápida
Empieza por el cable y el puerto: prueba con un cable de datos conocido en un puerto USB diferente antes de tocar el firmware o el soldador. Si la PCB sigue sin detectarse, refluye el conector USB y comprueba si hay puentes de soldadura. Solo actualiza el firmware después de que la placa sea detectada, y si una almohadilla se levanta o el MCU está muerto, detente y reemplaza la PCB o elige un kit hot-swap.
Primero: descarta el cable, el puerto y el host
Una sorprendente cantidad de montajes 'muertos' se deben a cables USB solo de alimentación o a un hub defectuoso. Usa un cable con el que ya hayas sincronizado datos, conéctalo directamente a la placa base y pruébalo en un segundo ordenador. Si la placa aparece en el Administrador de dispositivos o en Información del sistema, el problema es de firmware o keymap, no de hardware. Si no aparece nada, pasa a las comprobaciones de la PCB que se indican a continuación.
PCB no detectada: inspecciona la alimentación y el conector USB
Con la placa desconectada, examina las patillas del conector USB con aumento. Una grieta o una soldadura fría aquí provoca una detección intermitente. Refluye cada pata con soldadura nueva y flux. Luego comprueba si hay puentes de soldadura entre los pines de datos y el blindaje. Si tienes un multímetro, confirma que 5V llega al MCU y que D+ y D- no están en cortocircuito con tierra. Una placa que nunca se enumera necesita estas reparaciones antes de cualquier paso de firmware.
Teclas que faltan o se repiten: refluye las uniones sospechosas
Si la placa escribe pero fallan teclas específicas, la unión del diodo o del interruptor de esa fila o columna es la causa probable. Refluye ambos pines del interruptor y el diodo de cada tecla afectada. En una PCB cableada soldable, una sola unión fría puede eliminar una fila entera. Prueba con un probador de teclas o un editor de texto después de cada reflujo para saber qué unión lo solucionó.
Problemas de actualización del firmware: reinicia, luego actualiza
Cuando la PCB se detecta pero las teclas son incorrectas o no funcionan, entra en el bootloader con el botón de reinicio o la combinación de teclas que use tu placa, luego actualiza la disposición correcta. Si VIA o Vial no ven la placa, confirma que el firmware se compiló con el protocolo coincidente. En la versión M0110 QMK/VIA/Vial, Vial aún no se ha actualizado al protocolo V3, por lo que VIA es el configurador fiable hasta que se publique la documentación.
Cuándo detenerse y cambiar de rumbo
Detente si se levanta una almohadilla, el MCU se sobrecalienta o la placa se cortocircuita cada vez que la enchufas. Son fallos a nivel de placa, no problemas de ajuste. Una PCB hot-swap o un kit preconstruido elimina por completo la variable de la soldadura, y un servicio de montaje elimina tanto la soldadura como la configuración del firmware si prefieres escribir a depurar.
Tabla de diagnóstico: síntoma, causa, acción, punto de parada
- Sin detección alguna: Probablemente un cable solo de alimentación, un puerto muerto o una unión del conector USB agrietada. Prueba con un cable de datos en un puerto trasero de la placa base, luego refluye las patillas del conector y comprueba si hay puentes. Si aún no se enumera después de un reflujo limpio, el MCU o la placa es el problema; reemplaza la PCB en lugar de perseguir el firmware.
- Detectada pero algunas teclas muertas: Una unión fría del interruptor o del diodo en esa fila o columna. Refluye ambos pines y el diodo de cada tecla afectada, probando después de cada uno. Si refluir no restaura la tecla, la almohadilla o la pista están dañadas; detente y usa una PCB diferente o una placa hot-swap.
- Escribe pero con caracteres o capas incorrectos: La disposición del firmware no coincide con la construcción física. Entra en el bootloader y actualiza la disposición correcta, luego reasigna en VIA o Vial. Si Vial no puede ver la placa, usa VIA; en la versión M0110 QMK/VIA/Vial, Vial aún no se ha actualizado para el protocolo V3.
- Desconexiones intermitentes mientras se escribe: Una unión USB floja o un problema de tensión del cable. Refluye el conector y usa un cable con alivio de tensión. Si las desconexiones continúan después del reflujo, detente; el conector o el MCU están fallando y una PCB de reemplazo es el camino más seguro.
Opciones de montaje que reducen estos puntos de fallo
- Versión M0110 QMK/VIA/Vial: M0110 QMK/VIA/Vial está certificado basado en el protocolo V3, mientras que el protocolo Vial aún no se ha actualizado; en el momento del envío, el producto solo será compatible con QMK y VIA. Si tu montaje usa esta PCB, configúrala con VIA en lugar de Vial para evitar un configurador que no pueda ver la placa.
- PCB cableada soldable: Este no es un teclado completamente ensamblado; no se puede devolver ni reembolsar y no incluye una garantía de 12 meses. Cómpralo solo si te sientes cómodo diagnosticando uniones de soldadura tú mismo, ya que no hay garantía de respaldo para un error de montaje.
- Kit Vortex Model M SSK - Diseño ISO (Servicio de Montaje): Kit Vortex Model M SSK es un teclado mecánico de aluminio CNC totalmente retroinspirado con retroiluminación RGB, función totalmente hot-swappable, NKRO y compatible con QMK/VIA/Vial para reasignación de teclas o macros. Los zócalos hot-swap eliminan el paso de soldadura que causa la mayoría de los fallos de 'no escribe', y el servicio de montaje se encarga del firmware por ti.
