Documentation/linux_tv/media/v4l/lirc_dev_intro.rst

.. -*- coding: utf-8; mode: rst -*-

.. _lirc_dev_intro:

************
Introduction
************

The LIRC device interface is a bi-directional interface for transporting
raw IR data between userspace and kernelspace. Fundamentally, it is just
a chardev (/dev/lircX, for X = 0, 1, 2, ...), with a number of standard
struct file_operations defined on it. With respect to transporting raw
IR data to and fro, the essential fops are read, write and ioctl.

Example dmesg output upon a driver registering w/LIRC:

    $ dmesg |grep lirc_dev

    lirc_dev: IR Remote Control driver registered, major 248

    rc rc0: lirc_dev: driver ir-lirc-codec (mceusb) registered at minor
    = 0

What you should see for a chardev:

    $ ls -l /dev/lirc*

    crw-rw---- 1 root root 248, 0 Jul 2 22:20 /dev/lirc0


.. ------------------------------------------------------------------------------
.. This file was automatically converted from DocBook-XML with the dbxml
.. library (https://github.com/return42/sphkerneldoc). The origin XML comes
.. from the linux kernel, refer to:
..
.. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
.. ------------------------------------------------------------------------------