Skip to content

About

Эмулятор советского персонального компьютера БК-0010-01 (процессор К1801ВМ1, клон PDP-11) на C++17 / Qt6 / OpenGL с отладчиком и профилятором.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

205 Commits

Folders and files

Repository files navigation

Эмулятор-отладчик БК-0010-01 / БК-0011М

Эмулятор советских персональных компьютеров БК-0010-01 и БК-0011М (процессор К1801ВМ1, клон PDP-11) на C++17 / Qt6 / OpenGL с отладчиком в стиле Soft-ICE.

debugger

Возможности

  • Процессор К1801ВМ1 — полный набор инструкций PDP-11 (+ SOB, XOR), точный расчёт флагов N/Z/V/C, все 8 режимов адресации, прерывания и векторы.
  • Три машины: БК-0010 1985 года (Фокал и тесты МСТД в ПЗУ, плёночная клавиатура), БК-0010-01 (Бейсик) и БК-0011М (4 МГц, 128 Кбайт страничного ОЗУ, БОС, 16 палитр со сменой по ходу луча, звуковой сопроцессор AY-3-8910) — меню «Машина» или ключ --machine. Экранная клавиатура — плёночная БК-0010 или кнопочная БК-0010-01.
  • Экран через OpenGL (QOpenGLWidget): режимы 256×256 (4 цвета) и 512×256 (ч/б), палитры БК-0010, вертикальный скролл. Переключение — F11. Пиксель БК не квадратный — кадр ложился на телевизионное поле 4:3, — поэтому по умолчанию пиксель цветного режима рисуется блоком 4×3 точек, то есть кадр 1024×768. Масштаб в обоих режимах целый (1024×768, 2048×1536… и 1024×512, 2048×1024…), остаток окна остаётся чёрными полями. Переключение на квадратные пиксели — Ctrl+F11 или --no-aspect34.
  • GigaScreen: программа, которая каждый кадр меняет экранную страницу или палитру (на БК-0011М так получают цвета сверх палитры), на ЭЛТ видна смесью цветов, а на мониторе ПК мерцала бы. Точка, цвет которой идёт через кадр, показывается смесью двух её цветов (в линейном свете, как их складывает глаз); всё остальное, в том числе движение, — как есть. Действует на окно, запись видео, --shot и MCP; галка в меню «Эмуляция», ключ --no-gigascreen.
  • Загрузка и исполнение .BIN (игр) с автозагрузкой ПЗУ-монитора.
  • Мышь «Марсианка» (УВК-01) на порту 0177714 от мыши ПК — опция в меню «Машина» (--mouse, MCP bk_mouse): движение над экраном БК — шаги шара, средняя кнопка — захват.
  • Магнитофон: кассеты .WAV — записи с ленты и вывод конвертеров .BIN → .WAV (bkbin2wav, веб-конвертер thesands.ru, включая турбо-загрузчик Maxim). Кассета грузится сразу, как .BIN (игра.wav, игра.wav#N), или играет в магнитофоне: сигнал идёт в разряд 5 0177716, файлы читает сам драйвер ПЗУ или свой загрузчик программы. Подробности — docs/tape.md.
  • Контроллер AZБК (MAXIOL) на обеих машинах: маппер 32 Мбайт, VGA 1024×768 со слоями и палитрой, блиттер, два AY, Covox, DMA-звук, диски с «карты SD», сетевая карта (DHCP, NTP, ping, HTTP, сетевые диски landisk, облако HOF — через tap/macvtap хоста) — прошивка 00019 (roms/azbk) грузит BIOS и ANDOS/CSIDOS. Ключ --az, меню «Машина» → «Контроллер AZБК».
  • Клавиатура БК-0010: когда отладчик выключен, ввод с клавиатуры хоста идёт в БК (коды КОИ-7). Латиница/цифры/пунктуация, кириллица (КОИ-7 Н1), спец-клавиши (стрелки, ВВОД, ЗАБ, ВС, СБР, функциональные), СУ(Ctrl)+буква → управляющий код, АР2 = Alt: Alt+клавиша даёт её код с битом 0200 через вектор 0274 (Alt+; — 32/64 символа, Alt+! — красный цвет, Alt+Delete — режим РП; Alt+Shift — АР2+РУС/ЛАТ). Пока работает БК, Alt не открывает меню; РУС/ЛАТ переключается автоматически при смене языка ввода, а также вручную клавишами левый Shift (РУС) и правый Shift (ЛАТ) — их же игры часто используют как «выстрел влево/вправо» (Shift, а не Ctrl, чтобы не мешать Ctrl-шорткатам приложения). Прерывание клавиатуры (векторы 060 / 0274); кадровое прерывание (вектор 0100) — только у БК-0011М: у БК-0010 вектор 0100 — прерывание от внешнего устройства (контакт B1 разъёма УП, A5 МПИ).
  • Звук — пищалка, AY и Covox смешиваются в ядре (Speaker) в стерео: AY по схеме ABC платы «Мультизвук» (A — влево, B — в оба вполовину, C — вправо, перетекание −21 дБ, ФНЧ 7,5 кГц), Covox — стерео или моно по автоопределению «Мультизвука»; воспроизведение через QAudioSink (при наличии Qt6 Multimedia). Отключение звука — Ctrl+M.
  • Память по страницам — шестнадцатеричный дамп страниц, не подключённых в адресное пространство: «Память БК по страницам» (Ctrl+P; у БК-0011М — 8 страниц ОЗУ и ПЗУ, у каждой строки — адрес БК, по которому она видна сейчас, слежение за окном 0/1 или экраном) и «ДОЗУ СМК-512 по страницам» (Ctrl+D); правка слов на месте.
  • Запись видео экрана со звуком — меню «Видео» (Ctrl+F5) или --video файл.avi|.mp4: кадр видео — кадр БК, частота точно 48,828125 Гц (3125/64), время эмулируемое (пауза в файл не попадает); стереозвук (пищалка, AY, Covox) — кусок на кадр, без расхождения с картинкой. Кодек выбирается в настройках: ZMBV + PCM в AVI (кодек записи экрана DOSBox, без потерь; кадр 1024×768 — точка БК 2×3, как в окне — или 512×256) или H.264 + AAC в MP4 — формат, который Telegram и телефоны показывают сразу (нужна сборка с FFmpeg). Подробности — docs/video.md.
  • Отладчик Soft-ICE (F12) — отдельное окно рядом с экраном БК: регистры/PSW, дизассемблер с подсветкой PC и точками останова, дамп памяти, стек. Открывается по F12 и на точке останова; F12 в отладчике продолжает выполнение, оставляя окно открытым (оно показывает живые регистры, память и стек; следующий F12 снова останавливает), Esc или крестик — продолжают и закрывают окно. Место и размер окна запоминаются. Пошаговая отладка с одновременным показом экрана БК: шаг, шаг с обходом, до курсора, до выхода из процедуры.
  • Визуализация памяти — графический вид памяти 1/2/4/8/16 бит на пиксель, ч/б и цвет (по умолчанию «2 бита» — палитра БК: экранное ОЗУ выглядит как сама картинка), с тепловой картой обращений: давно не используемая память показывает своё содержимое ярко, а свежий доступ вспыхивает цветом и плавно затухает — чтение зелёным, запись красным, исполнение кода синим. По умолчанию во всё окно показывается только ОЗУ; флажок «Показать ПЗУ» добавляет ПЗУ (весь адресный диапазон в более мелком масштабе). На БК-0011М источник по умолчанию — вся память машины: все 8 страниц ОЗУ (с флажком «Показать ПЗУ» — и все ПЗУ-слоты), с подписями, какая страница сейчас в каком окне и какая экранная; можно выбрать и одну страницу. Так же — ДОЗУ платы СМК-512. Рисование мышью по показанной памяти (флажок «Рисовать мышью», по умолчанию выключен) — только с зажатым Ctrl: левая кнопка пишет в точки выбранное значение (столько бит, сколько в точке при текущем режиме), правая — 0. Точка окна, в которую свёрнуто несколько строк памяти, перекрашивается во всех; ПЗУ и регистры не меняются.
  • Горячий путь — самые исполняемые цепочки базовых блоков (пути), связанные наиболее частыми переходами, отсортированные по доле времени CPU (топ-N). Каждый путь свёрнут в строку-сводку (ранг, вход, число блоков, %, тепловая полоса); левый клик по треугольнику ▸ разворачивает путь в его блоки (с переходами → адрес), а блок — в ассемблерные инструкции со счётчиками исполнений. Клик по телу строки ведёт дизассемблер на адрес. Правый клик скрывает адрес (напр. цикл-пустышку), 0 — показать всё, +/− — число путей. Прокрутка — колесо / перетаскивание. Строки подкрашены по «температуре» (частоте исполнения).
  • Пламенный граф (Ctrl+F) — flame graph по восстановленному дереву вызовов: каждый прямоугольник — кадр стека, ширина ∝ времени CPU (inclusive), вниз = глубже по стеку (корень/main вверху). Стек восстанавливается на лету по JSR/возвратам (и прерываниям). Клик — углубиться в поддерево, ПКМ/ Backspace — вверх, 0 — весь граф, Del — сброс; клик ведёт дизассемблер на подпрограмму, наведение показывает собств./вкл. долю.
  • Хронология вызовов (Ctrl+T) — времяупорядоченный flame chart (как в Chrome DevTools/speedscope): X = время CPU, Y = глубина стека, каждый бар — один вызов подпрограммы на всём протяжении, пока он был на стеке. Правый край — «сейчас». Колесо — зум времени, тащить — прокрутка по глубине, клик — в дизассемблер.
  • Все окна профилировщика связаны общей подсветкой (наведение на подпрограмму подсвечивает её во всех окнах и в дизассемблере). У «Горячих инструкций во времени» дополнительно: G — агрегация по подпрограммам, S — стопка (streamgraph), F — маркеры кадров по таймеру, колесо над графиком — зум по времени.
  • Сохранение/восстановление полного состояния (Ctrl+S / Ctrl+L).

Сборка

Зависимости

Обязательно: CMake ≥ 3.16, компилятор C++17, Qt 6 (Core, Gui, Widgets, OpenGLWidgets) с заголовками (dev-пакеты), OpenGL, zlib (сжатие видео ZMBV). Опционально: Qt 6 Multimedia — без него эмулятор собирается, но без звука; FFmpeg (libavcodec, libavformat, libavutil, libswscale с libx264) — запись видео в MP4 для Telegram, без него остаётся AVI.

Fedora / RHEL:

sudo dnf install cmake gcc-c++ qt6-qtbase-devel qt6-qtmultimedia-devel mesa-libGL-devel zlib-devel
sudo dnf install ffmpeg-devel      # MP4; из RPM Fusion — в ffmpeg-free нет libx264

Debian / Ubuntu (22.04+):

sudo apt install cmake g++ qt6-base-dev libgl1-mesa-dev qt6-multimedia-dev zlib1g-dev \
                 libavcodec-dev libavformat-dev libswscale-dev

Если CMake не находит Qt6OpenGLWidgets, доустановите libqt6opengl6-dev.

Arch / Manjaro:

sudo pacman -S cmake base-devel qt6-base qt6-multimedia

openSUSE:

sudo zypper install cmake gcc-c++ qt6-base-devel qt6-opengl-devel qt6-multimedia-devel zlib-devel

macOS (Homebrew):

brew install cmake qt@6
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH="$(brew --prefix qt@6)"

Windows (или Qt из официального онлайн-установщика) — укажите путь к комплекту Qt:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=C:/Qt/6.x.y/msvc2022_64

Ошибка Could not find a package configuration file provided by "Qt6" (Qt6Config.cmake) означает, что dev-пакеты Qt 6 не установлены или CMake не знает, где они лежат. Установите пакеты из списка выше или передайте -DCMAKE_PREFIX_PATH=<каталог Qt>, затем удалите старый каталог build/ (в его кэше остаётся Qt6_DIR-NOTFOUND) и запустите cmake заново.

Команды сборки

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j

Запуск

./build/bk0010-emulator [путь/к/игре.bin]
./build/bk0010-emulator [путь/к/дискете.bkd|.img]   # сразу грузится с дискеты

Все ключи с пояснениями печатает ./build/bk0010-emulator --help (или -h).

Позиционный аргумент распознаётся по расширению: .bkd и .img (в любом регистре) — это образ дискеты, всё остальное — игра в формате .BIN.

ПЗУ (monit10.rom, basic10.rom; для БК-0010 — bk10_018_focal.rom и bk10_019_mstd.rom; для БК-0011М — bk11m_324_bos.rom, bk11m_325_ext.rom, bk11m_327_basic1.rom, bk11m_328_basic2.rom, bk11m_329_basic3.rom, bk11m_330_mstd.rom) ищутся в каталоге roms/ (задаётся при сборке, переопределяется --roms <dir> или переменной BK_ROM_DIR).

БК-0010 (Фокал, плёночная клавиатура)

Исходная машина 1985 года: то же железо, что у БК-0010-01, но в розетках ПЗУ вместо Бейсика — Фокал (БИС 018, 0120000) и тесты МСТД (019, 0160000), розетка 0140000 пуста (чтение — зависание). Включается в меню «Машина», ключом --machine bk10f (--bk10f, --machine bk0010) или bk_reset {"machine":"bk10f"}; плата СМК-512 у неё по умолчанию снята. После включения монитор передаёт управление Фокалу: ?00 AT 0.00, ГОТОВНОСТЬ К РАБОТЕ, приглашение *. PASS TEST — тест-монитор МСТД (приглашение +). Те же ПЗУ получает БК-0010-01 с блоком МСТД (--mstd).

Клавиатура — плёночная: та же матрица ВП1-014, но с лишними клавишами ГРАФ, ЗАП, СТИР, УСТ ТАБ, СБР ТАБ, ГТ, диагональными стрелками и «НР» вместо «АР2». Их коды — в таблице «Клавиатура БК» ниже, все они есть и в «Экранной клавиатуре БК» (меню «Эмуляция»): у БК-0010 она плёночная, у остальных — кнопочная БК-0010-01. Мышью нажимаются и модификаторы: СУ, НР/АР2 и ПР действуют на одну следующую клавишу, ЗАГЛ/СТР — фиксация регистра букв. Подробности — docs/bk0010.md.

БК-0011М

Машина выбирается в меню «Машина» (выбор запоминается между запусками), ключом --machine auto|bk10|bk10f|bk11m (--bk10, --bk10f, --bk11m) на один запуск или аргументом machine MCP bk_machine/bk_reset. Режимы:

  • «Автоматически — по программе» (auto, по умолчанию): программу .BIN (в командной строке, в меню «Файл», в MCP bk_load) машину выбирает она сама — пишет в регистр 0177662 (палитра и экран 11М) или зовёт БОС (EMT с нечётным номером) — БК-0011М, иначе БК-0010-01. Без программы, а также с дискетой или винчестером, — БК-0011М со звуковым сопроцессором AY. В меню видно, какая машина работает сейчас; переход в этот режим перезагружает уже загруженную программу на её машину.
  • БК-0010 (bk10f), БК-0010-01 (bk10) и БК-0011М (bk11m): работает только эта машина, программа не проверяется — .BIN грузится в неё, какой бы она ни была. БК-0010 авто-режим не выбирает никогда: по программе её от БК-0010-01 не отличить. На БК-0011М .BIN грузится так же, как командами монитора БОС «L», «R6/1000», «G». БК-0011М — это 4 МГц, 128 Кбайт ОЗУ страницами по 16 Кбайт (регистр 0177716 с битом 11), ПЗУ БОС и БЕЙСИКа, два экранных буфера и 16 палитр (регистр 0177662), кадровое прерывание 0100 с запретом. Экран рисуется по ходу луча: смена палитры или экранного буфера посреди кадра и даже посреди строки видна там, где её сделала программа (демо INSULT, DENON). Образ диска грузит сам БОС:
./build/bk0010-emulator --machine bk11m '/путь/INSULT.IMG'

Звуковой сопроцессор AY-3-8910 / YM2149 на порту 0177714 (слово — номер регистра, байт — данные) включён по умолчанию на БК-0011М; галка в меню «Машина», ключи --ay / --no-ay. Там же второй AY — плата «2AY» с выбором чипа и по TurboSound, и по «Грифону» (--2ay / --no-2ay), и Covox — ЦАП на том же порту (--covox / --no-covox); на БК-0011М по умолчанию включены оба, на БК-0010-01 — нет. Как они уживаются на одном порту — в docs/sound.md. На БК-0011М --no-scanline выключает отрисовку по лучу, --mstd вставляет тестовый блок МСТД, --smk — блок расширения памяти СМК-512 (работает и на БК-0011М). Подробности и сверка тактов с замерами — в docs/bk0011m.md.

Ключи --aspect34 / --no-aspect34 задают пропорции пикселей на один запуск (в окне; сохранённую настройку переключателя Ctrl+F11 они не перезаписывают). Включение пропорций 3:4 подращивает окно, если ему не хватает высоты на целый кадр. На безголовый режим ключи не влияют: --shot пишет буфер как есть, 512×256. При дробном масштабировании рабочего стола (125 %, 150 %) кратность считается в физических точках экрана, поэтому картинка может оказаться заметно меньше окна.

Мышь «Марсианка»

Шаровой манипулятор УВК-01 (МОКБ «Марс») на параллельном порту 0177714. Включается в меню «Машина → Мышь «Марсианка»» (настройка запоминается), ключом --mouse или в MCP bk_mouse {"enable": true}, по умолчанию выключен. Источник — мышь ПК над экраном БК:

  • движение даёт шаги шара. Сколько точек экрана ПК приходится на шаг, задаётся в меню отдельно по горизонтали и по вертикали (по умолчанию 8 и 3). Шар у «Марсианки» один на обе оси, но программы двигают курсор по-разному: CSI-DOS за шаг сдвигает его на байт экрана по горизонтали и на две строки по вертикали, Chess Club — на два байта и на четыре строки. В окне ПК вертикальный шаг у обеих в 2,7 раза короче горизонтального, значения по умолчанию это выравнивают. У MANIAC отношение 2,1, с ними вертикаль идёт на четверть быстрее;
  • левая и правая кнопки — кнопки манипулятора;
  • средняя кнопка захватывает мышь: курсор прячется, и движение не упирается в край окна; ещё раз средняя кнопка, отладчик или переход в другое окно её отпускают.

На порту, как у джойстика (линии складываются по ИЛИ):

Разряд 001 002 004 010 040 0100
Сигнал вверх вправо вниз влево левая кнопка правая кнопка

Флаги направления — триггеры манипулятора. Программа читает порт и сбрасывает триггеры спадом разряда 3 записи в 0177714 («СБРОС», выход ВД03), например: MOV @#177714,R2 / CLR @#177714 / MOV #10,@#177714 в CSI-DOS. За такой опрос расходуется шаг по каждой оси. Если программа «СБРОС» не даёт и читает мышь как джойстик (MANIAC), шаг тратится кадром позже чтения, в котором она его увидела: при опросе раз в 2–3 кадра шаги не теряются. Программа, хоть раз давшая «СБРОС», шагов без него не теряет. Проверено на CSI-DOS 3 (курсор ходит за мышью, щелчок левой кнопкой нажимает кнопки диалога), Chess Club (рука) и MANIAC (перекрестие): каждый шаг сдвигает курсор.

Магнитофон (кассеты .WAV)

bk0010-emulator игра.wav грузит программу с кассеты сразу, как .BIN. Декодер читает сигнал так же, как драйвер EMT 36 монитора, турбо-поток Maxim тоже. игра.wav#N берёт N-й файл ленты, --wav2bin игра.wav показывает оглавление и сохраняет файлы в .BIN. Кассета остаётся в магнитофоне за загруженным файлом.

--tape игра.wav и меню «Магнитофон» вставляют кассету, ничего не загружая. Файлы читает драйвер ПЗУ, как на живой машине: на БК-0010-01 MON, М, имя, затем С; на БК-0011М в мониторе БОС L, ВВОД, затем G. Лента трогается сама, когда драйвер начинает чтение (автопуск), и встаёт, когда он выключает двигатель. «Воспроизведение» (--tape-play) нужно только своим загрузчикам. Пока лента идёт, GUI ускоряет эмуляцию. Пока кассета вставлена, EMT 36 не перехватывается; «Извлечь кассету» возвращает загрузку файлов хоста. Окно «Оглавление кассеты» показывает файлы, адреса, КС и время, а также умеет загрузить файл, поставить на него ленту и сохранить его как .BIN. Подробности — docs/tape.md.

Дисковод и загрузка с образа диска

Эмулируется контроллер НГМД в разъёме МПИ — микросхема 1801ВП1-128 и ПЗУ драйвера 326 (roms/disk326.rom), то есть штатная дисковая конфигурация БК-0010-01. Образ — сырой дамп секторов 800 Кбайт (80×2×10×512), расширения .bkd и .img в любом регистре. Вставить и загрузиться: «Файл» → «Вставить образ диска…» (Ctrl+B), позиционным аргументом или ключом --disk <образ> (--disk-b — второй привод, --disk-rw снимает защиту записи — изменённый образ пишется обратно в файл при выходе и перед сменой дискеты, --disk-sides 1|2 задаёт геометрию). Дисковод работает вместе с блоком расширения памяти СМК-512, и многим системам это необходимо: у голой БК-0010-01 под ядро остаётся около 16 Кбайт ОЗУ. Плата стоит по умолчанию, а если в GUI её сняли, вставленная дискета включает её сама (на один запуск, сохранённую настройку не меняет); --no-smk это отменяет. Проверено на BKUNIX и на игре BK3D. Подробности — в docs/floppy.md.

Блок расширения памяти СМК-512

Эмулируется контроллер СМК-512 («АльтПро») в разъёме МПИ — 512 Кбайт дополнительного ОЗУ: 16 страниц по 32 Кбайт, восемь режимов подключения, регистр управления 0177130. По умолчанию плата установлена. Снимается в меню «Машина» (настройка запоминается между запусками) или ключом --no-smk; --smk включает. На БК-0010-01 плата накрывает ПЗУ Бейсика 0120000–0157777, и программы, которые вызывают оттуда подпрограммы (например, tetr-music), с ней падают — как на живой машине; их запускают с --no-smk; на БК-0010-01 и БК-0011М настройка своя. С установленной платой отладчик показывает текущий режим и номер страницы в панели «СИСТ. РЕГИСТРЫ», по Ctrl+D открывается дамп всех 512 Кбайт ДОЗУ постранично (с адресом БК, по которому строка видна сейчас, и правкой слов по клику), а в визуализаторе памяти появляется выбор источника — память БК, все 16 страниц ДОЗУ или одна. Дисковод и прошивка платы описаны в docs/floppy.md, подробности о самой плате — в docs/smk512.md.

Контроллер AZБК

Плата AZБК (MAXIOL) в разъёме МПИ — всё, что видит программа: маппер на 32 Мбайт (16 окон по 4 Кбайт, перевод записей 0177716 и 0177130 — эмуляция карты БК-0011М и СМК-512), VGA 1024×768 с тремя слоями, палитрой на 32768 цветов и блиттером, два AY, Covox 16 бит, DMA-звук с IMA ADPCM, контроллер дисков (образы с «карты SD»), EEPROM, часы, ГПСЧ и сетевая карта ENC28J60 со стеком TCP/IP прошивки. Работает на БК-0011М и БК-0010-01 (--az-037 — доработка 037, эмуляция БК-0011М на БК-0010; --no-az-nomon — БК-0011М без доработки монитора, со своим ПЗУ БОС). Карта SD по умолчанию — roms/azbk: прошивка 00019 без образов дисков; свою задаёт --az-sd, диск — --az-unit 0=<образ> (или образ позиционным аргументом при --az). Машина стартует с AZBOOT, показывает BIOS и грузится с AZ0. В GUI — «Машина» → «Контроллер AZБК» (карта SD, диск AZ0, доработка 037, сеть), Ctrl+E — экран VGA платы или самой БК, Ctrl+J — память платы по страницам. Подробности — в docs/azbk.md.

Сеть: плата выходит в сеть хоста отдельным под-интерфейсом — macvtap на физической карте (свой MAC из MAC= в [NETWORK] файла AZ.INI, адрес от DHCP локальной сети) или tap. Интерфейс один раз создаёт tools/azbk-net.sh (через sudo), дальше эмулятору права не нужны. DHCP, постоянный адрес, MAC и имя меняются в Setup платы (КТ на экране BIOS → Network), как на настоящей.

./build/bk0010-emulator --az --az-unit 0=ANDOS330.IMG
tools/azbk-net.sh macvtap enp3s0                 # один раз: под-интерфейс azbk0
./build/bk0010-emulator --az --az-net macvtap:azbk0

Винчестер (образы HDI)

Два контроллера винчестера IDE (master и slave) с образами в формате HDI эмулятора GID — побайтовый образ диска, перед которым дописан паспорт накопителя (ответ на IDENTIFY): канал платы СМК-512 (регистры 0177740–0177757, прошивка smk512.rom) и самарский контроллер Лугова для БК-0011М (0177620–0177656, драйвер в прошивке КНГМД samara.rom). Образ .hdi в командной строке (или --hdd, --hdd-b для второго, --hdd-rw — писать в файл) подключает винчестер и загружается с него; контроллер выбирается по разметке образа или ключом --hdd-ctl smk|samara. В GUI — «Файл» → «Подключить винчестер (HDI)…» и «Контроллер винчестера». bk_io_state показывает логические диски по разметке. Проверено на БК-0010-01 и БК-0011М: MKDOS и ANDOS 3.30 грузятся с винчестера СМК, CSIDOS — с «Самары». Подробности — в docs/hdd.md.

Эмуляция арбитража видеоконтроллера КР1801ВП1-037: доступ процессора к ОЗУ квантован окном, которое 037 открывает раз в 4 такта, а время команды в ДОЗУ считается по расписанию обменов процессора К1801ВМ1, снятому с его RTL-модели, — с учётом соседних команд (ранняя предвыборка). Включено по умолчанию и сверено с тестами XOP2/XOP2N на реальной БК-0010-01. Фазу такта процессора относительно окна железо выбирает случайно при включении питания, и от неё зависит таблица времён команд; ключ --cpu-phase 0|1 выбирает её (по умолчанию 0: MOV (R0),R1 = 28 тактов).

У ОЗУ платы СМК-512 арбитража нет, и тайминги там свои — заметно быстрее и не кратные четырём (MOV R1,R2 — 8 тактов против 12). Для него есть вторая таблица, снятая с реальной платы; команда, у которой часть обменов идёт в ДОЗУ БК, а часть в ОЗУ платы, считается между ними. Ключ --no-arb037 отключает обе поправки — это «идеальная» память, которой нет ни у одной реальной машины. Подробности — в docs/slow-memory-timing.md.

Горячие клавиши

Клавиша Действие
F12 Остановить в отладчике Soft-ICE / продолжить, не закрывая его окна
F11 Переключить режим экрана (цвет ↔ ч/б)
Ctrl+F11 Пропорции пикселей: 3:4 (блок 4×3) ↔ квадратные
Esc В отладчике — продолжить выполнение и закрыть окно отладчика
F7 В отладчике — шаг с заходом (step into)
F8 В отладчике — шаг с обходом (step over)
Shift+F8 В отладчике — до выхода из процедуры (step out): RTS/RTI/RTT, остановка на адресе возврата; то же в меню «Отладка»
F9 В отладчике — точка останова на строке под курсором (вкл/выкл)
F4 В отладчике — выполнить до курсора
G В отладчике — переход к адресу или символу
↑/↓, PgUp/PgDn, [/] В отладчике — курсор, листать код, листать память (колесо — панель под мышью)
Enter, ←/→, X В отладчике — к цели перехода, назад/вперёд по истории, кто ссылается на строку
N, ; В отладчике — имя, комментарий строки под курсором
B/W/S/P, U В отладчике — пометить данными (байт/слово/строка/указатель), снова код
мышь В отладчике — ЛКМ по строке: выбрать, по адресу: переход; ПКМ: точка останова; ЛКМ по регистру/стеку/памяти: правка
Ctrl+R Сброс
Ctrl+M Включить/выключить звук
Ctrl+F5 Начать/остановить запись видео
Ctrl+G Горячий путь
Ctrl+K Граф вызовов
Ctrl+F Пламенный граф
Ctrl+T Хронология вызовов (flame chart)
Ctrl+H Горячие инструкции во времени
Ctrl+I Визуализация памяти
Ctrl+D ДОЗУ СМК-512 по страницам
Ctrl+P Память БК по страницам (ОЗУ и ПЗУ, у БК-0011М — все 8 страниц)
Ctrl+J Память платы AZБК по страницам
Ctrl+E С AZБК: экран VGA платы ↔ экран самой БК
Ctrl+B Вставить образ диска и загрузиться
Ctrl+S/Ctrl+L Сохранить / восстановить состояние

Меню Отладка открывает окна профилировщика (горячий путь, граф вызовов, пламенный граф, горячие во времени), визуализации памяти и дампа ДОЗУ СМК-512.

Клавиатура БК

Когда отладчик выключен, буквы, цифры и знаки передаются как есть, а специальные клавиши БК соответствуют таким клавишам ПК (коды в восьмеричной системе):

Клавиша ПК Клавиша БК Код
Enter ВВОД 012
Backspace ЗАБ 030
Tab ТАБ 0211
Home ВС 023
Delete СБР 014
F1 ПОВТ 0201
F2 КТ 003
F3 =|=> 0213
F4 |<== 026
F5 |==> 027
F6 ИНД СУ 0202
F7 БЛОК РЕД 0204
F8 ШАГ 0200
F9 СБР 014
Insert ГРАФ 0205
PgUp / PgDn ЗАП / СТИР 0206 / 0207
End ГТ 024
Ctrl+Tab / Ctrl+Delete УСТ ТАБ / СБР ТАБ 015 / 020
цифровой блок без NumLock: 7 9 1 3 ↖ ↗ ↙ ↘ 034 / 035 / 037 / 036
цифровой блок без NumLock: 5 ⇱ (курсор в начало экрана) 022
← → ↑ ↓ стрелки 010 / 031 / 032 / 033
левый / правый Shift РУС / ЛАТ 016 / 017
Ctrl+буква СУ+буква 001–032
Alt+клавиша АР2+клавиша код | 0200 (вектор 0274)
F10 СТОП прерывание по вектору 4

F11 и F12 заняты режимом экрана и отладчиком, в БК они не передаются. В открытом отладчике F4, F7, F8, Shift+F8, F9, PgUp/PgDn и Esc — его команды.

Коды — по позициям матрицы ВП1-014, снятым с её нетлиста. Бит 0200 значит «через вектор 0274», в регистр 0177662 идут младшие 7 бит. ТАБ, ШАГ и =|=> идут через 0274 с кодами 011, 000 и 013. Монитор сам делает из них 0211, 0220 и 0231, поэтому в справочниках «ШАГ = 220». ГРАФ, ЗАП, СТИР, УСТ ТАБ, СБР ТАБ, ГТ, ⇱ и диагонали — клавиши плёночной клавиатуры БК-0010. На кнопочной те же коды дают СУ и АР2 с буквой, поэтому эти клавиши ПК работают на всех машинах.

Тесты

ctest --test-dir build          # или ./build/cpu_tests
./build/cpu_tests Covox BKX1    # только разделы, в названии которых есть эти слова

Юнит-тесты покрывают декодер инструкций, флаги, ветвления, JSR/RTS, SOB и сохранение/восстановление состояния. Тесты разбиты на именованные разделы: при провале в строке FAIL видно раздел, при падении процесса — тоже.

Безголовый режим (для проверки/скриншотов)

QT_QPA_PLATFORM=offscreen ./build/bk0010-emulator --frames 200 --shot out.png game.bin

Доступны: --frames N, --shot, --dbgshot, --memvis, --hotpath, --callgraph, --flame, --flamechart, --hotchart, --mono, --no-arb037, --cpu-phase 0|1, --scanline / --no-scanline, --no-gigascreen, --smk / --no-smk, --disk <образ> / --disk-rw, --machine auto|bk10|bk11m, --ay / --no-ay, --mstd, --key <код>, --keyframe N, --video <файл.avi|.mp4> (все --frames кадров в видео, со звуком), --video-codec zmbv|h264, --video-size, --no-video-audio.

--scanline включает построчную отрисовку: каждая строка рисуется тем значением регистра смещения 0177664, какое стояло, когда луч её проходил (по модели развёртки Vp037). Нужно для построчных эффектов — параллакса и «разрезанного» экрана; при покадровой отрисовке (по умолчанию на БК-0010) весь кадр рисуется последним значением скролла. На БК-0011М построчная отрисовка включена по умолчанию.

MCP-сервер (отладка через Claude)

Эмулятор умеет работать как MCP-сервер (Model Context Protocol) — тогда Claude может загружать .BIN, шагать по коду, читать/писать память и регистры, ставить точки останова, снимать скриншоты и смотреть «горячие» инструкции сам. Для отладки игр есть управление (клавиатура и джойстик на 0177714) с привязкой ко времени, снятие экрана и звукового буфера — рецепты в docs/mcp-debugging.md.

./build/bk0010-emulator --server        # JSON-RPC 2.0 по stdio (по строкам)

Сервер понимает те же ключи машины, носителей и тайминга, что GUI и безголовый режим (--bk10, --no-smk, --disk, --disk-b, --disk-rom, --hdd, --hdd-b, --az, --az-unit, --cpu-phase, --no-arb037, --scanline…): разбор командной строки один на все режимы. AZБК на ходу ставится и снимается через bk_reset {az, az_sd, az_unit0}, кабель сетевой карты — bk_reset {az_net}.

Регистрация в Claude Code — файл .mcp.json в корне проекта уже готов (сервер bk0010). После сборки запустите Claude Code из этого каталога и подтвердите подключение сервера.

Инструменты (все адреса/значения принимают десятичное, 0x… hex или восьмеричное с ведущим 0 — по соглашению БК; восьмеричное передавайте строкой: голое JSON-число разбирается как десятичное):

Инструмент Назначение
bk_load загрузить .BIN (сначала грузится монитор) и запустить; reset — с чистого листа, frames — сразу прогнать N кадров; .wav — программа с кассеты (x.wav#N — N-й файл)
bk_mouse мышь «Марсианка» на 0177714: подключить, шаги шара dx/dy, кнопки left/right, прогнать кадры
bk_tape магнитофон: вставить/извлечь кассету .wav, оглавление, воспроизведение, стоп, перемотка, позиция на файл, run — гнать кадры, пока лента грузится, сохранить файл как .BIN
bk_reset сброс машины
bk_run / bk_run_until выполнять кадры / до адреса-символа; input — таймлайн ввода [{frame, key, joy}] за один вызов
bk_step / bk_step_over / bk_step_out шаг внутрь / через JSR·EMT / до выхода из процедуры
bk_regs / bk_set_reg чтение / запись R0–R7, SP, PC, PSW
bk_read_mem / bk_write_mem память словами или байтами; страница В-В пишется через шину, чтобы устройство увидело запись (bus переопределяет)
bk_disasm дизассемблирование
bk_break / bk_unbreak / bk_breakpoints точки останова
bk_key нажать клавишу по имени (enter, right, рус, стоп) или символу; frames:N — нажать, прогнать N кадров, отпустить (нужно играм, опрашивающим бит удержания 0177716, напр. Digger)
bk_type набрать строку (кириллица — с автоматическим РУС/ЛАТ)
bk_joystick джойстик на 0177714: кнопки по имени в выбранной раскладке (standard/breakhouse/swcorp/klad2, липкая), сырые биты, удержание на N кадров
bk_joy_probe определить раскладку неизвестной игры перебором битов с откатом состояния
bk_screenshot PNG экрана БК (можно сперва прогнать frames)
bk_ocr прочитать текст с экрана по знакоместам (знакогенератор ПЗУ): узкий режим 64 симв./строку и широкий 32, режим и сетка подбираются сами; свой шрифт игры — через font_addr
bk_vram ASCII-вид экрана; mode:"index" — точные индексы палитры по пикселям окна ВОЗУ
bk_audio звук (стерео): WAV (inline и/или файл), пик/RMS по каналам, огибающая и разбор на тоны по фронтам 0177716
bk_io_state / bk_io_log снимок регистров В-В / лог обращений, включая ЧТЕНИЯ с PC инструкции (видно, кто опрашивает джойстик)
bk_state_save / bk_state_load сохранить / восстановить состояние (файл или именованный слот в памяти)
bk_symbols загрузить символы из .map (GNU ld) — адреса по имени; имена подпрограмм ПЗУ контроллера дисковода (roms/*.sym) видны и без этого, пока контроллер на шине
bk_hotspots самые часто исполняемые инструкции
bk_calltree дерево вызовов текстом: вкл./собств. % и такты по путям вызова, поддерево функции (addr), плоский топ по собственному времени
bk_profile профиль в формате folded stacks (speedscope / flamegraph.pl)
bk_profile_reset обнулить профиль и счётчики bk_hotspots, сохранив текущий стек вызовов

У bk_calltree и bk_profile есть frames: N (и input, как у bk_run): профиль обнуляется и снимается только за следующие N кадров — удобно сравнивать «до» и «после».

Архитектура

  • src/core/ — ядро эмуляции (без Qt): Cpu, Memory, Disasm, Screen, Speaker, Trace, Board (главный цикл, I/O-регистры, прерывания, save/restore), плюс общие таблицы ввода Joystick.h (раскладки джойстика) и BkKeys.h (имена клавиш и текст → КОИ-7) — их разделяют GUI, MCP-сервер и тесты.
  • src/ui/ — Qt6: MainWindow, GlScreen (OpenGL), DebuggerWindow, MemVisWidget, HotPathWidget, CallGraphWidget, FlameWidget, FlameChartWidget, HotChartWidget.
  • src/mcp/ — McpServer: MCP-сервер поверх ядра (JSON-RPC по stdio, QtCore JSON).

Ядро исполняет инструкции по кадрам 48,83 Гц (3 МГц, 61440 тактов на кадр), UI-поток отображает текстуру экрана и панели отладчика.

Справочник по железу БК-0010-01 (карта памяти, регистры, векторы, кодирование экрана, палитра, формат .BIN, тактирование) — в docs/BK0010-hardware.md. Указания для будущих сессий Claude Code — в CLAUDE.md.

About

Эмулятор советского персонального компьютера БК-0010-01 (процессор К1801ВМ1, клон PDP-11) на C++17 / Qt6 / OpenGL с отладчиком и профилятором.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages