Исправление точности сенсорного управления ESP32 CYD: Полное руководство по профессиональной калибровке

Понимание ESP32 CYD Аппаратная архитектура

Ключевые характеристики, имеющие значение

• Отображение: 2,8-дюймовый TFT ЖК-дисплей ILI9341
• Разрешение: 240×320 пикселей (портрет), фактически 320×240 в альбомной ориентации.
• Сенсорный контроллер: Контроллер резистивного сенсорного экрана XPT2046
• ИнтерфейсSPI-связь для дисплея и сенсорного экрана.
• Конфигурация контактов:
  • T_IRQ (Прерывание): GPIO 36
  • Т_ДИН (MOSI): GPIO 32
  • Т_ВЫ (MISO): GPIO 39
  • T_CLK: GPIO 25
  • Т_КС (Выбор микросхемы): GPIO 33

Почему резистивным сенсорным экранам необходима калибровка?

• Нажатия кнопок регистрируются с небольшим отклонением от цели.
• Ввод с клавиатуры становится досадно неточным.
• Графические редакторы создают неровные, смещенные линии.
• Качество пользовательского опыта значительно ухудшается.

Методология шеститочечной калибровки

x_screen = alphaX * x_touch + betaX * y_touch + deltaX y_screen = alphaY * x_touch + betaY * y_touch + deltaY

• (x_touch, y_touch) это необработанные значения с контроллера XPT2046.
• (x_screen, y_screen) являются скорректированными координатами отображения
• альфа, бета, и дельта Шесть калибровочных коэффициентов являются уникальными для каждого устройства.

Пошаговый процесс профессиональной калибровки.

Предварительные условия: Настройка библиотеки для производственной среды.

Необходимые библиотеки

1. LVGL (Light and Versatile Graphics Library) v9.2+
   • Предоставляет графический интерфейс пользователя для отображения калибровочных мишеней.
   • Скачать с: https://lvgl.io/
   • КритическийИспользуйте конкретный lv_conf.h Конфигурационный файл предоставлен сайтом Random Nerd Tutorials, или же его следует адаптировать с осторожностью. Стандартные конфигурации часто дают сбой.
2. TFT_eSPI Бодмер
   • Обрабатывает низкоуровневую связь с дисплеем.
   • Настройка User_Setup.h специально для CYD (Выводы GPIO, вращение и т. д.)
3. XPT2046_Сенсорный экран Пол Стоффреген
   • Взаимодействие с резистивным сенсорным контроллером
   • Помимо определения контактов, дополнительная настройка не требуется.
4. Основы линейной алгебры Автор: Том Стюарт (версия 5.1+)
   • Выполняет матричные операции для вычисления коэффициентов.
   • Установка через Arduino IDE: Скетч → Включить библиотеку → Управление библиотеками

Проверка конфигурации контактов

#определять XPT2046_IRQ 36   // T_IRQ
#определять XPT2046_MOSI 32  // T_DIN
#определять XPT2046_MISO 39  // T_OUT
#определять XPT2046_CLK 25   // T_CLK
#определять XPT2046_CS 33    // T_CS

Эскиз калибровки: готовый к внедрению код.

/*
 * Профессиональная калибровка сенсорного экрана ESP32 CYD
 * На основе примечания к применению TI slyt277
 * Адаптировано для коммерческого использования компанией [Название вашей компании]
 */

#включать <lvgl.h>
#включать <TFT_eSPI.h>
#включать <XPT2046_Touchscreen.h>
#включать <BasicLinearAlgebra.h>
#включать <Preferences.h>  // Для постоянного хранения

// Определения контактов сенсорного экрана
#определять XPT2046_IRQ 36
#определять XPT2046_MOSI 32
#определять XPT2046_MISO 39
#определять XPT2046_CLK 25
#определять XPT2046_CS 33

Сенсорный экран SPIClass SPI = SPIClass(ВСПИ);
XPT2046_Сенсорный экран сенсорный экран(XPT2046_CS, XPT2046_IRQ);

#определять ШИРИНА_ЭКРАНА 240
#определять ВЫСОТА_ЭКРАНА 320

// Точки калибровки (6-точечный метод)
константа инт scr_points[6][2] = { 
  {13, 11}, {20, 220}, {167, 60}, 
  {155, 180}, {300, 13}, {295, 225} 
};

// Коэффициенты переменных
плавать альфаХ, бетаX, дельтаX, альфаY, бета-, дельтаY;
Предпочтения предпочтения;

// ... [Остальная часть логики калибровки, включая gather_cal_data(), 
// compute_transformation_coefficients() и ts_calibration()]
// Полный код доступен в репозитории GitHub, ссылка на который приведена ниже.

• Интегрированный Настройки библиотека для постоянного хранения коэффициентов
• Усовершенствованный алгоритм отбрасывания выбросов (фильтрует выборки, выходящие за пределы одного стандартного отклонения).
• Механизм автоматической повторной попытки, если ошибка калибровки превышает пороговое значение.
• Последовательный вывод форматируется для удобного анализа автоматизированными системами тестирования.

Протокол выполнения

1. Загрузите калибровочный эскиз. к вашему ESP32 CYD
2. Открытый последовательный монитор со скоростью 115200 бод
3. Дождитесь инструкцийНа экране появится сообщение “Нажимайте на каждый перекрестие, пока оно не исчезнет”.”
4. Точное нарезание резьбыИспользуйте прилагаемый стилус, чтобы точно нажать на центр каждого красного перекрестия (+) в момент его появления.
   • Постучите сильно, но мягко.
   • Удерживайте примерно 500 мс на каждое нажатие.
   • Подождите, пока перекрестие прицела исчезнет, прежде чем продолжить.
5. Этап проверкиПосле шести нажатий система отображает синие перекрестия (ожидаемые положения) и красные отметки «X» (ваши фактические нажатия).
6. Проанализируйте показатели ошибок.Проверьте последовательный монитор на наличие ошибок.
   • Допустимая погрешность: < 5 пикселей
   • Если ошибка превышает 10 пикселей, выполните сброс и повторную калибровку.

Извлечение и хранение коэффициентов

****************************************************************** ИСПОЛЬЗУЙТЕ СЛЕДУЮЩИЕ ЗНАЧЕНИЯ КОЭФФИЦИЕНТОВ ДЛЯ КАЛИБРОВКИ СЕНСОРНОГО ЭКРАНА Вычисленное X: alpha_x = -0.000, beta_x = 0.090, delta_x = -33.771 Вычисленное Y: alpha_y = 0.066, beta_y = 0.000, delta_y = -14.632 ******************************************************************

Вариант А: Жестко заданные коэффициенты (одна единица)

пустота touchscreen_read(lv_indev_t * indev, lv_indev_data_t * данные) {
  если(сенсорный экран.tirqTouched() && сенсорный экран.тронут()) {
    TS_Point p = сенсорный экран.получить точку();
    
    // ЗАМЕНИТЕ НА ВАШИ ОТКАЛИБРОВАННЫЕ ЗНАЧЕНИЯ
    плавать альфа_х = -0.000;
    плавать бета_х = 0.090;
    плавать дельта_х = -33.771;
    плавать альфа_й = 0.066;
    плавать бета_й = 0.000;
    плавать дельта_й = -14.632;
    
    // Применить преобразование
    инт x = альфа_й * p.x + бета_й * p.y + дельта_й;
    инт y = альфа_х * p.x + бета_х * p.y + дельта_х;
    
    // Ограничение границами экрана
    x = макс(0, мин(ШИРИНА_ЭКРАНА - 1, x));
    y = макс(0, мин(ВЫСОТА_ЭКРАНА - 1, y));
    
    данные->точка.x = x;
    данные->точка.y = y;
    данные->состояние = LV_INDEV_STATE_PRESSED;
  } еще {
    данные->состояние = LV_INDEV_STATE_RELEASED;
  }
}

Вариант B: Постоянное хранение (массовое производство)

// Сохранение коэффициентов после калибровки
предпочтения.начинать(""cyd-калибровка"", ЛОЖЬ);
предпочтения.putFloat(""alphaX"", альфаХ);
предпочтения.putFloat(""бетаX"", бетаX);
предпочтения.putFloat(""deltaX"", дельтаX);
предпочтения.putFloat(""альфаY"", альфаY);
предпочтения.putFloat(""бетаY"", бета-);
предпочтения.putFloat(""deltaY"", дельтаY);
предпочтения.конец();

// Коэффициенты нагрузки при запуске
предпочтения.начинать(""cyd-калибровка"", истинный);
альфаХ = предпочтения.getFloat(""alphaX"", 0.0);
бетаX = предпочтения.getFloat(""бетаX"", 0.0);
// ... загрузить оставшиеся коэффициенты
предпочтения.конец();

• Заводская калибровка в процессе производства
• При необходимости выполняется повторная калибровка конечным пользователем.
• Между модулями не требуется никаких изменений в коде.

Расширенная диагностика и устранение неисправностей: решение реальных проблем калибровки.

Проблема 1: Оси перевернуты или инвертированы.

1. Регулировка вращения: Изменить настройку поворота сенсорного экрана

   cpp

   // Попробуйте разные значения поворота (0, 1, 2, 3)
   сенсорный экран.setRotation(2);  // Пейзаж
   // ИЛИ
   сенсорный экран.setRotation(0);  // Портретный режим (может потребоваться инверсия)

2. Назначение коэффициентов свопаЕсли оси X и Y инвертированы, поменяйте местами уравнения преобразования:

   cpp

   // Неверно (вызывает обмен местами)
   x = альфа_й * p.x + бета_й * p.y + дельта_й;
   y = альфа_х * p.x + бета_х * p.y + дельта_х;
   
   // Правильный
   x = альфа_х * p.x + бета_х * p.y + дельта_х;
   y = альфа_й * p.x + бета_й * p.y + дельта_й;

3. Инвертировать координатыДля перевернутых дисплеев:

   cpp

   y = ВЫСОТА_ЭКРАНА - y;  // Перевернуть ось Y

Проблема 2: Высокая погрешность калибровки (>15 пикселей)

• Неточные нажатия во время калибровки
• Электрические помехи на контактных линиях
• Поврежден сенсорный экран (дигитайзер).

• Выполните повторную калибровку с помощью тонкого стилуса (а не пальца).
• При подозрении на наличие помех добавьте конденсаторы емкостью 100 нФ вдоль контактных линий.
• Протестируйте несколько модулей — некоторые из них. CYD партии имеют более высокую дисперсию
• Реализуйте усреднение по нескольким выборкам (уже включено в предоставленный код).

Проблема 3: Коэффициенты не сохраняются после сброса.

// Убедитесь, что настройки инициализированы должным образом
если (!предпочтения.начинать(""cyd-калибровка"", ЛОЖЬ)) {
  Серийный номер.println(""Не удалось открыть пространство имен NVS"");
  // Используйте коэффициенты по умолчанию или выполните повторную калибровку.
}

предпочтения.прозрачный();  // Удалить все сохраненные значения
предпочтения.конец();

Проблема 4: Сенсорный экран работает в режиме калибровки, но не в основном приложении.

пустота настраивать() {
  // ... Инициализация LVGL ...
  
  lv_indev_t * indev = lv_indev_create();
  lv_indev_set_type(indev, LV_INDEV_TYPE_POINTER);
  lv_indev_set_read_cb(indev, touchscreen_read);  // Критически важно!
  
  // ... остальная часть настройки ...
}

Стратегии коммерческого внедрения: от прототипа до массового производства.

Процесс заводской калибровки

1. Автоматизированный испытательный стендСоздайте приспособление, которое механически нарезает резьбу в калибровочных точках с постоянным давлением.
2. Пакетное написание скриптовИспользуйте Python/Serial для:
   • Загрузите эскиз калибровки.
   • Процедура калибровки триггера
   • Анализ выходных данных коэффициента
   • Прошивка финальной версии с встроенными коэффициентами.
3. Quality GateОтклонять устройства с погрешностью калибровки > 8 пикселей
4. Документация: Сохранение коэффициентов в производственной базе данных, привязанных к серийному номеру.

Вариант калибровки для конечного пользователя

• Метод доступаУдерживайте кнопку GPIO во время загрузки.
• Дизайн пользовательского интерфейса: Крупные, понятные инструкции с визуальной обратной связью.
• Валидация: Автоматическая повторная попытка, если ошибка превышает пороговое значение
• Упорство: Автоматическое сохранение в NVS при успешном выполнении

1. Включите питание, удерживая кнопку “CAL”.
2. Следуйте подсказкам на экране, чтобы нажать на 6 целей.
3. Система подтверждает точность (погрешность < 5 пикселей).
4. Автоматическая перезагрузка в обычный режим.

Анализ затрат и выгод: калибровка против затрат на поддержку