← Documents Documentation/userspace-api/media/dvb/legacy_dvb_decoder_api.rst GitHub 원문 ↗

Linux 6.18.37 · Userspace API / Media / DVB / Legacy decoder

Legacy DVB MPEG Decoder APIs

Legacy decoder format의 한계와 V4L2·ALSA·Media Controller 대체 경로를 설명합니다.

Source pathDocumentation/userspace-api/media/dvb/legacy_dvb_decoder_api.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약·해설

legacy_dvb_decoder_api.rst:1-61

ISO/IEC 13818-1 계열 stream만 지원하는 호환성 API입니다. 새 driver는 V4L2·ALSA를 사용하고 pipeline은 Media Controller로 구성해야 합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later OR GPL-2.0
2
3 .. _legacy_dvb_decoder_api:
4
5 ============================
6 Legacy DVB MPEG Decoder APIs
7 ============================
8
9 .. _legacy_dvb_decoder_notes:
10
11 General Notes
12 =============
13
14 This API has originally been designed for DVB only and is therefore limited to
15 the :ref:`legacy_dvb_decoder_formats` used in such digital TV-broadcastsystems.
16
17 To circumvent this limitations the more versatile :ref:`V4L2 <v4l2spec>` API has
18 been designed. Which replaces this part of the DVB API.
19
20 Nevertheless there have been projects build around this API.
21 To ensure compatibility this API is kept as it is.
22
23 .. attention:: Do **not** use this API in new drivers!
24
25 For audio and video use the :ref:`V4L2 <v4l2spec>` and ALSA APIs.
26
27 Pipelines should be set up using the :ref:`Media Controller API<media_controller>`.
28
29 Practically the decoders seem to be treated differently. The application typically
30 knows which decoder is in use or it is specially written for one decoder type.
31 Querying capabilities are rarely used because they are already known.
32
33
34 .. _legacy_dvb_decoder_formats:
35
36 Data Formats
37 ============
38
39 The API has been designed for DVB and compatible broadcastsystems.
40 Because of that fact the only supported data formats are ISO/IEC 13818-1
41 compatible MPEG streams. The supported payloads may vary depending on the
42 used decoder.
43
44 Timestamps are always MPEG PTS as defined in ITU T-REC-H.222.0 /
45 ISO/IEC 13818-1, if not otherwise noted.
46
47 For storing recordings typically TS streams are used, in lesser extent PES.
48 Both variants are commonly accepted for playback, but it may be driver dependent.
49
50
51
52
53 Table of Contents
54 =================
55
56 .. toctree::
57 :maxdepth: 2
58
59 legacy_dvb_video
60 legacy_dvb_audio
61 legacy_dvb_osd
62

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

Legacy decoder API의 한계와 대체 API

1-33

이 API는 DVB 전용으로 설계돼 digital TV broadcast system에서 쓰는 legacy DVB decoder format으로 제한됩니다. 더 다양한 형식을 처리하기 위해 V4L2 API가 설계됐고 이 DVB API 영역을 대체합니다.

기존 프로젝트와의 호환성을 위해 API 자체는 유지되지만 새 드라이버에서는 사용하면 안 됩니다. Audio와 video는 V4L2 및 ALSA API를 사용하고 pipeline은 Media Controller API로 구성해야 합니다.

실제 응용 프로그램은 사용 중인 decoder를 미리 알고 있거나 특정 decoder type 전용으로 작성되는 경우가 많습니다. 따라서 capability 조회는 이미 알려진 정보를 되풀이하므로 거의 쓰이지 않습니다.

현대 media pipeline 전환
Video 제어는 V4L2 API로 이전Audio 제어는 ALSA 및 V4L2 API로 이전장치 간 pipeline은 Media Controller API로 구성기존 DVB API는 호환성 용도로만 유지

Legacy decoder API에서 현재 subsystem으로 옮길 때의 역할 분담입니다.

.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later OR GPL-2.0

.. _legacy_dvb_decoder_api:

============================
Legacy DVB MPEG Decoder APIs
============================

.. _legacy_dvb_decoder_notes:

General Notes
=============

This API has originally been designed for DVB only and is therefore limited to
the :ref:`legacy_dvb_decoder_formats` used in such digital TV-broadcastsystems.

To circumvent this limitations the more versatile :ref:`V4L2 <v4l2spec>` API has
been designed. Which replaces this part of the DVB API.

Nevertheless there have been projects build around this API.
To ensure compatibility this API is kept as it is.

.. attention:: Do **not** use this API in new drivers!

    For audio and video use the :ref:`V4L2 <v4l2spec>` and ALSA APIs.

    Pipelines should be set up using the :ref:`Media Controller  API<media_controller>`.

Practically the decoders seem to be treated differently. The application typically
knows which decoder is in use or it is specially written for one decoder type.
Querying capabilities are rarely used because they are already known.

지원 stream 형식과 하위 문서

34-61

DVB 및 호환 broadcast system을 대상으로 하므로 지원 data format은 ISO/IEC 13818-1 호환 MPEG stream으로 제한됩니다. 실제 payload 지원 범위는 decoder에 따라 다릅니다.

별도 언급이 없으면 timestamp는 ITU T-REC-H.222.0 / ISO/IEC 13818-1에 정의된 MPEG PTS입니다. 녹화 저장에는 주로 TS를 쓰고 PES도 일부 쓰며, 재생 시 두 형식 모두 일반적으로 받아들이지만 driver 의존성이 있습니다.

Legacy decoder 하위 문서
문서범위
legacy_dvb_videoLegacy MPEG video decoder
legacy_dvb_audioLegacy MPEG audio decoder
legacy_dvb_osdAV7110 OnScreen Display

Video, audio, OnScreen Display API를 각각 설명합니다.

.. _legacy_dvb_decoder_formats:

Data Formats
============

The API has been designed for DVB and compatible broadcastsystems.
Because of that fact the only supported data formats are ISO/IEC 13818-1
compatible MPEG streams. The supported payloads may vary depending on the
used decoder.

Timestamps are always MPEG PTS as defined in ITU T-REC-H.222.0 /
ISO/IEC 13818-1, if not otherwise noted.

For storing recordings typically TS streams are used, in lesser extent PES.
Both variants are commonly accepted for playback, but it may be driver dependent.




Table of Contents
=================

.. toctree::
    :maxdepth: 2

    legacy_dvb_video
    legacy_dvb_audio
    legacy_dvb_osd