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.
This commit is contained in:
Loki 2026-11-16 19:09:10 +01:00
commit 79928b645b
Signed by: boba
GPG key ID: 6CDE87BC9A778D97
222 changed files with 5335 additions and 0 deletions

34
docs/ELECTRONICS.md Normal file
View file

@ -0,0 +1,34 @@
# Электроника
Цель: те же ELF-файлы, образы и драйверы, что и на реальном железе, без изменений.
## Цифровой слой
- `cpu`: трейт `Cpu` (`step(бюджет_тактов)`, `reset`, линии IRQ). Реализации:
RV32IMAC (микроконтроллеры), RV64GC с режимами M/S/U и MMU Sv39 (Linux).
Позже arm и avr через тот же трейт.
- Два режима выполнения: точный по тактам (Bench) и пачками (World).
- `soc`: шина с трейтом `Device` (чтение/запись по адресу, `tick`, IRQ), карта
памяти как данные, **device tree генерируется из неё**. Периферия: UART, GPIO,
I2C, SPI, PWM, ADC, таймеры, virtio (диск, консоль).
## Аналоговый слой
- `analog`: метод узловых потенциалов. Элемент добавляет «штамп» в матрицу.
Нелинейные элементы решаются Newton; сходимость обеспечивают gmin stepping,
source stepping и breakpoints. Шаг адаптивный, ограничен максимумом режима
(Bench и Lab 1 мкс, World 50 мкс) и ближайшим событием (COUPLING.md).
Если шаг не сходится после N делений, это диагностика в отчёт (VALIDATION.md),
а не тихое продолжение.
- Элементы: R, C, L, источники, диоды, транзисторы, батарея (с внутренним
сопротивлением), драйверы, датчики.
- `wiring` добавляет провода и разъёмы как элементы со связью с `thermal`.
## Мост (`bridge`)
- GPIO — источник напряжения с выходным сопротивлением.
- ADC читает напряжение узла; фронты PWM попадают в аналоговый шаг в точный момент.
- Мотор и мышца — сильная связь: модель мотора с обратной ЭДС живёт внутри
аналогового решателя, механическая нагрузка входит в неё как состояние и
обновляется на каждом аналоговом шаге (COUPLING.md). Слабое запаздывание на шаг
здесь недопустимо.
## Плата как данные
RON описывает SoC и подключённую схему. Образ прошивки хранится по хешу.