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

dt-bindings: phy: bcm-ns-usb3-phy: convert to yaml

1. Change syntax from txt to yaml
2. Drop "Driver for" from the title
3. Drop "reg = <0x0>;" from example (noticed by dt_binding_check)
4. Specify license

Signed-off-by: Rafał Miłecki <rafal@milecki.pl>
Reviewed-by: Rob Herring <robh@kernel.org>
Link: https://lore.kernel.org/r/20210329165056.31647-1-zajec5@gmail.com
Signed-off-by: Vinod Koul <vkoul@kernel.org>

authored by

Rafał Miłecki and committed by
Vinod Koul
5e15fdc3 3f3ec9b6

+62 -34
-34
Documentation/devicetree/bindings/phy/bcm-ns-usb3-phy.txt
··· 1 - Driver for Broadcom Northstar USB 3.0 PHY 2 - 3 - Required properties: 4 - 5 - - compatible: one of: "brcm,ns-ax-usb3-phy", "brcm,ns-bx-usb3-phy". 6 - - reg: address of MDIO bus device 7 - - usb3-dmp-syscon: phandle to syscon with DMP (Device Management Plugin) 8 - registers 9 - - #phy-cells: must be 0 10 - 11 - Initialization of USB 3.0 PHY depends on Northstar version. There are currently 12 - three known series: Ax, Bx and Cx. 13 - Known A0: BCM4707 rev 0 14 - Known B0: BCM4707 rev 4, BCM53573 rev 2 15 - Known B1: BCM4707 rev 6 16 - Known C0: BCM47094 rev 0 17 - 18 - Example: 19 - mdio: mdio@0 { 20 - reg = <0x0>; 21 - #size-cells = <1>; 22 - #address-cells = <0>; 23 - 24 - usb3-phy@10 { 25 - compatible = "brcm,ns-ax-usb3-phy"; 26 - reg = <0x10>; 27 - usb3-dmp-syscon = <&usb3_dmp>; 28 - #phy-cells = <0>; 29 - }; 30 - }; 31 - 32 - usb3_dmp: syscon@18105000 { 33 - reg = <0x18105000 0x1000>; 34 - };
+62
Documentation/devicetree/bindings/phy/bcm-ns-usb3-phy.yaml
··· 1 + # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause 2 + %YAML 1.2 3 + --- 4 + $id: http://devicetree.org/schemas/phy/bcm-ns-usb3-phy.yaml# 5 + $schema: http://devicetree.org/meta-schemas/core.yaml# 6 + 7 + title: Broadcom Northstar USB 3.0 PHY 8 + 9 + description: | 10 + Initialization of USB 3.0 PHY depends on Northstar version. There are currently 11 + three known series: Ax, Bx and Cx. 12 + Known A0: BCM4707 rev 0 13 + Known B0: BCM4707 rev 4, BCM53573 rev 2 14 + Known B1: BCM4707 rev 6 15 + Known C0: BCM47094 rev 0 16 + 17 + maintainers: 18 + - Rafał Miłecki <rafal@milecki.pl> 19 + 20 + properties: 21 + compatible: 22 + enum: 23 + - brcm,ns-ax-usb3-phy 24 + - brcm,ns-bx-usb3-phy 25 + 26 + reg: 27 + description: address of MDIO bus device 28 + maxItems: 1 29 + 30 + usb3-dmp-syscon: 31 + $ref: /schemas/types.yaml#/definitions/phandle 32 + description: 33 + Phandle to the DMP (Device Management Plugin) syscon 34 + 35 + "#phy-cells": 36 + const: 0 37 + 38 + required: 39 + - compatible 40 + - reg 41 + - usb3-dmp-syscon 42 + - "#phy-cells" 43 + 44 + additionalProperties: false 45 + 46 + examples: 47 + - | 48 + mdio { 49 + #address-cells = <1>; 50 + #size-cells = <0>; 51 + 52 + usb3-phy@10 { 53 + compatible = "brcm,ns-ax-usb3-phy"; 54 + reg = <0x10>; 55 + usb3-dmp-syscon = <&usb3_dmp>; 56 + #phy-cells = <0>; 57 + }; 58 + }; 59 + 60 + usb3_dmp: syscon@18105000 { 61 + reg = <0x18105000 0x1000>; 62 + };