Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: arm: Convert Gemini boards to YAML
This removes the old plaintext Gemini binding and replace it
with a YAML schema, adding some new boards in the process.
While we are at it, add the missing vendors to the vendor
prefix file.
Drop the overly deliberate description of subnodes and the big
example from the old document. Keep the elaborate description.
I noticed that "wiliboard" is not a real vendor, the vendor
is named "wiligear" so deprecated this and replaced with the
proper vendor.
Cc: Corentin Labbe <clabbe@baylibre.com>
Signed-off-by: Linus Walleij <linus.walleij@linaro.org>
Link: https://lore.kernel.org/r/20210723152356.1874088-1-linus.walleij@linaro.org
Signed-off-by: Rob Herring <robh@kernel.org>
authored by
Linus Walleij
and committed by
Rob Herring
7da6ebf5
390436f1
+105
-108
-108
Documentation/devicetree/bindings/arm/gemini.txt
-108
Documentation/devicetree/bindings/arm/gemini.txt
···
1
-
Cortina systems Gemini platforms
2
-
3
-
The Gemini SoC is the project name for an ARMv4 FA525-based SoC originally
4
-
produced by Storlink Semiconductor around 2005. The company was renamed
5
-
later renamed Storm Semiconductor. The chip product name is Storlink SL3516.
6
-
It was derived from earlier products from Storm named SL3316 (Centroid) and
7
-
SL3512 (Bulverde).
8
-
9
-
Storm Semiconductor was acquired by Cortina Systems in 2008 and the SoC was
10
-
produced and used for NAS and similar usecases. In 2014 Cortina Systems was
11
-
in turn acquired by Inphi, who seem to have discontinued this product family.
12
-
13
-
Many of the IP blocks used in the SoC comes from Faraday Technology.
14
-
15
-
Required properties (in root node):
16
-
compatible = "cortina,gemini";
17
-
18
-
Required nodes:
19
-
20
-
- soc: the SoC should be represented by a simple bus encompassing all the
21
-
onchip devices, this is referred to as the soc bus node.
22
-
23
-
- syscon: the soc bus node must have a system controller node pointing to the
24
-
global control registers, with the compatible string
25
-
"cortina,gemini-syscon", "syscon";
26
-
27
-
Required properties on the syscon:
28
-
- reg: syscon register location and size.
29
-
- #clock-cells: should be set to <1> - the system controller is also a
30
-
clock provider.
31
-
- #reset-cells: should be set to <1> - the system controller is also a
32
-
reset line provider.
33
-
34
-
The clock sources have shorthand defines in the include file:
35
-
<dt-bindings/clock/cortina,gemini-clock.h>
36
-
37
-
The reset lines have shorthand defines in the include file:
38
-
<dt-bindings/reset/cortina,gemini-reset.h>
39
-
40
-
- timer: the soc bus node must have a timer node pointing to the SoC timer
41
-
block, with the compatible string "cortina,gemini-timer"
42
-
See: clocksource/cortina,gemini-timer.txt
43
-
44
-
- interrupt-controller: the sob bus node must have an interrupt controller
45
-
node pointing to the SoC interrupt controller block, with the compatible
46
-
string "cortina,gemini-interrupt-controller"
47
-
See interrupt-controller/cortina,gemini-interrupt-controller.txt
48
-
49
-
Example:
50
-
51
-
/ {
52
-
model = "Foo Gemini Machine";
53
-
compatible = "cortina,gemini";
54
-
#address-cells = <1>;
55
-
#size-cells = <1>;
56
-
57
-
memory {
58
-
device_type = "memory";
59
-
reg = <0x00000000 0x8000000>;
60
-
};
61
-
62
-
soc {
63
-
#address-cells = <1>;
64
-
#size-cells = <1>;
65
-
ranges;
66
-
compatible = "simple-bus";
67
-
interrupt-parent = <&intcon>;
68
-
69
-
syscon: syscon@40000000 {
70
-
compatible = "cortina,gemini-syscon", "syscon";
71
-
reg = <0x40000000 0x1000>;
72
-
#clock-cells = <1>;
73
-
#reset-cells = <1>;
74
-
};
75
-
76
-
uart0: serial@42000000 {
77
-
compatible = "ns16550a";
78
-
reg = <0x42000000 0x100>;
79
-
resets = <&syscon GEMINI_RESET_UART>;
80
-
clocks = <&syscon GEMINI_CLK_UART>;
81
-
interrupts = <18 IRQ_TYPE_LEVEL_HIGH>;
82
-
reg-shift = <2>;
83
-
};
84
-
85
-
timer@43000000 {
86
-
compatible = "cortina,gemini-timer";
87
-
reg = <0x43000000 0x1000>;
88
-
interrupt-parent = <&intcon>;
89
-
interrupts = <14 IRQ_TYPE_EDGE_FALLING>, /* Timer 1 */
90
-
<15 IRQ_TYPE_EDGE_FALLING>, /* Timer 2 */
91
-
<16 IRQ_TYPE_EDGE_FALLING>; /* Timer 3 */
92
-
resets = <&syscon GEMINI_RESET_TIMER>;
93
-
/* APB clock or RTC clock */
94
-
clocks = <&syscon GEMINI_CLK_APB>,
95
-
<&syscon GEMINI_CLK_RTC>;
96
-
clock-names = "PCLK", "EXTCLK";
97
-
syscon = <&syscon>;
98
-
};
99
-
100
-
intcon: interrupt-controller@48000000 {
101
-
compatible = "cortina,gemini-interrupt-controller";
102
-
reg = <0x48000000 0x1000>;
103
-
resets = <&syscon GEMINI_RESET_INTCON0>;
104
-
interrupt-controller;
105
-
#interrupt-cells = <2>;
106
-
};
107
-
};
108
-
};
+95
Documentation/devicetree/bindings/arm/gemini.yaml
+95
Documentation/devicetree/bindings/arm/gemini.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/arm/gemini.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Cortina systems Gemini platforms
8
+
9
+
description: |
10
+
The Gemini SoC is the project name for an ARMv4 FA525-based SoC originally
11
+
produced by Storlink Semiconductor around 2005. The company was renamed
12
+
later renamed Storm Semiconductor. The chip product name is Storlink SL3516.
13
+
It was derived from earlier products from Storm named SL3316 (Centroid) and
14
+
SL3512 (Bulverde).
15
+
16
+
Storm Semiconductor was acquired by Cortina Systems in 2008 and the SoC was
17
+
produced and used for NAS and similar usecases. In 2014 Cortina Systems was
18
+
in turn acquired by Inphi, who seem to have discontinued this product family.
19
+
20
+
Many of the IP blocks used in the SoC comes from Faraday Technology.
21
+
22
+
maintainers:
23
+
- Linus Walleij <linus.walleij@linaro.org>
24
+
25
+
properties:
26
+
$nodename:
27
+
const: '/'
28
+
compatible:
29
+
oneOf:
30
+
31
+
- description: Storlink Semiconductor Gemini324 EV-Board also known
32
+
as Storm Semiconductor SL93512R_BRD
33
+
items:
34
+
- const: storlink,gemini324
35
+
- const: storm,sl93512r
36
+
- const: cortina,gemini
37
+
38
+
- description: D-Link DIR-685 Xtreme N Storage Router
39
+
items:
40
+
- const: dlink,dir-685
41
+
- const: cortina,gemini
42
+
43
+
- description: D-Link DNS-313 1-Bay Network Storage Enclosure
44
+
items:
45
+
- const: dlink,dns-313
46
+
- const: cortina,gemini
47
+
48
+
- description: Edimax NS-2502
49
+
items:
50
+
- const: edimax,ns-2502
51
+
- const: cortina,gemini
52
+
53
+
- description: ITian Square One SQ201
54
+
items:
55
+
- const: itian,sq201
56
+
- const: cortina,gemini
57
+
58
+
- description: Raidsonic NAS IB-4220-B
59
+
items:
60
+
- const: raidsonic,ib-4220-b
61
+
- const: cortina,gemini
62
+
63
+
- description: SSI 1328
64
+
items:
65
+
- const: ssi,1328
66
+
- const: cortina,gemini
67
+
68
+
- description: Teltonika RUT1xx Mobile Router
69
+
items:
70
+
- const: teltonika,rut1xx
71
+
- const: cortina,gemini
72
+
73
+
- description: Wiligear Wiliboard WBD-111
74
+
items:
75
+
- const: wiligear,wiliboard-wbd111
76
+
- const: cortina,gemini
77
+
78
+
- description: Wiligear Wiliboard WBD-222
79
+
items:
80
+
- const: wiligear,wiliboard-wbd222
81
+
- const: cortina,gemini
82
+
83
+
- description: Wiligear Wiliboard WBD-111 - old incorrect binding
84
+
items:
85
+
- const: wiliboard,wbd111
86
+
- const: cortina,gemini
87
+
deprecated: true
88
+
89
+
- description: Wiligear Wiliboard WBD-222 - old incorrect binding
90
+
items:
91
+
- const: wiliboard,wbd222
92
+
- const: cortina,gemini
93
+
deprecated: true
94
+
95
+
additionalProperties: true
+10
Documentation/devicetree/bindings/vendor-prefixes.yaml
+10
Documentation/devicetree/bindings/vendor-prefixes.yaml
···
563
563
description: ITE Tech. Inc.
564
564
"^itead,.*":
565
565
description: ITEAD Intelligent Systems Co.Ltd
566
+
"^itian,.*":
567
+
description: ITian Corporation
566
568
"^iwave,.*":
567
569
description: iWave Systems Technologies Pvt. Ltd.
568
570
"^jdi,.*":
···
1113
1111
"^st-ericsson,.*":
1114
1112
description: ST-Ericsson
1115
1113
deprecated: true
1114
+
"^storlink,.*":
1115
+
description: StorLink Semiconductors, Inc.
1116
+
"^storm,.*":
1117
+
description: Storm Semiconductor, Inc.
1116
1118
"^summit,.*":
1117
1119
description: Summit microelectronics
1118
1120
"^sunchip,.*":
···
1149
1143
description: TechNexion
1150
1144
"^technologic,.*":
1151
1145
description: Technologic Systems
1146
+
"^teltonika,.*":
1147
+
description: Teltonika Networks
1152
1148
"^tempo,.*":
1153
1149
description: Tempo Semiconductor
1154
1150
"^techstar,.*":
···
1276
1268
description: Shenzhen whwave Electronics, Inc.
1277
1269
"^wi2wi,.*":
1278
1270
description: Wi2Wi, Inc.
1271
+
"^wiligear,.*":
1272
+
description: Wiligear, Ltd.
1279
1273
"^winbond,.*":
1280
1274
description: Winbond Electronics corp.
1281
1275
"^winstar,.*":