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:
commit
79928b645b
222 changed files with 5335 additions and 0 deletions
34
docs/ELECTRONICS.md
Normal file
34
docs/ELECTRONICS.md
Normal 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 и подключённую схему. Образ прошивки хранится по хешу.
|
||||
Loading…
Add table
Add a link
Reference in a new issue