Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: phy: eswin: Document the EIC7700 SoC SATA PHY
Document the SATA PHY on the EIC7700 SoC platform,
describing its usage.
Signed-off-by: Yulin Lu <luyulin@eswincomputing.com>
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com>
Link: https://patch.msgid.link/20260205082129.1482-1-luyulin@eswincomputing.com
Signed-off-by: Vinod Koul <vkoul@kernel.org>
authored by
Yulin Lu
and committed by
Vinod Koul
820265f7
290a3575
+92
+92
Documentation/devicetree/bindings/phy/eswin,eic7700-sata-phy.yaml
+92
Documentation/devicetree/bindings/phy/eswin,eic7700-sata-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/eswin,eic7700-sata-phy.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Eswin EIC7700 SoC SATA PHY
8
+
9
+
maintainers:
10
+
- Yulin Lu <luyulin@eswincomputing.com>
11
+
- Huan He <hehuan1@eswincomputing.com>
12
+
13
+
properties:
14
+
compatible:
15
+
const: eswin,eic7700-sata-phy
16
+
17
+
reg:
18
+
maxItems: 1
19
+
20
+
clocks:
21
+
maxItems: 1
22
+
23
+
clock-names:
24
+
const: phy
25
+
26
+
resets:
27
+
maxItems: 2
28
+
29
+
reset-names:
30
+
items:
31
+
- const: port
32
+
- const: phy
33
+
34
+
eswin,tx-amplitude-tuning:
35
+
description: This adjusts the transmitter amplitude signal, and its value
36
+
is derived from eye diagram tuning. The three values correspond to Gen1,
37
+
Gen2, and Gen3 parameters respectively.
38
+
$ref: /schemas/types.yaml#/definitions/uint32-array
39
+
items:
40
+
- description: Gen1 parameter.
41
+
minimum: 0
42
+
maximum: 0x7f
43
+
- description: Gen2 parameter.
44
+
minimum: 0
45
+
maximum: 0x7f
46
+
- description: Gen3 parameter.
47
+
minimum: 0
48
+
maximum: 0x7f
49
+
default: [0, 0, 0]
50
+
51
+
eswin,tx-preemph-tuning:
52
+
description: This adjusts the transmitter de-emphasis signal, and its value
53
+
is derived from eye diagram tuning. The three values correspond to Gen1,
54
+
Gen2, and Gen3 parameters respectively.
55
+
$ref: /schemas/types.yaml#/definitions/uint32-array
56
+
items:
57
+
- description: Gen1 parameter.
58
+
minimum: 0
59
+
maximum: 0x3f
60
+
- description: Gen2 parameter.
61
+
minimum: 0
62
+
maximum: 0x3f
63
+
- description: Gen3 parameter.
64
+
minimum: 0
65
+
maximum: 0x3f
66
+
default: [0, 0, 0]
67
+
68
+
"#phy-cells":
69
+
const: 0
70
+
71
+
required:
72
+
- compatible
73
+
- reg
74
+
- clocks
75
+
- clock-names
76
+
- resets
77
+
- reset-names
78
+
- "#phy-cells"
79
+
80
+
additionalProperties: false
81
+
82
+
examples:
83
+
- |
84
+
sata-phy@50440300 {
85
+
compatible = "eswin,eic7700-sata-phy";
86
+
reg = <0x50440300 0x40>;
87
+
clocks = <&hspcrg 17>;
88
+
clock-names = "phy";
89
+
resets = <&hspcrg 0>, <&hspcrg 1>;
90
+
reset-names = "port", "phy";
91
+
#phy-cells = <0>;
92
+
};