Andrey Kruchinkin
54f0ba7b0e
Перенесён из KONOR_ds18b20/lib/keypad; в OpticalTester лежала такая же копия. О портах и таймерах библиотека не знает: уровни приходят обратным вызовом read(), время — параметром Keypad_Poll(). События складываются в очередь на восемь штук, поэтому быстрое нажатие не теряется, пока приложение перерисовывает экран.
keypad
Опрос шести кнопок навигации с антидребезгом, автоповтором и удержанием.
Библиотека не знает ни о портах, ни о таймерах: уровни кнопок приходят через
обратный вызов порта, время — параметром Keypad_Poll(). События складываются
в короткую очередь, поэтому быстрое нажатие не теряется, пока приложение
перерисовывает экран.
порт платы keypad.c приложение
read(key) ──────► антидребезг, автоповтор ──► Keypad_GetEvent()
удержание, очередь на 8
Состав
| Файл | Что делает | Зависимости |
|---|---|---|
keypad.h, keypad.c |
шесть кнопок, антидребезг, автоповтор, длинное нажатие, очередь событий | stdint.h |
Кнопок ровно шесть: четыре направления, ввод и возврат — набор покрывает навигацию по меню без матрицы и сдвиговых регистров.
Что нужно от платформы
Один вызов и монотонное время в миллисекундах:
uint8_t read(void *ctx, uint8_t key); /* 1 — кнопка нажата */
Быстрый старт
Keypad keypad;
Keypad_Config config = { .read = board_key_read, .context = &board };
/* нулевые поля заменяются умолчаниями: дребезг 20 мс, автоповтор 400/120 мс,
удержание 800 мс, автоповтор только для стрелок */
Keypad_Init(&keypad, &config);
for (;;) {
Keypad_Poll(&keypad, board_millis());
Keypad_Event event;
while (Keypad_GetEvent(&keypad, &event)) {
if (event.type == KEYPAD_EVENT_PRESS) { /* ... */ }
}
}
Опрашивать Keypad_Poll() достаточно раз в 1..5 мс — из основного цикла
или из системного тика.
Проверено в проектах
KONOR_ds18b20, OpticalTester. Естественная пара — menu:
Keypad_Key отображается в Menu_Key один в один.