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