Copyright © 1991-: LinuxTV Developers

Linux Kernel Media Documentation

• Linux Media Infrastructure userspace API
  • Introduction
  • Part I - Video for Linux API
    • 1. Common API Elements
      • 1.1. Opening and Closing Devices
      • 1.2. Querying Capabilities
      • 1.3. Application Priority
      • 1.4. Video Inputs and Outputs
      • 1.5. Audio Inputs and Outputs
      • 1.6. Tuners and Modulators
      • 1.7. Video Standards
      • 1.8. Digital Video (DV) Timings
      • 1.9. User Controls
      • 1.10. Extended Controls API
      • 1.11. Camera Control Reference
      • 1.12. Flash Control Reference
      • 1.13. Image Source Control Reference
      • 1.14. Image Process Control Reference
      • 1.15. Codec Control Reference
      • 1.16. Stateless Codec Control Reference
      • 1.17. JPEG Control Reference
      • 1.18. Digital Video Control Reference
      • 1.19. RF Tuner Control Reference
      • 1.20. FM Transmitter Control Reference
      • 1.21. FM Receiver Control Reference
      • 1.22. Detect Control Reference
      • 1.23. Colorimetry Control Reference
      • 1.24. Guidelines for Video4Linux pixel format 4CCs
      • 1.25. Data Formats
      • 1.26. Single- and multi-planar APIs
      • 1.27. Cropping, composing and scaling -- the SELECTION API
      • 1.28. Image Cropping, Insertion and Scaling -- the CROP API
      • 1.29. Streaming Parameters
    • 2. Image Formats
      • 2.1. Single-planar format structure
      • 2.2. Multi-planar format structures
      • 2.3. Standard Image Formats
      • 2.4. Indexed Format
      • 2.5. RGB Formats
      • 2.6. Raw Bayer Formats
      • 2.7. YUV Formats
      • 2.8. HSV Formats
      • 2.9. Depth Formats
      • 2.10. Compressed Formats
      • 2.11. SDR Formats
      • 2.12. Touch Formats
      • 2.13. Metadata Formats
      • 2.14. Reserved Format Identifiers
      • 2.15. Colorspaces
      • 2.16. Defining Colorspaces in V4L2
      • 2.17. Detailed Colorspace Descriptions
      • 2.18. Detailed Transfer Function Descriptions
    • 3. Input/Output
      • 3.1. Read/Write
      • 3.2. Streaming I/O (Memory Mapping)
      • 3.3. Streaming I/O (User Pointers)
      • 3.4. Streaming I/O (DMA buffer importing)
      • 3.5. Buffers
      • 3.6. Field Order
    • 4. Interfaces
      • 4.1. Video Capture Interface
      • 4.2. Video Overlay Interface
      • 4.3. Video Output Interface
      • 4.4. Video Output Overlay Interface
      • 4.5. Video Memory-To-Memory Interface
      • 4.6. Raw VBI Data Interface
      • 4.7. Sliced VBI Data Interface
      • 4.8. Radio Interface
      • 4.9. RDS Interface
      • 4.10. Software Defined Radio Interface (SDR)
      • 4.11. Touch Devices
      • 4.12. Event Interface
      • 4.13. Sub-device Interface
      • 4.14. Metadata Interface
    • 5. Libv4l Userspace Library
      • 5.1. Introduction
    • 6. Changes
      • 6.1. Differences between V4L and V4L2
      • 6.2. Changes of the V4L2 API
    • 7. Function Reference
      • 7.1. V4L2 close()
      • 7.2. V4L2 ioctl()
      • 7.3. ioctl VIDIOC_CREATE_BUFS
      • 7.4. ioctl VIDIOC_CROPCAP
      • 7.5. ioctl VIDIOC_DBG_G_CHIP_INFO
      • 7.6. ioctl VIDIOC_DBG_G_REGISTER, VIDIOC_DBG_S_REGISTER
      • 7.7. ioctl VIDIOC_DECODER_CMD, VIDIOC_TRY_DECODER_CMD
      • 7.8. ioctl VIDIOC_DQEVENT
      • 7.9. ioctl VIDIOC_DV_TIMINGS_CAP, VIDIOC_SUBDEV_DV_TIMINGS_CAP
      • 7.10. ioctl VIDIOC_ENCODER_CMD, VIDIOC_TRY_ENCODER_CMD
      • 7.11. ioctl VIDIOC_ENUMAUDIO
      • 7.12. ioctl VIDIOC_ENUMAUDOUT
      • 7.13. ioctl VIDIOC_ENUM_DV_TIMINGS, VIDIOC_SUBDEV_ENUM_DV_TIMINGS
      • 7.14. ioctl VIDIOC_ENUM_FMT
      • 7.15. ioctl VIDIOC_ENUM_FRAMESIZES
      • 7.16. ioctl VIDIOC_ENUM_FRAMEINTERVALS
      • 7.17. ioctl VIDIOC_ENUM_FREQ_BANDS
      • 7.18. ioctl VIDIOC_ENUMINPUT
      • 7.19. ioctl VIDIOC_ENUMOUTPUT
      • 7.20. ioctl VIDIOC_ENUMSTD, VIDIOC_SUBDEV_ENUMSTD
      • 7.21. ioctl VIDIOC_EXPBUF
      • 7.22. ioctl VIDIOC_G_AUDIO, VIDIOC_S_AUDIO
      • 7.23. ioctl VIDIOC_G_AUDOUT, VIDIOC_S_AUDOUT
      • 7.24. ioctl VIDIOC_G_CROP, VIDIOC_S_CROP
      • 7.25. ioctl VIDIOC_G_CTRL, VIDIOC_S_CTRL
      • 7.26. ioctl VIDIOC_G_DV_TIMINGS, VIDIOC_S_DV_TIMINGS
      • 7.27. ioctl VIDIOC_G_EDID, VIDIOC_S_EDID, VIDIOC_SUBDEV_G_EDID, VIDIOC_SUBDEV_S_EDID
      • 7.28. ioctl VIDIOC_G_ENC_INDEX
      • 7.29. ioctl VIDIOC_G_EXT_CTRLS, VIDIOC_S_EXT_CTRLS, VIDIOC_TRY_EXT_CTRLS
      • 7.30. ioctl VIDIOC_G_FBUF, VIDIOC_S_FBUF
      • 7.31. ioctl VIDIOC_G_FMT, VIDIOC_S_FMT, VIDIOC_TRY_FMT
      • 7.32. ioctl VIDIOC_G_FREQUENCY, VIDIOC_S_FREQUENCY
      • 7.33. ioctl VIDIOC_G_INPUT, VIDIOC_S_INPUT
      • 7.34. ioctl VIDIOC_G_JPEGCOMP, VIDIOC_S_JPEGCOMP
      • 7.35. ioctl VIDIOC_G_MODULATOR, VIDIOC_S_MODULATOR
      • 7.36. ioctl VIDIOC_G_OUTPUT, VIDIOC_S_OUTPUT
      • 7.37. ioctl VIDIOC_G_PARM, VIDIOC_S_PARM
      • 7.38. ioctl VIDIOC_G_PRIORITY, VIDIOC_S_PRIORITY
      • 7.39. ioctl VIDIOC_G_SELECTION, VIDIOC_S_SELECTION
      • 7.40. ioctl VIDIOC_G_SLICED_VBI_CAP
      • 7.41. ioctl VIDIOC_G_STD, VIDIOC_S_STD, VIDIOC_SUBDEV_G_STD, VIDIOC_SUBDEV_S_STD
      • 7.42. ioctl VIDIOC_G_TUNER, VIDIOC_S_TUNER
      • 7.43. ioctl VIDIOC_LOG_STATUS
      • 7.44. ioctl VIDIOC_OVERLAY
      • 7.45. ioctl VIDIOC_PREPARE_BUF
      • 7.46. ioctl VIDIOC_QBUF, VIDIOC_DQBUF
      • 7.47. ioctl VIDIOC_QUERYBUF
      • 7.48. ioctl VIDIOC_QUERYCAP
      • 7.49. ioctls VIDIOC_QUERYCTRL, VIDIOC_QUERY_EXT_CTRL and VIDIOC_QUERYMENU
      • 7.50. ioctl VIDIOC_QUERY_DV_TIMINGS
      • 7.51. ioctl VIDIOC_QUERYSTD, VIDIOC_SUBDEV_QUERYSTD
      • 7.52. ioctl VIDIOC_REQBUFS
      • 7.53. ioctl VIDIOC_REMOVE_BUFS
      • 7.54. ioctl VIDIOC_S_HW_FREQ_SEEK
      • 7.55. ioctl VIDIOC_STREAMON, VIDIOC_STREAMOFF
      • 7.56. ioctl VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL
      • 7.57. ioctl VIDIOC_SUBDEV_ENUM_FRAME_SIZE
      • 7.58. ioctl VIDIOC_SUBDEV_ENUM_MBUS_CODE
      • 7.59. ioctl VIDIOC_SUBDEV_G_CROP, VIDIOC_SUBDEV_S_CROP
      • 7.60. ioctl VIDIOC_SUBDEV_G_FMT, VIDIOC_SUBDEV_S_FMT
      • 7.61. ioctl VIDIOC_SUBDEV_G_FRAME_INTERVAL, VIDIOC_SUBDEV_S_FRAME_INTERVAL
      • 7.62. ioctl VIDIOC_SUBDEV_G_ROUTING, VIDIOC_SUBDEV_S_ROUTING
      • 7.63. ioctl VIDIOC_SUBDEV_G_SELECTION, VIDIOC_SUBDEV_S_SELECTION
      • 7.64. ioctl VIDIOC_SUBDEV_G_CLIENT_CAP, VIDIOC_SUBDEV_S_CLIENT_CAP
      • 7.65. ioctl VIDIOC_SUBDEV_QUERYCAP
      • 7.66. ioctl VIDIOC_SUBSCRIBE_EVENT, VIDIOC_UNSUBSCRIBE_EVENT
      • 7.67. V4L2 mmap()
      • 7.68. V4L2 munmap()
      • 7.69. V4L2 open()
      • 7.70. V4L2 poll()
      • 7.71. V4L2 read()
      • 7.72. V4L2 select()
      • 7.73. V4L2 write()
    • 8. Common definitions for V4L2 and V4L2 subdev interfaces
      • 8.1. Common selection definitions
    • 9. Video For Linux Two Header File
      • 9.1. videodev2.h
    • 10. Video Capture Example
      • 10.1. file: media/v4l/capture.c
    • 11. Video Grabber example using libv4l
      • 11.1. file: media/v4l/v4l2grab.c
    • 12. References
      • 12.1. CEA 608-E
      • 12.2. EN 300 294
      • 12.3. ETS 300 231
      • 12.4. ETS 300 706
      • 12.5. ISO 13818-1
      • 12.6. ISO 13818-2
      • 12.7. ITU BT.470
      • 12.8. ITU BT.601
      • 12.9. ITU BT.653
      • 12.10. ITU BT.709
      • 12.11. ITU BT.1119
      • 12.12. ITU-T Rec. H.264 Specification (04/2017 Edition)
      • 12.13. ITU H.265/HEVC
      • 12.14. JFIF
      • 12.15. ITU-T.81
      • 12.16. W3C JPEG JFIF
      • 12.17. SMPTE 12M
      • 12.18. SMPTE 170M
      • 12.19. SMPTE 240M
      • 12.20. SMPTE RP 431-2
      • 12.21. SMPTE ST 2084
      • 12.22. sRGB
      • 12.23. sYCC
      • 12.24. xvYCC
      • 12.25. opRGB
      • 12.26. ITU BT.2020
      • 12.27. EBU Tech 3213
      • 12.28. EBU Tech 3321
      • 12.29. IEC 62106
      • 12.30. NRSC-4-B
      • 12.31. ISO 12232:2006
      • 12.32. CEA-861-E
      • 12.33. VESA DMT
      • 12.34. EDID
      • 12.35. HDCP
      • 12.36. HDMI
      • 12.37. HDMI2
      • 12.38. DP
      • 12.39. poynton
      • 12.40. colimg
      • 12.41. VP8
      • 12.42. VP9
      • 12.43. AV1
    • Revision and Copyright
    • Revision History
  • Part II - Digital TV API
    • 1. Introduction
      • 1.1. What you need to know
      • 1.2. History
      • 1.3. Overview
      • 1.4. Linux Digital TV Devices
      • 1.5. API include files
    • 2. Digital TV Frontend API
      • 2.1. Querying frontend information
      • 2.2. Querying frontend status and statistics
      • 2.3. Property types
      • 2.4. Frontend Function Calls
    • 3. Digital TV Demux Device
      • 3.1. Demux Data Types
      • 3.2. Demux Function Calls
    • 4. Digital TV CA Device
      • 4.1. CA Data Types
      • 4.2. CA Function Calls
      • 4.3. The High level CI API
    • 5. Digital TV Network API
      • 5.1. Digital TV net Function Calls
    • 6. Digital TV Deprecated APIs
      • 6.1. Digital TV Frontend legacy API (a. k. a. DVBv3)
      • 6.2. Legacy DVB MPEG Decoder APIs
    • 7. Examples
    • 8. Digital TV uAPI header files
      • 8.1. Digital TV uAPI headers
    • Revision and Copyright
    • Revision History
  • Part III - Remote Controller API
    • 1. Introduction
    • 2. Remote Controller’s sysfs nodes
      • 2.1. /sys/class/rc/
      • 2.2. /sys/class/rc/rcN/
      • 2.3. /sys/class/rc/rcN/protocols
      • 2.4. /sys/class/rc/rcN/filter
      • 2.5. /sys/class/rc/rcN/filter_mask
      • 2.6. /sys/class/rc/rcN/wakeup_protocols
      • 2.7. /sys/class/rc/rcN/wakeup_filter
      • 2.8. /sys/class/rc/rcN/wakeup_filter_mask
    • 3. Remote Controller Protocols and Scancodes
      • 3.1. rc-5 (RC_PROTO_RC5)
      • 3.2. rc-5-sz (RC_PROTO_RC5_SZ)
      • 3.3. rc-5x-20 (RC_PROTO_RC5X_20)
      • 3.4. jvc (RC_PROTO_JVC)
      • 3.5. sony-12 (RC_PROTO_SONY12)
      • 3.6. sony-15 (RC_PROTO_SONY15)
      • 3.7. sony-20 (RC_PROTO_SONY20)
      • 3.8. nec (RC_PROTO_NEC)
      • 3.9. nec-x (RC_PROTO_NECX)
      • 3.10. nec-32 (RC_PROTO_NEC32)
      • 3.11. sanyo (RC_PROTO_SANYO)
      • 3.12. mcir2-kbd (RC_PROTO_MCIR2_KBD)
      • 3.13. mcir2-mse (RC_PROTO_MCIR2_MSE)
      • 3.14. rc-6-0 (RC_PROTO_RC6_0)
      • 3.15. rc-6-6a-20 (RC_PROTO_RC6_6A_20)
      • 3.16. rc-6-6a-24 (RC_PROTO_RC6_6A_24)
      • 3.17. rc-6-6a-32 (RC_PROTO_RC6_6A_32)
      • 3.18. rc-6-mce (RC_PROTO_RC6_MCE)
      • 3.19. sharp (RC_PROTO_SHARP)
      • 3.20. xmp (RC_PROTO_XMP)
      • 3.21. cec (RC_PROTO_CEC)
      • 3.22. imon (RC_PROTO_IMON)
      • 3.23. rc-mm-12 (RC_PROTO_RCMM12)
      • 3.24. rc-mm-24 (RC_PROTO_RCMM24)
      • 3.25. rc-mm-32 (RC_PROTO_RCMM32)
      • 3.26. xbox-dvd (RC_PROTO_XBOX_DVD)
    • 4. Remote controller tables
    • 5. Changing default Remote Controller mappings
      • 5.1. file: uapi/v4l/keytable.c
    • 6. LIRC Device Interface
      • 6.1. Introduction
      • 6.2. LIRC modes
      • 6.3. Data types used by LIRC_MODE_SCANCODE
      • 6.4. BPF based IR decoder
      • 6.5. LIRC Function Reference
      • 6.6. LIRC Header File
    • Revision and Copyright
    • Revision History
  • Part IV - Media Controller API
    • 1. Introduction
    • 2. Media device model
    • 3. Types and flags used to represent the media graph elements
    • 4. Request API
      • 4.1. General Usage
      • 4.2. Request Allocation
      • 4.3. Request Preparation
      • 4.4. Request Submission
      • 4.5. Recycling and Destruction
      • 4.6. Example for a Codec Device
      • 4.7. Example for a Simple Capture Device
    • 5. Function Reference
      • 5.1. media open()
      • 5.2. media close()
      • 5.3. media ioctl()
      • 5.4. ioctl MEDIA_IOC_DEVICE_INFO
      • 5.5. ioctl MEDIA_IOC_G_TOPOLOGY
      • 5.6. ioctl MEDIA_IOC_ENUM_ENTITIES
      • 5.7. ioctl MEDIA_IOC_ENUM_LINKS
      • 5.8. ioctl MEDIA_IOC_SETUP_LINK
      • 5.9. ioctl MEDIA_IOC_REQUEST_ALLOC
      • 5.10. request close()
      • 5.11. request ioctl()
      • 5.12. request poll()
      • 5.13. ioctl MEDIA_REQUEST_IOC_QUEUE
      • 5.14. ioctl MEDIA_REQUEST_IOC_REINIT
    • 6. Media Controller Header File
      • 6.1. media.h
    • Revision and Copyright
    • Revision History
  • Part V - Consumer Electronics Control API
    • 1. Introduction
    • 2. Function Reference
      • 2.1. cec open()
      • 2.2. cec close()
      • 2.3. cec ioctl()
      • 2.4. cec poll()
      • 2.5. ioctl CEC_ADAP_G_CAPS
      • 2.6. ioctls CEC_ADAP_G_LOG_ADDRS and CEC_ADAP_S_LOG_ADDRS
      • 2.7. ioctls CEC_ADAP_G_PHYS_ADDR and CEC_ADAP_S_PHYS_ADDR
      • 2.8. ioctl CEC_ADAP_G_CONNECTOR_INFO
      • 2.9. ioctl CEC_DQEVENT
      • 2.10. ioctls CEC_G_MODE and CEC_S_MODE
      • 2.11. ioctls CEC_RECEIVE and CEC_TRANSMIT
    • 3. CEC Pin Framework Error Injection
      • 3.1. Basic Syntax
      • 3.2. Clear Error Injections
      • 3.3. Receive Messages
      • 3.4. Transmit Messages
      • 3.5. Custom Pulses
    • 4. CEC Header File
      • 4.1. cec.h
    • Revision and Copyright
    • Revision History
  • Generic Error Codes
  • Glossary
  • GNU Free Documentation License
    • 0. PREAMBLE
    • 1. APPLICABILITY AND DEFINITIONS
    • 2. VERBATIM COPYING
    • 3. COPYING IN QUANTITY
    • 4. MODIFICATIONS
    • 5. COMBINING DOCUMENTS
    • 6. COLLECTIONS OF DOCUMENTS
    • 7. AGGREGATION WITH INDEPENDENT WORKS
    • 8. TRANSLATION
    • 9. TERMINATION
    • 10. FUTURE REVISIONS OF THIS LICENSE
    • Addendum
  • Video4Linux (V4L) driver-specific documentation
    • 1. ASPEED video driver
      • 1.1. V4L2_CID_ASPEED_HQ_MODE
      • 1.2. V4L2_CID_ASPEED_HQ_JPEG_QUALITY
    • 2. Using camera sensor drivers
      • 2.1. Frame size
      • 2.2. Frame interval configuration
      • 2.3. Rotation, orientation and flipping
    • 3. MIPI CCS camera sensor driver
      • 3.1. Pixel Array sub-device
      • 3.2. Binner
      • 3.3. Scaler
      • 3.4. Digital and analogue crop
      • 3.5. Private controls
    • 4. The cx2341x driver
      • 4.1. Non-compressed file format
      • 4.2. Format of embedded V4L2_MPEG_STREAM_VBI_FMT_IVTV VBI data
    • 5. DW100 dewarp driver
    • 6. i.MX Video Capture Driver
      • 6.1. Events
      • 6.2. Controls
    • 7. Maxim Integrated MAX2175 RF to bits tuner driver
      • 7.1. V4L2_CID_MAX2175_I2S_ENABLE
      • 7.2. V4L2_CID_MAX2175_HSLS
      • 7.3. V4L2_CID_MAX2175_RX_MODE (menu)
    • 8. NPCM video driver
      • 8.1. Driver-specific Controls
      • 8.2. References
    • 9. OMAP 3 Image Signal Processor (ISP) driver
      • 9.1. Events
      • 9.2. Private IOCTLs
      • 9.3. CCDC and preview block IOCTLs
      • 9.4. Statistic blocks IOCTLs
      • 9.5. VIDIOC_OMAP3ISP_STAT_EN
      • 9.6. VIDIOC_OMAP3ISP_AEWB_CFG, VIDIOC_OMAP3ISP_HIST_CFG and VIDIOC_OMAP3ISP_AF_CFG
      • 9.7. VIDIOC_OMAP3ISP_STAT_REQ
      • 9.8. References
    • 10. THine THP7312 ISP driver
    • 11. The Linux USB Video Class (UVC) driver
      • 11.1. Extension Unit (XU) support
    • 12. ST VGXY61 camera sensor driver
      • 12.1. V4L2_CID_HDR_SENSOR_MODE
• Media subsystem kernel internal API
  • 1. Media Subsystem Profile
    • 1.1. Overview
      • 1.1.1. Media maintainers
    • 1.2. Submit Checklist Addendum
      • 1.2.1. Style Cleanup Patches
      • 1.2.2. Coding Style Addendum
    • 1.3. Key Cycle Dates
    • 1.4. Review Cadence
  • 2. Video4Linux devices
    • 2.1. Introduction
    • 2.2. Structure of a V4L driver
    • 2.3. Structure of the V4L2 framework
    • 2.4. Video device’ s internal representation
      • 2.4.1. ioctls and locking
      • 2.4.2. Video device registration
      • 2.4.3. video device debugging
      • 2.4.4. Video device cleanup
      • 2.4.5. helper functions
      • 2.4.6. video_device functions and data structures
    • 2.5. V4L2 device instance
      • 2.5.1. v4l2_device functions and data structures
    • 2.6. V4L2 File handlers
      • 2.6.1. V4L2 fh functions and data structures
    • 2.7. V4L2 sub-devices
      • 2.7.1. Subdev registration
      • 2.7.2. Calling subdev operations
    • 2.8. V4L2 sub-device userspace API
    • 2.9. Read-only sub-device userspace API
    • 2.10. I2C sub-device drivers
    • 2.11. Centrally managed subdev active state
    • 2.12. Streams, multiplexed media pads and internal routing
    • 2.13. V4L2 sub-device functions and data structures
    • 2.14. V4L2 events
      • 2.14.1. Event subscription
      • 2.14.2. Unsubscribing an event
      • 2.14.3. Check if there’s a pending event
      • 2.14.4. How events work
    • 2.15. V4L2 Controls
      • 2.15.1. Introduction
      • 2.15.2. Objects in the framework
      • 2.15.3. Basic usage for V4L2 and sub-device drivers
      • 2.15.4. Inheriting Sub-device Controls
      • 2.15.5. Accessing Control Values
      • 2.15.6. Menu Controls
      • 2.15.7. Custom Controls
      • 2.15.8. Active and Grabbed Controls
      • 2.15.9. Control Clusters
      • 2.15.10. Handling autogain/gain-type Controls with Auto Clusters
      • 2.15.11. VIDIOC_LOG_STATUS Support
      • 2.15.12. Different Handlers for Different Video Nodes
      • 2.15.13. Finding Controls
      • 2.15.14. Preventing Controls inheritance
      • 2.15.15. V4L2_CTRL_TYPE_CTRL_CLASS Controls
      • 2.15.16. Adding Notify Callbacks
      • 2.15.17. v4l2_ctrl functions and data structures
    • 2.16. V4L2 videobuf2 functions and data structures
    • 2.17. V4L2 DV Timings functions
    • 2.18. V4L2 flash functions and data structures
    • 2.19. V4L2 Media Controller functions and data structures
    • 2.20. V4L2 Media Bus functions and data structures
    • 2.21. V4L2 Memory to Memory functions and data structures
    • 2.22. V4L2 async kAPI
    • 2.23. V4L2 fwnode kAPI
    • 2.24. V4L2 CCI kAPI
    • 2.25. V4L2 rect helper functions
    • 2.26. Tuner functions and data structures
    • 2.27. V4L2 common functions and data structures
    • 2.28. Hauppauge TV EEPROM functions and data structures
    • 2.29. V4L2 JPEG header related functions and data structures
  • 3. Digital TV (DVB) devices
    • 3.1. Digital TV Common functions
      • 3.1.1. DVB devices
      • 3.1.2. Digital TV Ring buffer
      • 3.1.3. Digital TV VB2 handler
    • 3.2. Digital TV Frontend kABI
      • 3.2.1. Digital TV Frontend
      • 3.2.2. Digital TV Frontend statistics
      • 3.2.3. Digital TV Frontend functions and types
    • 3.3. Digital TV Demux kABI
      • 3.3.1. Digital TV Demux
      • 3.3.2. Demux Callback API
      • 3.3.3. Digital TV Demux device registration functions and data structures
      • 3.3.4. High-level Digital TV demux interface
      • 3.3.5. Driver-internal low-level hardware specific driver demux interface
    • 3.4. Digital TV Conditional Access kABI
    • 3.5. Digital TV Network kABI
  • 4. Remote Controller devices
    • 4.1. Remote Controller core
      • 4.1.1. Remote controller data structures and functions
  • 5. Media Controller devices
    • 5.1. Media Controller
      • 5.1.1. Abstract media device model
      • 5.1.2. Media device
      • 5.1.3. Entities
      • 5.1.4. Interfaces
      • 5.1.5. Pads
      • 5.1.6. Links
      • 5.1.7. Graph traversal
      • 5.1.8. Use count and power handling
      • 5.1.9. Links setup
      • 5.1.10. Pipelines and media streams
      • 5.1.11. Link validation
      • 5.1.12. Pipeline traversal
      • 5.1.13. Media Controller Device Allocator API
      • 5.1.14. API Definitions
  • 6. CEC Kernel Support
    • 6.1. The CEC Protocol
    • 6.2. CEC Adapter Interface
    • 6.3. Implementing the Low-Level CEC Adapter
    • 6.4. Implementing the interrupt handler
    • 6.5. Optional: Implementing Error Injection Support
    • 6.6. Implementing the High-Level CEC Adapter
    • 6.7. CEC framework functions
    • 6.8. CEC Pin framework
    • 6.9. CEC Notifier framework
  • 7. Pixel data transmitter and receiver drivers
    • 7.1. Bus types
      • 7.1.1. MIPI CSI-2
      • 7.1.2. Parallel and BT.656
    • 7.2. Transmitter drivers
      • 7.2.1. Media bus pixel code
      • 7.2.2. Link frequency
      • 7.2.3. .s_stream() callback
    • 7.3. CSI-2 transmitter drivers
      • 7.3.1. Pixel rate
      • 7.3.2. LP-11 and LP-111 states
      • 7.3.3. Stopping the transmitter
  • 8. Writing camera sensor drivers
    • 8.1. CSI-2, parallel and BT.656 buses
    • 8.2. Handling clocks
      • 8.2.1. ACPI
      • 8.2.2. Devicetree
    • 8.3. Power management
      • 8.3.1. Control framework
    • 8.4. Rotation, orientation and flipping
    • 8.5. Example drivers
  • 9. Media driver-specific documentation
    • 9.1. Video4Linux (V4L) drivers
      • 9.1.1. The bttv driver
      • 9.1.2. The cx2341x driver
      • 9.1.3. The cx88 driver
      • 9.1.4. The Samsung S5P/EXYNOS4 FIMC driver
      • 9.1.5. The pvrusb2 driver
      • 9.1.6. PXA-Camera Host Driver
      • 9.1.7. The Radiotrack radio driver
      • 9.1.8. The Rockchip Image Signal Processor Driver (rkisp1)
      • 9.1.9. The saa7134 driver
      • 9.1.10. Cropping and Scaling algorithm, used in the sh_mobile_ceu_camera driver
      • 9.1.11. Tuner drivers
      • 9.1.12. The Virtual Media Controller Driver (vimc)
      • 9.1.13. The Zoran driver
      • 9.1.14. MIPI CCS camera sensor driver
      • 9.1.15. CCS PLL calculator
      • 9.1.16. Intel IPU6 Driver
    • 9.2. Digital TV drivers
      • 9.2.1. Idea behind the dvb-usb-framework
      • 9.2.2. Frontend drivers
      • 9.2.3. vidtv: Virtual Digital TV driver
      • 9.2.4. Contributors
• Media subsystem admin and user guide
  • 1. Introduction
  • 2. Building support for a media device
    • 2.1. Configuring the Linux Kernel
      • 2.1.1. Media dependencies
      • 2.1.2. Enabling Remote Controller Support
      • 2.1.3. Enabling HDMI CEC Support
      • 2.1.4. Enabling Media Support
      • 2.1.5. Example
    • 2.2. Building and installing a new Kernel
    • 2.3. Building just the new media drivers and core
  • 3. Infrared remote control support in video4linux drivers
    • 3.1. Basics
    • 3.2. How it works
      • 3.2.1. Using with lircd
      • 3.2.2. Using without lircd
  • 4. HDMI CEC
    • 4.1. Supported hardware in mainline
    • 4.2. Utilities
    • 4.3. DisplayPort to HDMI Adapters with working CEC
      • 4.3.1. USB-C to HDMI
      • 4.3.2. DisplayPort to HDMI
      • 4.3.3. Mini-DisplayPort to HDMI
    • 4.4. USB CEC Dongles
    • 4.5. CEC Without HPD
    • 4.6. Microcontrollers & CEC
    • 4.7. Making a CEC debugger
  • 5. Digital TV
    • 5.1. Using the Digital TV Framework
      • 5.1.1. Introduction
      • 5.1.2. Getting the card going
      • 5.1.3. Receiving a digital TV channel
    • 5.2. Digital TV Conditional Access Interface
      • 5.2.1. ca_zap
      • 5.2.2. Cards that fall in this category
      • 5.2.3. CI modules that are supported
    • 5.3. FAQ
    • 5.4. References
  • 6. Cards List
    • 6.1. USB drivers
      • 6.1.1. AU0828 cards list
      • 6.1.2. cx231xx cards list
      • 6.1.3. EM28xx cards list
      • 6.1.4. Siano cards list
      • 6.1.5. The gspca cards list
      • 6.1.6. dvb-usb-dib0700 cards list
      • 6.1.7. dvb-usb-dibusb-mb cards list
      • 6.1.8. dvb-usb-dibusb-mc cards list
      • 6.1.9. dvb-usb-a800 cards list
      • 6.1.10. dvb-usb-af9005 cards list
      • 6.1.11. dvb-usb-az6027 cards list
      • 6.1.12. dvb-usb-cinergyT2 cards list
      • 6.1.13. dvb-usb-cxusb cards list
      • 6.1.14. dvb-usb-digitv cards list
      • 6.1.15. dvb-usb-dtt200u cards list
      • 6.1.16. dvb-usb-dtv5100 cards list
      • 6.1.17. dvb-usb-dw2102 cards list
      • 6.1.18. dvb-usb-gp8psk cards list
      • 6.1.19. dvb-usb-m920x cards list
      • 6.1.20. dvb-usb-nova-t-usb2 cards list
      • 6.1.21. dvb-usb-opera1 cards list
      • 6.1.22. dvb-usb-pctv452e cards list
      • 6.1.23. dvb-usb-technisat-usb2 cards list
      • 6.1.24. dvb-usb-ttusb2 cards list
      • 6.1.25. dvb-usb-umt-010 cards list
      • 6.1.26. dvb-usb-vp702x cards list
      • 6.1.27. dvb-usb-vp7045 cards list
      • 6.1.28. dvb-usb-af9015 cards list
      • 6.1.29. dvb-usb-af9035 cards list
      • 6.1.30. dvb-usb-anysee cards list
      • 6.1.31. dvb-usb-au6610 cards list
      • 6.1.32. dvb-usb-az6007 cards list
      • 6.1.33. dvb-usb-ce6230 cards list
      • 6.1.34. dvb-usb-dvbsky cards list
      • 6.1.35. dvb-usb-ec168 cards list
      • 6.1.36. dvb-usb-gl861 cards list
      • 6.1.37. dvb-usb-lmedm04 cards list
      • 6.1.38. dvb-usb-mxl111sf cards list
      • 6.1.39. dvb-usb-rtl28xxu cards list
      • 6.1.40. dvb-usb-zd1301 cards list
      • 6.1.41. Other USB cards list
    • 6.2. PCI drivers
      • 6.2.1. BTTV cards list
      • 6.2.2. CX18 cards list
      • 6.2.3. cx23885 cards list
      • 6.2.4. CX88 cards list
      • 6.2.5. IVTV cards list
      • 6.2.6. SAA7134 cards list
      • 6.2.7. SAA7164 cards list
      • 6.2.8. Zoran cards list
    • 6.3. Platform drivers
      • 6.3.1. MMC/SDIO DVB adapters
    • 6.4. Radio drivers
    • 6.5. I²C drivers
      • 6.5.1. Audio decoders, processors and mixers
      • 6.5.2. Audio/Video compression chips
      • 6.5.3. Camera sensor devices
      • 6.5.4. Flash devices
      • 6.5.5. IR I2C driver
      • 6.5.6. Lens drivers
      • 6.5.7. Miscellaneous helper chips
      • 6.5.8. RDS decoders
      • 6.5.9. SDR tuner chips
      • 6.5.10. Video and audio decoders
      • 6.5.11. Video decoders
      • 6.5.12. Video encoders
      • 6.5.13. Video improvement chips
      • 6.5.14. Tuner drivers
    • 6.6. Firewire driver
    • 6.7. Test drivers
  • 7. Video4Linux (V4L) driver-specific documentation
    • 7.1. The bttv driver
      • 7.1.1. Release notes for bttv
      • 7.1.2. Make bttv work with your card
      • 7.1.3. Autodetecting cards
      • 7.1.4. Still doesn’t work?
      • 7.1.5. Modprobe options
      • 7.1.6. If the box freezes hard with bttv
      • 7.1.7. Bttv quirks
      • 7.1.8. Cards
      • 7.1.9. Chips used at bttv devices
      • 7.1.10. Specs
      • 7.1.11. Thanks
      • 7.1.12. Contributors
    • 7.2. The cafe_ccic driver
      • 7.2.1. Introduction
      • 7.2.2. Load time options
    • 7.3. The cx88 driver
      • 7.3.1. Current status
      • 7.3.2. How to add support for new cards
    • 7.4. The Samsung S5P/Exynos4 FIMC driver
      • 7.4.1. Supported SoCs
      • 7.4.2. Supported features
      • 7.4.3. Not currently supported
      • 7.4.4. User space interfaces
      • 7.4.5. 5. Device mapping to video and subdev device nodes
      • 7.4.6. 7. Build
    • 7.5. i.MX Video Capture Driver
      • 7.5.1. Introduction
      • 7.5.2. Features
      • 7.5.3. Topology
      • 7.5.4. Entities
      • 7.5.5. imx6-mipi-csi2
      • 7.5.6. ipuX_csiY_mux
      • 7.5.7. ipuX_csiY
      • 7.5.8. Cropping in ipuX_csiY
      • 7.5.9. Frame Skipping in ipuX_csiY
      • 7.5.10. Frame Interval Monitor in ipuX_csiY
      • 7.5.11. ipuX_vdic
      • 7.5.12. ipuX_ic_prp
      • 7.5.13. ipuX_ic_prpenc
      • 7.5.14. ipuX_ic_prpvf
      • 7.5.15. Capture Pipelines
      • 7.5.16. Unprocessed Video Capture:
      • 7.5.17. IC Direct Conversions:
      • 7.5.18. Motion Compensated De-interlace:
      • 7.5.19. Usage Notes
      • 7.5.20. i.MX6Q SabreLite with OV5642 and OV5640
      • 7.5.21. i.MX6Q SabreAuto with ADV7180 decoder
      • 7.5.22. i.MX6DL SabreAuto with ADV7180 decoder
      • 7.5.23. i.MX6Q SabreSD with MIPI CSI-2 OV5640
      • 7.5.24. Known Issues
      • 7.5.25. File list
      • 7.5.26. References
      • 7.5.27. Authors
    • 7.6. i.MX7 Video Capture Driver
      • 7.6.1. Introduction
      • 7.6.2. Entities
      • 7.6.3. imx-mipi-csi2
      • 7.6.4. csi-mux
      • 7.6.5. csi
      • 7.6.6. Usage Notes
      • 7.6.7. Warp7 with OV2680
      • 7.6.8. i.MX6ULL-EVK with OV5640
      • 7.6.9. References
    • 7.7. Intel Image Processing Unit 3 (IPU3) Imaging Unit (ImgU) driver
      • 7.7.1. Introduction
      • 7.7.2. CIO2
      • 7.7.3. ImgU
      • 7.7.4. Configuring the Intel IPU3
      • 7.7.5. Example user space code for IPU3
      • 7.7.6. Overview of IPU3 pipeline
      • 7.7.7. References
    • 7.8. Intel Image Processing Unit 6 (IPU6) Input System driver
      • 7.8.1. Introduction
      • 7.8.2. Input system driver
      • 7.8.3. References
    • 7.9. The ivtv driver
      • 7.9.1. Features
      • 7.9.2. Additional features for the PVR-350 (CX23415 based)
      • 7.9.3. See also
      • 7.9.4. IRC
      • 7.9.5. Devices
      • 7.9.6. Base devices
    • 7.10. The mgb4 driver
      • 7.10.1. sysfs interface
      • 7.10.2. MTD partitions
      • 7.10.3. IIO (triggers)
    • 7.11. OMAP 3 Image Signal Processor (ISP) driver
      • 7.11.1. Introduction
      • 7.11.2. Split to subdevs
      • 7.11.3. Controlling the OMAP 3 ISP
      • 7.11.4. Technical reference manuals (TRMs) and other documentation
      • 7.11.5. References
    • 7.12. OMAP4 ISS Driver
      • 7.12.1. Introduction
      • 7.12.2. Tested platforms
      • 7.12.3. File list
      • 7.12.4. References
    • 7.13. Philips webcams (pwc driver)
    • 7.14. Qualcomm Camera Subsystem driver
      • 7.14.1. Introduction
      • 7.14.2. Qualcomm Camera Subsystem hardware
      • 7.14.3. Supported functionality
      • 7.14.4. Driver Architecture and Design
      • 7.14.5. Implementation
      • 7.14.6. Documentation
      • 7.14.7. References
    • 7.15. Raspberry Pi PiSP Back End Memory-to-Memory ISP (pisp-be)
      • 7.15.1. The PiSP Back End
      • 7.15.2. The pisp-be driver
      • 7.15.3. ISP configuration
    • 7.16. Renesas R-Car Fine Display Processor (FDP1) Driver
    • 7.17. Rockchip Image Signal Processor (rkisp1)
      • 7.17.1. Introduction
      • 7.17.2. Revisions
      • 7.17.3. Topology
      • 7.17.4. Capturing Video Frames Example
      • 7.17.5. Configuring Quantization
    • 7.18. The saa7134 driver
      • 7.18.1. Status
      • 7.18.2. Build
      • 7.18.3. Changes / Fixes
      • 7.18.4. Known Problems
      • 7.18.5. Credits
    • 7.19. The Silicon Labs Si470x FM Radio Receivers driver
      • 7.19.1. Information from Silicon Labs
      • 7.19.2. Supported ICs
      • 7.19.3. Supported USB devices
      • 7.19.4. Software
      • 7.19.5. Audio Listing
      • 7.19.6. Module Parameters
      • 7.19.7. Errors
      • 7.19.8. Open Issues
      • 7.19.9. Other useful information and links
    • 7.20. The Silicon Labs Si4713 FM Radio Transmitter Driver
      • 7.20.1. Information about the Device
      • 7.20.2. Device driver description
      • 7.20.3. Properties description
      • 7.20.4. RNL
      • 7.20.5. Stereo/Mono and RDS subchannels
      • 7.20.6. Testing
    • 7.21. The SI476x Driver
      • 7.21.1. TODO for the driver
      • 7.21.2. Parameters exposed over debugfs
    • 7.22. Starfive Camera Subsystem driver
      • 7.22.1. Introduction
      • 7.22.2. Starfive Camera Subsystem hardware
      • 7.22.3. Topology
    • 7.23. The Virtual Media Controller Driver (vimc)
      • 7.23.1. Topology
      • 7.23.2. Subdevices
      • 7.23.3. Module options
    • 7.24. The Virtual Stateless Decoder Driver (visl)
      • 7.24.1. Module parameters
      • 7.24.2. What is the default use case for this driver?
      • 7.24.3. Supported codecs
      • 7.24.4. visl trace events
      • 7.24.5. Dumping OUTPUT buffer data through debugfs
    • 7.25. The Virtual Video Test Driver (vivid)
      • 7.25.1. Configuring the driver
      • 7.25.2. Video Capture
      • 7.25.3. Video Output
      • 7.25.4. VBI Capture
      • 7.25.5. VBI Output
      • 7.25.6. Radio Receiver
      • 7.25.7. Radio Transmitter
      • 7.25.8. Software Defined Radio Receiver
      • 7.25.9. Metadata Capture
      • 7.25.10. Metadata Output
      • 7.25.11. Touch Capture
      • 7.25.12. Controls
      • 7.25.13. Video, Sliced VBI and HDMI CEC Looping
      • 7.25.14. Radio & RDS Looping
      • 7.25.15. Cropping, Composing, Scaling
      • 7.25.16. Formats
      • 7.25.17. Output Overlay
      • 7.25.18. CEC (Consumer Electronics Control)
      • 7.25.19. Some Future Improvements
  • 8. Digital TV driver-specific documentation
    • 8.1. Avermedia DVB-T on BT878 Release Notes
      • 8.1.1. The Avermedia DVB-T
      • 8.1.2. Getting the card going
      • 8.1.3. Known Limitations
      • 8.1.4. Further Update
    • 8.2. How to get the bt8xx cards working
      • 8.2.1. General information
      • 8.2.2. Loading Modules
    • 8.3. Firmware files for lmedm04 cards
      • 8.3.1. For DM04+/QQBOX LME2510C (Sharp 7395 Tuner)
      • 8.3.2. For DM04 LME2510 (LG Tuner)
      • 8.3.3. For DM04 LME2510C (LG Tuner)
      • 8.3.4. For LME2510
      • 8.3.5. For LME2510C
    • 8.4. Opera firmware
    • 8.5. How to set up the Technisat/B2C2 Flexcop devices
      • 8.5.1. Find out what device you have
      • 8.5.2. Kernel compilation:
    • 8.6. TechnoTrend/Hauppauge DEC USB Driver
      • 8.6.1. Driver Status
      • 8.6.2. Getting the Firmware
      • 8.6.3. Hotplug Firmware Loading