LilyGO T-Display-SF32¶

Что такое T-Display-SF32?¶

Xinyuan-LilyGO/T-Display-SF32 — платформа разработки на базе MCU SF32LB52x с AMOLED-дисплеем CO5300 диагональю 2,16 дюйма и сенсорным контроллером CST9220. В репозитории описаны 16 MB флеш-памяти, 8 MB PSRAM, IMU BHI260AP, LoRa SX1262, интерфейс microSD, аудио, USB Type-C, поддержка зарядки, назначение выводов платы, примеры приложений, файлы аппаратуры, каталог заводской прошивки и отчёт о потреблении питания для этой платы.

Такое сочетание подходит для оценки носимого устройства с дисплеем, портативного контроллера, портативного терминала с датчиками или подключённого человеко-машинного интерфейса (HMI). Это пример платформы, а не готовое изделие: несмотря на множество доступных аппаратных функций, команда продукта должна выбрать нужные интерфейсы, воспроизвести известную базовую конфигурацию, измерить её на конкретной ревизии платы и проверить питание, RF, безопасность, обслуживание ПО и восстановление.

Таблица поддержки функций в репозитории различает автономную плату T-SF32-Display и дополнительную плату расширения T-SF32-Keyboard. Wi-Fi (ESP32-C6), GPS (L76K), матричная клавиатура и её светодиоды (TCA8418, AW21009, XL9555), BME280, ИК-передатчик и вибромотор (AW86224) доступны только с этой платой расширения и не входят в базовую конфигурацию автономной платы.

Зачем нужна реализация на SF32?¶

На одной плате T-Display-SF32 графические возможности, Bluetooth, аудио и режимы низкого энергопотребления SF32LB52x объединены с внешними компонентами: дисплеем, сенсорным интерфейсом, датчиками движения, устройствами хранения и радиотрактом LoRa. LilyGO также предоставляет конфигурацию платы, специализированные драйверы, примеры и отдельный форк SDK LilyGO, который, согласно описанию, основан на SiFli-SDK 2.4.0. Это может сократить первоначальную настройку платы по сравнению с использованием неизменённой универсальной цели SDK.

Компромисс связан с ответственностью за сопровождение. Поддержка платы, изменения драйверов, ревизии аппаратуры, комплектная прошивка и связь между форком SDK от LilyGO и основным SiFli-SDK контролируются вне SiFli. Поэтому для воспроизводимости зафиксируйте коммит обоих репозиториев, сохраните работоспособный заводской образ/образ восстановления, а переход на более новую версию основного SiFli-SDK оформляйте как отдельное инженерное изменение.

Результат, область применения и условия начала¶

Ожидаемый результат: зафиксировать версии базовой конфигурации T-Display-SF32; проверить дисплей и сенсорный ввод, выбранные периферийные устройства, поведение системы питания и восстановление; воспроизвести сборку из исходников; затем внести одно ограниченное изменение приложения и сохранить результаты регрессионной проверки для оценки продукта.

Эта страница не подтверждает, что все варианты платы укомплектованы всеми периферийными устройствами, что прошивка поставщика готова к производству, что отчёт о питании применим к другой ревизии или нагрузке, либо что работа LoRa разрешена в каждом регионе. Она также не распространяет поддержку SiFli на специализированную аппаратуру и драйверы LilyGO.

Перед началом подготовьте:

• Точную модель платы T-Display-SF32 и её аппаратную ревизию, а также схему или карту выводов;
• Источник питания с ограничением тока либо защищённый аккумулятор, напряжение и состояние которого можно контролировать;
• Заведомо исправный USB-кабель с линиями данных, документированный разъём Type-C для прошивки и сохранённый образ восстановления;
• Зафиксированные коммиты репозитория T-Display-SF32 и форка SDK LilyGO;
• Окружение Windows/PowerShell, описанное в форке SDK LilyGO для первой воспроизводимой сборки; другие варианты хост-систем требуют отдельной проверки;
• Только те тестовые аксессуары, которые нужны для интерфейсов в области работ: например, карту microSD, наушники или аудионагрузку и устройство LoRa для разрешённого диапазона;
• Журнал версий прошивки, сборок, последовательного вывода, фотографий, измерений тока, отказов и восстановления.

Аппаратные и программные спецификации¶

Аппаратная спецификация¶

Программная спецификация¶

Выбор поддерживаемой базовой конфигурации¶

Основной репозиторий T-Display-SF32 сейчас использует ветку master и не обозначает выпуск с тегом как универсальную базовую версию ПО. Запишите точный коммит, а не «последнюю версию». В репозитории есть каталог firmware/T-SF32-Factory-V1.2, но одного его имени недостаточно: зафиксируйте соответствующую ревизию платы, коммит репозитория и процедуру прошивки.

После настройки необходимого окружения README T-Display-SF32 описывает следующую последовательность сборки и прошивки в Windows:

cd T-Display-SF32\examples\rt_os\rt_driver\project
scons --board=t-display-sf32_hcpu -j8
build_t-display-sf32_hcpu\uart_download.bat

Сохраните фактические коммиты репозитория и SDK, результат настройки переменных окружения, полный журнал сборки, созданные образы и журналы прошивки и загрузки. Число параллельных задач можно менять; цель сборки и ревизии исходников должны оставаться неизменными.

Этапы проекта¶

Архитектура системы и зависимости¶

flowchart LR
    U["Пользователь\nсенсорный ввод и кнопки"] --> F["Прошивка T-Display-SF32\nSF32LB52x + RT-Thread"]
    F --> D["AMOLED CO5300\nсенсорный контроллер CST9220"]
    F --> P["Установленная периферия\nIMU, microSD, аудио, LoRa"]
    B["Аккумулятор / USB Type-C\nзарядное устройство и линии питания"] --> F
    H["Средства сборки и прошивки на хосте"] -->|"загрузка UART и журналы"| F
    R["Репозиторий платы LilyGO"] --> H
    S["Форк SDK LilyGO\nпроизводный от SiFli-SDK"] --> H
    O["Исходники устройства и SDK SiFli"] -. "базовая документация платформы" .-> S

Рассматривайте отказы как отдельные области: питание/зарядка платы, запуск и прошивка, дисплей/сенсорный ввод, каждое выбранное периферийное устройство, поддержка платы LilyGO и базовый SDK. Например, отказ примера дисплея может быть вызван питанием, ревизией платы, настройкой панели/сенсорного контроллера, приложением или несовместимостью SDK и драйвера. Формулировки «не работает SDK» недостаточно для диагностики.

Этап 1 — Зафиксируйте исходную конфигурацию поставщика¶

Цель: установить фактическое поведение полученной платы и исходной конфигурации поставщика до изменения исходного кода.

1. Сфотографируйте обе стороны платы и запишите маркировку, установленные периферийные устройства, компоненты дисплея/сенсорного ввода, память, переключатели, разъёмы и коммит репозитория.
2. Проверьте источник питания и полярность. LilyGO предупреждает, что для запуска требуется напряжение выше 3,5 V; используйте контролируемый источник и не проводите испытания на глубоко разряженном элементе.
3. Прошивайте только базовый образ, заведомо соответствующий плате, либо сначала запустите установленную прошивку, если её происхождение известно. По возможности сохраните исходный образ.
4. Проверьте меню на устройстве или неизменённые примеры для дисплея/сенсорного ввода и каждой периферии, выбранной для продукта. Фиксируйте отсутствующие функции или неустановленные компоненты, не считая это отказом.
5. Выполните два холодных запуска и сохраните журналы загрузки, фотографии интерфейса, результаты ввода и сенсорного теста, а также запись тока для чётко заданного сценария простоя или активной работы.

Что сохранить: ревизию платы и фотографии, идентификатор репозитория/образа, сведения об источнике и аккумуляторе, журналы прошивки и загрузки, перечень установленных устройств, результаты проверки функций и условия измерения тока.

Критерий выхода из контрольной точки 1: после двух холодных запусков воспроизводится установленная базовая работа дисплея/сенсорного ввода, зафиксированы результаты для каждого установленного периферийного устройства в области работ, а исходный или заведомо рабочий образ можно восстановить.

Этап 2 — Проверьте периферию, питание и восстановление¶

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

Критерий выхода из контрольной точки 2: для каждой подходящей проверки есть воспроизводимый результат и способ восстановления; пользовательская прошивка защищает от низкого заряда; ни один неустранённый отказ не может повредить аккумулятор или оставить плату неработоспособной без документированного пути восстановления.

Этап 3 — Создайте воспроизводимую базу исходников¶

Цель: дать второму инженеру возможность создать и прошить ту же базовую конфигурацию из чистых исходников с зафиксированными версиями.

1. Получите зафиксированные коммиты репозитория платы и форка SDK LilyGO; запишите, какая основная версия SDK указана как база форка.
2. Настройте документированное окружение PowerShell и соберите t-display-sf32_hcpu в чистом каталоге.
3. Сохраните сведения об окружении, зависимостях, конфигурации, памяти/разделах, образе, прошивке и последовательных журналах.
4. Повторите сборку на другом компьютере или после удаления всех результатов сборки, затем выполните полную регрессию этапа 2.

Критерий выхода из контрольной точки 3: для создания прошивки, проходящей проверки этапа 2, не требуются устаревший образ, неотслеживаемый файл платы или недокументированная замена SDK.

Этап 4 — Адаптируйте по одному функциональному направлению¶

Цель: внести одно полезное изменение, сохранив рабочую базовую конфигурацию поставщика и путь восстановления.

Критерий выхода из контрольной точки 4: изменение проверено, исходный образ можно восстановить, а все применимые тесты дисплея, сенсорного ввода, периферии, питания, флеш-памяти и восстановления пройдены.

Этап 5 — Оцените готовность продукта¶

Перед полевыми испытаниями или разработкой собственной печатной платы (PCB) ответьте на вопросы:

• Кто отвечает за файлы платы, форк SDK LilyGO, исправления драйверов, обновления безопасности и переход на следующие версии SiFli-SDK?
• Какие ревизии платы и установленные периферийные устройства входят в базовую конфигурацию продукта, и как будут определяться и проверяться поступающие экземпляры?
• Каковы измеренные токи в активном режиме, простое, сне, при запуске и выключении для заданной яркости дисплея, коэффициента заполнения (duty cycle) радиопередачи, накопителя и конфигурации датчиков?
• Как проверяются защита аккумулятора, зарядка, тепловой режим, корпус, доступ к разъёмам и восстановление выключенного устройства?
• Какой регион LoRa, какая антенна и какой план частот будут использоваться; какие параметры передачи и нормативные требования для них применимы?
• Совместимы ли лицензии файлов аппаратуры, прошивки, форка SDK, примеров, ресурсов и сторонних компонентов с предполагаемым распространением?
• Принимает ли команда зависимость от стороннего прототипа или уже проверила контролируемый форк и план сопровождения?

Критерий выхода из контрольной точки 5: для каждого остаточного риска назначен ответственный, собраны доказательства и определён порядок действий; команда явно решила продолжить, отложить или остановить работу.

Передача материалов для проектирования изделия¶

Зафиксируйте точную модель SF32 и устройства памяти, временные характеристики дисплея/сенсорного ввода, установленную периферию и шины, дерево питания, политику зарядного устройства и аккумулятора, стратегию антенны/RF, разъём загрузки и прошивки, схему разделов, доступ к производственным тестам, ответственность за форк ПО и проверенный путь восстановления. Продолжайте по пути интеграции SF32LB52x, руководству по проектированию аппаратуры SF32LB52x, сборке, прошивке и мониторингу последовательного вывода в SiFli-SDK и материалу «Разработка для серийного производства».

Основные источники¶

• Репозиторий Xinyuan-LilyGO/T-Display-SF32
• README для T-Display-SF32 на китайском языке
• Примеры для T-Display-SF32
• Файлы аппаратной части T-Display-SF32
• Материалы испытаний энергопотребления T-Display-SF32
• Форк SDK Xinyuan-LilyGO/SlFli-SDK-Lilygo
• OpenSiFli/SiFli-SDK

Последнее обновление: 2026-10-21