 Использование текстового редактора

Этот раздел описывает возможности и команды   текстового редактора ISaGRAF, особенно команды, использующиеся для ввода исходных текстов программ ST и IL.

Команды редактирования

Опции

Команды меню "Инструменты"

Вызов других инструментов ISaGRAF

Параметры программы

Остальные команды меню Файл

Обновление дневника программы

Выбор переменной из словаря

Отладка программ ST и IL

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

Определение ресурсов


Команды редактирования

Команды меню Редактор используются для редактирования текста. Большинство команд оперируют с выделенными символами диаграммы или с символом на текущей позиции курсора.

 	Удаление и вставка

Поиск и замена

Переход к строке

Вставка символа из словаря

Вставка файла


 	Удаление и вставка

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


Поиск и замена

Команды меню Редактор / Заменить, Редактор / Заменить используются для нахождения и замены текста в диаграмме. Могут быть найдены любые символьные строки. Поиск может быть осуществлён вверх или вниз от выбранной позиции. Он заканчивается по достижении конца диаграммы.


Переход к строке

Команда Редактор / Перейти на строку используется для перемещения курсора на строку с указанным номером. Это может быть полезно для редактирования строки, содержащей ошибку, на которую сослался компилятор программ на ST или IL.


Вставка символа из словаря

Используйте команду Редактор / Вставить переменную для вставки на позицию курсора символа переменной или объекта, объявленного в словаре проекта. Символ выбирается из окна диалога, описанного в разделе Дополнительно о редакторах программ этого документа.


Вставка файла

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


Опции

Команды меню Опции используются для того, чтобы показать или убрать панель редактирования и выбора шрифта. Выбранный шрифт будет использоваться для любого текста, редактируемого в Инструментарии ISaGRAF.

При использовании редактора для ввода программы на ST или IL, команда  Опции / Показать ключевые слова служит для того, чтобы показать или убрать окно, содержащее наиболее употребляемые ключевые слова этих языков.


Вызов других инструментов ISaGRAF

Проверить (компилировать) программу

 	Симулировать или отлаживать приложение

Редактирование словаря переменных


Проверка ( компиляция ) программ

Команда Файл / Проверить запускает генератор кода ISaGRAF для проверки синтаксиса редактируемой программы. Если она написана на языке SFC, то проверяются как 1-уровень, так и 2-уровень. Когда проверка синтаксиса завершена, окно генерации необходимо закрыть для продолжения редактирования. Если приложение состоит только из одной программы ( редактируемой в данный момент ), то, при отсутствии ошибок, будет создан код приложения. Команда Создать / Опции компилятора используется для установки параметров компиляции и оптимизации. Обратитесь к разделу Использование Генератора Кода этого раздела за более подобной информацией о генерации кода и компиляции.


 	Симуляция или отладка приложения

Команды Файл / Симулировать и Файл / Отладка запускают графический отладчик ISaGRAF как для режима Симуляции, так и для реального соединения. Они переоткрывают программу на SFC в режиме отладки. В режиме отладки в программе нельзя произвести никаких изменений.


Редактирование словаря переменных

Команда Файл / Словарь используется для редактирования словаря переменных текущей программы или текущего приложения. Таким же способом можно редактировать макросы. Описатель локальный и макросы относятся к текущей программе.


Параметры программы

Если редактируемая программа является функцией, функциональным блоком или подпрограммой, то команда Файл / Параметры используется для определения её параметров вызова и возвращаемых параметров. Эта команда не действует, если редактируемая программа является SFC программой верхнего уровня, от раздела Begin до End.

Функции, функциональные блоки или подпрограммы могут иметь до 32 параметров ( ввода или вывода ). Функция или подпрограмма имеет ровно один возвращаемый параметр, имя которого должно совпадать с именем функции, в соответствии с правилами преобразования ST.

Список в верхней левой части окна показывает параметры, в порядке способов вызова : сначала параметры вызова, затем - возврата. Нижняя часть окна показывает подробное описание параметра, выделенного в списке. В качестве параметра может быть использован любой тип данных ISaGRAF. Возвращаемый параметр должен располагаться в списке после параметров вызова. Имена параметров должны подчиняться следующим правилам :

•	Длина имени не должна превышать 8 символов

•	Первый символ должен быть буквой

•	Следующие символы могут быть буквой, цифрой или символом подчёркивания

•	В имени проекта прописной и строчный регистры не различаются

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


Остальные команды меню Файл

Следующие команды доступны из меню Файл любого программного редактора.

Открыть другую программу

Печать программы


Открытие другой программы

Команда Файл / Открыть позволяет закрыть редактируемую программу и начать редактирование  другой программы того же проекта на том же языке. Новая программа заменяет текущую в окне редактирования.


Печать программ

Команда Файл / Печать выводит редактируемую программу на принтер. Эта команда создаёт эскиз листинга программы. Более подробная информация по этому вопросу получается при использовании генератора документов проекта.

Для графических программ ( SFC, FBD и Quick LD ) Вы можете воспользоваться командой Редактор / Копировать рисунок (метафайл) для копирования в буфер изображения диаграммы в формате метафайла. Оно может быть вставлено в другое приложение как в текстовом процессоре. Для программ SFC только 1-уровень информация ( диаграммы, нумерация и комментарии 1-уровня )может быть помещена в метафайл.


Обновление дневника программы

Файл дневника, присоединённый к редактируемой программе, может быть введён вручную при помощи команды Файл / Дневник. Файл дневника обновляется автоматически при компиляции. Вывод компилятора снабжается временной отметкой / отметкой даты.

Если в меню Опции выбран режим Обновить дневник, то при каждом сохранении программы на диск появляется окно диалога

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


Выбор переменной из словаря

При редактировании текстовой программы ( IL или ST ) Редактор / Вставить переменную позволяет выбрать объявленную ранее переменную для вставки на текущую позицию курсора. При редактировании программ FBD или LD требуется для описания контактов, витков, параметров блоков ввода/вывода или переменных FBD. В обоих случаях появляется окно диалога .

Окно выбора Область для выбора глобальных или локальных переменных. Окно выбора справа позволяет выбрать тип данных. Маленькие иконы рядом с окном выбора типа - это кнопки, которые используются для выбора наиболее часто используемых типов данных :

Boolean

Integer / Real

Timer

Message

Для выбора переменой щёлкните мышью на имени из списка. В результате этого её имя и описание появятся вверху списка. Затем нажмите кнопку Принять для подтверждения выбора. Можно также непосредственно ввести имя переменной, не используя список.


Определение ресурсов

Команда Ресурсы меню Опции позволяет пользователю определять ресурсы. Ресурсы - это любые, определенные пользователем данные (конфигурация сети, установки оборудования …) любого формата (файл, список значений), которые должны быть соединены с генерируемым кодом, чтобы быть загруженными вместе на целевую PLC. Такие данные напрямую не управляются ядром ISaGRAF, и в основном предназначены для другого программного обеспечения, установленного на целевом PLC. Обратитесь к своему руководству по оборудованию для дальнейшей информации о доступных ресурсах.

Файл определения ресурсов

Описание языка

Пример

Компиляция ресурсов

Реализация


Файл определения ресурсов

Ресурсы, определенные в Файле определения ресурса  сохраняются вместе с другими файлами проекта ISaGRAF. Это чисто текстовый файл в ASCII кодах, созданный Компилятором Ресурсов ISaGRAF. Этот компилятор автоматически запускается во время построения кодов приложения. Эта секция объясняет синтаксис этого файла. Файл определения ресурсов использует лексические правила языка ST. Комментарии, начинающиеся с (* и заканчивающиеся символами *), могут быть вставлены в любом месте текста. Строки разграничиваются одиночными апострофами. Обратитесь ко второй части этого руководства для большего объяснения лексических форматов, используемых для ввода числовых значений.


Справочник по языку

Ниже дан список ключевых слов и операторов, используемых в файле определения ресурсов.

ULONGDATA

VARLIST

BINARYFILE

TEXTFILE

TARGET

ANYTARGET

FROM

TO


ULONGDATA

Значение:	Определяет ресурс, который является списком целых значений. Значения сохраняются в получаемом коде как 32 битные целые. Значения сохраняются в порядке, указанном в файле определения ресурсов. Значения должны быть разделены запятыми. Имя ресурса не должно превышать 15 символов.

Синтаксис:	ULONGDATA '<имя_ресурса>'

BEGIN

...целевой_выбор...

...список переменных...

END

Пример:	ULongData 'MYDATA'

Begin

...

0, -1, 100_000,	(* десятичные *)

16#A0B1, 2#1011_0101	(*шестнадцатеричн,двоичные*)

End


VARLIST

Значение:	Определяет ресурс, который является списком адресов переменных. Переменные идентифицируются своими именами в файле определения ресурсов. Адреса переменных сохраняются в получаемом коде как беззнаковые 16 битные целые. Адреса сохраняются в порядке, указанном в файле определения ресурсов. Переменные должны быть разделены запятыми. Имя ресурса не должно превышать 15 символов.

Синтаксис:	VARLIST '<имя_ресурса>'

BEGIN

...выбор_цели...

...список переменных...

END

Пример:	VarList 'LIST'

Begin

...

Var100, MyParameter, Command, Alarm

End


BINARYFILE

Значение:	Определяет ресурс Бинарный Файл. Исходные данные сохраняются в MS-DOS файле. Определение целевого ресурса завершается определением целевого имени. Конец строки символов не преобразуется Компилятором Ресурсов ISaGRAF. Имя ресурса не должно превышать 15 символов.

Синтаксис:	BINARYFILE '<имя_ресурса>'

BEGIN

...выбор_цели...

FROM '<путь_источника>'

TO '<путь_назначения>'

END

Пример:	BinaryFile 'MYFILE'

Begin

...

From 'c:\user\config.bin'

To '/dd/user/appl/config.dat'

End


TEXTFILE

Значение:	Определяет ресурс Текстовый Файл. Исходные данные сохраняются в MS-DOS файле. Определение целевого ресурса завершается определением целевого имени. Конец строки символов преобразуется Компилятором Ресурсов ISaGRAF, в соответствии с соглашениями целевой головной системы. Имя ресурса не должно превышать 15 символов.

Синтаксис:	TEXTFILE '<имя_ресурса>'

BEGIN

...выбор_цели...

FROM '<путь_источника>'

TO '<путь_назначения>'

END

Пример:	TextFile 'MYFILE'

Begin

...

From 'c:\user\config.bin'

To '/dd/user/appl/config.dat'

End


TARGET

Значение:	Определяет имя получаемых кодов, которые должны включать ресурс. Обратитесь к предшествующей секции (опции компилятора) для дальнейшей информации об управляемых целях. Оператор Target может появляться более, чем один раз в том же самом блоке ресурса для выбора нескольких целей. Этот оператор не может быть использован, если указан оператор AnyTarget.

Синтаксис:	TARGET '<имя_цели>'

Пример:	BinaryFile 'MYFILE'

Begin

Target 'ISA86M'

Target 'ISA68M'

...

End


ANYTARGET

Значение:	Определяет то, что ресурс должен быть включен во все коды, построенные Генератором Кодов. Генератор Кодов ISaGRAF может производить несколько кодов назначения во время выполнения одной команды Создать. Этот оператор не может быть использован, если указан один или несколько операторов Target.

Синтаксис:	ANYTARGET

Пример:	ULongData 'MYDATA'

Begin

AnyTarget

...

End


FROM

Значение:	Определяет путь источника (на PC, где установлен ISaGRAF Workbench) ресурсов BinaryFile и TextFile. Символы, используемые для разделения компонентов пути (диск, каталог, префикс, суффикс) должны соответствовать соглашениям MS-DOS.

Синтаксис:	FROM '<путь цели>'

Пример:	BinaryFile 'MYFILE'

Begin

...

From 'c:\user\config.dat'

To '/dd/user/appl/config.dat'

End


TO

Значение:	Определяет путь назначения (на системе назначения) ресурсов BinaryFile и TextFile. Символы, используемые для разделения компонентов пути (диск, каталог, префикс, суффикс) должны соответствовать соглашениям системы назначения.

Синтаксис:	TO '<путь цели>'

Пример:	TextFile 'MYFILE'

Begin

...

From 'c:\user\config.dat'

To '/dd/user/appl/config.dat'

End


Пример

Ниже дан полный пример файла определения ресурсов:

(* файл определения ресурсов *)

ULongData 'DATA1'	(* список значений *)

Begin

   Target 'ISA86M'	(* только для этой цели *)

   1, 0, 16#1A2B3C4D, +1, -1	(* цифровые значения *)

End

VarList 'VLIST1'	(* список переменных *)

Begin

   Target 'ISA86M'	(* только для этой цели *)

   Valve1, StateX, Command, Alrm1	(* имена переменных  *)

End

BinaryFile 'FILE1'	(* ресурс бинарный файл *)

Begin

   AnyTarget	(* для любой цели *)

   From 'c:\user\updatef.bin'	(* исходник на PC *)

   To 'updatef.cfg'	(* файл назначения на PLC *)

End

TextFile 'FILE2'	(* ресурс текстовый файл *)

Begin

   Target 'ISA68M'

   From 'c:\nw\nwbd.txt'	(* исходный файл на PC *)

   To '/nw/dat/nwbd'	(* файл назначения на PLC *)

End


Компиляция ресурсов

Если ресурсы были введены в файл определения ресурсов, окно диалога появится в конце генерации кодов ISaGRAF. Нажмите кнопку Запустить компилятор для запуска компилятора ресурсов. Выходные сообщения и ошибки будут отображены в основном окне управления. Нажмите Выход для избежания компиляции ресурсов. В этом случае ресурсы не будут добавлены в коды ISaGRAF.


Реализация

Число ресурсов, размер строк данных и файлов ISaGRAF не ограничивает. Ресурсы сохраняются в конце генерируемого кода с каталогом ресурсов. Ниже дан формат (используя С нотацию) формата каталога ресурсов:

__RESOURCE:

{

  long nbres;	/*количество определенных ресурсов*/

  {

    char name[16];	/* имя ресурса */

    long type;	/* тип данных ресурса */

    long size;	/* точный размер блока данных  */

    void *data;

    char *path_offset;	/* указывает на строку */

  } /*nb записей */

}

Ниже даны возможные значения поля type:

•	1 = бинарный файл

•	2 = текстовый файл

•	3 = ulong данные (в этом случае поле path_offset не используется)

•	4 = список переменных (в этом случае поле path_offset не используется)

Для текстовых файлов конец строки символов преобразуется компилятором ресурсов в зависимости с соглашениями системы назначения. Все указатели - это 32 битные смещения от адреса соответствующей структуры. Все имена ресурсов и пути - это строки, заканчивающиеся на NULL.  Пути и данные следуют за каталогом ресурсов.


Команды меню Инструменты"

Следующие команды имеются в меню Инструменты всех языковых редакторов. Они используются для вывода информации в маленькие текстовые списки внизу окна редактирования, и используют ее для просмотра программы.

"Показать вывод компилятора "	показывает в окне вывода сообщение об ошибке последней компиляции редактируемой программы.

"Найти в диаграмме"	находит вхождения текста в редактируемой программе, и представляет их в окне вывода. Для языков SFC and FC, эта команда ищет по всем программам уровня 2.

"Скрыть список вывода "	закрывает окно вывода

Если сообщение об ошибке или вхождении появляются в окне вывода, то двойной щелчок в строке передвигает выделение на соответствующую позицию. Для языков SFC и FC, эта команда открывает соответствующее уровню 2 программное окно.


Отладка программ ST и IL

Во время симуляции или отладки программ ST и IL, никакие модификации не могут быть введены в программный текст.

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

ST	Для программ ST, Окно Списка встроено в окно редактора. Вы можете изменять размер просмотров перетаскивая мышью линию разделения между ними.

Сохранение списка на жестком диске

 	Вставка переменных в список

Изменение выбранноц переменной

Показать дамп

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


Сохранение списков на жесткий диск

Команда "Файл / Сохранить список" сохраняет списки переменных на диске, под тем же именем что и редактируемая программа. Этот список будет автоматически подгружаться каждый раз, когда программа ST или IL открывается в режиме отладки. Этот список может быть свободно открыт и модифицирован с использованием средств Списка запущенных с помощью команды "Инструменты / Список переменных" окна отладки.


 	Вставка переменных в список

Команда Редактор/ Вставить переменную вставляет другую переменную в список. Имя переменной выбирается в списке объектов, определенных в словаре проекта. В этом случае пользователь не должен вводить вручную идентификатор. Переменная вставляется перед переменной, выбранной в данный момент в списке. Список не может содержать более 32 переменных. Одна и та же переменная не может появляться более одного раза в том же самом списке.

Если имя переменной в тексте ST выделено, нажмите эту кнопку на панели инструментов или запустите команду "Редактор/ Подсмотреть выделение ", чтобы напрямую послать переменную во встроенный список шпиона.


Изменение выбранной переменной

Команда Редактор/ Изменить переменную замещает выбранную переменную другой переменной. Вы можете также использовать команду Вырезать для удаления выбранной переменной из списка.


Показать Дамп

В любой момент вы можете изменить режим просмотра между списком и просмотром "Дампа". Нажмите кнопку  "увеличение" на панели инструментов или используйте команду "Опции / Дамп" для изменения режима просмотра.

В режиме "Дамп", отображается только одна переменная. Ее значение отображается в числовом/символьном формате вверху окна, и также появляется двоичный дамп формат. Этот режим позволяет вам просматривать шестнадцатеричные значения каждого байта переменной.

Экран "Дамп" полезен для просмотра сообщений содержащих печатные символы.