Breath Dual Mode Monitor
Dual-mode breath monitor для Waveshare ESP32-S3-Touch-AMOLED-2.16.
Режимы
На стартовом экране есть кнопки выбора режима:
START USB SENSOR— использует USBD- / D+как сухой контакт.START MANUAL MONITOR— ручной монитор, использующий две внешние кнопки пользователя.START POT 3-WIRE— использует USBD- / D+иUSB GNDдля проверки переменного резистора.START POT 2-WIRE— грубо оценивает положение переменного резистора только поD- / D+.START POT CAL— калиброванный грубый режим по двум контактамD- / D+, показывает положение внутри реально увиденного диапазона.START PIN DIAG— диагностирует, могут ли USBD- / D+реально работать как GPIO/ADC.
START MANUAL MONITOR является большой основной кнопкой. Все остальные режимы находятся ниже как компактные служебные кнопки.
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. - В правом верхнем углу показываются заряд батареи и значок молнии во время зарядки. Данные читает AXP2101.
- Дисплей гаснет после выбранного времени без касания экрана или внешней кнопки. Измерение, кнопки и предупреждения продолжают работать; касание или кнопка сразу включает подсветку обратно.
- Если после принятой фазы нет следующей корректной противоположной кнопки: первые 30 секунд скетч молчит, затем 30 секунд тихо сигналит каждые 5 секунд, следующие 30 секунд громко сигналит каждые 5 секунд, затем ещё 5 минут громко сигналит раз в 15 секунд. После этого AXP2101 выключает прибор.
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не создаёт цикл.- В ручном режиме учитывается каждый полный цикл, включая длительности меньше 3 секунд.
- Ручной монитор принимает фазы только в порядке
INHALE -> EXHALE -> INHALE. Повторное нажатие текущей кнопки иEXHALEдо первогоINHALEполностью игнорируются: не меняют фазу, не сбрасывают таймер и не подают звук. - Каждое принятое нажатие даёт один тихий подтверждающий сигнал. В ручном режиме поле
Phase timeпоказывает длительность именно текущего вдоха или выдоха. - В USB Sensor Mode циклы короче 3 секунд игнорируются без сброса текущего таймера цикла.
- Среднее считается с округлением по миллисекундам по последним 5 завершённым циклам и выводится до десятых секунды.
- После принятого
EXHALEдобавляется полный цикл, пересчитывается среднее и при среднем ниже лимита срабатывает предупреждение. - Внизу экрана всегда показаны те же последние 5 измерений, из которых считается среднее.
- Нижние два числовых поля (
From startиLimit) выводятся увеличенным размером.
Settings
Settings сохраняются в NVS:
- limit:
5 / 7 / 10 / 15 / 20секунд; - quiet cycle tick volume:
0..10; - alert volume:
0..10. - screen timeout:
10s / 30s / 60s / Always.
Настройки прокручиваются вертикальным свайпом, чтобы поместить все четыре пункта.
Тревоги
- Если среднее последних циклов меньше выбранного лимита, звучат предупреждения как в USB breath monitor: серия растёт до 5 сигналов.
- В USB-режиме длинный цикл с 60 секунд использует 5 громких сигналов с повтором каждые 5 секунд.
- В ручном мониторе используется отдельная экономная лестница напоминаний, описанная выше, с выключением питания через 6 минут 30 секунд без корректной следующей фазы.
Прошивка
Из этой папки:
./burn.sh
Только проверить сборку, не прошивая плату:
NO_UPLOAD=1 ./burn.sh