snark13
c71e249a4e
First substantive commit: the entire Sprinter C compiler tree on top of
the bare README+gitignore initial commit.
What's in here:
bin/sprinter-cc — driver script invoking SDCC + linker + mkexe
libc/ — Sprinter-specific libc layer over ESTEX/BIOS
(conio, gfx, io, mem, stdio + headers)
runtime/ — crt0 variants (default/small/banked/minimal)
+ heap + bank trampolines
toolchain/ — mkexe (SprintEXE packer, C + tests)
examples/ — 30 demo programs (gfx, file I/O, env, time, …)
lib/Makefile — builds the libc archive (sprinter.lib)
docs/ — converted Sprinter manuals + asm reference samples
third_party/ — solid-c reference compiler dump + sdcc setup script
release_docs/ — packaging / release notes
gitignore overhaul:
• Drop dangerous blanket patterns: *.asm (would hide docs/samples/*.asm)
and *.exe (case-insensitive match was hiding third_party/solid-c/*.EXE
on macOS APFS). Replaced with examples/*/*.{asm,exe,…} and lib/*.lib.
• Restore tracking of toolchain/mkexe/tests/{one,big}.bin — those are
INPUT fixtures, not build outputs.
• Collapse the duplicated SDCC/C/Sdcc sections into one section per
concern (build outputs / vendored / OS-junk).
• Add .sprinter-cc-*/, build/ (catches lib/build/ too), .claude/.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
3.1 KiB
3.1 KiB
Обзор примеров
Релиз содержит 27 примеров в каталоге examples/. Каждый — самодостаточная
демо-программа с комментариями (использовались как regression-тесты при разработке).
Сборка примера
cd examples/hello
make
Результат — hello.exe рядом с hello.c через examples/example.mk.
Категории
Hello world / основы
hello— stdio + conio Turbo-C-стиль цветаargv— парсинг argv в crt0conio— smoke test conio APIattrprob— пробинг байта атрибутов Sprinter
Файловый ввод-вывод
cat— читает и печатает TEST.TXTseek— 32-битный lseek по файлу в 100 КБls— листинг каталога через ffirst/fnextfiletest— FILE* стримы (fopen/fread/fwrite/fclose)stattest—stat/fstatдля файлов и каталоговopenenv— флаги open() + environment variables
Память и банки
malloc— стресс-тест heap (200+ allocations)mem_test— page allocator +bank_read/bank_writebanked— banked-код в W3 (huge mode)bankedbg— banked-код в W1 (big mode)banklocl— bank-local статические данные и BSS
Мышь
mouse— драйвер в текстовом режимеgfx_mous— мышь с пользовательским bitmap-курсором в графическом режиме
Графика
gfx_demo— 320×256×256: линии, прямоугольники, fill через acceleratorgfx_d16— 640×256×16: те же примитивы в 16-цветном режимеgfx_text— bitmap-текст на графическом экране
Прочее
errno— errno / strerror / perrortimedir— дата/время + листинг каталогаptime— POSIX time API (time / localtime / mktime)strtest—<string.h>тест (из SDCC's z80.lib)stdlib—<stdlib.h>тест (qsort / rand / strtol / etc.)assrtest— assert()rt_test— runtime helpers (sleep, setjmp, atexit)
Example.mk
Каждый пример использует examples/example.mk. Минимальный Makefile:
PROJ_ROOT := $(abspath $(CURDIR)/../..)
EXAMPLE := my_app
include $(PROJ_ROOT)/examples/example.mk
Опциональные параметры (задаются до include):
MEMORY := huge # по умолчанию tiny
STACK_SIZE := 4096 # по умолчанию ~1278
EXTRA_SRCS := helper.c util.c # дополнительные .c в той же папке
EXTRA_FLAGS := --bank 1=engine.c --debug # pass-through в sprinter-cc
Используйте этот template для своих программ.