driver-api/soundwire/summary.rst

10 SoundWire is a 2-pin multi-drop interface with data and clock line. It
14  (1) Transporting all of payload data channels, control information, and setup
15      commands over a single two-pin interface.
23  (4) Device status monitoring, including interrupt-style alerts to the Master.
27 Slaves can support up to 14 Data Ports. 13 Data Ports are dedicated to audio
28 transport. Data Port0 is dedicated to transport of Bulk control information,
29 each of the audio Data Ports (1..14) can support up to 8 Channels in
38         +---------------+                                       +---------------+
40         |    Master     |-------+-------------------------------|    Slave      |
42         |               |-------|-------+-----------------------|               |
43         +---------------+       |       |                       +---------------+
47                              +--+-------+--+
52                              +-------------+
64 3rd-party vendors to enable implementation-defined functionality while
69 Programs all the MIPI-defined Slave registers. Represents a SoundWire
77 Driver controlling the Slave device. MIPI-specified registers are controlled
79 Any implementation-defined Slave register is controlled by Slave driver. In
102 .. code-block:: c
110 		mutex_init(&bus->lock);
111 		INIT_LIST_HEAD(&bus->slaves);
125 "sdw_master_ops" is used by Bus to control the Bus in the hardware specific
126 way. It includes Bus control functions such as sending the SoundWire
136 then perform hardware-specific configurations.
142 48-bit identifier, stored in 6 read-only dev_id registers. This dev_id
154 board-file, ACPI or DT. The MIPI Software specification defines additional
161 .. code-block:: c
184 Slave capabilities to program Slave registers and to control the Bus
193  (2) Multiple data lane support.
199 https://members.mipi.org/wg/All-Members/document/70290
203 https://www.mipi.org/specifications/mipi-disco-soundwire