Documentation/devicetree/bindings/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
   7 title: Rejected, Legacy or Incomplete Devices
   8
   9 maintainers:
  10   - Rob Herring <robh@kernel.org>
  11
  12 description:
  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
  26 properties:
  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
 281 required:
 282   - compatible
 283   - broken-usage-of-incorrect-compatible
 284
 285 additionalProperties: false