incomplete-devices.yaml

  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