From 47b793816c542a82582a9d9af363e32dd76ddba8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E2=80=9CNaeel=E2=80=9D?= <tazet@narod.ru>
Date: Mon, 25 May 2026 19:45:02 +0400
Subject: [PATCH] quickstart guide for first ELM test

---
 QUICKSTART.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 QUICKSTART.md

diff --git a/QUICKSTART.md b/QUICKSTART.md
new file mode 100644
index 0000000..0ce51e0
--- /dev/null
+++ b/QUICKSTART.md
@@ -0,0 +1,55 @@
+# Быстрый старт — тест ELM327 в машине
+
+## Один раз: Bluetooth
+
+```bash
+bash scripts/setup-bt.sh
+```
+
+Следуй инструкциям на экране. Нужен MAC-адрес ELM327 (обычно виден в списке найденных устройств).
+
+---
+
+## Тест 1: только чтение (без LLM)
+
+```bash
+python run.py --no-llm
+```
+
+Что должно произойти:
+- Подключится к ELM327
+- Прочитает VIN
+- Прочитает коды ошибок
+- Прочитает параметры (обороты, температура, скорость...)
+- Сохранит в elmer.db
+
+Если ошибка «Не удалось открыть порт» — запусти `bash scripts/setup-bt.sh` ещё раз.
+
+---
+
+## Тест 2: полный цикл (с DeepSeek)
+
+```bash
+DEEPSEEK_API_KEY=sk-твой-ключ python run.py
+```
+
+То же самое + отправит в DeepSeek и покажет диагноз.
+
+---
+
+## Веб-интерфейс (на ноутбуке)
+
+```bash
+pip install -r requirements.txt
+DEEPSEEK_API_KEY=sk-твой-ключ python web/app.py
+# Открыть http://localhost:5005
+```
+
+---
+
+## Если ELM327 не отвечает
+
+1. Проверь что ELM327 запитана (горит лампочка)
+2. Проверь сопряжение: `bluetoothctl paired-devices`
+3. Проверь порт: `ls -la /dev/rfcomm0`
+4. Попробуй вручную: `sudo rfcomm bind 0 MAC-адрес`