Citirea intrării cu modul LIRC_MODE_MODE2

În modul LIRC_MODE_MODE2, datele returnate de read(2) furnizează valori pe 32 de biți reprezentând un spațiu sau o durată de impuls. Timpul duratei (microsecunde) este codificat în cei 24 de biți inferiori. Impulsul (cunoscut și sub denumirea de flash) indică o durată de detectare a luminii infraroșii, iar spațiul (cunoscut și sub denumirea de spațiu) indică o durată fără infraroșu. Dacă durata spațiului depășește timpul de inactivitate, este livrat un pachet special de timp de inactivitate, care marchează sfârșitul unui mesaj. Cei 8 biți superiori indică tipul de pachet:

LIRC_MODE2_SPACE

Valoarea reflectă o durată a spațiului (microsecunde).

LIRC_MODE2_PULSE

Valoarea reflectă durata unui impuls (microsecunde).

LIRC_MODE2_FREQUENCY

Valoarea reflectă o frecvență (Hz); consultați ioctl-ul LIRC_SET_MEASURE_CARRIER_MODE.

LIRC_MODE2_TIMEOUT

Valoarea reflectă o durată a spațiului (microsecunde). Pachetul reflectă un timp de așteptare; consultați ioctl-ul LIRC_SET_REC_TIMEOUT_REPORTS.

LIRC_MODE2_OVERFLOW

Receptorul IR s-a confruntat cu o depășire de capacitate și, prin urmare, datele lipsesc (de la Linux 5.18).

Citirea intrării în modul LIRC_MODE_SCANCODE

În modul LIRC_MODE_SCANCODE, datele returnate de read(2) reflectă apăsările de buton decodate, în structura lirc_scancode. Codul de scanare este stocat în câmpul scancode, iar protocolul IR este stocat în rc_proto. Acest câmp are una dintre valorile din structura enum rc_proto.

Scrierea ieșirii în modul LIRC_MODE_PULSE

Datele scrise în dispozitivul de caractere folosind write(2) sunt o secvență de impulsuri/spații de valori întregi. Impulsurile și spațiile sunt marcate doar implicit prin poziția lor. Datele trebuie să înceapă și să se încheie cu un impuls, deci trebuie să includă întotdeauna un număr impar de eșantioane. Funcția write(2) se blochează până când datele au fost transmise de hardware. Dacă sunt furnizate mai multe date decât poate trimite hardware-ul, apelul write(2) eșuează cu eroarea EINVAL.

Scrierea ieșirii în modul LIRC_MODE_SCANCODE

Datele scrise în dispozitivele de caractere trebuie să fie o singură structură lirc_scancode. Câmpurile scancode și rc_proto trebuie completate, toate celelalte câmpuri trebuie să fie 0. Codificatoarele IR ale nucleului vor converti scan-codul în impulsuri și spații. Protocolul sau codul de scanare nu este valid, sau dispozitivul lirc nu poate transmite.

Comenzi acceptate întotdeauna

Dispozitivele /dev/lirc* acceptă întotdeauna următoarele comenzi:

LIRC_GET_FEATURES (void)

Returnează o mască de biți de caracteristici combinate; consultați CARACTERISTICI.

Dacă un dispozitiv returnează un cod de eroare pentru LIRC_GET_FEATURES, se poate presupune că acesta nu este un dispozitiv lirc.

Comenzi opționale

Unele dispozitive lirc acceptă comenzile enumerate mai jos. Cu excepția cazului în care se specifică altfel, acestea eșuează cu eroarea ENOTTY dacă operația nu este acceptată sau cu eroarea EINVAL dacă operația a eșuat sau au fost furnizate argumente nevalide. Dacă un controlor nu anunță suportul pentru anumite caracteristici, invocarea ioctl-urilor corespunzătoare va eșua cu eroarea ENOTTY.

LIRC_GET_REC_MODE (void)

Dacă dispozitivul lirc nu are receptor, această operație eșuează cu eroarea ENOTTY. În caz contrar, se returnează modul de recepție, care va fi unul dintre:

LIRC_SET_REC_MODE (int)

Stabilește modul de recepție. val este fie LIRC_MODE_SCANCODE, fie LIRC_MODE_MODE2. Dacă dispozitivul lirc nu are receptor, această operație eșuează cu eroarea ENOTTY.

LIRC_GET_SEND_MODE (void)

Returnează modul de trimitere. Este acceptat modul LIRC_MODE_PULSE sau LIRC_MODE_SCANCODE. Dacă dispozitivul lirc nu poate trimite, această operație eșuează cu eroarea ENOTTY.

LIRC_SET_SEND_MODE (int)

Stabilește modul de trimitere. val este fie LIRC_MODE_SCANCODE, fie LIRC_MODE_PULSE. Dacă dispozitivul lirc nu poate trimite, această operație eșuează cu eroarea ENOTTY.

LIRC_SET_SEND_CARRIER (int)

Stabilește frecvența de modulație. Argumentul este frecvența (Hz).

LIRC_SET_SEND_DUTY_CYCLE (int)

Stabilește ciclul de funcționare al purtătoarei. val este un număr în intervalul [0,100] care descrie lățimea impulsului ca procent din ciclul total. În prezent, nu este definită nicio semnificație specială pentru 0 sau 100, dar valorile sunt rezervate pentru utilizare viitoare.

LIRC_GET_MIN_TIMEOUT(void)

LIRC_GET_MAX_TIMEOUT(void)

Unele dispozitive au temporizatoare interne care pot fi utilizate pentru a detecta absența activității IR pentru o perioadă lungă de timp. Acest lucru poate ajuta lircd(8) să detecteze că un semnal IR s-a terminat și poate accelera procesul de decodare. Aceste operații returnează valori întregi cu timpul de așteptare minim/maxim care poate fi definit (microsecunde). Unele dispozitive au un timp fix de așteptare. Pentru astfel de controlori, LIRC_GET_MIN_TIMEOUT și LIRC_GET_MAX_TIMEOUT vor eșua cu eroarea ENOTTY.

LIRC_SET_REC_TIMEOUT (int)

Stabilește valoarea întreagă pentru timpul de inactivitate IR (microsecunde). Pentru a fi acceptată, valoarea trebuie să fie în limitele definite de LIRC_GET_MIN_TIMEOUT și LIRC_GET_MAX_TIMEOUT. O valoare de 0 (dacă este acceptată de hardware) dezactivează toți timpii de așteptare hardware, iar datele trebuie raportate cât mai curând posibil. Dacă valoarea exactă nu poate fi definită, atunci trebuie definită următoarea valoare posibilă mai mare decât valoarea dată.

LIRC_GET_REC_TIMEOUT (void)

Returnează timpul de inactivitate curent (microsecunde). Disponibilă de la Linux 4.18.

LIRC_SET_REC_TIMEOUT_REPORTS (int)

Activează (val este 1) sau dezactivează (val este 0) pachetele de timp de așteptare în LIRC_MODE_MODE2. Comportamentul acestei operații a variat în funcție de versiunile nucleului:

LIRC_SET_REC_CARRIER (int)

Stabilește limita superioară a frecvenței purtătoare de recepție (Hz). A se vedea LIRC_SET_REC_CARRIER_RANGE.

LIRC_SET_REC_CARRIER_RANGE (int)

Stabilește limita inferioară a frecvenței purtătoare de recepție (Hz). Pentru ca acest lucru să aibă efect, stabiliți mai întâi limita inferioară utilizând ioctl-ul LIRC_SET_REC_CARRIER_RANGE și apoi limita superioară utilizând ioctl-ul LIRC_SET_REC_CARRIER.

LIRC_SET_MEASURE_CARRIER_MODE (int)

Activează (val este 1) sau dezactivează (val este 0) modul de măsurare. Dacă este activat, de la următoarea apăsare de tastă, controlorul va trimite pachete LIRC_MODE2_FREQUENCY. În mod implicit, acesta ar trebui să fie dezactivat.

LIRC_GET_REC_RESOLUTION (void)

Returnează rezoluția controlorului (microsecunde).

LIRC_SET_TRANSMITTER_MASK (int)

Activează setul de transmițătoare specificate în val, care conține o mască de biți în care fiecare transmițător activat este un 1. Primul transmițător este codificat de bitul cel mai puțin semnificativ și așa mai departe. Atunci când este dată o mască de biți nevalidă, de exemplu un bit este activat chiar dacă dispozitivul nu are atât de multe transmițătoare, această operație returnează numărul de transmițătoare disponibile și nu face nimic în caz contrar.

LIRC_SET_WIDEBAND_RECEIVER (int)

Unele dispozitive sunt echipate cu un receptor special de bandă largă care este destinat a fi utilizat pentru a învăța ieșirea unei telecomenzi existente. Acest ioctl poate fi utilizat pentru a activa (val egal cu 1) sau dezactiva (val egal cu 0) această funcționalitate. Acest lucru ar putea fi util pentru dispozitivele care, altfel, au receptoare cu bandă îngustă care le împiedică să fie utilizate cu anumite telecomenzi. De asemenea, receptoarele cu bandă largă pot fi mai precise. Pe de altă parte, dezavantajul lor este, de obicei, gama redusă de recepție.

Notă: receptorul de bandă largă poate fi activat implicit dacă activați rapoartele purtătoarei. În acest caz, acesta va fi dezactivat de îndată ce dezactivați rapoartele purtătoarei. Încercarea de a dezactiva un receptor de bandă largă în timp ce rapoartele purtătoarei sunt active nu va avea niciun efect.