Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: usb: maxim,max3421: convert to DT schema
Convert legacy maxim,max3421.txt to proper format.
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com>
Signed-off-by: Rodrigo Gobbi <rodrigo.gobbi.7@gmail.com>
Link: https://patch.msgid.link/20260225014751.9121-1-rodrigo.gobbi.7@gmail.com
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
authored by
Rodrigo Gobbi
and committed by
Greg Kroah-Hartman
322a81d3
b558a9cc
+67
-23
-23
Documentation/devicetree/bindings/usb/maxim,max3421.txt
-23
Documentation/devicetree/bindings/usb/maxim,max3421.txt
···
1
-
Maxim Integrated SPI-based USB 2.0 host controller MAX3421E
2
-
3
-
Required properties:
4
-
- compatible: Should be "maxim,max3421"
5
-
- spi-max-frequency: maximum frequency for this device must not exceed 26 MHz.
6
-
- reg: chip select number to which this device is connected.
7
-
- maxim,vbus-en-pin: <GPOUTx ACTIVE_LEVEL>
8
-
GPOUTx is the number (1-8) of the GPOUT pin of MAX3421E to drive Vbus.
9
-
ACTIVE_LEVEL is 0 or 1.
10
-
- interrupts: the interrupt line description for the interrupt controller.
11
-
The driver configures MAX3421E for active low level triggered interrupts,
12
-
configure your interrupt line accordingly.
13
-
14
-
Example:
15
-
16
-
usb@0 {
17
-
compatible = "maxim,max3421";
18
-
reg = <0>;
19
-
maxim,vbus-en-pin = <3 1>;
20
-
spi-max-frequency = <26000000>;
21
-
interrupt-parent = <&PIC>;
22
-
interrupts = <42>;
23
-
};
+67
Documentation/devicetree/bindings/usb/maxim,max3421.yaml
+67
Documentation/devicetree/bindings/usb/maxim,max3421.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/usb/maxim,max3421.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: MAXIM MAX3421e USB Peripheral/Host Controller
8
+
9
+
maintainers:
10
+
- David Mosberger <davidm@egauge.net>
11
+
12
+
description: |
13
+
The controller provides USB2.0 compliant with Full Speed or Low Speed when in
14
+
the host mode. At peripheral, it operates at Full Speed. At both cases, it
15
+
uses a SPI interface.
16
+
Datasheet at:
17
+
https://www.analog.com/media/en/technical-documentation/data-sheets/max3421e.pdf
18
+
19
+
properties:
20
+
compatible:
21
+
const: maxim,max3421
22
+
23
+
reg:
24
+
maxItems: 1
25
+
26
+
interrupts:
27
+
maxItems: 1
28
+
29
+
spi-max-frequency:
30
+
maximum: 26000000
31
+
32
+
maxim,vbus-en-pin:
33
+
$ref: /schemas/types.yaml#/definitions/uint32-array
34
+
description:
35
+
One of eight GPOUT pins to control external VBUS power and the polarity
36
+
of the active level. It's an array of GPIO number and the active level of it.
37
+
minItems: 2
38
+
maxItems: 2
39
+
40
+
required:
41
+
- compatible
42
+
- reg
43
+
- interrupts
44
+
- maxim,vbus-en-pin
45
+
46
+
allOf:
47
+
- $ref: /schemas/spi/spi-peripheral-props.yaml#
48
+
49
+
unevaluatedProperties: false
50
+
51
+
examples:
52
+
- |
53
+
#include <dt-bindings/gpio/gpio.h>
54
+
#include <dt-bindings/interrupt-controller/irq.h>
55
+
spi {
56
+
#address-cells = <1>;
57
+
#size-cells = <0>;
58
+
59
+
usb@0 {
60
+
compatible = "maxim,max3421";
61
+
reg = <0>;
62
+
maxim,vbus-en-pin = <3 1>;
63
+
spi-max-frequency = <26000000>;
64
+
interrupt-parent = <&gpio>;
65
+
interrupts = <42>;
66
+
};
67
+
};