Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

usb: dt-bindings: ti,twl6030-usb: convert to DT schema

Convert the legacy TXT binding for the TWL6030 USB module
to the modern YAML DT schema format. This adds formal validation
and improves documentation using a conditional schema.

The legacy twlxxxx-usb.txt file is no longer needed and is removed.

Signed-off-by: Jihed Chaibi <jihed.chaibi.dev@gmail.com>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Link: https://lore.kernel.org/r/20250824112338.64953-3-jihed.chaibi.dev@gmail.com
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

authored by

Jihed Chaibi and committed by
Greg Kroah-Hartman
1daa7f57 7d3f7801

+48 -21
+48
Documentation/devicetree/bindings/usb/ti,twl6030-usb.yaml
··· 1 + # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/usb/ti,twl6030-usb.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Texas Instruments TWL6030 USB Comparator 8 + 9 + maintainers: 10 + - Peter Ujfalusi <peter.ujfalusi@gmail.com> 11 + 12 + description: 13 + Bindings for the USB comparator module found within the TWL6030 14 + family of companion chips. 15 + 16 + properties: 17 + compatible: 18 + const: ti,twl6030-usb 19 + 20 + interrupts: 21 + items: 22 + - description: OTG for ID events in host mode 23 + - description: USB device mode for VBUS events 24 + 25 + usb-supply: 26 + description: 27 + Phandle to the VUSB regulator. For TWL6030, this should be the 'vusb' 28 + regulator. For TWL6032 subclass, it should be the 'ldousb' regulator. 29 + 30 + required: 31 + - compatible 32 + - interrupts 33 + - usb-supply 34 + 35 + additionalProperties: false 36 + 37 + examples: 38 + - | 39 + #include <dt-bindings/interrupt-controller/irq.h> 40 + 41 + usb { 42 + compatible = "ti,twl6030-usb"; 43 + 44 + interrupts = <4 IRQ_TYPE_LEVEL_HIGH>, <10 IRQ_TYPE_LEVEL_HIGH>; 45 + interrupt-parent = <&gic>; 46 + 47 + usb-supply = <&reg_vusb>; 48 + };
-21
Documentation/devicetree/bindings/usb/twlxxxx-usb.txt
··· 1 - USB COMPARATOR OF TWL CHIPS 2 - 3 - TWL6030 USB COMPARATOR 4 - - compatible : Should be "ti,twl6030-usb" 5 - - interrupts : Two interrupt numbers to the cpu should be specified. First 6 - interrupt number is the otg interrupt number that raises ID interrupts when 7 - the controller has to act as host and the second interrupt number is the 8 - usb interrupt number that raises VBUS interrupts when the controller has to 9 - act as device 10 - - usb-supply : phandle to the regulator device tree node. It should be vusb 11 - if it is twl6030 or ldousb if it is twl6032 subclass. 12 - 13 - twl6030-usb { 14 - compatible = "ti,twl6030-usb"; 15 - interrupts = < 4 10 >; 16 - }; 17 - 18 - Board specific device node entry 19 - &twl6030-usb { 20 - usb-supply = <&vusb>; 21 - };