485 lines
18 KiB
Markdown
485 lines
18 KiB
Markdown
# ELM327 Communication Patterns — анализ 5 отлаженных проектов
|
||
|
||
> **Цель:** понять как РЕАЛЬНО работают проекты с ELM327, выбрать лучшие паттерны для Elmer.
|
||
> **Дата:** 2026-05-27
|
||
> **Источники:** исходный код 5 проектов (Java, Kotlin, Python, C)
|
||
|
||
---
|
||
|
||
## Сводная таблица
|
||
|
||
| | OBD-Droid | OBD2AI | Automotive-AI | obd2-mcp-server | Vehicle-Diag-Assist |
|
||
|---|---|---|---|---|---|
|
||
| **Язык** | Java | Kotlin | Python | Python | C (W600) + Python |
|
||
| **Платформа** | Android | Android | Desktop | Desktop/Claude MCP | Embedded (MCU) |
|
||
| **LLM** | ChatGPT | gpt-5-mini | GPT-3.5/4 | Claude (MCP) | DeepSeek/Claude |
|
||
| **Чтение** | Побайтово, 1мс | kotlin-obd lib | readline() | Побайтово (BLE/SPP) | UART, семафор |
|
||
| **UUID** | 00001101... | 00001101... | N/A (pyserial) | BLE + serial | N/A (UART) |
|
||
| **Baud** | — | — | config.py | 38400 (auto-retry) | 38400 8N1 |
|
||
| **Timeout** | Адаптивный 5с | 400мс fix | 1с | 20с connect / 2с config | 2000мс |
|
||
| **Инит** | ATD→ATE0→ATL0→ATS0→ATH1→... | ATZ→ATE0→ATL0→ATSP0 | N/A | ATZ→ATE0→ATL0→ATS0→ATH1→ATCAF1→ATAT1→ATST64→ATSP0 | ATZ→... |
|
||
| **Ретраи** | requeue + SETPROT | 3 strikes → stop | Нет | [2,5,10]с backoff | Нет |
|
||
| **Simulator** | Встроенный demo | Нет | ELM327-emulator | Mock mode (Ford) | Gradio + HW sim |
|
||
| **DTC база** | Встроенная | Нет | Нет | 1937 Ford + generic | Нет |
|
||
|
||
---
|
||
|
||
## 1. OBD-Droid (Wal33D) — Java Android ⭐ ЛУЧШИЙ
|
||
|
||
### 1.1. StreamHandler.java — побайтовый I/O
|
||
|
||
```java
|
||
// ЧТЕНИЕ: побайтово, сон 1мс между проверками
|
||
public void run() {
|
||
while (true) {
|
||
if (in.available() > 0) {
|
||
if ((chr = in.read()) > 0) {
|
||
processRxChar(chr);
|
||
} else break;
|
||
} else {
|
||
Thread.sleep(1); // ← 1 миллисекунда!
|
||
}
|
||
}
|
||
}
|
||
|
||
// ОБРАБОТКА СИМВОЛОВ: '>' = такой же разделитель как CR/LF!
|
||
private void processRxChar(int chr) {
|
||
switch (chr) {
|
||
case 32: break; // пробел — игнорируем
|
||
case '>': // промпт ELM
|
||
message += (char) chr;
|
||
// fall through — НЕ отдельный случай!
|
||
case 10: // LF
|
||
case 13: // CR
|
||
messageHandler.handleTelegram(message.toCharArray());
|
||
message = "";
|
||
break;
|
||
default:
|
||
message += (char) chr;
|
||
}
|
||
}
|
||
|
||
// ОТПРАВКА: BufferedWriter с буфером 1 байт = flush на каждом байте
|
||
out = new BufferedWriter(new OutputStreamWriter(outStream), 1);
|
||
|
||
public int writeTelegram(final char[] buffer, int type, Object id) {
|
||
new Thread(() -> {
|
||
String msg = new String(buffer) + "\r"; // ELM ждёт CR
|
||
out.write(msg.toCharArray());
|
||
out.flush(); // немедленный flush из-за буфера 1 байт
|
||
}).start();
|
||
return buffer.length;
|
||
}
|
||
```
|
||
|
||
**Ключевые выводы:**
|
||
- `>` — НЕ спецсигнал «можно слать дальше». Это просто разделитель строк, как CR/LF.
|
||
- Буфер 1 байт на запись = каждый байт сразу уходит в порт.
|
||
- Отправка в отдельном потоке (не блокирует чтение).
|
||
|
||
### 1.2. ElmProt.java — стейт-машина протокола
|
||
|
||
**RSP_ID — все возможные ответы ELM327:**
|
||
```java
|
||
enum RSP_ID {
|
||
PROMPT(">"), OK("OK"), MODEL("ELM"),
|
||
NODATA("NODATA"), SEARCH("SEARCHING"),
|
||
ERROR("ERROR"), NOCONN("UNABLE"), NOCONN2("NABLETO"),
|
||
CANERROR("CANERROR"), BUSBUSY("BUSBUSY"),
|
||
BUSERROR("BUSERROR"), BUSINIERR("BUSINIT:ERR"),
|
||
BUSINIERR2("BUSINIT:BUS"), BUSINIERR3("BUSINIT:...ERR"),
|
||
FBERROR("FBERROR"), DATAERROR("DATAERROR"),
|
||
BUFFERFULL("BUFFERFULL"), STOPPED("STOPPED"),
|
||
RXERROR("<"), QMARK("?"),
|
||
UNKNOWN("");
|
||
}
|
||
```
|
||
|
||
**STAT — состояния соединения:**
|
||
```java
|
||
UNDEFINED → INITIALIZING → INITIALIZED → ECU_DETECT → ECU_DETECTED
|
||
→ ECU_SELECTED → CONNECTING → CONNECTED
|
||
// Ошибки:
|
||
NODATA, STOPPED, DISCONNECTED, BUSERROR, DATAERROR, RXERROR, ERROR
|
||
```
|
||
|
||
**Инициализация (после ATZ → MODEL):**
|
||
```
|
||
ATD // defaults
|
||
ATE0 // echo off
|
||
ATL0 // line feeds off
|
||
ATS0 // spaces off
|
||
ATH1 // headers ON (для обнаружения ЭБУ)
|
||
ATDP // узнать протокол
|
||
ATSPA1 // протокол AUTO
|
||
ATAT1 // adaptive timing ON
|
||
ATST<value> // установить таймаут
|
||
```
|
||
|
||
**Обработка ошибок — детально:**
|
||
```
|
||
SEARCHING → статус CONNECTING (не ошибка!)
|
||
NODATA → увеличить OBD timeout + переустановить протокол
|
||
ERROR → WARMSTART (ATWS)
|
||
DATAERROR → WARMSTART
|
||
RXERROR → WARMSTART
|
||
BUFFERFULL→ WARMSTART
|
||
BUS ERROR → DISCONNECTED → переустановить протокол + ретрай последней команды
|
||
UNABLE → DISCONNECTED → переустановить протокол + ретрай
|
||
```
|
||
|
||
**Мульти-фрейм ISO-TP:**
|
||
```
|
||
Формат: "0:4100..." — первая строка с длиной
|
||
"1:4100..." — продолжение
|
||
charsExpected = байт_длины * 2 (каждый байт = 2 hex символа)
|
||
```
|
||
|
||
### 1.3. BluetoothCommService.java — BT SPP
|
||
|
||
```java
|
||
final UUID SPP_UUID = UUID.fromString("00001101-0000-1000-8000-00805F9B34FB");
|
||
|
||
// Первая попытка: стандартный RFCOMM
|
||
tmp = device.createRfcommSocketToServiceRecord(SPP_UUID); // secure
|
||
// или
|
||
tmp = device.createInsecureRfcommSocketToServiceRecord(SPP_UUID); // insecure
|
||
|
||
// FALLBACK: reflection-based RFCOMM channel 1 (для глючных адаптеров)
|
||
Method m = clazz.getMethod("createRfcommSocket", paramTypes);
|
||
Object[] params = new Object[]{1}; // channel 1
|
||
sockFallback = (BluetoothSocket) m.invoke(device, params);
|
||
```
|
||
|
||
**Ключевой вывод:** Есть fallback на reflection-based RFCOMM channel 1 — для дешёвых китайских клонов!
|
||
|
||
---
|
||
|
||
## 2. OBD2AI (catsmoker) — Kotlin Android
|
||
|
||
### 2.1. BluetoothHelper
|
||
|
||
```kotlin
|
||
val sppUuid: UUID = UUID.fromString("00001101-0000-1000-8000-00805F9B34FB")
|
||
|
||
suspend fun connectToDevice(deviceAddress: String): Pair<InputStream, OutputStream> {
|
||
val device = bluetoothAdapter?.getRemoteDevice(deviceAddress)
|
||
bluetoothSocket = device.createRfcommSocketToServiceRecord(sppUuid).apply {
|
||
bluetoothAdapter.cancelDiscovery()
|
||
connect()
|
||
}
|
||
return Pair(socket.inputStream, socket.outputStream)
|
||
}
|
||
```
|
||
|
||
### 2.2. ObdHelper — инициализация и команды
|
||
|
||
```kotlin
|
||
// Инициализация: фиксированные задержки, БЕЗ ожидания '>'
|
||
suspend fun initializeObd() = withContext(Dispatchers.IO) {
|
||
suspend fun sendRawCommand(command: String) {
|
||
out.write((command + "\r").toByteArray())
|
||
out.flush()
|
||
delay(400) // ← 400мс после КАЖДОЙ команды
|
||
}
|
||
|
||
sendRawCommand("ATZ") // сброс
|
||
sendRawCommand("ATE0") // эхо выкл
|
||
sendRawCommand("ATL0") // line feeds выкл
|
||
sendRawCommand("ATSP0") // авто-протокол
|
||
|
||
delay(1000) // дополнительная пауза после инита
|
||
// Очистка буфера
|
||
if (`in`.available() > 0) {
|
||
val buffer = ByteArray(`in`.available())
|
||
`in`.read(buffer)
|
||
}
|
||
}
|
||
```
|
||
|
||
**Используется библиотека `kotlin-obd` (eltonvs):**
|
||
```kotlin
|
||
// Для стандартных команд — библиотека
|
||
obdConnection = ObdDeviceConnection(inputStream, outputStream)
|
||
val result = connection.run(TroubleCodesCommand())
|
||
|
||
// Для нестандартных — ручной парсинг
|
||
class MyRPMCommand : ObdCommand() {
|
||
override val pid = "0C"
|
||
override val handler = { it: ObdRawResponse ->
|
||
val rawValue = it.processedValue
|
||
val identifier = "410C"
|
||
val aHex = rawValue.substring(index + 4, index + 6)
|
||
val bHex = rawValue.substring(index + 6, index + 8)
|
||
((a * 256) + b) / 4 // формула RPM
|
||
}
|
||
}
|
||
```
|
||
|
||
### 2.3. Live Data Monitoring
|
||
|
||
```kotlin
|
||
suspend fun startLiveDataMonitoring() = withContext(Dispatchers.IO) {
|
||
var errorCount = 0
|
||
while (isMonitoring.get()) {
|
||
try {
|
||
val speed = runCommand(MySpeedCommand())
|
||
val rpm = runCommand(MyRPMCommand())
|
||
val temp = runCommand(MyCoolantTempCommand())
|
||
errorCount = 0
|
||
delay(800) // 800мс между циклами
|
||
} catch (e: Exception) {
|
||
errorCount++
|
||
if (errorCount >= 3) break // 3 ошибки подряд = стоп
|
||
delay(1000)
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 3. Automotive-AI (Eloquent-Algorithmics) — Python Desktop
|
||
|
||
### 3.1. ELM327 через pyserial
|
||
|
||
```python
|
||
# config.py
|
||
SERIAL_PORT = "/dev/ttyUSB0" # или COM3 на Windows
|
||
BAUD_RATE = 38400
|
||
|
||
# Подключение
|
||
ser = serial.Serial(port=SERIAL_PORT, baudrate=BAUD_RATE, timeout=1)
|
||
|
||
# Отправка команды
|
||
def send_command(ser, command):
|
||
ser.write((command + "\r\n").encode()) # CRLF терминатор
|
||
response = ser.readline().decode().strip()
|
||
response = response.replace("\r", "").replace(">", "")
|
||
return response
|
||
```
|
||
|
||
**Ключевые отличия от OBD-Droid:**
|
||
- `readline()` вместо побайтового чтения — ПРОЩЕ, но менее надёжно
|
||
- `\r\n` вместо просто `\r`
|
||
- `timeout=1` — ждёт 1 секунду на readline
|
||
- Убирает `>` из ответа (не использует как разделитель)
|
||
|
||
### 3.2. Парсинг ответов
|
||
|
||
```python
|
||
# RPM: 010C → 41 0C HH LL
|
||
if cmd == "010C":
|
||
value = (int(response.split()[2], 16) * 256 +
|
||
int(response.split()[3], 16)) / 4
|
||
|
||
# Coolant: 0105 → 41 05 XX
|
||
if cmd == "0105":
|
||
value = int(response.split()[2], 16) - 40 # -40 offset
|
||
|
||
# VIN: 0902
|
||
vin_response = parse_vin_response(response)
|
||
vehicle_data = decode_vin(vin_response)
|
||
```
|
||
|
||
---
|
||
|
||
## 4. obd2-mcp-server (petrpatek) — Python Claude MCP ⭐ САМЫЙ СВЕЖИЙ
|
||
|
||
### 4.1. BLE + Serial подключение
|
||
|
||
```
|
||
Поддерживает:
|
||
- BLE (vLinker FD, STN чип) — асинхронный, asyncio.Lock
|
||
- Serial (classic Bluetooth SPP) — синхронный, pyserial
|
||
|
||
Baud rate auto-retry: [500k, 115.2k, 38.4k, 9.6k]
|
||
BLE: 30-секундный keepalive heartbeat (без него адаптер засыпает через ~120с)
|
||
```
|
||
|
||
### 4.2. Инициализация (САМАЯ ПОЛНАЯ)
|
||
|
||
```python
|
||
ATZ # сброс
|
||
ATE0 # эхо выкл
|
||
ATL0 # line feeds выкл
|
||
ATS0 # пробелы выкл
|
||
ATH1 # заголовки CAN ВКЛ (для обнаружения ЭБУ)
|
||
ATCAF1 # CAN auto-formatting ON
|
||
ATAT1 # adaptive timing ON
|
||
ATST64 # timeout = 64*4ms = 256ms
|
||
ATSP0 # авто-протокол
|
||
|
||
# Для STN адаптеров (OBDlink):
|
||
ATPP 0E SV 00 # отключить сон
|
||
ATPP 0E ON # включить
|
||
```
|
||
|
||
### 4.3. Ретраи и таймауты
|
||
|
||
```python
|
||
MAX_RETRIES = 3
|
||
RETRY_BACKOFF = [2, 5, 10] # секунды
|
||
CONNECT_TIMEOUT = 20 # секунд
|
||
PROTOCOL_TIMEOUT = 12 # секунд
|
||
CONFIG_TIMEOUT = 2 # секунды
|
||
```
|
||
|
||
### 4.4. Очистка ответа
|
||
|
||
```python
|
||
def _clean_elm_response(raw: str) -> str:
|
||
# Убирает: промпт ">", эхо команд, "SEARCHING...", пустые строки
|
||
...
|
||
```
|
||
|
||
### 4.5. DTC база данных
|
||
|
||
```
|
||
- 1937 Ford-специфичных кодов
|
||
- Generic OBD-II коды (P, B, C, U)
|
||
- Ленивая загрузка по бренду
|
||
- Скрапинг с troublecodes.net
|
||
```
|
||
|
||
---
|
||
|
||
## 5. Vehicle-Diagnostic-Assistant (castlebbs) — Embedded C + Python
|
||
|
||
### 5.1. Аппаратная архитектура
|
||
|
||
```
|
||
W600 MCU ←UART1 38400 8N1→ ELM327 чип → CAN → Авто
|
||
↕ HTTP/MCP
|
||
LangChain Agent (Python) → DeepSeek / Claude
|
||
```
|
||
|
||
### 5.2. ELM327 Driver (C)
|
||
|
||
```c
|
||
// elm327.c
|
||
int elm327_send_command(const char* cmd, char* resp, int len, int timeout) {
|
||
// Пишет команду + \r в UART1
|
||
// Ждёт ответ через FreeRTOS semaphore (прерывание по приёму)
|
||
// Таймаут по умолчанию: 2000мс
|
||
// Макс. длина ответа: 512 байт
|
||
}
|
||
|
||
// Hybrid simulation mode:
|
||
// AT команды → реальный ELM327
|
||
// OBD команды → симуляция (если включена)
|
||
```
|
||
|
||
### 5.3. Поддерживаемые режимы OBD
|
||
|
||
```
|
||
Mode 01: live data (30+ PID)
|
||
Mode 03: stored DTC (формат 43 XX XX XX XX)
|
||
Mode 04: clear DTC (44)
|
||
Mode 07: pending DTC (47)
|
||
Mode 09: vehicle info (VIN, calibration ID)
|
||
```
|
||
|
||
### 5.4. PID формулы (Mode 01)
|
||
|
||
| PID | Формула | Пример |
|
||
|-----|---------|--------|
|
||
| 0C (RPM) | `(A*256+B)/4` | 0x1AF8 → 1726 |
|
||
| 0D (Speed) | `A` (km/h) | 0x00 → 0 |
|
||
| 05 (ECT) | `A-40` (°C) | 0x5A → 50 |
|
||
| 04 (Load) | `(A*100)/255` (%) | 0x40 → 25.1 |
|
||
| 10 (MAF) | `((A*256)+B)/100` (g/s) | — |
|
||
| 2F (Fuel) | `(A*100)/255` (%) | — |
|
||
|
||
### 5.5. Safe formula evaluation
|
||
|
||
```python
|
||
def calculate_obd_value(raw_response, formula):
|
||
# LLM вызывает этот tool для расчёта значений
|
||
# safe_eval() — ограниченный eval (только +-*/ и переменные A,B,C,D)
|
||
hex_bytes = raw_response.replace("41 XX ", "").split()
|
||
A, B, C, D = [int(x, 16) for x in hex_bytes]
|
||
return safe_eval(formula, {"A": A, "B": B, "C": C, "D": D})
|
||
```
|
||
|
||
---
|
||
|
||
## СРАВНИТЕЛЬНЫЙ АНАЛИЗ: Что взять для Elmer
|
||
|
||
### Инициализация ELM327
|
||
|
||
| Проект | Последовательность | Задержки |
|
||
|--------|-------------------|----------|
|
||
| OBD-Droid | ATD→ATE0→ATL0→ATS0→ATH1→ATDP→ATSPA1→ATAT1→ATST | Стейт-машина, нет фикс. задержек |
|
||
| OBD2AI | ATZ→ATE0→ATL0→ATSP0 | 400мс после каждой |
|
||
| obd2-mcp | ATZ→ATE0→ATL0→ATS0→ATH1→ATCAF1→ATAT1→ATST64→ATSP0 | async, по ответам |
|
||
| Automotive-AI | Нет явной инициализации | — |
|
||
|
||
**Рекомендация для Elmer:** взять последовательность obd2-mcp-server (самая полная) + задержки OBD2AI (400мс) + ATH0 вместо ATH1 (для чистых ответов без CAN-заголовков).
|
||
|
||
### Чтение ответов
|
||
|
||
| Проект | Метод | Плюсы | Минусы |
|
||
|--------|-------|-------|--------|
|
||
| OBD-Droid | Побайтово, 1мс sleep | Макс. контроль | Сложный код |
|
||
| OBD2AI | kotlin-obd lib | Готовое решение | Зависимость от библиотеки |
|
||
| Automotive-AI | `ser.readline()` | Простой код | Менее надёжно |
|
||
|
||
**Рекомендация для Elmer:** для Android — побайтовое чтение как у OBD-Droid (уже есть в TestService). Для Python-мока/сервера — `readline()` достаточно для тестов.
|
||
|
||
### Обработка ошибок
|
||
|
||
| Ошибка | OBD-Droid | OBD2AI | obd2-mcp |
|
||
|--------|-----------|--------|----------|
|
||
| SEARCHING | Статус CONNECTING | — | Пропустить, ждать |
|
||
| NO DATA | Увеличить timeout | — | Вернуть пусто |
|
||
| BUS ERROR | DISCONNECTED + retry | — | — |
|
||
| UNABLE | DISCONNECTED + retry | — | — |
|
||
| ERROR | WARMSTART (ATWS) | — | — |
|
||
| RX ERROR | WARMSTART | 3 strikes → stop | — |
|
||
|
||
**Рекомендация для Elmer:** SEARCHING = ждать + увеличить таймаут. NO DATA = пропустить PID. BUS ERROR/UNABLE = одна попытка reconnect + retry. ERROR = WARMSTART.
|
||
|
||
### Тайминги
|
||
|
||
| Проект | Между командами | Инит | Таймаут ответа |
|
||
|--------|-----------------|------|----------------|
|
||
| OBD-Droid | Нет (стейт-машина) | Стейт-машина | 5000мс адаптивный |
|
||
| OBD2AI | 400мс fix | 1000мс после всех | ? (внутри lib) |
|
||
| Automotive-AI | Нет | Нет | 1000мс (readline) |
|
||
| obd2-mcp | По ответам | По ответам | 2000-20000мс |
|
||
| castlebbs | По семафору | — | 2000мс |
|
||
|
||
**Рекомендация для Elmer:** 400мс между командами (как OBD2AI) + адаптивный таймаут от 2000мс с возможностью увеличения (как OBD-Droid).
|
||
|
||
### BT подключение (Android)
|
||
|
||
| Проект | Метод | Fallback |
|
||
|--------|-------|----------|
|
||
| OBD-Droid | `createRfcommSocketToServiceRecord` secure + insecure | Reflection RFCOMM channel 1 |
|
||
| OBD2AI | `createRfcommSocketToServiceRecord` | Нет |
|
||
|
||
**Рекомендация для Elmer:** взять fallback на reflection channel 1 из OBD-Droid — критично для дешёвых клонов.
|
||
|
||
---
|
||
|
||
## ИТОГ: Что реализовать в elmer-android
|
||
|
||
### Приоритет 1 (обязательно)
|
||
- [ ] Побайтовое чтение с паузой 1мс (StreamHandler.java)
|
||
- [ ] `>` = разделитель строк, НЕ спецсигнал
|
||
- [ ] Fallback RFCOMM channel 1 (BluetoothCommService.java)
|
||
- [ ] Фиксированные задержки 400мс между командами (OBD2AI)
|
||
- [ ] Очистка буфера после инициализации
|
||
|
||
### Приоритет 2 (важно)
|
||
- [ ] Обработка SEARCHING, NO DATA, BUS ERROR
|
||
- [ ] 3-strike retry для live monitoring
|
||
- [ ] Адаптивный таймаут (базовый 5000мс)
|
||
|
||
### Приоритет 3 (для production)
|
||
- [ ] WARMSTART при ERROR/DATAERROR
|
||
- [ ] Мульти-фрейм ISO-TP
|
||
- [ ] DTC база (можно с obd2-mcp-server)
|
||
- [ ] Экспоненциальный backoff для ретраев
|