Просмотр исходного текста страницы Stalker Stealth Monitor

[[Изображение:STS_debugger.png|right]]
'''STalker Stealth Monitor''' ('''STS''') — теневой [[монитор-отладчик]], написанный Дмитрием Парцырным ([[Stalker]]) из [[Харьков]]а и дорабатывавшийся разными людьми ([[Иван Рощин]], [[Alone Coder]]).

Текущая версия 7.4 доработана [[Alone Coder]]

== Отличия STS7.x от STS6.x ==

* возврат в вызвавшую программу через RET;
* полный #3d13. Не требуется вводить #5cf4 при трассировке загрузчиков. Невозможно запороть диск. Сработает любой способ подключения HDD или рамдиска, поддержанный в TR-DOS;
* поскольку STS7.x основан на STS5.x, то в нём нет поддержки расширенной памяти компьютеров Scorpion, Profi, ATM и др. (есть отдельная сборка под АТМ2);
* есть дизассемблирование! Выходной текст короче, чем он был в v5.x, но его всё равно можно, не отходя от кассы, импортировать в ALASM (версия ALASM должна быть не ниже
4.47fff);
* разрешено использовать 1M по пентагоновскому стандарту;
* резидент сокращён на 3 байта (теперь 31) и не будет портить RAMTOP при размещении по адресу 23698 (резидент STS6.2 вообще не помещается в системных переменных - в нём 46 байт);
* для ALASM есть специальная (плавающая - с каждой версией меняется) точка входа, которая не портит регистровую модель отлаживаемой программы;
* исправлены ошибки с меткой верхней строки, с определением состояния прерываний, с инициализацией дисковода;
* есть русский шрифт (CP866) и его поддержку можно включать и выключать кнопкой Y;
* подсчёта тактов нет;
* версия 7.x занимает только одну страницу памяти, не считая память ниже #DB00 (обычно буфер каталога ALASM'а - ALASM затирал кусок STS6.2, если ассемблирование проводилось до первого выхода в STS), и не требует дискету с оверлеями;
* опрос клавиатуры синхронизирован с прерываниями - не требуются нелепые настройки, курсор движется быстрее;
* в режиме Caps Lock можно вводить маленькие буквы (с Caps'ом);
* автоматически выключает кэш - не повиснет при отладке кэшевых программ;
* не забывает положение курсора после перемещения по каталогу диска (Extend);
* не забывает номер банка после выхода в ALASM и входа обратно;
* правильно ставит параметры бейсик-файлов при сохранении с расширением .B;
* все регистры видны на одном экране, не нужно переключать наборы регистров;
* области пользователя нет, используется память #ff00, которая уничтожается при работе с диском;
* нет кнопки SETUP - переключение дисководов теперь по ss1, а переключение ПЗУ (Basic/DOS) по кнопке E;
* есть исходник с настройками, в котором вы можете включить какие-нибудь из выброшенных функций (например, подсказки, память пользователя или звук) и перекрасить окошки по своему вкусу.

== Управление курсором ==

CURSOR ([CS+5/6/7/8/9])

[cs+3] - Page Up - страница вверх

[cs+4] - Page Down - страница вниз

[ss+8] - скроллинг текста вверх

[ss+9] - скроллинг текста вниз


== Режим редактирования ==

CURSOR ([cs5]-влево, [cs8]-вправо)

[cs+6] - курсор вниз на строку

[cs+2] - CAPS LOCK - режим больших букв

[cs+0] - BACKSPACE - забой

[Break] - CANCEL - отмена

[ENTER] - ввод

== Управление панелями ==

[cs+1] - переключить экраны

[ss+3] - перекл. Dec/Hex

[ss+4] - перекл. Disasm/List(дамп)

[ss+5] - вкл/выкл показ меток. Анализируется содержимое первой страницы меток ALASM (при входе из ALASM в STS записывается номер страницы и адрес начала меток ALASM). Если меток больше 16k, то ничего не получится!

[cs+ss] - режим каталога диска. Вызываются все дисковые команды (смена дисковода, запись/чтение файла, запись/чтение сектора), при этом имя файла автоматически копируется с позиции курсора. Чтение файла возможно также по клавише <ENTER>.

== Команды-окна с параметрами ==

[Q] - Quit. Перед выходом восстанавливается SP (какой был при запуске STS), IY=#5C3A. Quit To BASIC выходит в бейсик через JP #0058. Из TR-DOS можно вернуться по команде RETURN.

[I] - Fill block. Заполнение участка памяти блоком кодов длиной 1..8 байт, символ "▒" используется для определения конца блока, передвигается с помощью ввода новых символов и DELETE ([cs+0]). Резидент восстанавливается, его можно затирать.

[O] - Copy block. Резидент не восстанавливается!

[L] - Load file. После ввода имени файла STS читает каталог диска, определяет наличие файла, и если таковой имеется, выдает в строках Start и Len информацию о файле (старт и длина) из каталога.

[S] - Save file. Для перезаписи файла на старое место после ввода расширения файла нажмите не [ENTER], а [ssENTER] и удерживайте [ss] примерно 1 секунду. Файл перезапишется на
старое место из памяти - с адреса и с длиной согласно каталогу.

[ss+L] - Load sectors, [ss+S] - Save sectors. STS может правильно прочитать/записать не только TR-DOS сектора, но и 1 сектор MS-DOS, IS-DOS и других систем, у которых длина сектора не равна 256 байтам. #3d13 этому не мешает. Резидент восстанавливается, его можно затирать, но нельзя затирать переменные TR-DOS. Также нельзя нажимать Break.

[R] - Set Resident address. По умолчанию=23698.

[B] - Set Bank. Значение для порта 32765=#7FFD. Описание битов порта #7FFD:
 0,1,2 - переключение страницы ОЗУ в фирменном ZX Spectrum 128
 3 - номер активного экрана
 4 - номер ПЗУ: 0=Basic128, 1=Basic48
 5 - защелка порта, 1=48k компьютер. Для Pentagon 1M - ещё один бит номера банка.
 6,7 - дополнительные биты номера страницы ОЗУ для расширений 512k/256k(Pentagon), в фирменном 128-ом не используются. 7-й бит также поддерживается компьютером KAY1024, за счёт этого KAY1024 тоже может полноценно работать с STS7.x, лежащим вне основных страниц ОЗУ.

[ss+1] - Выбрать дисковод. От A до D.

[M] - Set MemAdr. Установка адреса, с которого будет выводиться информация в панели.

[F] - Find. Поиск блока байтов, текста или команды Z80 по 'AND' маске: байты из памяти маскируются, т.е. биты с маской 1 остаются, с маской 0 - выключаются и сравниваются с
маскированным значением в "bytes". (Inverse - поиск до первого НЕсоответствующего байта.) Если последовательность не найдена во всех 64K памяти с текущим Bank, то BORDER будет красным.

== Команды без параметров ==

[N] - find Next. Продолжение поиска с позиции курсора. Если панель находится в режиме List, то строка будет найдена точно в позиции курсора. В режимах Disasm такой точный поиск сработает только верхней строке панели (из-за различной длины команд Z80).

[ss+M] - MemAdr=PC. Переходим туда, где в данный момент "застыл" виртуальный процессор Z80.

[P] - MemAdr=адрес, упоминаемый в тексте, где стоит курсор.

Примеры:

 1) курсор стоит на регистре HL #E234; жмем [P]=> перейдем на #Е234;

 2) курсор на команде LD IX,#8456; жмем [P]=> перейдем на #8456.

[ss+P] - Return to old MemAdr. Вернуться назад после перехода по кнопке [P]. STS помнит 32 последних перехода.

[A,1/2/3/4/5] - запомнить MemAdr. Нажать [A], отпустить, нажать номер ячейки: от 1 до 5 (по умолчанию в этих ячейках адреса #6000, #8000, #c000, #5d3b и #5cf4 соответственно).

[1/2/3/4/5] - MemAdr=запомненный Adr.

[ss+N] - DumpAdr(адрес ячеек, светящихся вверху экрана)=SP

[V] - DumpAdr=cursor

[Z] - PC=cursor

[E] - переключение ПЗУ (BASIC/DOS). В ПЗУ TR-DOS команды OUT/IN, а также команды, читающие само ПЗУ TR-DOS, не эмулируются!

== Команды отладки ==

[W] - Write break point. Поставить точку останова (3 байта). Когда отлаживаемая программа дойдёт до этой точки, она возвратится через Резидент в STS и восстановит эти 3 байта как было. Не использует Stack. Одновременно можно поставить только одну точку! После Quit в Монитор можно вернутся не только через #db00, но и через Break Point.

[ss+K] - Jump to PC with Screen 1

[ss+J] - Jump to PC with Screen 0

[ss+Z] - Step command. Выполнение текущей команды Z80.

[ss+X] - Step command with Run CALL. То же самое, но команды CALL запускаются из Resident'а. Эту команду, в отличие от следующей, можно выполнять в ПЗУ.

[ss+T] - Run+Break. После текущей команды ставится Breakpoint, после чего STS смело прыгает в эту команду. Так можно делать только в ОЗУ.

[U] - Перейти к памяти User'а в банке STS. Изначально там RET'ы.

[ss+U] - Call User subroutine. Вызов того, что вы там написали.

[J] - Jump Adr. При запуске устанавливается 0-й экран. Возврат в STS - через точки останова.

[C] - Call Adr. То же, но возврат - через RET. Отлаживаемая программа не должна использовать область памяти Резидента.

[Т] - Trace. Окно трассировки в пошаговом режиме:
 GO - начало трассировки;
 Indicate - с индикацией/без нее (без индикации включается 0-й экран);
 ReDisasm - с перерисовкой панели после каждой команды или без;
 Stop if Dos - останов при переходе к TR-DOS. При входе автоматически включается просмотр TR-DOS; при выходе - отключается;
 Stop if Find - останов по заданной в Find команде, Inverse не работает;
 Stop if User - при отладке каждой команды запускается подпрограмма пользователя из области User'а (см.про [U]). Если она возвращает NZ (или ничего не меняет), то продолжается
трассировка, иначе останов. Примеры использования этой навороченной функции:
 1) Необходимо остановиться, когда в ячейке (#7345) будет #34:
 [U], вводим подпрограмму:
LD A,(#7345)
CP #34
RET
 2) Необходимо остановиться, когда в HL=#1243:
 [U], вводим подпрограмму:
LD HL,(#FEEC) ;(см.ниже про адреса регистров)
LD DE,#1243
AND A
SBC HL,DE
RET
 Stop on Adr - остановка на адресе;
 Trace Bank - вкл./выкл. обработки команд вывода в порт #7ffd (проверяются 1-й и 15-й разряды адреса). При выкл. они не будут переключать память, при вкл. - будут;
 Trace Call - вкл./выкл. трассировки команд CALL. При вкл.отладчик заходит 'внутрь' процедуры ([ssZ]), при выкл. - запускает ([ss+X])

[D] - Disasm To Disk. Дизассемблирование на Диск. В первом окошке указываете:
 Start - адрес начала дизассемблируемой области памяти.
 End - адрес её конца (включительно! в Copy и Fill - тоже). End не должен быть равен #FFFF=65535.
Во втором окошке:
 Start - начало локального блока, вычисляется автоматически.
 End - адрес конца локального блока.
 Disasm/DEFB N - дизассемблер/дамп памяти (по N байт в строке).

Дизассемблирование происходит в два прохода. На первом создается таблица меток (используется буфер #c000-#daff в странице STS'а), на втором собственно и происходит дизассемблирование с выгрузкой на диск (буфер организуется по адресу #4000).

== Дополнительная информация ==

При запуске STS из 7-й страницы используется 1-й экран, иначе 0-й.


Некоторые ошибочные ситуации отображаются изменением цвета BORDER'а: красный - последовательность не найдена в 64К памяти (команда Find) или Disk Error (не для #3d13 версии!); фиолетовый - неправильно введены мнемоники ассемблера. Расстояние между командой и ее операндами (данными) должно равняться 1 пробелу; число цифр в HEX числе должно быть строго 2 или 4, смотря по команде; команды типа RES 5,A,(IY+1) не ассемблируются; голубой - нет места на диске;

Резидент - блок кодов переменного содержания, но с постоянной длиной в 31=#1F байт (для STS7.0), размещается в области #4000..#BFFF (для 48k - в любой области). Резидент используется монитором для доступа к любой странице памяти (Bank). Резидент динамически изменяется и восстанавливается (не всегда, см. примечания к командам). При перемещении Резидента восстанавливается память, бывшая "под ним". Перед дисковыми функциями восстанавливается память "под Резидентом",а после - заново запоминается. При запуске STS память под Резидентом запоминается, при QUIT она не восстанавливается.

Расположение значений регистров Z80 в STS:
        +0 +2 +4 +8
#FEE4 : PC SP IX IY
#FEEC : HL DE BC AF
#FEF4 : R
#FEF5 : I
#FEF6 : HL'DE'BC'AF'
#FEFE : MemAdr

Подпрограмма вывода числа/метки в режиме показа меток лежит тут:
Адрес входа: #FE6C
Вход: bc=число для печати
      hl=позиция для печати(не всегда)
Необходимо сохранять: bc,de',ix

Что хранится в #ff00 (BUFFER) не во время дисковых операций:
#FF00 - user область при userarea=0; от #FF80 вниз - P_BUFFER для кн."P" (P_BUF_ADR);
#FFBE - адреса строк, показанных на экране;
#FFFF - портим для HALT при IM2.

== Связь с автором ==

STS6.2 написан Дмитрием Парцырным (STALKER) в сентябре 1997.
Его адрес на тот момент:
310002, г.Харьков, ул.маршала Бажанова, д.12, кв.52 (0572)452569

== История версий ==

Исходники были переданы автором Faster'у из TNL, тот отдал их Capry из Stall, а Capry отдал мне (Alone Coder'у). Я передал авторские диски исходников Crank'у из Techno Lab в свободное распространение.

[[Категория:Отладчики]]