Skip to content

Latest commit

 

History

History
170 lines (121 loc) · 12.9 KB

MANUAL.md

File metadata and controls

170 lines (121 loc) · 12.9 KB

Руководство пользователя

Установка программы

Windows

  • Скачайте архив из раздела Releases. Для Windows 7 используйте файл ecat-3.X.X-windows-i386.zip, для Windows 10+ – ecat-3.X.X-windows-x86_64.zip.
  • Распакуйте архив и запустите ecat3.exe.

macOS

Для правильной работы клавиатуры необходимо оставлять фокус на окне с меню и кнопками.

  • Скачайте файл dmg из раздела Releases.
  • Скачайте библиотеку SDL2 из её репозитория. Используйте файл dmg.
  • Откройте dmg-файл библиотеки и перетащите иконку SDL2.framework в системную папку /Library/Frameworks.
  • Откройте dmg-файл программы. При первом запуске система сообщит, что запретила выполнение библиотеки SDL. Перейдите в системные настройки ОС, раздел Безопасность, и разрешите использование библиотеки.
  • Запустите программу еще раз. При необходимости подтвердите разрешение в отрывшемся окне.

Linux

Для правильной работы клавиатуры необходимо оставлять фокус на окне с меню и кнопками.

  • Скачайте файл ecat-3.X.X-linux-x86_64.AppImage из раздела Releases, сделайте его исполняемым и запустите.

Главное окно

Основные операции

Выбор компьютера

  • Вариант 1: с помощью кнопки на панели главного окна.
  • Вариант 2: С помощью пункта меню «Файл/Выбор компьютера...».

Если перед нажатием «ОК» отметить флажок «Установить по умолчанию», данная машина будет открываться по умолчанию при следующем запуске эмулятора.

Перезагрузка

  • Холодный перезапуск (с очисткой памяти) с помощью кнопки или соответствующего пункта меню «Эмуляция».
  • Теплый перезапуск (без очистки памяти) с помощью кнопки или соответствующего пункта меню «Эмуляция».

Работа с файлами

Прямая загрузка в память

Результат будет отличаться в зависимости от выбранного компьютера. В общем случае файл будет напрямую загружен в память, минуя все программные механизмы эмулируемого компьютера.

Подробности смотрите в описании компьютера при его выборе в соответствующем окне.

  • Вариант 1: с помощью кнопки на панели главного окна.
  • Вариант 2: С помощью пункта меню «Файл/Открыть файл...».

Дисководы

Если в конфигурации компьютера есть дисководы, то в панели управления появляется одна или несколько кнопок . У каждой кнопки есть дополнительное меню, с помощью которого можно посмотреть, какой образ загружен, загрузить другой файл, сохранить измененный образ на диск.

Нажатие на саму иконку позволяет быстро выбрать образ, не открывая меню.

В моменты обращения компьютера к диску стрелка на иконке становится красной:

Примечание: возможность сохранения образа в различные форматы зависит от выбранного компьютера. В частности, для компьютера «Агат» пока есть возможность сохранения только в физическом формате MFM.

Загрузка с магнитофона


Автор изображения – McClaud

Иконка магнитофона появляется в панели, если магнитофон есть в конфигурации компьютера.

  1. Открыть окно эмулятора магнитофона кнопкой в главном окне программы;
  2. Открыть файл кнопкой «СТОП/ВЫБРОС» (самая правая с синим индикатором);
  3. Запустить воспроизведение кнопкой «ПУСК»;
  4. Действия в эмулируемой системе описаны в документации к конкретной машине.
  5. Другие действия:
    • Кнопка «ОСТАНОВ» – пауза;
    • Кнопка «СТОП/ВЫБРОС» – при воспроизведении – остановка, второе нажатие – открыть файл;
    • Кнопка «ПЕРЕМОТКА ВЛЕВО» – сброс текущей позиции файла на начало.
    • Регулятор «ГРОМКОСТЬ» – заглушить звук.

Средства отладки

Состояние устройств

Все доступные устройства перечислены в меню «Эмуляция/Устройства». Те устройства, для которых доступно отладочное окно, выводятся черным цветом. Если отладочное окно недоступно – серым.

Отладочное окно процессора является одновременно основным отладчиком в системе.

Основной отладчик


Окно отладчика для процессора Z80

Основной отладчик может быть вызван тремя способами:

  1. С помощью кнопки на панели главного окна.
  2. С помощью пункта меню «Эмуляция/Отладчик».
  3. Через меню «Эмуляция/Устройства», если открыть окно отладки устройства CPU.

Окно отладчика содержит следующие элементы:

  • Панель состояния с кнопками управления;
  • Панель дизассемблера;
  • Две панели состояния регистров и флагов процессора;
  • Панель дампа памяти (так, как память видит сам процессор с учетом диспетчера).

Панель состояния

Верхняя панель состоит из четырех блоков:

  • Символ режима работы процессора:

    • – процессор запущен без отладки;
    • – процессор остановлен;
    • – процессор запущен под отладчиком, отслеживаются точки останова и состяние регистров;

  • Блок управления выполнением:

    • – возврат курсора панели дизассемблера на текущую точку исполнения;
    • – шаг внутрь (с заходом в подпрограмму), короткая клавиша F7;
    • – шаг поверх (без захода в подпрограмму), короткая клавиша F8;
    • – выполнить до курсора, короткая клавиша F4;
    • – запустить под отладчиком (с отслеживанием точек останова), короткая клавиша F9;
    • – останов процессора;
    • – запуск без отладки.

  • Блок управления панелью дизассемблера:

    • Строка ввода адреса или значения регистра;
    • – переключение панели дизассемблера на введенный адрес (установка курсора);
    • – установка точки останова на адрес под курсором. (Для установки точки сначала необходимо нажать кнопку установки курсора на нужный адрес!);
    • – удаление точки останова с адреса под курсором. (Курсор должен стоять на нужном адресе!);
    • Выпадающий список с именами регистров;
    • – запись значения в выбранный регистр.

  • Блок управления панелью дампа памяти:

    • Строка ввода адреса;
    • – переключение панели дампа на введенный адрес;
    • – переход на страницу вниз;
    • – переход на страницу вверх.