查看“SAI Linux driver”的源代码

== Article purpose ==
本文介绍了适用于[[SAI internal peripheral]]的SAI Linux<sup>&reg;</sup> 驱动程序。

== Short Description ==
SAI<ref name="SAI internal peripheral">[[SAI internal peripheral]]</ref> Linux驱动程序是在Linux [[ALSA_overview|ALSA framework]]中实现的ASoC CPU DAI驱动程序。

== Configuration ==

=== Kernel Configuration ===
使用Linux Menuconfig工具在内核配置中激活SAI <ref name="SAI internal peripheral"/> Linux驱动程序： [[Menuconfig or how to configure kernel]].
<pre>
[*] Device Drivers
    [*] Sound card support
        [*] Advanced Linux Sound Architecture
            [*] ALSA for SoC audio support
                STMicroelectronics STM32 SOC audio support
	             [*] STM32 SAI interface (Serial Audio Interface) support
</pre>

=== Device tree ===
配置SAI Linux内核驱动时，请参考[[SAI device tree configuration]] 文章。

== How to use ==
可以通过ALSA设备从用户域访问SAI Linux驱动程序。有关如何列出和使用ALSA设备的信息，请参考[[ALSA_overview#How_to_use|ALSA overview]] 。

==How to trace and debug==
可以检查[[Debugfs|debugfs]] 和procfs文件系统以获取有关SAI驱动程序及其使用的资源的信息。 下面提供了这些文件系统条目的详尽列表。 有关调试工具的更多详细信息，请参见[[ALSA_overview#How_to_trace_and_debug_the_framework|ALSA overview]] 。

* debugfs条目:
:* '''asoc''': 请参阅 [[ALSA_overview#How_to_monitor]]
:* '''clk''': 请参阅 [[Clock_overview#How_to_monitor_with_debugfs]] 以获取有关时钟的信息。
:* '''pinctrl''': 请参阅 [[Pinctrl_overview#How_to_monitor]] 以获取有关PIN的信息。
:* '''regmap''': 允许监视SAI外设寄存器。
<div style="margin-left: 2em;">
 $ cat /sys/kernel/debug/regmap/xxx.audio-controller/registers
</div>
* procfs条目：
:* '''asound''': 请参阅 [[ALSA_overview#How_to_debug]]
:* '''interrupts''': 允许检查中断。
<div style="margin-left: 2em;">
 $ cat /proc/interrupts
</div>

== Source code location ==
The STM32 SAI peripheral includes two independent audio subblocks that share common resources. The driver source code reflects this architecture.

{{CodeSource | Linux kernel | sound/soc/stm/stm32_sai.c}}: handles common resources such as clock, interrupt, reset and shared register.

{{CodeSource | Linux kernel | sound/soc/stm/stm32_sai_sub.c}}: handles the resources dedicated to each subblock.

==References==
<references />