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

来自百问网嵌入式Linux wiki
（创建页面，内容为“== Purpose == The purpose of this article is to explain how to configure the digital-to-analog converter (''DAC'')<ref name="DAC internal peripheral">DAC internal…”）
 
 
（未显示同一用户的6个中间版本）
第1行： 第1行：
 
== Purpose ==
 
== Purpose ==
  
−
The purpose of this article is to explain how to configure the digital-to-analog converter (''DAC'')<ref name="DAC internal peripheral">[[DAC internal peripheral]]</ref> ''' when the peripheral is assigned to Linux<sup>&reg;</sup> OS''', and in particular:
+
本文旨在说明将数模转换器('''DAC''')<ref name="DAC internal peripheral">[[DAC internal peripheral]]</ref> ''' 分配给 Linux<sup>&reg;</sup> 操作系统时如何进行配置''', 尤其是:
−
* how to configure and enable the DAC '''peripheral'''
+
* 如何配置和启用DAC'''peripheral'''
−
* how to configure the '''board''', the DAC channels, reference voltage regulator and pins.
+
* 如何配置'''板'''、DAC通道、基准电压调节器和引脚。
−
The configuration is performed using the '''device tree mechanism'''<ref name="Device tree">[[Device tree]]</ref>.
+
使用'''设备树机制'''执行配置<ref name="Device tree">[[Device tree]]</ref>.
  
−
It is used by the [[DAC Linux driver]] that registers relevant information in [[IIO overview|IIO framework]], such as IIO devices, channels and voltage scale.
+
[[DAC Linux driver]]使用它在 [[IIO overview|IIO framework]]中注册相关信息，例如IIO设备，通道和电压标度。
  
−
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 DAC device tree bindings''<ref>{{CodeSource | Linux kernel | Documentation/devicetree/bindings/iio/dac/st,stm32-dac.txt | Documentation/devicetree/bindings/iio/dac/st,stm32-dac.txt}}, STM32 DAC device tree bindings</ref> deal with all the required or optional properties.
+
带有所有必需或可选属性的“ STM32 DAC设备树绑定”<ref>{{CodeSource | Linux kernel | Documentation/devicetree/bindings/iio/dac/st,stm32-dac.txt | Documentation/devicetree/bindings/iio/dac/st,stm32-dac.txt}}, STM32 DAC device tree bindings</ref> 协议。
  
 
== DT configuration ==
 
== DT configuration ==
−
This hardware description is a combination of STM32 and board device tree files. See [[Device tree]] for explanations on device tree file split.
+
该硬件描述是STM32和电路板设备树文件的组合。 有关分割设备树文件的说明，请参见 [[Device tree]]。
  
−
The '''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 DAC nodes are declared in stm32mp157c.dtsi<ref name="stm32mp157c_dtsi">{{CodeSource | Linux kernel | arch/arm/boot/dts/stm32mp157c.dtsi | STM32MP157C device tree file}}</ref>:
+
DAC节点在stm32mp157c.dtsi中声明<ref name="stm32mp157c_dtsi">{{CodeSource | Linux kernel | arch/arm/boot/dts/stm32mp157c.dtsi | STM32MP157C device tree file}}</ref>:
−
* '''DT root node''' (''''dac'''') describes the DAC hardware block parameters such as registers area and clocks.
+
* '''DT根节点'''（''''dac''''）描述DAC硬件模块参数，例如寄存器区域和时钟。
−
* '''DT child nodes''' (''''dac1'''' and ''''dac2'''') describe DAC channels independently.
+
* '''DT子节点'''（''''dac1''''和''''dac2''''）独立描述DAC通道。
 
  '''dac''': dac@address {
 
  '''dac''': dac@address {
 
  compatible = "st,stm32h7-dac-core";
 
  compatible = "st,stm32h7-dac-core";
第36行： 第36行：
 
  };
 
  };
 
  };
 
  };
−
{{Warning|This device tree part is related to STM32 microprocessors. It should be kept as is, without being modified by the end-user.}}
+
{{Warning|该设备树部分与STM32微处理器有关。 它应该保持原样，而不要由最终用户修改。}}
  
 
=== DT configuration (board level) ===
 
=== DT configuration (board level) ===
−
Follow the below sequence to configure and enable the DAC on your board:
+
请按照以下顺序在板上配置和启用DAC：
−
* Enable '''DT root node''' named ''''dac'''' by setting '''status = "okay"'''.
+
* 通过设置'''status =“ okay”'''启用名为''''dac''''的'''DT根节点'''。
−
* Configure pins in use via [[Pinctrl overview|pinctrl]] through '''pinctrl-0''' and '''pinctrl-names'''.
+
* 通过 [[Pinctrl overview|pinctrl]]至'''pinctrl-0'''和'''pinctrl-names'''配置正在使用的引脚。
−
* Configure analog reference voltage regulator<ref name="Regulator overview">[[Regulator overview]]</ref> by setting '''vref-supply = <&your_regulator>'''.
+
* 通过设置'''vref-supply = <＆your_regulator>'''来配置模拟参考电压稳压器<ref name="Regulator overview">[[Regulator overview]]</ref> 。
−
* Enable '''DT child node(s)''' for ''''dac1'''' and/or ''''dac2'''' channels(s) in use by setting '''status = "okay"'''.
+
* 通过设置'''status =“ okay”'''为启用的''''dac1''''和/或''''dac2''''通道启用'''DT子节点''' 。
−
{{info|The DAC can use the internal VREFBUF<ref name="VREFBUF internal peripheral">[[VREFBUF internal peripheral]]</ref> or any other external regulator<ref name="Regulator overview"/> wired to the VREF+ pin}}.
+
{{info|DAC可以使用内部VREFBUF<ref name="VREFBUF internal peripheral">[[VREFBUF internal peripheral]]</ref> 或连接到VREF +引脚的任何其他外部稳压器<ref name="Regulator overview"/>}}.
  
 
=== DT configuration example ===
 
=== DT configuration example ===
−
The example below shows how to configure DAC1 and DAC2 channels:
+
下面的示例显示如何配置DAC1和DAC2通道：
−
* PA4 and PA5 pins both configured as analog pins (see [[Pinctrl device tree configuration]] for more details)
+
* PA4和PA5引脚均配置为模拟引脚 (更多信息，请参见 [[Pinctrl device tree configuration]])
−
* VREFBUF<ref name="VREFBUF internal peripheral"/> used as reference voltage
+
* VREFBUF<ref name="VREFBUF internal peripheral"/> 用作参考电压
  
 
  dac_ch1_pins_a: dac-ch1 {
 
  dac_ch1_pins_a: dac-ch1 {
第76行： 第76行：
  
 
==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==
−
For additional information, refer to the following links:
+
有关更多信息，请参考以下链接：
  
 
<references />
 
<references />
−
 
−
<noinclude>
 
−
[[Category:Device tree configuration]]
 
−
[[Category:IIO]]
 
−
{{ArticleBasedOnModel|Peripheral or framework device tree configuration model}}
 
−
{{PublicationRequestId | 8780 | 2018-09-14 | AnneJ}}
 
−
</noinclude>
 

2020年11月9日 (一) 15:29的最新版本

Purpose

本文旨在说明将数模转换器(DAC)[1] 分配给 Linux® 操作系统时如何进行配置, 尤其是:

  • 如何配置和启用DACperipheral
  • 如何配置板、DAC通道、基准电压调节器和引脚。

使用设备树机制执行配置[2].

DAC Linux driver使用它在 IIO framework中注册相关信息，例如IIO设备，通道和电压标度。

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

DT bindings documentation

带有所有必需或可选属性的“ STM32 DAC设备树绑定”[3] 协议。

DT configuration

该硬件描述是STM32和电路板设备树文件的组合。 有关分割设备树文件的说明，请参见 Device tree。

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

DT configuration (STM32 level)

DAC节点在stm32mp157c.dtsi中声明[4]:

  • DT根节点（'dac'）描述DAC硬件模块参数，例如寄存器区域和时钟。
  • DT子节点（'dac1'和'dac2'）独立描述DAC通道。
dac: dac@address {
	compatible = "st,stm32h7-dac-core";
	...                                                                            /* common resources in 'dac' root node. */
	dac1: dac@1 {
		compatible = "st,stm32-dac";
		reg = <1>;                                                             /* DAC identifier (e.g. 1 for DAC1) */
		...                                                                    /* private resources in 'dac1' child node. */
	};
	dac2: dac@2 {
		compatible = "st,stm32-dac";
		reg = <2>;                                                             /* DAC identifier (e.g. 2 for DAC2) */
		...                                                                    /* private resources in 'dac2' child node. */
	};
};
Warning.png 该设备树部分与STM32微处理器有关。 它应该保持原样，而不要由最终用户修改。

DT configuration (board level)

请按照以下顺序在板上配置和启用DAC：

  • 通过设置status =“ okay”启用名为'dac'的DT根节点。
  • 通过 pinctrl至pinctrl-0和pinctrl-names配置正在使用的引脚。
  • 通过设置vref-supply = <＆your_regulator>来配置模拟参考电压稳压器[5] 。
  • 通过设置status =“ okay”为启用的'dac1'和/或'dac2'通道启用DT子节点 。
Info.png DAC可以使用内部VREFBUF[6] 或连接到VREF +引脚的任何其他外部稳压器[5]

.

DT configuration example

下面的示例显示如何配置DAC1和DAC2通道： 

dac_ch1_pins_a: dac-ch1 {
	pins {
		pinmux = <STM32_PINMUX('A', 4, ANALOG)>;                 /* configure 'PA4' as ANALOG */
	};
};
dac_ch2_pins_a: dac-ch2 {
	pins {
		pinmux = <STM32_PINMUX('A', 5, ANALOG)>;                 /* configure 'PA5' as ANALOG */
	};
};

&dac {
	pinctrl-names = "default";
	pinctrl-0 = <&dac_ch1_pins_a &dac_ch2_pins_a>;                   /* Use PA4 and PA5 pin as ANALOG */
	vref-supply = <&vrefbuf>;                                        /* Example to use VREFBUF (It needs to be enabled as well) */
	status = "okay";                                                 /* Enable the DAC block */
	dac1: dac@1 {
		status = "okay";                                         /* Enable DAC1 */
	};
	dac2: dac@2 {
		status = "okay";                                         /* Enable DAC2 */
	};
};

How to configure the DT using STM32CubeMX

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

References

有关更多信息，请参考以下链接：

  1. ↑ DAC internal peripheral
  2. ↑ Device tree
  3. ↑ Documentation/devicetree/bindings/iio/dac/st,stm32-dac.txt | |}} Documentation/devicetree/bindings/iio/dac/st,stm32-dac.txt , STM32 DAC device tree bindings
  4. ↑ arch/arm/boot/dts/stm32mp157c.dtsi | |}} STM32MP157C device tree file
  5. ↑ 5.05.1 Regulator overview
  6. ↑ 6.06.1 VREFBUF internal peripheral
取自“http://wiki.100ask.org/index.php?title=DAC_device_tree_configuration&oldid=7668”