irq: Phase 2a — CTC-таймер на отдельном векторе 0x06 (Z84C015)

- irq_ctc_install(handler, div2, div3) / irq_ctc_remove: канал 2 CTC
  делит видеотакт 875 кГц (1 тик = 1 знакоместо), канал 3 считает от
  него и прерывает; f = 875000/(div2*div3), div 0 = 256. Пресет
  IRQ_CTC_VSYNC_DIV2/3 = 112*160 — точное начало кадра ~48.8 Гц БЕЗ
  примеси клавиатуры (вектор 0x06 отделён от общего 0xFF)
- CTC-трамплин: полный сейв -> handler -> EI/RETI; RETI обязателен
  (daisy chain Z84C015 снимает IUS только по опкоду RETI); к DSS не
  чейнится — личное прерывание
- общая IM2-таблица под счётчиком ссылок (_irq_table.c): кадровый и
  CTC-хендлеры независимы, последний unref возвращает I/IM 1;
  atexit-уборка глушит CTC обязательно (иначе кГц-прерывания душат
  шелл после выхода)
- порты/слова по docs/samples: CH0=0x10/CH2=0x12/CH3=0x13,
  0x57/0xD7/вектор в CH0, стоп 0x03
- irqtest: CTC-vsync параллельно с кадровым + произвольная частота;
  MAME: frame 48 Гц, ctc(vsync) 49 Гц (parallel frame жив),
  ctc(50x50) 350 Гц точно по формуле, remove/выход чистые

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-07 09:15:04 +03:00
parent 5184415fc4
commit 8a952b99eb
13 changed files with 418 additions and 124 deletions
+4 -18
View File
@@ -1,30 +1,16 @@
/*
* irq_remove — снять user-handler и вернуть систему в штатный режим
* DSS: I := сохранённое значение (наследие Spectrum ROM, обычно 0x3F)
* и ВСЕГДА IM 1 — DSS работает в IM 1, его обработчик на 0x0038
* (так же делают сэмплы сообщества: sprinterIntLib.asm
* intRestoreDefaultInterrupt, SIO_CTC_KEY.asm). Идемпотентно;
* вызывается и из atexit.
* irq_remove — снять кадровый user-handler и отпустить IM2-таблицу
* (последний пользователь возвращает I/IM 1 — штатный режим DSS).
* Идемпотентно; вызывается и из atexit-уборки.
*/
#include "_irq.h"
static void irq_restore(uint8_t i_val) __naked
{
(void)i_val;
__asm
;; A = старое I (только регистр; режим DSS всегда IM 1).
ld i, a
im 1
ret
__endasm;
}
void irq_remove(void)
{
if (!_irq_user) return;
IRQ_DISABLE();
_irq_user = 0;
irq_restore(_irq_old_i);
IRQ_ENABLE();
_irq_table_unref();
}