Skip to content
WhoSowSeePublic

About

A modern Rust rewrite of the classic КР580ВМ80А desktop emulator

Topics

Resources

Contributing

Stars

7 stars

Watchers

2 watching

Forks

Repository files navigation

Логотип KR580

CONTRIBUTORS FORKS STARS

CRATES.IO DOWNLOADS

Настольный эмулятор КР580 на Rust

Скриншот эмулятора KR580

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-окна.

Установка из crates.io

cargo install kr580

Этот вариант рассчитан на опубликованный релиз в crates.io. Пока пакет не опубликован, используй сборку из исходников или standalone-установщик.

Установка на NixOS

nix run github:WhoSowSee/KR580
nix profile install github:WhoSowSee/KR580

NixOS-пакет ставит готовые kr580 и kr, desktop entry, иконки и MIME-типы .580 / .krs напрямую через Nix store. Standalone-установщик для этого сценария не используется.

Fedora и Arch Linux

Скачайте подходящий пакет из 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 kr580

Сборка GUI и launcher

cargo 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.ps1

Linux/Unix:

bash scripts/build_installer.sh

macOS (готовое приложение в DMG):

bash scripts/build_macos_dmg.sh

Snap (из корня репозитория на 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.

Структура workspace

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 package

just показывает доступные команды, 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, форматам файлов, сборке и проверкам собрана в указателе документации.

История звёзд

История звёзд KR580

catppuccin

© 2026-present WhoSowSee

LICENSE

About

A modern Rust rewrite of the classic КР580ВМ80А desktop emulator

Topics

Resources

Contributing

Stars

7 stars

Watchers

2 watching

Forks

Releases

Contributors

Languages