summaryrefslogtreecommitdiffstats
path: root/Documentation/linux_tv/media/v4l/lirc_dev_intro.rst
diff options
context:
space:
mode:
Diffstat (limited to 'Documentation/linux_tv/media/v4l/lirc_dev_intro.rst')
-rw-r--r--Documentation/linux_tv/media/v4l/lirc_dev_intro.rst37
1 files changed, 37 insertions, 0 deletions
diff --git a/Documentation/linux_tv/media/v4l/lirc_dev_intro.rst b/Documentation/linux_tv/media/v4l/lirc_dev_intro.rst
new file mode 100644
index 000000000000..10d4d9a96b15
--- /dev/null
+++ b/Documentation/linux_tv/media/v4l/lirc_dev_intro.rst
@@ -0,0 +1,37 @@
+.. -*- 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
+.. ------------------------------------------------------------------------------