Завершить разделение SDK и внешних проектов
This commit is contained in:
Александр Петров
+19
-64
@@ -1,75 +1,30 @@
|
||||
# Обзор примеров
|
||||
# Программы и примеры
|
||||
|
||||
Релиз содержит 27 примеров в каталоге `examples/`. Каждый — самодостаточная
|
||||
демо-программа с комментариями (использовались как regression-тесты при разработке).
|
||||
Релиз SDK содержит регрессионные программы в `tests/`: `hello`, `cat`,
|
||||
`gfx_demo`, `bgitest` и другие. Они проверяют компилятор, libc, графику и
|
||||
runtime Sprinter. `make` собирает их, а `make floppy` упаковывает в локальный
|
||||
`build/media/toolkit-tests.img`.
|
||||
|
||||
## Сборка примера
|
||||
Большие демонстрации (`balls`, `mdview`, `mdview2`, `rpgwalk`, `scroll`,
|
||||
`space`) выпускаются отдельным проектом Examples. Для него задаётся только
|
||||
путь к установленному SDK:
|
||||
|
||||
```sh
|
||||
cd examples/hello
|
||||
export SPRINTER_ROOT=/путь/к/sprinter-c
|
||||
cd /путь/к/Examples
|
||||
pyenv exec python -m pip install -r requirements.txt
|
||||
make
|
||||
```
|
||||
|
||||
Результат — `hello.exe` рядом с `hello.c` через `examples/example.mk`.
|
||||
|
||||
## Категории
|
||||
|
||||
### Hello world / основы
|
||||
* **`hello`** — stdio + conio Turbo-C-стиль цвета
|
||||
* **`argv`** — парсинг argv в crt0
|
||||
* **`conio`** — smoke test conio API
|
||||
* **`attrprob`** — пробинг байта атрибутов Sprinter
|
||||
|
||||
### Файловый ввод-вывод
|
||||
* **`cat`** — читает и печатает TEST.TXT
|
||||
* **`seek`** — 32-битный lseek по файлу в 100 КБ
|
||||
* **`ls`** — листинг каталога через ffirst/fnext
|
||||
* **`filetest`** — FILE* стримы (`fopen`/`fread`/`fwrite`/`fclose`)
|
||||
* **`stattest`** — `stat`/`fstat` для файлов и каталогов
|
||||
* **`openenv`** — флаги open() + environment variables
|
||||
|
||||
### Память и банки
|
||||
* **`malloc`** — стресс-тест heap (200+ allocations)
|
||||
* **`mem_test`** — page allocator + `bank_read`/`bank_write`
|
||||
* **`banked`** — banked-код в W3 (huge mode)
|
||||
* **`bankedbg`** — banked-код в W1 (big mode)
|
||||
* **`banklocl`** — bank-local статические данные и BSS
|
||||
|
||||
### Мышь
|
||||
* **`mouse`** — драйвер в текстовом режиме
|
||||
* **`gfx_mous`** — мышь с пользовательским bitmap-курсором в графическом режиме
|
||||
|
||||
### Графика
|
||||
* **`gfx_demo`** — 320×256×256: линии, прямоугольники, fill через accelerator
|
||||
* **`gfx_d16`** — 640×256×16: те же примитивы в 16-цветном режиме
|
||||
* **`gfx_text`** — bitmap-текст на графическом экране
|
||||
|
||||
### Прочее
|
||||
* **`errno`** — errno / strerror / perror
|
||||
* **`timedir`** — дата/время + листинг каталога
|
||||
* **`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:
|
||||
Для своей программы подключайте `app.mk` SDK:
|
||||
|
||||
```makefile
|
||||
PROJ_ROOT := $(abspath $(CURDIR)/../..)
|
||||
EXAMPLE := my_app
|
||||
include $(PROJ_ROOT)/examples/example.mk
|
||||
SPRINTER_ROOT ?= /путь/к/sprinter-c
|
||||
EXAMPLE := my_app
|
||||
include $(SPRINTER_ROOT)/app.mk
|
||||
```
|
||||
|
||||
Опциональные параметры (задаются до `include`):
|
||||
|
||||
```makefile
|
||||
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 для своих программ.
|
||||
`make floppy` создаёт образ в локальном `build/media/` приложения. Для
|
||||
запуска в эмуляторе задайте `MAME_HOME` с `mame.arm`, `roms/` и `IMG/`;
|
||||
`MAME_BIN`, `MAME_ROMPATH`, `MAME_DSS_IMAGE`, `MAME_SYSTEM_HDD_IMAGE` и
|
||||
`MAME_BIOS` позволяют переопределить отдельные пути.
|
||||
|
||||
@@ -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` — глубокие нюансы платформы и компилятора (от граблей до подводных камней).
|
||||
|
||||
@@ -366,8 +366,8 @@ Prepend'ит `DEBUG_RT = 1` в crt0 + передаёт `-DDEBUG_RT` в SDCC. О
|
||||
### MAME testing workflow
|
||||
|
||||
```sh
|
||||
make floppy # пакует все .exe + data в mame/v306/IMG/mc.img
|
||||
cd mame/v306 && ./run_mame.sh
|
||||
make floppy # пакует SDK-тесты в build/media/toolkit-tests.img
|
||||
make run MAME_HOME=/путь/к/MAME/runtime
|
||||
```
|
||||
Имена файлов на флопе должны быть 8.3 (FAT12). Все примеры названы соответственно — `banked_big → bankedbg`, `seek_demo → seek`, `time_dir_test → timedir`, etc.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user