generated from Grigo/AndroidTemplate
154 lines
6.2 KiB
Markdown
154 lines
6.2 KiB
Markdown
# LoraTester Server
|
||
|
||
Единый HTTP-сервер для телеметрии LoRa, GPS устройств, истории статистики, треков и чата.
|
||
|
||
## Быстрый старт
|
||
|
||
```bash
|
||
cd server
|
||
python -m venv .venv
|
||
.venv\Scripts\activate # Windows
|
||
pip install -r requirements.txt
|
||
python flask_app.py
|
||
```
|
||
|
||
Откройте http://localhost:7634
|
||
|
||
## Переменные окружения
|
||
|
||
| Переменная | По умолчанию |
|
||
|------------|----------------|
|
||
| `LORATESTER_HOST` | `0.0.0.0` |
|
||
| `LORATESTER_PORT` | `7634` |
|
||
| `LORATESTER_DB` | `./loratester.db` |
|
||
| `LORATESTER_TELEMETRY_LIMIT` | `5000` (записей истории на устройство) |
|
||
| `LORATESTER_TRACK_POINTS_LIMIT` | `10000` (точек на один трек) |
|
||
| `LORATESTER_ELEVATION_URL` | `http://192.168.1.109:8085/v1/elevation` |
|
||
| `LORATESTER_ELEVATION_PROBE_TTL` | `60` (сек, кэш проверки доступности) |
|
||
| `LORATESTER_ELEVATION_TIMEOUT` | `8` (сек, таймаут HTTP к сервису высот) |
|
||
|
||
## Docker Compose
|
||
|
||
```bash
|
||
cd server
|
||
docker compose up -d --build
|
||
```
|
||
|
||
Проверка:
|
||
|
||
```bash
|
||
curl http://127.0.0.1:7634/api/health | jq
|
||
```
|
||
|
||
Ожидается `"elevation_ok": true` если локальный Open-Meteo доступен с хоста/контейнера.
|
||
|
||
Переопределить URL высот (`.env` рядом с `docker-compose.yml`):
|
||
|
||
```env
|
||
LORATESTER_ELEVATION_URL=http://192.168.1.109:8085/v1/elevation
|
||
```
|
||
|
||
БД хранится в volume `loratester-data` (`/data/loratester.db` внутри контейнера).
|
||
|
||
## Деплой (lora.grigowashere.ru)
|
||
|
||
```bash
|
||
cd /srv/storage/disk2/services/LoraTester/server
|
||
docker compose up -d --build
|
||
```
|
||
|
||
Или без Docker:
|
||
|
||
```bash
|
||
cd /srv/storage/disk2/services/LoraTester/server
|
||
pip install -r requirements.txt
|
||
export LORATESTER_DB=/srv/storage/disk2/services/LoraTester/loratester.db
|
||
export LORATESTER_ELEVATION_URL=http://192.168.1.109:8085/v1/elevation
|
||
uvicorn fastapi_app:app --host 0.0.0.0 --port 7634
|
||
```
|
||
|
||
После обновления кода **обязательно перезапустите** сервис. При старте выполняются миграции SQLite (`devices`, `telemetry.meta`, таблицы `tracks`).
|
||
|
||
Проверка:
|
||
|
||
```bash
|
||
curl http://127.0.0.1:7634/api/health
|
||
```
|
||
|
||
Ожидается `"db_ok": true`, `"schema_version": 4`, `"elevation_ok": true`.
|
||
|
||
Если БД создана вручную и схема битая (`no such table: devices` / `no such column: t.meta`):
|
||
|
||
1. Остановить сервис
|
||
2. `cp loratester.db loratester.db.bak`
|
||
3. Удалить `loratester.db` (или оставить бэкап и дать миграциям дописать колонки после рестарта с новым кодом)
|
||
4. Запустить снова — `init_db()` создаст полную схему
|
||
|
||
## API
|
||
|
||
### Телеметрия (только Android, заголовок `X-Lora-Client: android`)
|
||
|
||
- `POST /api/telemetry` — `{device_id, lat?, lon?, rssi?, meta?, fields?, role?, ts?}`
|
||
- `GET /api/devices` — последнее состояние устройств
|
||
- `GET /api/telemetry?device_id=&limit=&since=&until=&role=` — история (без `raw_frame`)
|
||
- `GET /api/stats/history?device_id=` — то же, alias
|
||
|
||
### Треки (запись с Android)
|
||
|
||
- `POST /api/tracks/start` — `{device_id}` → `{track_id}`
|
||
- `POST /api/tracks/{id}/points` — `{points: [{ts, lat, lon, altitude_gps?, rssi?, role?, meta?}]}`
|
||
- `POST /api/tracks/{id}/finish`
|
||
- `GET /api/tracks?device_id=`
|
||
- `GET /api/tracks/{id}` — метаданные + точки (высота terrain через локальный Open-Meteo)
|
||
|
||
### Команды (очередь на устройство)
|
||
|
||
- `POST /api/commands` — `{from_device_id, to_device_id, kind, payload?}`
|
||
`kind`: `at` (`payload.line` — одна строка, или `payload.lines` — массив макроса), `mode` (`payload.role`: TX/RX), `stats_push` (снимок meta/rssi/role/sf/bw)
|
||
`from_device_id`: `web` или `android-xxxxxxxx`
|
||
Макрос обычно: `S` (стоп TX/RX), затем `AT+FQ=`, `AT+PW=`, `AT+SF=`, `AT+BW=`, `AT+CR=`, `AT+PL=`, `AT+TM=`, при необходимости `AT+TX` / `AT+RX`.
|
||
|
||
### Профиль высот (веб, треки)
|
||
|
||
- `POST /api/elevation/profile` — `{points: [{lat, lon}], step_m?: 10}` → срез рельефа (локальный Open-Meteo)
|
||
- `GET /api/tracks/{id}/elevation-profile?step_m=10` — то же по сохранённому треку
|
||
- `GET /api/elevation/nearest-hill?lat=&lon=&radius_m=5000` — ближайшая возвышенность (прокси Open-Meteo)
|
||
- `GET /api/elevation/grid?lat=&lon=&radius_m=200&step_m=0` — сетка высот для хитмапы (100–500 m, step_m=0 авто)
|
||
- `GET /api/commands/pending?device_id=` — Android, доставка + `delivered_at`
|
||
- `GET /api/commands?to_device_id=&limit=` — история (веб)
|
||
|
||
### Синхронный трек (два устройства)
|
||
|
||
- `POST /api/paired-tracks/start` — `{device_ids?: [a,b], initiator?, device_id?}` → сессия `armed`, `start_at = now+3s`
|
||
- `GET /api/paired-tracks/active` — `{active, session?}`
|
||
- `POST /api/paired-tracks/ack` — Android: `{session_id, device_id, track_id}`
|
||
- `POST /api/paired-tracks/cancel` — `{session_id?}`
|
||
|
||
### Прочее
|
||
|
||
- `POST /api/chat` — `{device_id, text}`
|
||
- `GET /api/chat?since=0`
|
||
- `GET /api/health` — `{ok, db_ok, schema_version, database_path, elevation_ok, elevation_url, elevation_error}`
|
||
|
||
## FastAPI (прод)
|
||
|
||
```bash
|
||
uvicorn fastapi_app:app --host 0.0.0.0 --port 7634
|
||
```
|
||
|
||
Flask (`flask_app.py`) — тот же API для локальной разработки.
|
||
|
||
## Тесты
|
||
|
||
```bash
|
||
cd server
|
||
pip install httpx pytest
|
||
python -m pytest tests/ -v
|
||
```
|
||
|
||
## Android
|
||
|
||
URL: `https://lora.grigowashere.ru`. На карте: **Начать/Остановить трекинг пути** — точки с GPS, статистикой приёма и высотой (локальный Open-Meteo на сервере). Вкладка **Статистика** — история с сервера.
|
||
|
||
Telnet: `127.0.0.1:2727` — мост COM→telnet на устройстве.
|