fabrilis/docs/COUPLING.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

46 lines
4.2 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.

# Связь подсистем (co-simulation)
Типичная замкнутая цепь: МК выдаёт PWM, драйвер питает мотор, мотор двигает ногу,
нагрузка поднимает ток, ток просаживает питание и греет провод, нагрев меняет
сопротивление, и мотор теряет момент. Подсистемы считаются разными решателями, и
от способа обмена между ними зависит, будет ли поведение верным. Словарь заимствован
из стандарта FMI: master algorithm, communication step, event iteration, rollback.
## Классы связей
| Класс | Пример | Способ обмена |
|---|---|---|
| Односторонняя | физика → рендер; ток → нагрев провода (медленно) | снимок, без итераций |
| Слабая двусторонняя | МК ↔ периферия; температура ↔ сопротивление | обмен в точках синхронизации, запаздывание на шаг допустимо, значение удерживается (zero-order hold) |
| Сильная | мотор: напряжение, ток, обратная ЭДС, момент, скорость; контакт стопы с землёй | один решатель на всю связку или итерации внутри шага (Гаусс-Зейдель с релаксацией) и критерий сходимости |
Каждая связь в коде объявляется с классом. Сильные связи нельзя решать запаздыванием:
модель мотора живёт внутри аналогового решателя, а механическая нагрузка входит в неё
как состояние (момент, скорость) и обновляется на каждом аналоговом шаге.
## Контракт подсистемы
Входы, выходы, период, направление связи, допустимое запаздывание и поддержка отката
(`save` и `restore` состояния). Контракт проверяется при сборке сцены.
## События
Очередь событий с метками времени в нс: фронты PWM, прерывания МК, перегорание
предохранителя, обрыв провода. Событие делит шаг: аналоговый решатель ставит
breakpoint в момент события. Внутри эпохи события обрабатываются в порядке (время,
приоритет, номер подсистемы). Между событиями значения удерживаются; интерполяция
нужна только для вывода.
## Шаг и ошибка
Аналоговый шаг адаптивный и ограничен максимумом режима (Bench: 1 мкс, World: крупный
квант) и ближайшим событием. Если итерации сильной связи не сошлись, шаг делится
пополам и повторяется с отката. Если после N делений сходимости нет, это диагностика
в отчёт (VALIDATION.md), а не тихое продолжение.
## Снимок
Снимок состоит из подснимков подсистем, и каждая подсистема сама сериализует своё
состояние. Это нужно для отката шага, перемотки и сохранения.
## План внедрения
- Срез 1: слабые связи с запаздыванием на шаг и очередь событий.
- Срез 4 (электроника): сильные связи и откат шага.
## Открыто
Выбор коэффициента релаксации и предельного числа делений шага.