brcm,sata-phy.yaml (3054B)
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) 2%YAML 1.2 3--- 4$id: "http://devicetree.org/schemas/phy/brcm,sata-phy.yaml#" 5$schema: "http://devicetree.org/meta-schemas/core.yaml#" 6 7title: Broadcom SATA3 PHY 8 9maintainers: 10 - Florian Fainelli <f.fainelli@gmail.com> 11 12properties: 13 $nodename: 14 pattern: "^sata[-|_]phy(@.*)?$" 15 16 compatible: 17 oneOf: 18 - items: 19 - enum: 20 - brcm,bcm7216-sata-phy 21 - brcm,bcm7425-sata-phy 22 - brcm,bcm7445-sata-phy 23 - brcm,bcm63138-sata-phy 24 - const: brcm,phy-sata3 25 - items: 26 - const: brcm,iproc-nsp-sata-phy 27 - items: 28 - const: brcm,iproc-ns2-sata-phy 29 - items: 30 - const: brcm,iproc-sr-sata-phy 31 32 reg: 33 minItems: 1 34 maxItems: 2 35 36 reg-names: 37 minItems: 1 38 items: 39 - const: phy 40 - const: phy-ctrl 41 42 "#address-cells": 43 const: 1 44 45 "#size-cells": 46 const: 0 47 48patternProperties: 49 "^sata-phy@[0-9]+$": 50 type: object 51 description: | 52 Each port's PHY should be represented as a sub-node. 53 54 properties: 55 reg: 56 description: The SATA PHY port number 57 maxItems: 1 58 59 "#phy-cells": 60 const: 0 61 62 "brcm,enable-ssc": 63 $ref: /schemas/types.yaml#/definitions/flag 64 description: | 65 Use spread spectrum clocking (SSC) on this port 66 This property is not applicable for "brcm,iproc-ns2-sata-phy", 67 "brcm,iproc-nsp-sata-phy" and "brcm,iproc-sr-sata-phy". 68 69 "brcm,rxaeq-mode": 70 $ref: /schemas/types.yaml#/definitions/string 71 description: 72 String that indicates the desired RX equalizer mode. 73 enum: 74 - off 75 - auto 76 - manual 77 78 "brcm,rxaeq-value": 79 $ref: /schemas/types.yaml#/definitions/uint32 80 description: | 81 When 'brcm,rxaeq-mode' is set to "manual", provides the RX 82 equalizer value that should be used. 83 minimum: 0 84 maximum: 63 85 86 "brcm,tx-amplitude-millivolt": 87 description: | 88 Transmit amplitude voltage in millivolt. 89 $ref: /schemas/types.yaml#/definitions/uint32 90 enum: [400, 500, 600, 800] 91 92 required: 93 - reg 94 - "#phy-cells" 95 96 additionalProperties: false 97 98if: 99 properties: 100 compatible: 101 const: brcm,iproc-ns2-sata-phy 102then: 103 properties: 104 reg: 105 minItems: 2 106 107 reg-names: 108 minItems: 2 109else: 110 properties: 111 reg: 112 maxItems: 1 113 114 reg-names: 115 maxItems: 1 116 117required: 118 - compatible 119 - "#address-cells" 120 - "#size-cells" 121 - reg 122 - reg-names 123 124additionalProperties: false 125 126examples: 127 - | 128 sata_phy@f0458100 { 129 compatible = "brcm,bcm7445-sata-phy", "brcm,phy-sata3"; 130 reg = <0xf0458100 0x1e00>; 131 reg-names = "phy"; 132 #address-cells = <1>; 133 #size-cells = <0>; 134 135 sata-phy@0 { 136 reg = <0>; 137 #phy-cells = <0>; 138 }; 139 140 sata-phy@1 { 141 reg = <1>; 142 #phy-cells = <0>; 143 }; 144 };