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
No comments to display
No comments to display