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

来自百问网嵌入式Linux wiki
 
(未显示同一用户的12个中间版本)
第1行: 第1行:
 
== Article purpose ==
 
== Article purpose ==
This article explains how to configure ''Bluetooth'' <ref name="Bluetooth"> [[WLAN_and_Bluetooth_hardware_component|Bluetooth]] </ref> ''' when the peripheral ''(or peripheral associated to the framework)'' is assigned to the Linux<sup>&reg;</sup> OS'''.  
+
本文介绍如何配置“蓝牙” <ref name="Bluetooth"> [[WLAN_and_Bluetooth_hardware_component|Bluetooth]] </ref> ''' 将外围设备“(或与框架关联的外围设备)”分配给 Linux<sup>&reg;</sup> OS'''.  
  
The configuration is performed using the '''device tree mechanism''' <ref> [[Device tree]]</ref>.
+
使用 '''设备树机制''' <ref> [[Device tree]]</ref>执行配置。
  
The Bluetooth companion chip chosen on our platform is a Cypress chip <ref>[http://wireless.murata.com/datasheet?/RFM/data/lbee5kl1dx.pdf MURATA CYW4343W datasheet]</ref>
+
在我们的平台上选择的蓝牙配套芯片是赛普拉斯(Cypress)芯片 <ref>[http://wireless.murata.com/datasheet?/RFM/data/lbee5kl1dx.pdf MURATA CYW4343W datasheet]</ref>
  
 
== Bluetooth DT bindings documentation ==
 
== Bluetooth DT bindings documentation ==
The ''Bluetooth''<ref name="WLAN and BT external peripheral"> [[WLAN_and_Bluetooth_hardware_component]]</ref> ''' tree bindings are composed of:
+
The ''Bluetooth''<ref name="WLAN and BT external peripheral"> [[WLAN_and_Bluetooth_hardware_component]]</ref> ''' 树绑定由以下部分组成:
* STM32 USART device tree bindings <ref>[[Serial TTY device tree configuration]]</ref>
+
* STM32 USART设备树绑定 <ref>[[Serial TTY device tree configuration]]</ref>
* The Cypress device, used as child node <ref>{{CodeSource | Linux kernel | Documentation/devicetree/bindings/net/broadcom-bluetooth.txt}}</ref> of the host USART device to which the slave device is attached.
+
* 用作从属设备所连接的主机USART设备的子节点<ref>{{CodeSource | Linux kernel | Documentation/devicetree/bindings/net/broadcom-bluetooth.txt}}</ref> 的Cypress设备。
  
 
== Bluetooth DT configuration ==
 
== Bluetooth DT configuration ==
This hardware description is a combination of the STM32 microprocessor device tree files (.dtsi extension) and board device tree files (.dts extension). See the device tree for an explanation of the device tree file split.  
+
此硬件描述是STM32微处理器设备树文件(扩展名为.dtsi)和板设备树文件(扩展名为.dts)的组合。有关设备树文件拆分的说明,请参见设备树
  
 
=== Bluetooth DT configuration (STM32 level) ===
 
=== Bluetooth DT configuration (STM32 level) ===
The USART peripheral node is located in ''stm32mp157c.dtsi''
+
USART外设节点位于``stm32mp157c.dtsi''
* This is a set of properties that may not vary for given STM32 device, such as: registers address, clock, reset...
+
* 这是一组属性,对于给定的STM32器件而言可能不变,例如:寄存器地址,时钟,复位...
The USART DT configuration is explained in [[Serial TTY device tree configuration]]
+
[[Serial TTY device tree configuration]]中说明了USART DT配置。
 +
 
  
 
=== Bluetooth DT configuration (board level) ===
 
=== Bluetooth DT configuration (board level) ===
{{ReviewsComments|NSA W940 : I would have say as below in stead of you first proposal?}}
 
'''For {{EcosystemRelease | revision=1.1.0|range=and after}}''':<br />
 
'''For {{EcosystemRelease | revision=1.1.0}}''':<br />
 
[Description for the STM32MP15-Ecosystem-v1.1.0 revision]
 
{{ReviewsComments|NSA W940 : why adding this sentence into brackets?}}
 
  
 
  &usart2 {
 
  &usart2 {
 
         ...  
 
         ...  
         st,hw-flow-ctrl;                                       {{highlight|/* enable hardware flow control */}}
+
         uart-has-rtscts;                                     {{highlight|/* enable hardware flow control */}}
 
         ...
 
         ...
 
         bluetooth {                                            {{highlight|/* node of Bluetooth companion chip */}}         
 
         bluetooth {                                            {{highlight|/* node of Bluetooth companion chip */}}         
第37行: 第33行:
 
  };
 
  };
  
Specific properties for USART:
+
USART的特定属性:
* st,hw-flow-ctrl: bool flag to enable hardware flow control
+
* uart-has-rtscts; bool标志以启用硬件流控制
  
<div class="mw-collapsible mw-collapsed">
+
== How to configure Bluetooth using CubeMX ==
'''For {{EcosystemRelease | revision=1.0.0 | range=and before}}''':
+
[[STM32CubeMX]] 工具可用于配置STM32MPU设备并获取相应的[[Device_tree#STM32|platform configuration device tree]]文件。<br />
<div class="mw-collapsible-content">
 
[Description for the STM32MP15-Ecosystem-v1.0.0 and previous revisions]
 
{{ReviewsComments|NSA W940 : why adding this sentence into brackets ?}}
 
 
 
&usart2 {
 
        ...
 
        st,hw-flow-ctrl;                            {{highlight|/* enable hardware flow control */}}
 
        ...
 
        bluetooth {                                {{highlight|/* node of Bluetooth companion chip */}}
 
                pinctrl-names = "default";         
 
                pinctrl-0 = <&btreg>;              {{highlight|/* GPIO to power up or down the internal companion chip regulators */}}
 
                compatible = "brcm,bcm43438-bt";
 
                max-speed = <3000000>;
 
        };
 
};
 
  
Specific properties for USART:
+
STM32CubeMX可能不支持上述 [[#Bluetooth DT bindings documentation|DT bindings documentation]]段落中描述的所有属性。如果是这样,该工具会在生成的设备树中插入'''用户部分'''。 然后可以编辑这些部分以添加一些属性,并将它们一代一代地保留下来。 有关更多信息,请参见 [[STM32CubeMX]] 用户手册。
* btreg: GPIO to power up or down the internal CYW4343W regulators used by the Bluetooth section
 
* st,hw-flow-ctrl: bool flag to enable hardware flow control
 
 
 
</div></div>
 
 
 
== How to configure Bluetooth using CubeMX ==
 
The [[STM32CubeMX]] tool can be used to configure the STM32MPU device and get the corresponding [[Device_tree#STM32|platform configuration device tree]] files.<br />
 
The STM32CubeMX may not support all the properties described in the above [[#Bluetooth 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.
 
  
 
==References==
 
==References==
 
<references />
 
<references />
 
<noinclude>
 
{{ArticleBasedOnModel | Peripheral or framework device tree configuration model}}
 
{{PublicationRequestId | 10171 | 2019-01-02 |  PhilipS}}
 
[[Category:Device tree configuration]]
 
[[Category:Bluetooth]]
 
</noinclude>
 

2020年11月5日 (四) 18:15的最新版本

Article purpose

本文介绍如何配置“蓝牙” [1] 将外围设备“(或与框架关联的外围设备)”分配给 Linux® OS.

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

在我们的平台上选择的蓝牙配套芯片是赛普拉斯(Cypress)芯片 [3]

Bluetooth DT bindings documentation

The Bluetooth[4] 树绑定由以下部分组成:

  • STM32 USART设备树绑定 [5]
  • 用作从属设备所连接的主机USART设备的子节点[6] 的Cypress设备。

Bluetooth DT configuration

此硬件描述是STM32微处理器设备树文件(扩展名为.dtsi)和板设备树文件(扩展名为.dts)的组合。有关设备树文件拆分的说明,请参见设备树

Bluetooth DT configuration (STM32 level)

USART外设节点位于``stm32mp157c.dtsi

  • 这是一组属性,对于给定的STM32器件而言可能不变,例如:寄存器地址,时钟,复位...

Serial TTY device tree configuration中说明了USART DT配置。


Bluetooth DT configuration (board level)

&usart2 {
       ... 
       uart-has-rtscts;                                     /* enable hardware flow control */
       ...
       bluetooth {                                            /* node of Bluetooth companion chip */         
               shutdown-gpios = <&gpioz 6 GPIO_ACTIVE_HIGH>;  /* GPIO specifier, used to enable the BT module */
               compatible = "brcm,bcm43438-bt";
               max-speed = <3000000>;
       };
};

USART的特定属性:

  • uart-has-rtscts; bool标志以启用硬件流控制

How to configure Bluetooth using CubeMX

STM32CubeMX 工具可用于配置STM32MPU设备并获取相应的platform configuration device tree文件。

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