zx_cartridge/FW/readme.md

ZX Spectrum Cartridge Controller — программисту

Общая информация

Модуль zx_cartridge управляет четырьмя микросхемами ПЗУ типа AM29F040 (512 КБ каждая), что даёт 2 МБ памяти.
Память организована в виде 256 страниц по 8 КБ. Страницы нумеруются от 0 до 255.

В адресном пространстве ZX Spectrum под картридж отведена область 0x0000…0x3FFF (16 КБ, первые 16 КБ памяти).
Эта область разделена на два 8‑КБ окна:

• Нижнее окно 0x0000…0x1FFF (A13 = 0) — всегда страница 0.
  Здесь должен располагаться код BIOS картриджа.

• Верхнее окно 0x2000…0x3FFF (A13 = 1) — страница, номер которой задаётся программно через регистр bank.

Регистры управления

Доступ к регистрам осуществляется через порты ввода‑вывода.

Порт bank (адрес 0xDF7F)

• Запись (OUT (0xDF7F), A) — устанавливает номер страницы для верхнего окна.
• Чтение (IN A, (0xDF7F)) — возвращает текущее значение регистра.

Формат байта bank:

Биты 7–6	Биты 5–0
Выбор микросхемы (0–3)	Номер страницы внутри микросхемы (0–63)

Таким образом, полный номер страницы = (chip << 6) | page.
После сброса регистр равен 0 (микросхема 0, страница 0).

Порт control (адрес 0xBF7F)

• Запись (OUT (0xBF7F), A) — запись в управляющий регистр.
• Чтение (IN A, (0xBF7F)) — чтение текущего значения.

Формат байта control:

Биты 7	Биты 6–0
Отключение картриджа	Можно использовать по своему усмотрению

• Бит 7 = 0 — картридж включён (обычный режим).
• Бит 7 = 1 — картридж отключён. Выходы ПЗУ переводятся в высокоимпедансное состояние, внутреннее ПЗУ Spectrum работает штатно.

После сброса бит 7 = 0 (картридж включён).