Files
Sprinter-SDCC/libc/kbd/_kbdraw.h
T
snark13 3c0baacbf6 libc/kbd: recovery по Rx-overrun SIO (залипание клавиш) + kbd_raw_sync
Симптом (интермиттентный): при отпускании shift+стрелка иногда стрелка
залипает.  Диагностика: на чистом одновременном release break-коды
обрабатываются верно (проверено MCP) → drain-логика ISR корректна.
Остаточное залипание = переполнение 3-байтного аппаратного FIFO SIO при
пачке скан-кодов (F0 12 E0 F0 74 = 5 байт) во время длинных DI-окон →
потерян break → залипание.

Фикс: трамплин после drain читает RR1 SIO (бит5 = Rx Overrun), при
overrun делает Error Reset (WR0=0x30) и взводит _kbdraw_overrun.
Новый kbd_raw_sync() (звать раз в кадр) по флагу сбрасывает всё
held-состояние _kbdraw_down (какой break потерян — неизвестно; реально
зажатые перечитаются).  pop_ctrl_tick зовёт kbd_raw_sync().  Буфер W2-
трамплина 288→320 (трамплин 244 Б).

ВНИМАНИЕ: путь overrun НЕ проверен детерминированно (баг интермиттентный,
зависит от тайминга DI) — ТРЕБУЕТ ПРОВЕРКИ на железе/в длинной сессии.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-18 12:26:42 +03:00

30 lines
1.6 KiB
C

/*
* _kbdraw.h — внутренности raw-канала клавиатуры (НЕ публичный
* заголовок; публичный интерфейс — <kbd_raw.h>).
*
* Всё состояние — плоские глобалы (живут в W2/_DATA во ВСЕХ memory-
* режимах, см. sprinter_memory_modes) — трамплин прерывания
* (libc/irq/_irq_tramp.c) обращается к ним БЕЗ W1-remap и без call,
* поэтому раскладка памяти приложения тут ни при чём.
*/
#ifndef _KBDRAW_INTERNAL_H
#define _KBDRAW_INTERNAL_H
#include <stdint.h>
/* Биты _kbdraw_pending — накопленные префиксы PS/2 Scan Code Set 2,
* ждущие завершающего байта кода (см. _irq_tramp.c). */
#define _KBDRAW_PEND_BREAK 0x01
#define _KBDRAW_PEND_EXT 0x02
extern uint8_t _kbdraw_active; /* 0 = raw выключен (дефолт, трамплин
* ведёт себя как раньше — прямо к DSS) */
extern uint8_t _kbdraw_pending; /* FSM декодера make/break, см. выше */
extern uint8_t _kbdraw_overrun; /* 1 = ISR поймал Rx-overrun SIO (потерян
* байт → возможно потерян break); снимает
* kbd_raw_sync (чистит _kbdraw_down) */
extern uint8_t _kbdraw_down[512]; /* 0/1 по коду; +256 для расширенных
* (префикс 0xE0) — см. kbd_raw_down */
#endif