snark13
4e43890fce
Пройденная игра доходила до таблицы рекордов и умирала: программа
исчезала, машина следом вставала намертво (di;halt на 0x0000) либо уходила
в reset. Одинаково из Flex Navigator и из голого DSS.
КОРЕНЬ. pop_ui.h объявлял группу pop_text_*_mapped БЕЗ __banked. Пока
pop_hof.c лежал в банке 9 рядом с pop_ui.c, прямой call был верен; после
переноса pop_hof/pop_config/pop_pal в банк 10 тот же call стал уходить в
пустой хвост чужого банка. Процессор полз по 0xFF до 0x0000, где ловушка
DSS ставит B=0x27 и сворачивает процесс — подмена страниц W1/W2/W3,
которую было видно на трупе, оказалась уборкой, а не причиной.
Точную инструкцию (call $E503 = _pop_text_map банка 9) дала трассировка
MAME на узком участке: trace включалась брейкпоинтом на входе в
pop_hof_show и выключалась на процедуре завершения процесса DSS (0x1E56).
ЧТО СДЕЛАНО
* pop_ui.h/.c — группа text_*_mapped помечена __banked.
* toolchain/check_bank_calls.py — две проверки банкового кода:
1) прямой call в чужой банк (доказательна, ВАЛИТ сборку — проверено
намеренной поломкой);
2) указатель на данные своего банка, отданный в чужой (эвристика по
форме кода, только предупреждает).
Встроена в app.mk, запускается сразу после линковки.
* pop_hof.c — курсор ввода строится на стеке: литерал "_" лежал в _BANK10
и после пометки __banked уезжал из-под ног чужому банку, заливая экран
знаками вопроса.
* libc: kbd_raw_keypad_as_ext() — kbd_raw_sync переносит голые коды
нумпада в EXT-половину карты. Лечит залипание стрелок (потерянный
префикс E0 сажал make в PLAIN как код нумпада, и снять его было нечем),
заодно нумпад стал управлением: 7/8/9, 4/6, 2 и 5 = вниз.
* pop_pace.c — цикл ожидания луча зовёт тот же idle-хук, что и
gfx_wait_vsync: без этого F10 в геймплее не работал вовсе.
* pop_hof.c — Esc в таблице рекордов отменяет запись (расхождение с
оригиналом записано в docs/impl_diff.md).
* Экран версии показывается только через Menu/Settings/About: стартовый
показ и Ctrl+V убраны, мёртвый код снят.
* sprpop_cold.c — pop_start_level зовёт pop_hp_invalidate: после Ctrl+A с
выросшим за уровень максимумом полоса HP моргала между страницами.
Разбор всех четырёх багов — в applications/PoP/roomtest/BUGS_CLOSED.md
(FINAL-BANKCALL, FINAL-HOF-GARBAGE, KBD-ARROW-PHANTOM, F10-GAMEPLAY),
правило про банки — в applications/SprPoP/CLAUDE.md.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
134 lines
6.2 KiB
Makefile
134 lines
6.2 KiB
Makefile
# app.mk — shared Makefile fragment for any standalone Sprinter ESTEX
|
||
# program — used both by libc feature tests under tests/ and by real
|
||
# applications under examples/.
|
||
#
|
||
# Usage in a per-program Makefile:
|
||
#
|
||
# PROJ_ROOT := $(abspath $(CURDIR)/../..)
|
||
# EXAMPLE := my_program # base name (matches my_program.c)
|
||
#
|
||
# # Optional overrides (any combination):
|
||
# # MEMORY := small # tiny | small | big | huge | manual
|
||
# # STACK_SIZE := 2048 # bytes reserved for the stack
|
||
# # EXTRA_SRCS := helper.c util.c # additional .c files in this dir
|
||
# # EXTRA_FLAGS := --crt0=minimal # passed through to sprinter-cc
|
||
# # EXTRA_DATA := test.txt # extra files to add to `make floppy`
|
||
#
|
||
# include $(PROJ_ROOT)/app.mk
|
||
#
|
||
# Pipeline (all driven by sprinter-cc):
|
||
# crt0 + EXAMPLE.c + EXTRA_SRCS --sdcc--> .ihx
|
||
# .ihx --mkexe--> EXAMPLE.exe
|
||
# linking against lib/sprinter.lib for libc.
|
||
#
|
||
# Targets provided:
|
||
# all build $(EXAMPLE).exe (default)
|
||
# clean remove build artefacts
|
||
# floppy build the example and pack it (alone, plus EXTRA_DATA) into
|
||
# mame/v306/IMG/mc.img — useful for trying a single program
|
||
# without rebuilding every example. Top-level `make floppy`
|
||
# (in the repo root) still packs all examples.
|
||
# run floppy + launch MAME
|
||
|
||
SPRINTER_CC := $(PROJ_ROOT)/bin/sprinter-cc
|
||
MKEXE := $(PROJ_ROOT)/toolchain/mkexe/mkexe
|
||
LIB := $(PROJ_ROOT)/lib/sprinter.lib
|
||
|
||
MAME_DIR := $(PROJ_ROOT)/mame/v306
|
||
FLOPPY_IMG := $(MAME_DIR)/IMG/mc.img
|
||
# ?= — приложение со своим каталогом выхода (applications/SprPoP) держит
|
||
# образ у себя и связывает его с MAME символьной ссылкой.
|
||
HDD_IMG ?= $(MAME_DIR)/IMG/test_hdd.chd
|
||
MAKE_DISK := $(MAME_DIR)/make_disk.py
|
||
MAKE_HDD := $(PROJ_ROOT)/toolchain/make_hdd.sh
|
||
RUN_MAME := $(MAME_DIR)/run_mame.sh
|
||
|
||
# Optional knobs — see top of file.
|
||
MEMORY ?= tiny
|
||
|
||
# SRC_DIR / BUILD_DIR — раскладка приложения, которое НЕ держит исходники и
|
||
# выхлоп в одной папке с Makefile (applications/SprPoP: src/ и build/). По
|
||
# умолчанию обе пусты, то есть всё как было: ./$(EXAMPLE).c → ./$(EXAMPLE).exe.
|
||
# Пустое значение обрабатывается отдельной веткой намеренно: "./prog.exe" и
|
||
# "prog.exe" — разные имена целей, и склеивать префикс безусловно нельзя.
|
||
SRC_DIR ?=
|
||
BUILD_DIR ?=
|
||
ifeq ($(strip $(SRC_DIR)),)
|
||
MAIN_SRC := $(EXAMPLE).c
|
||
else
|
||
MAIN_SRC := $(SRC_DIR)/$(EXAMPLE).c
|
||
endif
|
||
ifeq ($(strip $(BUILD_DIR)),)
|
||
EXE := $(EXAMPLE).exe
|
||
else
|
||
EXE := $(BUILD_DIR)/$(EXAMPLE).exe
|
||
endif
|
||
SOURCES := $(MAIN_SRC) $(EXTRA_SRCS)
|
||
# Аргументы упаковщика HDD. Обычно это exe и EXTRA_DATA; приложение со
|
||
# своей раскладкой каталогов может переопределить переменную до include.
|
||
HDD_PACK_ARGS ?= $(EXE) $(EXTRA_DATA)
|
||
|
||
CC_FLAGS := --memory $(MEMORY)
|
||
ifneq ($(STACK_SIZE),)
|
||
CC_FLAGS += --stack-size $(STACK_SIZE)
|
||
endif
|
||
CC_FLAGS += $(EXTRA_FLAGS)
|
||
|
||
all: $(EXE)
|
||
|
||
# runtime/*.s (crt0-семейство, bank.s, heap.s) собираются per-build
|
||
# внутри sprinter-cc — без этой зависимости их правка не перелинкует
|
||
# уже собранный exe (кусало: фикс bank.s не подхватился).
|
||
RUNTIME_DEPS := $(wildcard $(PROJ_ROOT)/runtime/*.s)
|
||
|
||
# ПРОВЕРКА БАНКОВЫХ ВЫЗОВОВ — сразу после линковки, пока артефакты свежие.
|
||
# Ловит прямой `call` в чужой банк: он собирается МОЛЧА и стреляет диким
|
||
# переходом в пустой хвост банка (разбор — в шапке скрипта). Запускается
|
||
# только если банки вообще есть, то есть по наличию каталога сборки с
|
||
# bankN_*.asm; обычным небанковым программам ничего не стоит.
|
||
BANK_CHECK := $(PROJ_ROOT)/toolchain/check_bank_calls.py
|
||
|
||
$(EXE): $(SOURCES) $(MKEXE) $(LIB) $(RUNTIME_DEPS)
|
||
$(if $(strip $(BUILD_DIR)),@mkdir -p $(dir $@))
|
||
$(SPRINTER_CC) $(CC_FLAGS) -o $@ $(SOURCES)
|
||
@d=$(dir $@).sprinter-cc-$(EXAMPLE); \
|
||
if ls $$d/bank*_*.asm >/dev/null 2>&1; then python3 $(BANK_CHECK) $$d; fi
|
||
|
||
$(MKEXE):
|
||
$(MAKE) -C $(PROJ_ROOT)/toolchain/mkexe
|
||
|
||
# $(LIB) = lib/sprinter.lib (libc). Графика (bgi256.lib) собирает
|
||
# libbgi/Makefile; гоним и его — иначе standalone `make` в тесте с
|
||
# --gfx 256 не найдёт bgi256.lib при линковке. Оба инкрементальные,
|
||
# на повторном запуске ничего не пересобирают.
|
||
$(LIB):
|
||
$(MAKE) -C $(PROJ_ROOT)/libc
|
||
$(MAKE) -C $(PROJ_ROOT)/libbgi
|
||
|
||
clean:
|
||
rm -rf $(if $(strip $(BUILD_DIR)),$(BUILD_DIR),.sprinter-cc-* $(EXE))
|
||
|
||
# `make floppy` packs ONLY this program (+ optional EXTRA_DATA files) into
|
||
# the MAME floppy image, replacing whatever was there. Handy for trying a
|
||
# single program without rebuilding everything.
|
||
floppy: $(EXE)
|
||
python3 $(MAKE_DISK) $(FLOPPY_IMG) $(EXE) $(EXTRA_DATA)
|
||
@echo
|
||
@echo "Floppy ready: $(FLOPPY_IMG) (with $(EXAMPLE).exe$(if $(EXTRA_DATA), + $(EXTRA_DATA))) "
|
||
@echo "Run: cd $(MAME_DIR) && ./run_mame.sh"
|
||
|
||
run: floppy
|
||
cd $(MAME_DIR) && ./run_mame.sh
|
||
|
||
# `make hdd` packs this program (+ optional EXTRA_DATA files) into the MAME
|
||
# HDD image mounted as disk D: (-hard2 test_hdd.chd). Гораздо быстрее FDD —
|
||
# используется MCP-мостом к MAME (run_bridge.sh). После пересборки образа
|
||
# MAME ОБЯЗАН полный рестарт (chdman -f = новый inode; см. memory).
|
||
hdd: $(EXE)
|
||
$(MAKE_HDD) $(HDD_IMG) $(HDD_PACK_ARGS)
|
||
@echo
|
||
@echo "HDD (D:) ready: $(HDD_IMG) (with $(EXAMPLE).exe$(if $(EXTRA_DATA), + $(EXTRA_DATA)))"
|
||
@echo "ВНИМАНИЕ: перезапусти MAME (run_bridge.sh) — образ пересобран."
|
||
|
||
.PHONY: all clean floppy run hdd
|