Завершить разделение SDK и внешних проектов

This commit is contained in:
Александр Петров
2026-09-16 10:01:43 +03:00
parent 0e74aaa7ee
commit 2e7ffd64a4
1965 changed files with 373 additions and 201393 deletions
+7 -5
View File
@@ -10,14 +10,15 @@
* **`lib/sprinter.lib`** — целевая libc для Sprinter (предсобрана; пересобирается через `make`, если изменили исходники libc).
* **`runtime/`** — варианты crt0 и runtime-помощники (ассемблируются per-build).
* **`toolchain/mkexe/`** — host-утилита, упаковывающая `.ihx` SDCC в SprintEXE.
* **`examples/`** — 27 готовых программ.
* **`tests/` + `testkit/`** — регрессионные программы и host-тесты SDK.
* **`app.mk`** — правила сборки и запуска автономных приложений.
* **`docs/{en,ru}/`** — эта документация.
## Первая сборка
```sh
cd sprinter-c-v1.0-<host>
make all # пересобрать lib + все примеры (~30 с)
make all # пересобрать инструменты, библиотеки и SDK-тесты
```
Если `make` жалуется на отсутствующий бинарник SDCC — загрузите его один раз:
@@ -48,8 +49,9 @@ Sprinter / MAME / в любом ESTEX DSS шелле.
Релиз **не содержит** эмулятор MAME или образы ROM / DSS / HDD Sprinter —
они большие и имеют свои лицензии. Для тестирования:
* **MAME:** установите MAME 0.283+ отдельно, получите образы Sprinter Sp2000
у Peters Plus, смонтируйте FAT12-флоп с вашими `.exe` файлами как `-flop1`.
* **MAME:** установите сборку с драйвером Sprinter и подготовьте `MAME_HOME`
с `mame.arm`, `roms/`, дискетой DSS и системным CHD. `make floppy` создаёт
локальный диск SDK-тестов; `make run MAME_HOME=/путь/к/runtime` монтирует его.
* **Реальный Sprinter:** скопируйте `.exe` на флоп или раздел HDD, видимый
для DSS, затем `RUN HELLO` в шелле.
@@ -57,6 +59,6 @@ Sprinter / MAME / в любом ESTEX DSS шелле.
* Прочитайте `sprinter_cc.md` про флаги компилятора.
* Прочитайте `memory_modes.md` когда не хватит 14 КБ кода.
* Просмотрите `examples/` — каждый файл это рабочая программа с комментариями.
* `examples.md` описывает SDK-тесты и отдельный проект Examples.
* `headers.md` — список публичных API.
* `platform_reference.md` — глубокие нюансы платформы и компилятора (от граблей до подводных камней).