🐞 DeZog: ОТЛАДЧИК, КОТОРЫЙ ВЫВЕЛ РЕТРО-КОД В XXII ВЕК

​

​

​

​

ВСТУПЛЕНИЕ: ОТ ГЛАЗ И КАЛЬКУЛЯТОРА К ГРАФИЧЕСКОМУ ИНТЕРФЕЙСУ​

ЧТО ТАКОЕ DeZog И ЗАЧЕМ ОН НУЖЕН?​

КЛЮЧЕВЫЕ ВОЗМОЖНОСТИ (ЧТО ОН ДАЁТ ПРОГРАММИСТУ)​

1. Точки останова (Breakpoints) — кликнули слева от строки — и выполнение остановится именно там. Поддерживаются условные брейкпоинты (остановиться, когда A=10).
2. Пошаговое выполнение — Step Over (F10), Step Into (F11), Step Out (Shift+F11). Как в дорогих IDE.
3. Обратная отладка (Reverse Debugging) — да-да, можно отмотать выполнение назад! Если пропустили момент, где всё сломалось — просто открутите несколько инструкций назад.
4. Просмотр регистров — все регистры Z80 (AF, BC, DE, HL, IX, IY, SP, PC, флаги) в реальном времени, с обновлением при каждом шаге.
5. Просмотр памяти — можно смотреть любые области RAM, включая экранные области и атрибуты. Даже в разных форматах: байты, слова, ASCII.
6. Watch-переменные — добавили метку Score в список наблюдения — и видите её изменение по шагам.
7. Code Coverage — подсвечивает строки кода, которые уже выполнялись. Видно, где программа побывала, а куда так и не зашла.
8. Поддержка ZX Next — понимает спрайты, банки памяти, новые инструкции.

ИСТОРИЧЕСКИЙ КОНТЕКСТ: ЭВОЛЮЦИЯ ОТЛАДКИ НА SPECTRUM​

УСТАНОВКА И НАСТРОЙКА: СДЕЛАЙ РАЗ, ПОЛЬЗУЙСЯ ГОДАМИ​

Установка расширения​

1. Запустите Visual Studio Code.
2. Нажмите Ctrl+Shift+X (или иконку квадратиков слева).
3. В поиске введите "DeZog".
4. Найдите расширение от автора maziac (иконка с жучком и микросхемой) и нажмите Install.

Что ещё нужно?​

1. zsim — встроенный симулятор Z80 (не требует ничего, работает прямо в VS Code). Идеально для быстрого старта и отладки логики.
2. ZEsarUX — мощный эмулятор Spectrum, подключается через протокол ZRCP.
3. CSpect — эмулятор для Windows, отличный для ZX Next.
4. ZX Next — реальное железо! Можно отлаживать программу прямо на реальном компьютере через последовательный порт.

Создание launch.json (самая важная часть)​

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "dezog",
            "request": "launch",
            "name": "DeZog (zsim)",
         
            // 1. ВЫБОР ЦЕЛИ
            "remoteType": "zsim",
            "zsim": {
                // Можно оставить пустым
            },
         
            // 2. ОТКУДА БРАТЬ СИМВОЛЫ (ФАЙЛ ЛИСТИНГА)
            "sjasmplus": [
                {
                    "path": "${workspaceFolder}/main.list"
                }
            ],
         
            // 3. ЧТО ЗАГРУЖАТЬ
            "load": "${workspaceFolder}/main.sna",
         
            // 4. ВАЖНО: ГДЕ ВЕРШИНА СТЕКА?
            "topOfStack": "stack_top",
         
            // 5. ДОПОЛНИТЕЛЬНЫЕ ФИШКИ
            "startAutomatically": false,  // Остановиться на первой инструкции
            "history": {
                "reverseDebugInstructionCount": 10000, // ВКЛЮЧАЕМ МАГИЮ ОБРАТНОЙ ОТЛАДКИ
                "codeCoverageEnabled": true
            }
        }
    ]
}

• "sjasmplus" — DeZog должен знать, где лежит файл листинга (.list), который генерирует ваш ассемблер. Именно по нему он связывает адреса в памяти со строками исходника.
• "load" — что грузим (снапшот .sna, бинарник .bin, образ ленты .tap).
• "topOfStack" — критически важно для правильного отображения стека вызовов. Укажите метку, где объявлена вершина стека.
• "reverseDebugInstructionCount" — включает тот самый реверс-дебаг. Указывает, сколько последних инструкций хранить в буфере, чтобы можно было отмотать назад.

Пример для разных целей​

"remoteType": "cspect",
"cspect": {
    "port": 5000  // Порт, который слушает CSpect
},
"load": "${workspaceFolder}/build/program.nex"

"remoteType": "zrcp",
"zrcp": {
    "port": 10000  // Порт ZRCP в ZEsarUX
}

"remoteType": "zxnext",
"zxnext": {
    "serial": "/dev/ttyUSB0"  // Путь к serial-порту
}

ИНТЕРФЕЙС И РАБОЧИЙ ПРОЦЕСС​

Как это выглядит в редакторе​

• Панель управления (Debug Toolbar) — плавает поверх редактора. Кнопки: Continue (F5), Step Over (F10), Step Into (F11), Step Out (Shift+F11), Restart, Stop. А также Step Back и Reverse Continue — кнопки для обратной отладки!
• Область VARIABLES — показывает все регистры Z80: AF, BC, DE, HL, IX, IY, SP, PC, флаги (S, Z, H, P/V, N, C). Можно раскрыть каждый регистр и увидеть его значение в разных форматах (hex, dec, bin). Также показывает дизассемблированный код вокруг PC и содержимое стека.
• Область WATCH — сюда можно добавить любые метки из вашего кода (например, player_x, score) и следить за их изменением.
• Область BREAKPOINTS — список всех точек останова. Можно временно отключать, удалять, добавлять условия (например, A==10).
• Область MEMORY — можно добавить любое количество областей памяти для просмотра. Удобно смотреть на экранную область (16384), атрибуты или буфер спрайтов.
• Редактор кода — текущая строка подсвечена жёлтым. Строки, которые уже выполнялись (code coverage), подсвечены зелёным фоном. Можно навести мышку на любую метку и увидеть её текущее значение.

Основные действия​

• Поставить точку останова — кликните слева от номера строки. Появится красный кружок.
• Условная точка останова — кликните правой кнопкой -> "Add Conditional Breakpoint" и введите условие, например: (A == 10) && (B > 5).
• Добавить переменную в Watch — выделите метку в коде, кликните правой кнопкой -> "Add to Watch".
• Посмотреть память — в палитре команд (Ctrl+Shift+P) выполните DeZog: Add Memory Viewer. Укажите адрес (например, 0x4000) и размер.

​

ДИРЕКТИВЫ И ИНТЕГРАЦИЯ​

Как DeZog понимает ваш код​

• sjasmplus — самый популярный выбор. Генерирует .list файлы, которые DeZog отлично парсит.
• z88dk — компилятор Си. DeZog понимает его выходные форматы.
• z80asm — ассемблер из пакета z88dk.

Интеграция с другими расширениями​

• Z80 Macro-Assembler — чтобы писать код с автодополнением.
• Z80 Instruction Set — чтобы видеть описание команд под курсором.
• Hex Hover Converter — чтобы видеть числа в разных системах счисления.
• ASM Code Lens — для дополнительной навигации.

СРАВНЕНИЕ: DeZog VS КЛАССИЧЕСКИЕ ОТЛАДЧИКИ​

ПЛЮСЫ И МИНУСЫ​

Плюсы (Почему это гениально)​

• Уровень комфорта XXI века: Вы отлаживаете ретро-код, сидя в современном редакторе с подсветкой, мышкой и вкладками. Никакого мерцания и 64-колоночного текста.
• Условные брейкпоинты: (HL == 0x4000) && (A > 5) — остановка по сложному условию. Для сложных багов это спасение.
• Обратная отладка: Перестал быть актуальным "HALT и перезапуск". Просто отмотал назад и увидел ошибку.
• Code Coverage: Мгновенно видно, какие части кода выполняются, а какие — мёртвый груз.
• Поддержка реального железа: Отладка прямо на ZX Next — это вообще за гранью добра и зла.
• Интеграция с VS Code: Всё остальное (Git, задачи, терминал) тоже под рукой.
• Активная разработка: Автор (maziac) постоянно обновляет и улучшает расширение.

Минусы (О чём нужно знать)​

• Сложность настройки: launch.json, файлы листинга, пути к эмуляторам — новичку придётся повозиться. Но это делается один раз на проект.
• Требует современного ПК: Нужен компьютер, где работает VS Code (хотя сейчас это почти любой).
• Нет встроенного ассемблера: DeZog только отлаживает. Компилировать код нужно отдельно (sjasmplus и т.д.).
• Для zsim нет графики: Встроенный симулятор эмулирует только процессор, не видео. Для отладки графики нужно подключать полноценный эмулятор (ZEsarUX/CSpect).

СОВЕТЫ БЫВАЛОГО (ОПТИМИЗАЦИЯ РАБОТЫ)​

1. Всегда включайте генерацию листинга в вашем ассемблере. Для sjasmplus это флаг --lst. Без него DeZog будет показывать только дизассемблер, а не ваш красивый исходный код.
2. Правильно указывайте вершину стека. Если "topOfStack" указан неверно, стек вызовов будет отображаться некорректно, и вы не увидите, откуда пришла программа.
3. Используйте условные брейкпоинты для поиска багов. Например, если игра вылетает, когда счёт становится больше 1000, поставьте брейкпоинт на изменение переменной score с условием score > 1000.
4. Сохраняйте историю побольше. Если позволяет память, ставьте reverseDebugInstructionCount в 50000-100000. Тогда можно отматывать далеко назад.
5. Смотрите память в удобном формате. Для экранной области удобно выбрать отображение "Byte" (байты) или "ASCII". Для таблиц спрайтов — "Word" (слова).
6. Комбинируйте с Z80 Macro-Assembler. Вместе они дают полный цикл: написание кода + отладка в одном окне.

ЗАКЛЮЧЕНИЕ: ОТЛАДКА БУДУЩЕГО ДЛЯ КОМПЬЮТЕРА ПРОШЛОГО​