Media subsystem kernel internal API

Copyright © 2009-2016 : LinuxTV Developers

This documentation is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

For more details see the file COPYING in the source distribution of Linux.

Table of Contents

• 1. Video4Linux devices
  • 1.1. Introduction
  • 1.2. Structure of a V4L driver
  • 1.3. Structure of the V4L2 framework
  • 1.4. Video device’ s internal representation
    • 1.4.1. ioctls and locking
    • 1.4.2. Video device registration
    • 1.4.3. video device debugging
    • 1.4.4. Video device cleanup
    • 1.4.5. helper functions
    • 1.4.6. video_device functions and data structures
  • 1.5. V4L2 device instance
    • 1.5.1. v4l2_device functions and data structures
  • 1.6. V4L2 File handlers
    • 1.6.1. V4L2 fh functions and data structures
  • 1.7. V4L2 sub-devices
  • 1.8. V4L2 sub-device userspace API
  • 1.9. I2C sub-device drivers
  • 1.10. V4L2 sub-device functions and data structures
  • 1.11. V4L2 events
    • 1.11.1. Event subscription
    • 1.11.2. Unsubscribing an event
    • 1.11.3. Check if there’s a pending event
    • 1.11.4. How events work
      • 1.11.4.1. V4L2 event functions and data structures
  • 1.12. V4L2 Controls
    • 1.12.1. Introduction
    • 1.12.2. Objects in the framework
    • 1.12.3. Basic usage for V4L2 and sub-device drivers
    • 1.12.4. Inheriting Controls
    • 1.12.5. Accessing Control Values
    • 1.12.6. Menu Controls
    • 1.12.7. Custom Controls
    • 1.12.8. Active and Grabbed Controls
    • 1.12.9. Control Clusters
    • 1.12.10. Handling autogain/gain-type Controls with Auto Clusters
    • 1.12.11. VIDIOC_LOG_STATUS Support
    • 1.12.12. Different Handlers for Different Video Nodes
    • 1.12.13. Finding Controls
    • 1.12.14. Inheriting Controls
    • 1.12.15. V4L2_CTRL_TYPE_CTRL_CLASS Controls
    • 1.12.16. Adding Notify Callbacks
    • 1.12.17. v4l2_ctrl functions and data structures
  • 1.13. Videobuf Framework
    • 1.13.1. Introduction
    • 1.13.2. Buffer types
    • 1.13.3. Data structures, callbacks, and initialization
    • 1.13.4. File operations
    • 1.13.5. ioctl() operations
    • 1.13.6. Buffer allocation
    • 1.13.7. Filling the buffers
  • 1.14. V4L2 videobuf2 functions and data structures
  • 1.15. V4L2 clocks
  • 1.16. V4L2 DV Timings functions
  • 1.17. V4L2 flash functions and data structures
  • 1.18. V4L2 Media Controller functions and data structures
  • 1.19. V4L2 Media Bus functions and data structures
  • 1.20. V4L2 Memory to Memory functions and data structures
  • 1.21. V4L2 fwnode kAPI
  • 1.22. V4L2 rect helper functions
  • 1.23. Tuner functions and data structures
  • 1.24. V4L2 common functions and data structures
  • 1.25. Hauppauge TV EEPROM functions and data structures
• 2. Digital TV (DVB) devices
• 3. Digital TV Common functions
• 4. Digital TV Ring buffer
• 5. Digital TV Frontend kABI
  • 5.1. Digital TV Frontend
    • 5.1.1. Demodulator driver
    • 5.1.2. Attaching frontend driver to the bridge driver
  • 5.2. Digital TV Frontend statistics
    • 5.2.1. Introduction
    • 5.2.2. Groups of statistics
    • 5.2.3. Statistics collect
      • 5.2.3.1. if the driver have a bit that indicates when a collected data is ready
      • 5.2.3.2. If the driver doesn’t provide a statistics available check bit
  • 5.3. Digital TV Frontend functions and types
• 6. Digital TV Demux kABI
  • 6.1. Digital TV Demux
• 7. Demux Callback API
  • 7.1. Demux Callback
• 8. Digital TV Conditional Access kABI
• 9. Remote Controller devices
  • 9.1. Remote Controller core
  • 9.2. LIRC
• 10. Media Controller devices
  • 10.1. Media Controller
    • 10.1.1. Abstract media device model
    • 10.1.2. Media device
    • 10.1.3. Entities
    • 10.1.4. Interfaces
    • 10.1.5. Pads
    • 10.1.6. Links
    • 10.1.7. Graph traversal
    • 10.1.8. Use count and power handling
    • 10.1.9. Links setup
    • 10.1.10. Pipelines and media streams
    • 10.1.11. Link validation
• 11. CEC Kernel Support
  • 11.1. The CEC Protocol
  • 11.2. CEC Adapter Interface
  • 11.3. Implementing the Low-Level CEC Adapter
  • 11.4. Implementing the interrupt handler
  • 11.5. Implementing the High-Level CEC Adapter
  • 11.6. CEC framework functions
  • 11.7. CEC Pin framework
  • 11.8. CEC Notifier framework
• 12. MIPI CSI-2
  • 12.1. Transmitter drivers
    • 12.1.1. Stopping the transmitter
  • 12.2. Receiver drivers