“I2S device tree configuration”的版本间的差异

来自百问网嵌入式Linux wiki
 
第1行: 第1行:
 
== Article purpose ==
 
== Article purpose ==
This article explains how to configure the [[SPI internal peripheral|SPI/I2S internal peripheral]] when it is assigned to the '''Linux® OS'''. In that case, it is controlled by the [[ALSA_overview|ALSA framework]].
+
本文介绍了将[[SPI internal peripheral|SPI/I2S internal peripheral]]分配给'''Linux® OS'''时如何配置。 在这种情况下,它由[[ALSA_overview|ALSA framework]]控制。
  
The configuration is performed using the [[Device_tree|device tree]] mechanism that provides a hardware description of the I2S peripheral, used by the [[I2S_Linux_driver|I2S linux driver]].
+
使用 [[Device_tree|device tree]] 机制执行配置,该机制提供了[[I2S_Linux_driver|I2S linux driver]]使用的I2S外设的硬件描述。
  
If the peripheral is assigned to another execution context, refer to [[How to assign an internal peripheral to a runtime context]] article for guidelines on peripheral assignment and configuration.
+
如果外围设备已分配给另一个执行上下文,请参阅 [[How to assign an internal peripheral to a runtime context]] 文章,以获取有关外围设备分配和配置的准则。
  
 
== DT bindings documentation ==
 
== DT bindings documentation ==
STM32 I2S device tree bindings <ref name="i2s bindings">{{CodeSource | Linux kernel | Documentation/devicetree/bindings/sound/st,stm32-i2s.txt}}</ref> describes all the required and optional configuration properties.
+
STM32 I2S设备树绑定<ref name="i2s bindings">{{CodeSource | Linux kernel | Documentation/devicetree/bindings/sound/st,stm32-i2s.txt}}</ref> 描述了所有必需的和可选的配置属性。
  
 
== DT configuration ==
 
== DT configuration ==
This hardware description is a combination of STM32 microprocessor <ref name="stm32mp157c.dtsi">{{CodeSource | Linux kernel | arch/arm/boot/dts/stm32mp157c.dtsi}}</ref> and board device tree files. See the [[Device tree]] for an explanation of the device tree file split.
+
此硬件描述是STM32微处理器 <ref name="stm32mp157c.dtsi">{{CodeSource | Linux kernel | arch/arm/boot/dts/stm32mp157c.dtsi}}</ref> and board device tree files. See the [[Device tree]] 和板设备树文件。
  
'''STM32CubeMX''' can be used to generate the board device tree. Refer to [[#How_to_configure_the_DT_using_STM32CubeMX|How to configure the DT using STM32CubeMX]] for more details.
+
'''STM32CubeMX'''可用于生成板卡设备树。有关更多详细信息,请参考 Refer to [[#How_to_configure_the_DT_using_STM32CubeMX|How to configure the DT using STM32CubeMX]]
  
 
=== DT configuration (STM32 level) ===
 
=== DT configuration (STM32 level) ===
The I2S node is declared in stm32mp157c.dtsi<ref name="stm32mp157c.dtsi">{{CodeSource | Linux kernel | arch/arm/boot/dts/stm32mp157c.dtsi}}</ref>.  
+
I2S节点在stm32mp157c.dtsi <ref name="stm32mp157c.dtsi">{{CodeSource | Linux kernel | arch/arm/boot/dts/stm32mp157c.dtsi}}</ref>.  
It describes the hardware parameters such as register addresses, interrupt, clock, and DMA. This set of properties may not vary for a given STM32MPU.
+
它描述了硬件参数,例如寄存器地址,中断,时钟和DMA。 对于给定的STM32MPU,这组属性可能不会发生变化。
{{Warning|This device tree part is related to STM32 microprocessors. It must be kept as is, without being modified by the end-user.}}
+
 
 +
{{Warning|该设备树部分与STM32微处理器有关。它必须保持原样,而不能由最终用户修改。}}
  
 
=== DT configuration (board level) ===
 
=== DT configuration (board level) ===
  
The I2S is an audio peripheral, which can be used as a component of a soundcard through Linux<sup>&reg;</sup> kernel [[ALSA overview|ALSA framework]]. This part of the device tree allows the configuration of the I2S to implement a soundcard. Refer to [[Soundcard configuration|soundcard configuration]] for examples of I2S configuration for various boards.
+
I2S是一个音频外设,可以通过Linux<sup>&reg;</sup> kernel [[ALSA overview|ALSA framework]]作为声卡的一个组件。 设备树的这一部分允许I2S的配置来实现声卡。 有关各种板卡的I2S配置示例,请参阅[[Soundcard configuration|soundcard configuration]]
  
 
==How to configure the DT using STM32CubeMX==
 
==How to configure the DT using STM32CubeMX==
The [[STM32CubeMX]] tool can be used to configure the STM32MPU device and get the corresponding [[Device_tree#STM32|platform configuration device tree]] files.<br />
+
[[STM32CubeMX]] 工具可用于配置STM32MPU设备并获取相应的 [[Device_tree#STM32|platform configuration device tree]] 文件。<br />
STM32CubeMX may not support all the properties described in the above [[#DT bindings documentation|DT bindings documentation]] paragraph. If so, the tool inserts '''user sections''' in the generated device tree. These sections can then be edited to add some properties and are preserved from one generation to another. Refer to the [[STM32CubeMX]] user manual for further information.
+
STM32CubeMX可能不支持上述 [[#DT bindings documentation|DT bindings documentation]]段落中描述的所有属性。
{{Warning|STM32CubeMX does not allow the generation of all the nodes required to configure a soundcard. The soundcard node and the codec nodes have to be filled manually through user sections.}}
+
如果是这样,该工具会在生成的设备树中插入'''用户部分''' 然后可以编辑这些部分以添加一些属性,并将它们保留下来。 有关详细信息,请参阅[[STM32CubeMX]] 用户手册。
 +
{{Warning|STM32CubeMX不允许生成配置声卡所需的所有节点。 声卡节点和编解码器节点必须通过用户部分手动填充。}}
  
 
==References==
 
==References==
  
 
<references />
 
<references />
 
<noinclude>
 
[[Category:Device tree configuration]]
 
[[Category:ALSA]]
 
{{ArticleBasedOnModel | Peripheral or framework device tree configuration model}}
 
{{PublicationRequestId | 13535 | 2019-10-04 | }}
 
</noinclude>
 

2020年11月5日 (四) 10:35的最新版本

Article purpose

本文介绍了将SPI/I2S internal peripheral分配给Linux® OS时如何配置。 在这种情况下,它由ALSA framework控制。

使用 device tree 机制执行配置,该机制提供了I2S linux driver使用的I2S外设的硬件描述。

如果外围设备已分配给另一个执行上下文,请参阅 How to assign an internal peripheral to a runtime context 文章,以获取有关外围设备分配和配置的准则。

DT bindings documentation

STM32 I2S设备树绑定[1] 描述了所有必需的和可选的配置属性。

DT configuration

此硬件描述是STM32微处理器 [2] and board device tree files. See the Device tree 和板设备树文件。

STM32CubeMX可用于生成板卡设备树。有关更多详细信息,请参考 Refer to How to configure the DT using STM32CubeMX

DT configuration (STM32 level)

I2S节点在stm32mp157c.dtsi [2]. 它描述了硬件参数,例如寄存器地址,中断,时钟和DMA。 对于给定的STM32MPU,这组属性可能不会发生变化。

Warning.png 该设备树部分与STM32微处理器有关。它必须保持原样,而不能由最终用户修改。

DT configuration (board level)

I2S是一个音频外设,可以通过Linux® kernel ALSA framework作为声卡的一个组件。 设备树的这一部分允许I2S的配置来实现声卡。 有关各种板卡的I2S配置示例,请参阅soundcard configuration

How to configure the DT using STM32CubeMX

STM32CubeMX 工具可用于配置STM32MPU设备并获取相应的 platform configuration device tree 文件。
STM32CubeMX可能不支持上述 DT bindings documentation段落中描述的所有属性。

如果是这样,该工具会在生成的设备树中插入用户部分 然后可以编辑这些部分以添加一些属性,并将它们保留下来。 有关详细信息,请参阅STM32CubeMX 用户手册。
Warning.png STM32CubeMX不允许生成配置声卡所需的所有节点。 声卡节点和编解码器节点必须通过用户部分手动填充。