250 lines
8.9 KiB
C++
250 lines
8.9 KiB
C++
#include "TdeckmaxKeyboard.h"
|
|
|
|
#include <tactility/log.h>
|
|
|
|
#include <driver/i2c.h>
|
|
#include <driver/gpio.h>
|
|
|
|
constexpr auto* TAG = "TdeckmaxKeyboard";
|
|
|
|
// Keyboard backlight (LED_PWM), GPIO42 on the T-Deck Max.
|
|
constexpr auto BACKLIGHT = GPIO_NUM_42;
|
|
|
|
constexpr auto KB_ROWS = 4;
|
|
constexpr auto KB_COLS = 10;
|
|
|
|
// Keymaps are written in the vendor's row/column orientation
|
|
// (Xinyuan-LilyGO/T-Deck-MAX examples/factory/peri_keypad.cpp). The TCA8418
|
|
// columns are wired in reverse, so the vendor reads keymap[row][9 - col]. We do
|
|
// the same reversal in processKeyboard(), which keeps these tables a direct,
|
|
// verifiable copy of the vendor layout.
|
|
//
|
|
// Modifier keys (ALT and SYM) are blanked here ('\0') and handled by position:
|
|
// ALT -> shift/uppercase, at vendor column 0 of row 2
|
|
// SYM -> symbol layer, at vendor column 8 of row 3
|
|
|
|
// Lowercase (base) layer
|
|
static constexpr char keymap_lc[KB_ROWS][KB_COLS] = {
|
|
{'q', 'w', 'e', 'r', 't', 'y', 'u', 'i', 'o', 'p'},
|
|
{'a', 's', 'd', 'f', 'g', 'h', 'j', 'k', 'l', LV_KEY_BACKSPACE},
|
|
{'\0', 'z', 'x', 'c', 'v', 'b', 'n', 'm', '$', LV_KEY_ENTER},
|
|
{'\0', '\0', '\0', '\0', '\0', LV_KEY_PREV, '0', ' ', '\0', LV_KEY_NEXT}
|
|
};
|
|
|
|
// Uppercase layer (ALT held or caps toggled)
|
|
static constexpr char keymap_uc[KB_ROWS][KB_COLS] = {
|
|
{'Q', 'W', 'E', 'R', 'T', 'Y', 'U', 'I', 'O', 'P'},
|
|
{'A', 'S', 'D', 'F', 'G', 'H', 'J', 'K', 'L', LV_KEY_BACKSPACE},
|
|
{'\0', 'Z', 'X', 'C', 'V', 'B', 'N', 'M', '$', LV_KEY_ENTER},
|
|
{'\0', '\0', '\0', '\0', '\0', LV_KEY_PREV, '0', ' ', '\0', LV_KEY_NEXT}
|
|
};
|
|
|
|
// Symbol layer (SYM held). The T-Deck Max silkscreen for the symbol layer is
|
|
// not documented in the vendor sources, so these are sensible defaults; adjust
|
|
// to match the printed keys once verified on hardware.
|
|
static constexpr char keymap_sy[KB_ROWS][KB_COLS] = {
|
|
{'1', '2', '3', '4', '5', '6', '7', '8', '9', '0'},
|
|
{'@', '#', '+', '-', '*', '/', '(', ')', '_', LV_KEY_BACKSPACE},
|
|
{'\0', '!', '?', ';', ':', '\'', '"', ',', '.', LV_KEY_ENTER},
|
|
{'\0', '\0', '\0', '\0', '\0', LV_KEY_PREV, '0', ' ', '\0', LV_KEY_NEXT}
|
|
};
|
|
|
|
void TdeckmaxKeyboard::readCallback(lv_indev_t* indev, lv_indev_data_t* data) {
|
|
auto keyboard = static_cast<TdeckmaxKeyboard*>(lv_indev_get_user_data(indev));
|
|
|
|
// Emit the release edge for the previous key first: LVGL's keypad handling
|
|
// only delivers a key on a RELEASED->PRESSED transition, so two different
|
|
// keys reported PRESSED back-to-back would swallow the second one.
|
|
if (keyboard->lastKeyNeedsRelease) {
|
|
keyboard->lastKeyNeedsRelease = false;
|
|
data->key = keyboard->lastKey;
|
|
data->state = LV_INDEV_STATE_RELEASED;
|
|
data->continue_reading = uxQueueMessagesWaiting(keyboard->queue) > 0;
|
|
return;
|
|
}
|
|
|
|
char keypress = 0;
|
|
if (xQueueReceive(keyboard->queue, &keypress, 0) == pdPASS) {
|
|
keyboard->lastKey = static_cast<uint32_t>(keypress);
|
|
keyboard->lastKeyNeedsRelease = true;
|
|
data->key = keyboard->lastKey;
|
|
data->state = LV_INDEV_STATE_PRESSED;
|
|
// Drain the whole queue in this read cycle so a typing burst lands in
|
|
// one render pass (and thus a single e-paper refresh).
|
|
data->continue_reading = true;
|
|
} else {
|
|
data->key = 0;
|
|
data->state = LV_INDEV_STATE_RELEASED;
|
|
}
|
|
}
|
|
|
|
void TdeckmaxKeyboard::processKeyboard() {
|
|
bool anykey_pressed = false;
|
|
|
|
// Each update() pops one event from the TCA8418's FIFO. Drain it fully per
|
|
// poll (bounded, in case of a misbehaving bus) so a fast typing burst isn't
|
|
// throttled to one event per poll period. Handling each event as a discrete
|
|
// press/release edge also means a key held across another key's press (fast
|
|
// typing rollover) no longer re-sends its character.
|
|
for (int drained = 0; drained < 16 && keypad->update(); drained++) {
|
|
if (keypad->released_key_count > 0) {
|
|
// Release event: only modifier state cares about releases.
|
|
auto row = keypad->released_list[0].row;
|
|
auto vcol = (KB_COLS - 1) - keypad->released_list[0].col;
|
|
|
|
if ((row == 2) && (vcol == 0)) {
|
|
shiftPressed = false; // ALT key
|
|
}
|
|
if ((row == 3) && (vcol == 8)) {
|
|
symPressed = false; // SYM key
|
|
}
|
|
} else if (keypad->pressed_key_count > 0) {
|
|
// Press event: the key that caused it is the newest list entry.
|
|
auto row = keypad->pressed_list[keypad->pressed_key_count - 1].row;
|
|
auto vcol = (KB_COLS - 1) - keypad->pressed_list[keypad->pressed_key_count - 1].col;
|
|
anykey_pressed = true;
|
|
|
|
if ((row == 2) && (vcol == 0)) {
|
|
shiftPressed = true; // ALT key
|
|
} else if ((row == 3) && (vcol == 8)) {
|
|
symPressed = true; // SYM key
|
|
} else {
|
|
char chr;
|
|
if (symPressed) {
|
|
chr = keymap_sy[row][vcol];
|
|
} else if (shiftPressed || capToggle) {
|
|
chr = keymap_uc[row][vcol];
|
|
} else {
|
|
chr = keymap_lc[row][vcol];
|
|
}
|
|
|
|
// Non-blocking: this runs on the periodic input timer, so a full
|
|
// queue (reader stalled) must drop the keystroke rather than
|
|
// stall this callback and the timer's other periodic work.
|
|
if (chr != '\0' && xQueueSend(queue, &chr, 0) != pdPASS) {
|
|
LOG_W(TAG, "Keyboard queue full, dropping keystroke");
|
|
}
|
|
}
|
|
|
|
if ((symPressed && shiftPressed) && capToggleArmed) {
|
|
capToggle = !capToggle;
|
|
capToggleArmed = false;
|
|
}
|
|
}
|
|
|
|
if ((!symPressed && !shiftPressed) && !capToggleArmed) {
|
|
capToggleArmed = true;
|
|
}
|
|
}
|
|
|
|
if (anykey_pressed) {
|
|
makeBacklightImpulse();
|
|
}
|
|
}
|
|
|
|
bool TdeckmaxKeyboard::startLvgl(lv_display_t* display) {
|
|
backlightOkay = initBacklight(BACKLIGHT, 30000, LEDC_TIMER_0, LEDC_CHANNEL_1);
|
|
keypad->init(KB_ROWS, KB_COLS);
|
|
|
|
assert(inputTimer == nullptr);
|
|
inputTimer = std::make_unique<tt::Timer>(tt::Timer::Type::Periodic, tt::kernel::millisToTicks(20), [this] {
|
|
processKeyboard();
|
|
});
|
|
|
|
assert(backlightImpulseTimer == nullptr);
|
|
backlightImpulseTimer = std::make_unique<tt::Timer>(tt::Timer::Type::Periodic, tt::kernel::millisToTicks(50), [this] {
|
|
processBacklightImpulse();
|
|
});
|
|
|
|
kbHandle = lv_indev_create();
|
|
lv_indev_set_type(kbHandle, LV_INDEV_TYPE_KEYPAD);
|
|
lv_indev_set_read_cb(kbHandle, &readCallback);
|
|
lv_indev_set_display(kbHandle, display);
|
|
lv_indev_set_user_data(kbHandle, this);
|
|
|
|
inputTimer->start();
|
|
backlightImpulseTimer->start();
|
|
|
|
return true;
|
|
}
|
|
|
|
bool TdeckmaxKeyboard::stopLvgl() {
|
|
assert(inputTimer);
|
|
inputTimer->stop();
|
|
inputTimer = nullptr;
|
|
|
|
assert(backlightImpulseTimer);
|
|
backlightImpulseTimer->stop();
|
|
backlightImpulseTimer = nullptr;
|
|
|
|
lv_indev_delete(kbHandle);
|
|
kbHandle = nullptr;
|
|
return true;
|
|
}
|
|
|
|
bool TdeckmaxKeyboard::isAttached() const {
|
|
return i2c_controller_has_device_at_address(keypad->getController(), keypad->getAddress(), 100) == ERROR_NONE;
|
|
}
|
|
|
|
bool TdeckmaxKeyboard::initBacklight(gpio_num_t pin, uint32_t frequencyHz, ledc_timer_t timer, ledc_channel_t channel) {
|
|
backlightPin = pin;
|
|
backlightTimer = timer;
|
|
backlightChannel = channel;
|
|
|
|
ledc_timer_config_t ledc_timer = {
|
|
.speed_mode = LEDC_LOW_SPEED_MODE,
|
|
.duty_resolution = LEDC_TIMER_8_BIT,
|
|
.timer_num = backlightTimer,
|
|
.freq_hz = frequencyHz,
|
|
.clk_cfg = LEDC_AUTO_CLK,
|
|
.deconfigure = false
|
|
};
|
|
|
|
if (ledc_timer_config(&ledc_timer) != ESP_OK) {
|
|
LOG_E(TAG, "Backlight timer config failed");
|
|
return false;
|
|
}
|
|
|
|
ledc_channel_config_t ledc_channel = {
|
|
.gpio_num = backlightPin,
|
|
.speed_mode = LEDC_LOW_SPEED_MODE,
|
|
.channel = backlightChannel,
|
|
.intr_type = LEDC_INTR_DISABLE,
|
|
.timer_sel = backlightTimer,
|
|
.duty = 0,
|
|
.hpoint = 0,
|
|
.sleep_mode = LEDC_SLEEP_MODE_NO_ALIVE_NO_PD,
|
|
.flags = {
|
|
.output_invert = 0
|
|
}
|
|
};
|
|
|
|
if (ledc_channel_config(&ledc_channel) != ESP_OK) {
|
|
LOG_E(TAG, "Backlight channel config failed");
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
bool TdeckmaxKeyboard::setBacklightDuty(uint8_t duty) {
|
|
if (!backlightOkay) {
|
|
LOG_E(TAG, "Backlight not ready");
|
|
return false;
|
|
}
|
|
return (ledc_set_duty(LEDC_LOW_SPEED_MODE, backlightChannel, duty) == ESP_OK) &&
|
|
(ledc_update_duty(LEDC_LOW_SPEED_MODE, backlightChannel) == ESP_OK);
|
|
}
|
|
|
|
void TdeckmaxKeyboard::makeBacklightImpulse() {
|
|
backlightImpulseDuty = 255;
|
|
setBacklightDuty(backlightImpulseDuty);
|
|
}
|
|
|
|
void TdeckmaxKeyboard::processBacklightImpulse() {
|
|
if (backlightImpulseDuty > 0) {
|
|
backlightImpulseDuty--;
|
|
setBacklightDuty(backlightImpulseDuty);
|
|
}
|
|
}
|