Зафиксировать рабочий BreathMonitor v1 и сервер

This commit is contained in:
AidarKC
2026-10-25 14:14:27 +03:00
parent 370f4ae94e
commit d5a37d3009
43 changed files with 2490 additions and 1522 deletions
@@ -0,0 +1,130 @@
# AGENTS — BreathMonitor v3
## Назначение
Эта папка содержит третью версию автономного ESP32-монитора дыхания и отдельный Java/SQLite-сервер.
- `firmware/` — прошивка для Waveshare ESP32-S3-Touch-AMOLED-2.16.
- `server/` — исходники Java-сервера, Gradle-сборка и веб-интерфейс.
- `deploy/` — шаблон systemd-службы и отдельный фрагмент Caddy.
## Обязательные правила
- Все изменения этого проекта относятся к репозиторию `SKETCH`, не смешивать их с коммитами `SHiNE-product`.
- Основной язык документации и пояснений — русский.
- Не удалять FFat при обновлении прошивки. Не использовать `Erase All Flash`, если нужно сохранить локальные журналы.
- Если при старте появляется `STORAGE ERROR`, нажимать `FORMAT FFat` только после проверки/резервирования локальных журналов; без подтверждения прошивка форматирование не выполняет.
- Перед прошивкой убедиться, что выбрана схема `app3M_fat9M_16MB`.
- Не менять формат записей журналов и API без отдельного согласования: сервер проверяет 32-байтные записи, CRC32 и префиксную целостность загрузок.
- Не хранить пароли, токены, SQLite-базу и реальные серверные секреты в git.
## Прошивка
Плата и библиотеки такие же, как у `breathmonitor_v2 lvgl`. `firmware/burn.sh` использует библиотеки из:
`SHiNE-product/ESP32/esp32/ESP32-S3-Touch-AMOLED-2.16/official-demo/examples/Arduino-v3.3.5/libraries`
Сборка без загрузки:
```bash
cd "SKETCH/breath_button_monitor/breathmonitor_v3 with server/firmware"
NO_UPLOAD=1 ./burn.sh
```
Загрузка на подключённую плату:
```bash
PORT=/dev/ttyACM0 ./burn.sh
```
Скрипт использует ESP32 core 3.3.5, FQBN с 16 MB Flash, PSRAM OPI и разделом `app3M_fat9M_16MB`. Перед загрузкой проверить порт командой `arduino-cli board list`.
## Серверная сборка
Сервер всегда собирается локально. VPS не должен запускать Maven, Gradle или компилятор.
```bash
cd "SKETCH/breath_button_monitor/breathmonitor_v3 with server/server"
./gradlew --no-daemon clean shadowJar
```
Требуется JDK 17. Результат:
`server/build/libs/breathmonitor-1.0.0.jar`
Проверить локально запуск и health можно так:
```bash
BREATH_DATA_DIR="$PWD/.local-data" \
BREATH_WEB_DIR="$PWD/web" \
PUBLIC_ORIGIN="https://breathmonitor.shineup.me" \
java -jar build/libs/breathmonitor-1.0.0.jar
```
Для VPS передаётся только готовый JAR и при необходимости статические файлы `web/`. Не выполнять на VPS `build.sh`, `gradlew`, `mvn` или компиляцию.
## Деплой сервера
Целевой адрес: `breathmonitor.shineup.me`, VPS: `178.208.90.249`. SSH-пользователь текущего тестового контура — `player`.
Постоянные пути на VPS:
- приложение: `/opt/breathmonitor/server`
- JAR: `/opt/breathmonitor/server/build/libs/breathmonitor-1.0.0.jar`
- данные SQLite и журналы: `/var/lib/breathmonitor`
- systemd unit: `/etc/systemd/system/breathmonitor.service`
- Caddy: `/etc/caddy/Caddyfile`
- внутренний HTTP-порт: `127.0.0.1:8090`
Безопасный порядок обновления:
1. Локально собрать и проверить JAR.
2. Передать только JAR во временный файл на VPS через `rsync`.
3. Сделать копию текущего JAR и проверить права.
4. Атомарно заменить JAR, не удаляя `/var/lib/breathmonitor`.
5. Перезапустить только `breathmonitor.service`.
6. Проверить `systemctl status breathmonitor` и `curl https://breathmonitor.shineup.me/api/health`.
7. Caddy не перезапускать при обычном обновлении JAR. Перезагрузка Caddy нужна только при изменении его конфигурации.
Пример передачи готового артефакта:
```bash
rsync -az server/build/libs/breathmonitor-1.0.0.jar \
player@178.208.90.249:/tmp/breathmonitor-1.0.0.jar
```
Дальнейшая замена требует SSH/sudo-доступа и выполняется отдельно от сборки. При недоступном VPS не повторять сборку удалённо и не трогать существующие сервисы.
## Первый запуск и аккаунт
Сервис запускается от системного пользователя `breathmonitor` и использует `BREATH_DATA_DIR=/var/lib/breathmonitor`.
Создание аккаунта выполняется один раз на VPS с тем же каталогом данных:
```bash
sudo -u breathmonitor env BREATH_DATA_DIR=/var/lib/breathmonitor \
/opt/breathmonitor/server/start.sh create-user aidar
```
Текущая версия допускает пароль длиной от 1 до 63 символов. Короткие пароли допустимы только для закрытого тестового контура; для публичного использования нужен длинный пароль.
## Проверки после обновления
```bash
curl -fsS https://breathmonitor.shineup.me/api/health
sudo systemctl is-active breathmonitor
sudo journalctl -u breathmonitor -n 70 --no-pager
```
После прошивки на приборе проверить Wi-Fi, синхронизацию времени, `ONLINE → ACCOUNT`, `PAIR`, затем `UPLOAD`. Журналы на устройстве не удалять при диагностике; использовать USB-команды `LOG INFO`, `LOG LIST` и `LOG DOWNLOAD <дата>`.
## Резервирование
Резервировать нужно SQLite-базу с учётом WAL и каталог журналов:
- `/var/lib/breathmonitor/statistics.db`
- `/var/lib/breathmonitor/statistics.db-wal`
- `/var/lib/breathmonitor/statistics.db-shm`
- `/var/lib/breathmonitor/logs/`
Не заменять каталог данных при обновлении приложения и не выполнять `rsync --delete` по `/var/lib/breathmonitor`.
@@ -0,0 +1,186 @@
# BreathMonitor — автономный прибор + Java/SQLite сервер
**Комплект для развёртывания** · 24 октября 2026 года
Адрес API и сайта уже задан: **https://breathmonitor.shineup.me**
Это исходники готовой первой интеграционной версии, а не подтверждённая сборка для конкретной платы: Java-код и парсер рассчитаны на JDK 17, но `.ino` требуется собрать в Arduino IDE с исходными библиотеками и проверить на физическом ESP32-S3. Интернет в среде сборки отсутствовал, поэтому готовый исполняемый JAR с SQLite JDBC не вложен: `server/build.sh` соберёт его Gradle, скачав зависимости из Maven Central.
## Содержимое
```text
firmware/breathmonitor_lvgl.ino — изменённый скетч (исходный UI, измерения, RTC)
firmware/ISRG_Root_X1_reference.pem — копия публичного корневого сертификата (он уже встроен в .ino)
server/BreathServer.java — один Java-класс: API, SQLite, HTTPS через Caddy, веб-сайт
server/RecordFixtureTest.java — тест бинарного формата/CRC32 без JDBC
server/build.gradle — зависимости SQLite JDBC, SLF4J и сборка jar
server/build.sh — Gradle package
server/start.sh — запуск и админ-команды
server/web/ — независимая HTML/CSS/JavaScript статистика
deploy/Caddyfile.fragment — пример секции для Caddy
deploy/breathmonitor.service — пример службы systemd
```
## 1. Изменения прибора
- **Без постоянного Wi-Fi.** После загрузки радиомодуль выключен. Операция `TIME → SYNC NOW` подключает известную сеть, синхронизирует NTP+RTC, выключает Wi-Fi. `ONLINE → UPLOAD` делает то же самое для передачи журналов. `Wi-Fi → TEST` проверяет доступность сети и отключает модуль.
- До восьми сохранённых SSID и паролей перенесены из старой прошивки без изменения ключей `manual-wifi`.
- Если известные Wi-Fi недоступны, открывается список сетей; после выбора/ввода пароля ранее запрошенная операция продолжается автоматически.
- **Журнал по дням:** `/logs/20261024.bin` и т. п., записи по 32 байта, версия 1 + CRC32. Запись только в конец, существующие дневные файлы продолжаются после перезагрузки. `/logs/undated.bin` — события при недостоверном времени.
- `/events.bin` из исходной прошивки **не удаляется**. При первом запуске записи переносятся в дневные файлы, успешный перенос фиксируется `/migration.done`. При аварийном выключении перенос пробуется снова; старый исходный файл остаётся. Неверные CRC в старом файле пропускаются, но остаются в оригинале для диагностики.
- Автоформатирование FFat отключено (`FFat.begin(false)`). Если FFat не монтируется, прибор показывает на экране подтверждение `FORMAT FFat`; форматирование выполняется только после явного нажатия и удаляет локальные журналы.
- `ONLINE → ACCOUNT`: ввести логин и пароль учётной записи сайта, затем `PAIR` или сразу `UPLOAD`. Введённый пароль живёт в RAM до авторизации; хранится отдельный токен устройства в Preferences. После перезагрузки пароль не нужен.
- `ONLINE → REUPLOAD` очищает **только индекс отправленных размеров** `/sync.state`, не сами журналы. При следующем `UPLOAD` прибор повторно отправит все дневные файлы (сервер не дублирует циклы).
- Передача HTTPS в отдельной FreeRTOS-задаче; измерения и обновление LVGL продолжаются в основном цикле. Отправляется зафиксированный на момент начала передачи размер файла: новые записи попадут в следующую синхронизацию.
- Публичный ключ SSL не выключен: прошивка доверяет **ISRG Root X1**. Caddy должен получить совместимый сертификат Let's Encrypt. При смене удостоверяющего центра нужно обновить доверенный сертификат в прошивке.
**USB CDC:** доступны `LOG INFO`, `LOG LIST`, `LOG DOWNLOAD 20261024`, `LOG DOWNLOAD undated`, `LOG DOWNLOAD LEGACY`. `LOG DOWNLOAD` без указания даты больше не поддерживается. Бинарные данные передаются HEX-строками между `LOG BEGIN ...` и `LOG END`.
**Важно при прошивке:** используйте тот же раздел/Partition Scheme, который содержал исходный FFat, и не выбирайте `Erase All Flash`. Перепрошивка с изменением разметки может стереть старые журналы. До прошивки сделайте резервную копию `/events.bin` через исходную команду `LOG DOWNLOAD`.
## 2. Установка Java + SQLite (Ubuntu)
На сервере с Caddy и доступом в интернет:
```bash
sudo apt update
sudo apt install -y openjdk-17-jdk gradle
# Скопируйте папку server в /opt/breathmonitor/server
cd /opt/breathmonitor/server
chmod +x build.sh start.sh
./build.sh
```
Сборка создаёт `target/breathmonitor-1.0.0.jar`. Это самодостаточный shaded JAR, включающий SQLite JDBC и SLF4J. Другой процесс базы данных не нужен.
Для первого запуска от текущего пользователя:
```bash
cd /opt/breathmonitor/server
./start.sh create-user aidar
# Введите пароль длиной 1–63 символа
./start.sh create-user anna
./start.sh
```
Админ-команда сброса пароля:
```bash
./start.sh reset-password aidar
```
**Сброс пароля отзывает все веб-сессии и токены привязанных устройств**; пароль и привязку придётся ввести заново.
По умолчанию:
- Java-сервер слушает **только** `127.0.0.1:8090`, так что он не доступен напрямую из интернета.
- База данных находится в `server/data/statistics.db`, журналы в `server/data/logs/<login>/<device-id>/<login>_YYYYMMDD.bin`.
- Файлы фронтенда читаются из `server/web`.
- Значения настраиваются переменными `BREATH_PORT`, `BREATH_BIND`, `BREATH_DATA_DIR`, `BREATH_WEB_DIR`, `PUBLIC_ORIGIN`.
### Служба systemd
Для постоянного запуска рекомендуется отдельный системный пользователь и каталог данных:
```bash
sudo useradd --system --user-group --no-create-home --shell /usr/sbin/nologin breathmonitor || true
sudo mkdir -p /var/lib/breathmonitor
sudo chown -R breathmonitor:breathmonitor /var/lib/breathmonitor
sudo chown -R root:root /opt/breathmonitor/server
sudo cp /opt/breathmonitor/deploy/breathmonitor.service /etc/systemd/system/
sudo systemctl daemon-reload
# Сначала создайте пользователей, используя то же BREATH_DATA_DIR и от имени breathmonitor:
sudo -u breathmonitor env BREATH_DATA_DIR=/var/lib/breathmonitor bash -c 'cd /opt/breathmonitor/server && ./start.sh create-user aidar'
sudo systemctl enable --now breathmonitor
sudo journalctl -u breathmonitor -n 70 --no-pager
```
Не создавайте сначала пользователей в `server/data/`, а потом не переключайтесь на `/var/lib/breathmonitor`: это **разные** базы данных. При необходимости перенесите каталог данных до запуска службы.
## 3. Caddy / HTTPS / DNS
Настройте DNS-запись `A` (и при необходимости `AAAA`) для `breathmonitor.shineup.me` на адрес вашего сервера. В вашем существующем Caddyfile добавьте блок из `deploy/Caddyfile.fragment`, не перезаписывая остальные сайты. Прибор всегда использует `https://breathmonitor.shineup.me` — адрес уже в `.ino`.
```bash
sudo caddy fmt --overwrite /etc/caddy/Caddyfile
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
curl -i https://breathmonitor.shineup.me/api/health
```
Ответ должен быть HTTP 200 и `{"ok":true}`. Затем откройте сайт в браузере, войдите под созданным логином и паролем.
Текущая версия Caddy сама использует стандартный Let's Encrypt. Это важно, поскольку `ROOT_CA` прошивки содержит только ISRG Root X1; другой TLS-издатель может не пройти проверку. Если у вас уже есть отдельный wildcard-сертификат, сначала проверьте его цепочку доверия и при необходимости обновите `ROOT_CA`.
## 4. Первое подключение прибора
1. Установить обновлённую прошивку без стирания FFat/Preferences.
2. `SETTINGS → Wi-Fi → SCAN`: выбрать свою сеть, ввести пароль, дождаться успешной проверки. Сеть сохранится.
3. `SETTINGS → TIME → SYNC NOW`: получить точное время и выключить Wi-Fi. После NTP аппаратные часы продолжают работать автономно.
4. `SETTINGS → ONLINE → ACCOUNT → LOGIN`: ввести **тот же** логин, что создали командой `create-user`.
5. `PASSWORD`: ввести пароль аккаунта; `PAIR` — одноразово получить токен (или просто `ONLINE → UPLOAD`, и привязка выполнится при первой выгрузке).
6. Сделать несколько циклов дыхания и нажать `ONLINE → UPLOAD`. Увидеть сообщение `Done: ... uploaded`. Через браузер обновить страницу статистики.
7. Последующие загрузки выполняются одним нажатием `UPLOAD`; пароль повторно не вводится.
На приборах с заводским/сброшенным RTC перед защищённой отправкой автоматически выполняется NTP. Если отсутствует интернет/NTP, файлы продолжают сохраняться локально; при неудачной синхронизации не удаляются.
## 5. Формат API (для отладки)
| Метод и путь | Назначение | Авторизация |
|---|---|---|
| `GET /api/health` | проверка сервера | нет |
| `POST /api/device/login` | `login\npassword\nDEVICEID` → 64 шестнадцатеричных символа токена | пароль пользователя |
| `PUT /api/device/upload?date=20261024` | сырое тело `.bin`, заголовки `Authorization: Bearer TOKEN` и `X-Device-ID: <12 hex>` | токен устройства |
| `POST /api/login` | логин в браузере | пароль пользователя; cookie с Secure/HttpOnly |
| `GET /api/me` | профиль | cookie |
| `GET /api/stats` | личная статистика | cookie |
| `GET /api/leaderboard` | открытый рейтинг только согласившихся | нет |
| `POST /api/privacy` | тело `true` или `false`, включение публичного рейтинга | cookie + проверка Origin |
| `POST /api/logout` | выход | cookie + проверка Origin |
Сервер проверяет каждую 32-байтную запись и CRC32. Если файл уже существует, новая версия обязана **полностью содержать старый файл как начальный префикс**. Повторная отправка идентичной версии не добавляет циклы; изменение/уменьшение журнала отклоняется с HTTP 409. После проверки файл атомарно заменяется, а суточная статистика пересчитывается и записывается в SQLite через UPSERT. Для разных устройств одного пользователя файлы лежат в отдельных папках.
## 6. Конфиденциальность, администрирование, резервные копии
- По умолчанию **все аккаунты приватные**; другие люди не видят их результаты. Пользователь может включить публичный рейтинг в личном кабинете. В рейтинг попадают только агрегированные показатели, не подробные записи.
- Password storage: PBKDF2-HMAC-SHA256 с солью и 210 тыс. итераций. Веб-сессии и токены устройств в БД хранятся как SHA-256-хеши. Базовые ограничения на перебор логина — до 12 попыток с IP за минуту (для публичного большого проекта позже нужен усиленный anti-abuse перед Caddy).
- Важно делать резервные копии **и `statistics.db` (с учётом SQLite WAL), и `data/logs/`**. При работающем сервере лучше снимать транзакционный SQLite backup, а не просто копировать открытый файл базы без `-wal`.
- Долговременное сохранение FFat зависит от носителя и состояния питания. Базовую защиту обеспечивают append-only журналы, контроль CRC и серверные копии; для критичных данных нужен дополнительный журнал транзакций/резервирование.
- Сайт не утверждает, что измеряет здоровье или качество медитации. Он показывает только события, зафиксированные прибором.
## 7. Известные ограничения первой версии
1. `.ino` пока не прошёл аппаратную компиляцию, прошивку и испытания на вашей конкретной плате. Исходный LVGL UI, сенсор, IMU и аудио сохранены, но реальный тест кнопок, Wi-Fi и FFat обязателен.
2. Серверный Java-класс синтаксически компилируется; двоичный тест CRC и декодирования цикла пройден. Полный тест запуска SQLite/JDBC требует загрузки зависимостей Gradle из Maven Central.
3. Для простоты передаётся **целиком изменившийся суточный файл** (а не только его добавленный хвост); при типичном размере десятки КБ это нормально. Загрузка ограничена 16 МиБ на файл.
4. Если текущий дневной файл физически повреждён или содержит неполную запись, отправка этого файла отклоняется; прибор не удаляет файл автоматически. Нужна ручная диагностика через `LOG LIST`/USB.
5. При недостоверных часах события попадают в `undated.bin`. Автоматически приписывать им выдуманную дату нельзя: их можно учесть в общей сумме, но не привязать надёжно к календарному дню без дополнительной информации.
6. Суточная дата задаётся **фиксированным** UTC-смещением в настройках прибора (автоматический переход на летнее/зимнее время пока не предусмотрен).
7. Изменение времени/смещения суток не переименовывает уже записанные файлы. В случае некорректного времени возможен дневной файл с неправильной датой; хранящиеся в каждой записи UTC и флаг доверия дают возможность дальнейшей коррекции.
8. Устройства на одном аккаунте считаются вместе. Разные физические устройства должны иметь разные ID ESP32. В **первой версии прибор рассчитан на одного владельца**: после успешной привязки вход в другой аккаунт с того же прибора заблокирован, чтобы не загрузить личную историю прежнего владельца в чужой аккаунт. Для передачи устройства другому человеку нужно сначала экспортировать/архивировать журналы и безопасно сбросить локальное хранилище и Preferences (реализация безопасного сброса — отдельная задача).
9. Регистрация пользователей выполняется администратором через CLI; самостоятельная регистрация на сайте не реализована.
10. В `ONLINE → REUPLOAD` удаляется только локальный индекс выгрузок. Если сервер получил отличающуюся старую историю, он вернёт HTTP 409: безопаснее исследовать конфликт, чем автоматически переписать старые данные.
## 8. Проверки до ежедневного использования
- Питание OFF/ON посреди дня → количество 32-байтных записей в текущем файле увеличивается, записи не исчезают.
- Переход через полночь по настроенному времени → создаётся новый датированный файл.
- Сохранённая Wi-Fi сеть недоступна → устройство предлагает список сетей и затем продолжает именно TIME/UPLOAD.
- Отключение интернет-кабеля во время отправки → файл на приборе остаётся, повторная синхронизация работает.
- Повторный `UPLOAD` без новых циклов → нет дублей статистики.
- Появление новых циклов во время отправки → в следующей синхронизации сервер получает расширенный файл.
- Сброс часов RTC → новые события идут в `undated.bin` до синхронизации.
- Новый пользователь/новый токен → доступ только к своим файлам, публичный рейтинг по умолчанию пустой.
- Перед прошивкой заранее выгрузить старый `/events.bin` по USB и сравнить запись после миграции.
### Локальный тест Java без JDBC
```bash
cd server
javac --release 21 BreathServer.java RecordFixtureTest.java
java RecordFixtureTest
```
Ожидаемый ответ: `PASS: 32-byte little-endian event, duration and CRC32 validation`.
---
**После первого запуска** я рекомендую следующий этап: сделать диагностический экран «свободно FFat / не выгружено / ошибка последней передачи» и веб-функцию загрузки журнала вручную с компьютера. Это облегчит восстановление и сопровождение приборов, когда пользователей станет больше.
@@ -0,0 +1,4 @@
breathmonitor.shineup.me {
encode zstd gzip
reverse_proxy 127.0.0.1:8090
}
@@ -0,0 +1,22 @@
[Unit]
Description=BreathMonitor lightweight Java server
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=breathmonitor
Group=breathmonitor
WorkingDirectory=/opt/breathmonitor/server
ExecStart=/opt/breathmonitor/server/start.sh
Environment=BREATH_DATA_DIR=/var/lib/breathmonitor
Environment=BREATH_WEB_DIR=/opt/breathmonitor/server/web
Environment=PUBLIC_ORIGIN=https://breathmonitor.shineup.me
Restart=on-failure
RestartSec=5
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
ReadWritePaths=/var/lib/breathmonitor
PrivateTmp=true
[Install]
WantedBy=multi-user.target
@@ -0,0 +1,31 @@
-----BEGIN CERTIFICATE-----
MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw
TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh
cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4
WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJu
ZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBY
MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54rVygc
h77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+
0TM8ukj13Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6U
A5/TR5d8mUgjU+g4rk8Kb4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sW
T8KOEUt+zwvo/7V3LvSye0rgTBIlDHCNAymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyH
B5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ4Q7e2RCOFvu396j3x+UC
B5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf1b0SHzUv
KBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWn
OlFuhjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTn
jh8BCNAw1FtxNrQHusEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbw
qHyGO0aoSCqI3Haadr8faqU9GY/rOPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CI
rU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV
HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY9umbbjANBgkq
hkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL
ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ
3BebYhtF8GaV0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KK
NFtY2PwByVS5uCbMiogziUwthDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5
ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJwTdwJx4nLCgdNbOhdjsnvzqvHu7Ur
TkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nxe5AW0wdeRlN8NwdC
jNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZAJzVc
oyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq
4RgqsahDYVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPA
mRGunUHBcnWEvgJBQl9nJEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57d
emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc=
-----END CERTIFICATE-----
@@ -0,0 +1,43 @@
#!/usr/bin/env bash
set -euo pipefail
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
WORKSPACE_DIR="$(cd "$ROOT_DIR/../../../../" && pwd)"
DEMO_BASE="$WORKSPACE_DIR/SHiNE-product/ESP32/esp32/ESP32-S3-Touch-AMOLED-2.16/official-demo/examples/Arduino-v3.3.5"
PORT="${PORT:-}"
FQBN="${FQBN:-esp32:esp32:esp32s3:USBMode=hwcdc,CDCOnBoot=cdc,UploadSpeed=921600,CPUFreq=240,FlashMode=dio,FlashSize=16M,PartitionScheme=app3M_fat9M_16MB,PSRAM=opi}"
BUILD_DIR="$ROOT_DIR/../../.arduino-build/breathmonitor-v3"
OUT_DIR="$ROOT_DIR/../../.arduino-build/out-breathmonitor-v3"
if [[ ! -d "$DEMO_BASE/libraries" ]]; then
echo "Missing Waveshare libraries: $DEMO_BASE/libraries" >&2
exit 1
fi
compile_args=(
--fqbn "$FQBN"
--build-path "$BUILD_DIR"
--output-dir "$OUT_DIR"
--library "$DEMO_BASE/libraries/GFX_Library_for_Arduino"
--library "$DEMO_BASE/libraries/SensorLib"
--library "$DEMO_BASE/libraries/XPowersLib"
--library "$DEMO_BASE/libraries/lvgl"
--library "$DEMO_BASE/libraries/Mylibrary"
"$ROOT_DIR/firmware.ino"
)
if ! arduino-cli compile "${compile_args[@]}"; then
arduino-cli compile --clean "${compile_args[@]}"
fi
if [[ "${NO_UPLOAD:-0}" == "1" ]]; then
exit 0
fi
if [[ -z "$PORT" ]]; then
PORT="$(arduino-cli board list | awk '/ttyACM|ttyUSB/ {print $1; exit}')"
fi
if [[ -z "$PORT" ]]; then
echo "Set PORT=/dev/ttyACM0 or use NO_UPLOAD=1." >&2
exit 1
fi
arduino-cli upload --fqbn "$FQBN" -p "$PORT" --input-dir "$OUT_DIR" "$ROOT_DIR/firmware.ino"
@@ -0,0 +1,443 @@
/*
* SPDX-FileCopyrightText: 2015-2022 Espressif Systems (Shanghai) CO LTD
*
* SPDX-License-Identifier: Apache-2.0
*/
#include <string.h>
#include "es8311.h"
#include "driver/gpio.h"
#include "esp_log.h"
#include "esp_err.h"
#include "esp_check.h"
#include "es8311_reg.h"
#include "esp32-hal-i2c.h"
typedef struct {
unsigned int port;
uint16_t dev_addr;
} es8311_dev_t;
/*
* Clock coefficient structure
*/
struct _coeff_div {
uint32_t mclk; /* mclk frequency */
uint32_t rate; /* sample rate */
uint8_t pre_div; /* the pre divider with range from 1 to 8 */
uint8_t pre_multi; /* the pre multiplier with 0: 1x, 1: 2x, 2: 4x, 3: 8x selection */
uint8_t adc_div; /* adcclk divider */
uint8_t dac_div; /* dacclk divider */
uint8_t fs_mode; /* double speed or single speed, =0, ss, =1, ds */
uint8_t lrck_h; /* adclrck divider and daclrck divider */
uint8_t lrck_l;
uint8_t bclk_div; /* sclk divider */
uint8_t adc_osr; /* adc osr */
uint8_t dac_osr; /* dac osr */
};
/* codec hifi mclk clock divider coefficients */
static const struct _coeff_div coeff_div[] = {
/*!<mclk rate pre_div mult adc_div dac_div fs_mode lrch lrcl bckdiv osr */
/* 8k */
{12288000, 8000, 0x06, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{18432000, 8000, 0x03, 0x01, 0x03, 0x03, 0x00, 0x05, 0xff, 0x18, 0x10, 0x10},
{16384000, 8000, 0x08, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{8192000, 8000, 0x04, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{6144000, 8000, 0x03, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{4096000, 8000, 0x02, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{3072000, 8000, 0x01, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{2048000, 8000, 0x01, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{1536000, 8000, 0x03, 0x02, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{1024000, 8000, 0x01, 0x01, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
/* 11.025k */
{11289600, 11025, 0x04, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{5644800, 11025, 0x02, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{2822400, 11025, 0x01, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{1411200, 11025, 0x01, 0x01, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
/* 12k */
{12288000, 12000, 0x04, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{6144000, 12000, 0x02, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{3072000, 12000, 0x01, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{1536000, 12000, 0x01, 0x01, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
/* 16k */
{12288000, 16000, 0x03, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{18432000, 16000, 0x03, 0x01, 0x03, 0x03, 0x00, 0x02, 0xff, 0x0c, 0x10, 0x10},
{16384000, 16000, 0x04, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{8192000, 16000, 0x02, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{6144000, 16000, 0x03, 0x01, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{4096000, 16000, 0x01, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{3072000, 16000, 0x03, 0x02, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{2048000, 16000, 0x01, 0x01, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{1536000, 16000, 0x03, 0x03, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{1024000, 16000, 0x01, 0x02, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
/* 22.05k */
{11289600, 22050, 0x02, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{5644800, 22050, 0x01, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{2822400, 22050, 0x01, 0x01, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{1411200, 22050, 0x01, 0x02, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{705600, 22050, 0x01, 0x03, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
/* 24k */
{12288000, 24000, 0x02, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{18432000, 24000, 0x03, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{6144000, 24000, 0x01, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{3072000, 24000, 0x01, 0x01, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{1536000, 24000, 0x01, 0x02, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
/* 32k */
{12288000, 32000, 0x03, 0x01, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{18432000, 32000, 0x03, 0x02, 0x03, 0x03, 0x00, 0x02, 0xff, 0x0c, 0x10, 0x10},
{16384000, 32000, 0x02, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{8192000, 32000, 0x01, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{6144000, 32000, 0x03, 0x02, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{4096000, 32000, 0x01, 0x01, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{3072000, 32000, 0x03, 0x03, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{2048000, 32000, 0x01, 0x02, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{1536000, 32000, 0x03, 0x03, 0x01, 0x01, 0x01, 0x00, 0x7f, 0x02, 0x10, 0x10},
{1024000, 32000, 0x01, 0x03, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
/* 44.1k */
{11289600, 44100, 0x01, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{5644800, 44100, 0x01, 0x01, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{2822400, 44100, 0x01, 0x02, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{1411200, 44100, 0x01, 0x03, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
/* 48k */
{12288000, 48000, 0x01, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{18432000, 48000, 0x03, 0x01, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{6144000, 48000, 0x01, 0x01, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{3072000, 48000, 0x01, 0x02, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{1536000, 48000, 0x01, 0x03, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
/* 64k */
{12288000, 64000, 0x03, 0x02, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{18432000, 64000, 0x03, 0x02, 0x03, 0x03, 0x01, 0x01, 0x7f, 0x06, 0x10, 0x10},
{16384000, 64000, 0x01, 0x00, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{8192000, 64000, 0x01, 0x01, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{6144000, 64000, 0x01, 0x02, 0x03, 0x03, 0x01, 0x01, 0x7f, 0x06, 0x10, 0x10},
{4096000, 64000, 0x01, 0x02, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{3072000, 64000, 0x01, 0x03, 0x03, 0x03, 0x01, 0x01, 0x7f, 0x06, 0x10, 0x10},
{2048000, 64000, 0x01, 0x03, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{1536000, 64000, 0x01, 0x03, 0x01, 0x01, 0x01, 0x00, 0xbf, 0x03, 0x18, 0x18},
{1024000, 64000, 0x01, 0x03, 0x01, 0x01, 0x01, 0x00, 0x7f, 0x02, 0x10, 0x10},
/* 88.2k */
{11289600, 88200, 0x01, 0x01, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{5644800, 88200, 0x01, 0x02, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{2822400, 88200, 0x01, 0x03, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{1411200, 88200, 0x01, 0x03, 0x01, 0x01, 0x01, 0x00, 0x7f, 0x02, 0x10, 0x10},
/* 96k */
{12288000, 96000, 0x01, 0x01, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{18432000, 96000, 0x03, 0x02, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{6144000, 96000, 0x01, 0x02, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{3072000, 96000, 0x01, 0x03, 0x01, 0x01, 0x00, 0x00, 0xff, 0x04, 0x10, 0x10},
{1536000, 96000, 0x01, 0x03, 0x01, 0x01, 0x01, 0x00, 0x7f, 0x02, 0x10, 0x10},
};
static const char *TAG = "ES8311";
static inline esp_err_t es8311_write_reg(es8311_handle_t dev, uint8_t reg_addr, uint8_t data)
{
es8311_dev_t *es = (es8311_dev_t *) dev;
const uint8_t write_buf[2] = {reg_addr, data};
return i2cWrite(es->port, es->dev_addr, write_buf, sizeof(write_buf), 1000);
}
static inline esp_err_t es8311_read_reg(es8311_handle_t dev, uint8_t reg_addr, uint8_t *reg_value)
{
es8311_dev_t *es = (es8311_dev_t *) dev;
size_t readCount = 0;
return i2cWriteReadNonStop(es->port, es->dev_addr, &reg_addr, 1, reg_value, 1, 1000, &readCount);
}
/*
* look for the coefficient in coeff_div[] table
*/
static int get_coeff(uint32_t mclk, uint32_t rate)
{
for (int i = 0; i < (sizeof(coeff_div) / sizeof(coeff_div[0])); i++) {
if (coeff_div[i].rate == rate && coeff_div[i].mclk == mclk) {
return i;
}
}
return -1;
}
esp_err_t es8311_sample_frequency_config(es8311_handle_t dev, int mclk_frequency, int sample_frequency)
{
uint8_t regv;
/* Get clock coefficients from coefficient table */
int coeff = get_coeff(mclk_frequency, sample_frequency);
if (coeff < 0) {
ESP_LOGE(TAG, "Unable to configure sample rate %dHz with %dHz MCLK", sample_frequency, mclk_frequency);
return ESP_ERR_INVALID_ARG;
}
const struct _coeff_div *const selected_coeff = &coeff_div[coeff];
/* register 0x02 */
ESP_RETURN_ON_ERROR(es8311_read_reg(dev, ES8311_CLK_MANAGER_REG02, &regv), TAG, "I2C read/write error");
regv &= 0x07;
regv |= (selected_coeff->pre_div - 1) << 5;
regv |= selected_coeff->pre_multi << 3;
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_CLK_MANAGER_REG02, regv), TAG, "I2C read/write error");
/* register 0x03 */
const uint8_t reg03 = (selected_coeff->fs_mode << 6) | selected_coeff->adc_osr;
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_CLK_MANAGER_REG03, reg03), TAG, "I2C read/write error");
/* register 0x04 */
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_CLK_MANAGER_REG04, selected_coeff->dac_osr), TAG, "I2C read/write error");
/* register 0x05 */
const uint8_t reg05 = ((selected_coeff->adc_div - 1) << 4) | (selected_coeff->dac_div - 1);
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_CLK_MANAGER_REG05, reg05), TAG, "I2C read/write error");
/* register 0x06 */
ESP_RETURN_ON_ERROR(es8311_read_reg(dev, ES8311_CLK_MANAGER_REG06, &regv), TAG, "I2C read/write error");
regv &= 0xE0;
if (selected_coeff->bclk_div < 19) {
regv |= (selected_coeff->bclk_div - 1) << 0;
} else {
regv |= (selected_coeff->bclk_div) << 0;
}
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_CLK_MANAGER_REG06, regv), TAG, "I2C read/write error");
/* register 0x07 */
ESP_RETURN_ON_ERROR(es8311_read_reg(dev, ES8311_CLK_MANAGER_REG07, &regv), TAG, "I2C read/write error");
regv &= 0xC0;
regv |= selected_coeff->lrck_h << 0;
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_CLK_MANAGER_REG07, regv), TAG, "I2C read/write error");
/* register 0x08 */
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_CLK_MANAGER_REG08, selected_coeff->lrck_l), TAG, "I2C read/write error");
return ESP_OK;
}
static esp_err_t es8311_clock_config(es8311_handle_t dev, const es8311_clock_config_t *const clk_cfg, es8311_resolution_t res)
{
uint8_t reg06;
uint8_t reg01 = 0x3F; // Enable all clocks
int mclk_hz;
/* Select clock source for internal MCLK and determine its frequency */
if (clk_cfg->mclk_from_mclk_pin) {
mclk_hz = clk_cfg->mclk_frequency;
} else {
mclk_hz = clk_cfg->sample_frequency * (int)res * 2;
reg01 |= BIT(7); // Select BCLK (a.k.a. SCK) pin
}
if (clk_cfg->mclk_inverted) {
reg01 |= BIT(6); // Invert MCLK pin
}
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_CLK_MANAGER_REG01, reg01), TAG, "I2C read/write error");
ESP_RETURN_ON_ERROR(es8311_read_reg(dev, ES8311_CLK_MANAGER_REG06, &reg06), TAG, "I2C read/write error");
if (clk_cfg->sclk_inverted) {
reg06 |= BIT(5);
} else {
reg06 &= ~BIT(5);
}
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_CLK_MANAGER_REG06, reg06), TAG, "I2C read/write error");
/* Configure clock dividers */
return es8311_sample_frequency_config(dev, mclk_hz, clk_cfg->sample_frequency);
}
static esp_err_t es8311_resolution_config(const es8311_resolution_t res, uint8_t *reg)
{
switch (res) {
case ES8311_RESOLUTION_16:
*reg |= (3 << 2);
break;
case ES8311_RESOLUTION_18:
*reg |= (2 << 2);
break;
case ES8311_RESOLUTION_20:
*reg |= (1 << 2);
break;
case ES8311_RESOLUTION_24:
*reg |= (0 << 2);
break;
case ES8311_RESOLUTION_32:
*reg |= (4 << 2);
break;
default:
return ESP_ERR_INVALID_ARG;
}
return ESP_OK;
}
static esp_err_t es8311_fmt_config(es8311_handle_t dev, const es8311_resolution_t res_in, const es8311_resolution_t res_out)
{
uint8_t reg09 = 0; // SDP In
uint8_t reg0a = 0; // SDP Out
ESP_LOGI(TAG, "ES8311 in Slave mode and I2S format");
uint8_t reg00;
ESP_RETURN_ON_ERROR(es8311_read_reg(dev, ES8311_RESET_REG00, &reg00), TAG, "I2C read/write error");
reg00 &= 0xBF;
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_RESET_REG00, reg00), TAG, "I2C read/write error"); // Slave serial port - default
/* Setup SDP In and Out resolution */
es8311_resolution_config(res_in, &reg09);
es8311_resolution_config(res_out, &reg0a);
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_SDPIN_REG09, reg09), TAG, "I2C read/write error");
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_SDPOUT_REG0A, reg0a), TAG, "I2C read/write error");
return ESP_OK;
}
esp_err_t es8311_microphone_config(es8311_handle_t dev, bool digital_mic)
{
uint8_t reg14 = 0x1A; // enable analog MIC and max PGA gain
/* PDM digital microphone enable or disable */
if (digital_mic) {
reg14 |= BIT(6);
}
es8311_write_reg(dev, ES8311_ADC_REG17, 0xC8); // Set ADC gain @todo move this to ADC config section
return es8311_write_reg(dev, ES8311_SYSTEM_REG14, reg14);
}
esp_err_t es8311_init(es8311_handle_t dev, const es8311_clock_config_t *const clk_cfg, const es8311_resolution_t res_in, const es8311_resolution_t res_out)
{
ESP_RETURN_ON_FALSE(
(clk_cfg->sample_frequency >= 8000) && (clk_cfg->sample_frequency <= 96000),
ESP_ERR_INVALID_ARG, TAG, "ES8311 init needs frequency in interval [8000; 96000] Hz"
);
if (!clk_cfg->mclk_from_mclk_pin) {
ESP_RETURN_ON_FALSE(res_out == res_in, ESP_ERR_INVALID_ARG, TAG, "Resolution IN/OUT must be equal if MCLK is taken from SCK pin");
}
/* Reset ES8311 to its default */
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_RESET_REG00, 0x1F), TAG, "I2C read/write error");
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_RESET_REG00, 0x00), TAG, "I2C read/write error");
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_RESET_REG00, 0x80), TAG, "I2C read/write error"); // Power-on command
/* Setup clock: source, polarity and clock dividers */
ESP_RETURN_ON_ERROR(es8311_clock_config(dev, clk_cfg, res_out), TAG, "");
/* Setup audio format (fmt): master/slave, resolution, I2S */
ESP_RETURN_ON_ERROR(es8311_fmt_config(dev, res_in, res_out), TAG, "");
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_SYSTEM_REG0D, 0x01), TAG, "I2C read/write error"); // Power up analog circuitry - NOT default
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_SYSTEM_REG0E, 0x02), TAG, "I2C read/write error"); // Enable analog PGA, enable ADC modulator - NOT default
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_SYSTEM_REG12, 0x00), TAG, "I2C read/write error"); // power-up DAC - NOT default
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_SYSTEM_REG13, 0x10), TAG, "I2C read/write error"); // Enable output to HP drive - NOT default
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_ADC_REG1C, 0x6A), TAG, "I2C read/write error"); // ADC Equalizer bypass, cancel DC offset in digital domain
ESP_RETURN_ON_ERROR(es8311_write_reg(dev, ES8311_DAC_REG37, 0x08), TAG, "I2C read/write error"); // Bypass DAC equalizer - NOT default
return ESP_OK;
}
void es8311_delete(es8311_handle_t dev)
{
free(dev);
}
esp_err_t es8311_voice_volume_set(es8311_handle_t dev, int volume, int *volume_set)
{
if (volume < 0) {
volume = 0;
} else if (volume > 100) {
volume = 100;
}
int reg32;
if (volume == 0) {
reg32 = 0;
} else {
reg32 = ((volume) * 256 / 100) - 1;
}
// provide user with real volume set
if (volume_set != NULL) {
*volume_set = volume;
}
return es8311_write_reg(dev, ES8311_DAC_REG32, reg32);
}
esp_err_t es8311_voice_volume_get(es8311_handle_t dev, int *volume)
{
uint8_t reg32;
ESP_RETURN_ON_ERROR(es8311_read_reg(dev, ES8311_DAC_REG32, &reg32), TAG, "I2C read/write error");
if (reg32 == 0) {
*volume = 0;
} else {
*volume = ((reg32 * 100) / 256) + 1;
}
return ESP_OK;
}
esp_err_t es8311_voice_mute(es8311_handle_t dev, bool mute)
{
uint8_t reg31;
ESP_RETURN_ON_ERROR(es8311_read_reg(dev, ES8311_DAC_REG31, &reg31), TAG, "I2C read/write error");
if (mute) {
reg31 |= BIT(6) | BIT(5);
} else {
reg31 &= ~(BIT(6) | BIT(5));
}
return es8311_write_reg(dev, ES8311_DAC_REG31, reg31);
}
esp_err_t es8311_microphone_gain_set(es8311_handle_t dev, es8311_mic_gain_t gain_db)
{
return es8311_write_reg(dev, ES8311_ADC_REG16, gain_db); // ADC gain scale up
}
esp_err_t es8311_voice_fade(es8311_handle_t dev, const es8311_fade_t fade)
{
uint8_t reg37;
ESP_RETURN_ON_ERROR(es8311_read_reg(dev, ES8311_DAC_REG37, &reg37), TAG, "I2C read/write error");
reg37 &= 0x0F;
reg37 |= (fade << 4);
return es8311_write_reg(dev, ES8311_DAC_REG37, reg37);
}
esp_err_t es8311_microphone_fade(es8311_handle_t dev, const es8311_fade_t fade)
{
uint8_t reg15;
ESP_RETURN_ON_ERROR(es8311_read_reg(dev, ES8311_ADC_REG15, &reg15), TAG, "I2C read/write error");
reg15 &= 0x0F;
reg15 |= (fade << 4);
return es8311_write_reg(dev, ES8311_ADC_REG15, reg15);
}
void es8311_register_dump(es8311_handle_t dev)
{
for (int reg = 0; reg < 0x4A; reg++) {
uint8_t value;
ESP_ERROR_CHECK(es8311_read_reg(dev, reg, &value));
printf("REG:%02x: %02x", reg, value);
}
}
es8311_handle_t es8311_create(const unsigned int port, const uint16_t dev_addr)
{
es8311_dev_t *sensor = (es8311_dev_t *) calloc(1, sizeof(es8311_dev_t));
sensor->port = port;
sensor->dev_addr = dev_addr;
return (es8311_handle_t) sensor;
}
@@ -0,0 +1,227 @@
/*
* SPDX-FileCopyrightText: 2015-2022 Espressif Systems (Shanghai) CO LTD
*
* SPDX-License-Identifier: Apache-2.0
*/
/**
* @file
* @brief ES8311 driver
*/
#pragma once
#include "esp_types.h"
#include "esp_err.h"
/* ES8311 address: CE pin low - 0x18, CE pin high - 0x19 */
#define ES8311_ADDRRES_0 0x18u // Leaving this here for backward compatibility
#define ES8311_ADDRESS_0 0x18u
#define ES8311_ADDRESS_1 0x19u
#ifdef __cplusplus
extern "C" {
#endif
typedef void *es8311_handle_t;
typedef enum {
ES8311_MIC_GAIN_MIN = -1,
ES8311_MIC_GAIN_0DB,
ES8311_MIC_GAIN_6DB,
ES8311_MIC_GAIN_12DB,
ES8311_MIC_GAIN_18DB,
ES8311_MIC_GAIN_24DB,
ES8311_MIC_GAIN_30DB,
ES8311_MIC_GAIN_36DB,
ES8311_MIC_GAIN_42DB,
ES8311_MIC_GAIN_MAX
} es8311_mic_gain_t;
typedef enum {
ES8311_FADE_OFF = 0,
ES8311_FADE_4LRCK, // 4LRCK means ramp 0.25dB/4LRCK
ES8311_FADE_8LRCK,
ES8311_FADE_16LRCK,
ES8311_FADE_32LRCK,
ES8311_FADE_64LRCK,
ES8311_FADE_128LRCK,
ES8311_FADE_256LRCK,
ES8311_FADE_512LRCK,
ES8311_FADE_1024LRCK,
ES8311_FADE_2048LRCK,
ES8311_FADE_4096LRCK,
ES8311_FADE_8192LRCK,
ES8311_FADE_16384LRCK,
ES8311_FADE_32768LRCK,
ES8311_FADE_65536LRCK
} es8311_fade_t;
typedef enum es8311_resolution_t {
ES8311_RESOLUTION_16 = 16,
ES8311_RESOLUTION_18 = 18,
ES8311_RESOLUTION_20 = 20,
ES8311_RESOLUTION_24 = 24,
ES8311_RESOLUTION_32 = 32
} es8311_resolution_t;
typedef struct es8311_clock_config_t {
bool mclk_inverted;
bool sclk_inverted;
bool mclk_from_mclk_pin; // true: from MCLK pin (pin no. 2), false: from SCLK pin (pin no. 6)
int mclk_frequency; // This parameter is ignored if MCLK is taken from SCLK pin
int sample_frequency; // in Hz
} es8311_clock_config_t;
/**
* @brief Initialize ES8311
*
* There are two ways of providing Master Clock (MCLK) signal to ES8311 in Slave Mode:
* 1. From MCLK pin:
* For flexible scenarios. A clock signal from I2S master is routed to MCLK pin.
* Its frequency must be defined in clk_cfg->mclk_frequency parameter.
* 2. From SCLK pin:
* For simpler scenarios. ES8311 takes its clock from SCK pin. MCLK pin does not have to be connected.
* In this case, res_in must equal res_out; clk_cfg->mclk_frequency parameter is ignored
* and MCLK is calculated as MCLK = clk_cfg->sample_frequency * res_out * 2.
* Not all sampling frequencies are supported in this mode.
*
* @param dev ES8311 handle
* @param[in] clk_cfg Clock configuration
* @param[in] res_in Input serial port resolution
* @param[in] res_out Output serial port resolution
* @return
* - ESP_OK success
* - ESP_ERR_INVALID_ARG Sample frequency or resolution invalid
* - Else fail
*/
esp_err_t es8311_init(es8311_handle_t dev, const es8311_clock_config_t *const clk_cfg, const es8311_resolution_t res_in,
const es8311_resolution_t res_out);
/**
* @brief Set output volume
*
* Volume paramter out of <0, 100> interval will be truncated.
*
* @param dev ES8311 handle
* @param[in] volume Set volume (0 ~ 100)
* @param[out] volume_set Volume that was set. Same as volume, unless volume is outside of <0, 100> interval.
* This parameter can be set to NULL, if user does not need this information.
*
* @return
* - ESP_OK success
* - Else fail
*/
esp_err_t es8311_voice_volume_set(es8311_handle_t dev, int volume, int *volume_set);
/**
* @brief Get output volume
*
* @param dev ES8311 handle
* @param[out] volume get volume (0 ~ 100)
*
* @return
* - ESP_OK success
* - Else fail
*/
esp_err_t es8311_voice_volume_get(es8311_handle_t dev, int *volume);
/**
* @brief Print out ES8311 register content
*
* @param dev ES8311 handle
*/
void es8311_register_dump(es8311_handle_t dev);
/**
* @brief Mute ES8311 output
*
* @param dev ES8311 handle
* @param[in] enable true: mute, false: don't mute
* @return
* - ESP_OK success
* - Else fail
*/
esp_err_t es8311_voice_mute(es8311_handle_t dev, bool enable);
/**
* @brief Set Microphone gain
*
* @param dev ES8311 handle
* @param[in] gain_db Microphone gain
* @return
* - ESP_OK success
* - Else fail
*/
esp_err_t es8311_microphone_gain_set(es8311_handle_t dev, es8311_mic_gain_t gain_db);
/**
* @brief Configure microphone
*
* @param dev ES8311 handle
* @param[in] digital_mic Set to true for digital microphone
* @return
* - ESP_OK success
* - Else fail
*/
esp_err_t es8311_microphone_config(es8311_handle_t dev, bool digital_mic);
/**
* @brief Configure sampling frequency
*
* @note This function is called by es8311_init().
* Call this function explicitly only if you want to change sample frequency during runtime.
* @param dev ES8311 handle
* @param[in] mclk_frequency MCLK frequency in [Hz] (MCLK or SCLK pin, depending on bit register01[7])
* @param[in] sample_frequency Required sample frequency in [Hz], e.g. 44100, 22050...
* @return
* - ESP_OK success
* - ESP_ERR_INVALID_ARG cannot set clock dividers for given MCLK and sampling frequency
* - Else I2C read/write error
*/
esp_err_t es8311_sample_frequency_config(es8311_handle_t dev, int mclk_frequency, int sample_frequency);
/**
* @brief Configure fade in/out for ADC: voice
*
* @param dev ES8311 handle
* @param[in] fade Fade ramp rate
* @return
* - ESP_OK success
* - Else I2C read/write error
*/
esp_err_t es8311_voice_fade(es8311_handle_t dev, const es8311_fade_t fade);
/**
* @brief Configure fade in/out for DAC: microphone
*
* @param dev ES8311 handle
* @param[in] fade Fade ramp rate
* @return
* - ESP_OK success
* - Else I2C read/write error
*/
esp_err_t es8311_microphone_fade(es8311_handle_t dev, const es8311_fade_t fade);
/**
* @brief Create ES8311 object and return its handle
*
* @param[in] port I2C port number
* @param[in] dev_addr I2C device address of ES8311
*
* @return
* - NULL Fail
* - Others Success
*/
es8311_handle_t es8311_create(const unsigned int port, const uint16_t dev_addr);
/**
* @brief Delete ES8311 object
*
* @param dev ES8311 handle
*/
void es8311_delete(es8311_handle_t dev);
#ifdef __cplusplus
}
#endif
@@ -0,0 +1,76 @@
/*
* SPDX-FileCopyrightText: 2015-2021 Espressif Systems (Shanghai) CO LTD
*
* SPDX-License-Identifier: Apache-2.0
*/
#pragma once
/*
* ES8311_REGISTER NAME_REG_REGISTER ADDRESS
*/
#define ES8311_RESET_REG00 0x00 /*reset digital,csm,clock manager etc.*/
/*
* Clock Scheme Register definition
*/
#define ES8311_CLK_MANAGER_REG01 0x01 /* select clk src for mclk, enable clock for codec */
#define ES8311_CLK_MANAGER_REG02 0x02 /* clk divider and clk multiplier */
#define ES8311_CLK_MANAGER_REG03 0x03 /* adc fsmode and osr */
#define ES8311_CLK_MANAGER_REG04 0x04 /* dac osr */
#define ES8311_CLK_MANAGER_REG05 0x05 /* clk divier for adc and dac */
#define ES8311_CLK_MANAGER_REG06 0x06 /* bclk inverter and divider */
#define ES8311_CLK_MANAGER_REG07 0x07 /* tri-state, lrck divider */
#define ES8311_CLK_MANAGER_REG08 0x08 /* lrck divider */
/*
* SDP
*/
#define ES8311_SDPIN_REG09 0x09 /* dac serial digital port */
#define ES8311_SDPOUT_REG0A 0x0A /* adc serial digital port */
/*
* SYSTEM
*/
#define ES8311_SYSTEM_REG0B 0x0B /* system */
#define ES8311_SYSTEM_REG0C 0x0C /* system */
#define ES8311_SYSTEM_REG0D 0x0D /* system, power up/down */
#define ES8311_SYSTEM_REG0E 0x0E /* system, power up/down */
#define ES8311_SYSTEM_REG0F 0x0F /* system, low power */
#define ES8311_SYSTEM_REG10 0x10 /* system */
#define ES8311_SYSTEM_REG11 0x11 /* system */
#define ES8311_SYSTEM_REG12 0x12 /* system, Enable DAC */
#define ES8311_SYSTEM_REG13 0x13 /* system */
#define ES8311_SYSTEM_REG14 0x14 /* system, select DMIC, select analog pga gain */
/*
* ADC
*/
#define ES8311_ADC_REG15 0x15 /* ADC, adc ramp rate, dmic sense */
#define ES8311_ADC_REG16 0x16 /* ADC */
#define ES8311_ADC_REG17 0x17 /* ADC, volume */
#define ES8311_ADC_REG18 0x18 /* ADC, alc enable and winsize */
#define ES8311_ADC_REG19 0x19 /* ADC, alc maxlevel */
#define ES8311_ADC_REG1A 0x1A /* ADC, alc automute */
#define ES8311_ADC_REG1B 0x1B /* ADC, alc automute, adc hpf s1 */
#define ES8311_ADC_REG1C 0x1C /* ADC, equalizer, hpf s2 */
/*
* DAC
*/
#define ES8311_DAC_REG31 0x31 /* DAC, mute */
#define ES8311_DAC_REG32 0x32 /* DAC, volume */
#define ES8311_DAC_REG33 0x33 /* DAC, offset */
#define ES8311_DAC_REG34 0x34 /* DAC, drc enable, drc winsize */
#define ES8311_DAC_REG35 0x35 /* DAC, drc maxlevel, minilevel */
#define ES8311_DAC_REG37 0x37 /* DAC, ramprate */
/*
*GPIO
*/
#define ES8311_GPIO_REG44 0x44 /* GPIO, dac2adc for test */
#define ES8311_GP_REG45 0x45 /* GP CONTROL */
/*
* CHIP
*/
#define ES8311_CHD1_REGFD 0xFD /* CHIP ID1 */
#define ES8311_CHD2_REGFE 0xFE /* CHIP ID2 */
#define ES8311_CHVER_REGFF 0xFF /* VERSION */
#define ES8311_CHD1_REGFD 0xFD /* CHIP ID1 */
#define ES8311_MAX_REGISTER 0xFF
File diff suppressed because it is too large Load Diff
@@ -0,0 +1,11 @@
# AGENTS — BreathMonitor server
- Сборка выполняется только локально через `./gradlew --no-daemon shadowJar` на JDK 17.
- VPS получает только `build/libs/breathmonitor-1.0.0.jar`; Maven/Gradle на VPS не запускать.
- Runtime-каталог данных задаётся `BREATH_DATA_DIR=/var/lib/breathmonitor` и не должен попадать в пакет приложения.
- Не менять `/var/lib/breathmonitor` при обновлении JAR.
- Не добавлять в git SQLite-файлы, логи, токены, пароли и временные `.gradle`/`build`-артефакты.
- При изменении REST API обновлять описание API в `README_RU.md` и проверять совместимость прошивки.
- При изменении схемы журналов обновлять документацию и тест `RecordFixtureTest.java`.
- Сервис слушает только `127.0.0.1:8090`; внешний HTTPS обслуживает Caddy.
- Production/test VPS не использовать для компиляции: отсутствие Maven/Gradle на VPS является нормальным и ожидаемым состоянием.
@@ -0,0 +1,464 @@
import com.sun.net.httpserver.Headers;
import com.sun.net.httpserver.HttpExchange;
import com.sun.net.httpserver.HttpServer;
import javax.crypto.SecretKeyFactory;
import javax.crypto.spec.PBEKeySpec;
import java.io.*;
import java.net.*;
import java.nio.ByteBuffer;
import java.nio.ByteOrder;
import java.nio.charset.StandardCharsets;
import java.nio.file.*;
import java.security.*;
import java.sql.*;
import java.time.*;
import java.time.format.DateTimeFormatter;
import java.util.*;
import java.util.concurrent.*;
import java.util.zip.CRC32;
/** Lightweight standalone server: HTTP API, SQLite, immutable record parser and a static dashboard.
* Deploy behind a HTTPS reverse-proxy (Caddy); never expose the raw HTTP port publicly.
* JDK 21 + org.xerial:sqlite-jdbc (shaded by Gradle). No Spring, Node, or external database.
*/
public final class BreathServer {
private static final int RECORD = 32, MAX_UPLOAD = 16 * 1024 * 1024, ITERATIONS = 210_000;
private static final long SESSION_TTL = 14L * 24 * 3600 * 1000;
private static final SecureRandom RNG = new SecureRandom();
private static final String DB_URL = "jdbc:sqlite:" + Path.of(System.getenv().getOrDefault("BREATH_DATA_DIR", "data"), "statistics.db").toAbsolutePath();
private static final Path DATA = Path.of(System.getenv().getOrDefault("BREATH_DATA_DIR", "data")).toAbsolutePath();
private static final Path WEB = Path.of(System.getenv().getOrDefault("BREATH_WEB_DIR", "web")).toAbsolutePath();
private static final String ORIGIN = System.getenv().getOrDefault("PUBLIC_ORIGIN", "https://breathmonitor.shineup.me");
private static final String BIND = System.getenv().getOrDefault("BREATH_BIND", "127.0.0.1");
private static final int PORT = Integer.parseInt(System.getenv().getOrDefault("BREATH_PORT", "8090"));
private static final DateTimeFormatter DAY = DateTimeFormatter.BASIC_ISO_DATE;
private static final Map<String, LoginThrottle> THROTTLES = new ConcurrentHashMap<>();
private static final Object UPLOAD_LOCK = new Object();
record User(long id, String login, boolean published) {}
record FileSummary(long cycles, long durationMs, long inhaleMs, long exhaleMs, long maxCycleMs) {}
static final class HttpError extends Exception {
final int status;
HttpError(int status, String message) { super(message); this.status = status; }
}
static final class LoginThrottle { long start = System.currentTimeMillis(); int attempts; }
public static void main(String[] args) throws Exception {
Files.createDirectories(DATA);
Class.forName("org.sqlite.JDBC");
initialize();
if (args.length > 0) {
if (args.length == 2 && args[0].equals("create-user")) { createUser(args[1]); return; }
if (args.length == 2 && args[0].equals("reset-password")) { resetPassword(args[1]); return; }
System.err.println("Usage: java -jar BreathServer.jar [create-user <login> | reset-password <login>]");
System.exit(2);
}
HttpServer server = HttpServer.create(new InetSocketAddress(InetAddress.getByName(BIND), PORT), 64);
server.createContext("/", BreathServer::dispatch);
server.setExecutor(Executors.newFixedThreadPool(12));
server.start();
System.out.printf("BreathMonitor listening on http://%s:%d (public origin %s)%n", BIND, PORT, ORIGIN);
}
private static Connection connection() throws SQLException {
Connection c = DriverManager.getConnection(DB_URL);
try (Statement s = c.createStatement()) {
s.execute("PRAGMA foreign_keys=ON");
s.execute("PRAGMA busy_timeout=5000");
}
return c;
}
private static void initialize() throws SQLException {
try (Connection c = connection(); Statement s = c.createStatement()) {
s.execute("PRAGMA journal_mode=WAL");
s.execute("""
CREATE TABLE IF NOT EXISTS users (
id INTEGER PRIMARY KEY, login TEXT NOT NULL UNIQUE,
salt TEXT NOT NULL, password_hash TEXT NOT NULL,
published INTEGER NOT NULL DEFAULT 0)
""");
s.execute("""
CREATE TABLE IF NOT EXISTS devices (
user_id INTEGER NOT NULL, device_id TEXT NOT NULL,
token_hash TEXT NOT NULL, created_at INTEGER NOT NULL,
PRIMARY KEY(user_id,device_id), FOREIGN KEY(user_id) REFERENCES users(id))
""");
s.execute("CREATE UNIQUE INDEX IF NOT EXISTS devices_tokens ON devices(token_hash)");
s.execute("""
CREATE TABLE IF NOT EXISTS sessions (
token_hash TEXT PRIMARY KEY, user_id INTEGER NOT NULL,
expires_at INTEGER NOT NULL, FOREIGN KEY(user_id) REFERENCES users(id))
""");
s.execute("""
CREATE TABLE IF NOT EXISTS uploads (
user_id INTEGER NOT NULL, device_id TEXT NOT NULL, day TEXT NOT NULL,
bytes INTEGER NOT NULL, sha256 TEXT NOT NULL, cycles INTEGER NOT NULL,
duration_ms INTEGER NOT NULL, inhale_ms INTEGER NOT NULL,
exhale_ms INTEGER NOT NULL, max_cycle_ms INTEGER NOT NULL,
updated_at INTEGER NOT NULL,
PRIMARY KEY(user_id,device_id,day), FOREIGN KEY(user_id) REFERENCES users(id))
""");
}
}
private static String readPassword(String prompt) throws IOException {
Console console = System.console();
if (console != null) {
char[] p = console.readPassword("%s", prompt);
if (p == null) throw new IOException("Password input cancelled");
String result = new String(p); Arrays.fill(p, '\0'); return result;
}
System.out.print(prompt);
BufferedReader reader = new BufferedReader(new InputStreamReader(System.in, StandardCharsets.UTF_8));
String result = reader.readLine();
if (result == null) throw new IOException("Password input cancelled");
return result;
}
private static void createUser(String login) throws Exception {
validLogin(login);
String pwd = readPassword("New password (1..63 characters): ");
if (pwd.isEmpty() || pwd.length() > 63) throw new IllegalArgumentException("Password must contain 1..63 characters");
String salt = tokenBytes(16), hash = passwordHash(pwd, salt);
try (Connection c = connection(); PreparedStatement p = c.prepareStatement("INSERT INTO users(login,salt,password_hash) VALUES(?,?,?)")) {
p.setString(1, login); p.setString(2, salt); p.setString(3, hash); p.executeUpdate();
}
System.out.println("Created user: " + login + ". Sign in on the dashboard, then pair the device.");
}
private static void resetPassword(String login) throws Exception {
validLogin(login); String pwd = readPassword("New password (1..63 characters): ");
if (pwd.isEmpty() || pwd.length() > 63) throw new IllegalArgumentException("Password must contain 1..63 characters");
String salt = tokenBytes(16), hash = passwordHash(pwd, salt);
try (Connection c = connection()) {
c.setAutoCommit(false);
try (PreparedStatement p = c.prepareStatement("UPDATE users SET salt=?,password_hash=? WHERE login=?")) {
p.setString(1, salt); p.setString(2, hash); p.setString(3, login);
if (p.executeUpdate() != 1) throw new IllegalArgumentException("Unknown user: " + login);
}
try (PreparedStatement p = c.prepareStatement("DELETE FROM sessions WHERE user_id=(SELECT id FROM users WHERE login=?)")) {
p.setString(1, login); p.executeUpdate();
}
try (PreparedStatement p = c.prepareStatement("DELETE FROM devices WHERE user_id=(SELECT id FROM users WHERE login=?)")) {
p.setString(1, login); p.executeUpdate();
}
c.commit();
}
System.out.println("Password updated, web sessions and device tokens revoked.");
}
private static byte[] fromHex(String hex) { return HexFormat.of().parseHex(hex); }
private static String tokenBytes(int n) { byte[] v = new byte[n]; RNG.nextBytes(v); return HexFormat.of().formatHex(v); }
private static String sha(byte[] b) {
try { return HexFormat.of().formatHex(MessageDigest.getInstance("SHA-256").digest(b)); }
catch (NoSuchAlgorithmException ex) { throw new AssertionError(ex); }
}
private static String sha(String v) { return sha(v.getBytes(StandardCharsets.UTF_8)); }
private static String passwordHash(String pwd, String salt) throws Exception {
PBEKeySpec spec = new PBEKeySpec(pwd.toCharArray(), fromHex(salt), ITERATIONS, 256);
try { return HexFormat.of().formatHex(SecretKeyFactory.getInstance("PBKDF2WithHmacSHA256").generateSecret(spec).getEncoded()); }
finally { spec.clearPassword(); }
}
private static void validLogin(String login) throws HttpError {
if (!login.matches("[a-z0-9_-]{3,24}")) throw new HttpError(400, "Login must be 3..24 lowercase characters, numbers, '_' or '-'");
}
private static void validDevice(String device) throws HttpError {
if (!device.matches("[0-9A-F]{12}")) throw new HttpError(400, "Invalid device ID");
}
private static void validDay(String day) throws HttpError {
if (day.equals("undated")) return;
if (!day.matches("20[2-9][0-9][0-1][0-9][0-3][0-9]")) throw new HttpError(400, "Invalid day");
try { LocalDate.parse(day, DAY); } catch (Exception ex) { throw new HttpError(400, "Invalid calendar date"); }
}
private static void dispatch(HttpExchange x) {
try {
Headers h = x.getResponseHeaders();
h.set("X-Content-Type-Options", "nosniff"); h.set("Referrer-Policy", "no-referrer");
h.set("X-Frame-Options", "DENY"); h.set("Cache-Control", "no-store");
h.set("Content-Security-Policy", "default-src 'self'; script-src 'self'; style-src 'self'; connect-src 'self'; img-src 'self' data:; object-src 'none'; base-uri 'none'; frame-ancestors 'none'");
String path = x.getRequestURI().getPath(), method = x.getRequestMethod();
switch (path) {
case "/api/health" -> { if (!method.equals("GET")) throw new HttpError(405,"Method not allowed"); json(x,200,"{\"ok\":true}"); }
case "/api/device/login" -> { requireMethod(method,"POST"); deviceLogin(x); }
case "/api/device/upload" -> { requireMethod(method,"PUT"); deviceUpload(x); }
case "/api/login" -> { requireMethod(method,"POST"); requireBrowserOrigin(x); browserLogin(x); }
case "/api/logout" -> { requireMethod(method,"POST"); requireBrowserOrigin(x); browserLogout(x); }
case "/api/me" -> { requireMethod(method,"GET"); me(x); }
case "/api/stats" -> { requireMethod(method,"GET"); stats(x); }
case "/api/leaderboard" -> { requireMethod(method,"GET"); leaderboard(x); }
case "/api/privacy" -> { requireMethod(method,"POST"); requireBrowserOrigin(x); privacy(x); }
default -> { if (!method.equals("GET")&& !method.equals("HEAD")) throw new HttpError(405,"Method not allowed"); serveWeb(x,path,method); }
}
} catch (HttpError err) { sendError(x,err.status,err.getMessage()); }
catch (Exception err) { System.err.println("API error: " + err); sendError(x,500,"Internal error"); }
finally { x.close(); }
}
private static void requireMethod(String actual,String expected) throws HttpError { if (!actual.equals(expected))throw new HttpError(405,"Expected " + expected); }
private static void requireBrowserOrigin(HttpExchange x) throws HttpError {
String origin = x.getRequestHeaders().getFirst("Origin");
if (!ORIGIN.equals(origin)) throw new HttpError(403,"Origin mismatch");
}
private static byte[] readLimited(HttpExchange x, int limit) throws IOException, HttpError {
long len = 0;
try { len = Long.parseLong(Optional.ofNullable(x.getRequestHeaders().getFirst("Content-Length")).orElse("-1")); }
catch (NumberFormatException err) { throw new HttpError(400,"Invalid content length"); }
if (len > limit) throw new HttpError(413,"Payload too large");
try (InputStream in = x.getRequestBody(); ByteArrayOutputStream out = new ByteArrayOutputStream()) {
byte[] buf = new byte[8192]; int n;
while ((n=in.read(buf))!=-1) { if (out.size()+n > limit) throw new HttpError(413,"Payload too large"); out.write(buf,0,n); }
return out.toByteArray();
}
}
private static String[] credentials(HttpExchange x, boolean device) throws Exception {
String body = new String(readLimited(x, 1024),StandardCharsets.UTF_8);
String[] parts = body.split("\\n",-1);
if (parts.length != (device?3:2)) throw new HttpError(400,"Invalid credential payload");
validLogin(parts[0]);
if (device) validDevice(parts[2]);
return parts;
}
private static String remoteAddress(HttpExchange x) {
// Caddy is trusted and the server binds to 127.0.0.1: use its Remote-IP as a throttle key.
String ip = x.getRequestHeaders().getFirst("X-Forwarded-For");
return ip!=null && ip.length()<100 ? ip.split(",")[0].trim() : x.getRemoteAddress().getAddress().getHostAddress();
}
private static void throttle(HttpExchange x) throws HttpError {
String ip=remoteAddress(x); long now=System.currentTimeMillis();
LoginThrottle l=THROTTLES.computeIfAbsent(ip,key->new LoginThrottle());
synchronized (l) {
if (now-l.start>60000){l.start=now;l.attempts=0;}
if (++l.attempts>12) throw new HttpError(429,"Too many login attempts, try again later");
}
if (THROTTLES.size()>10000) THROTTLES.clear();
}
private static User checkCredentials(String login,String pass) throws Exception {
try(Connection c=connection();PreparedStatement p=c.prepareStatement("SELECT id,salt,password_hash,published FROM users WHERE login=?")) {
p.setString(1,login);
try(ResultSet rs=p.executeQuery()){
if(!rs.next())return null;
String actual=passwordHash(pass,rs.getString("salt"));
if (!MessageDigest.isEqual(fromHex(actual),fromHex(rs.getString("password_hash"))))return null;
return new User(rs.getLong("id"),login,rs.getInt("published")==1);
}
}
}
private static void deviceLogin(HttpExchange x) throws Exception {
throttle(x);
String[] values=credentials(x,true);
User user=checkCredentials(values[0],values[1]);
if(user==null) throw new HttpError(401,"Invalid credentials");
String token=tokenBytes(32);
try(Connection c=connection(); PreparedStatement p=c.prepareStatement("""
INSERT INTO devices(user_id,device_id,token_hash,created_at) VALUES(?,?,?,?)
ON CONFLICT(user_id,device_id) DO UPDATE SET token_hash=excluded.token_hash,created_at=excluded.created_at
""")) {
p.setLong(1,user.id());p.setString(2,values[2]);p.setString(3,sha(token));p.setLong(4,System.currentTimeMillis());p.executeUpdate();
}
send(x,200,"text/plain; charset=utf-8",token.getBytes(StandardCharsets.UTF_8));
}
private static void browserLogin(HttpExchange x) throws Exception {
throttle(x);String[] values=credentials(x,false);
User user=checkCredentials(values[0],values[1]);
if(user==null)throw new HttpError(401,"Invalid credentials");
String token=tokenBytes(32);long expiry=System.currentTimeMillis()+SESSION_TTL;
try(Connection c=connection();PreparedStatement p=c.prepareStatement("INSERT INTO sessions(token_hash,user_id,expires_at) VALUES(?,?,?)")){
p.setString(1,sha(token));p.setLong(2,user.id());p.setLong(3,expiry);p.executeUpdate();
}
x.getResponseHeaders().add("Set-Cookie","bm_session="+token+"; HttpOnly; Secure; SameSite=Strict; Path=/; Max-Age="+(SESSION_TTL/1000));
json(x,200,"{\"ok\":true}");
}
private static User loggedIn(HttpExchange x) throws Exception {
String cookie=Optional.ofNullable(x.getRequestHeaders().getFirst("Cookie")).orElse("");
String token=null;
for(String piece:cookie.split(";")){
String s=piece.trim();if(s.startsWith("bm_session=")){token=s.substring("bm_session=".length());break;}
}
if(token==null || !token.matches("[0-9a-f]{64}"))throw new HttpError(401,"Please sign in");
try(Connection c=connection(); PreparedStatement p=c.prepareStatement("""
SELECT u.id,u.login,u.published FROM sessions s JOIN users u ON u.id=s.user_id
WHERE s.token_hash=? AND s.expires_at>?
""")){
p.setString(1,sha(token));p.setLong(2,System.currentTimeMillis());
try(ResultSet rs=p.executeQuery()){
if(!rs.next())throw new HttpError(401,"Session expired");
return new User(rs.getLong(1),rs.getString(2),rs.getInt(3)!=0);
}
}
}
private static void browserLogout(HttpExchange x) throws Exception {
try { loggedIn(x); } catch(HttpError e) { /* Expired sessions still get cookie cleared. */ }
String cookie=Optional.ofNullable(x.getRequestHeaders().getFirst("Cookie")).orElse("");
for(String p:cookie.split(";")) {
String v=p.trim(); if(v.startsWith("bm_session=")){
try(Connection c=connection();PreparedStatement s=c.prepareStatement("DELETE FROM sessions WHERE token_hash=?")){
s.setString(1,sha(v.substring("bm_session=".length())));s.executeUpdate();
}
}
}
x.getResponseHeaders().add("Set-Cookie","bm_session=; HttpOnly; Secure; SameSite=Strict; Path=/; Max-Age=0");
json(x,200,"{\"ok\":true}");
}
private static void me(HttpExchange x) throws Exception {
User u=loggedIn(x);
json(x,200,"{\"login\":"+quoted(u.login())+",\"published\":"+u.published()+"}");
}
private static void privacy(HttpExchange x) throws Exception {
User u=loggedIn(x);String body=new String(readLimited(x,16),StandardCharsets.US_ASCII).trim();
if (!body.equals("true")&&!body.equals("false"))throw new HttpError(400,"Expected true or false");
try(Connection c=connection();PreparedStatement p=c.prepareStatement("UPDATE users SET published=? WHERE id=?")){
p.setInt(1,body.equals("true")?1:0);p.setLong(2,u.id());p.executeUpdate();
}
json(x,200,"{\"ok\":true}");
}
private static String param(HttpExchange x,String name) {
String q=x.getRequestURI().getRawQuery();if(q==null)return null;
for(String pair:q.split("&")) {
String[] kv=pair.split("=",2);if(kv[0].equals(name))return kv.length==2?URLDecoder.decode(kv[1],StandardCharsets.UTF_8):"";
}
return null;
}
private static User authorizeDevice(HttpExchange x,String device) throws Exception {
String auth=x.getRequestHeaders().getFirst("Authorization");
if(auth==null||!auth.matches("Bearer [0-9a-f]{64}"))throw new HttpError(401,"Invalid bearer token");
try(Connection c=connection();PreparedStatement p=c.prepareStatement("""
SELECT u.id,u.login,u.published FROM devices d JOIN users u ON u.id=d.user_id
WHERE d.token_hash=? AND d.device_id=?
""")){
p.setString(1,sha(auth.substring(7)));p.setString(2,device);
try(ResultSet rs=p.executeQuery()){
if(!rs.next())throw new HttpError(401,"Unknown device or revoked token");
return new User(rs.getLong(1),rs.getString(2),rs.getInt(3)!=0);
}
}
}
private static FileSummary verifyAndSummarize(byte[] body) throws HttpError {
if(body.length==0||body.length%RECORD!=0)throw new HttpError(400,"File must contain complete 32-byte records");
long cycles=0,total=0,inhale=0,exhale=0,max=0;
CRC32 crc=new CRC32();
for(int pos=0;pos<body.length;pos+=RECORD){
int version=body[pos]&255, type=body[pos+1]&255;
if(version!=1||type<1||type>10)throw new HttpError(400,"Invalid record type/version at offset "+pos);
crc.reset();crc.update(body,pos,28);
long got=ByteBuffer.wrap(body,pos+28,4).order(ByteOrder.LITTLE_ENDIAN).getInt()&0xffffffffL;
if(crc.getValue()!=got)throw new HttpError(400,"CRC32 mismatch at offset "+pos);
if(type==1){
long i=((body[pos+16]&255)|((body[pos+17]&255)<<8))*100L;
long e=((body[pos+18]&255)|((body[pos+19]&255)<<8))*100L;
cycles++; inhale+=i;exhale+=e;total+=i+e;max=Math.max(max,i+e);
}
}
return new FileSummary(cycles,total,inhale,exhale,max);
}
private static void deviceUpload(HttpExchange x) throws Exception {
String day=param(x,"date");if(day==null)throw new HttpError(400,"Missing date");validDay(day);
String device=x.getRequestHeaders().getFirst("X-Device-ID");if(device==null)throw new HttpError(400,"Missing X-Device-ID");validDevice(device);
User user=authorizeDevice(x,device);
byte[] body=readLimited(x,MAX_UPLOAD);
FileSummary summary=verifyAndSummarize(body);
String hash=sha(body);
Path dest=DATA.resolve("logs").resolve(user.login()).resolve(device).resolve(user.login()+"_"+day+".bin");
synchronized(UPLOAD_LOCK){
Files.createDirectories(dest.getParent());
if(Files.exists(dest)){
byte[] prior=Files.readAllBytes(dest);
// Device journals are append-only: old bytes may never be replaced or truncated.
if(body.length<prior.length || !MessageDigest.isEqual(Arrays.copyOf(body,prior.length),prior))
throw new HttpError(409,"Upload does not extend stored journal; reconcile manually");
}
Path tmp=Files.createTempFile(dest.getParent(),"upload-",".part");
try {
Files.write(tmp,body,StandardOpenOption.WRITE,StandardOpenOption.TRUNCATE_EXISTING);
try{Files.move(tmp,dest,StandardCopyOption.ATOMIC_MOVE,StandardCopyOption.REPLACE_EXISTING);}
catch(AtomicMoveNotSupportedException err){Files.move(tmp,dest,StandardCopyOption.REPLACE_EXISTING);}
}finally{Files.deleteIfExists(tmp);}
// Repeated identical uploads are idempotent thanks to the per-device/date PRIMARY KEY.
try(Connection c=connection();PreparedStatement p=c.prepareStatement("""
INSERT INTO uploads(user_id,device_id,day,bytes,sha256,cycles,duration_ms,inhale_ms,exhale_ms,max_cycle_ms,updated_at)
VALUES(?,?,?,?,?,?,?,?,?,?,?)
ON CONFLICT(user_id,device_id,day) DO UPDATE SET
bytes=excluded.bytes, sha256=excluded.sha256,cycles=excluded.cycles,
duration_ms=excluded.duration_ms,inhale_ms=excluded.inhale_ms,
exhale_ms=excluded.exhale_ms,max_cycle_ms=excluded.max_cycle_ms,updated_at=excluded.updated_at
""")){
p.setLong(1,user.id());p.setString(2,device);p.setString(3,day);p.setInt(4,body.length);
p.setString(5,hash);p.setLong(6,summary.cycles());p.setLong(7,summary.durationMs());
p.setLong(8,summary.inhaleMs());p.setLong(9,summary.exhaleMs());
p.setLong(10,summary.maxCycleMs());p.setLong(11,System.currentTimeMillis());p.executeUpdate();
}
}
json(x,200,"{\"ok\":true,\"bytes\":"+body.length+",\"cycles\":"+summary.cycles()+"}");
}
private static void stats(HttpExchange x) throws Exception {
User user=loggedIn(x);
StringBuilder daily=new StringBuilder("[");
String sql="""
SELECT day,SUM(cycles),SUM(duration_ms),SUM(inhale_ms),SUM(exhale_ms),MAX(max_cycle_ms)
FROM uploads WHERE user_id=? AND day <> 'undated' GROUP BY day ORDER BY day DESC LIMIT 400
""";
long totalCycles=0,totalDuration=0,totalDays=0,lastSync=0,undated=0;
try(Connection c=connection()){
try(PreparedStatement p=c.prepareStatement(sql)){
p.setLong(1,user.id());try(ResultSet rs=p.executeQuery()){
while(rs.next()){
long cycles=rs.getLong(2),duration=rs.getLong(3);
if(daily.length()>1)daily.append(',');
daily.append("{\"day\":").append(quoted(rs.getString(1)))
.append(",\"cycles\":").append(cycles)
.append(",\"durationMs\":").append(duration)
.append(",\"inhaleMs\":").append(rs.getLong(4))
.append(",\"exhaleMs\":").append(rs.getLong(5))
.append(",\"maxCycleMs\":").append(rs.getLong(6)).append('}');
}
}
}
try(PreparedStatement p=c.prepareStatement("SELECT COALESCE(SUM(cycles),0),COALESCE(SUM(duration_ms),0),COUNT(DISTINCT CASE WHEN day<>'undated' THEN day END),COALESCE(MAX(updated_at),0) FROM uploads WHERE user_id=?")){
p.setLong(1,user.id());try(ResultSet rs=p.executeQuery()){rs.next();totalCycles=rs.getLong(1);totalDuration=rs.getLong(2);totalDays=rs.getLong(3);lastSync=rs.getLong(4);}
}
try(PreparedStatement p=c.prepareStatement("SELECT COALESCE(SUM(cycles),0) FROM uploads WHERE user_id=? AND day='undated'")){
p.setLong(1,user.id());try(ResultSet rs=p.executeQuery()){rs.next();undated=rs.getLong(1);}
}
}
daily.append(']');
json(x,200,"{\"login\":"+quoted(user.login())+",\"totalCycles\":"+totalCycles+
",\"totalDurationMs\":"+totalDuration+",\"activeDays\":"+totalDays+
",\"lastSyncMs\":"+lastSync+",\"undatedCycles\":"+undated+",\"daily\":"+daily+"}");
}
private static void leaderboard(HttpExchange x) throws Exception {
StringBuilder b=new StringBuilder("[ ");
try(Connection c=connection();PreparedStatement p=c.prepareStatement("""
SELECT u.login,COALESCE(SUM(f.cycles),0),COALESCE(SUM(f.duration_ms),0),
COUNT(DISTINCT CASE WHEN f.day<>'undated' THEN f.day END)
FROM users u LEFT JOIN uploads f ON f.user_id=u.id
WHERE u.published=1 GROUP BY u.id ORDER BY SUM(f.duration_ms) DESC LIMIT 100
""");ResultSet rs=p.executeQuery()){
boolean first=true;
while(rs.next()){
if(!first)b.append(',');first=false;
b.append("{\"login\":").append(quoted(rs.getString(1)))
.append(",\"cycles\":").append(rs.getLong(2))
.append(",\"durationMs\":").append(rs.getLong(3))
.append(",\"activeDays\":").append(rs.getLong(4)).append('}');
}
}
b.append(']');json(x,200,b.toString());
}
private static String quoted(String s){return "\""+s.replace("\\","\\\\").replace("\"","\\\"")+"\"";}
private static void serveWeb(HttpExchange x,String path,String method) throws Exception {
String name = switch(path){case "/","/index.html" -> "index.html";
case "/app.js" -> "app.js";case "/style.css" -> "style.css";
default -> null;};
if(name==null)throw new HttpError(404,"Not found");
Path target=WEB.resolve(name);if(!Files.isRegularFile(target))throw new HttpError(404,"Frontend files not installed");
String ct=name.endsWith(".js")?"application/javascript; charset=utf-8":name.endsWith(".css")?"text/css; charset=utf-8":"text/html; charset=utf-8";
byte[] bytes=Files.readAllBytes(target);
if(method.equals("HEAD")){x.getResponseHeaders().set("Content-Type",ct);x.sendResponseHeaders(200,-1);return;}
send(x,200,ct,bytes);
}
private static void sendError(HttpExchange x,int status,String message) {
try {json(x,status,"{\"error\":"+quoted(message)+"}");}catch(IOException ignored){}
}
private static void json(HttpExchange x,int status,String json) throws IOException {
send(x,status,"application/json; charset=utf-8",json.getBytes(StandardCharsets.UTF_8));
}
private static void send(HttpExchange x,int status,String type,byte[] bytes) throws IOException {
x.getResponseHeaders().set("Content-Type",type);x.sendResponseHeaders(status,bytes.length);
try(OutputStream o=x.getResponseBody()){o.write(bytes);}
}
}
@@ -0,0 +1,25 @@
import java.lang.reflect.*;
import java.nio.*;
import java.util.zip.CRC32;
// Requires only JDK 21, not the SQLite JDBC jar; verifies compatibility with ESP32 binary layout.
final class RecordFixtureTest {
public static void main(String[] args) throws Exception {
byte[] r=new byte[32];r[0]=1;r[1]=1;r[2]=1;
ByteBuffer b=ByteBuffer.wrap(r).order(ByteOrder.LITTLE_ENDIAN);
b.putInt(4,100);b.putLong(8,1792828800000L);
b.putShort(16,(short)41);b.putShort(18,(short)55);
CRC32 crc=new CRC32();crc.update(r,0,28);b.putInt(28,(int)crc.getValue());
Method m=BreathServer.class.getDeclaredMethod("verifyAndSummarize",byte[].class);
m.setAccessible(true);
Object summary=m.invoke(null,(Object)r);
Method cycles=summary.getClass().getDeclaredMethod("cycles");cycles.setAccessible(true);
Method duration=summary.getClass().getDeclaredMethod("durationMs");duration.setAccessible(true);
if((Long)cycles.invoke(summary)!=1||(Long)duration.invoke(summary)!=9600L)
throw new AssertionError("Cycle values not decoded correctly");
r[16]^=1;
try {m.invoke(null,(Object)r);throw new AssertionError("Corrupted CRC accepted");}
catch(InvocationTargetException ex){if(!ex.getCause().getMessage().contains("CRC32"))throw ex;}
System.out.println("PASS: 32-byte little-endian event, duration and CRC32 validation");
}
}
@@ -0,0 +1,39 @@
plugins {
id 'java'
id 'application'
id 'com.github.johnrengelman.shadow' version '8.1.1'
}
group = 'me.shineup'
version = '1.0.0'
repositories { mavenCentral() }
java {
toolchain { languageVersion = JavaLanguageVersion.of(17) }
}
dependencies {
implementation 'org.xerial:sqlite-jdbc:3.50.3.0'
implementation 'org.slf4j:slf4j-nop:2.0.16'
}
sourceSets {
main {
java.srcDirs = ['.']
java.includes = ['BreathServer.java']
}
}
application { mainClass = 'BreathServer' }
tasks.jar { enabled = false }
shadowJar {
archiveBaseName = 'breathmonitor'
archiveVersion = '1.0.0'
archiveClassifier = ''
mergeServiceFiles()
manifest { attributes 'Main-Class': 'BreathServer' }
}
tasks.build { dependsOn tasks.shadowJar }
@@ -0,0 +1,12 @@
#!/usr/bin/env bash
set -euo pipefail
cd "$(dirname "$0")"
if [[ -x ./gradlew ]]; then
./gradlew --no-daemon shadowJar
elif command -v gradle >/dev/null 2>&1; then
gradle --no-daemon shadowJar
else
echo 'Gradle is required (install Gradle or provide ./gradlew).' >&2
exit 1
fi
printf 'Built %s\n' "$(pwd)/build/libs/breathmonitor-1.0.0.jar"
@@ -0,0 +1,6 @@
#Mon Oct 20 16:15:09 MSK 2025
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.14-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
+234
View File
@@ -0,0 +1,234 @@
#!/bin/sh
#
# Copyright © 2015-2021 the original authors.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
##############################################################################
#
# Gradle start up script for POSIX generated by Gradle.
#
# Important for running:
#
# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
# noncompliant, but you have some other compliant shell such as ksh or
# bash, then to run this script, type that shell name before the whole
# command line, like:
#
# ksh Gradle
#
# Busybox and similar reduced shells will NOT work, because this script
# requires all of these POSIX shell features:
# * functions;
# * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
# «${var#prefix}», «${var%suffix}», and «$( cmd )»;
# * compound commands having a testable exit status, especially «case»;
# * various built-in commands including «command», «set», and «ulimit».
#
# Important for patching:
#
# (2) This script targets any POSIX shell, so it avoids extensions provided
# by Bash, Ksh, etc; in particular arrays are avoided.
#
# The "traditional" practice of packing multiple parameters into a
# space-separated string is a well documented source of bugs and security
# problems, so this is (mostly) avoided, by progressively accumulating
# options in "$@", and eventually passing that to Java.
#
# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
# see the in-line comments for details.
#
# There are tweaks for specific operating systems such as AIX, CygWin,
# Darwin, MinGW, and NonStop.
#
# (3) This script is generated from the Groovy template
# https://github.com/gradle/gradle/blob/master/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
# within the Gradle project.
#
# You can find Gradle at https://github.com/gradle/gradle/.
#
##############################################################################
# Attempt to set APP_HOME
# Resolve links: $0 may be a link
app_path=$0
# Need this for daisy-chained symlinks.
while
APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path
[ -h "$app_path" ]
do
ls=$( ls -ld "$app_path" )
link=${ls#*' -> '}
case $link in #(
/*) app_path=$link ;; #(
*) app_path=$APP_HOME$link ;;
esac
done
APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit
APP_NAME="Gradle"
APP_BASE_NAME=${0##*/}
# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
# Use the maximum available, or set MAX_FD != -1 to use that value.
MAX_FD=maximum
warn () {
echo "$*"
} >&2
die () {
echo
echo "$*"
echo
exit 1
} >&2
# OS specific support (must be 'true' or 'false').
cygwin=false
msys=false
darwin=false
nonstop=false
case "$( uname )" in #(
CYGWIN* ) cygwin=true ;; #(
Darwin* ) darwin=true ;; #(
MSYS* | MINGW* ) msys=true ;; #(
NONSTOP* ) nonstop=true ;;
esac
CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
# Determine the Java command to use to start the JVM.
if [ -n "$JAVA_HOME" ] ; then
if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
# IBM's JDK on AIX uses strange locations for the executables
JAVACMD=$JAVA_HOME/jre/sh/java
else
JAVACMD=$JAVA_HOME/bin/java
fi
if [ ! -x "$JAVACMD" ] ; then
die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
Please set the JAVA_HOME variable in your environment to match the
location of your Java installation."
fi
else
JAVACMD=java
which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
Please set the JAVA_HOME variable in your environment to match the
location of your Java installation."
fi
# Increase the maximum file descriptors if we can.
if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
case $MAX_FD in #(
max*)
MAX_FD=$( ulimit -H -n ) ||
warn "Could not query maximum file descriptor limit"
esac
case $MAX_FD in #(
'' | soft) :;; #(
*)
ulimit -n "$MAX_FD" ||
warn "Could not set maximum file descriptor limit to $MAX_FD"
esac
fi
# Collect all arguments for the java command, stacking in reverse order:
# * args from the command line
# * the main class name
# * -classpath
# * -D...appname settings
# * --module-path (only if needed)
# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
# For Cygwin or MSYS, switch paths to Windows format before running java
if "$cygwin" || "$msys" ; then
APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
JAVACMD=$( cygpath --unix "$JAVACMD" )
# Now convert the arguments - kludge to limit ourselves to /bin/sh
for arg do
if
case $arg in #(
-*) false ;; # don't mess with options #(
/?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath
[ -e "$t" ] ;; #(
*) false ;;
esac
then
arg=$( cygpath --path --ignore --mixed "$arg" )
fi
# Roll the args list around exactly as many times as the number of
# args, so each arg winds up back in the position where it started, but
# possibly modified.
#
# NB: a `for` loop captures its iteration list before it begins, so
# changing the positional parameters here affects neither the number of
# iterations, nor the values presented in `arg`.
shift # remove old arg
set -- "$@" "$arg" # push replacement arg
done
fi
# Collect all arguments for the java command;
# * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of
# shell script including quotes and variable substitutions, so put them in
# double quotes to make sure that they get re-expanded; and
# * put everything else in single quotes, so that it's not re-expanded.
set -- \
"-Dorg.gradle.appname=$APP_BASE_NAME" \
-classpath "$CLASSPATH" \
org.gradle.wrapper.GradleWrapperMain \
"$@"
# Use "xargs" to parse quoted args.
#
# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
#
# In Bash we could simply go:
#
# readarray ARGS < <( xargs -n1 <<<"$var" ) &&
# set -- "${ARGS[@]}" "$@"
#
# but POSIX shell has neither arrays nor command substitution, so instead we
# post-process each arg (as a line of input to sed) to backslash-escape any
# character that might be a shell metacharacter, then use eval to reverse
# that process (while maintaining the separation between arguments), and wrap
# the whole thing up as a single "set" statement.
#
# This will of course break if any of these variables contains a newline or
# an unmatched quote.
#
eval "set -- $(
printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
xargs -n1 |
sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
tr '\n' ' '
)" '"$@"'
exec "$JAVACMD" "$@"
@@ -0,0 +1,12 @@
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion><groupId>me.shineup</groupId><artifactId>breathmonitor</artifactId><version>1.0.0</version><packaging>jar</packaging>
<properties><maven.compiler.release>21</maven.compiler.release><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding></properties>
<dependencies>
<dependency><groupId>org.xerial</groupId><artifactId>sqlite-jdbc</artifactId><version>3.50.3.0</version></dependency>
<dependency><groupId>org.slf4j</groupId><artifactId>slf4j-nop</artifactId><version>2.0.16</version></dependency>
</dependencies>
<build><sourceDirectory>${project.basedir}</sourceDirectory><plugins>
<plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.13.0</version><configuration><includes><include>BreathServer.java</include></includes></configuration></plugin>
<plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-shade-plugin</artifactId><version>3.6.0</version><executions><execution><phase>package</phase><goals><goal>shade</goal></goals><configuration><createDependencyReducedPom>false</createDependencyReducedPom><transformers><transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"><mainClass>BreathServer</mainClass></transformer></transformers></configuration></execution></executions></plugin>
</plugins></build>
</project>
@@ -0,0 +1,8 @@
pluginManagement {
repositories {
gradlePluginPortal()
mavenCentral()
}
}
rootProject.name = 'breathmonitor'
@@ -0,0 +1,7 @@
#!/usr/bin/env bash
set -euo pipefail
cd "$(dirname "$0")"
export BREATH_BIND="${BREATH_BIND:-127.0.0.1}"
export BREATH_PORT="${BREATH_PORT:-8090}"
export PUBLIC_ORIGIN="${PUBLIC_ORIGIN:-https://breathmonitor.shineup.me}"
exec java -jar build/libs/breathmonitor-1.0.0.jar "$@"
@@ -0,0 +1,80 @@
'use strict';
const $ = (id) => document.getElementById(id);
const number = (value) => new Intl.NumberFormat('ru-RU').format(value || 0);
const duration = (ms) => { const min=Math.round(ms/60000); return min >= 60 ? `${Math.floor(min/60)} ч ${min%60} мин` : `${min} мин`; };
const readableDay = (day) => `${day.slice(6,8)}.${day.slice(4,6)}.${day.slice(0,4)}`;
async function request(path, options) {
const result=await fetch(path,{credentials:'same-origin', ...options});
let data;
try { data=await result.json(); } catch {throw new Error(`HTTP ${result.status}`);}
if(!result.ok)throw new Error(data.error||`HTTP ${result.status}`);
return data;
}
function showLoggedIn(yes){$('loginPanel').classList.toggle('hidden',yes);$('dashboard').classList.toggle('hidden',!yes);$('logout').classList.toggle('hidden',!yes);}
async function loadMe(){
try { const me=await request('/api/me');showLoggedIn(true);$('userName').textContent=me.login;
$('published').checked=!!me.published;await loadStats(); }
catch { showLoggedIn(false);$('userName').textContent=''; }
}
async function loadStats(){
const data=await request('/api/stats');
$('totalCycles').textContent=number(data.totalCycles);
$('totalHours').textContent=duration(data.totalDurationMs);
$('activeDays').textContent=number(data.activeDays);
$('avgCycle').textContent=data.totalCycles?`${(data.totalDurationMs/data.totalCycles/1000).toFixed(1)} с`:'—';
$('syncedAt').textContent=data.lastSyncMs?`Обновлено: ${new Date(data.lastSyncMs).toLocaleString('ru-RU')}`:'Пока нет загрузок';
const days=[...data.daily].slice(0,12);
$('dailyList').replaceChildren();
for(const d of days){const row=document.createElement('div');row.className='day';
const label=document.createElement('div');label.textContent=readableDay(d.day);
const small=document.createElement('small');small.textContent=`${number(d.cycles)} циклов · ср. ${d.cycles?(d.durationMs/d.cycles/1000).toFixed(1):'—'} с`;
label.append(small);const value=document.createElement('strong');value.textContent=duration(d.durationMs);row.append(label,value);$('dailyList').append(row);}
if(!days.length)$('dailyList').textContent='Пока нет синхронизированных практик.';
$('notice').textContent=data.undatedCycles?`Циклов без достоверной даты: ${number(data.undatedCycles)}. Синхронизируйте часы прибора.`:'';
renderChart(data.daily);
}
function renderChart(days){
const canvas=$('chart'),ctx=canvas.getContext('2d');
const w=canvas.width,h=canvas.height;ctx.clearRect(0,0,w,h);
const indexed=new Map(days.map(d=>[d.day,d.durationMs/60000]));
const today=new Date();const series=[];
for(let n=29;n>=0;n--){const date=new Date(today.getFullYear(),today.getMonth(),today.getDate()-n);
const key=`${date.getFullYear()}${String(date.getMonth()+1).padStart(2,'0')}${String(date.getDate()).padStart(2,'0')}`;
series.push({date,value:indexed.get(key)||0});}
const max=Math.max(20,...series.map(s=>s.value)), top=25,bottom=260,base=bottom-top;
ctx.strokeStyle='#375163';ctx.lineWidth=1;ctx.fillStyle='#9bb0bf';ctx.font='17px system-ui';
for(let i=0;i<=4;i++){const y=bottom-i*base/4;ctx.beginPath();ctx.moveTo(44,y);ctx.lineTo(w-10,y);ctx.stroke();
ctx.fillText(`${Math.round(max*i/4)}м`,0,y+5);}
const span=(w-64)/30;
for(let i=0;i<series.length;i++){
const x=47+i*span,bar=series[i].value/max*base;
ctx.fillStyle=i>=27?'#51d4bb':'#4c87ac';ctx.fillRect(x,bottom-bar,Math.max(5,span-6),bar);
if(i%7===0||i===29){ctx.fillStyle='#9bb0bf';ctx.fillText(String(series[i].date.getDate()),x,bottom+25);}
}
}
async function loadLeaderboard(){
const rows=await request('/api/leaderboard');const board=$('leaderboard');board.replaceChildren();
if(!rows.length){const msg=document.createElement('p');msg.className='empty';msg.textContent='Пока никто не включил участие в рейтинге.';board.append(msg);return;}
rows.forEach((r,i)=>{
const row=document.createElement('div');row.className='leader';
const rank=document.createElement('span');rank.className='rank';rank.textContent=`#${i+1}`;
const login=document.createElement('b');login.textContent=r.login;
const time=document.createElement('span');time.className='value';time.textContent=duration(r.durationMs);
const cycles=document.createElement('span');cycles.className='cycles';cycles.textContent=`${number(r.cycles)} циклов`;
row.append(rank,login,time,cycles);board.append(row);
});
}
$('loginForm').addEventListener('submit',async event=>{
event.preventDefault();$('loginError').textContent='';
const fd=new FormData(event.target);
try {
await request('/api/login',{method:'POST',headers:{'Content-Type':'text/plain; charset=utf-8'},body:`${fd.get('login')}\n${fd.get('password')}`});
event.target.reset();await loadMe();
}catch(e){$('loginError').textContent=e.message;}
});
$('logout').addEventListener('click',async()=>{try{await request('/api/logout',{method:'POST'});}catch{}showLoggedIn(false);$('userName').textContent='';});
$('published').addEventListener('change',async event=>{
try{await request('/api/privacy',{method:'POST',headers:{'Content-Type':'text/plain'},body:String(event.target.checked)});await loadLeaderboard();}
catch(e){event.target.checked=!event.target.checked;$('notice').textContent=`Ошибка изменения видимости: ${e.message}`;}
});
loadMe();loadLeaderboard().catch(()=>{$('leaderboard').textContent='Не удалось загрузить рейтинг.';});
@@ -0,0 +1,29 @@
<!doctype html>
<html lang="ru"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="theme-color" content="#111e2d"><title>BreathMonitor · Статистика дыхания</title>
<link rel="stylesheet" href="/style.css">
</head><body>
<header class="nav"><div class="brand"><span class="logo">◉</span><div>BreathMonitor<small>Дыхательные практики</small></div></div>
<div class="right"><span id="userName"></span><button id="logout" class="subtle hidden">Выход</button></div></header>
<main>
<section class="hero"><div><span class="eyebrow">BREATH DATA · LIVE DASHBOARD</span><h1>Прогресс начинается<br>с каждого вдоха.</h1><p>Автономная запись на устройстве. Синхронизация по запросу. История, которая остаётся с вами.</p></div>
<div class="pulse"><div class="orb"></div><span>INHALE · EXHALE</span></div></section>
<section id="loginPanel" class="panel auth"><div><div class="eyebrow">ЛИЧНЫЙ КАБИНЕТ</div><h2>Войти в статистику</h2><p>Аккаунт создаётся администратором сервера. Логин и пароль используются также для привязки прибора.</p></div>
<form id="loginForm"><label>Логин<input name="login" required minlength="3" maxlength="24" autocomplete="username" placeholder="например, aidar"></label>
<label>Пароль<input name="password" type="password" required autocomplete="current-password" placeholder="••••••••••••"></label>
<button type="submit" class="primary">Войти →</button><p id="loginError" class="error" role="alert"></p></form></section>
<section id="dashboard" class="hidden">
<div class="section-title"><div><span class="eyebrow">МОЯ СТАТИСТИКА</span><h2>Обзор практики</h2></div><span id="syncedAt" class="pill">Не синхронизировано</span></div>
<div class="stat-grid"><div class="stat"><span>Всего циклов</span><strong id="totalCycles">—</strong></div><div class="stat"><span>Всего времени</span><strong id="totalHours">—</strong></div>
<div class="stat"><span>Активных дней</span><strong id="activeDays">—</strong></div><div class="stat"><span>Средний цикл</span><strong id="avgCycle">—</strong></div></div>
<div class="grid"><section class="panel chart"><div class="panel-head"><div><h3>Регулярность</h3><p>Минуты практики за последние 30 дней</p></div></div>
<canvas id="chart" width="900" height="300" aria-label="Время практики по дням"></canvas></section>
<section class="panel"><div class="panel-head"><h3>Последние дни</h3><span>История</span></div><div id="dailyList" class="days"></div></section></div>
<section class="panel privacy"><div><h3>Открытый рейтинг</h3><p>По умолчанию ваши данные скрыты. Вы можете добровольно включить публичный показ общего результата. Детальные графики остаются личными.</p></div><label class="toggle"><input id="published" type="checkbox"><span>Показывать меня в рейтинге</span></label></section>
<p id="notice" class="hint"></p>
</section>
<div class="section-title"><div><span class="eyebrow">СООБЩЕСТВО</span><h2>Рейтинг участников</h2></div><span class="pill">По общему времени практики</span></div>
<section class="panel"><div id="leaderboard" class="leaders"><p class="empty">Загрузка рейтинга…</p></div></section>
<footer>BreathMonitor · Время практики рассчитывается по завершённым зарегистрированным циклам. Данные обновляются после ручной синхронизации прибора.</footer>
</main><script src="/app.js" defer></script></body></html>
File diff suppressed because one or more lines are too long