Tip
English version: README-EN.md
KR580 – современный настольный эмулятор системы на КР580 / Intel 8080. Внутри – детерминированное ядро CPU, типизированные внешние устройства через I/O-порты и нативный многооконный интерфейс.
Проект сделан для наблюдаемого выполнения программ: можно редактировать ОЗУ и регистры, идти по командам или тактам, видеть живое обновление панелей управления, открывать окна внешних устройств, сохранять снимки и экспортировать состояние без чтения данных из UI-виджетов.
Note
Возможности KR580:
- Детерминированное состояние КР580 / Intel 8080: регистры, флаги,
PC,SP, 64 КиБ ОЗУ, прерывания,HLT, счётчики циклов и тактовая фаза. - Выполнение документированных 8080-опкодов с тестами семейств команд, флагов, условных переходов, стека, прерываний и маршрутизации I/O.
- Пошаговое выполнение по команде, выполнение по такту, регулируемый запуск и быстрый burst-режим.
- Нативный iced-интерфейс: список ОЗУ, редактор регистров, регистр состояния, схема машинных циклов, панель управления и локализованный установщик.
- Окна внешних устройств: монитор, дисковод, жёсткий диск, сетевой адаптер и принтер.
- Совместимые с оригинальным KP580
.580-образы, загрузка сырых.krs-подпрограмм, прямой импорт/экспорт.txt/.xlsxи нативная системная печать с параметрами драйвера. - Графический установщик, деинсталлятор, терминальный launcher, опциональные ассоциации
.580и.krsи portable/system-режимы установки.
Монитор
Дисковод · Жёсткий диск
Сетевой адаптер · Принтер
IoBus направляет младший байт адреса I/O-порта в пять моделируемых устройств:
| Порт | Устройство | Что делает |
|---|---|---|
00h |
Монитор | Текстовый framebuffer 64×20 и графический слой 256×256. |
01h |
Дисковод | Файловое или debug-buffer хранилище с окном просмотра. |
02h |
HDD | Append-backed hdd.kpd и отдельный просмотр принятого буфера. |
03h |
Сетевой адаптер | TCP client/server worker, RX/TX-счётчики и явное состояние соединения. |
04h |
Принтер | CP866 spool, буфер вывода и асинхронная системная печать. |
Операции устройств возвращают типизированные статусы и ошибки. CPU обращается к ним только через IN / OUT, поэтому состояние эмулятора остаётся сериализуемым и тестируемым.
- Rust
1.88.0или новее для сборки из исходников. - Desktop-окружение, способное запускать нативные iced-окна.
cargo install kr580Этот вариант рассчитан на опубликованный релиз в crates.io. Пока пакет не опубликован, используй сборку из исходников или standalone-установщик.
nix run github:WhoSowSee/KR580
nix profile install github:WhoSowSee/KR580NixOS-пакет ставит готовые kr580 и kr, desktop entry, иконки и MIME-типы .580 / .krs напрямую через Nix store. Standalone-установщик для этого сценария не используется.
Скачайте подходящий пакет из GitHub Releases
и замените <version> в команде на версию файла:
sudo dnf install "./KR580-<version>-x86_64-unknown-linux-gnu.rpm"На Arch Linux обновите систему и установите пакет:
sudo pacman -Syu
sudo pacman -U "./KR580-<version>-x86_64-unknown-linux-gnu.pkg.tar.zst"RPM доступен для x86_64 и aarch64, Arch-пакет — для x86_64. Требуется glibc 2.39 или новее. Подробности: RPM и Arch Linux.
git clone https://github.com/WhoSowSee/KR580.git
cd KR580
cargo run -p kr580cargo build --release -p kr580 --bin kr580 --bin krГотовые бинарники появятся в target/release/ как kr580 / kr или kr580.exe / kr.exe.
Windows:
powershell -NoProfile -ExecutionPolicy Bypass -File scripts/build_installer.ps1Linux/Unix:
bash scripts/build_installer.shmacOS (готовое приложение в DMG):
bash scripts/build_macos_dmg.shSnap (из корня репозитория на Linux):
snapcraft pack --use-lxdСкрипты записывают пакеты в dist/, а Snapcraft создаёт .snap в корне
репозитория.
# Запуск эмулятора из исходников
cargo run -p kr580
# Открыть snapshot или подпрограмму через launcher
cargo run -p kr580 --bin kr -- path/to/program.580
# Показать справку launcher
cargo run -p kr580 --bin kr -- --helpПосле установки kr может открывать .580-снимки и .krs-подпрограммы из терминала и регистрировать или удалять их ассоциации там, где это поддерживает платформа.
| Формат | Назначение |
|---|---|
.580 |
Фиксированный 65,549-байтный образ RAM, регистров, PC и SP оригинального KP580. |
.krs |
Сырые байты подпрограммы, загружаемые по указанному базовому адресу. |
.txt |
Текстовый экспорт регистров, флагов и памяти; также поддерживается импорт. |
.xlsx |
Импорт/экспорт workbook через rust_xlsxwriter и calamine. |
| Crate | Ответственность |
|---|---|
k580-core |
Публичное ядро CPU: state, opcode decode/execute, timing, interrupts и PortBus. |
kr580 |
Публичный installable crate: desktop UI, launcher, installer, uninstaller, platform shims и внутренние modules backend, devices, persistence. |
В корне есть justfile с командами разработки. Нужен
just версии 1.56.0 или новее
(cargo install just --locked), а на Windows также PowerShell 7.4+
с pwsh.exe в PATH.
just
just check-all
just run --help
just build
just packagejust показывает доступные команды, just check-all проверяет форматирование
justfile и Rust, запускает Clippy и тесты workspace, затем собирает release GUI
и launcher. just package выбирает Windows setup, Linux setup или macOS DMG,
а just icons перегенерирует иконки после изменения исходных изображений.
Подробности и передача аргументов описаны в
документации по проверкам.
Прямые команды Cargo также доступны:
cargo fmt --all
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspaceПравила участия и оформления issue/PR описаны в CONTRIBUTING.md. Для изменений с помощью AI действует AI Policy.
Техническая справка по архитектуре, CPU, устройствам, UI, форматам файлов, сборке и проверкам собрана в указателе документации.
© 2026-present WhoSowSee