媒體子系統核心內部 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.2.3. .enable_streams() 和 .disable_streams() 回撥
    • 7.2.4. 停止傳送器
  • 7.3. CSI-2 傳送器驅動程式
    • 7.3.1. 畫素速率
    • 7.3.2. LP-11 和 LP-111 狀態
• 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. Samsung 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(new)
        • 9.1.13.2.6. Pinnacle/Miro DC10+
        • 9.1.13.2.7. Pinnacle/Miro DC10(old)
        • 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. Buttress
        • 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.