第二部分 - 数字电视 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 Annex 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. 数字电视条件接收设备
  • 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 props 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 的初始修订。