Files
Sketches/breath_button_monitor/breath_dual_mode_monitor

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.

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