라디오 인터페이스 | Linux 6.18.37

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

1. 요약·해설

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

요약·해설

dev-radio.rst:1-52

AM/FM radio 노드는 index 0 tuner 또는 modulator로 주파수를 관리하며, 영상·overlay·streaming parameter API를 지원하지 않는 간결한 V4L2 장치 모델입니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later

3 .. _radio:

5 ***************

6 Radio Interface

7 ***************

9 This interface is intended for AM and FM (analog) radio receivers and

10 transmitters.

12 Conventionally V4L2 radio devices are accessed through character device

13 special files named ``/dev/radio`` and ``/dev/radio0`` to

14 ``/dev/radio63`` with major number 81 and minor numbers 64 to 127.

17 Querying Capabilities

18 =====================

20 Devices supporting the radio interface set the ``V4L2_CAP_RADIO`` and

21 ``V4L2_CAP_TUNER`` or ``V4L2_CAP_MODULATOR`` flag in the

22 ``capabilities`` field of struct

23 :c:type:`v4l2_capability` returned by the

24 :ref:`VIDIOC_QUERYCAP` ioctl. Other combinations of

25 capability flags are reserved for future extensions.

28 Supplemental Functions

29 ======================

31 Radio devices can support :ref:`controls <control>`, and must support

32 the :ref:`tuner or modulator <tuner>` ioctls.

34 They do not support the video input or output, audio input or output,

35 video standard, cropping and scaling, compression and streaming

36 parameter, or overlay ioctls. All other ioctls and I/O methods are

37 reserved for future extensions.

40 Programming

41 ===========

43 Radio devices may have a couple audio controls (as discussed in

44 :ref:`control`) such as a volume control, possibly custom controls.

45 Further all radio devices have one tuner or modulator (these are

46 discussed in :ref:`tuner`) with index number zero to select the radio

47 frequency and to determine if a monaural or FM stereo program is

48 received/emitted. Drivers switch automatically between AM and FM

49 depending on the selected frequency. The

50 :ref:`VIDIOC_G_TUNER <VIDIOC_G_TUNER>` or

51 :ref:`VIDIOC_G_MODULATOR <VIDIOC_G_MODULATOR>` ioctl reports the

52 supported frequency range.

3. 한국어 전문 번역

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

AM/FM 라디오 장치와 노드

1-16

Radio 인터페이스는 AM과 FM 아날로그 라디오 수신기 및 송신기를 위한 V4L2 인터페이스입니다. 영상 장치가 아니라 주파수와 오디오 관련 control을 다루는 radio 전용 장치 모델입니다.

관례적으로 장치는 major 81, minor 64부터 127을 사용하고 `/dev/radio`, `/dev/radio0`부터 `/dev/radio63`까지의 character device special file로 노출됩니다.

Radio 장치 노드

항목설명

기본 이름/dev/radio

번호 이름/dev/radio0 ... /dev/radio63

Major81

Minor64 ... 127

V4L2 radio 장치의 전통적인 번호와 이름입니다.

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

.. _radio:

***************
Radio Interface
***************

This interface is intended for AM and FM (analog) radio receivers and
transmitters.

Conventionally V4L2 radio devices are accessed through character device
special files named ``/dev/radio`` and ``/dev/radio0`` to
``/dev/radio63`` with major number 81 and minor numbers 64 to 127.

Capability와 지원하지 않는 기능

17-39

Radio 인터페이스를 지원하면 `VIDIOC_QUERYCAP`가 반환한 `struct v4l2_capability.capabilities`에 `V4L2_CAP_RADIO`와 함께 수신기용 `V4L2_CAP_TUNER` 또는 송신기용 `V4L2_CAP_MODULATOR`를 설정합니다. 그 밖의 capability 조합은 향후 확장을 위해 예약되어 있습니다.

Radio 장치는 control을 지원할 수 있고 tuner 또는 modulator ioctl은 반드시 지원해야 합니다. 반대로 video input/output, audio input/output, video standard, cropping/scaling, compression, streaming parameter, overlay ioctl은 지원하지 않습니다. 여기에 명시되지 않은 다른 ioctl과 I/O 방식도 향후 확장용입니다.

Radio capability 조합

항목설명

수신기V4L2_CAP_RADIO + V4L2_CAP_TUNER

송신기V4L2_CAP_RADIO + V4L2_CAP_MODULATOR

ControlVolume 또는 장치 고유 control을 선택적으로 지원

예약그 밖의 capability 조합과 I/O 방식은 향후 확장용

수신과 송신 역할에 따라 필수 flag가 달라집니다.

Radio에서 제외되는 API

항목설명

VideoInput/output 및 video standard 미지원

Audio routingAudio input/output ioctl 미지원

GeometryCropping과 scaling 미지원

Data pathCompression, streaming parameter, overlay 미지원

영상 처리 경로의 ioctl은 radio 장치에 적용하지 않습니다.

Querying Capabilities
=====================

Devices supporting the radio interface set the ``V4L2_CAP_RADIO`` and
``V4L2_CAP_TUNER`` or ``V4L2_CAP_MODULATOR`` flag in the
``capabilities`` field of struct
:c:type:`v4l2_capability` returned by the
:ref:`VIDIOC_QUERYCAP` ioctl. Other combinations of
capability flags are reserved for future extensions.


Supplemental Functions
======================

Radio devices can support :ref:`controls <control>`, and must support
the :ref:`tuner or modulator <tuner>` ioctls.

They do not support the video input or output, audio input or output,
video standard, cropping and scaling, compression and streaming
parameter, or overlay ioctls. All other ioctls and I/O methods are
reserved for future extensions.

주파수와 mono/stereo 제어

40-52

Radio 장치에는 volume 같은 소수의 audio control과 장치 고유 control이 있을 수 있습니다. 모든 장치는 index 0인 tuner 또는 modulator 하나를 가지며, 이 객체로 radio frequency를 선택하고 mono 또는 FM stereo 프로그램의 수신·송신 상태를 다룹니다.

AM과 FM 전환은 선택한 주파수에 따라 드라이버가 자동으로 수행합니다. 지원 주파수 범위는 수신기에서 `VIDIOC_G_TUNER`, 송신기에서 `VIDIOC_G_MODULATOR`로 조회합니다.

Radio 설정 흐름

VIDIOC_QUERYCAP로 tuner 또는 modulator 역할 확인Index 0 tuner/modulator 조회VIDIOC_G_TUNER 또는 VIDIOC_G_MODULATOR로 범위 확인지원 범위 안에서 radio frequency 선택Driver가 주파수에 따라 AM/FM 자동 전환Mono 또는 FM stereo 상태 확인

장치 역할을 확인하고 index 0 객체에서 주파수를 선택합니다.

Programming
===========

Radio devices may have a couple audio controls (as discussed in
:ref:`control`) such as a volume control, possibly custom controls.
Further all radio devices have one tuner or modulator (these are
discussed in :ref:`tuner`) with index number zero to select the radio
frequency and to determine if a monaural or FM stereo program is
received/emitted. Drivers switch automatically between AM and FM
depending on the selected frequency. The
:ref:`VIDIOC_G_TUNER <VIDIOC_G_TUNER>` or
:ref:`VIDIOC_G_MODULATOR <VIDIOC_G_MODULATOR>` ioctl reports the
supported frequency range.