Los dos modos terminan en los mismos manejadores por pantalla (
dispatchPress() / dispatchLongPress() en zerokey-io.cpp), así que cada pantalla se comporta igual sea cual sea el modo. Descripción para el usuario: Gestos.
Hardware
El firmware enmascara la salida con
0x3E para los pads (0x3F al leer, para que el bit ND nunca cuente como toque).
Inicialización del TS06
El TS06 no guarda su configuración al apagarse, así queconfigureTouchController() (zerokey-setup.cpp) se ejecuta en cada arranque, en el orden del flujo de encendido del datasheet, y vuelve a leer cada registro; si algo no se quedó, lo reintenta una vez.
Antes de la 1.1.0 el firmware solo escribía la sensibilidad, Ch_hold y Ref_rst; CTRL2 no se escribía nunca. Como además el chip es físicamente menos sensible en CH4–CH6, el pad Izquierda es el menos sensible y Derecha el que más. Cualquier cambio de sensibilidad hay que comprobarlo antes en el hardware.
Sondeo
handleButtonChecker() se llama desde el bucle de Arduino. La espera del bucle depende del modo (loopDelayMs()): 10 ms en Gestos (el reconocedor necesita tiempos finos), 30 ms en Botones.
Modo Botones
Una pulsación larga muestra un borde que se va llenando alrededor de la pantalla (
drawLongPressProgress()); soltar antes la cancela.
Modo Gestos: el reconocedor
El reconocedor (zerokey-gesture.cpp, espacio de nombres zkgesture) es lógica pura sin acceso al hardware. Recibe una máscara lógica de pads en cada sondeo, ya reasignada para la pantalla girada 180° del modo zurdo, así que “arriba” es siempre el pad que el usuario ve arriba.
La yema del dedo es más ancha que el hueco entre pads, así que a menudo hay dos o tres bits activos a la vez. En lugar de “gana el primero”, un toque es una sesión desde el primer pad hasta que todos llevan releaseMs apagados, y se juzga por dónde empezó y dónde terminó. Los pads se tratan como puntos (Arriba (0,+1), Abajo (0,−1), Izquierda (−1,0), Derecha (+1,0), Centro (0,0)) y se compara el centroide de cada conjunto:
- Deslizamiento: el centroide se movió al menos un pad a lo largo de un eje (y el doble que en el otro), el dedo llegó a un pad que no estaba bajo él al empezar, en el lado hacia el que se movió, y, si el pad del lado opuesto del recorrido se tocó, se tocó primero. Por eso pulsar todo a la vez nunca es un deslizamiento, se suelten los pads en el orden que se suelten.
- Toque / Largo: no hay deslizamiento y el centro formó parte del toque, solo, con vecinos o los cinco pads. Largo si el centro se mantuvo ≥
holdMs. - Suelto: no hay deslizamiento y solo se tocaron pads exteriores; no es una orden. La pantalla muestra un aviso con el deslizamiento que hace lo que habría hecho ese pad.
commitMs mantenido sin moverse, el toque queda fijado como pulsación del centro y ya no puede convertirse en deslizamiento.
Los umbrales del centroide van en 1/60 de la separación entre pads: 60 (un pad) con el dedo apoyado, 45 (¾ de pad) al juzgar un toque terminado.
Eventos:
EV_SWIPE, EV_SWIPE_HOLD (dedo apoyado tras deslizar), EV_SWIPE_REPEAT, EV_TAP, EV_LONG, EV_STRAY.
El reconocedor tiene pruebas unitarias en el PC (ZerokeyOS/tests/) que reproducen secuencias simuladas: deslizamientos limpios, golpes rápidos, huecos entre pads, pulsaciones imprecisas, los cinco pads a la vez.
Del gesto a la acción
En las pantallas cuyo contenido se mueve entero, deslizar arrastra el contenido, como en un móvil, así que la acción es la contraria a la dirección del dedo (gestureAction()):
En el teclado del PIN los dígitos forman una tira que se arrastra como las cuentas (de derecha a izquierda se añade), mientras que la rueda sigue al dedo (deslizar hacia arriba = el valor siguiente sube desde abajo). Ahí un toque no hace nada, así que el PIN nunca se confirma sin querer.
Deslizar y mantener:
Las páginas de confirmación críticas (reset de fábrica, bootloader, autorización de importar/exportar) se disparan con el centro aún mantenido, tras
HOLD_CONFIRM_MS = 1,5 s, con el mismo borde que se llena. Mantener el centro 10 s en la pantalla del PIN activa o desactiva el lector de pantalla HID (SCREEN_READER_HOLD_MS). El aviso por toque suelto se ve durante GESTURE_HINT_MS = 1,2 s.
Controles de la pantalla del PIN
Tras cada dígito la rueda se para en el ✓. En el asistente, borrar sin ningún dígito vuelve a la tarjeta “Crea tu PIN”.
Errores
- Si el TS06 no se detecta al arrancar, el táctil queda desactivado y el log serie lo indica; no hay error en pantalla.
- El táctil se ignora durante las esperas por PIN erróneo y las operaciones largas (borrado de credenciales).
- El TS06 comparte el bus I²C con la EEPROM, el ATECC608A y la OLED; el sondeo se intercala con ese tráfico en el bucle principal cooperativo.