ESP32-S3 触摸屏与 LVGL：做一个真正能点击的设置页

idf.py --version
# 必须为 ESP-IDF v5.5.5；命令在本项目根目录执行
idf.py set-target esp32s3
idf.py build
idf.py -p REPLACE_WITH_BOX3_USB_PORT flash monitor

/* SPDX-License-Identifier: MIT */
#include <stdio.h>
#include <string.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "freertos/queue.h"
#include "driver/i2c_master.h"
#include "esp_log.h"
#include "nvs.h"
#include "nvs_flash.h"
#include "bsp/esp-bsp.h"
#include "bsp/display.h"
#include "lvgl.h"
#include "settings_model.h"

static const char *TAG = "touch_settings";
static QueueHandle_t requests, results;
/* This model and every lv_obj_t are owned only by the LVGL task. */
static settings_model_t model;
static lv_obj_t *marker, *slider, *save_button, *status_label, *value_label, *point_label;
static bool backlight_error;
static lv_indev_t *touch;

static settings_t load_settings(bool *valid) {
    settings_t s = settings_defaults(); *valid=false;
    nvs_handle_t h;
    esp_err_t e = nvs_open("touch_ui", NVS_READONLY, &h);
    if (e == ESP_ERR_NVS_NOT_FOUND) { ESP_LOGI(TAG,"Missing namespace: defaults are not saved yet"); return s; }
    if (e != ESP_OK) { ESP_LOGE(TAG,"Load open: %s; defaults, no erase",esp_err_to_name(e)); return s; }
    uint8_t blob[4]; size_t size=sizeof(blob);
    e=nvs_get_blob(h,"settings",blob,&size); nvs_close(h);
    if (e==ESP_OK && settings_decode(blob,size,&s)) *valid=true;
    else ESP_LOGW(TAG,"Missing/invalid setting: %s, size=%u; use unsaved defaults",esp_err_to_name(e),(unsigned)size);
    return s;
}
static esp_err_t store_settings(settings_t s) {
    uint8_t blob[4]; settings_encode(s,blob);
    nvs_handle_t h; esp_err_t e=nvs_open("touch_ui",NVS_READWRITE,&h);
    if (e!=ESP_OK) return e;
    e=nvs_set_blob(h,"settings",blob,sizeof(blob));
    if (e==ESP_OK) e=nvs_commit(h);
    nvs_close(h); return e;
}
static void storage_worker(void *unused) {
    (void)unused; settings_t snapshot;
    while (true) {
        if (xQueueReceive(requests,&snapshot,portMAX_DELAY)==pdTRUE) {
            esp_err_t e=store_settings(snapshot);
            ESP_LOGI(TAG,"NVS save snapshot marker=%u brightness=%u result=%s",snapshot.marker,snapshot.brightness,esp_err_to_name(e));
            /* Never call LVGL from this task. One request is in flight. */
            xQueueSend(results,&e,portMAX_DELAY);
        }
    }
}
static void refresh_status(void) {
    lv_label_set_text(status_label,backlight_error ? "Backlight error" : settings_status(&model));
    if (model.busy) lv_obj_add_state(save_button,LV_STATE_DISABLED);
    else lv_obj_remove_state(save_button,LV_STATE_DISABLED);
}
static void controls_changed(lv_event_t *e) {
    (void)e;
    settings_t next={lv_obj_has_state(marker,LV_STATE_CHECKED),(uint8_t)lv_slider_get_value(slider)};
    if (!settings_edit(&model,next)) return;
    lv_label_set_text_fmt(value_label,"Backlight %u%% PWM",next.brightness);
    backlight_error=bsp_display_brightness_set(next.brightness)!=ESP_OK;
    /* The switch marks a small UI dot, not an external load or power relay. */
    lv_obj_t *dot=lv_obj_get_user_data(marker);
    if (next.marker) lv_obj_remove_flag(dot,LV_OBJ_FLAG_HIDDEN);
    else lv_obj_add_flag(dot,LV_OBJ_FLAG_HIDDEN);
    refresh_status();
}
static void save_clicked(lv_event_t *e) {
    (void)e; settings_t snapshot;
    if (!settings_begin_save(&model,&snapshot)) return;
    if (xQueueSend(requests,&snapshot,0)!=pdTRUE) settings_finish_save(&model,false);
    refresh_status();
}
static void save_poll(lv_timer_t *timer) {
    (void)timer; esp_err_t result;
    if (xQueueReceive(results,&result,0)==pdTRUE) { settings_finish_save(&model,result==ESP_OK); refresh_status(); }
}
static void touch_pressed(lv_event_t *e) {
    (void)e; lv_point_t p; lv_indev_get_point(touch,&p);
    lv_label_set_text_fmt(point_label,"Touch x=%ld y=%ld",(long)p.x,(long)p.y);
    ESP_LOGI(TAG,"touch x=%ld y=%ld (LVGL coordinates)",(long)p.x,(long)p.y);
}
static lv_obj_t *label_at(lv_obj_t *parent, int x, int y, const char *text) {
    lv_obj_t *o=lv_label_create(parent); lv_obj_set_pos(o,x,y); lv_label_set_text(o,text); return o;
}
static void create_ui(void) {
    lv_obj_t *screen=lv_screen_active();
    lv_obj_remove_flag(screen,LV_OBJ_FLAG_SCROLLABLE);
    lv_obj_set_style_bg_color(screen,lv_color_hex(0x101C2B),0);
    lv_obj_set_style_text_color(screen,lv_color_white(),0);
    lv_obj_t *title=label_at(screen,12,8,"Settings");
    lv_obj_set_style_text_font(title,&lv_font_montserrat_20,0);
    lv_obj_t *dot=lv_obj_create(screen); lv_obj_set_size(dot,12,12); lv_obj_set_pos(dot,292,13);
    lv_obj_set_style_radius(dot,6,0); lv_obj_set_style_bg_color(dot,lv_color_hex(0x4EE0B0),0);
    lv_obj_set_style_border_width(dot,0,0); lv_obj_remove_flag(dot,LV_OBJ_FLAG_CLICKABLE | LV_OBJ_FLAG_SCROLLABLE);
    if (!model.current.marker) lv_obj_add_flag(dot,LV_OBJ_FLAG_HIDDEN);
    label_at(screen,12,54,"Show marker");
    marker=lv_switch_create(screen); lv_obj_set_pos(marker,232,42); lv_obj_set_size(marker,72,44);
    lv_obj_set_style_bg_color(marker,lv_color_hex(0x1E5E9B),LV_PART_INDICATOR | LV_STATE_CHECKED);
    lv_obj_set_user_data(marker,dot);
    if (model.current.marker) lv_obj_add_state(marker,LV_STATE_CHECKED);
    lv_obj_add_event_cb(marker,controls_changed,LV_EVENT_VALUE_CHANGED,NULL);
    value_label=label_at(screen,12,94,"");
    lv_label_set_text_fmt(value_label,"Backlight %u%% PWM",model.current.brightness);
    slider=lv_slider_create(screen); lv_obj_set_pos(slider,24,130); lv_obj_set_size(slider,272,12);
    lv_slider_set_range(slider,10,100); lv_slider_set_value(slider,model.current.brightness,LV_ANIM_OFF);
    lv_obj_set_ext_click_area(slider,16); /* 44 px high hit area, not a mm guarantee. */
    lv_obj_add_event_cb(slider,controls_changed,LV_EVENT_VALUE_CHANGED,NULL);
    save_button=lv_button_create(screen); lv_obj_set_pos(save_button,12,166); lv_obj_set_size(save_button,112,44);
    lv_obj_set_style_bg_color(save_button,lv_color_hex(0x1E5E9B),0);
    lv_obj_set_style_text_color(save_button,lv_color_white(),0);
    lv_obj_t *text=lv_label_create(save_button); lv_label_set_text(text,"Save"); lv_obj_center(text);
    lv_obj_add_event_cb(save_button,save_clicked,LV_EVENT_CLICKED,NULL);
    status_label=label_at(screen,140,179,"");
    point_label=label_at(screen,12,219,"Touch: not tested");
    lv_obj_set_style_text_font(point_label,&lv_font_montserrat_14,0);
    lv_timer_create(save_poll,100,NULL);
    refresh_status();
}
void app_main(void) {
    esp_err_t e=nvs_flash_init();
    if (e!=ESP_OK) { ESP_LOGE(TAG,"NVS init %s; stop without automatic erase",esp_err_to_name(e)); return; }
    bool valid; settings_t initial=load_settings(&valid);
    settings_init(&model,initial,valid);
    ESP_ERROR_CHECK(bsp_i2c_init());
    i2c_master_bus_handle_t bus=bsp_i2c_get_handle();
    /* Bind this lesson to the BSP's TT21100/ST7789 branch. Address ACK alone
       does not prove the printed controller model; inspect the board first. */
    if (i2c_master_probe(bus,0x24,100)!=ESP_OK ||
        i2c_master_probe(bus,0x5D,100)==ESP_OK || i2c_master_probe(bus,0x14,100)==ESP_OK) {
        ESP_LOGE(TAG,"Unsupported/probe-failed touch combination; require TT21100 at 0x24 and no GT911 branch"); return;
    }
    requests=xQueueCreate(1,sizeof(settings_t)); results=xQueueCreate(1,sizeof(esp_err_t));
    if (!requests || !results || xTaskCreate(storage_worker,"ui_storage",4096,NULL,3,NULL)!=pdPASS) {
        ESP_LOGE(TAG,"Storage queue/task allocation failed"); return;
    }
    lv_display_t *display=bsp_display_start();
    if (!display || !(touch=bsp_display_get_input_dev())) { ESP_LOGE(TAG,"BSP display/touch init failed"); return; }
    backlight_error=bsp_display_brightness_set(initial.brightness)!=ESP_OK;
    if (!bsp_display_lock(1000)) { ESP_LOGE(TAG,"LVGL lock timed out"); return; }
    create_ui();
    lv_indev_add_event_cb(touch,touch_pressed,LV_EVENT_PRESSED,NULL);
    bsp_display_unlock();
    ESP_LOGI(TAG,"Ready; loaded=%u, coordinate/reboot tests remain physical-board checks",valid);
}

cc -std=c11 -Wall -Wextra -Werror -I main host/host_check.c -o /tmp/d06-host
/tmp/d06-host