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

来自百问网嵌入式Linux wiki
 
(未显示同一用户的4个中间版本)
第1行: 第1行:
 
== Article purpose ==
 
== Article purpose ==
This article explains how to configure the [[SPDIFRX internal peripheral]] when it is assigned to the '''Linux® OS'''. In that case, it is controlled by the [[ALSA_overview|ALSA framework]].
+
本文介绍了在将[[SPDIFRX 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 SPDIFRX peripheral, used by the [[SPDIFRX_Linux_driver|SPDFIRX linux driver]].
+
使用 [[Device_tree|device tree]] 机制执行配置,该机制提供了[[SPDIFRX_Linux_driver|SPDFIRX linux driver]]使用的SPDIFRX外设的硬件描述。
  
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 SPDIFRX device tree bindings <ref name="spdifrx bindings">{{CodeSource | Linux kernel | Documentation/devicetree/bindings/sound/st,stm32-spdifrx.txt}}</ref> document describes all the required and optional configuration properties.
+
STM32 SPDIFRX设备树绑定<ref name="spdifrx bindings">{{CodeSource | Linux kernel | Documentation/devicetree/bindings/sound/st,stm32-spdifrx.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>和板设备树文件。有关设备树文件分割的说明,请参见[[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'''可用于生成板卡设备树。 有关更多详细信息,请参考[[#How_to_configure_the_DT_using_STM32CubeMX|How to configure the DT using STM32CubeMX]]
  
 
=== DT configuration (STM32 level) ===
 
=== DT configuration (STM32 level) ===
The SPDIFRX node is declared in stm32mp157c.dtsi<ref name="stm32mp157c.dtsi">{{CodeSource | Linux kernel | arch/arm/boot/dts/stm32mp157c.dtsi}}</ref>.  
+
SPDIFRX节点在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 SPDIFRX 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 SPDIFRX to implement a soundcard. Refer to [[Soundcard configuration|soundcard configuration]] for examples of SPDIFRX configuration on various boards.
+
SPDIFRX是一个音频外设,可以通过 Linux<sup>&reg;</sup>内核 [[ALSA overview|ALSA framework]]作为声卡的组件。设备树的这一部分允许SPDIFRX的配置以实现声卡。有关各种板上SPDIFRX配置的示例,请参考 [[Soundcard configuration|soundcard configuration]]
  
 
=== DT configuration examples ===
 
=== DT configuration examples ===
第42行: 第42行:
  
 
==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 />
The 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 they are preserved from one generation to another. Refer to [[STM32CubeMX]] user manual for further information.
+
STM32CubeMX可能不支持以上[[#DT bindings documentation|DT bindings documentation]] 段中描述的所有属性。如果是这样,该工具会在生成的设备树中插入 '''用户部分''' 。 然后可以编辑这些部分以添加一些属性,并将它们一代一代地保留下来。有关更多信息,请参见 [[STM32CubeMX]]用户手册。
  
 
==References==
 
==References==
 
<references />
 
<references />

2020年11月5日 (四) 16:44的最新版本

Article purpose

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

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

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

DT bindings documentation

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

DT configuration

此硬件描述是STM32微处理器 [2]和板设备树文件。有关设备树文件分割的说明,请参见Device tree

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

DT configuration (STM32 level)

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

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

DT configuration (board level)

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

DT configuration examples

&spdifrx {
	pinctrl-names = "default", "sleep"; 
	pinctrl-0 = <&spdifrx_pins_a>;
	pinctrl-1 = <&spdifrx_sleep_pins_a>
	/* Use spdifrx_pins_a instead of spdifrx_sleep_pins_a configuration,
	to allow IEC958 status bits capture, when an audio stream record is
	not active. Note that sleep state has to be defined, to allow pin state
	recovery from low power modes. */

	spdifrx_port: port {
		spdifrx_endpoint: endpoint {
			remote-endpoint = <&spdif_in_endpoint>;
		};
	};
};

How to configure the DT using STM32CubeMX

STM32CubeMX 工具可用于配置STM32MPU设备并获取相应的 platform configuration device tree
STM32CubeMX可能不支持以上DT bindings documentation 段中描述的所有属性。如果是这样,该工具会在生成的设备树中插入 用户部分 。 然后可以编辑这些部分以添加一些属性,并将它们一代一代地保留下来。有关更多信息,请参见 STM32CubeMX用户手册。