xref: /freebsd/sys/contrib/device-tree/Bindings/net/nokia-bluetooth.txt (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1Nokia Bluetooth Chips
2---------------------
3
4Nokia phones often come with UART connected bluetooth chips from different
5vendors and modified device API. Those devices speak a protocol named H4+
6(also known as h4p) by Nokia, which is similar to the H4 protocol from the
7Bluetooth standard. In addition to the H4 protocol it specifies two more
8UART status lines for wakeup of UART transceivers to improve power management
9and a few new packet types used to negotiate uart speed.
10
11Required properties:
12
13 - compatible: should contain "nokia,h4p-bluetooth" as well as one of the following:
14   * "brcm,bcm2048-nokia"
15   * "ti,wl1271-bluetooth-nokia"
16 - reset-gpios: GPIO specifier, used to reset the BT module (active low)
17 - bluetooth-wakeup-gpios: GPIO specifier, used to wakeup the BT module (active high)
18 - host-wakeup-gpios: GPIO specifier, used to wakeup the host processor (active high)
19 - clock-names: should be "sysclk"
20 - clocks: should contain a clock specifier for every name in clock-names
21
22Optional properties:
23
24 - None
25
26Example:
27
28/ {
29       /* controlled (enabled/disabled) directly by BT module */
30       bluetooth_clk: vctcxo {
31               compatible = "fixed-clock";
32               #clock-cells = <0>;
33               clock-frequency = <38400000>;
34       };
35};
36
37&uart2 {
38       pinctrl-names = "default";
39       pinctrl-0 = <&uart2_pins>;
40
41       bluetooth {
42               compatible = "ti,wl1271-bluetooth-nokia", "nokia,h4p-bluetooth";
43
44               reset-gpios = <&gpio1 26 GPIO_ACTIVE_LOW>; /* gpio26 */
45               host-wakeup-gpios = <&gpio4 5 GPIO_ACTIVE_HIGH>; /* gpio101 */
46               bluetooth-wakeup-gpios = <&gpio2 5 GPIO_ACTIVE_HIGH>; /* gpio37 */
47
48               clocks = <&bluetooth_clk>;
49               clock-names = "sysclk";
50       };
51};
52