Убрал лишние скетчи из проекта

This commit is contained in:
AidarKC
2026-10-15 18:04:54 +03:00
parent d25894149b
commit e77aaa3675
12 changed files with 74 additions and 1916 deletions
@@ -47,7 +47,6 @@ case "${MODE}" in
lvgl-official-based-test) SKETCH_DIR="${ROOT_DIR}/test_sketches/lvgl_official_based_test" ;;
lvgl-subserver-touch-test) SKETCH_DIR="${ROOT_DIR}/test_sketches/lvgl_subserver_touch_test" ;;
lvgl-russian-font-test) SKETCH_DIR="${ROOT_DIR}/test_sketches/lvgl_russian_font_test" ;;
breath-dual-mode-monitor) SKETCH_DIR="${ROOT_DIR}/test_sketches/breath_dual_mode_monitor" ;;
usb-contact-test) SKETCH_DIR="${ROOT_DIR}/test_sketches/usb_contact_sensor_test" ;;
usb-contact-debug-test) SKETCH_DIR="${ROOT_DIR}/test_sketches/usb_contact_sensor_debug_test" ;;
usb-contact-resistance-test) SKETCH_DIR="${ROOT_DIR}/test_sketches/usb_contact_resistance_test" ;;
@@ -55,21 +54,13 @@ case "${MODE}" in
lvgl-nav-minimal-test) SKETCH_DIR="${ROOT_DIR}/shine_homeserver_main" ;;
*)
echo "Unknown mode: ${MODE}" >&2
echo "Use one of: hello, widgets, audio, simple, argon2, homeserver-ui, shine-homeserver-main, shine-homeserver-ui-main, legacy-homeserver-ui, text-test, gfx-text-test, gfx-layout-test, lvgl-basic-test, lvgl-interaction-test, lvgl-touch-debug-test, lvgl-official-based-test, lvgl-subserver-touch-test, lvgl-russian-font-test, breath-dual-mode-monitor, usb-contact-test, usb-contact-debug-test, usb-contact-resistance-test, usb-contact-screen-start-stub" >&2
echo "Use one of: hello, widgets, audio, simple, argon2, homeserver-ui, shine-homeserver-main, shine-homeserver-ui-main, legacy-homeserver-ui, text-test, gfx-text-test, gfx-layout-test, lvgl-basic-test, lvgl-interaction-test, lvgl-touch-debug-test, lvgl-official-based-test, lvgl-subserver-touch-test, lvgl-russian-font-test, usb-contact-test, usb-contact-debug-test, usb-contact-resistance-test, usb-contact-screen-start-stub" >&2
exit 2
;;
esac
if [[ -z "${PORT}" ]]; then
if ! PORT="$(detect_port)"; then
echo "Failed to auto-detect ESP32 port. Set PORT=/dev/ttyACM0 ./burn.sh ${MODE}" >&2
exit 3
fi
fi
echo "== Mode: ${MODE}"
echo "== Sketch: ${SKETCH_DIR}"
echo "== Port: ${PORT}"
echo "== FQBN: ${FQBN}"
mkdir -p "${BUILD_DIR}" "${OUT_DIR}"
@@ -93,6 +84,20 @@ if ! arduino-cli compile "${compile_args[@]}"; then
arduino-cli compile --clean "${compile_args[@]}"
fi
if [[ "${NO_UPLOAD:-0}" == "1" ]]; then
echo "== Done: compiled without upload (NO_UPLOAD=1)."
exit 0
fi
if [[ -z "${PORT}" ]]; then
if ! PORT="$(detect_port)"; then
echo "Failed to auto-detect ESP32 port. Set PORT=/dev/ttyACM0 ./burn.sh ${MODE}" >&2
exit 3
fi
fi
echo "== Port: ${PORT}"
arduino-cli upload \
-p "${PORT}" \
--fqbn "${FQBN}" \
@@ -15,7 +15,6 @@
- `lvgl_official_based_test/` - минимальный наш экран поверх максимально близкой к официальному `05_LVGL_Widgets` инициализации
- `lvgl_subserver_touch_test/` - старый гибридный тест: `LVGL`-экран с инициализацией дисплея и чтением touch из старого `shine_homeserver_ui`; подтверждён на реальном устройстве
- `lvgl_russian_font_test/` - тест кастомного кириллического `LVGL`-шрифта с русскими кнопками, длинными строками и рабочим touch
- `breath_dual_mode_monitor/` - dual-mode breath monitor в стиле GFX-скетча: старт USB-датчика или внешних кнопок `KEY3/BOOT`, настройки лимита и громкости, повторяющиеся звуковые предупреждения
- `usb_contact_sensor_test/` - тест переключения нативных USB D-/D+ (`GPIO19/20`) в режим простого замыкаемого контакта после нажатия Start; после перезагрузки снова обычный USB
- `usb_contact_sensor_debug_test/` - debug-версия теста замыкания контакта: экранная кнопка проверяет touch, а переход в sensor mode выполняется физической кнопкой BOOT
- `usb_contact_resistance_test/` - тест измерения сопротивления между USB D-/D+ через ADC на GPIO20; рассчитан на внешний известный резистор 10 kΩ с D+ на GND
@@ -33,7 +32,6 @@
- `./burn.sh lvgl-official-based-test`
- `./burn.sh lvgl-subserver-touch-test`
- `./burn.sh lvgl-russian-font-test`
- `./burn.sh breath-dual-mode-monitor`
- `./burn.sh usb-contact-test`
- `./burn.sh usb-contact-debug-test`
- `./burn.sh usb-contact-resistance-test`
@@ -1,28 +0,0 @@
# AGENTS
## Назначение папки
Эта папка содержит отдельный ESP32-скетч `breath_dual_mode_monitor.ino` для Waveshare `ESP32-S3-Touch-AMOLED-2.16`.
Скетч совмещает два режима измерения дыхания:
- `START USB SENSOR` — датчик-сухой контакт на USB `D- / D+`;
- `START MANUAL MONITOR` — ручной монитор с двумя внешними кнопками пользователя `KEY3 / GPIO18` и `BOOT / GPIO0`.
- `START POT 3-WIRE` — тест переменного резистора по 3-проводной схеме через `USB D- / D+ / GND`.
- `START POT 2-WIRE` — грубый тест переменного резистора по двум контактам `USB D- / D+`.
- `START POT CAL` — калиброванный грубый тест переменного резистора по двум контактам `USB D- / D+`.
- `START PIN DIAG` — диагностика возможности использовать `USB D- / D+` как GPIO/ADC.
## Обязательная синхронизация
При любом изменении `breath_dual_mode_monitor.ino` обязательно обновлять рядом лежащий `README.md`.
Если меняются экранные тексты, кнопки, режимы старта, пины, настройки, звуковые сигналы, правила подсчёта циклов или поведение тревоги после 60 секунд, описание в `README.md` должно быть обновлено в том же наборе изменений.
Также при изменении поведения скетча обновлять общий reference-документ:
- `../../../../reference/usb_contact_sensor_test_spec.md`
## Язык экрана
Экранные строки в скетче оставлять на английском языке.
@@ -1,147 +0,0 @@
# Breath Dual Mode Monitor
Dual-mode breath monitor для Waveshare `ESP32-S3-Touch-AMOLED-2.16`.
## Режимы
На стартовом экране есть кнопки выбора режима:
- `START USB SENSOR` — использует USB `D- / D+` как сухой контакт.
- `START MANUAL MONITOR` — ручной монитор, использующий две внешние кнопки пользователя.
- `START POT 3-WIRE` — использует USB `D- / D+` и `USB GND` для проверки переменного резистора.
- `START POT 2-WIRE` — грубо оценивает положение переменного резистора только по `D- / D+`.
- `START POT CAL` — калиброванный грубый режим по двум контактам `D- / D+`, показывает положение внутри реально увиденного диапазона.
- `START PIN DIAG` — диагностирует, могут ли USB `D- / D+` реально работать как GPIO/ADC.
## USB Sensor Mode
- `GPIO19 / USB D-` переводится в `OUTPUT LOW`.
- `GPIO20 / USB D+` переводится в `INPUT_PULLUP`.
- Замкнутый контакт считается `EXHALE`.
- Разомкнутый контакт считается `INHALE`.
- Короткие USB-циклы меньше 3 секунд не считаются завершённым циклом: время текущего цикла продолжает идти от предыдущего принятого `EXHALE`.
- Короткое нажатие `KEY3 / GPIO18` открывает или закрывает settings в USB-режиме.
- Внизу рабочего экрана USB-режима показываются длительности последних пяти засчитанных циклов.
- После старта USB data-линии заняты GPIO-режимом до перезагрузки.
## Buttons Mode
- `KEY3 / GPIO18` — `INHALE`, active LOW.
- `BOOT / GPIO0` — `EXHALE`, active LOW.
- `BOOT` нельзя удерживать во время включения или reset платы.
- На рабочем экране нет touch-кнопок `INHALE` / `EXHALE`: дыхание переключается только внешними кнопками.
- Долгое удержание `KEY3 / INHALE` около 850 мс открывает settings и одновременно считается нажатием `INHALE`.
- Когда settings открыты, следующее нажатие `KEY3 / INHALE` закрывает settings и тоже считается нажатием `INHALE`.
## Pot Test Mode
Режим для проверки переменного резистора `RP 6045-B50K` на 50 kΩ по 3-проводной схеме:
- `USB D- / GPIO19` — источник `3.3V`, подключается к одному крайнему выводу резистора.
- `USB D+ / GPIO20` — ADC-вход, подключается к средней ножке/ползунку.
- `USB GND` — земля, подключается ко второму крайнему выводу резистора.
На экране показываются:
- положение ползунка `0..100%`;
- горизонтальная шкала;
- напряжение на `D+`;
- raw ADC;
- примерное сопротивление участка `0..50 kΩ`.
Программная защита best-effort:
- если ADC насыщается или показывает опасно высокое напряжение, скетч переводит `D-` и `D+` в `INPUT`, пищит и показывает `USB/PIN FAULT`;
- это не делает 5V на GPIO безопасными: ESP32-S3 GPIO не являются 5V tolerant;
- после fault нужно отключить неправильное подключение и перезагрузить плату.
## Pot 2-Wire Test Mode
Грубый режим для проверки переменного резистора по двум контактам:
- `USB D- / GPIO19` — источник `3.3V`;
- `USB D+ / GPIO20` — ADC-вход с внутренней подтяжкой вниз;
- подключить два вывода потенциометра между `D-` и `D+`: средний ползунок и один крайний вывод.
Ограничения:
- измерение грубое, потому что внутренняя подтяжка ESP32 имеет большой разброс;
- положение и сопротивление могут быть нелинейными и отличаться между платами;
- для проверки движения ползунка и примерного края диапазона режим подходит;
- для будущей точной логики дыхания лучше использовать `START POT 3-WIRE`.
## Pot Cal Test Mode
Калиброванный грубый режим для случаев, когда USB-линии дают маленький или смещённый диапазон, но движение всё равно видно:
- `USB D- / GPIO19` — источник `3.3V`;
- `USB D+ / GPIO20` — ADC-вход с внутренней подтяжкой вниз;
- подключить два вывода потенциометра между `D-` и `D+`: средний ползунок и один крайний вывод.
На экране показываются:
- процент `0..100%` внутри автоматически найденного диапазона;
- текущие `mV` и raw ADC;
- найденный диапазон `min-max`;
- состояние `CALIBRATING`, `SMALL RANGE`, `LOW EDGE`, `MID` или `HIGH EDGE`.
Как пользоваться:
- открыть `START POT CAL`;
- медленно провести ползунок от одного края до другого, чтобы скетч запомнил минимум и максимум;
- если нужно начать калибровку заново, нажать `KEY3 / GPIO18`.
Этот режим не измеряет настоящее сопротивление. Он нужен, чтобы понять, можно ли получить хотя бы относительное положение ползунка на проблемной USB-паре.
## USB Pin Diag Mode
Режим для проверки, не удерживает ли USB PHY/кабель линии `D- / D+` около нуля.
Тесты:
- `Test A`: `D- / GPIO19` переводится в `OUTPUT HIGH`, `D+ / GPIO20` читается как ADC.
- `Test B`: `D+ / GPIO20` переводится в `OUTPUT HIGH`, `D- / GPIO19` читается как ADC.
Как пользоваться:
- открыть `START PIN DIAG`;
- замкнуть `D-` и `D+` напрямую;
- смотреть, появляется ли около `3.3V` / высокий ADC хотя бы в одном направлении.
Если оба теста остаются около нуля, значит USB-линии, вероятно, удерживаются USB-подключением, USB PHY или платной обвязкой, и использовать этот разъём как аналоговый датчик при таком подключении нельзя.
## Логика дыхания
- Цикл считается от одного `EXHALE` до следующего `EXHALE`.
- `INHALE` до первого `EXHALE` не создаёт цикл.
- В Buttons Mode циклы короче 1.5 секунды игнорируются.
- Ручной монитор принимает фазы только в порядке `INHALE -> EXHALE -> INHALE`. Повторное нажатие текущей кнопки и `EXHALE` до первого `INHALE` полностью игнорируются: не меняют фазу, не сбрасывают таймер и не подают звук.
- Каждое принятое нажатие даёт один тихий подтверждающий сигнал. В ручном режиме поле `Phase time` показывает длительность именно текущего вдоха или выдоха.
- В USB Sensor Mode циклы короче 3 секунд игнорируются без сброса текущего таймера цикла.
- Среднее считается по последним 5 завершённым циклам.
- Экран показывает текущий цикл, среднее за 5 циклов, время сессии, выбранный лимит и счётчики тревог.
- Нижние два числовых поля (`From start` и `Limit`) выводятся увеличенным размером.
## Settings
Settings сохраняются в NVS:
- limit: `5 / 7 / 10 / 15 / 20` секунд;
- quiet cycle tick volume: `0..10`;
- alert volume: `0..10`.
## Тревоги
- Если среднее последних циклов меньше выбранного лимита, звучат предупреждения как в USB breath monitor: серия растёт до 5 сигналов.
- Если текущий цикл длится 60 секунд, звучит 5 громких сигналов.
- После этого каждые 5 секунд снова звучит серия из 5 громких сигналов.
- Повтор продолжается до смены фазы / выхода из длинного цикла.
- В ручном мониторе для одной затянувшейся фазы звучит один громкий сигнал на `35`, `40`, `45`, `50` и `55` секундах. С `60` секунд начинается обычная серия из 5 громких сигналов с повтором каждые 5 секунд.
## Прошивка
Из папки `main-device`:
```bash
./burn.sh breath-dual-mode-monitor
```