driver-api/soundwire/stream.rst

24 	-------------------------
26 	-------------------------
31 	+---------------+                    Clock Signal  +---------------+
32 	|    Master     +----------------------------------+     Slave     |
36 	|    L  +  R    +----------------------------------+    L  +  R    |
38 	+---------------+  +----------------------->       +---------------+
45 	+---------------+                    Clock Signal  +---------------+
46 	|    Master     +----------------------------------+     Slave     |
50 	|    L  +  R    +----------------------------------+    L  +  R    |
52 	+---------------+  <-----------------------+       +---------------+
59 	+---------------+                    Clock Signal  +---------------+
60 	|    Master     +---------+------------------------+     Slave     |
64 	|    L  +  R    +---+------------------------------+       L       |
66 	+---------------+   |     |   +------------->      +---------------+
69 	                    |     |                        +---------------+
70 	                    |     +----------------------> |     Slave     |
74 	                    +----------------------------> |       R       |
76 	                                                   +---------------+
85 	+---------------+                    Clock Signal  +---------------+
86 	|    Master     +---------+------------------------+     Slave     |
90 	|    L  +  R    +---+------------------------------+     L + R     |
92 	+---------------+   |     |   +------------->      +---------------+
95 	                    |     |                        +---------------+
96 	                    |     +----------------------> |     Slave     |
100 	                    +----------------------------> |     L + R     |
102 	                                                   +---------------+
108 	+--------------------+
110 	|     +--------------+                             +----------------+
113 	|     |      1      |------------+                 |                |
114 	|     |  L Channel  ||           |                 +-----+----+     |
116 	| Master  +----------+           | +---+---------> ||    Port |     |
118 	|     +--------------+           |                 ||         |     |
119 	|     |             ||           |                 +----------+     |
120 	|     |  Data Port  |------------+                 |                |
124 	|     +--------------+         Clock Signal        |     L  +  R    |
125 	|                    +---------------------------> |      (Data)    |
126 	+--------------------+                             |                |
127 							   +----------------+
133 	+---------------+                    Clock Signal  +---------------+
134 	|    Master     +----------------------------------+     Slave     |
138 	|       L       +----------------------------------+       L       |
140 	+---------------+  +----------------------->       +---------------+
142 	+---------------+                    Clock Signal  +---------------+
143 	|    Master     +----------------------------------+     Slave     |
147 	|       R       +----------------------------------+       R       |
149 	+---------------+  +----------------------->       +---------------+
156 	+---------------+                    Clock Signal  +---------------+
157 	|    Master     +----------------------------------+     Slave     |
161 	|     L + R     +----------------------------------+     L + R     |
163 	+---------------+  +----------------------->       +---------------+
165 	+---------------+                    Clock Signal  +---------------+
166 	|    Master     +----------------------------------+     Slave     |
170 	|     L + R     +----------------------------------+     L + R     |
172 	+---------------+  +----------------------->       +---------------+
174 Example 8: 4-channel Stream is rendered by 2 Masters, each rendering a
177 	+---------------+                    Clock Signal  +---------------+
178 	|    Master     +----------------------------------+     Slave     |
182 	|    L1 + R1    +----------------------------------+    L1 + R1    |
184 	+---------------+  +----------------------->       +---------------+
186 	+---------------+                    Clock Signal  +---------------+
187 	|    Master     +----------------------------------+     Slave     |
191 	|     L2 + R2   +----------------------------------+    L2 + R2    |
193 	+---------------+  +----------------------->       +---------------+
195 Note1: In multi-link cases like above, to lock, one would acquire a global
198 always serialized. So, there is no race condition and hence no need for
219 ------------------
222       to be performed like prepare, enable, disable, de-prepare etc.
235 -----------------------
239 	+-----------+     +------------+     +----------+     +----------+
240 	| ALLOCATED +---->| CONFIGURED +---->| PREPARED +---->| ENABLED  |
242 	+-----------+     +------------+     +---+--+---+     +----+-----+
248 	         +----------+           +-----+------+        +-+--+-----+
249 	         | RELEASED |<----------+ DEPREPARED |<-------+ DISABLED |
251 	         +----------+           +------------+        +----------+
265 -----------------------
292 .. code-block:: c
323 .. code-block:: c
346       stream(s) on Bus. Re-computation is required to accommodate current
374 .. code-block:: c
404 .. code-block:: c
440 .. code-block:: c
448 De-prepare state of stream. Operations performed before entering in this
452       de-prepared by programming PrepareCtrl register.
467 the .hw_free() operation - the stream is not deprepared on a
474 .. code-block:: c
499 .. code-block:: c
512 .. code-block:: c