fabrilis/docs/MODES.md
loki5512344 878d144b77 Initial commit: Fabrilis docs, rules and deterministic core
Docs (architecture, decisions, coupling, determinism, UI, references), code rules enforced by tools/limits, deterministic core with units, time, math, sched, snapshot, vec and rng, plus smoke tests. ref/ stays out of git.
2026-11-16 23:06:29 +01:00

43 lines
3.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Режимы и Fidelity
Один бинарник, одна конструкция, три пресета. Режим задаёт периоды подсистем и
выбор моделей (`Fidelity`), всё остальное общее.
| Режим | Что это | Точность |
|---|---|---|
| **Bench** | Плата без мира: SoC, периферия, схема, питание | МК по тактам, аналоговый шаг до 1 мкс |
| **Lab** | Одна деталь на стенде: нагрузка, ток, температура | FEM, подробные мышцы, тепло, аналоговый шаг до 1 мкс |
| **World** | Паук в мире: поляна, горы, ветер | физика 1 кГц (1 мс), аналоговый шаг до 50 мкс, МК пачками |
Деталь из World можно «вынуть» в Lab, плату — в Bench, конструкция та же.
Шаг физики 1 кГц выбран под ходьбу: при 250 Гц контакт стопы и жёсткий шарнир
разъезжаются по фазе. 1 мс — целое число наносекунд (1 000 000 нс), поэтому
делится без остатка. Если эталонная сцена не тянет real-time, World замедляется,
а не огрубляется (см. бюджет в ARCHITECTURE.md).
## Fidelity (примеры)
| Подсистема | Высокая | Низкая |
|---|---|---|
| Мышца | модель Хилла + тепло | простой привод |
| Электроника | transient MNA, шаг до 1 мкс | идеальные элементы, шаг до 50 мкс |
| Механика | балки/FEM | жёсткие тела + нагрузки на шарниры |
| Аэродинамика | панельный метод | таблицы коэффициентов |
| МК | по тактам | пачки по 1000 тактов, квантованные прерывания |
Fidelity — набор независимых полей, а не единый переключатель: можно взять точную
механику и простую электронику. Режимы — только пресеты этих полей.
## События
Шаг подсистемы ограничен не только периодом, но и ближайшим событием в очереди:
фронт PWM, прерывание МК, отказ. Событие делит шаг в момент своего наступления
(COUPLING.md). Между событиями входы удерживаются.
## Управление временем (отдельно от Fidelity)
- Масштабируется только показ; шаг симуляции `dt` не меняется.
- Пауза; шаг на такт, квант или (Bench) инструкцию МК.
- Замедление 0.01×–1×; ускорение ограничено real-time factor.
- Перемотка назад: ближайший снимок + досчёт вперёд (возможна из-за детерминизма).
- Рендер интерполирует между снимками.
- Bench и Lab никогда не огрубляются: если железо не тянет, симуляция идёт медленнее
реального времени (показывается RTF). Только World может снижать визуальное качество.