ASoC 플랫폼 드라이버

플랫폼 드라이버의 범위

ASoC 플랫폼 드라이버 클래스는 오디오 DMA 드라이버, SoC DAI 드라이버, DSP 드라이버로 나눌 수 있다. 플랫폼 드라이버는 SoC CPU만을 대상으로 하며 보드에 종속된 코드를 포함해서는 안 된다.

====================
ASoC Platform Driver
====================

An ASoC platform driver class can be divided into audio DMA drivers, SoC DAI
drivers and DSP drivers. The platform drivers only target the SoC CPU and must
have no board specific code.

오디오 DMA 연산과 구성 요소 드라이버

플랫폼 DMA 드라이버는 선택적으로 다음 ALSA 연산을 지원한다. `struct snd_soc_ops`의 `startup`은 스트림 시작 준비, `shutdown`은 스트림 종료 정리, `hw_params`는 하드웨어 매개변수 적용, `hw_free`는 할당된 하드웨어 자원 해제, `prepare`는 실행 직전 준비, `trigger`는 시작·정지 같은 스트림 명령 처리를 맡는다.

플랫폼 드라이버는 `struct snd_soc_component_driver`를 통해 DMA 기능을 내보낸다. `name`은 구성 요소 이름이며 `probe`와 `remove`는 구성 요소의 초기화와 제거를, `suspend`와 `resume`은 전원 관리 전환을 담당한다.

PCM 생성과 파괴를 위한 `pcm_new`와 `pcm_free`도 제공할 수 있다. `ops`는 일반 PCM 연산을 담은 `struct snd_pcm_ops`를, `compr_ops`는 압축 오디오 연산을 담은 `struct snd_compr_ops`를 가리킨다. 생략 부호로 표시된 다른 필드도 구조체에 존재하지만 원문은 DMA 설명에 필요한 부분만 발췌한다.

오디오 DMA의 자세한 내용은 `../kernel-api/writing-an-alsa-driver`의 ALSA 드라이버 문서를 참조한다. DMA 드라이버 예제는 `soc/pxa/pxa2xx-pcm.c`이다.

Audio DMA
=========

The platform DMA driver optionally supports the following ALSA operations:-
::

  /* SoC audio ops */
  struct snd_soc_ops {
	int (*startup)(struct snd_pcm_substream *);
	void (*shutdown)(struct snd_pcm_substream *);
	int (*hw_params)(struct snd_pcm_substream *, struct snd_pcm_hw_params *);
	int (*hw_free)(struct snd_pcm_substream *);
	int (*prepare)(struct snd_pcm_substream *);
	int (*trigger)(struct snd_pcm_substream *, int);
  };

The platform driver exports its DMA functionality via struct
snd_soc_component_driver:-
::

  struct snd_soc_component_driver {
	const char *name;

	...
	int (*probe)(struct snd_soc_component *);
	void (*remove)(struct snd_soc_component *);
	int (*suspend)(struct snd_soc_component *);
	int (*resume)(struct snd_soc_component *);

	/* pcm creation and destruction */
	int (*pcm_new)(struct snd_soc_pcm_runtime *);
	void (*pcm_free)(struct snd_pcm *);

	...
	const struct snd_pcm_ops *ops;
	const struct snd_compr_ops *compr_ops;
	...
  };

Please refer to the :doc:`ALSA driver documentation
<../kernel-api/writing-an-alsa-driver>` for details of audio DMA.

An example DMA driver is soc/pxa/pxa2xx-pcm.c

SoC DAI 드라이버가 제공할 기능

각 SoC DAI 드라이버는 Digital Audio Interface(DAI) 설명, DAI 구성, PCM 설명, SYSCLK 구성 기능을 제공해야 한다. 일시 중단과 복귀 기능은 선택 사항이다.

첫 번째부터 네 번째 항목의 설명은 `codec.rst`를 참조한다. 플랫폼 DAI는 코덱 DAI와 같은 형식의 능력과 설정 계약을 제공하되, SoC 쪽 디지털 오디오 인터페이스를 구현한다.

SoC DAI Drivers
===============

Each SoC DAI driver must provide the following features:-

1. Digital audio interface (DAI) description
2. Digital audio interface configuration
3. PCM's description
4. SYSCLK configuration
5. Suspend and resume (optional)

Please see codec.rst for a description of items 1 - 4.

SoC DSP 드라이버가 제공할 기능

각 SoC DSP 드라이버는 일반적으로 DAPM 그래프, 믹서 제어, 적용 가능한 경우 DSP 버퍼로 들어가고 나오는 DMA 입출력, DSP 프런트엔드(FE) PCM 장치 정의를 제공한다.

네 번째 항목에 관한 설명은 원문이 가리키는 `DPCM.txt`를 참조한다. 이 문서에서는 원문의 파일명을 그대로 보존하며, FE PCM 장치는 DSP 경로의 사용자 측 스트림 종단을 정의한다.

SoC DSP Drivers
===============

Each SoC DSP driver usually supplies the following features :-

1. DAPM graph
2. Mixer controls
3. DMA IO to/from DSP buffers (if applicable)
4. Definition of DSP front end (FE) PCM devices.

Please see DPCM.txt for a description of item 4.