Skip to main content

18. Makra – tabele: typy danych, operatory i funkcje wbudowane (wersja tekstowa)

Streszczenie: Tabele z rozdziału Makra w wersji tekstowej: stałe i typy zmiennych, operatory (matematyczne, porównania, logiczne, bitowe, przesunięcia), składnia Select Case i while oraz opis wbudowanych funkcji makr – matematycznych, konwersji danych, operacji na zmiennych i bitach oraz komunikacyjnych (nazwa, składnia, opis, przykład).
EN: Macro reference tables: data types, operators and built-in functions (syntax, description, example).

Dotyczy: panele HMI Weintek (serie cMT, cMT X, eMT, iE, XE, mTV, iP), oprogramowanie EasyBuilder Pro
Źródło: tabele z wcześniejszej wersji tłumaczenia instrukcji Weintek EasyBuilder Pro (książka „Weintek - Instrukcja”), opracowanie Multiprojekt

Poniższe tabele odpowiadają tabelom pokazanym na tej stronie jako obrazy. Pochodzą z wcześniejszej wersji tłumaczenia instrukcji i zostały dodane, aby ich treść była dostępna jako tekst (wyszukiwanie, modele AI).

Tabele uzupełniają strony „18. Makra (18.1–18.8)” i „18. Makra (18.9–18.16)”: typy danych i stałe, operatory oraz wbudowane funkcje makr (matematyczne, konwersji danych, operacji na zmiennych i bitach, komunikacyjne).

Stałe

Stałe są wartościami stałymi i mogą być bezpośrednio zapisywane w instrukcjach. Dostępne są następujące format

Typ

Uwaga

Przykład

Dziesiętne


345, -234, 0, 23456

Hexadecymalne

Musi rozpoczynać się od przedrostka 0x

0x3b, 0xffff, 0x237

ASCII

Pojedynczy znak musi być umieszczony w apostrofach, a ciąg znaków musi być umieczony pomiędzy cudzysłowami.

'a', "data", "name"

Dyskretne


prawda, fałsz

Typy zmiennych

Istnieje 8 różnych typów zmiennych, 5 dla danych ze znakiem oraz 3 typy dla zmiennych bez znaku

Typ

opis

Wartości

bool (boolean)

1 bit (dyskretna)

0, 1

char (character)

8 bits (bajt)

+127 to -128

short (short integer)

16 bits (słowo)

+32767 to -32768

int (integer)

32 bits (podwójne słowo)

+2147483647to -2147483648

float (floating point)

32 bits (podwójne słowo)


unsigned char

8 bits (bajt)

0 to 255

unsigned short

16 bits (słowo)

0 to 65535

unsigned int

32 bits (podwójne słowo)

0 to 4,294,967,295

Operatory matematyczne

Operatory służą do określania sposobu obliczania wartości zmiennych.

Operacja matematyczna

Opis

Przykład

+

Dodawanie

A = B + C

-

Odejmowanie

A = B – C

*

Mnożenie

A = B * C

/

Dzielenie

A = B / C

%

Modulo (reszta z dzielenia)

A = B % 5

Operatory porównania

Operatory porównań

Opis

Przykład

<

Mniejższe niż

if A < 10 then B = 5

<=

Mniejsze, bądź równe

if A <= 10 then B = 5

>

Większe niż

if A > 10 then B = 5

>=

Większe, bądź równe

if A >= 10 then B = 5

==

Równe

if A == 10 then B = 5

<>

Różne

if A <> 10 then B = 5

Operatory logiczne

Operacje logiczne

Opis

Przykład

and

Logiczny AND

if A < 10 and B > 5 then C = 10

or

Logiczny OR

if A >= 10 or B > 5 then C = 10

xor

Logiczny Exclusive OR

if f A xor 256 then B = 5

not

Logiczny NOT

if not A then B = 5

Operatory przesunięcia bitowego

Operacje przesunięcia

Description

Example

<<

Przesuwa bity z wskazanego słowa B  o określoną liczbę bitów (8) w lewą stronę i zapisuje do A

A = B << 8

>>

Przesuwa bity z wskazanego słowa B  o określoną liczbę bitów (8) w prawą stronę i zapisuje do A

A = B >> 8

Operatory bitowe

Operatory bitowe

Opis

Przykład

&

Operator bitowy AND

A = B & 0xf

|

Operator bitowy OR

A = B | C

^

Operator bitowy XOR

A = B ^ C

~

Kod uzupełnień do jedności

A = ~B

Instrukcja Select Case – składnia

Select Case

Musi być użyty do rozpoczęcia pętli.

[zmienna]

Wymagany. Wartość tej zmiennej zostanie porównana z wartością każdego przypadku.

Case else

Opcjonalny. Reprezentuje domyślny przypadek. Jeśli żaden z wcześniejszych przypadków nie zostanie spełniony, zostanie wykonane wyrażenie z domyślnego przypadku. Jeśli nie ma domyślnego przypadku i żaden inny przypadek nie zostanie spełniony program przejdzie bezpośrednio do końca pętli select-case.

break

Opcjonalny. Pętla będzie wykonywana, dopóki nie zostanie osiągnięte polecenie przerwania. Jeśli polecenie przerwania nie jest używane, program kontynuuje wykonywanie następnego wyrażanie, aż do osiągnięcia polecenia końcowego.

end Select

Musi być użyty do zakończenia pętli.

Pętla while (break, continue) – składnia

while

Musi być użyty do rozpoczęcia pętli.

continue

Wymagany. Warunek sprawdzający. Gdy jest spełniony, pętla będzie  wykonywana. Kiedy przestanie być spełniany, pętla zakończy wykonywanie.

return [wartość]

Wyrażenie do wykonania, gdy warunek jest spełniony.

wend

Musi być użyty do zakończenia pętli.

Funkcje matematyczne

SQRT

Nazwa

SQRT

Składnia

SQRT(zrodlo, wynik)

Opis

Oblicza pierwiastek kwadratowy ze źródła i zapisuje otrzymaną wartość do wyniku. Źródło może być stałą lub zmienną. Wynik musi być zmienną. Źródło musi być wartością nieujemną.

Przykład

macro_command main()  float zrodlo, wynik  SQRT(15, wynik)  zrodlo = 9.0 SQRT(zrodlo, wynik)//  wynik wynosi 3.0  end macro_command

CUBERT

Nazwa

CUBERT

Składnia

CUBERT(zrodlo, wynik)

Opis

Oblicza pierwiastek sześcienny ze źródła i zapisuje otrzymaną wartość do wyniku. Źródło może być stałą lub zmienną. Wynik musi być zmienną. Źródło musi być wartością nieujemną.

Przykład

macro_command main()  float zrodlo, wynik  CUBERT (27, wynik) // wynik wynosi 3.0  zrodlo = 27.0 CUBERT(zrodlo, wynik)//  wynik wynosi 3.0  end macro_command

POW

Nazwa

POW

Składnia

POW(zrodlo1, zrodlo2, wynik)

Opis

Oblicza potęgę liczby zrodlo1 o wykładniku zrodlo2. zrodlo1 i zrodlo2 mogą być zmiennymi lub stałymi wartościami nieujemnymi. wynik musi być zmienną.

Przykład

macro_command main()  float y, wynik y = 0.5 POW (25, y, wynik) // wynik = 5 end macro_command

SIN

Nazwa

SIN

Składnia

SIN(zrodlo, wynik)

Opis

Oblicza sinus wartości określonej w zmiennej zrodlo wyrażonej w stopniach.  Źródło może być stałą lub zmienną. Wynik musi być zmienną

Przykład

macro_command main()  float zrodlo, wynik  SIN(90, wynik)//  wynik = 1  zrodlo = 30 SIN(zrodlo, wynik)//  wynik =s 0.5  end macro_command

COS

Nazwa

COS

Składnia

COS(zrodlo, wynik)

Opis

Oblicza cosinus wartości określonej w zmiennej zrodlo wyrażonej w stopniach.  Źródło może być stałą lub zmienną. Wynik musi być zmienną

Przykład

macro_command main()  float zrodlo, wynik  COS(90, wynik)//  wynik = 0  zrodlo = 60 GetData(zrodlo, "Local HMI", LW, 0, 1)  COS(zrodlo, wynik)//  wynik = 0.5  end macro_command

TAN

Nazwa

TAN

Składnia

TAN(zrodlo, wynik)

Opis

Oblicza tangens wartości określonej w zmiennej zrodlo wyrażonej w stopniach.  Źródło może być stałą lub zmienną. Wynik musi być zmienną.

Przykład

macro_command main()  float zrodlo, result  TAN(45, wynik)//  wynik = 1  zrodlo = 60 TAN(zrodlo, wynik)//  wynik = 1.732  end macro_command

COT

Nazwa

COT

Składnia

COT(zrodlo, wynik)

Opis

Oblicza cotangens (kotangens) wartości określonej w zmiennej zrodlo wyrażonej w stopniach.  Źródło może być stałą lub zmienną. Wynik musi być zmienną.

Przykład

macro_command main()  float zrodlo, wynik  COT(45, wynik)//  wynik = 1  zrodlo = 60 COT(zrodlo, wynik)//  wynik = 0.5774  end macro_command

SEC

Nazwa

SEC

Składnia

SEC(zrodlo, wynik)

Opis

Oblicza secans (sekans) wartości określonej w zmiennej zrodlo wyrażonej w stopniach.  Źródło może być stałą lub zmienną. Wynik musi być zmienną.

Przykład

macro_command main()  float zrodlo, wynik  SEC(45, wynik)//  wynik = 1.414  zrodlo = 60 SEC(zrodlo, wynik)//  jeśli źródło wynosi 60, wynik = 2  end macro_command

CSC

Nazwa

CSC

Składnia

CSC(zrodlo, result)

Opis

Oblicza cosecans (kosekans) wartości określonej w zmiennej zrodlo wyrażonej w stopniach.  Źródło może być stałą lub zmienną. Wynik musi być zmienną.

Przykład

macro_command main()  float zrodlo, wynik  CSC(45, wynik)//  wynik = 1.414  zrodlo = 30 CSC(zrodlo, wynik)//  wynik = 2  end macro_command

ASIN

Nazwa

ASIN

Składnia

ASIN(zrodlo, wynik)

Opis

Oblicza arcus sinus wartości określonej w zmiennej zrodlo wyrażonej w stopniach.  Źródło może być stałą lub zmienną. Wynik musi być zmienną.

Przykład

macro_command main()  float zrodlo, wynik  ASIN(0.8660, zrodlo)//  wynik = 60  zrodlo = 0.5 ASIN(zrodlo, wynik)//  wynik = 30  end macro_command

ACOS

Nazwa

ACOS

Składnia

ACOS(zrodlo, wynik)

Opis

Oblicza arcus cosinus wartości określonej w zmiennej zrodlo wyrażonej w stopniach.  Źródło może być stałą lub zmienną. Wynik musi być zmienną.

Przykład

macro_command main()  float zrodlo, wynik  ACOS(0.8660, wynik)//  wynik = 30  zrodlo = 0.5 ACOS(zrodlo, wynik)//  wynik = 60  end macro_command

ATAN

Nazwa

ATAN

Składnia

ATAN(zrodlo, wynik)

Opis

Oblicza arcus tanges wartości określonej w zmiennej zrodlo wyrażonej w stopniach.  Źródło może być stałą lub zmienną. Wynik musi być zmienną.

Przykład

macro_command main()  float zrodlo, wynik  ATAN(1, wynik)//  wynik = 45  zrodlo = 1.732 ATAN(zrodlo, wynik)//  wynik = 60  end macro_command

LOG

Nazwa

LOG

Składnia

LOG (zrodlo, wynik)

Opis

Oblicza logarytm naturalny z liczby źródłowej. źródłem może być zmienna lub stała. wynik musi być zmienną.

Przykład

macro_command main()  float zrodlo = 100, wynik  LOG (zrodlo, wynik)//  wynik wynosi w przybliżeniu 4.6052  end macro_command

LOG10

Nazwa

LOG10

Składnia

LOG10(zrodlo, wynik)

Opis

Logarytm dziesiętny (briggsowski) z liczby źródłowej. źródłem może być zmienna lub stała. wynik musi być zmienną.

Przykład

macro_command main()  float zrodlo = 100, wynik  LOG10 (zrodlo, wynik) // wynik = 2  end macro_command

RAND

Nazwa

RAND

Składnia

RAND(wynik)

Opis

Oblicza losową liczbę całkowitą i zapisuje do wyniku. wynik musi być zmienną.

Przykład

macro_command main()  short wynik  RAND (wynik) // wynik nie jest stałą wartością, zmienia się z każdym wykonaniem makra.  end macro_command

Konwersja formatu danych

BIN2BCD

Nazwa

BIN2BCD

Składnia

BIN2BCD(zrodlo, wynik)

Opis

Konwertuje wartość z formatu binarnego (źródło) do formatu BCD (wynik). źródło może być stałą lub zmienną. wynik musi być zmienną.

Przykład

macro_command main()   short zrodlo, wynik  BIN2BCD(1234, wynik)//  wynik = 0x1234  zrodlo = 5678 BIN2BCD(zrodlo, wynik)//  wynik = 0x5678  end macro_command

BCD2BIN

Nazwa

BCD2BIN

Składnia

BCD2BIN(zrodlo, wynik)

Opis

Konwertuje wartość z formatu BCD (źródło) do formatu binarnego (wynik). źródło może być stałą lub zmienną. wynik musi być zmienną.

Przykład

macro_command main()   short zrodlo, wynik  BCD2BIN(0x1234, wynik)//  result is 1234  zrodlo = 0x5678 BCD2BIN(zrodlo, wynik)//  result is 5678  end macro_command

DEC2ASCII

Nazwa

DEC2ASCII

Składnia

DEC2ASCII(zrodlo, wynik [start], dlugosc)

Opis

Konwertuje wartość dziesiętną (źródło) w ciąg znaków ASCII i zapisuje go w tablicy (wynik). „Dlugosc" reprezentuje długość ciągu znaków, a jednostka długości zależy od formatu wyniku, tzn. jeśli wyniku ma format "char" (rozmiar to bajt), a długość ciągu wynosi (bajt * dlugosc). Jeśli typem wyniku jest "short" (rozmiar jest słowem), długość łańcucha znaków wynosi (słowo * dlugosc) i tak dalej. Pierwszy znak jest wstawiany do tabeli o adresie: wynik[start], drugi znak do [start + 1], a ostatni znak do wyniku [start + (dlugosc -1)]. Zrodlo i dlugosc mogą być stałą lub zmienną. Wynik musi być zmienną, a start musi być stałą.

Przykład

macro_command main() short zrodlo char wynik1[4] short wynik2[4] char wynik3[6] zrodlo= 5678  DEC2ASCII(zrodlo, wynik1[0], 4) // wynik1[0] = '5', wynik1[1] = '6', wynik1[2] = '7', wynik1[3] = '8' // długość łańcucha znaków(wynik1) to 4 bajty (= 1 * 4) DEC2ASCII(zrodlo, wynik2[0], 4) // wynik2[0] = '5', wynik2 [1] = '6', wynik2 [2] = '7', wynik2 [3] = '8' // długość łańcucha znaków (wynik2) wynosi 8 bajtów (= 2 * 4)   zrodlo =-123 DEC2ASCII(zrodlo, wynik3[0], 6) // wynik3[0] = '-', wynik3[1] = '0', wynik3[2] = '0', wynik3[3] = '1' // wynik3[4] = '2', wynik3[5] = '3' // długość łańcucha znaków (wynik3) to 6 bajtów (= 1 * 6) end macro_command

HEX2ASCII

Nazwa

HEX2ASCII

Składnia

HEX2ASCII(zrodlo, wynik [start], dlugosc)

Opis

Przekształca wartość heksadecymalną (zrodlo) na ciąg znaków ASCII zapisany w tablicy (wynik).  „Dlugosc" reprezentuje długość ciągu znaków, a jednostka długości zależy od formatu wyniku, tzn. jeśli wyniku ma format "char" (rozmiar to bajt), a długość ciągu wynosi (bajt * dlugosc). Jeśli typem wyniku jest "short" (rozmiar jest słowem), długość łańcucha znaków wynosi (słowo * dlugosc) i tak dalej. Pierwszy znak jest wstawiany do tabeli o adresie: wynik[start], drugi znak do [start + 1], a ostatni znak do wyniku [start + (dlugosc -1)]. Zrodlo i dlugosc mogą być stałą lub zmienną. Wynik musi być zmienną, a start musi być stałą.

Przykład

macro_command main()  short zrodlo char wynik [4]  zrodlo = 0x5678 HEX2ASCII (zrodlo, wynik [0], 4) //  wynik [0] = '5', wynik [1] = '6', wynik [2] = '7', wynik [3] = '8'  end macro_command

FLOAT2ASCII

Nazwa

FLOAT2ASCII

Składnia

FLOAT2ASCII(zrodlo, wynik [start], dlugosc)

Opis

Przekształca wartość zmiennoprzecinkową (zrodlo) na ciąg znaków ASCII zapisany w tablicy (wynik).  „Dlugosc" reprezentuje długość ciągu znaków, a jednostka długości zależy od formatu wyniku, tzn. jeśli wyniku ma format "char" (rozmiar to bajt), a długość ciągu wynosi (bajt * dlugosc). Jeśli typem wyniku jest "short" (rozmiar jest słowem), długość łańcucha znaków wynosi (słowo * dlugosc) i tak dalej. Pierwszy znak jest wstawiany do tabeli o adresie: wynik[start], drugi znak do [start + 1], a ostatni znak do wyniku [start + (dlugosc -1)]. Zrodlo i dlugosc mogą być stałą lub zmienną. Wynik musi być zmienną, a start musi być stałą.

Przykład

macro_command main()  float zrodlo char wynik [4]  zrodlo = 56.8 FLOAT2ASCII (zrodlo, wynik [0], 4) //  wynik [0] = '5', wynik [1] = '6', wynik [2] = '.', wynik [3] = '8'  end macro_command

ASCII2DEC

Nazwa

ASCII2DEC

Składnia

ASCII2DEC(zrodlo[start], wynik, dlugosc)

Opis

Przekształca ciąg znaków (źródło) w wartość dziesiętną zapisaną w zmiennej (wynik). Długość ciągu znaków określa zmienia „dlugosc". Pierwszy znak ciągu to zrodlo[start]. Zrodlo i dlugosc mogą być stałą lub zmienną. Wynik musi być zmienną, a start musi być stałą

Przykład

macro_command main()  char zrodlo [4] short wynik  zrodlo [0] = '5' zrodlo [1] = '6' zrodlo [2] = '7' zrodlo [3] = '8'   ASCII2DEC(zrodlo [0], wynik, 4) //  wynik = 5678  end macro_command

ASCII2HEX

Nazwa

ASCII2HEX

Składnia

ASCII2HEX (zrodlo[start], wynik, dlugosc)

Opis

Przekształca ciąg znaków (źródło) w wartość heksadecymalną zapisaną w zmiennej (wynik). Długość ciągu znaków określa zmienia „dlugosc". Pierwszy znak ciągu to zrodlo[start]. Zrodlo i dlugosc mogą być stałą lub zmienną. Wynik musi być zmienną, a start musi być stałą.

Przykład

macro_command main()  char zrodlo [4] short result  zrodlo [0] = '5' zrodlo [1] = '6' zrodlo [2] = '7' zrodlo [3] = '8'    ASCII2HEX (zrodlo [0], wynik, 4) //  wynik = 0x5678  end macro_command

ASCII2FLOAT

Nazwa

ASCII2FLOAT

Składnia

ASCII2FLOAT(zrodlo[start], wynik, dlugosc)

Opis

Przekształca ciąg znaków (źródło) w wartość zmiennoprzecinkową zapisaną w zmiennej (wynik). Długość ciągu znaków określa zmienia „dlugosc". Pierwszy znak ciągu to zrodlo[start]. Zrodlo i dlugosc mogą być stałą lub zmienną. Wynik musi być zmienną, a start musi być stałą.

Przykład

macro_command main()  char zrodlo [4] float result  zrodlo [0] = '5' zrodlo [1] = '6' zrodlo [2] = '.' zrodlo [3] = '8'   ASCII2FLOAT (zrodlo [0], wynik, 4) //  wynik = 56.8  end macro_command

Operacje na zmiennych

FILL

Nazwa

FILL

Składnia

FILL(wynik [start], zadana, ilość)

Opis

Ustawia określona ilość pierwszych elementy licząc do wartości start tablicy (wynik) na określoną wartość (zadana). Zrodlo i start musi być zmienną, a zadana może być stałą lub zmienną.

Przykład

macro_command main()  char wynik [4] char zadana  FILL(wynik [0], 0x30, 4) //  wynik [0] = 0x30, wynik [1] = 0x30, , wynik [2] = 0x30, , wynik [3] = 0x30  zadana = 0x31 FILL(wynik[0], zadana, 2) //  wynik [0] = 0x31, wynik [1] = 0x31  end macro_command

SWAPB

Nazwa

SWAPB

Składnia

SWAPB(zrodlo, wynik)

Opis

Zamienia pozycję w zmiennej zrodlo starszego bajtu i młodszego bajtu i zapisuje jako wynik 16-bitowy. Źródło może być stałą lub zmienną. Wynik musi być zmienną.

Przykład

macro_command main()  short zrodlo, wynik  SWAPB(0x5678, wynik)//  wynik = 0x7856  zrodlo = 0x123 SWAPB(zrodlo, wynik)//   wynik = 0x2301  end macro_command

SWAPW

Nazwa

SWAPW

Składnia

SWAPW(zrodlo, wynik)

Opis

Zamienia pozycję starszego i młodszego słowa w rejestrze 32-bitowym i zapisuje jako wynik 32-bitowy.  Źródło może być stałą lub zmienną. Wynik musi być zmienną.

Przykład

macro_command main()  int zrodlo, wynik  SWAPW (0x12345678, wynik)//  wynik = 0x56781234  zrodlo = 0x12345 SWAPW (zrodlo, wynik)//   wynik = 0x23450001  end macro_command

LOBYTE

Nazwa

LOBYTE

Składnia

LOBYTE(zrodlo, wynik)

Opis

Pobiera młodszy bajt 16-bitowej zmiennej zrodlo i zapisuje do zmiennej wynik. Źródło może być stałą lub zmienną. Wynik musi być zmienną.

Przykład

macro_command main()  short zrodlo, wynik  LOBYTE(0x1234, wynik)//  wynik = 0x34  zrodlo = 0x123 LOBYTE(zrodlo, wynik)//   wynik = 0x23  end macro_command

HIBYTE

Nazwa

HIBYTE

Składnia

HIBYTE(zrodlo, wynik)

Opis

Pobiera starszy bajt 16-bitowej zmiennej zrodlo i zapisuje do zmiennej wynik. Źródło może być stałą lub zmienną. Wynik musi być zmienną.

Przykład

macro_command main()  short zrodlo, wynik  HIBYTE(0x1234, wynik)//  wynik = 0x12  zrodlo = 0x123 HIBYTE(zrodlo, wynik)//   wynik = 0x01  end macro_command

LOWORD

Nazwa

LOWORD

Składnia

LOWORD(zrodlo, wynik)

Opis

Pobiera młodsze słowo z 32-bitowej zmiennej zrodlo i zapisuje do zmiennej wynik. Źródło może być stałą lub zmienną. Wynik musi być zmienną.

Przykład

macro_command main()  int zrodlo, wynik  LOWORD(0x12345678, wynik)//  wynik = 0x5678  zrodlo = 0x12345 LOWORD(zrodlo, wynik)//   wynik = 0x2345  end macro_command

HIWORD

Nazwa

HIWORD

Składnia

HIWORD(zrodlo, wynik)

Opis

Pobiera starsze słowo z 32-bitowej zmiennej zrodlo i zapisuje do zmiennej wynik. Źródło może być stałą lub zmienną. Wynik musi być zmienną.

Przykład

macro_command main()  int zrodlo, wynik  HIWORD(0x12345678, wynik)//  wynik = 0x1234  zrodlo = 0x12345 HIWORD(zrodlo, wynik)//   wynik = 0x0001  end macro_command

Operacje na bitach

GETBIT

Nazwa

GETBIT

Składnia

GETBIT(zrodlo, wynik, poz_bitu)

Opis

Pobiera stan bitu z wyznaczonej pozycji (poz_bitu) w zmiennej (zrodlo) i zapisuje do zmiennej wynik. Wartość wyniku będzie wynosić 0 lub 1. Zrodlo i poz_bitu mogą być stałą lub zmienną. Wynik musi być zmienną.

Przykład

macro_command main()  int zrodlo, wynik short poz_bitu  GETBIT(9, wynik, 3)//  wynik = 1  zrodlo = 4 poz_bitu = 2 GETBIT(zrodlo, wynik, poz_bitu)//  wynik = 1  end macro_command

SETBITON

Nazwa

SETBITON

Składnia

SETBITON(zrodlo, wynik, poz_bitu)

Opis

Ustawia stan bitu z wyznaczonej pozycji (poz_bitu) w zmiennej (zrodlo) w stan ON i zapisuje zmienioną wartość do zmiennej wynik. Zrodlo i poz_bitu mogą być stałą lub zmienną. Wynik musi być zmienną..

Przykład

macro_command main()  int zrodlo, wynik short poz_bitu  SETBITON(1, wynik, 3)//  wynik = 9  zrodlo = 0 poz_bitu = 2 SETBITON (zrodlo, wynik, poz_bitu)//  wynik = 4  end macro_command

SETBITOFF

Nazwa

SETBITOFF

Składnia

SETBITOFF(zrodlo, wynik, poz_bitu)

Opis

Ustawia stan bitu z wyznaczonej pozycji (poz_bitu) w zmiennej (zrodlo) w stan OFF i zapisuje zmienioną wartość do zmiennej wynik. Zrodlo i poz_bitu mogą być stałą lub zmienną. Wynik musi być zmienną.

Przykład

macro_command main()  int zrodlo, wynik short poz_bitu  SETBITOFF(9, wynik, 3)//  wynik is 1  zrodlo = 4 poz_bitu = 2 SETBITOFF(zrodlo, wynik, poz_bitu)//  wynik is 0  end macro_command

INVBIT

Nazwa

INVBIT

Składnia

INVBIT(zrodlo, wynik, poz_bitu)

Opis

Zmienia stan bitu z wyznaczonej pozycji (poz_bitu) w zmiennej (zrodlo) w stan przeciwny i zapisuje zmienioną wartość do zmiennej wynik. Zrodlo i poz_bitu mogą być stałą lub zmienną. Wynik musi być zmienną.

Przykład

macro_command main()  int zrodlo, wynik short poz_bitu  INVBIT(4, wynik, 1)//  wynik = 6  zrodlo = 6 poz_bitu = 1 INVBIT(zrodlo, wynik, poz_bitu)//  wynik = 4  end macro_command

Funkcje komunikacyjne

DELAY

Nazwa

DELAY

Składnia

DELAY(czas)

Opis

Wstrzymuje wykonywanie bieżącego makra przez określony czas. Jednostka czasu (zmiennej czas) to milisekunda. Czas może być stałą lub zmienną.

Przykład

macro_command main()  int czas == 500  DELAY(100)//  opóźnienie to 100 ms DELAY(czas)//  opóźnienie to 500 ms  end macro_command

ADDSUM

Nazwa

ADDSUM

Składnia

ADDSUM(zrodlo[start], wynik, liczba)

Opis

Dodaje elementy tablicy (zrodlo) począwszy od elementu o numerze start do elementu o numerze start+liczba-1, aby wygenerować sumę kontrolną. Wprowadza sumę kontrolną do wyniku. Wynik musi być zmienną. Liczba jest ilością zgromadzonych elementów i może być stałą lub zmienną.

Przykład

macro_command main() char zrodlo[5] short wynik  data[0] = 0x1 data[1] = 0x2 data[2] = 0x3 data[3] = 0x4 data[4] = 0x5  ADDSUM(zrodlo[0], wynik, 5)//  wynik to 0xf  end macro_command

XORSUM

Nazwa

XORSUM

Składnia

XORSUM(zrodlo[start], wynik, liczba)

Opis

Używa metody wykluczania do obliczania sumy kontrolnej z tablicy (zrodlo) począwszy od elementu o numerze start do elementu o numerze start+liczba-1. Wprowadza sumę kontrolną do wyniku. Wynik musi być zmienną. Liczba jest ilością zgromadzonych elementów i może być stałą lub zmienną.

Przykład

macro_command main() char zrodlo [5] = {0x1, 0x2, 0x3, 0x4, 0x5} short wynik  XORSUM(zrodlo [0], wynik, 5)//  wynik = 0x1  end macro_command

BCC

Nazwa

BCC

Składnia

BCC(zrodlo[start], wynik, liczba)

Opis

Używa metody alternatywy wykluczającej (XOR) do obliczania sumy kontrolnej z tablicy (zrodlo) począwszy od elementu o numerze start do elementu o numerze start+liczba-1. Wprowadza sumę kontrolną do wyniku. Wynik musi być zmienną. Liczba jest ilością zgromadzonych elementów i może być stałą lub zmienną.

Przykład

macro_command main() char zrodlo [5] = {0x1, 0x2, 0x3, 0x4, 0x5} char wynik  BCC(zrodlo [0], wynik, 5)   // wynik = 0x1  end macro_command

CRC

Nazwa

CRC

Składnia

CRC(zrodlo[start], 16bit_CRC*, liczba*)

Opis

Oblicza 16-bitową wartość CRC zmiennych z tablicy (zrodlo) począwszy od elementu o numerze start do elementu o numerze start+liczba-1. Wstawia 16-bitowy CRC do zmiennej 16bit_CRC. Wynik musi być zmienną. Liczba jest ilością zgromadzonych elementów i może być stałą lub zmienną.

Przykład

macro_command main() char zrodlo [5] = {0x1, 0x2, 0x3, 0x4, 0x5} short 16bit_CRC  CRC(zrodlo [0], 16bit_CRC, 5)//  16bit_CRC = 0xbb2a  end macro_command

INPORT2

Składnia

INPORT2(odpowiedz[start], nazwa_urzadzenia, liczba, czas)

Opis

Odczytuje dane z portu komunikacyjnego (port COM lub port Ethernet). Odczytane dane zostaną zapisane w zmiennej odpowiedz. Nazwa_urzadzenia jest tak samo definiowana jak w funkcji OUTPORT. Liczba przechowuje informację na temat długość otrzymanego wektora danych, musi to być zmienna. Długość całkowita zmiennej liczba nie może przekraczać rozmiaru odpowiedzi. Czas (w milisekundach) może być stałą lub zmienną. Po odczytaniu danych, jeśli nie ma nadchodzących danych w wyznaczonym przedziale czasu, funkcja zwraca wartość.

Przykład

macro_command main()  short odpowiedz[6], liczba, czas=20  INPORT2(odpowiedz [0], "Free Protocol", liczba, czas) // czas wyrażony w milisekundach  if liczba > 0 then SetData(odpowiedz[0], "Local HMI", LW, 0, 6) // funkcja wysyła odpowiedź do LW 0end if  end macro_command

INPORT3

Nazwa

INPORT3

Składnia

INPORT3(odpowiedz[start], nazwa_urzadzenia, dlugosc_odpowiedzi, liczba)

Opis

Odczytuje dane z portu komunikacyjnego (port COM lub port Ethernet). Odczytane dane zostaną zapisane w zmiennej odpowiedz. Można określić ilość danych do odczytania. Dane, które nie są jeszcze odczytywane, będą przechowywane w pamięci buforowej HMI dla następnej operacji odczytu, aby zapobiec utracie danych. Nazwa_urzadzenia jest tak samo definiowana jak w funkcji OUTPORT. read_count przechowuje długość danych odczytanych za każdym razem.Liczba przechowuje informację na temat długość otrzymanego wektora danych, musi to być zmienna. Długość całkowita zmiennej liczba nie może przekraczać rozmiaru odpowiedzi

Przykład

macro_command main()  short odpowiedz[6], dlugosc_odpowiedzi INPORT3(odpowiedz [0], "Free Protocol", 6, dlugosc_odpowiedzi)  // odczyt 6 słów if dlugosc_odpowiedzi >= 6 then SetData(odpowiedz [0], "Local HMI", LW, 0, 6)  // przypisanie wartości z zmiennej odpowiedz do wektora 6 zmiennych począwszy od LW0 end if  end macro_command

Słowa kluczowe

funkcje makr, SQRT, POW, SIN, BIN2BCD, BCD2BIN, DEC2ASCII, ASCII2DEC, FILL, SWAPB, LOBYTE, GETBIT, SETBITON, SETBITOFF, INVBIT, DELAY, ADDSUM, XORSUM, CRC, INPORT2, typy danych, operatory