Эмулятор советских персональных компьютеров БК-0010-01 и БК-0011М (процессор К1801ВМ1, клон PDP-11) на C++17 / Qt6 / OpenGL с отладчиком в стиле Soft-ICE.
- Процессор К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, MCPbk_mouse): движение над экраном БК — шаги шара, средняя кнопка — захват. - Магнитофон: кассеты
.WAV— записи с ленты и вывод конвертеров.BIN → .WAV(bkbin2wav, веб-конвертер thesands.ru, включая турбо-загрузчик Maxim). Кассета грузится сразу, как.BIN(игра.wav,игра.wav#N), или играет в магнитофоне: сигнал идёт в разряд 50177716, файлы читает сам драйвер ПЗУ или свой загрузчик программы. Подробности —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 нет libx264Debian / 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-multimediaopenSUSE:
sudo zypper install cmake gcc-c++ qt6-base-devel qt6-opengl-devel qt6-multimedia-devel zlib-develmacOS (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).
Исходная машина 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.
Машина выбирается в меню «Машина» (выбор запоминается между запусками), ключом
--machine auto|bk10|bk10f|bk11m (--bk10, --bk10f, --bk11m) на один запуск или
аргументом machine MCP bk_machine/bk_reset. Режимы:
- «Автоматически — по программе» (
auto, по умолчанию): программу.BIN(в командной строке, в меню «Файл», в MCPbk_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 (перекрестие): каждый шаг
сдвигает курсор.
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 Кбайт
дополнительного ОЗУ: 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БК (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Два контроллера винчестера 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-сервер (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.
