feat: atxpi — server power & console manager (core, CLI, deploy)

- core/hardware: драйверы real (atxctl/pyserial) + mock, ATXPI_DRIVER
- core/power, console, mock: операции питания и RS232-консоли
- cli/atxpi: status/on/off/reset/cycle/console (stdlib, без deps)
- install.sh: one-shot curl|bash, идемпотентный, хост-агностичный
- deploy: systemd-юнит, шаблон env, update.sh
- README, AGENTS.md: документация и проектные решения
- AGENTS.md и доки очищены от внутренних хостов/адресов (публичный репо)
This commit is contained in:
toros
2026-09-08 21:54:11 +05:00
parent 135b091567
commit 12e6a453de
14 changed files with 657 additions and 0 deletions
+53
View File
@@ -0,0 +1,53 @@
# atxpi
Управляющая плоскость для сервера на базе Raspberry Pi: **питание** (ATX)
+ **RS232-консоль** + статус. Цель — компактный «бедняцкий IPMI».
Проект: репозиторий на внутреннем git-хостинге (ветка `main`). Хост в публичном репо не указываем.
## Состав (в репо)
| Модуль | Назначение |
|---|---|
| `atxctl/` | питание: I2C-expander HAT (кнопки PWRBTN/RESET, статус) — существующий |
| `lcd/` | статусный OLED (52pi, luma.core) — существующий |
| `ups/` | защита от просадки батареи (INA219) — существующий |
| `atxpi/` | **новый** управляющий слой: web-UI + REST + консоль + MCP + CLI |
## Слои `atxpi/`
```
atxpi/
├── core/
│ ├── hardware.py # абстракция + реальные драйверы (atxctl subprocess, pyserial)
│ ├── mock.py # фейки для разработки без железа (ATXPI_DRIVER=mock)
│ ├── power.py # высокоуровневые операции питания
│ └── console.py # высокоуровневые операции консоли
├── cli/
│ └── atxpi # CLI: status/on/off/reset/cycle/console
├── webui/ # (далее) FastAPI: REST + WebSocket-консоль + статика
├── mcp/ # (далее) MCP-сервер (stdio) для агентов
├── deploy/ # (далее) systemd-юниты + setup.sh
└── README.md
```
## CLI (шаг ① — готово, без внешних зависимостей)
```bash
cd atxpi
export ATXPI_DRIVER=mock # mock: без железа; по умолчанию real
./cli/atxpi status
./cli/atxpi on | off | reset | cycle
./cli/atxpi console --cmd "uptime" --read
```
## Драйверы
- `ATXPI_DRIVER=real` (по умолчанию): питание через `atxctl/main.py`,
консоль через `pyserial` на `SERIAL_PORT` (по умолчанию `/dev/ttyUSB0`, 115200).
- `ATXPI_DRIVER=mock`: фейковое питание (состояние в `atxpi/tmp/`) и консоль-эхо.
## Жёсткие требования
- Работает на **Raspberry Pi 2B** (armv7, 1 ГБ) — без node/тяжёлых БД.
- Никаких реальных проверок питания на «живых» серверах — только стенд.