Operații pe biți

Aceste funcții citesc și modifică biți individuali, câmpuri de biți și octeți ai unui număr întreg — de regulă cuvinte de stare și registre de alarmă citite cu MODBUSR. Bitul 0 este bitul cel mai puțin semnificativ (cel din dreapta), iar octetul 0 este octetul cel mai puțin semnificativ.

Lățimea în biți după tip#

Câți biți are un număr pentru funcțiile pe biți depinde de tipul lui:

• MODBUSR, literalii zecimali, PARSEJSON și valorile dispozitivelor sunt de tip double, deci contează ca 32 de biți. Doar variabilele cu tip, elementele colecțiilor și tipurile de date Modbus pe 64 de biți au o altă lățime.
• Un bit sau un octet în afara tipului este o eroare, de exemplu GETBIT(x, 16) pentru o variabilă uint16: GETBIT - bit must be between 0 and 15. Un câmp de biți care începe în interiorul tipului, dar depășește limita lui superioară este permis — GETBITS returnează biții care există, iar SETBITS îi ignoră pe ceilalți.
• Un double sau float se rotunjește la un număr întreg și trebuie să fie între −2 147 483 648 și 4 294 967 295; orice altă valoare, inclusiv NaN, este o eroare (value X is out of the 32-bit range). Valorile negative folosesc complementul față de doi, deci GETBITS(-1, 0, 16) este 65535.

Disponibilitate — lățimea după tip necesită TapHome Next 2026.1.40665+. Build-urile mai vechi tratează fiecare valoare ca 32 de biți: o valoare pe 64 de biți își pierde jumătatea superioară, iar un bit peste un tip pe 8 sau 16 biți returnează 0.

GETBIT#

GETBIT returnează valoarea unui singur bit al unui număr, 0 sau 1.

1

GETBIT(number, bit)

Exemplu

GETBIT(2, 0);
# Result: 0
GETBIT(4, 2);
# Result: 1
IF(GETBIT(MODBUSR(H, 600, Uint16), 3) = 1, ADDERROR(3, "Overheating"));

GETBITS#

GETBITS returnează un câmp de biți — numberOfBits biți începând de la startBit — ca număr întreg fără semn.

1

GETBITS(number, startBit, numberOfBits)

Parametri — numberOfBits este 1 – 32 sau 1 – 64 pentru un number pe 64 de biți.

Exemplu

GETBITS(216, 3, 2);
# Result: 3 (216 = 0b11011000, bits 3 and 4 are 1)
GETBITS(0xFF, 0, 4);
# Result: 15

Data și ora împachetate câte doi octeți pe registru (Komfovent):

VAR time := MODBUSR(H, 28, Uint16);
VAR date := MODBUSR(H, 30, Uint16);
GETBITS(time, 8, 8) + ":" + GETBITS(time, 0, 8) + " "
    + GETBITS(date, 0, 8) + "." + GETBITS(date, 8, 8) + "." + MODBUSR(H, 29, Uint16);

SETBIT#

SETBIT returnează numărul cu un bit setat la 0 (când value este 0) sau la 1 (orice altă value).

1

SETBIT(number, bit, value)

Exemplu

SETBIT(1, 1, 1);
# Result: 3
SETBIT(4, 2, 0);
# Result: 0
uint64 alarms := 0;
alarms := SETBIT(alarms, 40, 1);
GETBIT(alarms, 40);
# Result: 1 (a 64-bit variable has bits 0 to 63)

SETBITS#

SETBITS returnează numărul în care câmpul de numberOfBits biți care începe de la startBit este înlocuit cu value.

1

SETBITS(number, startBit, numberOfBits, value)

Exemplu

SETBITS(192, 4, 2, 3);
# Result: 240
SETBITS(192, 5, 2, 3);
# Result: 224

Erori — Given number of bits (2) is not enought for storing the value 4. când value nu încape în câmp (mesajul este scris chiar așa).

GETBYTE#

GETBYTE returnează un octet al unui număr (0 – 255) ca uint.

1

GETBYTE(number, index)

Exemplu

GETBYTE(256, 0);
# Result: 0
GETBYTE(256, 1);
# Result: 1
GETBYTE(259, 0);
# Result: 3

SETBYTE#

SETBYTE returnează numărul în care octetul de la index este înlocuit cu value (0 – 255).

1

SETBYTE(number, index, value)

Exemplu

SETBYTE(256, 0, 255);
# Result: 511
SETBYTE(259, 1, 2);
# Result: 515

Erori — Given value (X) is bigger than maximum byte value.; Given value is less than 0.

TOBCD#

TOBCD convertește un număr întreg în BCD împachetat — fiecare cifră zecimală în propriii 4 biți — și îl returnează ca uint; se păstrează cel mult 8 cifre.

1

TOBCD(number)

Exemplu

TOBCD(1234);
# Result: 4660 (0x1234)

FROMBCD#

FROMBCD convertește o valoare BCD împachetată înapoi într-un număr obișnuit.

1

FROMBCD(number)

Exemplu

FROMBCD(0x1234);
# Result: 1234

Erori — FROMBCD - number 26 is not in BCD format și poziția cifrei, când un grup de 4 biți este mai mare decât 9 (aici 0x1A).

Operatori pe biți și echivalentele din Excel#

Operatorii lucrează cu numere întregi; un operand double se convertește mai întâi în int64, iar un operand Null dă Null. Lista completă și prioritățile se găsesc pe pagina Operatori.

Operatorii pe biți leagă mai slab decât comparațiile: a & 1 > 0 înseamnă a & (1 > 0). Se folosesc întotdeauna paranteze.

VAR status := MODBUSR(H, 5, Uint16);
IF((status & 0x04) > 0, "Door open", "Door closed");

Consultați exemplul operațiilor pe biți în Google Sheets sau încercați instrumentul interactiv bitwisecmd.com.