kk0t9
5ba19cde46
- GPS-скорость: zero-clamp <~2-3 км/ч (на стоянке Doppler-шум, не ноль) — distraction v1 получал бы ложный on; FixQuality многоуровневый (no_fix/2d/3d/augmented/dead_reckoning + HDOP/sats); dead_reckoning не валиден для distraction/Nav; валидность времени ≠ позиции - приватность локации: эфемерна (без трека в v1), audit-log, исключена из LLM-промпта, while-in-use грант, on-device - антенна (внешняя/активная), TTFF cold/warm-start, окно без GPS на старте поездки; питание GPS в sleep/battery-cutoff (обесточивание+cold-start по умолчанию) - резистивная ADC-лесенка руля: контракт window-table + кондиционирование + collision-drop + темп-дрейф; транспорт ввода = uinput/evdev (не Shell-D-Bus, иначе surface-апы не покрыты); гейтинг руль-действий в distraction - IMU опционален/не гарантирован → dashcam (J) = непрерывный ring-buffer, не на g-sensor - точность времени SHM (~десятки-сотни мс), PPS опц./hardware-gated; Nav «фаза 2»→v4 - кросс-док: a-base §7/§14 (SHM, split time-row + K-dep), hardware §4 (антенна/1PPS), domains/README (K-cell без TPMS/климата), ipc Location (enum), c-shell §7/§9/§11 (clamped speed, uinput-ввод, закрыт Location-вопрос) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
4.7 KiB
4.7 KiB
Домены (Tier 2)
Детальные спеки подсистем. Каждый домен — отдельный документ по единому шаблону (ниже). Файлы создаём по мере наполнения; здесь — карта и план.
Статус: индекс + шаблон. Содержательные файлы доменов появляются по ходу работы.
Единый шаблон домена
- Назначение и границы — что делает, чего НЕ делает.
- Функции — таблица:
функция | MVP / later | зависит от | фаза. - Данные и интерфейсы — что домен публикует/потребляет на шине (ссылки на
../contracts/). - Зависимости — ссылки на другие домены и контракты (← здесь «связи»).
- Открытые вопросы / решения.
Карта доменов
| # | Домен | Файл | Кратко |
|---|---|---|---|
| A | Базовая система / OS | a-base-system.md |
образ, read-only rootfs, boot, watchdog, OTA, board support |
| B | Питание и жизненный цикл | b-power-lifecycle.md |
ACC, graceful shutdown, sleep, защита eMMC |
| C | Shell / UX / лаунчер | c-shell-ux.md |
тайлы, темы день/ночь, профили, driver-distraction, ввод с мультируля, мультидисплей |
| D | Голосовой ассистент | d-assistant.md |
wake→STT→LLM→TTS, vehicle-context, память о водителе (.md), офлайн-фолбэк, провайдер-агностик |
| E | Vehicle Data (OBD/CAN, read-only) | e-vehicle-data.md |
PIDs, DTC + расшифровка, поездки, расход, VSS-модель |
| F | Plugin host & экосистема | f-plugin-host.md |
загрузка/sandbox/lifecycle плагинов, дистрибуция, dev-tools (API — в ../contracts/plugin-sdk.md) |
| G | Связь / телефон | g-connectivity-phone.md |
BT HFP, модем/LTE, WiFi/hotspot, проекция телефона |
| H | Медиа / аудио | h-media-audio.md |
вся стандартная мультимедиа: локальное аудио, BT A2DP/AVRCP, радио, стриминг |
| I | Навигация | i-navigation.md |
офлайн-карты OSM, роутинг, POI, связка с ассистентом |
| J | Камеры / видео | j-cameras-video.md |
задняя камера, парктроник-оверлей, dashcam |
| K | Датчики / периферия | k-sensors-peripherals.md |
GPS/Location, IMU; кнопки руля — резистивная ADC-лесенка (CAN-кнопки/TPMS/климат/парктроник на CAN — у E); выделенные не-CAN датчики |
| L | Облако / компаньон | l-cloud-companion.md |
мобильное приложение, синхронизация, бэкап, OTA-канал, телеметрия (opt-in) |
Порядок наполнения определим в roadmap.md; технически — после контрактов.
Заделы (сиды для будущих доменов)
Идеи на будущее, пойманные по ходу проектирования; раскрываются при наполнении домена.
- J (Камеры). Камеры — динамический набор 0..N источников видео, не одна задняя. Задел: подключение доп. камер — фронтальная для видеорегистратора (dashcam), камеры кругового обзора (360°/surround) и т.п. Набор источников и «виды» (например surround-композит) — расширяемые, плагин может добавить источник/вид.
- K (Датчики). Парктроники и подобные датчики ближнего действия — как источник данных (чтение с CAN через Vehicle-Data или отдельный датчик) для оверлеев/ предупреждений поверх видео-вида.
- Архитектурная связь: видео-источники идут через data-plane (PipeWire/V4L2); задняя/парктроник-вид требуют низколатентного раннего пути (см. Решение №3 и lifecycle).