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

2.7 KiB
Raw Blame History

Электроника

Цель: те же 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 и подключённую схему. Образ прошивки хранится по хешу.