.\" -*- coding: UTF-8 -*- .\" Copyright (c) 2015-2016, Alec Leamas .\" Copyright (c) 2018, Sean Young .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH lirc 4 "3 mai 2023" "Pages du manuel de Linux 6.05.01" .SH NOM lirc —\ périphériques lirc .SH DESCRIPTION Les périphériques caractères \fI/dev/lirc*\fP fournissent une interface bidirectionnelle de bas niveau pour les télécommandes infrarouges (IR). La plupart de ces périphériques peuvent recevoir et certains peuvent émettre. Lors de la réception ou de l’émission de données, le pilote fonctionne dans deux modes différents selon le matériel sous\-jacent. .PP Certains matériels (typiquement les cartes TV) décodent le signal infrarouge en interne et fournissent des décodages d’appui de bouton sous forme de code d’analyse d’évènement du clavier (scancode). Les pilotes de cette sorte de matériel fonctionnent dans le mode \fBLIRC_MODE_SCANCODE\fP. De tels matériels habituellement ne gèrent pas l’émission de signaux infrarouges. De plus, de tels matériels ne peuvent décoder seulement qu’un nombre limité de protocoles, habituellement seulement le protocole de la télécommande particulière fournie avec, par exemple, une carte TV. .PP D’autres matériels fournissent un flux d’impulsions/intervalles. De tels pilotes fonctionnent dans le mode \fBLIRC_MODE_MODE2\fP. De tels matériels peuvent être utilisés (presque) avec n’importe quelle sorte de télécommande. Ce genre de matériel peut être aussi utilisé dans le mode \fBLIRC_MODE_SCANCODE\fP, auquel cas les décodeurs IR du noyau décoderont les signaux infrarouges. Ces décodeurs peuvent être écrits en BPF étendu (consulter \fBbpf\fP(2)) et attachés au périphérique \fBlirc\fP. Quelquefois ce genre de matériel gère l’émission de données par IR. .PP .\" L’ioctl \fBLIRC_GET_FEATURES\fP (voir ci\-après) permet de savoir si l’émission et la réception sont prises en charge, et, entre autres caractéristiques, dans quels modes. .SS "Lecture de l’entrée avec le mode LIRC_MODE_MODE2" Dans le mode \fBLIRC_MODE_MODE2\fP, les données renvoyées par \fBread\fP(2) fournissent des valeurs en 32\ bits représentant une durée d’intervalle ou d’impulsion. La durée (en microsecondes) est encodée dans les 24\ bits de plus faible poids. L’impulsion (pulse aussi appelée flash) indique une durée de lumière infrarouge détectée et l’intervalle (space aussi appelé gap) indique une durée sans infrarouges. Si la durée de l’intervalle excède la temporisation (timeout) d’inactivité, un paquet spécial de temporisation est émis qui marque la fin du message. Les 8\ bits de poids le plus fort indiquent le type de paquet\ : .TP 4 \fBLIRC_MODE2_SPACE\fP La valeur indique une durée d’intervalle (microsecondes) .TP 4 \fBLIRC_MODE2_PULSE\fP La valeur indique une durée d’impulsion (microsecondes) .TP 4 \fBLIRC_MODE2_FREQUENCY\fP La valeur indique une fréquence (Hz); consulter l’ioctl \fBLIRC_SET_MEASURE_CARRIER_MODE\fP. .TP 4 \fBLIRC_MODE2_TIMEOUT\fP .\" La valeur indique une durée d’intervalle (microsecondes). Le paquet indique une temporisation\ ; consulter l’ioctl \fBLIRC_SET_REC_TIMEOUT_REPORTS\fP. .TP 4 \fBLIRC_MODE2_OVERFLOW\fP Le récepteur IR est victime d’un débordement, et en conséquence des données manquent (depuis Linux\ 5.18). .SS "Lecture de l’entrée avec le mode LIRC_MODE_SCANCODE" .\" Dans le mode \fBLIRC_MODE_SCANCODE\fP, les données renvoyées par \fBread\fP(2) reflètent les décodages d’appui sur les boutons dans la structure \fIlirc_scancode\fP. Le scancode est stocké dans le champ \fIscancode\fP, et le protocole IR est stocké dans \fIrc_proto\fP. Ce champ a une des valeurs de \fIenum rc_proto\fP. .SS "Écriture de la sortie avec le mode LIRC_MODE_PULSE" Les données écrites sur le périphérique caractère en utilisant \fBwrite\fP(2) sont une séquence d’impulsions/intervalles de valeurs entières. Les impulsions et les intervalles sont marqués implicitement par leur position. Les données doivent débuter et se terminer par une impulsion, par conséquent elles doivent toujours inclurent un nombre impair d’échantillons. La fonction \fBwrite\fP(2) bloque jusqu’à ce que les données aient été transmises par l’appareil. Si plus de données sont fournies que ce que l’appareil peut envoyer, l’appel \fBwrite\fP(2) échoue avec l’erreur \fBEINVAL\fP. .SS "Écriture de la sortie avec le mode LIRC_MODE_SCANCODE" Les données écrites sur le périphérique caractère doivent être en une seule structure \fIlirc_scancode\fP. Les champs \fIscancode\fP et \fIrc_proto\fP doivent renseigner, tous les autres champs doivent être être\ 0. Les encodeurs IR du noyau convertiront le scancode en impulsions et intervalles. Le protocole ou le scancode est non valable, ou le périphérique \fBlirc\fP ne peut pas transmettre. .SH "COMMANDES IOCTL" .nf #include /* Mais voir BOGUES */ \& int ioctl(int fd, int cmd, int *val); .fi .PP Les opérations d’\fBioctl\fP(2) suivantes sont fournies par le périphérique caractère \fBlirc\fP pour examiner ou modifier les réglages \fBlirc\fP du matériel. .SS "Commandes toujours prises en charge" Les périphériques \fI/dev/lirc*\fP gèrent toujours la commande suivante\ : .TP 4 \fBLIRC_GET_FEATURES\fP (\fIvoid\fP) Renvoi d’un masque de bits des bits combinés de fonctionnalités\ ; consulter FONCTIONNALITÉS. .PP .\" Si un périphérique renvoie un code d’erreur pour \fBLIRC_GET_FEATURES\fP, il est normal de présumer que ce n’est pas un périphérique \fBlirc\fP. .SS "Commandes facultatives" Quelques périphériques \fBlirc\fP prennent en charge les commandes listées ci\-après. À moins d’être déclarées autrement, elles échouent avec l’erreur \fBENOTTY\fP si l’opération n’est pas gérée, ou avec l’erreur \fBEINVAL\fP si l’opération échoue ou si des arguments non valables sont fournis. Si le pilote n’annonce pas que certaines fonctionnalités ne sont pas gérées, l’invocation des ioctls correspondants échouera avec l’erreur \fBENOTTY\fP. .TP \fBLIRC_GET_REC_MODE\fP (\fIvoid\fP) Si le périphérique \fBlirc\fP n’a pas de récepteur, cette opération échouera avec l’erreur \fBENOTTY\fP. Sinon le mode de réception sera renvoyé et sera un des suivants\ : .RS .TP \fBLIRC_MODE_MODE2\fP le pilote renvoie une séquence de durées d’impulsion/intervalles\ ; .TP \fBLIRC_MODE_SCANCODE\fP le pilote renvoie les valeurs de la structure \fIlirc_scancode\fP, chacune d’elles représentant le décodage d’appui d’un bouton. .RE .TP \fBLIRC_SET_REC_MODE\fP (\fIint\fP) Réglage du mode de réception. \fIval\fP est soit \fBLIRC_MODE_SCANCODE\fP ou \fBLIRC_MODE_MODE2\fP. Si le périphérique \fBlirc\fP n’a pas de récepteur, cette opération échoue avec l’erreur \fBENOTTY.\fP .TP \fBLIRC_GET_SEND_MODE\fP (\fIvoid\fP) Renvoi du mode d’émission. \fBLIRC_MODE_PULSE\fP ou \fBLIRC_MODE_SCANCODE\fP sont gérées. Si le périphérique \fBlirc\fP ne peut pas émettre, cette opération échoue avec l’erreur \fBENOTTY.\fP .TP \fBLIRC_SET_SEND_MODE\fP (\fIint\fP) Réglage du mode d’émission. \fIval\fP est soit \fBLIRC_MODE_SCANCODE\fP ou \fBLIRC_MODE_PULSE\fP. Si le périphérique \fBlirc\fP ne peut pas émettre, cette opération échoue avec l’erreur \fBENOTTY.\fP .TP \fBLIRC_SET_SEND_CARRIER\fP (\fIint\fP) Réglage de la fréquence de modulation. L’argument est la fréquence (Hz). .TP \fBLIRC_SET_SEND_DUTY_CYCLE\fP (\fIint\fP) Réglage du cycle opératoire de la porteuse. \fIval\fP est un nombre dans l’intervalle [0,100] qui décrit la largeur d’impulsion comme un pourcentage du cycle total. Actuellement, aucune signification spéciale n’est donnée à 0 ou 100, mais ces valeurs sont réservées pour une utilisation future. .TP \fBLIRC_GET_MIN_TIMEOUT\fP (\fIvoid\fP)\fB,\fP \fBLIRC_GET_MAX_TIMEOUT\fP (\fIvoid\fP) Certains périphériques ont des minuteurs internes qui peuvent être utilisés pour détecter lorsqu’il n’y a pas eu d’activité IR depuis un long moment. Cela peut aider \fBlircd\fP(8) dans la détection qu’un signal IR a cessé, et peut accélérer le processus de décodage. Ces opérations renvoient des valeurs entières avec une temporisation minimale ou maximale pouvant être définie (microsecondes). Certains périphériques ont une temporisation fixe. Pour de tels pilotes, \fBLIRC_GET_MIN_TIMEOUT\fP et \fBLIRC_GET_MAX_TIMEOUT\fP échoueront avec l’erreur \fBENOTTY\fP. .TP \fBLIRC_SET_REC_TIMEOUT\fP (\fIint\fP) Réglage de la valeur entière pour la temporisation d’inactivité IR (microsecondes). Pour être acceptée la valeur doit être entre des limites définies par \fBLIRC_GET_MIN_TIMEOUT\fP et \fBLIRC_GET_MAX_TIMEOUT\fP. Une valeur de\ 0 (si acceptée par le matériel) désactive toutes les temporisations de matériel et les données devraient être annoncées le plus tôt possible. Si la valeur exacte ne peut être réglée, alors la valeur \fIsupérieure\fP possible la plus proche de la valeur donnée devrait être définie. .TP \fBLIRC_GET_REC_TIMEOUT\fP (\fIvoid\fP) Renvoi de la temporisation actuelle (microsecondes). Depuis Linux\ 4.18. .TP \fBLIRC_SET_REC_TIMEOUT_REPORTS\fP (\fIint\fP) Activation (\fIval\fP est\ 1) ou désactivation (\fIval\fP est\ 0) des paquets de temporisation dans \fBLIRC_MODE_MODE2\fP. Le comportement de cette opération a varié selon les versions du noyau\ : .RS .IP \- 3 Depuis Linux\ 5.17\ : les paquets de temporisation sont toujours activés et cet ioctl ne produit aucun effet. .IP \- Depuis Linux\ 4.16\ : les paquets de temporisation sont activés par défaut. Chaque fois que le périphérique \fBlirc\fP est ouvert, l’opération \fBLIRC_SET_REC_TIMEOUT\fP peut être utilisée pour désactiver (et, si désiré, réactiver ultérieurement) la temporisation sur le descripteur de fichier. .IP \- Dans Linux\ 4.15 et précédents\ : les paquets de temporisation sont désactivés par défaut et leur activation (à l’aide de \fBLIRC_SET_REC_TIMEOUT\fP) sur n’importe quel descripteur de fichier associé avec le périphérique \fBlirc\fP a pour effet d’activer les temporisations pour tous les descripteurs de fichier référant à ce périphérique (jusqu’à ce que les temporisations soient désactivés de nouveau). .RE .TP \fBLIRC_SET_REC_CARRIER\fP (\fIint\fP) Réglage de la limite supérieure de la fréquence de la porteuse de réception (Hz). Consulter \fBLIRC_SET_REC_CARRIER_RANGE\fP. .TP \fBLIRC_SET_REC_CARRIER_RANGE\fP (\fIint\fP) Réglage de la limite inférieure de la fréquence de la porteuse de réception (Hz). Pour que ces réglages soient effectifs, il faut régler la limite inférieure en utilisant l’ioctl \fBLIRC_SET_REC_CARRIER_RANGE\fP, puis la limite supérieure en utilisant l’ioctl \fBLIRC_SET_REC_CARRIER\fP. .TP \fBLIRC_SET_MEASURE_CARRIER_MODE\fP (\fIint\fP) Activation (\fIval\fP vaut 1) ou désactivation (\fIval\fP vaut 0) du mode de mesure. Si activé, lors du prochain appui de touche, le pilote enverra des paquets \fBLIRC_MODE2_FREQUENCY\fP. Par défaut, cela devrait être désactivé. .TP \fBLIRC_GET_REC_RESOLUTION\fP (\fIvoid\fP) Renvoi de la résolution du pilote (microsecondes). .TP \fBLIRC_SET_TRANSMITTER_MASK\fP (\fIint\fP) Activation de l’ensemble des émetteurs indiqués dans \fIval\fP, qui contient un masque de bits ou chaque émetteur activé est un\ 1. Le premier émetteur est encodé par le bit de poids le plus faible,\ etc. Quand un masque de bits non valable est fourni, par exemple un bit est défini bien que le périphérique n’ait pas autant d’émetteurs, cette opération renvoie le nombre d’émetteurs disponibles et ne fait rien d’autre autrement. .TP \fBLIRC_SET_WIDEBAND_RECEIVER\fP (\fIint\fP) Certains périphériques sont équipés d’un récepteur large bande qui est prévu pour découvrir la sortie d’une télécommande existante. Cet ioctl peut être utilisé pour activer (\fIval\fP vaut\ 1) ou désactiver (\fIval\fP vaut\ 0) cette fonctionnalité. Cela peut être utile pour des périphériques qui autrement ont des récepteurs à bande étroite pour empêcher une utilisation avec certaines télécommandes. Les récepteurs à large bande peuvent être aussi plus précis. D’un autre côté, leur désavantage est en général une réduction de la bande de réception. .IP .\" Remarque\ : le récepteur large bande peut être implicitement activé si les annonces de porteuse sont activées. Dans ce cas, il sera désactivé aussitôt que les annonces de porteuse seront désactivées. Essayer de déactiver un récepteur large bande alors que les annonces de porteuse sont activées est sans effet. .SH FONCTIONNALITÉS L’ioctl \fBLIRC_GET_FEATURES\fP renvoie un masque de bits décrivant les fonctionnalités du pilote. Les bits suivants peuvent être renvoyés dans le masque\ : .TP \fBLIRC_CAN_REC_MODE2\fP Le pilote peut recevoir en utilisant \fBLIRC_MODE_MODE2\fP. .TP \fBLIRC_CAN_REC_SCANCODE\fP Le pilote peut recevoir en utilisant \fBLIRC_MODE_SCANCODE\fP. .TP \fBLIRC_CAN_SET_SEND_CARRIER\fP Le pilote gère la modification de la fréquence de modulation en utilisant \fBLIRC_SET_SEND_CARRIER\fP. .TP \fBLIRC_CAN_SET_SEND_DUTY_CYCLE\fP Le pilote gère la modification du cycle opératoire en utilisant \fBLIRC_SET_SEND_DUTY_CYCLE\fP. .TP \fBLIRC_CAN_SET_TRANSMITTER_MASK\fP Le pilot gère les émetteurs actifs en utilisant \fBLIRC_SET_TRANSMITTER_MASK\fP. .TP \fBLIRC_CAN_SET_REC_CARRIER\fP Le pilote gère le réglage de la fréquence de la porteuse en utilisant \fBLIRC_SET_REC_CARRIER\fP. N’importe quel périphérique \fBlirc\fP depuis que les pilotes ont été intégrés dans Linux\ 2.6.36 peut avoir \fBLIRC_CAN_SET_REC_CARRIER_RANGE\fP déclaré si la fonctionnalité \fBLIRC_CAN_SET_REC_CARRIER\fP est activée. .TP \fBLIRC_CAN_SET_REC_CARRIER_RANGE\fP Le pilote gère \fBLIRC_SET_REC_CARRIER_RANGE\fP. La limite basse de la porteuse doit être d’abord définie en utilisant l’ioctl \fBLIRC_SET_REC_CARRIER_RANGE\fP, avant d’utiliser l’ioctl \fBLIRC_SET_REC_CARRIER\fP pour définir la limite supérieure. .TP \fBLIRC_CAN_GET_REC_RESOLUTION\fP Le pilote gère \fBLIRC_GET_REC_RESOLUTION\fP. .TP \fBLIRC_CAN_SET_REC_TIMEOUT\fP Le pilote gère \fBLIRC_SET_REC_TIMEOUT\fP. .TP \fBLIRC_CAN_MEASURE_CARRIER\fP Le pilote gère la mesure de la fréquence de modulation en utilisant \fBLIRC_SET_MEASURE_CARRIER_MODE\fP. .TP \fBLIRC_CAN_USE_WIDEBAND_RECEIVER\fP Le pilote gère le mode d’apprentissage en utilisant \fBLIRC_SET_WIDEBAND_RECEIVER\fP. .TP \fBLIRC_CAN_SEND_PULSE\fP .\" Le pilote gère l’émission en utilisant \fBLIRC_MODE_PULSE\fP ou \fBLIRC_MODE_SCANCODE\fP .SH BOGUES .\" L’utilisation de ces périphériques nécessite le fichier source d’en\-tête du noyau \fIlirc.h\fP. Ce fichier n’était pas disponible avant Linux\ 4.6. Les utilisateurs de noyaux plus anciens peuvent utiliser le fichier disponible dans .UR http://www.lirc.org .UE . .SH "VOIR AUSSI" \fBir\-ctl\fP(1), \fBlircd\fP(8),\ \fBbpf\fP(2) .PP .UR https://www.kernel.org/\:doc/\:html/\:latest/\:userspace\-api/\:media/\:rc/\:lirc\-dev.html .UE .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot et Jean-Paul Guillonneau . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .