Linux 4.19.133
[linux/fpc-iii.git] / drivers / soundwire / stream.c
blob907a548645b759fc1c9e030de9e4f63204d62b66
1 // SPDX-License-Identifier: (GPL-2.0 OR BSD-3-Clause)
2 // Copyright(c) 2015-18 Intel Corporation.
4 /*
5 * stream.c - SoundWire Bus stream operations.
6 */
8 #include <linux/delay.h>
9 #include <linux/device.h>
10 #include <linux/init.h>
11 #include <linux/module.h>
12 #include <linux/mod_devicetable.h>
13 #include <linux/slab.h>
14 #include <linux/soundwire/sdw_registers.h>
15 #include <linux/soundwire/sdw.h>
16 #include "bus.h"
19 * Array of supported rows and columns as per MIPI SoundWire Specification 1.1
21 * The rows are arranged as per the array index value programmed
22 * in register. The index 15 has dummy value 0 in order to fill hole.
24 int rows[SDW_FRAME_ROWS] = {48, 50, 60, 64, 75, 80, 125, 147,
25 96, 100, 120, 128, 150, 160, 250, 0,
26 192, 200, 240, 256, 72, 144, 90, 180};
28 int cols[SDW_FRAME_COLS] = {2, 4, 6, 8, 10, 12, 14, 16};
30 static int sdw_find_col_index(int col)
32 int i;
34 for (i = 0; i < SDW_FRAME_COLS; i++) {
35 if (cols[i] == col)
36 return i;
39 pr_warn("Requested column not found, selecting lowest column no: 2\n");
40 return 0;
43 static int sdw_find_row_index(int row)
45 int i;
47 for (i = 0; i < SDW_FRAME_ROWS; i++) {
48 if (rows[i] == row)
49 return i;
52 pr_warn("Requested row not found, selecting lowest row no: 48\n");
53 return 0;
55 static int _sdw_program_slave_port_params(struct sdw_bus *bus,
56 struct sdw_slave *slave,
57 struct sdw_transport_params *t_params,
58 enum sdw_dpn_type type)
60 u32 addr1, addr2, addr3, addr4;
61 int ret;
62 u16 wbuf;
64 if (bus->params.next_bank) {
65 addr1 = SDW_DPN_OFFSETCTRL2_B1(t_params->port_num);
66 addr2 = SDW_DPN_BLOCKCTRL3_B1(t_params->port_num);
67 addr3 = SDW_DPN_SAMPLECTRL2_B1(t_params->port_num);
68 addr4 = SDW_DPN_HCTRL_B1(t_params->port_num);
69 } else {
70 addr1 = SDW_DPN_OFFSETCTRL2_B0(t_params->port_num);
71 addr2 = SDW_DPN_BLOCKCTRL3_B0(t_params->port_num);
72 addr3 = SDW_DPN_SAMPLECTRL2_B0(t_params->port_num);
73 addr4 = SDW_DPN_HCTRL_B0(t_params->port_num);
76 /* Program DPN_OffsetCtrl2 registers */
77 ret = sdw_write(slave, addr1, t_params->offset2);
78 if (ret < 0) {
79 dev_err(bus->dev, "DPN_OffsetCtrl2 register write failed");
80 return ret;
83 /* Program DPN_BlockCtrl3 register */
84 ret = sdw_write(slave, addr2, t_params->blk_pkg_mode);
85 if (ret < 0) {
86 dev_err(bus->dev, "DPN_BlockCtrl3 register write failed");
87 return ret;
91 * Data ports are FULL, SIMPLE and REDUCED. This function handles
92 * FULL and REDUCED only and and beyond this point only FULL is
93 * handled, so bail out if we are not FULL data port type
95 if (type != SDW_DPN_FULL)
96 return ret;
98 /* Program DPN_SampleCtrl2 register */
99 wbuf = (t_params->sample_interval - 1);
100 wbuf &= SDW_DPN_SAMPLECTRL_HIGH;
101 wbuf >>= SDW_REG_SHIFT(SDW_DPN_SAMPLECTRL_HIGH);
103 ret = sdw_write(slave, addr3, wbuf);
104 if (ret < 0) {
105 dev_err(bus->dev, "DPN_SampleCtrl2 register write failed");
106 return ret;
109 /* Program DPN_HCtrl register */
110 wbuf = t_params->hstart;
111 wbuf <<= SDW_REG_SHIFT(SDW_DPN_HCTRL_HSTART);
112 wbuf |= t_params->hstop;
114 ret = sdw_write(slave, addr4, wbuf);
115 if (ret < 0)
116 dev_err(bus->dev, "DPN_HCtrl register write failed");
118 return ret;
121 static int sdw_program_slave_port_params(struct sdw_bus *bus,
122 struct sdw_slave_runtime *s_rt,
123 struct sdw_port_runtime *p_rt)
125 struct sdw_transport_params *t_params = &p_rt->transport_params;
126 struct sdw_port_params *p_params = &p_rt->port_params;
127 struct sdw_slave_prop *slave_prop = &s_rt->slave->prop;
128 u32 addr1, addr2, addr3, addr4, addr5, addr6;
129 struct sdw_dpn_prop *dpn_prop;
130 int ret;
131 u8 wbuf;
133 dpn_prop = sdw_get_slave_dpn_prop(s_rt->slave,
134 s_rt->direction,
135 t_params->port_num);
136 if (!dpn_prop)
137 return -EINVAL;
139 addr1 = SDW_DPN_PORTCTRL(t_params->port_num);
140 addr2 = SDW_DPN_BLOCKCTRL1(t_params->port_num);
142 if (bus->params.next_bank) {
143 addr3 = SDW_DPN_SAMPLECTRL1_B1(t_params->port_num);
144 addr4 = SDW_DPN_OFFSETCTRL1_B1(t_params->port_num);
145 addr5 = SDW_DPN_BLOCKCTRL2_B1(t_params->port_num);
146 addr6 = SDW_DPN_LANECTRL_B1(t_params->port_num);
148 } else {
149 addr3 = SDW_DPN_SAMPLECTRL1_B0(t_params->port_num);
150 addr4 = SDW_DPN_OFFSETCTRL1_B0(t_params->port_num);
151 addr5 = SDW_DPN_BLOCKCTRL2_B0(t_params->port_num);
152 addr6 = SDW_DPN_LANECTRL_B0(t_params->port_num);
155 /* Program DPN_PortCtrl register */
156 wbuf = p_params->data_mode << SDW_REG_SHIFT(SDW_DPN_PORTCTRL_DATAMODE);
157 wbuf |= p_params->flow_mode;
159 ret = sdw_update(s_rt->slave, addr1, 0xF, wbuf);
160 if (ret < 0) {
161 dev_err(&s_rt->slave->dev,
162 "DPN_PortCtrl register write failed for port %d",
163 t_params->port_num);
164 return ret;
167 /* Program DPN_BlockCtrl1 register */
168 ret = sdw_write(s_rt->slave, addr2, (p_params->bps - 1));
169 if (ret < 0) {
170 dev_err(&s_rt->slave->dev,
171 "DPN_BlockCtrl1 register write failed for port %d",
172 t_params->port_num);
173 return ret;
176 /* Program DPN_SampleCtrl1 register */
177 wbuf = (t_params->sample_interval - 1) & SDW_DPN_SAMPLECTRL_LOW;
178 ret = sdw_write(s_rt->slave, addr3, wbuf);
179 if (ret < 0) {
180 dev_err(&s_rt->slave->dev,
181 "DPN_SampleCtrl1 register write failed for port %d",
182 t_params->port_num);
183 return ret;
186 /* Program DPN_OffsetCtrl1 registers */
187 ret = sdw_write(s_rt->slave, addr4, t_params->offset1);
188 if (ret < 0) {
189 dev_err(&s_rt->slave->dev,
190 "DPN_OffsetCtrl1 register write failed for port %d",
191 t_params->port_num);
192 return ret;
195 /* Program DPN_BlockCtrl2 register*/
196 if (t_params->blk_grp_ctrl_valid) {
197 ret = sdw_write(s_rt->slave, addr5, t_params->blk_grp_ctrl);
198 if (ret < 0) {
199 dev_err(&s_rt->slave->dev,
200 "DPN_BlockCtrl2 reg write failed for port %d",
201 t_params->port_num);
202 return ret;
206 /* program DPN_LaneCtrl register */
207 if (slave_prop->lane_control_support) {
208 ret = sdw_write(s_rt->slave, addr6, t_params->lane_ctrl);
209 if (ret < 0) {
210 dev_err(&s_rt->slave->dev,
211 "DPN_LaneCtrl register write failed for port %d",
212 t_params->port_num);
213 return ret;
217 if (dpn_prop->type != SDW_DPN_SIMPLE) {
218 ret = _sdw_program_slave_port_params(bus, s_rt->slave,
219 t_params, dpn_prop->type);
220 if (ret < 0)
221 dev_err(&s_rt->slave->dev,
222 "Transport reg write failed for port: %d",
223 t_params->port_num);
226 return ret;
229 static int sdw_program_master_port_params(struct sdw_bus *bus,
230 struct sdw_port_runtime *p_rt)
232 int ret;
235 * we need to set transport and port parameters for the port.
236 * Transport parameters refers to the smaple interval, offsets and
237 * hstart/stop etc of the data. Port parameters refers to word
238 * length, flow mode etc of the port
240 ret = bus->port_ops->dpn_set_port_transport_params(bus,
241 &p_rt->transport_params,
242 bus->params.next_bank);
243 if (ret < 0)
244 return ret;
246 return bus->port_ops->dpn_set_port_params(bus,
247 &p_rt->port_params,
248 bus->params.next_bank);
252 * sdw_program_port_params() - Programs transport parameters of Master(s)
253 * and Slave(s)
255 * @m_rt: Master stream runtime
257 static int sdw_program_port_params(struct sdw_master_runtime *m_rt)
259 struct sdw_slave_runtime *s_rt = NULL;
260 struct sdw_bus *bus = m_rt->bus;
261 struct sdw_port_runtime *p_rt;
262 int ret = 0;
264 /* Program transport & port parameters for Slave(s) */
265 list_for_each_entry(s_rt, &m_rt->slave_rt_list, m_rt_node) {
266 list_for_each_entry(p_rt, &s_rt->port_list, port_node) {
267 ret = sdw_program_slave_port_params(bus, s_rt, p_rt);
268 if (ret < 0)
269 return ret;
273 /* Program transport & port parameters for Master(s) */
274 list_for_each_entry(p_rt, &m_rt->port_list, port_node) {
275 ret = sdw_program_master_port_params(bus, p_rt);
276 if (ret < 0)
277 return ret;
280 return 0;
284 * sdw_enable_disable_slave_ports: Enable/disable slave data port
286 * @bus: bus instance
287 * @s_rt: slave runtime
288 * @p_rt: port runtime
289 * @en: enable or disable operation
291 * This function only sets the enable/disable bits in the relevant bank, the
292 * actual enable/disable is done with a bank switch
294 static int sdw_enable_disable_slave_ports(struct sdw_bus *bus,
295 struct sdw_slave_runtime *s_rt,
296 struct sdw_port_runtime *p_rt, bool en)
298 struct sdw_transport_params *t_params = &p_rt->transport_params;
299 u32 addr;
300 int ret;
302 if (bus->params.next_bank)
303 addr = SDW_DPN_CHANNELEN_B1(p_rt->num);
304 else
305 addr = SDW_DPN_CHANNELEN_B0(p_rt->num);
308 * Since bus doesn't support sharing a port across two streams,
309 * it is safe to reset this register
311 if (en)
312 ret = sdw_update(s_rt->slave, addr, 0xFF, p_rt->ch_mask);
313 else
314 ret = sdw_update(s_rt->slave, addr, 0xFF, 0x0);
316 if (ret < 0)
317 dev_err(&s_rt->slave->dev,
318 "Slave chn_en reg write failed:%d port:%d",
319 ret, t_params->port_num);
321 return ret;
324 static int sdw_enable_disable_master_ports(struct sdw_master_runtime *m_rt,
325 struct sdw_port_runtime *p_rt, bool en)
327 struct sdw_transport_params *t_params = &p_rt->transport_params;
328 struct sdw_bus *bus = m_rt->bus;
329 struct sdw_enable_ch enable_ch;
330 int ret = 0;
332 enable_ch.port_num = p_rt->num;
333 enable_ch.ch_mask = p_rt->ch_mask;
334 enable_ch.enable = en;
336 /* Perform Master port channel(s) enable/disable */
337 if (bus->port_ops->dpn_port_enable_ch) {
338 ret = bus->port_ops->dpn_port_enable_ch(bus,
339 &enable_ch, bus->params.next_bank);
340 if (ret < 0) {
341 dev_err(bus->dev,
342 "Master chn_en write failed:%d port:%d",
343 ret, t_params->port_num);
344 return ret;
346 } else {
347 dev_err(bus->dev,
348 "dpn_port_enable_ch not supported, %s failed\n",
349 en ? "enable" : "disable");
350 return -EINVAL;
353 return 0;
357 * sdw_enable_disable_ports() - Enable/disable port(s) for Master and
358 * Slave(s)
360 * @m_rt: Master stream runtime
361 * @en: mode (enable/disable)
363 static int sdw_enable_disable_ports(struct sdw_master_runtime *m_rt, bool en)
365 struct sdw_port_runtime *s_port, *m_port;
366 struct sdw_slave_runtime *s_rt = NULL;
367 int ret = 0;
369 /* Enable/Disable Slave port(s) */
370 list_for_each_entry(s_rt, &m_rt->slave_rt_list, m_rt_node) {
371 list_for_each_entry(s_port, &s_rt->port_list, port_node) {
372 ret = sdw_enable_disable_slave_ports(m_rt->bus, s_rt,
373 s_port, en);
374 if (ret < 0)
375 return ret;
379 /* Enable/Disable Master port(s) */
380 list_for_each_entry(m_port, &m_rt->port_list, port_node) {
381 ret = sdw_enable_disable_master_ports(m_rt, m_port, en);
382 if (ret < 0)
383 return ret;
386 return 0;
389 static int sdw_do_port_prep(struct sdw_slave_runtime *s_rt,
390 struct sdw_prepare_ch prep_ch, enum sdw_port_prep_ops cmd)
392 const struct sdw_slave_ops *ops = s_rt->slave->ops;
393 int ret;
395 if (ops->port_prep) {
396 ret = ops->port_prep(s_rt->slave, &prep_ch, cmd);
397 if (ret < 0) {
398 dev_err(&s_rt->slave->dev,
399 "Slave Port Prep cmd %d failed: %d", cmd, ret);
400 return ret;
404 return 0;
407 static int sdw_prep_deprep_slave_ports(struct sdw_bus *bus,
408 struct sdw_slave_runtime *s_rt,
409 struct sdw_port_runtime *p_rt, bool prep)
411 struct completion *port_ready = NULL;
412 struct sdw_dpn_prop *dpn_prop;
413 struct sdw_prepare_ch prep_ch;
414 unsigned int time_left;
415 bool intr = false;
416 int ret = 0, val;
417 u32 addr;
419 prep_ch.num = p_rt->num;
420 prep_ch.ch_mask = p_rt->ch_mask;
422 dpn_prop = sdw_get_slave_dpn_prop(s_rt->slave,
423 s_rt->direction,
424 prep_ch.num);
425 if (!dpn_prop) {
426 dev_err(bus->dev,
427 "Slave Port:%d properties not found", prep_ch.num);
428 return -EINVAL;
431 prep_ch.prepare = prep;
433 prep_ch.bank = bus->params.next_bank;
435 if (dpn_prop->device_interrupts || !dpn_prop->simple_ch_prep_sm)
436 intr = true;
439 * Enable interrupt before Port prepare.
440 * For Port de-prepare, it is assumed that port
441 * was prepared earlier
443 if (prep && intr) {
444 ret = sdw_configure_dpn_intr(s_rt->slave, p_rt->num, prep,
445 dpn_prop->device_interrupts);
446 if (ret < 0)
447 return ret;
450 /* Inform slave about the impending port prepare */
451 sdw_do_port_prep(s_rt, prep_ch, SDW_OPS_PORT_PRE_PREP);
453 /* Prepare Slave port implementing CP_SM */
454 if (!dpn_prop->simple_ch_prep_sm) {
455 addr = SDW_DPN_PREPARECTRL(p_rt->num);
457 if (prep)
458 ret = sdw_update(s_rt->slave, addr,
459 0xFF, p_rt->ch_mask);
460 else
461 ret = sdw_update(s_rt->slave, addr, 0xFF, 0x0);
463 if (ret < 0) {
464 dev_err(&s_rt->slave->dev,
465 "Slave prep_ctrl reg write failed");
466 return ret;
469 /* Wait for completion on port ready */
470 port_ready = &s_rt->slave->port_ready[prep_ch.num];
471 time_left = wait_for_completion_timeout(port_ready,
472 msecs_to_jiffies(dpn_prop->ch_prep_timeout));
474 val = sdw_read(s_rt->slave, SDW_DPN_PREPARESTATUS(p_rt->num));
475 val &= p_rt->ch_mask;
476 if (!time_left || val) {
477 dev_err(&s_rt->slave->dev,
478 "Chn prep failed for port:%d", prep_ch.num);
479 return -ETIMEDOUT;
483 /* Inform slaves about ports prepared */
484 sdw_do_port_prep(s_rt, prep_ch, SDW_OPS_PORT_POST_PREP);
486 /* Disable interrupt after Port de-prepare */
487 if (!prep && intr)
488 ret = sdw_configure_dpn_intr(s_rt->slave, p_rt->num, prep,
489 dpn_prop->device_interrupts);
491 return ret;
494 static int sdw_prep_deprep_master_ports(struct sdw_master_runtime *m_rt,
495 struct sdw_port_runtime *p_rt, bool prep)
497 struct sdw_transport_params *t_params = &p_rt->transport_params;
498 struct sdw_bus *bus = m_rt->bus;
499 const struct sdw_master_port_ops *ops = bus->port_ops;
500 struct sdw_prepare_ch prep_ch;
501 int ret = 0;
503 prep_ch.num = p_rt->num;
504 prep_ch.ch_mask = p_rt->ch_mask;
505 prep_ch.prepare = prep; /* Prepare/De-prepare */
506 prep_ch.bank = bus->params.next_bank;
508 /* Pre-prepare/Pre-deprepare port(s) */
509 if (ops->dpn_port_prep) {
510 ret = ops->dpn_port_prep(bus, &prep_ch);
511 if (ret < 0) {
512 dev_err(bus->dev, "Port prepare failed for port:%d",
513 t_params->port_num);
514 return ret;
518 return ret;
522 * sdw_prep_deprep_ports() - Prepare/De-prepare port(s) for Master(s) and
523 * Slave(s)
525 * @m_rt: Master runtime handle
526 * @prep: Prepare or De-prepare
528 static int sdw_prep_deprep_ports(struct sdw_master_runtime *m_rt, bool prep)
530 struct sdw_slave_runtime *s_rt = NULL;
531 struct sdw_port_runtime *p_rt;
532 int ret = 0;
534 /* Prepare/De-prepare Slave port(s) */
535 list_for_each_entry(s_rt, &m_rt->slave_rt_list, m_rt_node) {
536 list_for_each_entry(p_rt, &s_rt->port_list, port_node) {
537 ret = sdw_prep_deprep_slave_ports(m_rt->bus, s_rt,
538 p_rt, prep);
539 if (ret < 0)
540 return ret;
544 /* Prepare/De-prepare Master port(s) */
545 list_for_each_entry(p_rt, &m_rt->port_list, port_node) {
546 ret = sdw_prep_deprep_master_ports(m_rt, p_rt, prep);
547 if (ret < 0)
548 return ret;
551 return ret;
555 * sdw_notify_config() - Notify bus configuration
557 * @m_rt: Master runtime handle
559 * This function notifies the Master(s) and Slave(s) of the
560 * new bus configuration.
562 static int sdw_notify_config(struct sdw_master_runtime *m_rt)
564 struct sdw_slave_runtime *s_rt;
565 struct sdw_bus *bus = m_rt->bus;
566 struct sdw_slave *slave;
567 int ret = 0;
569 if (bus->ops->set_bus_conf) {
570 ret = bus->ops->set_bus_conf(bus, &bus->params);
571 if (ret < 0)
572 return ret;
575 list_for_each_entry(s_rt, &m_rt->slave_rt_list, m_rt_node) {
576 slave = s_rt->slave;
578 if (slave->ops->bus_config) {
579 ret = slave->ops->bus_config(slave, &bus->params);
580 if (ret < 0)
581 dev_err(bus->dev, "Notify Slave: %d failed",
582 slave->dev_num);
583 return ret;
587 return ret;
591 * sdw_program_params() - Program transport and port parameters for Master(s)
592 * and Slave(s)
594 * @bus: SDW bus instance
596 static int sdw_program_params(struct sdw_bus *bus)
598 struct sdw_master_runtime *m_rt = NULL;
599 int ret = 0;
601 list_for_each_entry(m_rt, &bus->m_rt_list, bus_node) {
602 ret = sdw_program_port_params(m_rt);
603 if (ret < 0) {
604 dev_err(bus->dev,
605 "Program transport params failed: %d", ret);
606 return ret;
609 ret = sdw_notify_config(m_rt);
610 if (ret < 0) {
611 dev_err(bus->dev, "Notify bus config failed: %d", ret);
612 return ret;
615 /* Enable port(s) on alternate bank for all active streams */
616 if (m_rt->stream->state != SDW_STREAM_ENABLED)
617 continue;
619 ret = sdw_enable_disable_ports(m_rt, true);
620 if (ret < 0) {
621 dev_err(bus->dev, "Enable channel failed: %d", ret);
622 return ret;
626 return ret;
629 static int sdw_bank_switch(struct sdw_bus *bus)
631 int col_index, row_index;
632 struct sdw_msg *wr_msg;
633 u8 *wbuf = NULL;
634 int ret = 0;
635 u16 addr;
637 wr_msg = kzalloc(sizeof(*wr_msg), GFP_KERNEL);
638 if (!wr_msg)
639 return -ENOMEM;
641 wbuf = kzalloc(sizeof(*wbuf), GFP_KERNEL);
642 if (!wbuf) {
643 ret = -ENOMEM;
644 goto error_1;
647 /* Get row and column index to program register */
648 col_index = sdw_find_col_index(bus->params.col);
649 row_index = sdw_find_row_index(bus->params.row);
650 wbuf[0] = col_index | (row_index << 3);
652 if (bus->params.next_bank)
653 addr = SDW_SCP_FRAMECTRL_B1;
654 else
655 addr = SDW_SCP_FRAMECTRL_B0;
657 sdw_fill_msg(wr_msg, NULL, addr, 1, SDW_BROADCAST_DEV_NUM,
658 SDW_MSG_FLAG_WRITE, wbuf);
659 wr_msg->ssp_sync = true;
661 ret = sdw_transfer(bus, wr_msg);
662 if (ret < 0) {
663 dev_err(bus->dev, "Slave frame_ctrl reg write failed");
664 goto error;
667 kfree(wr_msg);
668 kfree(wbuf);
669 bus->defer_msg.msg = NULL;
670 bus->params.curr_bank = !bus->params.curr_bank;
671 bus->params.next_bank = !bus->params.next_bank;
673 return 0;
675 error:
676 kfree(wbuf);
677 error_1:
678 kfree(wr_msg);
679 return ret;
682 static int do_bank_switch(struct sdw_stream_runtime *stream)
684 struct sdw_master_runtime *m_rt = stream->m_rt;
685 const struct sdw_master_ops *ops;
686 struct sdw_bus *bus = m_rt->bus;
687 int ret = 0;
689 ops = bus->ops;
691 /* Pre-bank switch */
692 if (ops->pre_bank_switch) {
693 ret = ops->pre_bank_switch(bus);
694 if (ret < 0) {
695 dev_err(bus->dev, "Pre bank switch op failed: %d", ret);
696 return ret;
700 /* Bank switch */
701 ret = sdw_bank_switch(bus);
702 if (ret < 0) {
703 dev_err(bus->dev, "Bank switch failed: %d", ret);
704 return ret;
707 /* Post-bank switch */
708 if (ops->post_bank_switch) {
709 ret = ops->post_bank_switch(bus);
710 if (ret < 0) {
711 dev_err(bus->dev,
712 "Post bank switch op failed: %d", ret);
716 return ret;
720 * sdw_release_stream() - Free the assigned stream runtime
722 * @stream: SoundWire stream runtime
724 * sdw_release_stream should be called only once per stream
726 void sdw_release_stream(struct sdw_stream_runtime *stream)
728 kfree(stream);
730 EXPORT_SYMBOL(sdw_release_stream);
733 * sdw_alloc_stream() - Allocate and return stream runtime
735 * @stream_name: SoundWire stream name
737 * Allocates a SoundWire stream runtime instance.
738 * sdw_alloc_stream should be called only once per stream. Typically
739 * invoked from ALSA/ASoC machine/platform driver.
741 struct sdw_stream_runtime *sdw_alloc_stream(char *stream_name)
743 struct sdw_stream_runtime *stream;
745 stream = kzalloc(sizeof(*stream), GFP_KERNEL);
746 if (!stream)
747 return NULL;
749 stream->name = stream_name;
750 stream->state = SDW_STREAM_ALLOCATED;
752 return stream;
754 EXPORT_SYMBOL(sdw_alloc_stream);
757 * sdw_alloc_master_rt() - Allocates and initialize Master runtime handle
759 * @bus: SDW bus instance
760 * @stream_config: Stream configuration
761 * @stream: Stream runtime handle.
763 * This function is to be called with bus_lock held.
765 static struct sdw_master_runtime
766 *sdw_alloc_master_rt(struct sdw_bus *bus,
767 struct sdw_stream_config *stream_config,
768 struct sdw_stream_runtime *stream)
770 struct sdw_master_runtime *m_rt;
772 m_rt = stream->m_rt;
775 * check if Master is already allocated (as a result of Slave adding
776 * it first), if so skip allocation and go to configure
778 if (m_rt)
779 goto stream_config;
781 m_rt = kzalloc(sizeof(*m_rt), GFP_KERNEL);
782 if (!m_rt)
783 return NULL;
785 /* Initialization of Master runtime handle */
786 INIT_LIST_HEAD(&m_rt->port_list);
787 INIT_LIST_HEAD(&m_rt->slave_rt_list);
788 stream->m_rt = m_rt;
790 list_add_tail(&m_rt->bus_node, &bus->m_rt_list);
792 stream_config:
793 m_rt->ch_count = stream_config->ch_count;
794 m_rt->bus = bus;
795 m_rt->stream = stream;
796 m_rt->direction = stream_config->direction;
798 return m_rt;
802 * sdw_alloc_slave_rt() - Allocate and initialize Slave runtime handle.
804 * @slave: Slave handle
805 * @stream_config: Stream configuration
806 * @stream: Stream runtime handle
808 * This function is to be called with bus_lock held.
810 static struct sdw_slave_runtime
811 *sdw_alloc_slave_rt(struct sdw_slave *slave,
812 struct sdw_stream_config *stream_config,
813 struct sdw_stream_runtime *stream)
815 struct sdw_slave_runtime *s_rt = NULL;
817 s_rt = kzalloc(sizeof(*s_rt), GFP_KERNEL);
818 if (!s_rt)
819 return NULL;
821 INIT_LIST_HEAD(&s_rt->port_list);
822 s_rt->ch_count = stream_config->ch_count;
823 s_rt->direction = stream_config->direction;
824 s_rt->slave = slave;
826 return s_rt;
829 static void sdw_master_port_release(struct sdw_bus *bus,
830 struct sdw_master_runtime *m_rt)
832 struct sdw_port_runtime *p_rt, *_p_rt;
834 list_for_each_entry_safe(p_rt, _p_rt,
835 &m_rt->port_list, port_node) {
836 list_del(&p_rt->port_node);
837 kfree(p_rt);
841 static void sdw_slave_port_release(struct sdw_bus *bus,
842 struct sdw_slave *slave,
843 struct sdw_stream_runtime *stream)
845 struct sdw_port_runtime *p_rt, *_p_rt;
846 struct sdw_master_runtime *m_rt = stream->m_rt;
847 struct sdw_slave_runtime *s_rt;
849 list_for_each_entry(s_rt, &m_rt->slave_rt_list, m_rt_node) {
850 if (s_rt->slave != slave)
851 continue;
853 list_for_each_entry_safe(p_rt, _p_rt,
854 &s_rt->port_list, port_node) {
855 list_del(&p_rt->port_node);
856 kfree(p_rt);
862 * sdw_release_slave_stream() - Free Slave(s) runtime handle
864 * @slave: Slave handle.
865 * @stream: Stream runtime handle.
867 * This function is to be called with bus_lock held.
869 static void sdw_release_slave_stream(struct sdw_slave *slave,
870 struct sdw_stream_runtime *stream)
872 struct sdw_slave_runtime *s_rt, *_s_rt;
873 struct sdw_master_runtime *m_rt = stream->m_rt;
875 /* Retrieve Slave runtime handle */
876 list_for_each_entry_safe(s_rt, _s_rt,
877 &m_rt->slave_rt_list, m_rt_node) {
879 if (s_rt->slave == slave) {
880 list_del(&s_rt->m_rt_node);
881 kfree(s_rt);
882 return;
888 * sdw_release_master_stream() - Free Master runtime handle
890 * @stream: Stream runtime handle.
892 * This function is to be called with bus_lock held
893 * It frees the Master runtime handle and associated Slave(s) runtime
894 * handle. If this is called first then sdw_release_slave_stream() will have
895 * no effect as Slave(s) runtime handle would already be freed up.
897 static void sdw_release_master_stream(struct sdw_stream_runtime *stream)
899 struct sdw_master_runtime *m_rt = stream->m_rt;
900 struct sdw_slave_runtime *s_rt, *_s_rt;
902 list_for_each_entry_safe(s_rt, _s_rt, &m_rt->slave_rt_list, m_rt_node) {
903 sdw_slave_port_release(s_rt->slave->bus, s_rt->slave, stream);
904 sdw_release_slave_stream(s_rt->slave, stream);
907 list_del(&m_rt->bus_node);
911 * sdw_stream_remove_master() - Remove master from sdw_stream
913 * @bus: SDW Bus instance
914 * @stream: SoundWire stream
916 * This removes and frees port_rt and master_rt from a stream
918 int sdw_stream_remove_master(struct sdw_bus *bus,
919 struct sdw_stream_runtime *stream)
921 mutex_lock(&bus->bus_lock);
923 sdw_release_master_stream(stream);
924 sdw_master_port_release(bus, stream->m_rt);
925 stream->state = SDW_STREAM_RELEASED;
926 kfree(stream->m_rt);
927 stream->m_rt = NULL;
929 mutex_unlock(&bus->bus_lock);
931 return 0;
933 EXPORT_SYMBOL(sdw_stream_remove_master);
936 * sdw_stream_remove_slave() - Remove slave from sdw_stream
938 * @slave: SDW Slave instance
939 * @stream: SoundWire stream
941 * This removes and frees port_rt and slave_rt from a stream
943 int sdw_stream_remove_slave(struct sdw_slave *slave,
944 struct sdw_stream_runtime *stream)
946 mutex_lock(&slave->bus->bus_lock);
948 sdw_slave_port_release(slave->bus, slave, stream);
949 sdw_release_slave_stream(slave, stream);
951 mutex_unlock(&slave->bus->bus_lock);
953 return 0;
955 EXPORT_SYMBOL(sdw_stream_remove_slave);
958 * sdw_config_stream() - Configure the allocated stream
960 * @dev: SDW device
961 * @stream: SoundWire stream
962 * @stream_config: Stream configuration for audio stream
963 * @is_slave: is API called from Slave or Master
965 * This function is to be called with bus_lock held.
967 static int sdw_config_stream(struct device *dev,
968 struct sdw_stream_runtime *stream,
969 struct sdw_stream_config *stream_config, bool is_slave)
972 * Update the stream rate, channel and bps based on data
973 * source. For more than one data source (multilink),
974 * match the rate, bps, stream type and increment number of channels.
976 * If rate/bps is zero, it means the values are not set, so skip
977 * comparison and allow the value to be set and stored in stream
979 if (stream->params.rate &&
980 stream->params.rate != stream_config->frame_rate) {
981 dev_err(dev, "rate not matching, stream:%s", stream->name);
982 return -EINVAL;
985 if (stream->params.bps &&
986 stream->params.bps != stream_config->bps) {
987 dev_err(dev, "bps not matching, stream:%s", stream->name);
988 return -EINVAL;
991 stream->type = stream_config->type;
992 stream->params.rate = stream_config->frame_rate;
993 stream->params.bps = stream_config->bps;
995 /* TODO: Update this check during Device-device support */
996 if (is_slave)
997 stream->params.ch_count += stream_config->ch_count;
999 return 0;
1002 static int sdw_is_valid_port_range(struct device *dev,
1003 struct sdw_port_runtime *p_rt)
1005 if (!SDW_VALID_PORT_RANGE(p_rt->num)) {
1006 dev_err(dev,
1007 "SoundWire: Invalid port number :%d", p_rt->num);
1008 return -EINVAL;
1011 return 0;
1014 static struct sdw_port_runtime *sdw_port_alloc(struct device *dev,
1015 struct sdw_port_config *port_config,
1016 int port_index)
1018 struct sdw_port_runtime *p_rt;
1020 p_rt = kzalloc(sizeof(*p_rt), GFP_KERNEL);
1021 if (!p_rt)
1022 return NULL;
1024 p_rt->ch_mask = port_config[port_index].ch_mask;
1025 p_rt->num = port_config[port_index].num;
1027 return p_rt;
1030 static int sdw_master_port_config(struct sdw_bus *bus,
1031 struct sdw_master_runtime *m_rt,
1032 struct sdw_port_config *port_config,
1033 unsigned int num_ports)
1035 struct sdw_port_runtime *p_rt;
1036 int i;
1038 /* Iterate for number of ports to perform initialization */
1039 for (i = 0; i < num_ports; i++) {
1040 p_rt = sdw_port_alloc(bus->dev, port_config, i);
1041 if (!p_rt)
1042 return -ENOMEM;
1045 * TODO: Check port capabilities for requested
1046 * configuration (audio mode support)
1049 list_add_tail(&p_rt->port_node, &m_rt->port_list);
1052 return 0;
1055 static int sdw_slave_port_config(struct sdw_slave *slave,
1056 struct sdw_slave_runtime *s_rt,
1057 struct sdw_port_config *port_config,
1058 unsigned int num_config)
1060 struct sdw_port_runtime *p_rt;
1061 int i, ret;
1063 /* Iterate for number of ports to perform initialization */
1064 for (i = 0; i < num_config; i++) {
1065 p_rt = sdw_port_alloc(&slave->dev, port_config, i);
1066 if (!p_rt)
1067 return -ENOMEM;
1070 * TODO: Check valid port range as defined by DisCo/
1071 * slave
1073 ret = sdw_is_valid_port_range(&slave->dev, p_rt);
1074 if (ret < 0) {
1075 kfree(p_rt);
1076 return ret;
1080 * TODO: Check port capabilities for requested
1081 * configuration (audio mode support)
1084 list_add_tail(&p_rt->port_node, &s_rt->port_list);
1087 return 0;
1091 * sdw_stream_add_master() - Allocate and add master runtime to a stream
1093 * @bus: SDW Bus instance
1094 * @stream_config: Stream configuration for audio stream
1095 * @port_config: Port configuration for audio stream
1096 * @num_ports: Number of ports
1097 * @stream: SoundWire stream
1099 int sdw_stream_add_master(struct sdw_bus *bus,
1100 struct sdw_stream_config *stream_config,
1101 struct sdw_port_config *port_config,
1102 unsigned int num_ports,
1103 struct sdw_stream_runtime *stream)
1105 struct sdw_master_runtime *m_rt = NULL;
1106 int ret;
1108 mutex_lock(&bus->bus_lock);
1110 m_rt = sdw_alloc_master_rt(bus, stream_config, stream);
1111 if (!m_rt) {
1112 dev_err(bus->dev,
1113 "Master runtime config failed for stream:%s",
1114 stream->name);
1115 ret = -ENOMEM;
1116 goto unlock;
1119 ret = sdw_config_stream(bus->dev, stream, stream_config, false);
1120 if (ret)
1121 goto stream_error;
1123 ret = sdw_master_port_config(bus, m_rt, port_config, num_ports);
1124 if (ret)
1125 goto stream_error;
1127 goto unlock;
1129 stream_error:
1130 sdw_release_master_stream(stream);
1131 unlock:
1132 mutex_unlock(&bus->bus_lock);
1133 return ret;
1135 EXPORT_SYMBOL(sdw_stream_add_master);
1138 * sdw_stream_add_slave() - Allocate and add master/slave runtime to a stream
1140 * @slave: SDW Slave instance
1141 * @stream_config: Stream configuration for audio stream
1142 * @stream: SoundWire stream
1143 * @port_config: Port configuration for audio stream
1144 * @num_ports: Number of ports
1146 * It is expected that Slave is added before adding Master
1147 * to the Stream.
1150 int sdw_stream_add_slave(struct sdw_slave *slave,
1151 struct sdw_stream_config *stream_config,
1152 struct sdw_port_config *port_config,
1153 unsigned int num_ports,
1154 struct sdw_stream_runtime *stream)
1156 struct sdw_slave_runtime *s_rt;
1157 struct sdw_master_runtime *m_rt;
1158 int ret;
1160 mutex_lock(&slave->bus->bus_lock);
1163 * If this API is invoked by Slave first then m_rt is not valid.
1164 * So, allocate m_rt and add Slave to it.
1166 m_rt = sdw_alloc_master_rt(slave->bus, stream_config, stream);
1167 if (!m_rt) {
1168 dev_err(&slave->dev,
1169 "alloc master runtime failed for stream:%s",
1170 stream->name);
1171 ret = -ENOMEM;
1172 goto error;
1175 s_rt = sdw_alloc_slave_rt(slave, stream_config, stream);
1176 if (!s_rt) {
1177 dev_err(&slave->dev,
1178 "Slave runtime config failed for stream:%s",
1179 stream->name);
1180 ret = -ENOMEM;
1181 goto stream_error;
1184 ret = sdw_config_stream(&slave->dev, stream, stream_config, true);
1185 if (ret)
1186 goto stream_error;
1188 list_add_tail(&s_rt->m_rt_node, &m_rt->slave_rt_list);
1190 ret = sdw_slave_port_config(slave, s_rt, port_config, num_ports);
1191 if (ret)
1192 goto stream_error;
1195 * Change stream state to CONFIGURED on first Slave add.
1196 * Bus is not aware of number of Slave(s) in a stream at this
1197 * point so cannot depend on all Slave(s) to be added in order to
1198 * change stream state to CONFIGURED.
1200 stream->state = SDW_STREAM_CONFIGURED;
1201 goto error;
1203 stream_error:
1205 * we hit error so cleanup the stream, release all Slave(s) and
1206 * Master runtime
1208 sdw_release_master_stream(stream);
1209 error:
1210 mutex_unlock(&slave->bus->bus_lock);
1211 return ret;
1213 EXPORT_SYMBOL(sdw_stream_add_slave);
1216 * sdw_get_slave_dpn_prop() - Get Slave port capabilities
1218 * @slave: Slave handle
1219 * @direction: Data direction.
1220 * @port_num: Port number
1222 struct sdw_dpn_prop *sdw_get_slave_dpn_prop(struct sdw_slave *slave,
1223 enum sdw_data_direction direction,
1224 unsigned int port_num)
1226 struct sdw_dpn_prop *dpn_prop;
1227 u8 num_ports;
1228 int i;
1230 if (direction == SDW_DATA_DIR_TX) {
1231 num_ports = hweight32(slave->prop.source_ports);
1232 dpn_prop = slave->prop.src_dpn_prop;
1233 } else {
1234 num_ports = hweight32(slave->prop.sink_ports);
1235 dpn_prop = slave->prop.sink_dpn_prop;
1238 for (i = 0; i < num_ports; i++) {
1239 if (dpn_prop[i].num == port_num)
1240 return &dpn_prop[i];
1243 return NULL;
1246 static int _sdw_prepare_stream(struct sdw_stream_runtime *stream)
1248 struct sdw_master_runtime *m_rt = stream->m_rt;
1249 struct sdw_bus *bus = m_rt->bus;
1250 struct sdw_master_prop *prop = NULL;
1251 struct sdw_bus_params params;
1252 int ret;
1254 prop = &bus->prop;
1255 memcpy(&params, &bus->params, sizeof(params));
1257 /* TODO: Support Asynchronous mode */
1258 if ((prop->max_freq % stream->params.rate) != 0) {
1259 dev_err(bus->dev, "Async mode not supported");
1260 return -EINVAL;
1263 /* Increment cumulative bus bandwidth */
1264 /* TODO: Update this during Device-Device support */
1265 bus->params.bandwidth += m_rt->stream->params.rate *
1266 m_rt->ch_count * m_rt->stream->params.bps;
1268 /* Program params */
1269 ret = sdw_program_params(bus);
1270 if (ret < 0) {
1271 dev_err(bus->dev, "Program params failed: %d", ret);
1272 goto restore_params;
1275 ret = do_bank_switch(stream);
1276 if (ret < 0) {
1277 dev_err(bus->dev, "Bank switch failed: %d", ret);
1278 goto restore_params;
1281 /* Prepare port(s) on the new clock configuration */
1282 ret = sdw_prep_deprep_ports(m_rt, true);
1283 if (ret < 0) {
1284 dev_err(bus->dev, "Prepare port(s) failed ret = %d",
1285 ret);
1286 return ret;
1289 stream->state = SDW_STREAM_PREPARED;
1291 return ret;
1293 restore_params:
1294 memcpy(&bus->params, &params, sizeof(params));
1295 return ret;
1299 * sdw_prepare_stream() - Prepare SoundWire stream
1301 * @stream: Soundwire stream
1303 * Documentation/driver-api/soundwire/stream.rst explains this API in detail
1305 int sdw_prepare_stream(struct sdw_stream_runtime *stream)
1307 int ret = 0;
1309 if (!stream) {
1310 pr_err("SoundWire: Handle not found for stream");
1311 return -EINVAL;
1314 mutex_lock(&stream->m_rt->bus->bus_lock);
1316 ret = _sdw_prepare_stream(stream);
1317 if (ret < 0)
1318 pr_err("Prepare for stream:%s failed: %d", stream->name, ret);
1320 mutex_unlock(&stream->m_rt->bus->bus_lock);
1321 return ret;
1323 EXPORT_SYMBOL(sdw_prepare_stream);
1325 static int _sdw_enable_stream(struct sdw_stream_runtime *stream)
1327 struct sdw_master_runtime *m_rt = stream->m_rt;
1328 struct sdw_bus *bus = m_rt->bus;
1329 int ret;
1331 /* Program params */
1332 ret = sdw_program_params(bus);
1333 if (ret < 0) {
1334 dev_err(bus->dev, "Program params failed: %d", ret);
1335 return ret;
1338 /* Enable port(s) */
1339 ret = sdw_enable_disable_ports(m_rt, true);
1340 if (ret < 0) {
1341 dev_err(bus->dev, "Enable port(s) failed ret: %d", ret);
1342 return ret;
1345 ret = do_bank_switch(stream);
1346 if (ret < 0) {
1347 dev_err(bus->dev, "Bank switch failed: %d", ret);
1348 return ret;
1351 stream->state = SDW_STREAM_ENABLED;
1352 return 0;
1356 * sdw_enable_stream() - Enable SoundWire stream
1358 * @stream: Soundwire stream
1360 * Documentation/driver-api/soundwire/stream.rst explains this API in detail
1362 int sdw_enable_stream(struct sdw_stream_runtime *stream)
1364 int ret = 0;
1366 if (!stream) {
1367 pr_err("SoundWire: Handle not found for stream");
1368 return -EINVAL;
1371 mutex_lock(&stream->m_rt->bus->bus_lock);
1373 ret = _sdw_enable_stream(stream);
1374 if (ret < 0)
1375 pr_err("Enable for stream:%s failed: %d", stream->name, ret);
1377 mutex_unlock(&stream->m_rt->bus->bus_lock);
1378 return ret;
1380 EXPORT_SYMBOL(sdw_enable_stream);
1382 static int _sdw_disable_stream(struct sdw_stream_runtime *stream)
1384 struct sdw_master_runtime *m_rt = stream->m_rt;
1385 struct sdw_bus *bus = m_rt->bus;
1386 int ret;
1388 /* Disable port(s) */
1389 ret = sdw_enable_disable_ports(m_rt, false);
1390 if (ret < 0) {
1391 dev_err(bus->dev, "Disable port(s) failed: %d", ret);
1392 return ret;
1395 stream->state = SDW_STREAM_DISABLED;
1397 /* Program params */
1398 ret = sdw_program_params(bus);
1399 if (ret < 0) {
1400 dev_err(bus->dev, "Program params failed: %d", ret);
1401 return ret;
1404 return do_bank_switch(stream);
1408 * sdw_disable_stream() - Disable SoundWire stream
1410 * @stream: Soundwire stream
1412 * Documentation/driver-api/soundwire/stream.rst explains this API in detail
1414 int sdw_disable_stream(struct sdw_stream_runtime *stream)
1416 int ret = 0;
1418 if (!stream) {
1419 pr_err("SoundWire: Handle not found for stream");
1420 return -EINVAL;
1423 mutex_lock(&stream->m_rt->bus->bus_lock);
1425 ret = _sdw_disable_stream(stream);
1426 if (ret < 0)
1427 pr_err("Disable for stream:%s failed: %d", stream->name, ret);
1429 mutex_unlock(&stream->m_rt->bus->bus_lock);
1430 return ret;
1432 EXPORT_SYMBOL(sdw_disable_stream);
1434 static int _sdw_deprepare_stream(struct sdw_stream_runtime *stream)
1436 struct sdw_master_runtime *m_rt = stream->m_rt;
1437 struct sdw_bus *bus = m_rt->bus;
1438 int ret = 0;
1440 /* De-prepare port(s) */
1441 ret = sdw_prep_deprep_ports(m_rt, false);
1442 if (ret < 0) {
1443 dev_err(bus->dev, "De-prepare port(s) failed: %d", ret);
1444 return ret;
1447 stream->state = SDW_STREAM_DEPREPARED;
1449 /* TODO: Update this during Device-Device support */
1450 bus->params.bandwidth -= m_rt->stream->params.rate *
1451 m_rt->ch_count * m_rt->stream->params.bps;
1453 /* Program params */
1454 ret = sdw_program_params(bus);
1455 if (ret < 0) {
1456 dev_err(bus->dev, "Program params failed: %d", ret);
1457 return ret;
1460 return do_bank_switch(stream);
1464 * sdw_deprepare_stream() - Deprepare SoundWire stream
1466 * @stream: Soundwire stream
1468 * Documentation/driver-api/soundwire/stream.rst explains this API in detail
1470 int sdw_deprepare_stream(struct sdw_stream_runtime *stream)
1472 int ret = 0;
1474 if (!stream) {
1475 pr_err("SoundWire: Handle not found for stream");
1476 return -EINVAL;
1479 mutex_lock(&stream->m_rt->bus->bus_lock);
1481 ret = _sdw_deprepare_stream(stream);
1482 if (ret < 0)
1483 pr_err("De-prepare for stream:%d failed: %d", ret, ret);
1485 mutex_unlock(&stream->m_rt->bus->bus_lock);
1486 return ret;
1488 EXPORT_SYMBOL(sdw_deprepare_stream);