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.
4.2 KiB
Связь подсистем (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 (электроника): сильные связи и откат шага.
Открыто
Выбор коэффициента релаксации и предельного числа делений шага.