docs: сессия 2026-06-06 + резюме проекта для нового чата
This commit is contained in:
+42
-58
@@ -1,69 +1,53 @@
|
||||
# 2026-06-06 — Полевой тест и финальная проверка ELM
|
||||
# 2026-06-06 — Полная сессия (полевой тест + 9 багов + фиксы)
|
||||
|
||||
## Контекст
|
||||
Выезд к машине. Приложение показывает "No ELM", хотя сторонние приложения (Torque, Car Scanner) подключаются нормально.
|
||||
## Текущий статус
|
||||
- **Версия:** v0.47.0-dev
|
||||
- **APK:** https://obdai.ru/elmer.apk
|
||||
- **Сервер:** https://obdai.ru (5.172.178.213, nginx+gunicorn)
|
||||
- **Android repo:** github.com/Repinoid/elmer-android
|
||||
- **Server repo:** gitea.services.ngcloud.ru/Nail/elmer
|
||||
|
||||
## Найденные баги (и их исправления)
|
||||
## Хронология коммитов (Android)
|
||||
|
||||
### 1. 🔴 КРИТИЧЕСКИЙ: `checkDevice()` не вызывал `connectAndInit()`
|
||||
**Файл:** `ElmChecker.kt:69`
|
||||
**Симптом:** Кнопка "🔌 ELM" показывала ❌ ELM не отвечает
|
||||
**Причина:** В ходе рефакторинга `checkDevice()` был вынесен как отдельный метод, но вызов `connectAndInit()` был убран. AT-команды слались в никуда — BT-сокет не открывался.
|
||||
**Исправление:** Вернул `if (!connectAndInit()) return null` в начало `checkDevice()`.
|
||||
**Коммит:** `6a33048`
|
||||
| Коммит | Описание |
|
||||
|--------|----------|
|
||||
| `6a33048` | fix: checkDevice() забыл connectAndInit() |
|
||||
| `739afa9` | fix: connect() идемпотентный + run() без двойного connect |
|
||||
| `94b890f` | bump v0.43.0-dev |
|
||||
| `71618c6` | fix: статус-строка — append вместо overwrite |
|
||||
| `d49f6d6` | fix: все appendStatus с \n, таймер на своей строке |
|
||||
| `3ef3532` | fix: scriptRegistered сброс в onDestroy |
|
||||
| `dead66c` | fix: init без ретраев, v1.5-совместимость |
|
||||
|
||||
### 2. 🟡 `connect()` не идемпотентный
|
||||
**Файл:** `ElmChecker.kt:189`
|
||||
**Проблема:** Повторный вызов `connect()` пытался открыть новый сокет поверх уже открытого → IOException.
|
||||
**Исправление:** Добавлена проверка `if (socket?.isConnected == true) return` в начале `connect()`.
|
||||
**Коммит:** `739afa9`
|
||||
## Все 9 багов
|
||||
|
||||
### 3. 🟡 `run()` — двойной connect
|
||||
**Файл:** `ElmChecker.kt:133`
|
||||
**Проблема:** `run()` вызывал `connectAndInit()`, затем `checkDevice()` тоже вызывал `connectAndInit()` → двойное подключение.
|
||||
**Исправление:** Убрал `connectAndInit()` из `run()`, так как `checkDevice()` сам подключается.
|
||||
**Статус:** `run()` сейчас не используется в продакшене (UI вызывает методы по отдельности), но исправлен на будущее.
|
||||
**Коммит:** `739afa9`
|
||||
1. checkDevice без connectAndInit — AT-команды без BT-сокета
|
||||
2. connect не идемпотентный — guard socket.isConnected
|
||||
3. run двойной connect
|
||||
4. Статус-строка overwrite — всё на appendStatus(\n...)
|
||||
5. Таймер съедал заголовок — \n вместо пробела
|
||||
6. scriptRegistered не сбрасывался после поворота
|
||||
7. init() 70 секунд на ATAT1 — write+tryRead(2s) вместо exec
|
||||
8. checkDevice слал v2-команды на v1.5 — проверка isV2
|
||||
9. recover/updateAtst/handle длинные таймауты — 2000-3000мс
|
||||
|
||||
## Архитектура вызовов (финальная)
|
||||
## ELM327: версии и команды (Wikipedia)
|
||||
|
||||
Три пути в UI:
|
||||
- **v1.5 НЕ СУЩЕСТВУЕТ** — клон v1.0/v1.4 с фейковой версией
|
||||
- ATAT1 (adaptive timing): с v1.2
|
||||
- AT@1/AT@2 (device ID): с v1.3
|
||||
- ATST (set timeout): с v1.2
|
||||
- Базовые (ATI, ATDP, ATRV, ATSP, ATE0, ATL0, ATS0, ATWS): с v1.0
|
||||
|
||||
### Путь 1: 🔌 ELM → 🚗 ЭБУ
|
||||
```
|
||||
checkElm() → findElmDevice() → ElmChecker(dev, bt).checkDevice()
|
||||
→ connectAndInit() → connect() → elm.init()
|
||||
→ ATI, AT@1, AT@2, ATDP, ATRV, ATAT1
|
||||
→ возвращает DeviceInfo
|
||||
→ checker сохранён в elmChecker (сокет НЕ закрыт)
|
||||
## Правила для Copilot
|
||||
|
||||
checkEcu() → elmChecker.checkEcu()
|
||||
→ send("0100"), send("0902")
|
||||
→ возвращает EcuData
|
||||
→ сокет остаётся открытым (GC закроет)
|
||||
```
|
||||
1. Коммит после каждой правки: git add -A && git commit -m "..." && git push
|
||||
2. При деплое bump версии в android/app/build.gradle.kts
|
||||
3. Формат: fix:/feat:/refactor:/bump:/docs:
|
||||
|
||||
### Путь 2: ⚠️ DTC
|
||||
```
|
||||
scanDtc() → findElmDevice() → NEW ElmChecker(dev, bt).scanDtc()
|
||||
→ connectAndInit() → connect() → elm.init()
|
||||
→ send("03"), send("07") → parseDtcCodes()
|
||||
→ disconnect() ← сокет ЗАКРЫВАЕТСЯ
|
||||
→ возвращает List<String>
|
||||
```
|
||||
## TODO
|
||||
|
||||
### Путь 3: run() (не используется)
|
||||
```
|
||||
run() → checkDevice() → connectAndInit() → ... → checkEcu() → disconnect()
|
||||
```
|
||||
|
||||
## Текущее состояние
|
||||
- Версия: **v0.42.0-dev**
|
||||
- APK: https://obdai.ru/elmer.apk
|
||||
- BT permissions: Android 12+ запрашиваются в onCreate()
|
||||
- Сервер: работает, ping ОК
|
||||
- Тесты: 133 шт (118 pass, 1 expected fail SQLite)
|
||||
|
||||
## Не исправлено (потенциальные проблемы)
|
||||
- После 🔌ELM → 🚗ЭБУ сокет не закрывается. Если потом нажать ⚠️DTC, создаётся второй сокет к тому же устройству. Некоторые ELM-клоны не держат два соединения.
|
||||
- Нет таймаута на `checkElm()` — если ELM завис, поток висит бесконечно.
|
||||
- [ ] Разбить MainActivity.kt (~470 -> <=200 строк)
|
||||
- [ ] Разбить ElmChecker.kt (~270 -> <=200 строк)
|
||||
- [ ] Подробные комментарии перед каждой функцией
|
||||
- [ ] Полевой тест v0.47.0-dev на машине
|
||||
|
||||
Reference in New Issue
Block a user