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 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_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 :

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.