1.42 LWCMD - Команда диагностики с помощью загружаемых программных модулей

С целью диагностики AMO-LWCMD посылает исполняемые команды в формате ASCII на подлежащий диагностике модуль (в настоящее время это только модуль CDG V4.0). AMO получает также строки в формате ASCII с пульта управления и выводит их на дисплей пользовательского терминала HICOM без дальнейших манипуляций с ними (При этом база данных HICOM не затрагивается).

Команды, которые можно посылать на пульт, можно посмотреть в документе "Администрирование и обслуживание" ('Administration and maintenance' K. Janssens SIEMENS ATEA).

Командой AMO-LWCMD следует пользоваться только обученному персоналу технического обслуживания системы. Поэтому AMO защищена с помощью пароля класса 3 ("Специалист по изделию").

1.42.1 Ограничения

Это описание пригодно для версий начиная с HICOM 300 E V3.0. AMO-LWCMD в настоящее время имеется только для CDG V4.0.

1.42.2 Взаимозависимости

Прямым партнером по связи с AMO является PP. PP обменивается сообщениями с загружаемым программным модулем CDG в обоих направлениях (передача и прием).

1.42.3 Функции AMO

EXEC-LWCMD

:

Послать на пульт команду диагностики с помощью загружаемого модуля и вывести на дисплей "распечатку" полученных данных (в настоящее время только для модуля CDG V4.0)

1.42.3.1 EXEC-LWCMD

Операция EXEC посылает команду на конфигурированную плату, адресуемую правильным LTU-номером, на установочный слот модуля и на плату TYPE. AMO связывается с платой через PP, который собирает выводимые с платы данные и посылает их назад на AMO.

AMO выводит на дисплей полученную "распечатку" данных в формате ASCII (макс. 192 Кбайт сегментами по 8 Кбайт) без дополнительной обработки, за исключением случая, когда в пределах вывода 80 символов не было обнаружено ни одного CR/LF (возврат каретки/перевод строки) (одна строка COMTES). В этом случае AMO продолжает вывод данных с новой строки.

Значение входного параметра TIMER можно выбрать в пределах 1..100 сек. Если в течение заданного времени PP не отвечает, AMO заканчивает работу с сообщением об ошибке. По умолчанию таймер ставится на 20 сек. При сборе данных с CDG V4.0 плата PP также запускает таймер. Имеется несколько разных сообщений об ошибках для каждого случая исчерпания лимита времени.

Примечание

Команда загрузки программного модуля для платы CDG V4.0 (см. примеры) может содержать знаки двойных кавычек. Интерфейс пользовательского терминала HICOM не допускает использования таких специальных символов, как двойные кавычки в параметрах TEXTSTRING (строка текста). Поэтому пользователю приходится вводить вместо них две простые кавычки. AMO преобразует простые кавычки назад в двойные и посылает скорректированную команду на плату CDG V4.0 (через PP).

Пример:

- Двойные кавычки вводитьне разрешено:

	EXEC-LWCMD:1,79,CDG,"execute 4 1 2 1 1 "PRA 1 test-link" 

- Вместо них пользователь должен ввести две простые кавычки:

	EXEC-LWCMD:1,79,CDG,"execute 4 1 2 1 1 ''PRA 1 test-link''"

Краткий обзор процедуры

Код команды	Параметр
EXEC-LWCMD	LTU=<парам>,
	SLOT=<парам>,
	| TYPE=<CDG>,
	CMD=<строка>,
	[TIMER=<парам>];

.

Примеры

Некоторые из команд диагностики, которые можно послать на плату CDG V4.0 посредством AMO-LWCMD и выполнить "распечатку" данных, можно найти в документе 'Administration and Maintenance' (Admaint.zbv) от Siemens ATEA (K. Janssens). См. начиная с разд. 3.2.1.7 и далее.

Следующий пример показывает "распечатку" для платы, конфигурированной с LTU=2, SLOT=43. Плата выведет все имеющиеся действия команд (команда 'Help'). Таймер пользователя будет установлен на 30 сек.

Ввод:

exec-lwcmd:2,43,cdg,"help",30;

Вывод:

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

CMD	Команда для платы
	Тип вводимых данных	:	одно значение
		:	обязательное
	Допустимые значения		строка текста, макс. 240 знаков.

LTU	Блок внешних линий
	Тип вводимых данных	:	одно значение
			обязательное
	Допустимые значения	:	1..15

SLOT	Установка слота модуля
	Тип вводимых данных	:	одно значение
			обязательное
	Допустимые значения	:	1..121

TIMER	Контрольный таймер для PP
	Тип вводимых данных	:	одно значение
			опция
	Допустимые значения	:	1..100	в секундах

TYPE	Тип платы
	Тип вводимых данных		одно значение
			обязательное
	Допустимые значения		CDG	плата CDG V4.0

1.42.5 Сообщения об ошибках и Предупреждения

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

F01:	AMO БЫЛА ЗАПУЩЕНА ДВАЖДЫ
	AMO ИСПОЛНИМА, ЕСЛИ ТЕКУЩАЯ ЗАДАЧА ВЫПОЛНЕНА
	ИЛИ
	РАБОТА AMO БЫЛА ПРЕРВАНА (ИСПОЛЬЗУЙТЕ ДРУГУЮ SWU AMO ЧТОБЫ ПОПЫТАТЬСЯ СБРОСИТЬ ПРОЦЕСС)
F02:	ПЛАТА НЕДОСТУПНА
F03:	В ЭТОМ СЛОТЕ НЕТ, НЕПРАВИЛЬНЫЙ ИЛИ
	ПОМЕЧЕННЫЙ КАК НЕИСПОЛНЯЕМЫЙ МОДУЛЬ
F04:	НЕВЕРНАЯ КОМАНДА ДЛЯ МОДУЛЯ
F05:	ПРЕВЫШЕН МАКСИМАЛЬНЫЙ ОТОБРАЖАЕМЫЙ ОБЪЕМ ДАННЫХ (192 К)
F06:	ВЫВОД НА ДИСПЛЕЙ ОСТАНОВЛЕН ПОЛЬЗОВАТЕЛЕМ
F07:	В ТЕЧЕНИЕ ЗАДАННОГО ВРЕМЕНИ МОДУЛЬ НЕ ОТВЕЧАЕТ
F08:	ПЕРЕДАЧА ДАННЫХ ОСТАНОВЛЕНА ПОСЛЕ ВЫВОДА <DUMPLEN> БАЙТА
F09:	ОШИБКА ИСКЛЮЧИТЕЛЬНОЙ СИТУАЦИИ AMO: НЕВОЗМОЖНО ПОСЛАТЬ СООБЩЕНИЕ НА PP
F10:	ОШИБКА ИСКЛЮЧИТЕЛЬНОЙ СИТУАЦИИ AMO: ОШИБКА ПРИ ПОЛУЧЕНИИ СООБЩЕНИЯ ОТ PP
F11:	ДАННЫЕ, ПОЛУЧЕННЫЕ ОТ ПЛАТЫ, НЕВЕРНЫ
F11Z1	ПРИЧИНА: КОД СОБЫТИЯ AMO /= РЕЗУЛЬТАТУ "РАСПЕЧАТКИ" AMO
F11Z2	ПРИЧИНА: ДЛИНА "РАСПЕЧАТКИ" > МАКС. ВЕЛИЧИНЫ (81549)
F11Z3	ПРИЧИНА: CBIT /= [0,1]

Сообщение об ошибке F07 выводится также если происходит превышение времени на PP при ожидании ответа на начальное сообщение (состояние 'START'), посланное на плату. На внутреннем таймере PP по умолчанию устанавливается значение 10 сек, равное половине уставки таймера сообщений AMO-LWCMD .

Сообщение об ошибке F11 содержит три возможные дополнительные причины ошибки: Z1, Z2 и Z3. Они дают более глубокую информацию о причине прекращения вывода данных AMO, если заголовок рассматриваемой "распечатки" не согласуется с тем, чего ожидает от AMO-LWCMD техник-системник.

1.42.5.2 Предупреждения

нет