媒体子系统内核内部 API

本节包含关于媒体子系统及其支持的驱动程序的使用信息。

请参阅

媒体子系统管理和用户指南

• 了解关于媒体子系统和支持的驱动程序的使用信息；

Linux 媒体基础设施用户空间 API

• 了解媒体设备上使用的用户空间 API。

目录

• 1. 媒体子系统概述
  • 1.1. 概述
    • 1.1.1. 媒体维护者
  • 1.2. 提交清单附录
    • 1.2.1. 样式清理补丁
    • 1.2.2. 编码样式附录
  • 1.3. 关键周期日期
  • 1.4. 审查节奏
• 2. Video4Linux 设备
  • 2.1. 简介
  • 2.2. V4L 驱动程序的结构
  • 2.3. V4L2 框架的结构
  • 2.4. 视频设备的内部表示
    • 2.4.1. ioctl 和锁定
    • 2.4.2. 视频设备注册
    • 2.4.3. 视频设备调试
    • 2.4.4. 视频设备清理
    • 2.4.5. 辅助函数
    • 2.4.6. video_device 函数和数据结构
  • 2.5. V4L2 设备实例
    • 2.5.1. v4l2_device 函数和数据结构
  • 2.6. V4L2 文件句柄
    • 2.6.1. V4L2 fh 函数和数据结构
  • 2.7. V4L2 子设备
    • 2.7.1. 子设备注册
      • 2.7.1.1. 注册同步子设备
      • 2.7.1.2. 注册异步子设备
      • 2.7.1.3. 异步子设备通知器
      • 2.7.1.4. 子设备的异步子设备通知器
      • 2.7.1.5. 用于相机传感器驱动程序的异步子设备注册助手
      • 2.7.1.6. 异步子设备通知器示例
      • 2.7.1.7. 异步子设备通知器回调
    • 2.7.2. 调用子设备操作
  • 2.8. V4L2 子设备用户空间 API
  • 2.9. 只读子设备用户空间 API
  • 2.10. I2C 子设备驱动程序
  • 2.11. 集中管理的子设备活动状态
  • 2.12. 流、多路复用媒体焊盘和内部路由
  • 2.13. V4L2 子设备函数和数据结构
  • 2.14. V4L2 事件
    • 2.14.1. 事件订阅
    • 2.14.2. 取消订阅事件
    • 2.14.3. 检查是否有待处理的事件
    • 2.14.4. 事件如何工作
      • 2.14.4.1. V4L2 事件函数和数据结构
  • 2.15. V4L2 控件
    • 2.15.1. 简介
    • 2.15.2. 框架中的对象
    • 2.15.3. V4L2 和子设备驱动程序的基本用法
    • 2.15.4. 继承子设备控件
    • 2.15.5. 访问控制值
    • 2.15.6. 菜单控件
    • 2.15.7. 自定义控件
    • 2.15.8. 活动和捕获的控件
    • 2.15.9. 控制集群
    • 2.15.10. 使用自动集群处理自动增益/增益类型控件
    • 2.15.11. VIDIOC_LOG_STATUS 支持
    • 2.15.12. 不同视频节点的不同处理程序
    • 2.15.13. 查找控件
    • 2.15.14. 防止控件继承
    • 2.15.15. V4L2_CTRL_TYPE_CTRL_CLASS 控件
    • 2.15.16. 添加通知回调
    • 2.15.17. v4l2_ctrl 函数和数据结构
  • 2.16. V4L2 videobuf2 函数和数据结构
  • 2.17. V4L2 DV 定时函数
  • 2.18. V4L2 闪光灯函数和数据结构
  • 2.19. V4L2 媒体控制器函数和数据结构
  • 2.20. V4L2 媒体总线函数和数据结构
  • 2.21. V4L2 内存到内存函数和数据结构
  • 2.22. V4L2 异步 kAPI
  • 2.23. V4L2 fwnode kAPI
  • 2.24. V4L2 CCI kAPI
  • 2.25. V4L2 矩形辅助函数
  • 2.26. 调谐器函数和数据结构
  • 2.27. V4L2 通用函数和数据结构
  • 2.28. Hauppauge TV EEPROM 函数和数据结构
  • 2.29. V4L2 JPEG 标头相关函数和数据结构
• 3. 数字电视 (DVB) 设备
  • 3.1. 数字电视通用函数
    • 3.1.1. DVB 设备
    • 3.1.2. 数字电视环形缓冲区
    • 3.1.3. 数字电视 VB2 处理程序
  • 3.2. 数字电视前端 kABI
    • 3.2.1. 数字电视前端
      • 3.2.1.1. 解调器驱动程序
      • 3.2.1.2. 将前端驱动程序附加到桥接驱动程序
    • 3.2.2. 数字电视前端统计信息
      • 3.2.2.1. 简介
      • 3.2.2.2. 统计信息组
      • 3.2.2.3. 统计信息收集
        • 3.2.2.3.1. 如果驱动程序具有指示何时准备好收集数据的位
        • 3.2.2.3.2. 如果驱动程序不提供统计信息可用性检查位
    • 3.2.3. 数字电视前端函数和类型
  • 3.3. 数字电视解复用 kABI
    • 3.3.1. 数字电视解复用
    • 3.3.2. 解复用回调 API
    • 3.3.3. 数字电视解复用设备注册函数和数据结构
    • 3.3.4. 高级数字电视解复用接口
    • 3.3.5. 驱动程序内部低级硬件特定驱动程序解复用接口
  • 3.4. 数字电视条件访问 kABI
  • 3.5. 数字电视网络 kABI
• 4. 遥控器设备
  • 4.1. 遥控器核心
    • 4.1.1. 遥控器数据结构和函数
• 5. 媒体控制器设备
  • 5.1. 媒体控制器
    • 5.1.1. 抽象媒体设备模型
    • 5.1.2. 媒体设备
    • 5.1.3. 实体
    • 5.1.4. 接口
    • 5.1.5. 焊盘
    • 5.1.6. 链接
    • 5.1.7. 图遍历
    • 5.1.8. 使用计数和电源管理
    • 5.1.9. 链接设置
    • 5.1.10. 管道和媒体流
    • 5.1.11. 链接验证
    • 5.1.12. 管道遍历
    • 5.1.13. 媒体控制器设备分配器 API
    • 5.1.14. API 定义
• 6. CEC 内核支持
  • 6.1. CEC 协议
  • 6.2. CEC 适配器接口
  • 6.3. 实现低级 CEC 适配器
  • 6.4. 实现中断处理程序
  • 6.5. 可选：实现错误注入支持
  • 6.6. 实现高级 CEC 适配器
  • 6.7. CEC 框架函数
  • 6.8. CEC 引脚框架
  • 6.9. CEC 通知器框架
• 7. 像素数据发射器和接收器驱动程序
  • 7.1. 总线类型
    • 7.1.1. MIPI CSI-2
    • 7.1.2. 并行和 BT.656
  • 7.2. 发射器驱动程序
    • 7.2.1. 媒体总线像素代码
    • 7.2.2. 链接频率
  • 7.3. CSI-2 发射器驱动程序
    • 7.3.1. 像素速率
    • 7.3.2. LP-11 和 LP-111 状态
    • 7.3.3. 停止发射器
• 8. 编写相机传感器驱动程序
  • 8.1. CSI-2、并行和 BT.656 总线
  • 8.2. 处理时钟
    • 8.2.1. ACPI
    • 8.2.2. 设备树
  • 8.3. 电源管理
    • 8.3.1. 控制框架
  • 8.4. 旋转、方向和翻转
  • 8.5. 示例驱动程序
• 9. 媒体驱动程序特定文档
  • 9.1. Video4Linux (V4L) 驱动程序
    • 9.1.1. bttv 驱动程序
      • 9.1.1.1. bttv 和声音迷你指南
        • 9.1.1.1.1. 声音如何工作的详细信息
    • 9.1.2. cx2341x 驱动程序
      • 9.1.2.1. cx2341x 芯片中的内存
        • 9.1.2.1.1. 内存映射
        • 9.1.2.1.2. 寄存器
        • 9.1.2.1.3. 中断状态寄存器
      • 9.1.2.2. 缺失的文档
      • 9.1.2.3. cx2341x 固件上传
        • 9.1.2.3.1. 如何查找
        • 9.1.2.3.2. 如何加载
      • 9.1.2.4. 如何调用固件 API
      • 9.1.2.5. OSD 固件 API 描述
        • 9.1.2.5.1. CX2341X_OSD_GET_FRAMEBUFFER
        • 9.1.2.5.2. CX2341X_OSD_GET_PIXEL_FORMAT
        • 9.1.2.5.3. CX2341X_OSD_SET_PIXEL_FORMAT
        • 9.1.2.5.4. CX2341X_OSD_GET_STATE
        • 9.1.2.5.5. CX2341X_OSD_SET_STATE
        • 9.1.2.5.6. CX2341X_OSD_GET_OSD_COORDS
        • 9.1.2.5.7. CX2341X_OSD_SET_OSD_COORDS
        • 9.1.2.5.8. CX2341X_OSD_GET_SCREEN_COORDS
        • 9.1.2.5.9. CX2341X_OSD_SET_SCREEN_COORDS
        • 9.1.2.5.10. CX2341X_OSD_GET_GLOBAL_ALPHA
        • 9.1.2.5.11. CX2341X_OSD_SET_GLOBAL_ALPHA
        • 9.1.2.5.12. CX2341X_OSD_SET_BLEND_COORDS
        • 9.1.2.5.13. CX2341X_OSD_GET_FLICKER_STATE
        • 9.1.2.5.14. CX2341X_OSD_SET_FLICKER_STATE
        • 9.1.2.5.15. CX2341X_OSD_BLT_COPY
        • 9.1.2.5.16. CX2341X_OSD_BLT_FILL
        • 9.1.2.5.17. CX2341X_OSD_BLT_TEXT
        • 9.1.2.5.18. CX2341X_OSD_SET_FRAMEBUFFER_WINDOW
        • 9.1.2.5.19. CX2341X_OSD_SET_CHROMA_KEY
        • 9.1.2.5.20. CX2341X_OSD_GET_ALPHA_CONTENT_INDEX
        • 9.1.2.5.21. CX2341X_OSD_SET_ALPHA_CONTENT_INDEX
      • 9.1.2.6. 编码器固件 API 描述
        • 9.1.2.6.1. CX2341X_ENC_PING_FW
        • 9.1.2.6.2. CX2341X_ENC_START_CAPTURE
        • 9.1.2.6.3. CX2341X_ENC_STOP_CAPTURE
        • 9.1.2.6.4. CX2341X_ENC_SET_AUDIO_ID
        • 9.1.2.6.5. CX2341X_ENC_SET_VIDEO_ID
        • 9.1.2.6.6. CX2341X_ENC_SET_PCR_ID
        • 9.1.2.6.7. CX2341X_ENC_SET_FRAME_RATE
        • 9.1.2.6.8. CX2341X_ENC_SET_FRAME_SIZE
        • 9.1.2.6.9. CX2341X_ENC_SET_BIT_RATE
        • 9.1.2.6.10. CX2341X_ENC_SET_GOP_PROPERTIES
        • 9.1.2.6.11. CX2341X_ENC_SET_ASPECT_RATIO
        • 9.1.2.6.12. CX2341X_ENC_SET_DNR_FILTER_MODE
        • 9.1.2.6.13. CX2341X_ENC_SET_DNR_FILTER_PROPS
        • 9.1.2.6.14. CX2341X_ENC_SET_CORING_LEVELS
        • 9.1.2.6.15. CX2341X_ENC_SET_SPATIAL_FILTER_TYPE
        • 9.1.2.6.16. CX2341X_ENC_SET_VBI_LINE
        • 9.1.2.6.17. CX2341X_ENC_SET_STREAM_TYPE
        • 9.1.2.6.18. CX2341X_ENC_SET_OUTPUT_PORT
        • 9.1.2.6.19. CX2341X_ENC_SET_AUDIO_PROPERTIES
        • 9.1.2.6.20. CX2341X_ENC_HALT_FW
        • 9.1.2.6.21. CX2341X_ENC_GET_VERSION
        • 9.1.2.6.22. CX2341X_ENC_SET_GOP_CLOSURE
        • 9.1.2.6.23. CX2341X_ENC_GET_SEQ_END
        • 9.1.2.6.24. CX2341X_ENC_SET_PGM_INDEX_INFO
        • 9.1.2.6.25. CX2341X_ENC_SET_VBI_CONFIG
        • 9.1.2.6.26. CX2341X_ENC_SET_DMA_BLOCK_SIZE
        • 9.1.2.6.27. CX2341X_ENC_GET_PREV_DMA_INFO_MB_10
        • 9.1.2.6.28. CX2341X_ENC_GET_PREV_DMA_INFO_MB_9
        • 9.1.2.6.29. CX2341X_ENC_SCHED_DMA_TO_HOST
        • 9.1.2.6.30. CX2341X_ENC_INITIALIZE_INPUT
        • 9.1.2.6.31. CX2341X_ENC_SET_FRAME_DROP_RATE
        • 9.1.2.6.32. CX2341X_ENC_PAUSE_ENCODER
        • 9.1.2.6.33. CX2341X_ENC_REFRESH_INPUT
        • 9.1.2.6.34. CX2341X_ENC_SET_COPYRIGHT
        • 9.1.2.6.35. CX2341X_ENC_SET_EVENT_NOTIFICATION
        • 9.1.2.6.36. CX2341X_ENC_SET_NUM_VSYNC_LINES
        • 9.1.2.6.37. CX2341X_ENC_SET_PLACEHOLDER
        • 9.1.2.6.38. CX2341X_ENC_MUTE_VIDEO
        • 9.1.2.6.39. CX2341X_ENC_MUTE_AUDIO
        • 9.1.2.6.40. CX2341X_ENC_SET_VERT_CROP_LINE
        • 9.1.2.6.41. CX2341X_ENC_MISC
      • 9.1.2.7. 解码器固件API描述
        • 9.1.2.7.1. CX2341X_DEC_PING_FW
        • 9.1.2.7.2. CX2341X_DEC_START_PLAYBACK
        • 9.1.2.7.3. CX2341X_DEC_STOP_PLAYBACK
        • 9.1.2.7.4. CX2341X_DEC_SET_PLAYBACK_SPEED
        • 9.1.2.7.5. CX2341X_DEC_STEP_VIDEO
        • 9.1.2.7.6. CX2341X_DEC_SET_DMA_BLOCK_SIZE
        • 9.1.2.7.7. CX2341X_DEC_GET_XFER_INFO
        • 9.1.2.7.8. CX2341X_DEC_GET_DMA_STATUS
        • 9.1.2.7.9. CX2341X_DEC_SCHED_DMA_FROM_HOST
        • 9.1.2.7.10. CX2341X_DEC_PAUSE_PLAYBACK
        • 9.1.2.7.11. CX2341X_DEC_HALT_FW
        • 9.1.2.7.12. CX2341X_DEC_SET_STANDARD
        • 9.1.2.7.13. CX2341X_DEC_GET_VERSION
        • 9.1.2.7.14. CX2341X_DEC_SET_STREAM_INPUT
        • 9.1.2.7.15. CX2341X_DEC_GET_TIMING_INFO
        • 9.1.2.7.16. CX2341X_DEC_SET_AUDIO_MODE
        • 9.1.2.7.17. CX2341X_DEC_SET_EVENT_NOTIFICATION
        • 9.1.2.7.18. CX2341X_DEC_SET_DISPLAY_BUFFERS
        • 9.1.2.7.19. CX2341X_DEC_EXTRACT_VBI
        • 9.1.2.7.20. CX2341X_DEC_SET_DECODER_SOURCE
        • 9.1.2.7.21. CX2341X_DEC_SET_PREBUFFERING
      • 9.1.2.8. PVR350 视频解码器寄存器 0x02002800 -> 0x02002B00
      • 9.1.2.9. cx231xx DMA 引擎
        • 9.1.2.9.1. 简介
        • 9.1.2.9.2. 流程
        • 9.1.2.9.3. 邮箱 #10
        • 9.1.2.9.4. 散布-收集数组
        • 9.1.2.9.5. DMA 传输状态
    • 9.1.3. cx88 驱动程序
      • 9.1.3.1. cx88 数据手册中缺少文档
      • 9.1.3.2. Hauppauge WinTV cx88 IR 信息
        • 9.1.3.2.1. 附加信息
    • 9.1.4. 三星 S5P/EXYNOS4 FIMC 驱动程序
      • 9.1.4.1. 文件分区
    • 9.1.5. pvrusb2 驱动程序
      • 9.1.5.1. 背景
      • 9.1.5.2. 构建
      • 9.1.5.3. 源文件列表/功能概述
    • 9.1.6. PXA-摄像头主机驱动程序
      • 9.1.6.1. 约束
      • 9.1.6.2. 全局视频工作流程
      • 9.1.6.3. DMA 使用
    • 9.1.7. Radiotrack 无线电驱动程序
      • 9.1.7.1. 致谢
      • 9.1.7.2. 为什么要有这份文档？
      • 9.1.7.3. 物理描述
      • 9.1.7.4. 使用 IOPORT 控制卡
      • 9.1.7.5. 编程示例
    • 9.1.8. Rockchip 图像信号处理器驱动程序 (rkisp1)
      • 9.1.8.1. 版本及其差异
      • 9.1.8.2. 从 V10 到 V12 的更改
      • 9.1.8.3. 从 V12 到 V13 的更改
    • 9.1.9. saa7134 驱动程序
      • 9.1.9.1. 卡片变体
      • 9.1.9.2. LifeView GPIO
      • 9.1.9.3. 鸣谢
    • 9.1.10. sh_mobile_ceu_camera 驱动程序中使用的裁剪和缩放算法
      • 9.1.10.1. 术语
      • 9.1.10.2. 通用缩放/裁剪方案
      • 9.1.10.3. S_FMT
      • 9.1.10.4. S_CROP
    • 9.1.11. 调谐器驱动程序
      • 9.1.11.1. 简单的调谐器编程
      • 9.1.11.2. 调谐器制造商
    • 9.1.12. 虚拟媒体控制器驱动程序 (vimc)
      • 9.1.12.1. 源代码文档
        • 9.1.12.1.1. vimc-streamer
    • 9.1.13. Zoran 驱动程序
      • 9.1.13.1. 常见问题解答
      • 9.1.13.2. 支持哪些卡
        • 9.1.13.2.1. Iomega Buz
        • 9.1.13.2.2. AverMedia 6 Eyes AVS6EYES
        • 9.1.13.2.3. Linux Media Labs LML33
        • 9.1.13.2.4. Linux Media Labs LML33R10
        • 9.1.13.2.5. Pinnacle/Miro DC10(新)
        • 9.1.13.2.6. Pinnacle/Miro DC10+
        • 9.1.13.2.7. Pinnacle/Miro DC10(旧)
        • 9.1.13.2.8. Pinnacle/Miro DC30
        • 9.1.13.2.9. Pinnacle/Miro DC30+
      • 9.1.13.3. 1.1 电视解码器能做什么和不能做什么
        • 9.1.13.3.1. Philips saa7111 电视解码器
        • 9.1.13.3.2. Philips saa7110a 电视解码器
        • 9.1.13.3.3. Philips saa7114 电视解码器
        • 9.1.13.3.4. Brooktree bt819 电视解码器
        • 9.1.13.3.5. Micronas vpx3220a 电视解码器
        • 9.1.13.3.6. Samsung ks0127 电视解码器
      • 9.1.13.4. 电视编码器能做什么和不能做什么
        • 9.1.13.4.1. Philips saa7185 电视编码器
        • 9.1.13.4.2. Brooktree bt856 电视编码器
        • 9.1.13.4.3. Analog Devices adv7170 电视编码器
        • 9.1.13.4.4. Analog Devices adv7175 电视编码器
        • 9.1.13.4.5. ITT mse3000 电视编码器
        • 9.1.13.4.6. Conexant bt866 电视编码器
      • 9.1.13.5. 我如何让这个该死的东西工作起来
      • 9.1.13.6. 我应该使用什么主板（或者为什么我的卡无法工作）
      • 9.1.13.7. 编程接口
      • 9.1.13.8. 应用
      • 9.1.13.9. 关于缓冲区大小、质量、输出大小等
      • 9.1.13.10. 它挂起/崩溃/失败/随便什么！救命啊！
      • 9.1.13.11. 维护者/联系方式
      • 9.1.13.12. 驱动程序许可
    • 9.1.14. MIPI CCS 摄像头传感器驱动程序
      • 9.1.14.1. CCS 静态数据
        • 9.1.14.1.1. CCS 工具
      • 9.1.14.2. 寄存器定义生成器
        • 9.1.14.2.1. 用法
    • 9.1.15. CCS PLL 计算器
    • 9.1.16. Intel IPU6 驱动程序
      • 9.1.16.1. 概述
      • 9.1.16.2. 支撑
        • 9.1.16.2.1. ISYS 和 PSYS 电源流
        • 9.1.16.2.2. 中断
        • 9.1.16.2.3. 安全性和固件身份验证
        • 9.1.16.2.4. 全局计时器同步
      • 9.1.16.3. DMA 和 MMU
      • 9.1.16.4. 固件文件格式
      • 9.1.16.5. Syscom 接口
      • 9.1.16.6. 输入系统
        • 9.1.16.6.1. D-PHY 和 CSI-2 端口通道映射
        • 9.1.16.6.2. ISYS 固件 ABI
  • 9.2. 数字电视驱动程序
    • 9.2.1. dvb-usb-framework 背后的想法
      • 9.2.1.1. 支持的设备
      • 9.2.1.2. 如何使用？
        • 9.2.1.2.1. 固件
        • 9.2.1.2.2. 编译
        • 9.2.1.2.3. 加载驱动程序
      • 9.2.1.3. 已知问题和错误
        • 9.2.1.3.1. 添加设备支持
        • 9.2.1.3.2. USB1.1 带宽限制
        • 9.2.1.3.3. 评论
      • 9.2.1.4. 3. 致谢
    • 9.2.2. 前端驱动程序
      • 9.2.2.1. 前端附加头文件
    • 9.2.3. vidtv：虚拟数字电视驱动程序
      • 9.2.3.1. 背景
      • 9.2.3.2. 构建 vidtv
      • 9.2.3.3. 运行 vidtv
      • 9.2.3.4. vidtv 的命令行参数
      • 9.2.3.5. vidtv 内部结构
      • 9.2.3.6. 使用 v4l-utils 测试 vidtv
        • 9.2.3.6.1. 使用 dvb-fe-tool
        • 9.2.3.6.2. 使用 dvb-scan
        • 9.2.3.6.3. 使用 dvb-zap
      • 9.2.3.7. vidtv 中仍有哪些可以改进的地方
        • 9.2.3.7.1. 添加 debugfs 集成
        • 9.2.3.7.2. 添加一种测试视频的方法
        • 9.2.3.7.3. 添加白噪声模拟
      • 9.2.3.8. vidtv 中使用的函数和结构体
    • 9.2.4. 贡献者

版权 © 2009-2020 : LinuxTV 开发者

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.