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

34 lines
2.7 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.

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