snark13
6dabe9b4b1
Корень двух багов SprPoP (KBD-STUCK-WAIT, частично GRAB-KBD-TIMING) нашёлся в исходниках DSS (docs/sources/Estex-DSS): обработчик прерывания DSS живёт в IM1 по 0x0038 и ПЕРВЫМ ДЕЛОМ делает `CALL KEYSCAN`, а тот вычерпывает FIFO SIO досуха. Наш трамплин проверял «есть ли клавиатурный байт» один раз, на входе в прерывание, а хвост кадрового пути уходил в DSS — значит скан-код, прилетевший позже, доставался DSS и уезжал в его буфер. Rx-overrun при этом НЕ взводится (байт не потерян железом, а прочитан не тем владельцем) — отсюда и загадка исходного диагноза: бит залип при `_kbdraw_overrun == 0`. Измерено в MAME (брейки + totalcycles): окно 738 тактов (~34 мкс) на каждом кадровом прерывании, из них 481 такт — пролог самого DSS. Поэтому проверка FIFO перед chain'ом снимает лишь треть и не годится (пробовали, кражи продолжались); кадровый путь при открытом raw теперь заканчивается приватным RETI, окно = 0. Цена: на это время у DSS замирает опрос мыши и мигание текстового курсора — зафиксировано в <kbd_raw.h>. Пойманный случай (старая сборка): DSS прочитал 0x74 (make стрелки «вправо») при _kbdraw_pending = EXT, то есть посылку E0 74 разорвало пополам между двумя владельцами канала. Проверка: брейк на входе KEYSCAN с условием «страница точно DSS + raw открыт» до правки срабатывал мгновенно (50/с), после — молчит; положительный контроль на нашем RETI срабатывает сразу. Трамплин 300 -> 310 Б (буфер W2-копии поднят 336 -> 384, запас 74 Б); размерный эталон обновлён: +10 Б у программ, линкующих IRQ. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
SprPoP — Prince of Persia на Sprinter Sp2000
Порт оригинального Prince of Persia (1989) на компьютер Sprinter Sp2000: режим 320×256×256, дабл-буфер, звук через CBL, код разложен по одиннадцати 16-килобайтным банкам.
Приложение автономно — код, оригинальные данные, конверторы ресурсов и сборка лежат внутри этой папки. Наружу нужен только компилятор:
export SPRINTER_ROOT=/путь/к/C-Compiler # не нужен, если папка лежит внутри его дерева
make # build/sprpop.exe + ресурсы в build/
make hdd # + образ build/hdd/sprpop.chd
Что где
src/ рукописный C: главный цикл sprpop.c + движок pop_*.c
gen/ генерируемые заголовки — руками не править
assets/orig/ оригинальные данные игры (вне репозитория, см. там README)
assets/packed/ то, что ложится на диск игры, в раскладке диска
tools/ конверторы ресурсов; все пути — в tools/paths.py
docs/ планы, доски задач и багов, справочники (начинать с docs/README.md)
tests/host/ модульные тесты движка под ucsim_z80
build/ выход: sprpop.exe, каталоги ресурсов, hdd/, промежуточные atl/
Цели сборки
| Команда | Что делает |
|---|---|
make |
собрать build/sprpop.exe и разложить ресурсы в build/ |
make hdd |
+ образ жёсткого диска build/hdd/sprpop.chd |
make mame-link |
однократно подставить образ в MAME (символьная ссылка на IMG/test_hdd.chd) |
make resources |
перегенерировать ресурсы из assets/orig/ |
make music-mp3 |
музыка из другого набора записей: music-flac (умолчание), music-mp3, music-ogg, music-mt32 |
make -C tests/host |
модульные тесты движка (секунды, без эмулятора) |
make clean |
снести build/ (ассеты не трогает) |
make distclean |
clean + снести упакованные ассеты assets/packed/ |
Отладочные ключи: make LEVEL=9 — стартовый уровень, make ROOM=15 POS=2 —
стартовая комната и тайл (row*10+col), make PROF=1 — профиль фаз кадра
полосами бордюра, make ALLOCS=100000 — плотная упаковка регистров для
замеров размера.
Сборка из чистого клона
Работает без assets/orig/: упакованные ресурсы (assets/packed/) и
генерируемые заголовки (gen/) лежат в репозитории. Исключение —
assets/packed/LEVELS/: файлы уровней ложатся на диск прямо из оригинала,
без конвертации, поэтому они, как и assets/orig/, вне репозитория. Что и
откуда положить — assets/orig/README.md.
assets/orig/ нужен только чтобы ресурсы перегенерировать (make resources) и как эталон механики: любая правка поведения сверяется с
assets/orig/SDLPoP/src/ до кодинга, см. CLAUDE.md.
Происхождение
Выделен из applications/PoP/roomtest 2026-08-26; та папка заморожена и
служит архивом закрытых задач, багов и исполненных планов. Референсные
реализации (Apple II 6502, Princed Resources, mininim) остались в
applications/PoP/.