Provided by: manpages-fr_4.21.0-2_all 
NOM
lirc — périphériques lirc
DESCRIPTION
Les périphériques caractères /dev/lirc* 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.
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
LIRC_MODE_SCANCODE. 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.
D’autres matériels fournissent un flux d’impulsions/intervalles. De tels pilotes
fonctionnent dans le mode LIRC_MODE_MODE2. 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 LIRC_MODE_SCANCODE, auquel cas les décodeurs IR du noyau
décoderont les signaux infrarouges. Ces décodeurs peuvent être écrits en BPF étendu
(consulter bpf(2)) et attachés au périphérique lirc. Quelquefois ce genre de matériel gère
l’émission de données par IR.
L’ioctl LIRC_GET_FEATURES (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.
Lecture de l’entrée avec le mode LIRC_MODE_MODE2
Dans le mode LIRC_MODE_MODE2, les données renvoyées par read(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 :
LIRC_MODE2_SPACE
La valeur indique une durée d’intervalle (microsecondes)
LIRC_MODE2_PULSE
La valeur indique une durée d’impulsion (microsecondes)
LIRC_MODE2_FREQUENCY
La valeur indique une fréquence (Hz); consulter l’ioctl LIRC_SET_MEASURE_CARRIER_MODE.
LIRC_MODE2_TIMEOUT
La valeur indique une durée d’intervalle (microsecondes). Le paquet indique une
temporisation ; consulter l’ioctl LIRC_SET_REC_TIMEOUT_REPORTS.
LIRC_MODE2_OVERFLOW
Le récepteur IR est victime d’un débordement, et en conséquence des données manquent
(depuis Linux 5.18).
Lecture de l’entrée avec le mode LIRC_MODE_SCANCODE
Dans le mode LIRC_MODE_SCANCODE, les données renvoyées par read(2) reflètent les décodages
d’appui sur les boutons dans la structure lirc_scancode. Le scancode est stocké dans le
champ scancode, et le protocole IR est stocké dans rc_proto. Ce champ a une des valeurs de
enum rc_proto.
Écriture de la sortie avec le mode LIRC_MODE_PULSE
Les données écrites sur le périphérique caractère en utilisant write(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 write(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 write(2) échoue avec l’erreur EINVAL.
É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
lirc_scancode. Les champs scancode et rc_proto 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 lirc ne peut
pas transmettre.
COMMANDES IOCTL
#include <linux/lirc.h> /* Mais voir BOGUES */
int ioctl(int fd, int cmd, int *val);
Les opérations d’ioctl(2) suivantes sont fournies par le périphérique caractère lirc pour
examiner ou modifier les réglages lirc du matériel.
Commandes toujours prises en charge
Les périphériques /dev/lirc* gèrent toujours la commande suivante :
LIRC_GET_FEATURES (void)
Renvoi d’un masque de bits des bits combinés de fonctionnalités ; consulter
FONCTIONNALITÉS.
Si un périphérique renvoie un code d’erreur pour LIRC_GET_FEATURES, il est normal de
présumer que ce n’est pas un périphérique lirc.
Commandes facultatives
Quelques périphériques lirc prennent en charge les commandes listées ci-après. À moins
d’être déclarées autrement, elles échouent avec l’erreur ENOTTY si l’opération n’est pas
gérée, ou avec l’erreur EINVAL 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 ENOTTY.
LIRC_GET_REC_MODE (void)
Si le périphérique lirc n’a pas de récepteur, cette opération échouera avec
l’erreur ENOTTY. Sinon le mode de réception sera renvoyé et sera un des suivants :
LIRC_MODE_MODE2
le pilote renvoie une séquence de durées d’impulsion/intervalles ;
LIRC_MODE_SCANCODE
le pilote renvoie les valeurs de la structure lirc_scancode, chacune d’elles
représentant le décodage d’appui d’un bouton.
LIRC_SET_REC_MODE (int)
Réglage du mode de réception. val est soit LIRC_MODE_SCANCODE ou LIRC_MODE_MODE2.
Si le périphérique lirc n’a pas de récepteur, cette opération échoue avec l’erreur
ENOTTY.
LIRC_GET_SEND_MODE (void)
Renvoi du mode d’émission. LIRC_MODE_PULSE ou LIRC_MODE_SCANCODE sont gérées. Si le
périphérique lirc ne peut pas émettre, cette opération échoue avec l’erreur ENOTTY.
LIRC_SET_SEND_MODE (int)
Réglage du mode d’émission. val est soit LIRC_MODE_SCANCODE ou LIRC_MODE_PULSE. Si
le périphérique lirc ne peut pas émettre, cette opération échoue avec l’erreur
ENOTTY.
LIRC_SET_SEND_CARRIER (int)
Réglage de la fréquence de modulation. L’argument est la fréquence (Hz).
LIRC_SET_SEND_DUTY_CYCLE (int)
Réglage du cycle opératoire de la porteuse. val 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.
LIRC_GET_MIN_TIMEOUT (void), LIRC_GET_MAX_TIMEOUT (void)
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 lircd(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,
LIRC_GET_MIN_TIMEOUT et LIRC_GET_MAX_TIMEOUT échoueront avec l’erreur ENOTTY.
LIRC_SET_REC_TIMEOUT (int)
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
LIRC_GET_MIN_TIMEOUT et LIRC_GET_MAX_TIMEOUT. 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 supérieure possible la plus proche de la valeur donnée devrait être
définie.
LIRC_GET_REC_TIMEOUT (void)
Renvoi de la temporisation actuelle (microsecondes). Depuis Linux 4.18.
LIRC_SET_REC_TIMEOUT_REPORTS (int)
Activation (val est 1) ou désactivation (val est 0) des paquets de temporisation
dans LIRC_MODE_MODE2. Le comportement de cette opération a varié selon les versions
du noyau :
- Depuis Linux 5.17 : les paquets de temporisation sont toujours activés et cet
ioctl ne produit aucun effet.
- Depuis Linux 4.16 : les paquets de temporisation sont activés par défaut. Chaque
fois que le périphérique lirc est ouvert, l’opération LIRC_SET_REC_TIMEOUT peut
être utilisée pour désactiver (et, si désiré, réactiver ultérieurement) la
temporisation sur le descripteur de fichier.
- 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 LIRC_SET_REC_TIMEOUT) sur n’importe quel
descripteur de fichier associé avec le périphérique lirc 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).
LIRC_SET_REC_CARRIER (int)
Réglage de la limite supérieure de la fréquence de la porteuse de réception (Hz).
Consulter LIRC_SET_REC_CARRIER_RANGE.
LIRC_SET_REC_CARRIER_RANGE (int)
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 LIRC_SET_REC_CARRIER_RANGE, puis la limite supérieure en
utilisant l’ioctl LIRC_SET_REC_CARRIER.
LIRC_SET_MEASURE_CARRIER_MODE (int)
Activation (val vaut 1) ou désactivation (val vaut 0) du mode de mesure. Si activé,
lors du prochain appui de touche, le pilote enverra des paquets
LIRC_MODE2_FREQUENCY. Par défaut, cela devrait être désactivé.
LIRC_GET_REC_RESOLUTION (void)
Renvoi de la résolution du pilote (microsecondes).
LIRC_SET_TRANSMITTER_MASK (int)
Activation de l’ensemble des émetteurs indiqués dans val, 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.
LIRC_SET_WIDEBAND_RECEIVER (int)
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 (val vaut 1) ou désactiver (val 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.
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.
FONCTIONNALITÉS
L’ioctl LIRC_GET_FEATURES renvoie un masque de bits décrivant les fonctionnalités du
pilote. Les bits suivants peuvent être renvoyés dans le masque :
LIRC_CAN_REC_MODE2
Le pilote peut recevoir en utilisant LIRC_MODE_MODE2.
LIRC_CAN_REC_SCANCODE
Le pilote peut recevoir en utilisant LIRC_MODE_SCANCODE.
LIRC_CAN_SET_SEND_CARRIER
Le pilote gère la modification de la fréquence de modulation en utilisant
LIRC_SET_SEND_CARRIER.
LIRC_CAN_SET_SEND_DUTY_CYCLE
Le pilote gère la modification du cycle opératoire en utilisant
LIRC_SET_SEND_DUTY_CYCLE.
LIRC_CAN_SET_TRANSMITTER_MASK
Le pilot gère les émetteurs actifs en utilisant LIRC_SET_TRANSMITTER_MASK.
LIRC_CAN_SET_REC_CARRIER
Le pilote gère le réglage de la fréquence de la porteuse en utilisant
LIRC_SET_REC_CARRIER. N’importe quel périphérique lirc depuis que les pilotes ont
été intégrés dans Linux 2.6.36 peut avoir LIRC_CAN_SET_REC_CARRIER_RANGE déclaré si
la fonctionnalité LIRC_CAN_SET_REC_CARRIER est activée.
LIRC_CAN_SET_REC_CARRIER_RANGE
Le pilote gère LIRC_SET_REC_CARRIER_RANGE. La limite basse de la porteuse doit être
d’abord définie en utilisant l’ioctl LIRC_SET_REC_CARRIER_RANGE, avant d’utiliser
l’ioctl LIRC_SET_REC_CARRIER pour définir la limite supérieure.
LIRC_CAN_GET_REC_RESOLUTION
Le pilote gère LIRC_GET_REC_RESOLUTION.
LIRC_CAN_SET_REC_TIMEOUT
Le pilote gère LIRC_SET_REC_TIMEOUT.
LIRC_CAN_MEASURE_CARRIER
Le pilote gère la mesure de la fréquence de modulation en utilisant
LIRC_SET_MEASURE_CARRIER_MODE.
LIRC_CAN_USE_WIDEBAND_RECEIVER
Le pilote gère le mode d’apprentissage en utilisant LIRC_SET_WIDEBAND_RECEIVER.
LIRC_CAN_SEND_PULSE
Le pilote gère l’émission en utilisant LIRC_MODE_PULSE ou LIRC_MODE_SCANCODE
BOGUES
L’utilisation de ces périphériques nécessite le fichier source d’en-tête du noyau lirc.h.
Ce fichier n’était pas disponible avant Linux 4.6. Les utilisateurs de noyaux plus anciens
peuvent utiliser le fichier disponible dans ⟨http://www.lirc.org⟩.
VOIR AUSSI
ir-ctl(1), lircd(8), bpf(2)
⟨https://www.kernel.org/doc/html/latest/userspace-api/media/rc/lirc-dev.html⟩
TRADUCTION
La traduction française de cette page de manuel a été créée par Christophe Blaess
<https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry
Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>,
Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin
Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis
Barbier <barbier@debian.org>, David Prévot <david@tilapin.org> et Jean-Paul Guillonneau
<guillonneau.jeanpaul@free.fr>
Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General
Public License version 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ concernant les
conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un
message à ⟨debian-l10n-french@lists.debian.org⟩.