[v2,00/14] ASoC: add Audio Graph Card2 driver

Message

Kuninori Morimoto July 20, 2021, 1:38 a.m. UTC

Hi Mark

We already have Audio-Graph-Card which is Of-Graph base general sound
card driver. Basically it supports basic CPU-Codec connection, and is
also supporting DPCM connection. Because it was forcibly expanded to
DPCM, DT parsing is very limited and very difficult to add new features
on it, for example Multi CPU/Codec support, Codec2Codec support, etc.

And some users want to use Audio-Graph-Card as basic connection and
expand/customize its own settings on it.

This patch adds more flexible new Audio-Graph-Card2 driver for it.
Audio-Graph-Card and Audio-Graph-Card2 are similar, but don't have
full compatibility.
The reason why I need Audio-Graph-Card2 instead of update Audio-Graph-Card
is that it is very difficult to keep compatibilty.

Audio-Graph-Card2 supports Normal Connection, DPCM Connection,
Multi CPU/Codec Connection, Codec2Codec Connection, and possible to
Customizing.

This patch-set adds Audio-Graph-Card2 driver and customized driver
sample, and DT settings sample which can be used for testing.

To enable testing/debuging, this patch-set also adds Test-Component
driver. We already have Dummy Component and/or Dummy DAI on soc-utils,
but 1) we can't use it from DT, 2) it do nothing.
Added new Test-Component can be used from DT, and it can indicate called
function name. We can use it to trace callback order / understanding
ALSA SoC behavior, etc.
Sample DT settings which can be used for testing is using Test-Component.

This patch set includes sample DT for custome driver and/or
audio-graph-card2. You can easily try to use/test it if you added
below line to your DT file. It needs below CONFIGs.
It will probe sample Sound Card which has Normal/DPCM/Multi/Codec2Codec
connections.

	#include "../../../../../sound/soc/generic/audio-graph-card2-sample.dtsi"

	CONFIG_SND_AUDIO_GRAPH_CARD2
	CONFIG_SND_SAMPLE_CUSTOM_CARD
	CONFIG_SND_TEST_COMPONENT

There are some notes.

Because Audio Graph Card2 is still under experimental stage, it will
indicate such warning when probing, and the DT might be updated/exchanged.

It can use Codec2Codec, but it will start automatically when probed,
and can't stop it so far. It should be updated.

 1 -  2 : add Test-Component driver
 3 -  9 : add Audio-Graph-Card2 driver
10      : add Audio-Graph-Card2 base custome driver sample
11 - 14 : Audio-Graph-Card2 driver / custome driver DT sample

Link: https://lore.kernel.org/r/[e-mail]
Link: https://lore.kernel.org/r/[e-mail]

v1 -> v2
	- don't use "port" base for_each loop

Kuninori Morimoto (14):
   1 ASoC: test-component: add Test Component YAML bindings
   2 ASoC: test-component: add Test Component for Sound debug/test
   3 ASoC: simple-card-utils: add asoc_graph_is_ports0()
   4 ASoC: simple-card-utils: add codec2codec support
   5 ASoC: audio-graph-card2: add Audio Graph Card2 driver
   6 ASoC: audio-graph-card2: add DPCM support
   7 ASoC: audio-graph-card2: add Multi CPU/Codec support
   8 ASoC: audio-graph-card2: add Codec2Codec support
   9 ASoC: audio-graph-card2: add Yaml Document
  10 ASoC: sample-custom-card: add Audio Graph Card2 custome sample
  11 ASoC: audio-graph-card2-sample.dtsi: add Sample DT for Audio Graph Card2
  12 ASoC: audio-graph-card2-sample.dtsi: add DPCM sample
  13 ASoC: audio-graph-card2-sample.dtsi: add Multi CPU/Codec sample
  14 ASoC: audio-graph-card2-sample.dtsi: add Codec2Codec sample.

 .../sound/audio-graph-card2-items.yaml        |   80 ++
 .../bindings/sound/audio-graph-card2.yaml     |   51 +
 .../bindings/sound/test-component.yaml        |   33 +
 include/sound/graph_card.h                    |   24 +
 include/sound/simple_card_utils.h             |    4 +
 sound/soc/generic/Kconfig                     |   20 +
 sound/soc/generic/Makefile                    |    6 +
 .../soc/generic/audio-graph-card2-sample.dtsi |  140 ++
 sound/soc/generic/audio-graph-card2.c         | 1252 +++++++++++++++++
 sound/soc/generic/sample-custom-card.c        |  160 +++
 sound/soc/generic/simple-card-utils.c         |   46 +-
 sound/soc/generic/test-component.c            |  659 +++++++++
 12 files changed, 2474 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/devicetree/bindings/sound/audio-graph-card2-items.yaml
 create mode 100644 Documentation/devicetree/bindings/sound/audio-graph-card2.yaml
 create mode 100644 Documentation/devicetree/bindings/sound/test-component.yaml
 create mode 100644 sound/soc/generic/audio-graph-card2-sample.dtsi
 create mode 100644 sound/soc/generic/audio-graph-card2.c
 create mode 100644 sound/soc/generic/sample-custom-card.c
 create mode 100644 sound/soc/generic/test-component.c