El firmware del repositorio rechaza asignación dinámica de heap y APIs de cadenas inseguras o sin límite, manteniendo predecible el uso de recursos en el microcontrolador de producción.
Público · Sistema de entrada embebido
QMK / Vial / Halcyon
Un proyecto integrado de sistema de entrada que abarca firmware QMK/Vial, ergonomía física, interacción TFT y encoder, configuración persistente Raw HID, herramientas Vial para el host y un Atlas visual para Ferris Sweep.
- Nicho
- Entrada ergonómica compacta con estado visible
- Stack principal
- C · QMK · Vial · Raw HID · WebHID
- Hardware
- Halcyon Ferris · mitades TFT + encoder
- Study
- Comportamiento físico, configuración desde el host y modelado visual
Keyboard Atlas
El Atlas desplegado modela la geometría, las capas, los acordes y el estado de interacción de Ferris Sweep como compañero visual del firmware. Funciona como documentación y como instrumento de diseño para estudiar cómo el comportamiento abstracto de las teclas se proyecta sobre el teclado físico.
Open Keyboard Atlas ↗Vista del sistema
FirmwareProtocolo Raw HIDCentro de control VialKeyboard Atlas
El estudio
Un teclado dividido de 34 teclas se convierte en una herramienta coherente cuando alcance físico, transiciones de capa, estado de pantalla y configuración desde el host se diseñan como un solo sistema de interacción.
La capa alfa proporciona una base espacial estable. Capas momentáneas, acordes de fila base, encoders y repetición amplían esa base mientras el TFT y el estado RGB hacen visible el comportamiento activo. Las herramientas del host exponen el mismo modelo para inspección y ajuste.
System composition
Firmware, software de configuración y documentación visual comparten responsabilidades explícitas.
Comportamiento del firmware
QMK/Vial gestiona semántica de entrada en ejecución, persistencia, coordinación del split, estado TFT y comportamiento de encoder.
Configuración desde el host
Un protocolo Raw HID tipado transporta configuración persistente y telemetría entre el teclado y las interfaces Vial conscientes de capacidades.
Modelo físico
El Atlas describe stagger, arco de pulgar, posiciones, capas y acordes reales de Ferris, con comprobaciones geométricas que mantienen la representación alineada con el teclado.
Evidencia de release
Configuración canónica, dependencias fijadas, comprobaciones de fuente, builds de firmware y aceptación de hardware aportan formas distintas de verificación.
Diseño de producto e interacción
El teclado físico es la superficie principal de diseño y las herramientas de software hacen legible su estado.
La colocación de capas parte del alcance y la frecuencia. Pulsaciones mantenidas y acordes breves mantienen las transiciones comunes cerca de la posición base, mientras la dirección del encoder sigue un modelo semántico estable entre contextos.
El TFT, los perfiles RGB y el Atlas ofrecen vistas complementarias del mismo sistema: estado inmediato en el dispositivo, comportamiento configurable en el host y una visión espacial para estudio y documentación.
Lectura arquitectónica
El firmware es la autoridad; las herramientas de host y el Atlas son proyecciones conscientes de capacidades del estado embebido.
El sistema trata memoria, flash, transporte entre mitades y ciclo de vida del dispositivo como restricciones arquitectónicas de primera clase. Raw HID tipado delimita la comunicación con Vial sin sacar del teclado la propiedad del comportamiento en ejecución.
Lint estricto de QMK, compilación del teclado y keymap exactos, informes de recursos, comprobaciones de procedencia y validación de release convierten supuestos de hardware en evidencia repetible de CI.
TFT, RGB, Vial y Keyboard Atlas muestran perspectivas distintas del mismo modelo de capas, acordes y configuración, sin crear fuentes de verdad competidoras.
El Atlas conserva stagger, arco de pulgares y posiciones reales para revisar las abstracciones del firmware contra el cuerpo y el dispositivo que afectan.
Enfoque de desarrollo
El propio teclado es el estudio de diseño: el uso físico produce observaciones, el Atlas hace visibles las relaciones y las comprobaciones repetibles convierten el comportamiento estable en evidencia de ingeniería.
Un cambio puede comenzar como experimento táctil con un acorde, ritmo de pantalla, pareja de encoder o relación de color. La misma idea puede examinarse mediante telemetría y Atlas antes de quedar recogida en configuración, pruebas y artefactos de release.
El firmware gestiona persistencia y comportamiento en ejecución; las interfaces Vial gestionan edición y validación; el Atlas gestiona la explicación espacial. Esta separación favorece la experimentación rápida y mantiene cada contrato explícito y revisable.