xref: /linux/Documentation/devicetree/bindings/incomplete-devices.yaml (revision 566ab427f827b0256d3e8ce0235d088e6a9c28bd)
1# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/incomplete-devices.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Rejected, Legacy or Incomplete Devices
8
9maintainers:
10  - Rob Herring <robh@kernel.org>
11
12description:
13  Some devices will not or should not get a proper Devicetree bindings, but
14  their compatibles are present in Linux drivers for various reasons.
15
16  Examples are devices using ACPI PRP0001 with non-updatable firmware/ACPI
17  tables or old PowerPC platforms without in-tree DTS.
18
19  Following list of devices is an incomplete schema with a goal to pass DT schema
20  checks on undocumented compatibles but also reject any DTS file using such
21  un-approved compatible.
22
23  Usage of any of following compatibles is not allowed in Devicetree sources,
24  even if they come from immutable firmware.
25
26properties:
27  compatible:
28    oneOf:
29      - description:
30          Rejected compatibles in Devicetree, but used in ACPI-based devices
31          with non-updatable firmware/ACPI tables (via ACPI PRP0001)
32        enum:
33          - broadcom,bcm5241
34          - ltr,ltrf216a
35
36      - description: Legacy compatibles used on Macintosh devices
37        enum:
38          - AAPL,3500
39          - AAPL,7500
40          - AAPL,8500
41          - AAPL,9500
42          - AAPL,accelerometer_1
43          - AAPL,e411
44          - AAPL,Gossamer
45          - AAPL,PowerBook1998
46          - AAPL,ShinerESB
47          - adm1030
48          - amd-0137
49          - B5221
50          - bmac+
51          - burgundy
52          - cobalt
53          - cy28508
54          - daca
55          - fcu
56          - gatwick
57          - gmac
58          - heathrow
59          - heathrow-ata
60          - heathrow-media-bay
61          - i2sbus
62          - i2s-modem
63          - iMac
64          - K2-GMAC
65          - k2-i2c
66          - K2-Keylargo
67          - K2-UATA
68          - kauai-ata
69          - Keylargo
70          - keylargo-ata
71          - keylargo-media-bay
72          - lm87cimt
73          - MAC,adm1030
74          - MAC,ds1775
75          - MacRISC
76          - MacRISC2
77          - MacRISC3
78          - MacRISC4
79          - max6690
80          - ohare
81          - ohare-media-bay
82          - ohare-swim3
83          - PowerBook1,1
84          - PowerBook2,1
85          - PowerBook2,2
86          - PowerBook3,1
87          - PowerBook3,2
88          - PowerBook3,3
89          - PowerBook3,4
90          - PowerBook3,5
91          - PowerBook4,1
92          - PowerBook4,2
93          - PowerBook4,3
94          - PowerBook5,1
95          - PowerBook5,2
96          - PowerBook5,3
97          - PowerBook5,4
98          - PowerBook5,5
99          - PowerBook5,6
100          - PowerBook5,7
101          - PowerBook5,8
102          - PowerBook5,9
103          - PowerBook6,3
104          - PowerBook6,5
105          - PowerBook6,7
106          - PowerMac10,1
107          - PowerMac10,2
108          - PowerMac1,1
109          - PowerMac11,2
110          - PowerMac12,1
111          - PowerMac2,1
112          - PowerMac2,2
113          - PowerMac3,1
114          - PowerMac3,4
115          - PowerMac3,5
116          - PowerMac3,6
117          - PowerMac4,1
118          - PowerMac4,2
119          - PowerMac4,4
120          - PowerMac4,5
121          - PowerMac7,2
122          - PowerMac7,3
123          - PowerMac8,1
124          - PowerMac8,2
125          - PowerMac9,1
126          - paddington
127          - RackMac1,1
128          - RackMac1,2
129          - RackMac3,1
130          - screamer
131          - shasta-ata
132          - sms
133          - smu-rpm-fans
134          - smu-sat
135          - smu-sensors
136          - snapper
137          - swim3
138          - tumbler
139          - u3-agp
140          - u3-dart
141          - u3-ht
142          - u4-dart
143          - u4-pcie
144          - U4-pcie
145          - uni-n-i2c
146          - uni-north
147
148      - description: Legacy compatibles used on other PowerPC devices
149        enum:
150          - 1682m-gizmo
151          - 1682m-gpio
152          - 1682m-rng
153          - 1682m-sdc
154          - amcc,ppc440epx-rng
155          - amcc,ppc460ex-bcsr
156          - amcc,ppc460ex-crypto
157          - amcc,ppc460ex-rng
158          - amcc,ppc460sx-crypto
159          - amcc,ppc4xx-crypto
160          - amcc,sata-460ex
161          - CBEA,platform-open-pic
162          - CBEA,platform-spider-pic
163          - direct-mapped
164          - display
165          - gpio-mdio
166          - hawk-bridge
167          - hawk-pci
168          - IBM,CBEA
169          - IBM,lhca
170          - IBM,lhea
171          - IBM,lhea-ethernet
172          - ibm,axon-msic
173          - Momentum,Apache
174          - Momentum,Maple
175          - mai-logic,articia-s
176          - mpc10x-pci
177          - mpc5200b-fec-phy
178          - mpc5200-serial
179          - mpc5200-sram
180          - nintendo,flipper
181          - nintendo,flipper-exi
182          - nintendo,flipper-pi
183          - nintendo,flipper-pic
184          - nintendo,hollywood
185          - nintendo,hollywood-pic
186          - nintendo,latte-exi
187          - nintendo,latte-srnprot
188          - ohci-be
189          - ohci-bigendian
190          - ohci-le
191          - PA6T-1682M
192          - pasemi,1682m-iob
193          - pasemi,localbus
194          - pasemi,localbus-nand
195          - pasemi,nemo
196          - pasemi,pwrficient
197          - pasemi,pwrficient-rng
198          - pasemi,rootbus
199          - pasemi,sdc
200          - soc
201          - sony,ps3
202          - sti,platform-spider-pic
203
204      - description: Legacy compatibles used on SPARC devices
205        enum:
206          - bq4802
207          - ds1287
208          - i2cpcf,8584
209          - isa-m5819p
210          - isa-m5823p
211          - m5819
212          - qcn
213          - sab82532
214          - su
215          - sun4v
216          - SUNW,bbc-beep
217          - SUNW,bbc-i2c
218          - SUNW,CS4231
219          - SUNW,ebus-pic16f747-env
220          - SUNW,kt-cwq
221          - SUNW,kt-mau
222          - SUNW,n2-cwq
223          - SUNW,n2-mau
224          - SUNW,niusl
225          - SUNW,smbus-beep
226          - SUNW,sun4v-console
227          - SUNW,sun4v-pci
228          - SUNW,vf-cwq
229          - SUNW,vf-mau
230
231      - description: Incomplete and/or legacy compatibles for unknown devices
232        enum:
233          - electra-cf
234          - i2cpcf,8584
235          - virtio,uml
236
237      - description: Linux kernel unit tests and sample code
238        enum:
239          - audio-graph-card2-custom-sample
240          - compat1
241          - compat2
242          - compat3
243          - gpio-mockup
244          - gpio-simulator
245          - gpio-virtuser
246          - linux,spi-loopback-test
247          - mailbox-test
248          - regulator-virtual-consumer
249          - test-device
250
251      - description:
252          Devices on MIPS platform, without any DTS users.  These are
253          unlikely to get converted to DT schema.
254        enum:
255          - mti,ranchu
256
257      - description:
258          Devices on PowerPC platform, without any DTS users.  These are
259          unlikely to get converted to DT schema.
260        enum:
261          - fujitsu,coral
262          - fujitsu,lime
263          - fujitsu,MB86276
264          - fujitsu,MB86277
265          - fujitsu,MB86293
266          - fujitsu,MB86294
267          - fujitsu,mint
268          - ibm,axon-msic
269          - ibm,pmemory
270          - ibm,pmemory-v2
271          - ibm,power-rng
272          - ibm,ppc4xx-spi
273          - ibm,sdram-4xx-ddr2
274          - ibm,secureboot
275          - ibm,secureboot-v1
276          - ibm,secureboot-v2
277          - ibm,secvar-backend
278          - sgy,gpio-halt
279          - wrs,epld-localbus
280
281required:
282  - compatible
283  - broken-usage-of-incorrect-compatible
284
285additionalProperties: false
286