Video4Linux (V4L) driver-specific documentation¶
Copyright © 1999-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 version 2 of the License.
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. Guidelines for Video4Linux pixel format 4CCs
- 2. Infrared remote control support in video4linux drivers
- 3. Using with lircd
- 4. Using without lircd
- 5. Tuner drivers
- 6. Cards List
- 7. The bttv driver
- 7.1. Release notes for bttv
- 7.2. Make bttv work with your card
- 7.3. Autodetecting cards
- 7.4. Still doesn’t work?
- 7.5. Modprobe options
- 7.6. If the box freezes hard with bttv
- 7.7. Bttv quirks
- 7.8. bttv and sound mini howto
- 7.9. Cards
- 7.9.1. Supported cards: Bt848/Bt848a/Bt849/Bt878/Bt879 cards
- 7.9.2. MATRIX Vision
- 7.9.3. Miro/Pinnacle PCTV
- 7.9.4. Hauppauge Win/TV pci
- 7.9.5. Askey CPH-Series
- 7.9.6. Lifeview Flyvideo Series:
- 7.9.7. Typhoon TV card series:
- 7.9.8. Guillemot
- 7.9.9. Mentor
- 7.9.10. Prolink
- 7.9.11. Dynalink
- 7.9.12. Phoebemicro
- 7.9.13. Genius/Kye
- 7.9.14. Tekram
- 7.9.15. Lucky Star
- 7.9.16. Leadtek
- 7.9.17. KNC One
- 7.9.18. Provideo
- 7.9.19. Highscreen
- 7.9.20. Zoltrix
- 7.9.21. AVerMedia
- 7.9.22. Aimslab
- 7.9.23. IXMicro (former: IMS=Integrated Micro Solutions)
- 7.9.24. Lifetec/Medion/Tevion/Aldi
- 7.9.25. Modular Technologies (www.modulartech.com) UK
- 7.9.26. Terratec
- 7.9.27. Technisat
- 7.9.28. Siemens
- 7.9.29. Powercolor
- 7.9.30. Pinnacle
- 7.9.31. Lenco
- 7.9.32. Iomega
- 7.9.33. LML
- 7.9.34. Grandtec
- 7.9.35. Koutech
- 7.9.36. IODATA (jp)
- 7.9.37. Canopus (jp)
- 7.9.38. www.sigmacom.co.kr
- 7.9.39. www.sasem.co.kr
- 7.9.40. hama
- 7.9.41. Sigma Designs
- 7.9.42. Formac
- 7.9.43. ATI
- 7.9.44. Diamond Multimedia
- 7.9.45. Aopen
- 7.9.46. Intel
- 7.9.47. STB
- 7.9.48. Videologic
- 7.9.49. Technotrend
- 7.9.50. Teles
- 7.9.51. Remote Vision
- 7.9.52. Boeder
- 7.9.53. Media-Surfer (esc-kathrein.de)
- 7.9.54. Jetway (www.jetway.com.tw)
- 7.9.55. Galaxis
- 7.9.56. Hauppauge
- 7.9.57. Matrix-Vision
- 7.9.58. Conceptronic (.net)
- 7.9.59. BestData
- 7.9.60. Gallant (www.gallantcom.com) www.minton.com.tw
- 7.9.61. Asonic (www.asonic.com.cn) (website down)
- 7.9.62. Hoontech
- 7.9.63. Teppro (www.itcteppro.com.tw)
- 7.9.64. Kworld (www.kworld.com.tw)
- 7.9.65. JTT/ Justy Corp.(http://www.jtt.ne.jp/)
- 7.9.66. ADS www.adstech.com
- 7.9.67. AVEC www.prochips.com
- 7.9.68. NoBrand
- 7.9.69. Mach www.machspeed.com
- 7.9.70. Eline www.eline-net.com/
- 7.9.71. Spirit
- 7.9.72. Boser www.boser.com.tw
- 7.9.73. Satelco www.citycom-gmbh.de, www.satelco.de
- 7.9.74. Sensoray www.sensoray.com
- 7.9.75. CEI (Chartered Electronics Industries Pte Ltd [CEI] [FCC ID HBY])
- 7.9.76. AITech
- 7.9.77. MAXRON
- 7.9.78. www.ids-imaging.de
- 7.9.79. www.sknet-web.co.jp
- 7.9.80. A-Max www.amaxhk.com (Colormax, Amax, Napa)
- 7.9.81. Cybertainment
- 7.9.82. VCR (http://www.vcrinc.com/)
- 7.9.83. Twinhan
- 7.9.84. MSI
- 7.9.85. Focus www.focusinfo.com
- 7.9.86. Sdisilk www.sdisilk.com/
- 7.9.87. www.euresys.com
- 7.9.88. PMC/Pace
- 7.9.89. Mercury www.kobian.com (UK and FR)
- 7.9.90. TEC sound
- 7.9.91. Lorenzen www.lorenzen.de
- 7.9.92. Origo (.uk) www.origo2000.com
- 7.9.93. I/O Magic www.iomagic.com
- 7.9.94. Arowana
- 7.9.95. iTVC15 boards
- 7.9.96. Asus www.asuscom.com
- 7.9.97. Hoontech
- 7.10. Chips used at bttv devices
- 7.11. Specs
- 7.12. Thanks
- 7.13. Contributors
- 8. The cafe_ccic driver
- 9. The cpia2 driver
- 10. The cx18 driver
- 11. The cx2341x driver
- 11.1. Memory at cx2341x chips
- 11.2. Missing documentation
- 11.3. The cx2341x firmware upload
- 11.4. How to call the firmware API
- 11.5. OSD firmware API description
- 11.5.1. CX2341X_OSD_GET_FRAMEBUFFER
- 11.5.2. CX2341X_OSD_GET_PIXEL_FORMAT
- 11.5.3. CX2341X_OSD_SET_PIXEL_FORMAT
- 11.5.4. CX2341X_OSD_GET_STATE
- 11.5.5. CX2341X_OSD_SET_STATE
- 11.5.6. CX2341X_OSD_GET_OSD_COORDS
- 11.5.7. CX2341X_OSD_SET_OSD_COORDS
- 11.5.8. CX2341X_OSD_GET_SCREEN_COORDS
- 11.5.9. CX2341X_OSD_SET_SCREEN_COORDS
- 11.5.10. CX2341X_OSD_GET_GLOBAL_ALPHA
- 11.5.11. CX2341X_OSD_SET_GLOBAL_ALPHA
- 11.5.12. CX2341X_OSD_SET_BLEND_COORDS
- 11.5.13. CX2341X_OSD_GET_FLICKER_STATE
- 11.5.14. CX2341X_OSD_SET_FLICKER_STATE
- 11.5.15. CX2341X_OSD_BLT_COPY
- 11.5.16. CX2341X_OSD_BLT_FILL
- 11.5.17. CX2341X_OSD_BLT_TEXT
- 11.5.18. CX2341X_OSD_SET_FRAMEBUFFER_WINDOW
- 11.5.19. CX2341X_OSD_SET_CHROMA_KEY
- 11.5.20. CX2341X_OSD_GET_ALPHA_CONTENT_INDEX
- 11.5.21. CX2341X_OSD_SET_ALPHA_CONTENT_INDEX
- 11.6. Encoder firmware API description
- 11.6.1. CX2341X_ENC_PING_FW
- 11.6.2. CX2341X_ENC_START_CAPTURE
- 11.6.3. CX2341X_ENC_STOP_CAPTURE
- 11.6.4. CX2341X_ENC_SET_AUDIO_ID
- 11.6.5. CX2341X_ENC_SET_VIDEO_ID
- 11.6.6. CX2341X_ENC_SET_PCR_ID
- 11.6.7. CX2341X_ENC_SET_FRAME_RATE
- 11.6.8. CX2341X_ENC_SET_FRAME_SIZE
- 11.6.9. CX2341X_ENC_SET_BIT_RATE
- 11.6.10. CX2341X_ENC_SET_GOP_PROPERTIES
- 11.6.11. CX2341X_ENC_SET_ASPECT_RATIO
- 11.6.12. CX2341X_ENC_SET_DNR_FILTER_MODE
- 11.6.13. CX2341X_ENC_SET_DNR_FILTER_PROPS
- 11.6.14. CX2341X_ENC_SET_CORING_LEVELS
- 11.6.15. CX2341X_ENC_SET_SPATIAL_FILTER_TYPE
- 11.6.16. CX2341X_ENC_SET_VBI_LINE
- 11.6.17. CX2341X_ENC_SET_STREAM_TYPE
- 11.6.18. CX2341X_ENC_SET_OUTPUT_PORT
- 11.6.19. CX2341X_ENC_SET_AUDIO_PROPERTIES
- 11.6.20. CX2341X_ENC_HALT_FW
- 11.6.21. CX2341X_ENC_GET_VERSION
- 11.6.22. CX2341X_ENC_SET_GOP_CLOSURE
- 11.6.23. CX2341X_ENC_GET_SEQ_END
- 11.6.24. CX2341X_ENC_SET_PGM_INDEX_INFO
- 11.6.25. CX2341X_ENC_SET_VBI_CONFIG
- 11.6.26. CX2341X_ENC_SET_DMA_BLOCK_SIZE
- 11.6.27. CX2341X_ENC_GET_PREV_DMA_INFO_MB_10
- 11.6.28. CX2341X_ENC_GET_PREV_DMA_INFO_MB_9
- 11.6.29. CX2341X_ENC_SCHED_DMA_TO_HOST
- 11.6.30. CX2341X_ENC_INITIALIZE_INPUT
- 11.6.31. CX2341X_ENC_SET_FRAME_DROP_RATE
- 11.6.32. CX2341X_ENC_PAUSE_ENCODER
- 11.6.33. CX2341X_ENC_REFRESH_INPUT
- 11.6.34. CX2341X_ENC_SET_COPYRIGHT
- 11.6.35. CX2341X_ENC_SET_EVENT_NOTIFICATION
- 11.6.36. CX2341X_ENC_SET_NUM_VSYNC_LINES
- 11.6.37. CX2341X_ENC_SET_PLACEHOLDER
- 11.6.38. CX2341X_ENC_MUTE_VIDEO
- 11.6.39. CX2341X_ENC_MUTE_AUDIO
- 11.6.40. CX2341X_ENC_SET_VERT_CROP_LINE
- 11.6.41. CX2341X_ENC_MISC
- 11.7. Decoder firmware API description
- 11.7.1. CX2341X_DEC_PING_FW
- 11.7.2. CX2341X_DEC_START_PLAYBACK
- 11.7.3. CX2341X_DEC_STOP_PLAYBACK
- 11.7.4. CX2341X_DEC_SET_PLAYBACK_SPEED
- 11.7.5. CX2341X_DEC_STEP_VIDEO
- 11.7.6. CX2341X_DEC_SET_DMA_BLOCK_SIZE
- 11.7.7. CX2341X_DEC_GET_XFER_INFO
- 11.7.8. CX2341X_DEC_GET_DMA_STATUS
- 11.7.9. CX2341X_DEC_SCHED_DMA_FROM_HOST
- 11.7.10. CX2341X_DEC_PAUSE_PLAYBACK
- 11.7.11. CX2341X_DEC_HALT_FW
- 11.7.12. CX2341X_DEC_SET_STANDARD
- 11.7.13. CX2341X_DEC_GET_VERSION
- 11.7.14. CX2341X_DEC_SET_STREAM_INPUT
- 11.7.15. CX2341X_DEC_GET_TIMING_INFO
- 11.7.16. CX2341X_DEC_SET_AUDIO_MODE
- 11.7.17. CX2341X_DEC_SET_EVENT_NOTIFICATION
- 11.7.18. CX2341X_DEC_SET_DISPLAY_BUFFERS
- 11.7.19. CX2341X_DEC_EXTRACT_VBI
- 11.7.20. CX2341X_DEC_SET_DECODER_SOURCE
- 11.7.21. CX2341X_DEC_SET_PREBUFFERING
- 11.8. PVR350 Video decoder registers 0x02002800 -> 0x02002B00
- 11.9. The cx231xx DMA engine
- 11.10. Non-compressed file format
- 11.11. Format of embedded V4L2_MPEG_STREAM_VBI_FMT_IVTV VBI data
- 12. The cx88 driver
- 13. The VPBE V4L2 driver design
- 14. The Samsung S5P/EXYNOS4 FIMC driver
- 15. The ivtv driver
- 16. Vaio Picturebook Motion Eye Camera Driver
- 17. OMAP 3 Image Signal Processor (ISP) driver
- 17.1. Introduction
- 17.2. Split to subdevs
- 17.3. Controlling the OMAP 3 ISP
- 17.4. Events
- 17.5. Private IOCTLs
- 17.6. CCDC and preview block IOCTLs
- 17.7. Statistic blocks IOCTLs
- 17.8. VIDIOC_OMAP3ISP_STAT_EN
- 17.9. VIDIOC_OMAP3ISP_AEWB_CFG, VIDIOC_OMAP3ISP_HIST_CFG and VIDIOC_OMAP3ISP_AF_CFG
- 17.10. VIDIOC_OMAP3ISP_STAT_REQ
- 17.11. Technical reference manuals (TRMs) and other documentation
- 17.12. References
- 18. OMAP4 ISS Driver
- 19. The pvrusb2 driver
- 20. PXA-Camera Host Driver
- 21. The Radiotrack radio driver
- 22. The saa7134 driver
- 23. Cropping and Scaling algorithm, used in the sh_mobile_ceu_camera driver
- 24. The Silicon Labs Si470x FM Radio Receivers driver
- 25. The Silicon Labs Si4713 FM Radio Transmitter Driver
- 26. The SI476x Driver
- 27. The Soc-Camera Drivers
- 28. The Linux USB Video Class (UVC) driver
- 29. The Virtual Video Test Driver (vivid)
- 29.1. Configuring the driver
- 29.2. Video Capture
- 29.3. Video Output
- 29.4. VBI Capture
- 29.5. VBI Output
- 29.6. Radio Receiver
- 29.7. Radio Transmitter
- 29.8. Software Defined Radio Receiver
- 29.9. Controls
- 29.10. Video, VBI and RDS Looping
- 29.11. Cropping, Composing, Scaling
- 29.12. Formats
- 29.13. Capture Overlay
- 29.14. Output Overlay
- 29.15. CEC (Consumer Electronics Control)
- 29.16. Some Future Improvements
- 30. The Zoran driver
- 30.1. Frequently Asked Questions
- 30.2. What cards are supported
- 30.3. 1.1 What the TV decoder can do an what not
- 30.4. What the TV encoder can do an what not
- 30.5. How do I get this damn thing to work
- 30.6. What mainboard should I use (or why doesn’t my card work)
- 30.7. Programming interface
- 30.8. Applications
- 30.9. Concerning buffer sizes, quality, output size etc.
- 30.10. It hangs/crashes/fails/whatevers! Help!
- 30.11. Maintainers/Contacting
- 30.12. Driver’s License
- 31. Zoran 364xx based USB webcam module