1.57 PETRA - Контроль трассировщика с помощью AMO

AMO PETRA может использоваться для создания, опроса и остановки процедур трассировки в платах периферийных модулей SWU. Кроме того, возможен вывод содержания памяти этих модулей.

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

Периферия (PP)  группы LTG собирает эти данные и разделяет их в соответствии со значениями параметров TRACE и DUMP, на одиночные сегменты памяти. По запросу AMO, PP передает эти данные AMO.

После этого данные TRACE могут выводиться целиком или по частям, как это задано командой AMO PETRA. Данные DUMP передаются командой AMO непосредственно на терминал.

Команда AMO PETRA может использоваться для большинства периферийных модулей.

При попытке активизации загружаемого ПО TRACER в модуле, который не поддерживает трассировку выводится сообщение об ошибке "F05: BOARD HAS NO PERIPHERAL TRACER". (По указанному адресу определяется тип модуля и сравнивается со значением в UBGDAT)

Это применимо и к DUMP.

1.57.1 Функции AMO

ADD-PETRA	:	Создание TRACER в одной плате
DISPLAY-PETRA	:	Получение памяти TRACE
		Получение и вывод памяти DUMP
OUTPUT-PETRA	:	Вывод памяти TRACE
DEACTIVATE-PETRA	:	Деактивизация созданной TRACER
STOP-PETRA	:	Прекращение выделения памяти  TRACE

1.57.2 Взаимосвязи

Нет

1.57.2.1 ADD-PETRA

1.57.2.1.1 Создание процессов TRACE в стандартных модулях (STD)

Команда создания используется для активизации процедуры трассировки в плате. При этом один, несколько или все процессы платы (0...15) передают данные TRACE периферии (PP).
Несколько процедур TRACE могут активизироваться последовательно. Результаты маркируются для каждого LTG в PP в соответствии с отправителем и собираются в общем буфере TRACE. При переполнении буфера запись начинается сначала (циклическая память).

Каждая периферийная плата требует собственного здания активизации TRACER. Инициализация платы, которая уже была активизирована не вызывает ошибки; это разрешает активизацию процессов в той же плате.

Примечание:

В каждом случае активизируются только те процессы, которые были указаны в последней команде. Процессы, которые были активизированы ранее, но не указаны в последней команде, деактивизируются. 

Обзор процедуры

Код команды	Параметры
ADD-PETRA	TYPE=STD,[LTG=<число>],LTU=<число>
	,SLOT=<число>,[CCT=<число>],PROC1=<число>
	,[PROC2=<число>];

Пример

Для процессов 1, 3, 5 по 9 и 11 должна выполняться трассировка LTG=1, LTU=2, SLOT= 19, и плата=5.

Ввод:

ADD-PETRA:STD,1,2,19,5,1&3&5&&9&B;

1.57.2.1.2 Трассировка процессов в специальных модулях (HEX)

В некоторых модулях (например, CMI) процессы трассировки активизируются более длинной командой. Это возможно с помощью ветви параметров HEX. Максимальная длина одной команды - 64 байта.

Параметр LENGTH указывает количество значений HEX. Параметр CCT определяется не всеми модулями (вы не должны использовать этот параметр для модулей CMI).

Обзор процедуры

Код команды	Параметры
ADD-PETRA	TYPE=HEX,[LTG=<число>],LTU=<число>,SLOT=<число>
	,[CCT=<число>],LENGTH=<число>,[HEX01=<число>]
	,[HEX02=<число>]....[HEX64=<число>];

Пример

Модуль ожидает команды A157BD300F.

Ввод:

ADD-PETRA:HEX,,2,43,,5,A1,57,BD,30,0F;

1.57.2.1.3 Запуск процессов TRACE в модулях LTUR

В модулях ROLM полки LTUR, процедуры трассировки не задаются указанием процессов. Процесс трассировки активизируется управляющим кодом длиной 2 байта. Этот код задается как 2 объединенных одиночных значения, ввода с помощью параметра PROC: PROC= <byte 1> & <byte 2>.

Состав 2 байтов трассировки (согласно "LTUR trace Function - Component spec, ROLM Systems, автор: Esther Poon"):

Байт I: T on off TRACE Class / Trigger code

Рис. 64 Структура кода управления трассировки

a)

T-on/off = 1: Активизация функций трассировки 1 on off all ckt snd only rcv only int task 7 6 5 4 3 2 1 0

Рис. 65 Функции трассировки

ON/OFF BIT: если задан, указывает на необходимость сброса состояний трассировки (если было включено).
SEND ONLY BIT: если задан, трассировка только передаваемых сообщений.
RECEIVE ONLY BIT: если задан, трассировка только принимаемых сообщений.
ALL CIRCUIT BIT: если задан, индикация состояния всех плат в объекте трасссировки. Если этот бит задан, номер платы из сообщения игнорируется.
INTERNAL TASK BIT: если задан, отчет о внутренних функциях (отличающихся от сообщений почтового ящика).

b)

T-on/off = 0: Условия остановки для функций трассировки 0 Класс трассировки Код переключателя трассировки 7 6 5 4 3 2 1 0

Рисунок 66 Классы трассировки и коды переключателя

Имеется 4 класса трассировки (бит 6 - 4) для задания условий, которые деактивизирует функцию трассировки. Эти классы имеют свои специфичные коды переключателя (бит 3 - 0).

	Код класса	Определение класса трассировки	Код переключателя трассировки
	000	OV2	N/A
	001	ERR CODE	заданный код ошибки
	010	STATE CODE	заданной номер состояния
	другие	не задан

OV2: если задан, трассировка должна быть прервана при превышении порога 2.
ERR CODE: если задан, трассировка должна быть прервана, если обнаружен заданный код ошибки (бит 3 - 0) указанной задачи/модуля.
STATE CODE: если задан, трассировка должна быть прервана, если обнаружено заданное состояние (бит 3 - 0) указанной задачи/модуля.

Byte II: mm imf Идентификатор задачи/модуля 7 6 5 4 3 2 1 0

Рис. Идентификатор задачи модуля

MM (MAIN MICRO) BIT: если задан, состояние трассировки должно быть задано для индикации компонентов в главном процессоре.
IMF (сервер IMF/DFE) BIT: если задан, состояние трассировки должно быть задано для индикации компонентов в сервере IMF/DFE.
TASK/MODULE ID (bit 5 - 0): если заданы MM BIT или IMF BIT, идентификатор задачи/модуля определяет разные задачыи или модули, которые должны быть активизированы/деактивизированы для трассировки.

Ниже приведены возможные значения байта II.

Byte II    mm     imf    Идентификатор задачи/модуля Значение идентификатора задачи/модуля
  00        0      0        0                No task in neither MM nor IMF 
  40        0      1        0                No task/module in IMF/DFE Server 
  41        0      1        1                I_ICONFIG 
  42        0      1        2                I_Restart 
  43        0      1        3                I_IPRC sender 
  44        0      1        4                I_IPRC receiver 
  45        0      1        5                IMF/DFE engine interface 
  4A        0      1       10                RLI/DFE 
  4B        0      1       11                State messaging circuit state machine 
  4D        0      1       13                I_Card state machine 
  4E        0      1       14                TTI_BS state machine 
  4F        0      1       15                DID_BS state machine 
  51        0      1       17                ATI_BS state machine 
  52        0      1       18                DIR_BS state machine 
  7F        0      1       3F                All tasks/modules in IMF/DFE Server 
  80        1      0        0                No task/module in MAIN 
  81        1      0        1                M_ICONFIG 
  82        1      0        2                M_Restart 
  83        1      0        3                M_IPRC sender 
  84        1      0        4                M_IPRC receiver 
  85        1      0        5                Connection management 
  86        1      0        6                Config assimilator 
  8A        1      0       10                RLI dependability 
  8B        1      0       11                RCC 
  8C        1      0       12                DFE 
  8D        1      0       13                M_Card state machine 
  8E        1      0       14                TTI circuit state machine 
  8F        1      0       15                DID circuit state machine 
  90        1      0       16                COT circuit state machine 
  91        1      0       17                ATI circuit state machine 
  92        1      0       18                T1 circuit state machine
  BF        1      0       3F                All tasks/modules in MAIN

Обзор процедуры

Код команды	Параметры
ADD-PETRA	TYPE=LTUR,[LTG=<число>],LTU=<число>
	,[SLOT=<число>],CCT=<число>,BYTE1=<шестн. знач.>
	,BYTE2=<шестн. знач.>;

Пример

Трассировка процессов 1, 3, 5 по 9 и 11 осуществляется из LTG=1, LTU=2, SLOT=19, номер платы =5.

Ввод:

ADD-PETRA:STD,1,2,19,5,1&3&5&&9&B;

Модуль LTUR в LTG=1, LTU=4, SLOT=133, номер платы =3, должен быть задан для трассировки с помощью управляющего кода A8 и 7F.

Ввод:

ADD-PETRA:LTUR,1,4,133,3,A8,7F;

1.57.2.2 DISPLAY-PETRA

1.	Получение данных TRACE.

2.	Получение и вывод данных DUMP.

Команда с параметром 'TRACE' используется для передачи данных, которые были собраны в сегменте трассировки системы периферийной обработки (PP) командой 'ADD'.
Сообщение заставляет PP передать сегмент данных с собранными данными TRACE в AMO.
Полученный сегмент доступен только один раз. При следующем опросе, AMO получает  из PP полностью новый сегмент с новыми данными. 
Данные трассировки, полученные от PP, можно выводить на экран с помощь команды "OUTPUT-PETRA" (см. следующий раздел). При указании параметра 'DUMP' на консоль выводится содержание памяти модуля.
Сообщение от PP заставляет модуль передать данные памяти их указанного адреса и указанной длины в (PP), где данные собираются в один сегмент. После получения последних данных они передаются в эту команду AMO и выводятся на терминал.
Максимальная длина области данных DUMP - 2048 байтов, так как для DUMP не создаются отдельные сегменты данных.  Новые модули с расширенной областью DUMP(например, STHC, SLTX) могут работать с памятью DUMP длиной до 8154 байтов.
В настоящее время возможно одновременное выполнение только одного задания DUMP. Дополнительные задания принимаются без вывода сообщения об ошибке, но не выполняются.

В модулях с процессором Motorolla адрес разделяется на параметры SEG и ADR. Например, для адреса 86754890 нужно ввести SEG=8675 и ADR=4890 (DISP-PETRA:DUMP,1,3,37,86,8675,4890,2048)

Обзор процедуры

Код команды	Параметры
DISPLAY-PETRA	TYPE=TRACE, [LTG=<число>];
	|TYPE=DUMP,[LTG=<число>],LTU=<число>,SLOT=<число>
	,CPU=51,SEG1=<параметр>,ADR=<шест. число>
	,[NO=<число>];
	|TYPE=DUMP,[LTG=<число>],LTU=<число>,SLOT=<число>
	,CPU=<параметр>,SEG=<hex>,ADR=<шест. число>
	,[NO=<число>];

Примеры

1.	Получение памяти TRACE из LTG=1.

Ввод:

DISP-PETRA:TRACE,1;

2.	Запрос и вывод памяти dump для модуля слот 37 и LTU номер 3 в LTG 1.

Ввод:

DISP-PETRA:DUMP,1,3,37,86,1234,5678,217;

Вывод:

   DUMP FUER   LTG  1   LTU  3   EBT  37
   1234:5670                           44 69 65 73 20 69 73 74  ........Dies ist
   1234:5680  20 65 69 6E 20 44 55 4D  50 20 20 20 20 20 20 20  ein DUMP
   1234:5690  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20
               "  "                     "  " 
   1234:56F0  00 01 02 03 04 05 06 07  08 09 0A 0B 0C 0D 0E 0F  ................ 
   1234:5700  10 11 12 13 14 15 16 17  18 19 1A 1B 1C 1D 1E 1F  ................
   1234:5710  20 21 22 23 24 25 26 27  28 29 2A 2B 2C 2D 2E 2F  ................
   1234:5720  30 31 32 33 34 35 36 37  38 39 3A 3B 3C 3D 3E 3F  0123456789:;<=>?
   1234:5730  40 41 42 43 44 45 46 47  48 49 4A 4B 4C 4D 4E 4F  @ABCDEFGHIJKLMN 
   1234:5740  44 55 4D 50 20 45 6E 64  65 20 20 20 20 20 20 20  DUMP Ende
   1234:5750  20

3.	Запрос и вывод памяти процессора MAIN/MICRO для модуля ROLM слот 127 и LTU номер 4 в LTG 1.

Ввод:

DISP-PETRA:DUMP,1,4,127,MM,3220,652A,46;

Вывод:

   DUMP FOR    LTG  1   LTU  4   EBT  127
   3220:6520                                 26 8A 47 06 3C 03            &.G.<.
   3220:6530  74 04 3C 04 75 2D 83 3E  0E 00 FF 73 0B 82 3E 71  t.<.u-.>...s..>q
   3220:6540  00 00 75 04 FF 06 0E 00  B8 A1 00 1E 50 B8 12 00  ..u.........P...
   3220:6550  1E 50 9A 44                                       .P.D

1.57.2.3 OUTPUT-PETRA 

После выполнения команды DISPLAY-PETRA выводится сообщение H3 и запрос "*" на ввод параметра NO и CONT.

Вместо перезапуска команды AMO эта функция основана на функции DISPLAY. Это делает возможным многократную проверку одни раз полученных данных. 

Оставшееся выполнение команды AMO управляется вторым параметром CONT. Пока значение параметра равно 'Y', может ввод новых команд DISPLAY. После ввода значения параметра 'N' команда AMO завершается и внутренний сегмент данных PETRA удаляется.

Каждая отдельная запись данных модуля имеет длину 16x8 бит, первый байт содержит номер LTU, второй - номер PBC, за которым следуют 14 байт данных TRACE. Для модулей TROSS51 эти данные состоят из трех индивидуальных байтов трассировки (1 пустого бита, 2 битовых флагов, 5 битов кода платы и 16 битов адреса); для модулей L3X и Rolm, в 14 байтах содержится одна запись трассировки.

Обзор процедуры

Код команды	Параметры
	[NO=<число>],[CONT=<параметр>];

Примеры

1.	Вывод полученных ранее данных TRACE и завершение AMO.

Ввод:

,N;

2.	Вывод 100 последних данных, полученных с использованием команды DISPLAY.

Ввод:

100;

Вывод:

   TRACE DATA FROM LTG  1
   LTU  SLOT   CCT   DATA
     1     1     0   9234 A345 D678 ABCD 88EF 99FA
     1     1     5   9234 D678 ABCD 88EF E7E7
   LTU   PBC  CIRCUIT  STATE PROC    BOARD HEADER  L3X HEADER  DATA
     4    11     0       3     4        8020 075      85 1 1   9A5A5A5
     4    11     0       1     4        8620 0 3      4320A5  A5A5A5A5
   LTU  SLOT   CCT   TR-TAG  DATA
     3    79     0      0    010203040506 07080910111213
   LTU  SLOT   CCT   DATA
     2    13     1   D432 A345 BADE AFFE 8080 8085 8086
     2    37     0   FEDE BAFF E969 DAEF 9111 8194 C711 A921 B368 8926 B764

1.57.2.4 DEACTIVATE-PETRA

Эта команда используется для деактивизации процедуры TRACE в плате.

Для каждой платы нужно ввести отдельную команду деактивизации трассировки.

Обзор процедуры

Код команды	Параметры
DEACTIVATE-PETRA	[LTG=<число>],LTU=<число>,SLOT=<число>,CCT=<число>;

Пример

Прекращение трассировки в модулей LTG=1, LTU=2, SLOT=19, номер платы=5.

Ввод:

DEACT-PETRA:1,2,19,5;

1.57.2.5 STOP-PETRA

Прекращение выделения памяти TRACE:

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

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

Обзор процедуры

Код команды	Параметры
STOP-PETRA	[LTG=<число>];

Пример

Освобождение памяти трассировки и остановка функции трассировки в LTG=1.

Ввод:

STOP-PETRA:1;

1.57.3 Описание параметров

ADR	Адрес DUMP
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	0 - FFFF
BYTE1
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	0 - FF
BYTE2
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	0 - FF
CCT	Номер платы в модуле
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	0 - 63
CONT	Переключатель завершения AMO
	Тип ввода	:	одиночное значение, необязательное
	Возможные значения	:	Y	AMO не завершается
		:	N	AMO завершается
	Значение по умолчанию	:	Y
CPU	Тип CPU
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	86	для 8086
			51	для 8051
			MM	для MAIN MICRO в модуле LTUR
			IMF	для IMF/DFE в модуле LTUR
			HDLC	для процессора HDLC в модуле LTUR
HEX01	1-й байт задания трассировки
	Тип ввода:		одиночное значение, обязательное
	Возможные значения		0 - FF
	Значение по умолчанию		0
HEX02	2-й байт задания трассировки
	Тип ввода:		одиночное значение, обязательное
	Возможные значения		0 - FF
	Значение по умолчанию		0
	:
	:
HEX64	64-й байт задания трассировки
	Тип ввода:		одиночное значение, обязательное
	Возможные значения		0 - FF
	Значение по умолчанию		0
LENGTH	Количество заданий трассировки
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	1 - 64
LTG	Номер группы линий
	Тип ввода	:	одиночное значение, необязательное
	Возможные значения	:	1 - 32
	Значение по умолчанию	:	1 (для Hicom 370)
LTU	Номер блока группы линий
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	1 - 15
NO	Длина области DUMP в байтах для вывода функцией DISPLAY или
	количество данных TRACE для вывода функцией OUTPUT
	Тип ввода	:	одиночное значение, необязательное
	Возможные значения	:	0 - 8154	в DISPLAY
			0 - 1024	в OUTPUT
	Значение по умолчанию	:	8154	в DISPLAY
			1024	в OUTPUT
PROC1	Регистрация получаемых процессов до
	Тип ввода	:	одиночное значение, объединенные одиночные значения или диапазон,
			обязательное
	Возможные значения	:	0 - F
PROC2	Регистрация передаваемых процессов до
	Тип ввода	:	одиночное значение, объединенные одиночные значения или диапазон,
			обязательное
	Возможные значения	:	0 - F
	Значение по умолчанию	:	нет процессов
SEG	Шестнадцатеричное значение сегмента для адреса dump в
	модулях 8086 и ROLM (для MM, IMF или HDLC)
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	0 - FFFF
SEG1	Символьная спецификация сегмента 8051
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	CSEG	сегмент кода
			DSEG	сегмент данных
			XSEG	дополнительный сегмент
SLOT	Спецификация слота в LTU
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	1 - 145
TYPE	Тип отображения, тип модуля
	Тип ввода	:	одиночное значение, обязательное для ADD, необязательное для DISPLAY
	Возможные значения в ветви DISPLAY:
			TRACE	получение памяти TRACE (значение по умолчанию)
			DUMP	получение и вывод памяти DUMP
	Возможные значения в ветви ADD:
			STD (стандартный модуль)
			HEX (задание трассировки в шестнадцатеричном формате)
			LTUR (модуль LTUR)

1.57.4 Сообщения об ошибках и предупредительные сообщения

1.57.4.1 Сообщения об ошибках

F01:	НЕТ ПЛАТЫ
	Указанная плата недоступна, неактивна или больше максимально допустимого значения для этого модуля.
F02:	НЕТ МОДУЛЯ
	Указанный модуль недоступен или не активен.
F03:	НЕТ LTU
	Указанный линейный модуль недоступен, неактивен или больше максимального допустимого значения для этой системы.
F04:	НЕТ LTG
	Указанная линейная группа недоступна, неактивна или больше максимально допустимого значения для этого типа системы.
F05:	ПЛАТА НЕ ИМЕЕТ ПЕРИФЕРИЙНОГО ТРАССИРОВЩИКА
	Тип модуля, указанный для заданного адреса выводится во внутренней таблице AMO недоступного модуля. Это также означает, что сообщение не выводится для новых не подлежащих трассировке модулей, еще не включенных в таблицу (сообщите разработчикам PETRA).
F06:	НЕОЖИДАННЫЙ ТИП ТРАССИРОВКИ: <xxxxxxxxxxxxxxxx> <xxxxxxxxxxxxxxxx>
	Недопустимый тип трассировки; данные объекта трассировки выводятся для диагностики (сообщите разработчикам PETRA).
F07:	НЕВОЗМОЖНО ЗАНЯТЬ ТОЧКУ ВХОДА @@@T В LTU-ТИП @@T
	Заданная точка входа (SLOT) недопустима для текущего типа полки (LTU).
F08:	НЕДОПУСТИМОЕ ЗНАЧЕНИЕ ПРОЦЕССА, РАЗРЕШЕННЫЙ ДИАПАЗОН С 0H ДО FH
	Для модулей ROLM  можно ввести только 15 процессов.
F09:	НЕДОПУСТИМЫЕ ДАННЫЕ ТРАССИРОВКИ ДЛЯ LTUR; ВВЕДИТЕ ДВА ОБЪЕДИНЕННЫХ ЗНАЧЕНИЯ 2
	В качестве данные трассировки для модулей ROLM (например, LTUR) можно ввести только два объединенных значения (0 - FF) .
F10:	ИДЕНТИФИКАЦИЯ ПРОЦЕССОРА НЕДОПУСТИМА ДЛЯ ЭТОГО МОДУЛЯ
	Для выбранного модуля указан недопустимый тип процессора.
F11:	У ПЛАТЫ НЕТ ФУНКЦИИ DUMP
F12:	УКАЗАННАЯ ДЛИНА МЕНЬШЕ КОЛИЧЕСТВА ВВЕДЕННЫХ ШЕСТНАДЦАТЕРИЧНЫХ ЗНАЧЕНИЙ

1.57.4.2 Предупредительные сообщения

H01:	БУФЕР ПУСТ (ТРЕБУЕМЫХ ДАННЫХ ТРАССИРОВКИ НЕТ)
	Если это сообщение не появилось в течение 20  секунд после отправки исходящего задания, это означает, что сегмент буфера трассировки не назначен в PP. Если это сообщение выводится непосредственно после ввода, то сегмент буфера трассировки назначен в PP, но все еще пуст.
H02:	БУФЕР ПУСТ (НЕТ ТРЕБУЕМЫХ ДАННЫХ DUMP)
H03:	ВЫВОДИМЫЕ ДАННЫЕ ТРАССИРОВКИ: КОЛИЧЕСТВО, ДЛИНА
	Предложение просмотреть переданные из PP данные.
H04:	БУФЕР ТРАССИРОВКИ СОДЕРЖИТ <xxxxx> ЭЛЕМЕНТОВ ТРАССИРОВКИ
	Информация о количестве элементов трассировки, которые были получены и могут быть выведены.
H05:	ОБЛАСТЬ RAM ПО АДЕРСУ H'4000 - H'7000 НЕДОСТУПНА ДЛЯ ПРОЦЕССОРА IMF/DFE
	Информация о недоступной области памяти для процессора IMF/DFE в модуле LTUR.