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>

tests/irqtest/irqtest.c

@@ -1,11 +1,13 @@
 /*
- * irqtest — smoke-тест IM2-модуля (Phase 1, docs/im2_isr_design.md).
+ * irqtest — smoke-тест IM2-модуля (Phase 1+2, docs/im2_isr_design.md).
  *
  * Проверяет:
- *   1. тикает ~50 Гц (сверка с time() за 3 секунды);
+ *   1. кадровый handler тикает ~50 Гц (сверка с time() за 3 секунды);
  *   2. клавиатура/SYSTIME живы при установленном handler'е (чейн к DSS);
- *   3. irq_remove останавливает тики;
- *   4. чистый выход в шелл (I восстановлен).
+ *   3. CTC-таймер (вектор 0x06): пресет vsync ~49 Гц ОДНОВРЕМЕННО с
+ *      кадровым; затем быстрый режим 875 кГц/(50*50) = 350 Гц;
+ *   4. irq_remove/irq_ctc_remove останавливают тики;
+ *   5. чистый выход в шелл (I/IM восстановлены, CTC заглушен).
  */
 
 #include <stdio.h>
@@ -15,12 +17,18 @@
 #include <irq.h>
 
 static volatile uint16_t ticks;
+static volatile uint16_t ctc_ticks;
 
 static void on_tick(void)
 {
     ticks++;
 }
 
+static void on_ctc(void)
+{
+    ctc_ticks++;
+}
+
 /* Диагностика: регистр I до установки (что за режим у DSS?). */
 static uint8_t get_i(void) __naked
 {
@@ -78,6 +86,47 @@ int main(void)
 
     printf("ticks: %u in 3 s (~%u Hz, expect ~50)\n", got, got / 3);
 
+    /* --- Phase 2: CTC-таймер одновременно с кадровым --- */
+    if (irq_ctc_install(on_ctc, IRQ_CTC_VSYNC_DIV2, IRQ_CTC_VSYNC_DIV3)) {
+        printf("irq_ctc_install failed: errno=%d\n", errno);
+        return 1;
+    }
+    {
+        time_t t3 = time(0);
+        while (time(0) == t3) ;
+        IRQ_DISABLE();
+        uint16_t c0 = ctc_ticks, f0 = ticks;
+        IRQ_ENABLE();
+        time_t t4 = time(0);
+        while (time(0) < t4 + 2) ;
+        IRQ_DISABLE();
+        uint16_t dc = ctc_ticks - c0, df = ticks - f0;
+        IRQ_ENABLE();
+        printf("ctc(vsync): %u in 2 s (~%u Hz), frame in parallel: %u\n",
+               dc, dc / 2, df);
+    }
+    irq_ctc_remove();
+
+    /* CTC на произвольной частоте: 875000/(50*50) = 350 Гц. */
+    if (irq_ctc_install(on_ctc, 50, 50)) {
+        printf("ctc fast install failed: errno=%d\n", errno);
+        return 1;
+    }
+    {
+        time_t t5 = time(0);
+        while (time(0) == t5) ;
+        IRQ_DISABLE();
+        uint16_t c0 = ctc_ticks;
+        IRQ_ENABLE();
+        time_t t6 = time(0);
+        while (time(0) < t6 + 2) ;
+        IRQ_DISABLE();
+        uint16_t dc = ctc_ticks - c0;
+        IRQ_ENABLE();
+        printf("ctc(50x50): %u in 2 s (~%u Hz, expect ~350)\n", dc, dc / 2);
+    }
+    irq_ctc_remove();
+
     puts("press any key (keyboard must work)...");
     getch();