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