1 // SPDX-License-Identifier: GPL-2.0-only
3 * HD-audio controller helpers
6 #include <linux/kernel.h>
7 #include <linux/delay.h>
8 #include <linux/export.h>
9 #include <sound/core.h>
10 #include <sound/hdaudio.h>
11 #include <sound/hda_register.h>
14 /* clear CORB read pointer properly */
15 static void azx_clear_corbrp(struct hdac_bus
*bus
)
19 for (timeout
= 1000; timeout
> 0; timeout
--) {
20 if (snd_hdac_chip_readw(bus
, CORBRP
) & AZX_CORBRP_RST
)
25 dev_err(bus
->dev
, "CORB reset timeout#1, CORBRP = %d\n",
26 snd_hdac_chip_readw(bus
, CORBRP
));
28 snd_hdac_chip_writew(bus
, CORBRP
, 0);
29 for (timeout
= 1000; timeout
> 0; timeout
--) {
30 if (snd_hdac_chip_readw(bus
, CORBRP
) == 0)
35 dev_err(bus
->dev
, "CORB reset timeout#2, CORBRP = %d\n",
36 snd_hdac_chip_readw(bus
, CORBRP
));
40 * snd_hdac_bus_init_cmd_io - set up CORB/RIRB buffers
41 * @bus: HD-audio core bus
43 void snd_hdac_bus_init_cmd_io(struct hdac_bus
*bus
)
45 WARN_ON_ONCE(!bus
->rb
.area
);
47 spin_lock_irq(&bus
->reg_lock
);
49 bus
->corb
.addr
= bus
->rb
.addr
;
50 bus
->corb
.buf
= (__le32
*)bus
->rb
.area
;
51 snd_hdac_chip_writel(bus
, CORBLBASE
, (u32
)bus
->corb
.addr
);
52 snd_hdac_chip_writel(bus
, CORBUBASE
, upper_32_bits(bus
->corb
.addr
));
54 /* set the corb size to 256 entries (ULI requires explicitly) */
55 snd_hdac_chip_writeb(bus
, CORBSIZE
, 0x02);
56 /* set the corb write pointer to 0 */
57 snd_hdac_chip_writew(bus
, CORBWP
, 0);
59 /* reset the corb hw read pointer */
60 snd_hdac_chip_writew(bus
, CORBRP
, AZX_CORBRP_RST
);
61 if (!bus
->corbrp_self_clear
)
62 azx_clear_corbrp(bus
);
65 snd_hdac_chip_writeb(bus
, CORBCTL
, AZX_CORBCTL_RUN
);
68 bus
->rirb
.addr
= bus
->rb
.addr
+ 2048;
69 bus
->rirb
.buf
= (__le32
*)(bus
->rb
.area
+ 2048);
70 bus
->rirb
.wp
= bus
->rirb
.rp
= 0;
71 memset(bus
->rirb
.cmds
, 0, sizeof(bus
->rirb
.cmds
));
72 snd_hdac_chip_writel(bus
, RIRBLBASE
, (u32
)bus
->rirb
.addr
);
73 snd_hdac_chip_writel(bus
, RIRBUBASE
, upper_32_bits(bus
->rirb
.addr
));
75 /* set the rirb size to 256 entries (ULI requires explicitly) */
76 snd_hdac_chip_writeb(bus
, RIRBSIZE
, 0x02);
77 /* reset the rirb hw write pointer */
78 snd_hdac_chip_writew(bus
, RIRBWP
, AZX_RIRBWP_RST
);
79 /* set N=1, get RIRB response interrupt for new entry */
80 snd_hdac_chip_writew(bus
, RINTCNT
, 1);
81 /* enable rirb dma and response irq */
82 snd_hdac_chip_writeb(bus
, RIRBCTL
, AZX_RBCTL_DMA_EN
| AZX_RBCTL_IRQ_EN
);
83 /* Accept unsolicited responses */
84 snd_hdac_chip_updatel(bus
, GCTL
, AZX_GCTL_UNSOL
, AZX_GCTL_UNSOL
);
85 spin_unlock_irq(&bus
->reg_lock
);
87 EXPORT_SYMBOL_GPL(snd_hdac_bus_init_cmd_io
);
89 /* wait for cmd dmas till they are stopped */
90 static void hdac_wait_for_cmd_dmas(struct hdac_bus
*bus
)
92 unsigned long timeout
;
94 timeout
= jiffies
+ msecs_to_jiffies(100);
95 while ((snd_hdac_chip_readb(bus
, RIRBCTL
) & AZX_RBCTL_DMA_EN
)
96 && time_before(jiffies
, timeout
))
99 timeout
= jiffies
+ msecs_to_jiffies(100);
100 while ((snd_hdac_chip_readb(bus
, CORBCTL
) & AZX_CORBCTL_RUN
)
101 && time_before(jiffies
, timeout
))
106 * snd_hdac_bus_stop_cmd_io - clean up CORB/RIRB buffers
107 * @bus: HD-audio core bus
109 void snd_hdac_bus_stop_cmd_io(struct hdac_bus
*bus
)
111 spin_lock_irq(&bus
->reg_lock
);
112 /* disable ringbuffer DMAs */
113 snd_hdac_chip_writeb(bus
, RIRBCTL
, 0);
114 snd_hdac_chip_writeb(bus
, CORBCTL
, 0);
115 spin_unlock_irq(&bus
->reg_lock
);
117 hdac_wait_for_cmd_dmas(bus
);
119 spin_lock_irq(&bus
->reg_lock
);
120 /* disable unsolicited responses */
121 snd_hdac_chip_updatel(bus
, GCTL
, AZX_GCTL_UNSOL
, 0);
122 spin_unlock_irq(&bus
->reg_lock
);
124 EXPORT_SYMBOL_GPL(snd_hdac_bus_stop_cmd_io
);
126 static unsigned int azx_command_addr(u32 cmd
)
128 unsigned int addr
= cmd
>> 28;
130 if (snd_BUG_ON(addr
>= HDA_MAX_CODECS
))
136 * snd_hdac_bus_send_cmd - send a command verb via CORB
137 * @bus: HD-audio core bus
138 * @val: encoded verb value to send
140 * Returns zero for success or a negative error code.
142 int snd_hdac_bus_send_cmd(struct hdac_bus
*bus
, unsigned int val
)
144 unsigned int addr
= azx_command_addr(val
);
147 spin_lock_irq(&bus
->reg_lock
);
149 bus
->last_cmd
[azx_command_addr(val
)] = val
;
151 /* add command to corb */
152 wp
= snd_hdac_chip_readw(bus
, CORBWP
);
154 /* something wrong, controller likely turned to D3 */
155 spin_unlock_irq(&bus
->reg_lock
);
159 wp
%= AZX_MAX_CORB_ENTRIES
;
161 rp
= snd_hdac_chip_readw(bus
, CORBRP
);
163 /* oops, it's full */
164 spin_unlock_irq(&bus
->reg_lock
);
168 bus
->rirb
.cmds
[addr
]++;
169 bus
->corb
.buf
[wp
] = cpu_to_le32(val
);
170 snd_hdac_chip_writew(bus
, CORBWP
, wp
);
172 spin_unlock_irq(&bus
->reg_lock
);
176 EXPORT_SYMBOL_GPL(snd_hdac_bus_send_cmd
);
178 #define AZX_RIRB_EX_UNSOL_EV (1<<4)
181 * snd_hdac_bus_update_rirb - retrieve RIRB entries
182 * @bus: HD-audio core bus
184 * Usually called from interrupt handler.
185 * The caller needs bus->reg_lock spinlock before calling this.
187 void snd_hdac_bus_update_rirb(struct hdac_bus
*bus
)
193 wp
= snd_hdac_chip_readw(bus
, RIRBWP
);
195 /* something wrong, controller likely turned to D3 */
199 if (wp
== bus
->rirb
.wp
)
203 while (bus
->rirb
.rp
!= wp
) {
205 bus
->rirb
.rp
%= AZX_MAX_RIRB_ENTRIES
;
207 rp
= bus
->rirb
.rp
<< 1; /* an RIRB entry is 8-bytes */
208 res_ex
= le32_to_cpu(bus
->rirb
.buf
[rp
+ 1]);
209 res
= le32_to_cpu(bus
->rirb
.buf
[rp
]);
211 if (addr
>= HDA_MAX_CODECS
) {
213 "spurious response %#x:%#x, rp = %d, wp = %d",
214 res
, res_ex
, bus
->rirb
.rp
, wp
);
216 } else if (res_ex
& AZX_RIRB_EX_UNSOL_EV
)
217 snd_hdac_bus_queue_event(bus
, res
, res_ex
);
218 else if (bus
->rirb
.cmds
[addr
]) {
219 bus
->rirb
.res
[addr
] = res
;
220 bus
->rirb
.cmds
[addr
]--;
221 if (!bus
->rirb
.cmds
[addr
] &&
222 waitqueue_active(&bus
->rirb_wq
))
223 wake_up(&bus
->rirb_wq
);
225 dev_err_ratelimited(bus
->dev
,
226 "spurious response %#x:%#x, last cmd=%#08x\n",
227 res
, res_ex
, bus
->last_cmd
[addr
]);
231 EXPORT_SYMBOL_GPL(snd_hdac_bus_update_rirb
);
234 * snd_hdac_bus_get_response - receive a response via RIRB
235 * @bus: HD-audio core bus
236 * @addr: codec address
237 * @res: pointer to store the value, NULL when not needed
239 * Returns zero if a value is read, or a negative error code.
241 int snd_hdac_bus_get_response(struct hdac_bus
*bus
, unsigned int addr
,
244 unsigned long timeout
;
245 unsigned long loopcounter
;
246 wait_queue_entry_t wait
;
249 init_wait_entry(&wait
, 0);
250 timeout
= jiffies
+ msecs_to_jiffies(1000);
252 for (loopcounter
= 0;; loopcounter
++) {
253 spin_lock_irq(&bus
->reg_lock
);
254 if (!bus
->polling_mode
)
255 prepare_to_wait(&bus
->rirb_wq
, &wait
,
256 TASK_UNINTERRUPTIBLE
);
257 if (bus
->polling_mode
)
258 snd_hdac_bus_update_rirb(bus
);
259 if (!bus
->rirb
.cmds
[addr
]) {
261 *res
= bus
->rirb
.res
[addr
]; /* the last value */
262 if (!bus
->polling_mode
)
263 finish_wait(&bus
->rirb_wq
, &wait
);
264 spin_unlock_irq(&bus
->reg_lock
);
267 spin_unlock_irq(&bus
->reg_lock
);
268 if (time_after(jiffies
, timeout
))
270 #define LOOP_COUNT_MAX 3000
271 if (!bus
->polling_mode
) {
272 schedule_timeout(msecs_to_jiffies(2));
273 } else if (bus
->needs_damn_long_delay
||
274 loopcounter
> LOOP_COUNT_MAX
) {
275 if (loopcounter
> LOOP_COUNT_MAX
&& !warned
) {
276 dev_dbg_ratelimited(bus
->dev
,
277 "too slow response, last cmd=%#08x\n",
278 bus
->last_cmd
[addr
]);
281 msleep(2); /* temporary workaround */
288 if (!bus
->polling_mode
)
289 finish_wait(&bus
->rirb_wq
, &wait
);
293 EXPORT_SYMBOL_GPL(snd_hdac_bus_get_response
);
295 #define HDAC_MAX_CAPS 10
297 * snd_hdac_bus_parse_capabilities - parse capability structure
298 * @bus: the pointer to bus object
300 * Returns 0 if successful, or a negative error code.
302 int snd_hdac_bus_parse_capabilities(struct hdac_bus
*bus
)
304 unsigned int cur_cap
;
306 unsigned int counter
= 0;
308 offset
= snd_hdac_chip_readw(bus
, LLCH
);
310 /* Lets walk the linked capabilities list */
312 cur_cap
= _snd_hdac_chip_readl(bus
, offset
);
314 dev_dbg(bus
->dev
, "Capability version: 0x%x\n",
315 (cur_cap
& AZX_CAP_HDR_VER_MASK
) >> AZX_CAP_HDR_VER_OFF
);
317 dev_dbg(bus
->dev
, "HDA capability ID: 0x%x\n",
318 (cur_cap
& AZX_CAP_HDR_ID_MASK
) >> AZX_CAP_HDR_ID_OFF
);
321 dev_dbg(bus
->dev
, "Invalid capability reg read\n");
325 switch ((cur_cap
& AZX_CAP_HDR_ID_MASK
) >> AZX_CAP_HDR_ID_OFF
) {
327 dev_dbg(bus
->dev
, "Found ML capability\n");
328 bus
->mlcap
= bus
->remap_addr
+ offset
;
332 dev_dbg(bus
->dev
, "Found GTS capability offset=%x\n", offset
);
333 bus
->gtscap
= bus
->remap_addr
+ offset
;
337 /* PP capability found, the Audio DSP is present */
338 dev_dbg(bus
->dev
, "Found PP capability offset=%x\n", offset
);
339 bus
->ppcap
= bus
->remap_addr
+ offset
;
343 /* SPIB capability found, handler function */
344 dev_dbg(bus
->dev
, "Found SPB capability\n");
345 bus
->spbcap
= bus
->remap_addr
+ offset
;
348 case AZX_DRSM_CAP_ID
:
349 /* DMA resume capability found, handler function */
350 dev_dbg(bus
->dev
, "Found DRSM capability\n");
351 bus
->drsmcap
= bus
->remap_addr
+ offset
;
355 dev_err(bus
->dev
, "Unknown capability %d\n", cur_cap
);
362 if (counter
> HDAC_MAX_CAPS
) {
363 dev_err(bus
->dev
, "We exceeded HDAC capabilities!!!\n");
367 /* read the offset of next capability */
368 offset
= cur_cap
& AZX_CAP_HDR_NXT_PTR_MASK
;
374 EXPORT_SYMBOL_GPL(snd_hdac_bus_parse_capabilities
);
381 * snd_hdac_bus_enter_link_reset - enter link reset
382 * @bus: HD-audio core bus
384 * Enter to the link reset state.
386 void snd_hdac_bus_enter_link_reset(struct hdac_bus
*bus
)
388 unsigned long timeout
;
390 /* reset controller */
391 snd_hdac_chip_updatel(bus
, GCTL
, AZX_GCTL_RESET
, 0);
393 timeout
= jiffies
+ msecs_to_jiffies(100);
394 while ((snd_hdac_chip_readb(bus
, GCTL
) & AZX_GCTL_RESET
) &&
395 time_before(jiffies
, timeout
))
396 usleep_range(500, 1000);
398 EXPORT_SYMBOL_GPL(snd_hdac_bus_enter_link_reset
);
401 * snd_hdac_bus_exit_link_reset - exit link reset
402 * @bus: HD-audio core bus
404 * Exit from the link reset state.
406 void snd_hdac_bus_exit_link_reset(struct hdac_bus
*bus
)
408 unsigned long timeout
;
410 snd_hdac_chip_updateb(bus
, GCTL
, AZX_GCTL_RESET
, AZX_GCTL_RESET
);
412 timeout
= jiffies
+ msecs_to_jiffies(100);
413 while (!snd_hdac_chip_readb(bus
, GCTL
) && time_before(jiffies
, timeout
))
414 usleep_range(500, 1000);
416 EXPORT_SYMBOL_GPL(snd_hdac_bus_exit_link_reset
);
418 /* reset codec link */
419 int snd_hdac_bus_reset_link(struct hdac_bus
*bus
, bool full_reset
)
425 snd_hdac_chip_writew(bus
, STATESTS
, STATESTS_INT_MASK
);
427 /* reset controller */
428 snd_hdac_bus_enter_link_reset(bus
);
430 /* delay for >= 100us for codec PLL to settle per spec
431 * Rev 0.9 section 5.5.1
433 usleep_range(500, 1000);
435 /* Bring controller out of reset */
436 snd_hdac_bus_exit_link_reset(bus
);
438 /* Brent Chartrand said to wait >= 540us for codecs to initialize */
439 usleep_range(1000, 1200);
442 /* check to see if controller is ready */
443 if (!snd_hdac_chip_readb(bus
, GCTL
)) {
444 dev_dbg(bus
->dev
, "controller not ready!\n");
449 if (!bus
->codec_mask
) {
450 bus
->codec_mask
= snd_hdac_chip_readw(bus
, STATESTS
);
451 dev_dbg(bus
->dev
, "codec_mask = 0x%lx\n", bus
->codec_mask
);
456 EXPORT_SYMBOL_GPL(snd_hdac_bus_reset_link
);
458 /* enable interrupts */
459 static void azx_int_enable(struct hdac_bus
*bus
)
461 /* enable controller CIE and GIE */
462 snd_hdac_chip_updatel(bus
, INTCTL
,
463 AZX_INT_CTRL_EN
| AZX_INT_GLOBAL_EN
,
464 AZX_INT_CTRL_EN
| AZX_INT_GLOBAL_EN
);
467 /* disable interrupts */
468 static void azx_int_disable(struct hdac_bus
*bus
)
470 struct hdac_stream
*azx_dev
;
472 /* disable interrupts in stream descriptor */
473 list_for_each_entry(azx_dev
, &bus
->stream_list
, list
)
474 snd_hdac_stream_updateb(azx_dev
, SD_CTL
, SD_INT_MASK
, 0);
476 /* disable SIE for all streams */
477 snd_hdac_chip_writeb(bus
, INTCTL
, 0);
479 /* disable controller CIE and GIE */
480 snd_hdac_chip_updatel(bus
, INTCTL
, AZX_INT_CTRL_EN
| AZX_INT_GLOBAL_EN
, 0);
483 /* clear interrupts */
484 static void azx_int_clear(struct hdac_bus
*bus
)
486 struct hdac_stream
*azx_dev
;
488 /* clear stream status */
489 list_for_each_entry(azx_dev
, &bus
->stream_list
, list
)
490 snd_hdac_stream_writeb(azx_dev
, SD_STS
, SD_INT_MASK
);
493 snd_hdac_chip_writew(bus
, STATESTS
, STATESTS_INT_MASK
);
495 /* clear rirb status */
496 snd_hdac_chip_writeb(bus
, RIRBSTS
, RIRB_INT_MASK
);
498 /* clear int status */
499 snd_hdac_chip_writel(bus
, INTSTS
, AZX_INT_CTRL_EN
| AZX_INT_ALL_STREAM
);
503 * snd_hdac_bus_init_chip - reset and start the controller registers
504 * @bus: HD-audio core bus
505 * @full_reset: Do full reset
507 bool snd_hdac_bus_init_chip(struct hdac_bus
*bus
, bool full_reset
)
512 /* reset controller */
513 snd_hdac_bus_reset_link(bus
, full_reset
);
515 /* clear interrupts */
518 /* initialize the codec command I/O */
519 snd_hdac_bus_init_cmd_io(bus
);
521 /* enable interrupts after CORB/RIRB buffers are initialized above */
524 /* program the position buffer */
525 if (bus
->use_posbuf
&& bus
->posbuf
.addr
) {
526 snd_hdac_chip_writel(bus
, DPLBASE
, (u32
)bus
->posbuf
.addr
);
527 snd_hdac_chip_writel(bus
, DPUBASE
, upper_32_bits(bus
->posbuf
.addr
));
530 bus
->chip_init
= true;
534 EXPORT_SYMBOL_GPL(snd_hdac_bus_init_chip
);
537 * snd_hdac_bus_stop_chip - disable the whole IRQ and I/Os
538 * @bus: HD-audio core bus
540 void snd_hdac_bus_stop_chip(struct hdac_bus
*bus
)
545 /* disable interrupts */
546 azx_int_disable(bus
);
549 /* disable CORB/RIRB */
550 snd_hdac_bus_stop_cmd_io(bus
);
552 /* disable position buffer */
553 if (bus
->posbuf
.addr
) {
554 snd_hdac_chip_writel(bus
, DPLBASE
, 0);
555 snd_hdac_chip_writel(bus
, DPUBASE
, 0);
558 bus
->chip_init
= false;
560 EXPORT_SYMBOL_GPL(snd_hdac_bus_stop_chip
);
563 * snd_hdac_bus_handle_stream_irq - interrupt handler for streams
564 * @bus: HD-audio core bus
565 * @status: INTSTS register value
566 * @ack: callback to be called for woken streams
568 * Returns the bits of handled streams, or zero if no stream is handled.
570 int snd_hdac_bus_handle_stream_irq(struct hdac_bus
*bus
, unsigned int status
,
571 void (*ack
)(struct hdac_bus
*,
572 struct hdac_stream
*))
574 struct hdac_stream
*azx_dev
;
578 list_for_each_entry(azx_dev
, &bus
->stream_list
, list
) {
579 if (status
& azx_dev
->sd_int_sta_mask
) {
580 sd_status
= snd_hdac_stream_readb(azx_dev
, SD_STS
);
581 snd_hdac_stream_writeb(azx_dev
, SD_STS
, SD_INT_MASK
);
582 handled
|= 1 << azx_dev
->index
;
583 if (!azx_dev
->substream
|| !azx_dev
->running
||
584 !(sd_status
& SD_INT_COMPLETE
))
592 EXPORT_SYMBOL_GPL(snd_hdac_bus_handle_stream_irq
);
595 * snd_hdac_bus_alloc_stream_pages - allocate BDL and other buffers
596 * @bus: HD-audio core bus
598 * Call this after assigning the all streams.
599 * Returns zero for success, or a negative error code.
601 int snd_hdac_bus_alloc_stream_pages(struct hdac_bus
*bus
)
603 struct hdac_stream
*s
;
605 int dma_type
= bus
->dma_type
? bus
->dma_type
: SNDRV_DMA_TYPE_DEV
;
608 list_for_each_entry(s
, &bus
->stream_list
, list
) {
609 /* allocate memory for the BDL for each stream */
610 err
= snd_dma_alloc_pages(dma_type
, bus
->dev
,
617 if (WARN_ON(!num_streams
))
619 /* allocate memory for the position buffer */
620 err
= snd_dma_alloc_pages(dma_type
, bus
->dev
,
621 num_streams
* 8, &bus
->posbuf
);
624 list_for_each_entry(s
, &bus
->stream_list
, list
)
625 s
->posbuf
= (__le32
*)(bus
->posbuf
.area
+ s
->index
* 8);
627 /* single page (at least 4096 bytes) must suffice for both ringbuffes */
628 return snd_dma_alloc_pages(dma_type
, bus
->dev
, PAGE_SIZE
, &bus
->rb
);
630 EXPORT_SYMBOL_GPL(snd_hdac_bus_alloc_stream_pages
);
633 * snd_hdac_bus_free_stream_pages - release BDL and other buffers
634 * @bus: HD-audio core bus
636 void snd_hdac_bus_free_stream_pages(struct hdac_bus
*bus
)
638 struct hdac_stream
*s
;
640 list_for_each_entry(s
, &bus
->stream_list
, list
) {
642 snd_dma_free_pages(&s
->bdl
);
646 snd_dma_free_pages(&bus
->rb
);
647 if (bus
->posbuf
.area
)
648 snd_dma_free_pages(&bus
->posbuf
);
650 EXPORT_SYMBOL_GPL(snd_hdac_bus_free_stream_pages
);