Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 8cf3f9cf authored by Sanyog Kale's avatar Sanyog Kale Committed by Vinod Koul
Browse files

Documentation: soundwire: Add documentation for multi link 



Add example and documentation to describe multi link streams

Signed-off-by: default avatarPierre-Louis Bossart <pierre-louis.bossart@linux.intel.com>
Signed-off-by: default avatarSanyog Kale <sanyog.r.kale@intel.com>
Signed-off-by: default avatarShreyas NC <shreyas.nc@intel.com>
Acked-by: default avatarPierre-Louis Bossart <pierre-louis.bossart@linux.intel.com>
Signed-off-by: default avatarVinod Koul <vkoul@kernel.org>
parent 8d6ccf5c

Documentation/driver-api/soundwire/stream.rst

+28 −0
Original line number Diff line number Diff line
@@ -101,6 +101,34 @@ interface. :: 
	+--------------------+                             |                |

							   +----------------+



Example 5: Stereo Stream with L and R channel is rendered by 2 Masters, each

rendering one channel, and is received by two different Slaves, each

receiving one channel. Both Masters and both Slaves are using single port. ::



	+---------------+                    Clock Signal  +---------------+

	|    Master     +----------------------------------+     Slave     |

	|   Interface   |                                  |   Interface   |

	|       1       |                                  |       1       |

	|               |                     Data Signal  |               |

	|       L       +----------------------------------+       L       |

	|     (Data)    |     Data Direction               |     (Data)    |

	+---------------+  +----------------------->       +---------------+



	+---------------+                    Clock Signal  +---------------+

	|    Master     +----------------------------------+     Slave     |

	|   Interface   |                                  |   Interface   |

	|       2       |                                  |       2       |

	|               |                     Data Signal  |               |

	|       R       +----------------------------------+       R       |

	|     (Data)    |     Data Direction               |     (Data)    |

	+---------------+  +----------------------->       +---------------+



Note: In multi-link cases like above, to lock, one would acquire a global

lock and then go on locking bus instances. But, in this case the caller

framework(ASoC DPCM) guarantees that stream operations on a card are

always serialized. So, there is no race condition and hence no need for

global lock.



SoundWire Stream Management flow

================================