lirc(4)                      Device Drivers Manual                     lirc(4)

NUME
       lirc - dispozitive lirc (Linux Infrared remote control)

DESCRIERE
       Dispozitivele de caractere /dev/lirc* ofera o interfa<?>a
       bidirec<?>ionala de nivel scazut pentru telecomenzile cu infraro<?>u
       (IR).  Majoritatea acestor dispozitive pot primi, iar unele pot
       trimite.  Atunci cand prime<?>te sau trimite date, controlorul
       func<?>ioneaza in doua moduri diferite, in func<?>ie de hardware-ul
       subiacent.

       Unele echipamente hardware (de obicei, placi TV) decodifica semnalul IR
       intern <?>i furnizeaza apasarile de buton decodificate ca valori ale
       codului de scan. Controlorii pentru acest tip de hardware
       func<?>ioneaza in modul LIRC_MODE_SCANCODE. De obicei, un astfel de
       hardware nu accepta trimiterea de semnale IR. In plus, un astfel de
       hardware poate decodifica doar un set limitat de protocoale IR, de
       obicei doar protocolul telecomenzii specifice care este inclusa, de
       exemplu, cu o placa TV.

       Alte echipamente hardware furnizeaza un flux de durate ale
       impulsurilor/spa<?>iilor. Astfel de controlori func<?>ioneaza in modul
       LIRC_MODE_MODE2. Acest tip de hardware poate fi utilizat cu (aproape)
       orice tip de telecomanda. Acest tip de hardware poate fi utilizat <?>i
       in modul LIRC_MODE_SCANCODE, caz in care decodoarele IR ale nucleului
       vor decoda IR.  Aceste decodoare pot fi scrise in BPF extins (a se
       vedea bpf(2)) <?>i ata<?>ate la dispozitivul lirc.  Uneori, acest tip
       de hardware accepta <?>i trimiterea de date IR.

       Ioctl-ul LIRC_GET_FEATURES (a se vedea mai jos) permite, printre
       altele, sa se verifice daca primirea <?>i trimiterea sunt acceptate
       <?>i in ce moduri.

   Citirea intrarii cu modul LIRC_MODE_MODE2
       In modul LIRC_MODE_MODE2, datele returnate de read(2) furnizeaza valori
       pe 32 de bi<?>i reprezentand un spa<?>iu sau o durata de impuls. Timpul
       duratei (microsecunde) este codificat in cei 24 de bi<?>i inferiori.
       Impulsul (cunoscut <?>i sub denumirea de flash) indica o durata de
       detectare a luminii infraro<?>ii, iar spa<?>iul (cunoscut <?>i sub
       denumirea de spa<?>iu) indica o durata fara infraro<?>u. Daca durata
       spa<?>iului depa<?>e<?>te timpul de inactivitate, este livrat un pachet
       special de timp de inactivitate, care marcheaza sfar<?>itul unui mesaj.
       Cei 8 bi<?>i superiori indica tipul de pachet:

       LIRC_MODE2_SPACE
           Valoarea reflecta o durata a spa<?>iului (microsecunde).

       LIRC_MODE2_PULSE
           Valoarea reflecta durata unui impuls (microsecunde).

       LIRC_MODE2_FREQUENCY
           Valoarea reflecta o frecven<?>a (Hz); consulta<?>i ioctl-ul
           LIRC_SET_MEASURE_CARRIER_MODE.

       LIRC_MODE2_TIMEOUT
           Valoarea reflecta o durata a spa<?>iului (microsecunde).  Pachetul
           reflecta un timp de a<?>teptare; consulta<?>i ioctl-ul
           LIRC_SET_REC_TIMEOUT_REPORTS.

       LIRC_MODE2_OVERFLOW
           Receptorul IR s-a confruntat cu o depa<?>ire de capacitate <?>i,
           prin urmare, datele lipsesc (de la Linux 5.18).

   Citirea intrarii in modul LIRC_MODE_SCANCODE
       In modul LIRC_MODE_SCANCODE, datele returnate de read(2) reflecta
       apasarile de buton decodate, in structura lirc_scancode.  Codul de
       scanare este stocat in campul scancode, iar protocolul IR este stocat
       in rc_proto.  Acest camp are una dintre valorile din structura enum
       rc_proto.

   Scrierea ie<?>irii in modul LIRC_MODE_PULSE
       Datele scrise in dispozitivul de caractere folosind write(2) sunt o
       secven<?>a de impulsuri/spa<?>ii de valori intregi. Impulsurile <?>i
       spa<?>iile sunt marcate doar implicit prin pozi<?>ia lor. Datele
       trebuie sa inceapa <?>i sa se incheie cu un impuls, deci trebuie sa
       includa intotdeauna un numar impar de e<?>antioane. Func<?>ia write(2)
       se blocheaza pana cand datele au fost transmise de hardware. Daca sunt
       furnizate mai multe date decat poate trimite hardware-ul, apelul
       write(2) e<?>ueaza cu eroarea EINVAL.

   Scrierea ie<?>irii in modul LIRC_MODE_SCANCODE
       Datele scrise in dispozitivele de caractere trebuie sa fie o singura
       structura lirc_scancode. Campurile scancode <?>i rc_proto trebuie
       completate, toate celelalte campuri trebuie sa fie 0. Codificatoarele
       IR ale nucleului vor converti scan-codul in impulsuri <?>i spa<?>ii.
       Protocolul sau codul de scanare nu este valid, sau dispozitivul lirc nu
       poate transmite.

COMENZI IOCTL
       #include <linux/lirc.h>    /* Dar consulta<?>i sec<?>iunea ERORI */

       int ioctl(int fd, int cmd, int *val);

       Urmatoarele opera<?>ii ioctl(2) sunt furnizate de dispozitivul de
       caractere lirc pentru a sonda sau modifica parametrii hardware
       specifici lirc.

   Comenzi acceptate intotdeauna
       Dispozitivele /dev/lirc* accepta intotdeauna urmatoarele comenzi:

       LIRC_GET_FEATURES (void)
           Returneaza o masca de bi<?>i de caracteristici combinate;
           consulta<?>i CARACTERISTICI.

       Daca un dispozitiv returneaza un cod de eroare pentru
       LIRC_GET_FEATURES, se poate presupune ca acesta nu este un dispozitiv
       lirc.

   Comenzi op<?>ionale
       Unele dispozitive lirc accepta comenzile enumerate mai jos. Cu
       excep<?>ia cazului in care se specifica altfel, acestea e<?>ueaza cu
       eroarea ENOTTY daca opera<?>ia nu este acceptata sau cu eroarea EINVAL
       daca opera<?>ia a e<?>uat sau au fost furnizate argumente nevalide.
       Daca un controlor nu anun<?>a suportul pentru anumite caracteristici,
       invocarea ioctl-urilor corespunzatoare va e<?>ua cu eroarea ENOTTY.

       LIRC_GET_REC_MODE (void)
              Daca dispozitivul lirc nu are receptor, aceasta opera<?>ie
              e<?>ueaza cu eroarea ENOTTY. In caz contrar, se returneaza modul
              de recep<?>ie, care va fi unul dintre:

              LIRC_MODE_MODE2
                     Controlorul returneaza o secven<?>a de durate ale
                     impulsurilor/spa<?>iilor.

              LIRC_MODE_SCANCODE
                     Controlorul returneaza valorile structurii lirc_scancode,
                     fiecare dintre acestea reprezentand o apasare de buton
                     decodificata.

       LIRC_SET_REC_MODE (int)
              Stabile<?>te modul de recep<?>ie. val este fie
              LIRC_MODE_SCANCODE, fie LIRC_MODE_MODE2.  Daca dispozitivul lirc
              nu are receptor, aceasta opera<?>ie e<?>ueaza cu eroarea ENOTTY.

       LIRC_GET_SEND_MODE (void)
              Returneaza modul de trimitere. Este acceptat modul
              LIRC_MODE_PULSE sau LIRC_MODE_SCANCODE. Daca dispozitivul lirc
              nu poate trimite, aceasta opera<?>ie e<?>ueaza cu eroarea
              ENOTTY.

       LIRC_SET_SEND_MODE (int)
              Stabile<?>te modul de trimitere. val este fie
              LIRC_MODE_SCANCODE, fie LIRC_MODE_PULSE. Daca dispozitivul lirc
              nu poate trimite, aceasta opera<?>ie e<?>ueaza 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 purtatoarei. val este un
              numar in intervalul [0,100] care descrie la<?>imea impulsului ca
              procent din ciclul total. In prezent, nu este definita nicio
              semnifica<?>ie speciala 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 activita<?>ii IR pentru o
              perioada lunga de timp. Acest lucru poate ajuta lircd(8) sa
              detecteze ca un semnal IR s-a terminat <?>i poate accelera
              procesul de decodare. Aceste opera<?>ii returneaza valori
              intregi 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 intreaga pentru timpul de inactivitate IR
              (microsecunde). Pentru a fi acceptata, valoarea trebuie sa fie
              in limitele definite de LIRC_GET_MIN_TIMEOUT <?>i
              LIRC_GET_MAX_TIMEOUT. O valoare de 0 (daca este acceptata de
              hardware) dezactiveaza to<?>i timpii de a<?>teptare hardware,
              iar datele trebuie raportate cat mai curand posibil. Daca
              valoarea exacta nu poate fi definita, atunci trebuie definita
              urmatoarea valoare posibila mai mare decat valoarea data.

       LIRC_GET_REC_TIMEOUT (void)
              Returneaza timpul de inactivitate curent (microsecunde).
              Disponibila de la Linux 4.18.

       LIRC_SET_REC_TIMEOUT_REPORTS (int)
              Activeaza (val este 1) sau dezactiveaza (val este 0) pachetele
              de timp de a<?>teptare in LIRC_MODE_MODE2. Comportamentul
              acestei opera<?>ii a variat in func<?>ie de versiunile
              nucleului:

              o  Incepand cu Linux 5.17: pachetele de timp de a<?>teptare sunt
                 intotdeauna activate, iar acest ioctl este un no-op.

              o  Incepand cu Linux 4.16: pachetele de timp de expirare sunt
                 activate in mod implicit. De fiecare data cand dispozitivul
                 lirc este deschis, opera<?>ia LIRC_SET_REC_TIMEOUT poate fi
                 utilizata pentru a dezactiva (<?>i, daca se dore<?>te, pentru
                 a reactiva ulterior) timpul de a<?>teptare pe descriptorul de
                 fi<?>ier.

              o  In Linux 4.15 <?>i versiunile anterioare: pachetele de timp
                 de a<?>teptare sunt dezactivate in mod implicit, iar
                 activarea lor (prin LIRC_SET_REC_TIMEOUT) pe orice descriptor
                 de fi<?>ier asociat cu dispozitivul lirc are ca efect
                 activarea timpilor de a<?>teptare pentru toate descriptoarele
                 de fi<?>ier care se refera la acel dispozitiv (pana cand
                 timpii de a<?>teptare sunt dezactiva<?>i din nou).

       LIRC_SET_REC_CARRIER (int)
              Stabile<?>te limita superioara a frecven<?>ei purtatoare de
              recep<?>ie (Hz). A se vedea LIRC_SET_REC_CARRIER_RANGE.

       LIRC_SET_REC_CARRIER_RANGE (int)
              Stabile<?>te limita inferioara a frecven<?>ei purtatoare de
              recep<?>ie (Hz). Pentru ca acest lucru sa aiba efect,
              stabili<?>i mai intai limita inferioara utilizand ioctl-ul
              LIRC_SET_REC_CARRIER_RANGE <?>i apoi limita superioara utilizand
              ioctl-ul LIRC_SET_REC_CARRIER.

       LIRC_SET_MEASURE_CARRIER_MODE (int)
              Activeaza (val este 1) sau dezactiveaza (val este 0) modul de
              masurare. Daca este activat, de la urmatoarea apasare de tasta,
              controlorul va trimite pachete LIRC_MODE2_FREQUENCY. In mod
              implicit, acesta ar trebui sa fie dezactivat.

       LIRC_GET_REC_RESOLUTION (void)
              Returneaza rezolu<?>ia controlorului (microsecunde).

       LIRC_SET_TRANSMITTER_MASK (int)
              Activeaza setul de transmi<?>atoare specificate in val, care
              con<?>ine o masca de bi<?>i in care fiecare transmi<?>ator
              activat este un 1. Primul transmi<?>ator este codificat de bitul
              cel mai pu<?>in semnificativ <?>i a<?>a mai departe. Atunci cand
              este data o masca de bi<?>i nevalida, de exemplu un bit este
              activat chiar daca dispozitivul nu are atat de multe
              transmi<?>atoare, aceasta opera<?>ie returneaza numarul de
              transmi<?>atoare disponibile <?>i nu face nimic in caz contrar.

       LIRC_SET_WIDEBAND_RECEIVER (int)
              Unele dispozitive sunt echipate cu un receptor special de banda
              larga care este destinat a fi utilizat pentru a inva<?>a
              ie<?>irea unei telecomenzi existente. Acest ioctl poate fi
              utilizat pentru a activa (val egal cu 1) sau dezactiva (val egal
              cu 0) aceasta func<?>ionalitate. Acest lucru ar putea fi util
              pentru dispozitivele care, altfel, au receptoare cu banda
              ingusta care le impiedica sa fie utilizate cu anumite
              telecomenzi. De asemenea, receptoarele cu banda larga pot fi mai
              precise. Pe de alta parte, dezavantajul lor este, de obicei,
              gama redusa de recep<?>ie.

              Nota: receptorul de banda larga poate fi activat implicit daca
              activa<?>i rapoartele purtatoarei. In acest caz, acesta va fi
              dezactivat de indata ce dezactiva<?>i rapoartele purtatoarei.
              Incercarea de a dezactiva un receptor de banda larga in timp ce
              rapoartele purtatoarei sunt active nu va avea niciun efect.

CARACTERISTICI
       ioctl-ul LIRC_GET_FEATURES returneaza o masca de bi<?>i care descrie
       caracteristicile controlorului. Urmatorii bi<?>i pot fi returna<?>i in
       masca:

       LIRC_CAN_REC_MODE2
              Controlorul este capabil sa recep<?>ioneze utilizand
              LIRC_MODE_MODE2.

       LIRC_CAN_REC_SCANCODE
              Controlorul este capabil sa recep<?>ioneze folosind
              LIRC_MODE_SCANCODE.

       LIRC_CAN_SET_SEND_CARRIER
              Controlorul accepta schimbarea frecven<?>ei de modulare
              utilizand LIRC_SET_SEND_CARRIER.

       LIRC_CAN_SET_SEND_DUTY_CYCLE
              Controlorul accepta modificarea ciclului de func<?>ionare
              utilizand LIRC_SET_SEND_DUTY_CYCLE.

       LIRC_CAN_SET_TRANSMITTER_MASK
              Controlorul accepta schimbarea emi<?>atorului (emi<?>atoarelor)
              activ(e) utilizand LIRC_SET_TRANSMITTER_MASK.

       LIRC_CAN_SET_REC_CARRIER
              Controlorul accepta stabilirea frecven<?>ei purtatoare de
              recep<?>ie utilizand LIRC_SET_REC_CARRIER. Orice dispozitiv lirc
              de la fuzionarea controlorilor in Linux 2.6.36 trebuie sa aiba
              activata func<?>ia LIRC_CAN_SET_REC_CARRIER_RANGE daca este
              activata func<?>ia LIRC_CAN_SET_REC_CARRIER.

       LIRC_CAN_SET_REC_CARRIER_RANGE
              Controlorul accepta LIRC_SET_REC_CARRIER_RANGE. Limita
              inferioara a purtatoarei trebuie mai intai stabilita utilizand
              ioctl-ul LIRC_SET_REC_CARRIER_RANGE, inainte de a utiliza
              ioctl-ul LIRC_SET_REC_CARRIER pentru a stabili limita
              superioara.

       LIRC_CAN_GET_REC_RESOLUTION
              Controlorul accepta LIRC_GET_REC_RESOLUTION.

       LIRC_CAN_SET_REC_TIMEOUT
              Controlorul accepta LIRC_SET_REC_TIMEOUT.

       LIRC_CAN_MEASURE_CARRIER
              Controlorul accepta masurarea frecven<?>ei de modula<?>ie
              utilizand LIRC_SET_MEASURE_CARRIER_MODE.

       LIRC_CAN_USE_WIDEBAND_RECEIVER
              Controlorul accepta modul de inva<?>are utilizand
              LIRC_SET_WIDEBAND_RECEIVER.

       LIRC_CAN_SEND_PULSE
              Controlorul accepta trimiterea folosind LIRC_MODE_PULSE sau
              LIRC_MODE_SCANCODE

ERORI
       Utilizarea acestor dispozitive necesita fi<?>ierul de antet al sursei
       nucleului lirc.h. Acest fi<?>ier nu este disponibil inainte de Linux
       4.6.  Utilizatorii de nuclee mai vechi ar putea folosi fi<?>ierul
       inclus in <http://www.lirc.org>.

CONSULTA<?>I <?>I
       ir-ctl(1), lircd(8), bpf(2)

       <https://www.kernel.org/doc/html/latest/userspace-api/media/rc/
       lirc-dev.html>

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.12 1 septembrie 2024                       lirc(4)