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>

libc/include/irq.h

@@ -25,6 +25,8 @@
 #ifndef IRQ_H
 #define IRQ_H
 
+#include <stdint.h>
+
 typedef void (*isr_t)(void);
 
 /* Установить обработчик кадрового прерывания.
@@ -36,6 +38,24 @@ int  irq_install(isr_t handler);
  * повторно; вызывается автоматически при exit(). */
 void irq_remove(void);
 
+/* ---- CTC-таймер (Z84C015, вектор 0x06 — отдельный от кадрового) ---
+ *
+ * Канал 2 тактируется 875 кГц (1 тик = 1 знакоместо видеотракта) и
+ * делит; канал 3 считает от канала 2 и прерывает.  Частота handler'а:
+ *     f = 875000 / (div2 * div3),  div 0 = 256
+ * (диапазон ~13 Гц .. десятки кГц; на частотах выше пары кГц handler
+ * должен быть ОЧЕНЬ коротким).  Ставится независимо от irq_install —
+ * можно иметь оба.  Ограничения для handler'а те же, что выше.
+ * Обработчик завершается RETI (в трамплине) — daisy chain Z84C015. */
+
+int  irq_ctc_install(isr_t handler, uint8_t div2, uint8_t div3);
+void irq_ctc_remove(void);     /* глушит CTC; тоже вызывается из exit() */
+
+/* Пресет точного кадра: 112 тактов (2 пикс. линии) * 160 = 320 линий,
+ * ~48.8 Гц, начало кадра — «vsync без примеси клавиатуры». */
+#define IRQ_CTC_VSYNC_DIV2  112
+#define IRQ_CTC_VSYNC_DIV3  160
+
 /* Скобки для доступа main-кода к данным, разделяемым с ISR. */
 #define IRQ_DISABLE()  __asm__("di")
 #define IRQ_ENABLE()   __asm__("ei")