Документация проекта AtlasOS

2026-06-14 01:17:37 +03:00
parent db99f47077
commit 66d9f8037c
8 changed files with 588 additions and 0 deletions
@@ -0,0 +1,83 @@
+# 01 — Аппаратный слой (Hardware)
+
+## 1. Физические компоненты
+
+AtlasOS использует следующие компоненты Barotrauma + MicroLua:
+
+| Компонент | Кол-во | Назначение | Ёмкость / пины | Примечание |
+|---|---|---|---|---|
+| **MicroLua** | 3 (+5 резерв) | **IOC, CMC, MMC** | 32 in / 32 out | контроллеры блоков |
+| **Memory** | n (≥2) | сегменты **SEG0..SEGn** | 4096 символов UTF-8 | хранилище |
+| **Terminal / Display** | n | экраны | — | по одному IOC на терминал, login/logout per-terminal |
+
+Дополнительно:
+
+- Кнопки / переключатели — источники ввода команд.
+- Memory-компоненты подключаются к MMC по **WE- и RD-линиям** (подробно ниже).
+
+## 2. Распределение контроллеров
+
+| Контроллер | Роль | Входы (примеры) | Выходы (примеры) |
+|---|---|---|---|
+| **IOC** (n шт.) | терминал + login | in1 = ввод строки | out1 = текст, out2 = clear, out3 = цвет |
+| **CMC** (1) | центральный CPU, shell | сообщения от IOC | команды к IOC и MMC (однонаправленно) |
+| **MMC** (1) | MMU + inode-ФС | ответы от SEG | WE/RD/DATA к сегментам |
+
+Оставшиеся до 5 контроллеров:
+
+- копроцессоры тяжёлых команд (поиск, архивирование);
+- параллельные сессии;
+- внешние устройства (радио, датчики, логи).
+
+## 3. Пины и типы сигналов (MicroLua)
+
+| Тип на пине | Формат | Пример | Использование |
+|---|---|---|---|
+| integer | `0`, `1`, `-100` | `out[2] = 1` (clear) | флаги, адреса, коды |
+| string | UTF-8 | `out[1] = "ls -l"` | тексты, имена файлов, JSON-подобные сообщения шины |
+| color | `"R,G,B"` | `"255,0,128"` | цвет текста на терминале |
+
+**Важно:** строковые сигналы **неэкранированы** по умолчанию. При передаче по шине специализированные символы (`|`, `\n`, `,`) экранируются внутри протокола (см. `02-bus-protocol.md`).
+
+## 4. Физическая топология (схема пинов)
+
+```
+          Терминал 1          IOC1          Терминал 2          IOC2
+          ┌────────┐       ┌────────┐      ┌────────┐       ┌────────┐
+          │экран   │◀──────│out1-3  │      │экран   │◀──────│out1-3  │
+          │ввод    │──────▶│in1     │      │ввод    │──────▶│in1     │
+          └────────┘       └────▲───┘      └────────┘       └────▲───┘
+                                 │                                │
+                                 └──────────────┬─────────────────┘
+                                                │ (однонаправленно)
+                              ┌─────────────────▼─────────────────┐
+                              │              CMC (1)              │
+                              │        центральный CPU            │
+                              └─────────────────▲─────────────────┘
+                                                │ (однонаправленно)
+                              ┌─────────────────▼─────────────────┐
+                              │              MMC (1)              │
+                              │         память + inode-ФС         │
+                              └─────────────────▲─────────────────┘
+                    WE/RD/DATA (однонаправленно)
+               ┌──────────────┬──────────┬─────────────┐
+           ┌───┴───┐      ┌───┴───┐   ┌───┴───┐     ┌───┴───┐
+           │ SEG0  │ ...  │ SEGk  │   │SEG n-1│     │ SEGn  │
+           └───────┘      └───────┘   └───────┘     └───────┘
+```
+
+- Сигналы **только** `in → out` (никаких bidirectional пинов между контроллерами).
+- Каждый терминал имеет свой IOC — отдельная сессия + login/logout.
+- CMC — единственный исполнитель команд (центральный CPU).
+- MMC — единственный доступ к памяти.
+
+См. детальную организацию пинов и протокол в `02-bus-protocol.md`.
+
+## 5. Ограничения и рекомендации по экономии
+
+- Каждый SEG несёт ** overhead сериализации** (`|`, `\n`). Минимизируйте мелкие записи.
+- Храните **метаданные только в SEG0** (системная область).
+- Используйте **агрегированные сообщения шины** (batch) вместо множества мелких пинов.
+- Резервные контроллеры подключайте только когда нужно вынести тяжёлые вычисления.
+
+См. следующие документы для деталей протокола, памяти и ФС.