doc/device-tree-bindings/device.txt

   1 Devices
   2 =======
   3
   4 Device bindings are described by their own individual binding files.
   5
   6 U-Boot provides for some optional properties which are documented here. See
   7 also hid-over-i2c.txt which describes HID devices. See also
   8 Documentation/firmware-guide/acpi/enumeration.rst in the Linux kernel for
   9 the acpi,compatible property.
  10
  11  - acpi,has-power-resource : (boolean) true if this device has a power resource.
  12     This causes an ACPI PowerResource to be written containing the properties
  13     provided by this binding, to describe how to handle powering the device up
  14     and down using GPIOs
  15  - acpi,compatible : compatible string to report
  16  - acpi,ddn : Contains the string to use as the _DDN (DOS (Disk Operating
  17     System) Device Name)
  18  - acpi,hid : Contains the string to use as the HID (Hardware ID)
  19     identifier _HID
  20  - acpi,path : Specifies the full ACPI path for a device. This overrides the
  21     normal path built from the driver-model hierarchy
  22  - acpi,name : Provides the ACPI name for a device, which is a string consisting
  23    of four alphanumeric character (upper case)
  24  - acpi,uid : _UID value for device
  25  - acpi,wake : Provides the GPE used to detect a request from a device to wake
  26    from sleep
  27  - linux,probed : Tells U-Boot to add 'linux,probed' to the ACPI tables so that
  28     Linux will only load the driver if the device can be detected (e.g. on I2C
  29     bus). Note that this is an out-of-tree Linux feature.
  30
  31
  32 Example
  33 -------
  34
  35 elan_touchscreen: elan-touchscreen@10 {
  36         compatible = "i2c-chip";
  37         reg = <0x10>;
  38         acpi,hid = "ELAN0001";
  39         acpi,ddn = "ELAN Touchscreen";
  40         interrupts-extended = <&acpi_gpe GPIO_21_IRQ IRQ_TYPE_EDGE_FALLING>;
  41         linux,probed;
  42 };
  43
  44 pcie-a0@14,0 {
  45         reg = <0x0000a000 0 0 0 0>;
  46         acpi,name = "RP01";
  47         wifi: wifi {
  48                 compatible = "intel,generic-wifi";
  49                 acpi,ddn = "Intel WiFi";
  50                 acpi,name = "WF00";
  51                 acpi,wake = <GPE0_DW3_00>;
  52                 interrupts-extended = <&acpi_gpe 0x3c 0>;
  53         };
  54 };
  55
  56 p2sb: p2sb@d,0 {
  57         u-boot,dm-pre-reloc;
  58         reg = <0x02006810 0 0 0 0>;
  59         compatible = "intel,apl-p2sb";
  60         early-regs = <IOMAP_P2SB_BAR 0x100000>;
  61         pci,no-autoconfig;
  62
  63         n {
  64                 compatible = "intel,apl-pinctrl";
  65                 u-boot,dm-pre-reloc;
  66                 intel,p2sb-port-id = <PID_GPIO_N>;
  67                 acpi,path = "\\_SB.GPO0";
  68                 gpio_n: gpio-n {
  69                         compatible = "intel,gpio";
  70                         u-boot,dm-pre-reloc;
  71                         gpio-controller;
  72                         #gpio-cells = <2>;
  73                         linux-name = "INT3452:00";
  74                 };
  75         };