Справочник по макросам в EasyBuilder Pro на русском

15.12.2020
Справочник по макросам в EasyBuilder Pro на русском

Макросы обеспечивают дополнительную функциональность, которая может понадобиться вашему приложению.

Макросы - это автоматизированные последовательности команд, которые выполняются во время выполнения. Макросы позволяют выполнять такие задачи, как сложные операции масштабирования, обработка строк и взаимодействие пользователя с проектом. Здесь описываются синтаксис, использование и методы программирования макрокоманд.

В этом окне можно:

  • создавать макросы;
  • удалять макросы;
  • редактировать/править макросы;
  • делать импорт/экспорт макросов в файл *.ebm;
  • вызвать окно Библиотеки макросов;
  • защитить макросы от декомпиляции паролем;
  • задать формат адреса переменных для доступа к шестнадцатеричной части адреса (DDDDh вместо DDDDdd).

Редактор макросов

Окно редактора макросов.

 


Синтаксис макросов

Константы

Константы являются фиксированными значениями и могут быть записаны непосредственно в операторы. Формат следующий:

Тип константы

Пример

Примечание

десятичное целое число

345, -234, 0, 23456

 

шестнадцатеричный

0x3b, 0xffff,

 Должна начинаться 0x

ASCII

‘a’, “data”, “name”

 Символ должен быть заключен в одинарные кавычки, а строки в двойные

Булев, логический

true, false

 

 

Пример некоторых операторов с использованием констант:

macro_command main()

short A, B // Объявление переменных типа  short  A и B.

A = 1234

B = 0x12 // 1234 и 0x12 – константы

char st1[11] = "qwerty"  // qwerty – это строка-константа

char st2[11] = {'q','w','e','r','t','y'}    // константа qwerty задана как массив символов

char vb22    = 'w'   // w – это символ-константа

end macro_command

 

Переменные

Переменные - это имена, которые представляют информацию. Информация может быть изменена при изменении переменной с помощью операторов.

Правила именования переменных:

  • имя переменной должно начинаться с буквы;
  • имена переменных длиннее 32 символов не допускаются;
  • зарезервированные слова не могут использоваться в качестве имен переменных.

Существует 8 различных типов переменных, 5 типов данных со знаком и 3 для беззнаковых типов данных:

Тип переменной

Описание

Диапазон допустимых значений

Bool

1 бит (1 бит)

0 или 1

Char

8 бит (1 байт)

от -128 до 127

Short

16 бит (1 слово)

от -32 768 до 32 767

Int

32 бит (двойной слово)

от -2 147 483 648 до 2 147 483 647

Float

32 бит (двойное слово)

 

Unsigned Char

8 бит (1 байт)

от 0 до 255

Unsigned Short

16 бит (1 слово)

от 0 до 65 535

Unsigned Int

32 бита (двойное слово)

от 0 до 4 294 967 295

 

Объявление переменных

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

Объявление массивов

Макросы поддерживают одномерные массивы (отсчитываемый от нуля индекс). Чтобы объявить массив переменных, укажите тип и имя переменной, а затем число переменных в массиве, заключенное в скобки «[]». Массивы имеют длину от 1 до 4096 переменных. (Макрос поддерживает только до 4096 переменных).

Пример:

int a[10]

short b[20], switch[30]

float pressure[15]

Минимальный индекса массива равен 0, а максимальный индекс массива равен (размер массива - 1).

Пример:

char data[100] // Размер массива равен 100

Следовательно: минимальный индекс массива - «data[0]», а максимальный индекс массива - «data[99]», 100 - 1 = 99.

 

Инициализация переменных и массивов

Есть два способа инициализации переменных:

  • в теле функции после объявления, используя оператора присваивания (=)

int a

float b[3]

a = 10

b[0] = 1

 

  • сразу при объявлении

char a = '5', b = 9

 

Объявление массивов - особый случай. Весь массив можно инициализировать во время объявления, заключив значения, разделенные запятыми, в фигурные скобки «{}».

Пример:

float data[4] = {11, 22, 33, 44} // Следовательно, data[0] = 11, data[1] = 22….

 


Мастер добавления функции в макрос

Мастер позволяет:

  • добавлять встроенные функции;
  • добавлять функции из пользовательской библиотеки;
  • задать параметры функции с помощью выпадающих меню;
  • получить краткую справку по встроенной функции и пример ее использования.


Встроенные функции

EasyBuilder Pro имеет набор встроенных функций для поиска и передачи данных в ПЛК, управления данными и математических функций.Описание функций можно прочитать в Руководстве пользователя Easy Builder Pro в главе 18.7 или во встроенной справке в Мастере добвления функций (в момент вставки функции Мастером).

 

Математические

Преобразованеи данных

Манипулирование данными

Преобразование битов

Связь

ACOS

ASCII2DEC

FILL

GETBIT

ADDSUM

ASIN

ASCII2FLOAT

HIBYTE

INVBIT

CRC

ATAN

ASCII2HEX

HIWORD

SETBITOFF

DELAY

COS

BCD2BIN

LOBYTE

SETBITON

GetCTS

COT

BIN2BCD

LOWORD

 

GetData

CSC

DEC2ASCII

SWAPB

 

GetDataEx

CUBERT

FLOAT2ASCII

SWAPW

 

GetError

LOG

HEX2ASCII

   

INPORT

LOG10

     

INPORT2

POW

     

OUTPORT

RAND

     

PURGE

SEC

     

SetData

SIN

     

SetDataEx

SQRT

     

SetRTS

TAN

     

XORSUM

 

 

Операции со строками

Работа с рецептами

Разное

StringBin2DecAsc

StringIncluding

RecipeGetData

ASYNC_TRIG_MACRO

StringBin2HexAsc

StringInsert

RecipeQuery

Beep

StringCat

StringLength

RecipeQueryGetData

FindDataSamplingDate

StringCompare

StringMid

RecipeQueryGetRecordID

FindDataSamplingIndex

StringCompareNoCase

StringReverseFind

 

FindEventLogDate

StringCopy

StringSet

 

FindEventLogIndex

StringDecAsc2Bin

StringSetEx

 

SYNC_TRIG_MACRO

StringDecAsc2Float

StringToLower

 

TRACE

StringExcluding

StringToReverse

   

StringFind

StringToUpper

   

StringFindOneOf

StringTrimLeft

   

StringFloat2DecAsc

StringTrimRight

   

StringGet

     

StringGetEx

     

 


Функции

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

Определение функции, возвращающей значение:

sub тип <имя> [(параметры)]

Объявление локальных переменных

[тело функции]

[return [значение]]

end sub

 

sub int Add(int x, int y)

int result

result = x + y

return result

end sub

 

macro_command main()

int a = 10, b = 20, sum

sum = Add(a, b)

end macro_command

Или:

sub int Add()

int result, x = 10, y = 20

result = x + y

return result

end sub

 

macro_command main()

int sum

sum = Add()

end macro_command

 

Определение функции, не возвращающей никакого значения:

sub <имя> [(параметры)]

Объявлене локальных переменных

[тело функции]

end sub

Пример:

sub Add(int x, int y)

int result

result = x + y

end sub

 

macro_command main()

int a = 10, b = 20

Add(a, b)

end macro_command

Или:

sub Add()

int result, x = 10, y = 20

result = x + y

end sub

 

macro_command main()

Add()

end macro_command

 

Описание синтаксиса

  • sub -> Должен использоваться для начала функционального блока.
  • тип -> Необязательно. Это тип данных значения, возвращаемого функцией. Функциональный блок не всегда необходим для возврата значения.
  • (параметры) -> Необязательны. Параметры содержат значения, которые передаются функции основным макросом. Переданные параметры должны иметь свой тип, объявленный в поле параметра и присвоенные имени переменной.

 

Пример: sub int MyFunction (int x, int y). x и y будут целыми числами, переданными функции основным макросом. Эта функция вызывается оператором, который выглядит примерно так:

ret = MyFunction (456, pressure), где «pressure» должно быть целым числом в соответствии с определением функции.

Обратите внимание, что вызывающая инструкция может передавать функции жестко закодированные значения или переменные. После выполнения этой функции целочисленные значения возвращаются в «ret».

Объявление локальных переменных -> Переменные, которые используются в функциональном блоке, должны быть объявлены первыми. Это в дополнение к переданным параметрам. В приведенном выше примере x и y - переменные, которые может использовать функция. Глобальные переменные также доступны для использования в функциональном блоке.

[тело функции] -> список операторов, код.

[return [значение]] -> Необязательно. Используется для возврата значения вызывающей инструкции. Значение может быть константой или переменной. Return также завершает выполнение функционального блока. Функциональный блок не всегда необходим для возврата значения, но, когда тип возврата определяется в начале определения функции, необходима команда возврата.

end sub -> Должен использоваться для завершения функционального блока.

 


Библиотека макросов

Откройте проект в программном обеспечении для программирования, файл библиотеки функций по-умолчанию будет считан автоматически и информация о функции будет загружена в него.В этот момент, если вызывается пользовательская функция, сначала необходимо импортировать соответствующий файл *.mlb.— Имя файла библиотеки функций по умолчанию: MacroLibrary (без расширения имени файла)— Каталог библиотеки функций: каталог_установки_программного_обеспечения EasyBuilder\ library (папка)—\library (папка) содержит два типа файлов библиотеки функций:

  • файл без расширения: MacroLibrary, Библиотека Функций по-умолчанию для программного обеспечения, которое следует читать в начале.
  • файл с расширением (* .mlb): например, «math.mlb». Файлы для чтения/записи при импорте/экспорте пользователями. Эти файлы переносимы и могут быть вызваны из папки при необходимости.


Как выполнить макрос

Есть несколько способов выполнить макрос:

С помощью объекта Управления ПЛК

  1. Откройте объект Управления ПЛК и установите для атрибута значение «Выполнить макропрограмму».
  2. Выберите макрос по имени. Выберите бит и выберите условие запуска для запуска макроса. Макрос будет повторно запускаться, пока выполняется условие. Чтобы гарантировать, что макрос будет запускаться только один раз, рассмотрите возможность фиксации бита триггера, а затем сброса условия триггера в макросе.

С помощью объекта Битовый переключатель

  1. На вкладке «Общие» диалогового окна «Битовый переключатель» выберите параметр «Выполнить макрос».
  2. Выберите макрос для выполнения. Макрос будет выполнен один раз при нажатии кнопки.

С помощью объекта Функциональная кнопка

  1. На вкладке «Общие» диалогового окна «Функциональная кнопка» выберите параметр «Выполнить макрос».
  2. Выберите макрос для выполнения. Макрос будет выполнен один раз при нажатии кнопки.

Механизм выполнения макросов

  • Последовательное выполнение нескольких макросов.

Макросы выполняются в разных потоках, чтобы избежать влияния. Но если разные макросы читают или записывают один и тот же адрес в одно и то же время (например, с помощью команд GetData(), SetData()), макрос с меньшим порядковым номером будет выполнен первым.

  • Последовательность нескольких сигналов запуска одного и того же макроса.

После запуска макроса любым другим сигналам запуска этого же макроса будет отказано. Следовательно, макрос не будет запускаться повторно.

  • Последовательность сигналов запуска макроса от Функциональной кнопки и Бита уведомления.

[Запуск от Функциональной кнопки] Непосредственно отправляет команду на выполнения макроса.

[Запуск по Биту уведомления] Только когда состояние бита уведомления соответствует условию запуска, HMI отправляет команду на выполнение макроса.

  • Как будет реагировать выполняемый макрос, когда запускаются другие макросы?

Каждый макрос не зависит от запуска или выполнения других макросов.

 


Некоторые примечания об использовании макроса

Максимальный объем хранения локальных переменных в макросе составляет 4 Кбайт. Итак, максимальный размер массива для разных типов переменных следующий:

  • Char var 1 [4096]
  • bool var 2 [4096]
  • short var 3 [2048]
  • int var 4 [1024]
  • float var5 [1024]

 

  • В проекте можно использовать не более 255 макросов.
  • Макрос может вызвать блокировку HMI. Возможные причины:
    • макрос содержит бесконечный цикл без связи с ПЛК;
    • размер массива превышает размер памяти макроса.
  • Из-за задержек по связи с ПЛК макрос может выполняться медленнее, чем ожидалось. Кроме того, слишком много макросов может замедлить обмен данными с ПЛК.

 


Как отлаживать с помощью функции TRACE

С помощью макро функции TRACE и EasyDiagnoser можно проверить содержание варианта.Следующие шаги демонстрируют, как использовать функцию TRACE.

Шаг 1. Создайте функцию TRACE, как показано ниже:

macro_command main()

short a

GetData(a, "Local HMI", LW, 0, 1)

a = a + 1

SetData(a, "Local HMI", LW, 0, 1)

TRACE("LW0 = %d", a)

end macro_command

Шаг 2. Создайте объект числового дисплея (LW-0) и объект функциональной клавиши (выполнить макрос) в проекте.

Шаг 3. Скомпилируйте проект и загрузите проект в HMI или запустите моделирование на ПК.

Шаг 4. Если запустить моделирование на ПК, в окне моделирования щелкните правой кнопкой мыши и выберите «Запустить EasyDiagnoser».Если вы загрузили проект в HMI, запустите EasyDiagnoser.exe и выберите HMI.

Шаг 5. Когда EasyDiagnoser успешно подключит HMI, выполнение макроса обнаружит диалоговое окно [Вывод], в котором отображается результат выполнения функции TRACE.

Примечание. Системный регистр LB-9059 используется для отключения функции TRACE. Когда этот региср установлен в положение ON, функция TRACE не выводит данные в EasyDiagnoser.

8bit