SHA256
29 lines
2.4 KiB
Markdown
29 lines
2.4 KiB
Markdown
# AGENTS for ESP32
|
|
|
|
## Язык UI
|
|
|
|
- Для ESP32-скетчей и экранного UI использовать английский язык.
|
|
- Русский текст на экране ESP32 пока не поддерживается корректно: шрифтовой путь для кириллицы не считается рабочим.
|
|
- Если меняется UI-скетч, все пользовательские строки на экране должны оставаться английскими, пока ограничение не снято отдельной задачей.
|
|
|
|
## Синхронизация со спецификацией
|
|
|
|
- При изменении экранов, кнопок, переходов, статусов или текстов обязательно обновлять соответствующую спецификацию в `ESP32/esp32/ESP32-S3-Touch-AMOLED-2.16/reference/`.
|
|
|
|
## Сборка ESP32
|
|
|
|
- Основной способ проверки и прошивки скетчей для `ESP32-S3-Touch-AMOLED-2.16` - `main-device/burn.sh`.
|
|
- Не собирать эти скетчи напрямую через `arduino-cli compile` без `burn.sh`, потому что скрипт добавляет нужные локальные библиотеки и конфиги из `official-demo/examples/Arduino-v3.3.5/libraries`.
|
|
- Если сборка падает по `lv_conf.h` или `TouchDrvCSTXXX.hpp`, сначала проверять именно `burn.sh` и его `--library` пути, а не считать, что файл пропал из репозитория.
|
|
|
|
## Диагностика ESP32
|
|
|
|
- Последнюю сохранённую ошибку или диагностическую запись читать с устройства через USB serial monitor на `115200`.
|
|
- Базовая команда:
|
|
`arduino-cli monitor -p /dev/ttyACM0 --config baudrate=115200`
|
|
- После подключения отправлять одну из команд:
|
|
`last_error`, `last_diag` или `reg_diag`
|
|
- Для очистки сохранённой диагностики использовать:
|
|
`clear_error` или `clear_diag`
|
|
- При падениях в ветках регистрации и обновления PDA сначала читать именно `last_error`: запись хранится в NVS и может пережить перезагрузку устройства.
|