#include #if defined(CONFIG_TT_TOUCH_CALIBRATION_SUPPORTED) #include #include #include #include #include #include #include #include #include #include #include #include #include namespace tt::app::touchcalibration { constexpr auto* TAG = "TouchCalibration"; extern const ::AppManifest manifest; namespace { constexpr int32_t TARGET_MARGIN = 24; struct Sample { uint16_t x; uint16_t y; }; struct Context { uint32_t appInstanceId; Sample samples[4] = {}; uint8_t sampleCount = 0; bool calibrationApplied = false; lv_obj_t* root = nullptr; lv_obj_t* target = nullptr; lv_obj_t* titleLabel = nullptr; lv_obj_t* hintLabel = nullptr; }; lv_point_t getTargetPoint(uint8_t index, lv_coord_t width, lv_coord_t height) { switch (index) { case 0: return {.x = TARGET_MARGIN, .y = TARGET_MARGIN}; case 1: return {.x = width - TARGET_MARGIN, .y = TARGET_MARGIN}; case 2: return {.x = width - TARGET_MARGIN, .y = height - TARGET_MARGIN}; default: return {.x = TARGET_MARGIN, .y = height - TARGET_MARGIN}; } } void updateUi(Context* ctx) { if (ctx->target == nullptr || ctx->root == nullptr || ctx->titleLabel == nullptr || ctx->hintLabel == nullptr) { return; } const auto width = lv_obj_get_content_width(ctx->root); const auto height = lv_obj_get_content_height(ctx->root); if (ctx->sampleCount < 4) { const auto point = getTargetPoint(ctx->sampleCount, width, height); lv_obj_set_pos(ctx->target, point.x - 14, point.y - 14); lv_label_set_text(ctx->titleLabel, "Touchscreen Calibration"); lv_label_set_text_fmt(ctx->hintLabel, "Tap target %u/4", static_cast(ctx->sampleCount + 1)); } } // Drives the on-screen outcome text/state; the actual result (Ok/Error) is reported to the // caller from onPress() below, via ctx->calibrationApplied, once the user taps to dismiss. void finishCalibration(Context* ctx) { const int32_t xLow = (static_cast(ctx->samples[0].x) + static_cast(ctx->samples[3].x)) / 2; const int32_t xHigh = (static_cast(ctx->samples[1].x) + static_cast(ctx->samples[2].x)) / 2; const int32_t yLow = (static_cast(ctx->samples[0].y) + static_cast(ctx->samples[1].y)) / 2; const int32_t yHigh = (static_cast(ctx->samples[2].y) + static_cast(ctx->samples[3].y)) / 2; // Targets sit TARGET_MARGIN in from each edge (see getTargetPoint()), not at the screen // edges themselves - xLow/xHigh/yLow/yHigh are raw samples at those inset positions, not // at 0/width or 0/height. Extrapolate them out to the true edges so the saved range (which // lvgl_pointer.h maps onto the full [0, resolution) display range) lines up correctly // across the whole screen instead of being off by a margin's worth of scale and offset. const auto width = lv_obj_get_content_width(ctx->root); const auto height = lv_obj_get_content_height(ctx->root); const int32_t xSpan = static_cast(width) - 2 * TARGET_MARGIN; const int32_t ySpan = static_cast(height) - 2 * TARGET_MARGIN; if (xSpan <= 0 || ySpan <= 0) { lv_label_set_text(ctx->titleLabel, "Calibration Failed"); lv_label_set_text(ctx->hintLabel, "Screen too small. Tap to close."); lv_obj_add_flag(ctx->target, LV_OBJ_FLAG_HIDDEN); return; } const int32_t xMin = xLow - (xHigh - xLow) * TARGET_MARGIN / xSpan; const int32_t xMax = xHigh + (xHigh - xLow) * TARGET_MARGIN / xSpan; const int32_t yMin = yLow - (yHigh - yLow) * TARGET_MARGIN / ySpan; const int32_t yMax = yHigh + (yHigh - yLow) * TARGET_MARGIN / ySpan; settings::touch::TouchCalibrationSettings settings = settings::touch::getDefault(); settings.enabled = true; settings.xMin = xMin; settings.xMax = xMax; settings.yMin = yMin; settings.yMax = yMax; if (!settings::touch::isValid(settings)) { lv_label_set_text(ctx->titleLabel, "Calibration Failed"); lv_label_set_text(ctx->hintLabel, "Range invalid. Tap to close."); lv_obj_add_flag(ctx->target, LV_OBJ_FLAG_HIDDEN); return; } if (!settings::touch::save(settings)) { lv_label_set_text(ctx->titleLabel, "Calibration Failed"); lv_label_set_text(ctx->hintLabel, "Unable to save settings. Tap to close."); lv_obj_add_flag(ctx->target, LV_OBJ_FLAG_HIDDEN); return; } LvglPointerCalibration calibration = { .x_min = xMin, .x_max = xMax, .y_min = yMin, .y_max = yMax, }; lvgl_lock(); auto* indev = lvgl_pointer_get_default(); if (indev != nullptr) { lvgl_pointer_set_calibration(indev, &calibration); } lvgl_unlock(); ctx->calibrationApplied = true; LOG_I(TAG, "Saved calibration x=[%d, %d] y=[%d, %d]", xMin, xMax, yMin, yMax); lv_label_set_text(ctx->titleLabel, "Calibration Complete"); lv_label_set_text(ctx->hintLabel, "Touch anywhere to continue."); lv_obj_add_flag(ctx->target, LV_OBJ_FLAG_HIDDEN); } void onPress(lv_event_t* event) { auto* ctx = static_cast(lv_event_get_user_data(event)); auto* indev = lv_event_get_indev(event); if (indev == nullptr) { return; } lv_point_t point = {0, 0}; lv_indev_get_point(indev, &point); if (ctx->sampleCount < 4) { ctx->samples[ctx->sampleCount] = { .x = static_cast(std::max(static_cast(0), point.x)), .y = static_cast(std::max(static_cast(0), point.y)), }; ctx->sampleCount++; if (ctx->sampleCount < 4) { updateUi(ctx); } else { finishCalibration(ctx); } return; } app_event_emit_close(ctx->appInstanceId); } void createWidgets(lv_obj_t* parent, void* userData) { auto* ctx = static_cast(userData); lv_obj_set_style_bg_color(parent, lv_color_black(), LV_STATE_DEFAULT); lv_obj_set_style_bg_opa(parent, LV_OPA_COVER, LV_STATE_DEFAULT); lv_obj_set_style_border_width(parent, 0, LV_STATE_DEFAULT); lv_obj_set_style_radius(parent, 0, LV_STATE_DEFAULT); ctx->root = lv_obj_create(parent); lv_obj_set_size(ctx->root, LV_PCT(100), LV_PCT(100)); lv_obj_set_style_bg_opa(ctx->root, LV_OPA_TRANSP, LV_STATE_DEFAULT); lv_obj_set_style_border_width(ctx->root, 0, LV_STATE_DEFAULT); lv_obj_set_style_pad_all(ctx->root, 0, LV_STATE_DEFAULT); ctx->titleLabel = lv_label_create(ctx->root); lv_obj_align(ctx->titleLabel, LV_ALIGN_TOP_MID, 0, 14); lv_obj_set_style_text_color(ctx->titleLabel, lv_color_white(), LV_STATE_DEFAULT); lv_label_set_text(ctx->titleLabel, "Touchscreen Calibration"); ctx->hintLabel = lv_label_create(ctx->root); lv_obj_align(ctx->hintLabel, LV_ALIGN_BOTTOM_MID, 0, -14); lv_obj_set_style_text_color(ctx->hintLabel, lv_color_white(), LV_STATE_DEFAULT); lv_label_set_text(ctx->hintLabel, "Tap target 1/4"); ctx->target = lv_button_create(ctx->root); lv_obj_set_size(ctx->target, 28, 28); lv_obj_set_style_radius(ctx->target, LV_RADIUS_CIRCLE, LV_STATE_DEFAULT); lv_obj_set_style_bg_color(ctx->target, lv_palette_main(LV_PALETTE_RED), LV_STATE_DEFAULT); // Ensure root receives all presses for sampling. lv_obj_remove_flag(ctx->target, LV_OBJ_FLAG_CLICKABLE); auto* targetLabel = lv_label_create(ctx->target); lv_label_set_text(targetLabel, "+"); lv_obj_center(targetLabel); lv_obj_add_flag(ctx->root, LV_OBJ_FLAG_CLICKABLE); lv_obj_add_event_cb(ctx->root, onPress, LV_EVENT_PRESSED, ctx); updateUi(ctx); } int32_t appMain(int argc, char* argv[]) { uint32_t appInstanceId = app_scheduler_current_app_id(); Context ctx {}; ctx.appInstanceId = appInstanceId; // Clear any active calibration so the taps sampled below are raw, uncalibrated coordinates. lvgl_lock(); auto* startIndev = lvgl_pointer_get_default(); if (startIndev != nullptr) { lvgl_pointer_set_calibration(startIndev, nullptr); } lvgl_unlock(); TaskEventGroup event_group {}; task_event_group_construct(&event_group); AppEventSubscription sub {}; check(app_event_subscribe(&sub, &event_group) == ERROR_NONE); WindowId window = window_manager_create(appInstanceId, createWidgets, &ctx); bool shouldClose = false; while (!shouldClose) { task_event_group_wait_any(&event_group, nullptr, portMAX_DELAY); AppEvent event {}; while (app_event_poll(&sub, &event) == ERROR_NONE) { switch (event.type) { case APP_EVENT_CLOSE: shouldClose = true; break; default: break; } if (shouldClose) break; } } window_manager_remove(window); check(app_event_unsubscribe(&sub) == ERROR_NONE); task_event_group_destruct(&event_group); // finishCalibration() already applied a new calibration on success. On cancel/failure, // restore whatever calibration was on disk before the block above cleared it. if (!ctx.calibrationApplied) { settings::touch::TouchCalibrationSettings settings; lvgl_lock(); auto* endIndev = lvgl_pointer_get_default(); if (endIndev != nullptr && settings::touch::load(settings) && settings.enabled && settings::touch::isValid(settings)) { LvglPointerCalibration calibration = { .x_min = settings.xMin, .x_max = settings.xMax, .y_min = settings.yMin, .y_max = settings.yMax, }; lvgl_pointer_set_calibration(endIndev, &calibration); } lvgl_unlock(); } return ctx.calibrationApplied ? 0 : 2; // Ok : Error } } // namespace uint32_t start(uint32_t callerAppInstanceId) { uint32_t instanceId = 0; app_manager_start_for_result(manifest.id, callerAppInstanceId, 0, nullptr, &instanceId); return instanceId; } extern const ::AppManifest manifest = { .id = "tactility.touchcalibration", .name = "Touch Calibration", .category = APP_CATEGORY_SETTINGS, .location = { APP_LOCATION_MEMORY, reinterpret_cast(appMain) } }; } // namespace tt::app::touchcalibration #endif // defined(CONFIG_TT_TOUCH_CALIBRATION_SUPPORTED)