第二部分 - 數字電視 API

注意

此 API 也被稱為 Linux DVB API。

它最初是為了支援歐洲數字電視標準 (DVB) 而編寫的，後來擴充套件到支援所有數字電視標準。

為避免混淆，在本檔案中，我們選擇將其及相關硬體稱為 數字電視。

單詞 DVB 保留用於：

• 數字電視 API 版本（例如 DVB API 版本 3 或 DVB API 版本 5）；

• 數字電視資料型別（列舉、結構體、定義等）；

• 數字電視裝置節點（/dev/dvb/...）；

• 歐洲 DVB 標準。

版本 5.10

目錄

• 1. 介紹
  • 1.1. 您需要了解的
  • 1.2. 歷史
  • 1.3. 概述
  • 1.4. Linux 數字電視裝置
  • 1.5. API 包含檔案
• 2. 數字電視前端 API
  • 2.1. 查詢前端資訊
  • 2.2. 查詢前端狀態和統計
  • 2.3. 屬性型別
    • 2.3.1. 數字電視屬性引數
      • 2.3.1.1. DTV_UNDEFINED
      • 2.3.1.2. DTV_TUNE
      • 2.3.1.3. DTV_CLEAR
      • 2.3.1.4. DTV_FREQUENCY
      • 2.3.1.5. DTV_MODULATION
      • 2.3.1.6. DTV_BANDWIDTH_HZ
      • 2.3.1.7. DTV_INVERSION
      • 2.3.1.8. DTV_DISEQC_MASTER
      • 2.3.1.9. DTV_SYMBOL_RATE
      • 2.3.1.10. DTV_INNER_FEC
      • 2.3.1.11. DTV_VOLTAGE
      • 2.3.1.12. DTV_TONE
      • 2.3.1.13. DTV_PILOT
      • 2.3.1.14. DTV_ROLLOFF
      • 2.3.1.15. DTV_DISEQC_SLAVE_REPLY
      • 2.3.1.16. DTV_FE_CAPABILITY_COUNT
      • 2.3.1.17. DTV_FE_CAPABILITY
      • 2.3.1.18. DTV_DELIVERY_SYSTEM
      • 2.3.1.19. DTV_ISDBT_PARTIAL_RECEPTION
      • 2.3.1.20. DTV_ISDBT_SOUND_BROADCASTING
      • 2.3.1.21. DTV_ISDBT_SB_SUBCHANNEL_ID
      • 2.3.1.22. DTV_ISDBT_SB_SEGMENT_IDX
      • 2.3.1.23. DTV_ISDBT_SB_SEGMENT_COUNT
      • 2.3.1.24. DTV-ISDBT-LAYER[A-C] 引數
        • 2.3.1.24.1. DTV_ISDBT_LAYER_ENABLED
        • 2.3.1.24.2. DTV_ISDBT_LAYER[A-C]_FEC
        • 2.3.1.24.3. DTV_ISDBT_LAYER[A-C]_MODULATION
        • 2.3.1.24.4. DTV_ISDBT_LAYER[A-C]_SEGMENT_COUNT
        • 2.3.1.24.5. DTV_ISDBT_LAYER[A-C]_TIME_INTERLEAVING
        • 2.3.1.24.6. DTV_ATSCMH_FIC_VER
        • 2.3.1.24.7. DTV_ATSCMH_PARADE_ID
        • 2.3.1.24.8. DTV_ATSCMH_NOG
        • 2.3.1.24.9. DTV_ATSCMH_TNOG
        • 2.3.1.24.10. DTV_ATSCMH_SGN
        • 2.3.1.24.11. DTV_ATSCMH_PRC
        • 2.3.1.24.12. DTV_ATSCMH_RS_FRAME_MODE
        • 2.3.1.24.13. DTV_ATSCMH_RS_FRAME_ENSEMBLE
        • 2.3.1.24.14. DTV_ATSCMH_RS_CODE_MODE_PRI
        • 2.3.1.24.15. DTV_ATSCMH_RS_CODE_MODE_SEC
        • 2.3.1.24.16. DTV_ATSCMH_SCCC_BLOCK_MODE
        • 2.3.1.24.17. DTV_ATSCMH_SCCC_CODE_MODE_A
        • 2.3.1.24.18. DTV_ATSCMH_SCCC_CODE_MODE_B
        • 2.3.1.24.19. DTV_ATSCMH_SCCC_CODE_MODE_C
        • 2.3.1.24.20. DTV_ATSCMH_SCCC_CODE_MODE_D
      • 2.3.1.25. DTV_API_VERSION
      • 2.3.1.26. DTV_CODE_RATE_HP
      • 2.3.1.27. DTV_CODE_RATE_LP
      • 2.3.1.28. DTV_GUARD_INTERVAL
      • 2.3.1.29. DTV_TRANSMISSION_MODE
      • 2.3.1.30. DTV_HIERARCHY
      • 2.3.1.31. DTV_STREAM_ID
      • 2.3.1.32. DTV_DVBT2_PLP_ID_LEGACY
      • 2.3.1.33. DTV_ENUM_DELSYS
      • 2.3.1.34. DTV_INTERLEAVING
      • 2.3.1.35. DTV_LNA
      • 2.3.1.36. DTV_SCRAMBLING_SEQUENCE_INDEX
    • 2.3.2. 前端統計指標
      • 2.3.2.1. DTV_STAT_SIGNAL_STRENGTH
      • 2.3.2.2. DTV_STAT_CNR
      • 2.3.2.3. DTV_STAT_PRE_ERROR_BIT_COUNT
      • 2.3.2.4. DTV_STAT_PRE_TOTAL_BIT_COUNT
      • 2.3.2.5. DTV_STAT_POST_ERROR_BIT_COUNT
      • 2.3.2.6. DTV_STAT_POST_TOTAL_BIT_COUNT
      • 2.3.2.7. DTV_STAT_ERROR_BLOCK_COUNT
      • 2.3.2.8. DTV-STAT_TOTAL_BLOCK_COUNT
    • 2.3.3. 地面傳輸系統使用的屬性
      • 2.3.3.1. DVB-T 傳輸系統
      • 2.3.3.2. DVB-T2 傳輸系統
      • 2.3.3.3. ISDB-T 傳輸系統
      • 2.3.3.4. ATSC 傳輸系統
      • 2.3.3.5. ATSC-MH 傳輸系統
      • 2.3.3.6. DTMB 傳輸系統
    • 2.3.4. 有線傳輸系統使用的屬性
      • 2.3.4.1. DVB-C 傳輸系統
      • 2.3.4.2. DVB-C 附錄 B 傳輸系統
    • 2.3.5. 衛星傳輸系統使用的屬性
      • 2.3.5.1. DVB-S 傳輸系統
      • 2.3.5.2. DVB-S2 傳輸系統
      • 2.3.5.3. Turbo 碼傳輸系統
      • 2.3.5.4. ISDB-S 傳輸系統
    • 2.3.6. 前端 uAPI 資料型別
  • 2.4. 前端函式呼叫
    • 2.4.1. 數字電視前端 open()
      • 2.4.1.1. 名稱
      • 2.4.1.2. 概要
      • 2.4.1.3. 引數
      • 2.4.1.4. 描述
      • 2.4.1.5. 返回值
    • 2.4.2. 數字電視前端 close()
      • 2.4.2.1. 名稱
      • 2.4.2.2. 概要
      • 2.4.2.3. 引數
      • 2.4.2.4. 描述
      • 2.4.2.5. 返回值
    • 2.4.3. ioctl FE_GET_INFO
      • 2.4.3.1. 名稱
      • 2.4.3.2. 概要
      • 2.4.3.3. 引數
      • 2.4.3.4. 描述
      • 2.4.3.5. 前端功能
      • 2.4.3.6. 返回值
    • 2.4.4. ioctl FE_READ_STATUS
      • 2.4.4.1. 名稱
      • 2.4.4.2. 概要
      • 2.4.4.3. 引數
      • 2.4.4.4. 描述
      • 2.4.4.5. int fe_status
      • 2.4.4.6. 返回值
    • 2.4.5. ioctl FE_SET_PROPERTY, FE_GET_PROPERTY
      • 2.4.5.1. 名稱
      • 2.4.5.2. 概要
      • 2.4.5.3. 引數
      • 2.4.5.4. 描述
      • 2.4.5.5. 返回值
    • 2.4.6. ioctl FE_DISEQC_RESET_OVERLOAD
      • 2.4.6.1. 名稱
      • 2.4.6.2. 概要
      • 2.4.6.3. 引數
      • 2.4.6.4. 描述
      • 2.4.6.5. 返回值
    • 2.4.7. ioctl FE_DISEQC_SEND_MASTER_CMD
      • 2.4.7.1. 名稱
      • 2.4.7.2. 概要
      • 2.4.7.3. 引數
      • 2.4.7.4. 描述
      • 2.4.7.5. 返回值
    • 2.4.8. ioctl FE_DISEQC_RECV_SLAVE_REPLY
      • 2.4.8.1. 名稱
      • 2.4.8.2. 概要
      • 2.4.8.3. 引數
      • 2.4.8.4. 描述
      • 2.4.8.5. 返回值
    • 2.4.9. ioctl FE_DISEQC_SEND_BURST
      • 2.4.9.1. 名稱
      • 2.4.9.2. 概要
      • 2.4.9.3. 引數
      • 2.4.9.4. 描述
      • 2.4.9.5. 返回值
    • 2.4.10. ioctl FE_SET_TONE
      • 2.4.10.1. 名稱
      • 2.4.10.2. 概要
      • 2.4.10.3. 引數
      • 2.4.10.4. 描述
      • 2.4.10.5. 返回值
    • 2.4.11. ioctl FE_SET_VOLTAGE
      • 2.4.11.1. 名稱
      • 2.4.11.2. 概要
      • 2.4.11.3. 引數
      • 2.4.11.4. 描述
      • 2.4.11.5. 返回值
    • 2.4.12. ioctl FE_ENABLE_HIGH_LNB_VOLTAGE
      • 2.4.12.1. 名稱
      • 2.4.12.2. 概要
      • 2.4.12.3. 引數
      • 2.4.12.4. 描述
      • 2.4.12.5. 返回值
    • 2.4.13. ioctl FE_SET_FRONTEND_TUNE_MODE
      • 2.4.13.1. 名稱
      • 2.4.13.2. 概要
      • 2.4.13.3. 引數
      • 2.4.13.4. 描述
      • 2.4.13.5. 返回值
• 3. 數字電視複用器裝置
  • 3.1. 複用器資料型別
  • 3.2. 複用器函式呼叫
    • 3.2.1. 數字電視複用器 open()
      • 3.2.1.1. 名稱
      • 3.2.1.2. 概要
      • 3.2.1.3. 引數
      • 3.2.1.4. 描述
      • 3.2.1.5. 返回值
    • 3.2.2. 數字電視複用器 close()
      • 3.2.2.1. 名稱
      • 3.2.2.2. 概要
      • 3.2.2.3. 引數
      • 3.2.2.4. 描述
      • 3.2.2.5. 返回值
    • 3.2.3. 數字電視複用器 read()
      • 3.2.3.1. 名稱
      • 3.2.3.2. 概要
      • 3.2.3.3. 引數
      • 3.2.3.4. 描述
      • 3.2.3.5. 返回值
    • 3.2.4. 數字電視複用器 write()
      • 3.2.4.1. 名稱
      • 3.2.4.2. 概要
      • 3.2.4.3. 引數
      • 3.2.4.4. 描述
      • 3.2.4.5. 返回值
    • 3.2.5. 數字電視 mmap()
      • 3.2.5.1. 名稱
      • 3.2.5.2. 概要
      • 3.2.5.3. 引數
      • 3.2.5.4. 描述
      • 3.2.5.5. 返回值
    • 3.2.6. DVB munmap()
      • 3.2.6.1. 名稱
      • 3.2.6.2. 概要
      • 3.2.6.3. 引數
      • 3.2.6.4. 描述
      • 3.2.6.5. 返回值
    • 3.2.7. DMX_START
      • 3.2.7.1. 名稱
      • 3.2.7.2. 概要
      • 3.2.7.3. 引數
      • 3.2.7.4. 描述
      • 3.2.7.5. 返回值
    • 3.2.8. DMX_STOP
      • 3.2.8.1. 名稱
      • 3.2.8.2. 概要
      • 3.2.8.3. 引數
      • 3.2.8.4. 描述
      • 3.2.8.5. 返回值
    • 3.2.9. DMX_SET_FILTER
      • 3.2.9.1. 名稱
      • 3.2.9.2. 概要
      • 3.2.9.3. 引數
      • 3.2.9.4. 描述
      • 3.2.9.5. 返回值
    • 3.2.10. DMX_SET_PES_FILTER
      • 3.2.10.1. 名稱
      • 3.2.10.2. 概要
      • 3.2.10.3. 引數
      • 3.2.10.4. 描述
      • 3.2.10.5. 返回值
    • 3.2.11. DMX_SET_BUFFER_SIZE
      • 3.2.11.1. 名稱
      • 3.2.11.2. 概要
      • 3.2.11.3. 引數
      • 3.2.11.4. 描述
      • 3.2.11.5. 返回值
    • 3.2.12. DMX_GET_STC
      • 3.2.12.1. 名稱
      • 3.2.12.2. 概要
      • 3.2.12.3. 引數
      • 3.2.12.4. 描述
      • 3.2.12.5. 返回值
    • 3.2.13. DMX_GET_PES_PIDS
      • 3.2.13.1. 名稱
      • 3.2.13.2. 概要
      • 3.2.13.3. 引數
      • 3.2.13.4. 描述
      • 3.2.13.5. 返回值
    • 3.2.14. DMX_ADD_PID
      • 3.2.14.1. 名稱
      • 3.2.14.2. 概要
      • 3.2.14.3. 引數
      • 3.2.14.4. 描述
      • 3.2.14.5. 返回值
    • 3.2.15. DMX_REMOVE_PID
      • 3.2.15.1. 名稱
      • 3.2.15.2. 概要
      • 3.2.15.3. 引數
      • 3.2.15.4. 描述
      • 3.2.15.5. 返回值
    • 3.2.16. ioctl DMX_REQBUFS
      • 3.2.16.1. 名稱
      • 3.2.16.2. 概要
      • 3.2.16.3. 引數
      • 3.2.16.4. 描述
      • 3.2.16.5. 返回值
    • 3.2.17. ioctl DMX_QUERYBUF
      • 3.2.17.1. 名稱
      • 3.2.17.2. 概要
      • 3.2.17.3. 引數
      • 3.2.17.4. 描述
      • 3.2.17.5. 返回值
    • 3.2.18. ioctl DMX_EXPBUF
      • 3.2.18.1. 名稱
      • 3.2.18.2. 概要
      • 3.2.18.3. 引數
      • 3.2.18.4. 描述
      • 3.2.18.5. 示例
      • 3.2.18.6. 返回值
    • 3.2.19. ioctl DMX_QBUF, DMX_DQBUF
      • 3.2.19.1. 名稱
      • 3.2.19.2. 概要
      • 3.2.19.3. 引數
      • 3.2.19.4. 描述
      • 3.2.19.5. 返回值
• 4. 數字電視 CA 裝置
  • 4.1. CA 資料型別
  • 4.2. CA 函式呼叫
    • 4.2.1. 數字電視 CA open()
      • 4.2.1.1. 名稱
      • 4.2.1.2. 概要
      • 4.2.1.3. 引數
      • 4.2.1.4. 描述
      • 4.2.1.5. 返回值
    • 4.2.2. 數字電視 CA close()
      • 4.2.2.1. 名稱
      • 4.2.2.2. 概要
      • 4.2.2.3. 引數
      • 4.2.2.4. 描述
      • 4.2.2.5. 返回值
    • 4.2.3. CA_RESET
      • 4.2.3.1. 名稱
      • 4.2.3.2. 概要
      • 4.2.3.3. 引數
      • 4.2.3.4. 描述
      • 4.2.3.5. 返回值
    • 4.2.4. CA_GET_CAP
      • 4.2.4.1. 名稱
      • 4.2.4.2. 概要
      • 4.2.4.3. 引數
      • 4.2.4.4. 描述
      • 4.2.4.5. 返回值
    • 4.2.5. CA_GET_SLOT_INFO
      • 4.2.5.1. 名稱
      • 4.2.5.2. 概要
      • 4.2.5.3. 引數
      • 4.2.5.4. 描述
      • 4.2.5.5. 返回值
    • 4.2.6. CA_GET_DESCR_INFO
      • 4.2.6.1. 名稱
      • 4.2.6.2. 概要
      • 4.2.6.3. 引數
      • 4.2.6.4. 描述
      • 4.2.6.5. 返回值
    • 4.2.7. CA_GET_MSG
      • 4.2.7.1. 名稱
      • 4.2.7.2. 概要
      • 4.2.7.3. 引數
      • 4.2.7.4. 描述
      • 4.2.7.5. 返回值
    • 4.2.8. CA_SEND_MSG
      • 4.2.8.1. 名稱
      • 4.2.8.2. 概要
      • 4.2.8.3. 引數
      • 4.2.8.4. 描述
      • 4.2.8.5. 返回值
    • 4.2.9. CA_SET_DESCR
      • 4.2.9.1. 名稱
      • 4.2.9.2. 概要
      • 4.2.9.3. 引數
      • 4.2.9.4. 描述
      • 4.2.9.5. 返回值
  • 4.3. 高階 CI API
    • 4.3.1. 為什麼需要另一個 CI 介面？
• 5. 數字電視網路 API
  • 5.1. 數字電視網路函式呼叫
    • 5.1.1. 網路資料型別
    • 5.1.2. ioctl NET_ADD_IF
      • 5.1.2.1. 名稱
      • 5.1.2.2. 概要
      • 5.1.2.3. 引數
      • 5.1.2.4. 描述
      • 5.1.2.5. 返回值
    • 5.1.3. ioctl NET_REMOVE_IF
      • 5.1.3.1. 名稱
      • 5.1.3.2. 概要
      • 5.1.3.3. 引數
      • 5.1.3.4. 描述
      • 5.1.3.5. 返回值
    • 5.1.4. ioctl NET_GET_IF
      • 5.1.4.1. 名稱
      • 5.1.4.2. 概要
      • 5.1.4.3. 引數
      • 5.1.4.4. 描述
      • 5.1.4.5. 返回值
• 6. 數字電視已棄用 API
  • 6.1. 數字電視前端舊版 API（亦稱 DVBv3）
    • 6.1.1. 前端舊版資料型別
      • 6.1.1.1. 前端型別
      • 6.1.1.2. 前端頻寬
      • 6.1.1.3. 前端引數
        • 6.1.1.3.1. QPSK 引數
        • 6.1.1.3.2. QAM 引數
        • 6.1.1.3.3. VSB 引數
        • 6.1.1.3.4. OFDM 引數
      • 6.1.1.4. 前端事件
    • 6.1.2. 前端舊版函式呼叫
      • 6.1.2.1. FE_READ_BER
        • 6.1.2.1.1. 名稱
        • 6.1.2.1.2. 概要
        • 6.1.2.1.3. 引數
        • 6.1.2.1.4. 描述
        • 6.1.2.1.5. 返回值
      • 6.1.2.2. FE_READ_SNR
        • 6.1.2.2.1. 名稱
        • 6.1.2.2.2. 概要
        • 6.1.2.2.3. 引數
        • 6.1.2.2.4. 描述
        • 6.1.2.2.5. 返回值
      • 6.1.2.3. FE_READ_SIGNAL_STRENGTH
        • 6.1.2.3.1. 名稱
        • 6.1.2.3.2. 概要
        • 6.1.2.3.3. 引數
        • 6.1.2.3.4. 描述
        • 6.1.2.3.5. 返回值
      • 6.1.2.4. FE_READ_UNCORRECTED_BLOCKS
        • 6.1.2.4.1. 名稱
        • 6.1.2.4.2. 概要
        • 6.1.2.4.3. 引數
        • 6.1.2.4.4. 描述
        • 6.1.2.4.5. 返回值
      • 6.1.2.5. FE_SET_FRONTEND
        • 6.1.2.5.1. 名稱
        • 6.1.2.5.2. 概要
        • 6.1.2.5.3. 引數
        • 6.1.2.5.4. 描述
        • 6.1.2.5.5. 返回值
      • 6.1.2.6. FE_GET_FRONTEND
        • 6.1.2.6.1. 名稱
        • 6.1.2.6.2. 概要
        • 6.1.2.6.3. 引數
        • 6.1.2.6.4. 描述
        • 6.1.2.6.5. 返回值
      • 6.1.2.7. FE_GET_EVENT
        • 6.1.2.7.1. 名稱
        • 6.1.2.7.2. 概要
        • 6.1.2.7.3. 引數
        • 6.1.2.7.4. 描述
        • 6.1.2.7.5. 返回值
      • 6.1.2.8. FE_DISHNETWORK_SEND_LEGACY_CMD
        • 6.1.2.8.1. 名稱
        • 6.1.2.8.2. 概要
        • 6.1.2.8.3. 引數
        • 6.1.2.8.4. 描述
        • 6.1.2.8.5. 返回值
  • 6.2. 舊版 DVB MPEG 解碼器 API
    • 6.2.1. 一般說明
    • 6.2.2. 資料格式
    • 6.2.3. 目錄
      • 6.2.3.1. DVB 影片裝置
        • 6.2.3.1.1. 影片資料型別
        • 6.2.3.1.2. 影片函式呼叫
      • 6.2.3.2. DVB 音訊裝置
        • 6.2.3.2.1. 音訊資料型別
        • 6.2.3.2.2. 音訊函式呼叫
      • 6.2.3.3. DVB OSD 裝置
        • 6.2.3.3.1. OSD 資料型別
        • 6.2.3.3.2. OSD 函式呼叫
• 7. 示例
• 8. 數字電視 uAPI 標頭檔案
  • 8.1. 數字電視 uAPI 標頭檔案
    • 8.1.1. frontend.h
    • 8.1.2. dmx.h
    • 8.1.3. ca.h
    • 8.1.4. net.h

修訂和版權

作者

• 10. 11. Metzler, Ralph <rjkm@metzlerbros.de>

• 數字電視 API 文件的原始作者。

• 15. 3. Metzler, Marcus <rjkm@metzlerbros.de>

• 數字電視 API 文件的原始作者。

• Carvalho Chehab, Mauro <mchehab+samsung@kernel.org>

• 將文件移植到 Docbook XML，新增 DVBv5 API，修復文件空白。

版權所有 © 2002-2003 : Convergence GmbH

版權所有 © 2009-2017 : Mauro Carvalho Chehab

修訂歷史

修訂版本:

2.2.0 / 2017-09-01 (mcc)

非舊版 API 的 uAPI 文件與核心實現之間的大多數空白已修復。

修訂版本:

2.1.0 / 2015-05-29 (mcc)

DocBook 改進和清理，以便以更標準的方式記錄系統呼叫並提供有關當前數字電視 API 的更多描述。

修訂版本:

2.0.4 / 2011-05-06 (mcc)

添加了更多關於 DVBv5 API 的資訊，更好地描述了前端 GET/SET 屬性 ioctl。

修訂版本:

2.0.3 / 2010-07-03 (mcc)

添加了一些核心中存在但規範中缺失的前端功能標誌。

修訂版本:

2.0.2 / 2009-10-25 (mcc)

文件化了 FE_SET_FRONTEND_TUNE_MODE 和 FE_DISHETWORK_SEND_LEGACY_CMD ioctl。

修訂版本:

2.0.1 / 2009-09-16 (mcc)

添加了最初由 Patrick Boettcher 編寫的 ISDB-T 測試。

修訂版本:

2.0.0 / 2009-09-06 (mcc)

從 LaTeX 轉換為 DocBook XML。內容與原始 LaTeX 版本相同。

修訂版本:

1.0.0 / 2003-07-24 (rjkm)

LaTeX 中的初始修訂。