⏱️ Z80 ASSEMBLY METER: ВАШ КАРМАННЫЙ ОСЦИЛЛОГРАФ ДЛЯ VS CODE

​

​

​

ВСТУПЛЕНИЕ: ОТ СЕКУНДОМЕРА К ПРОФЕССИОНАЛЬНОМУ ИНСТРУМЕНТУ​

ЧТО ТАКОЕ Z80 ASSEMBLY METER И ЗАЧЕМ ОН НУЖЕН?​

1. Количество тактов (t-states) — сколько процессорных циклов займёт выполнение этого кода.
2. Размер в байтах — сколько памяти займёт скомпилированный код.
3. Мнемонику инструкции — для сверки, правильно ли расширение поняло команду.

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

1. Мгновенный подсчёт тактов — выделил блок кода, и сразу видишь его "вес" в тактах.
2. Подсчёт размера — контроль за тем, сколько байтов займёт процедура в памяти.
3. Поддержка разных платформ — Z80, MSX (с учётом M1 wait cycles), Amstrad CPC (в NOP-ах) и ZX Spectrum Next (с расширенным набором команд) .
4. Копирование в буфер — кликнул на результат — и он скопирован в clipboard.
5. Работа с выделением — если ничего не выделено, анализируется текущая строка.
6. Поддержка псевдоинструкций SjASMPlus — для тех, кто использует этот ассемблер .

ИСТОРИЧЕСКИЙ КОНТЕКСТ: КАК СЧИТАЛИ ТАКТЫ РАНЬШЕ​

УСТАНОВКА И НАСТРОЙКА: ПЯТЬ СЕКУНД — И ВЫ В ИГРЕ​

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

1. Запустите Visual Studio Code.
2. Нажмите Ctrl+Shift+X (или иконку квадратиков слева).
3. В поиске введите "Z80 Assembly Meter".
4. Найдите расширение от автора theNestruo (иконка с синим микрочипом и циферблатом) и нажмите Install.

Базовая настройка (почти ничего не нужно)​

{
    // Для какой платформы считаем такты
    "z80-asm-meter.platform": "z80", // Варианты: z80, msx, cpc, z80n
 
    // Показывать ли опкоды в статус-баре
    "z80-asm-meter.viewBytes": false,
 
    // Показывать ли распознанную инструкцию (полезно для отладки)
    "z80-asm-meter.viewInstruction": true,
 
    // Максимальное число инструкций для отображения в подсказке
    "z80-asm-meter.maxBytes": 16,
 
    // Поддержка псевдоинструкций SjASMPlus
    "z80-asm-meter.sjasmplusFakeInstructions": false,
 
    // Синтаксис меток (default или colonOptional)
    "z80-asm-meter.syntax.label": "default"
}

Выбор платформы: кому что​

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

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

1. Ставите курсор на любую строку с ассемблерной командой.
2. Смотрите в правый нижний угол статус-бара.
3. Видите: LD A,(HL) — 7 t-states, 1 byte.

1. Выделяете мышкой целую процедуру (например, цикл копирования экрана).
2. Статус-бар мгновенно обновляется: 892 t-states, 124 bytes.
3. Если блок большой, можно кликнуть на результат — откроется детальный разбор по каждой команде.

1. Кликнули левой кнопкой по показаниям в статус-баре.
2. В буфере обмена: "892 t-states, 124 bytes".
3. Вставили в комментарий к процедуре — готово, документировали.

Что именно показывается​

892 t-states | 124 bytes | LD A,(HL)

Нажмите, чтобы развернуть...

• 892 t-states — общее количество тактов на выделенный блок.
• 124 bytes — размер в байтах.
• LD A,(HL) — текущая инструкция (если включено viewInstruction). Помогает убедиться, что расширение правильно поняло синтаксис.

Как читать детали​

Инструкция                    Такты   Байты
-------------------------------------------
    ld hl, 16384             10      3
    ld de, 16385             10      3
    ld bc, 6911              10      3
    ld (hl), 0               7       2
    ldir                      21/16?  2
-------------------------------------------
ИТОГО:                        58 + 21*6910?  13 байт

ДИРЕКТИВЫ И ПОДДЕРЖИВАЕМЫЙ СИНТАКСИС​

Что понимает Z80 Assembly Meter​

1. Полный набор команд Z80 — все стандартные инструкции, включая битовые операции, блочные передачи, индексные режимы (IX, IY) .
2. Расширенный набор Z80N — для ZX Spectrum Next: MUL D,E, JP (C), SLOT и другие .
3. Псевдоинструкции SjASMPlus — если включить опцию sjasmplusFakeInstructions, расширение будет понимать директивы вроде EXIT, CONTINUE, MODULE .
4. Разные стили меток — можно настроить, обязательны ли двоеточия после меток (label: или просто label) .

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

• Z80 Macro-Assembler (mborik) — для написания кода.
• Z80 Assembly (Imanolea) — альтернативная подсветка.
• MSX Z80 (Yeoungman Seo) — для MSX-разработчиков.
• pasmo (BouKiChi) — поддержка синтаксиса Pasmo.
• DeZog (Maziac) — для отладки.

1. Z80 Macro-Assembler — пишешь код с автодополнением.
2. Z80 Assembly Meter — видишь стоимость каждой строчки.
3. DeZog — отлаживаешь результат.

СРАВНЕНИЕ: Z80 ASSEMBLY METER VS ТРАДИЦИОННЫЕ МЕТОДЫ​

Почему это победа​

• Скорость: не нужно переключаться между окнами.
• Точность: расширение использует официальные таблицы тактов из авторитетных источников :
  • Grauw MSX Assembly Page для Z80.
  • cpctech.org.uk для Amstrad CPC.
  • Официальная вики ZX Spectrum Next.
• Наглядность: видно стоимость прямо над кодом.
• Документирование: можно сразу вставить результат в комментарий.

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

Плюсы (Почему это must-have)​

• Мгновенная обратная связь: написал строку — увидел стоимость. Оптимизация становится частью процесса написания кода, а не отдельным этапом.
• Простота: не нужно ничего настраивать. Установил — работает.
• Поддержка трёх платформ: Z80, MSX, CPC, Next — универсальный солдат.
• Интеграция с экосистемой: работает вместе с другими расширениями, не конфликтует.
• Копирование в clipboard: кликнул — вставил в комментарий. Идеально для документирования критичных по времени процедур.
• Открытый исходный код: можно посмотреть, как считает, и даже исправить, если что-то не так .
• Вдохновлён классикой: автор упоминает, что создавал расширение, вдохновляясь утилитой Rafael Jannone BiT — дань уважения старой школе.

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

• Только для VS Code: если вы пишете в другом редакторе — не подойдёт.
• Не анализирует динамику: расширение считает статическую стоимость блока, но не может предсказать, сколько раз выполнится цикл (это зависит от данных). Для циклов нужно умножать в уме.
• Может путаться с макросами: если вы используете сложные макросы, расширение может не развернуть их полностью. Лучше анализировать уже развёрнутый код.
• Не поддерживает все ассемблеры: если вы используете экзотический синтаксис, возможно, придётся подстраивать настройки languageIds .
• Нет GUI для настроек: все опции правятся в JSON-файле, что для новичков может быть неочевидно.

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

1. Всегда держите статус-бар на виду. Если вы не видите показаний, проверьте, включено ли расширение для вашего языка (в настройках z80-asm-meter.languageIds).
2. Анализируйте критические участки. Для процедур, выполняющихся в прерываниях или в активной игре, каждая микросекунда на счету. Пройдитесь по ним с метром.
3. Сравнивайте варианты. Написали процедуру двумя способами? Выделите первый блок — запишите такты. Выделите второй — сравните. Выбирайте быстрейший.
4. Документируйте результат. Кликнули по статус-бару — скопировали результат — вставили в комментарий над процедурой. Через полгода скажете себе спасибо.
5. Учитывайте повторения. Для блоков с LDIR или циклами расширение покажет стоимость одной итерации. Умножьте на количество итераций вручную.
6. Используйте правильную платформу. Если пишете под MSX, не забудьте переключить platform на msx — такты с учётом M1 wait отличаются от классических .
7. Для Next включайте z80n. Расширение поддерживает команды ZX Spectrum Next, так что можно сразу видеть, насколько быстрее умножение нативным MUL по сравнению с софтовым.

ЭКОСИСТЕМА: ИДЕАЛЬНЫЙ КОМБО​

ЗАКЛЮЧЕНИЕ: МАЛ, ДА УДАЛ​