fabrilis/docs/MODES.md
loki5512344 79928b645b
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

3.5 KiB
Raw Blame History

Режимы и 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 может снижать визуальное качество.