| Simon Glass | fa04cef | 2020-04-26 09:19:45 -0600 | [diff] [blame] | 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 |
| Simon Glass | f185895 | 2020-07-07 21:32:07 -0600 | [diff] [blame] | 20 | - acpi,path : Specifies the full ACPI path for a device. This overrides the |
| 21 | normal path built from the driver-model hierarchy |
| Simon Glass | fefac0b | 2020-07-07 13:12:11 -0600 | [diff] [blame] | 22 | - acpi,name : Provides the ACPI name for a device, which is a string consisting |
| 23 | of four alphanumeric character (upper case) |
| Simon Glass | fa04cef | 2020-04-26 09:19:45 -0600 | [diff] [blame] | 24 | - acpi,uid : _UID value for device |
| Simon Glass | e4f09f9 | 2020-09-22 12:45:02 -0600 | [diff] [blame] | 25 | - acpi,wake : Provides the GPE used to detect a request from a device to wake |
| 26 | from sleep |
| Simon Glass | fa04cef | 2020-04-26 09:19:45 -0600 | [diff] [blame] | 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 | }; |
| Simon Glass | fefac0b | 2020-07-07 13:12:11 -0600 | [diff] [blame] | 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"; |
| Simon Glass | e4f09f9 | 2020-09-22 12:45:02 -0600 | [diff] [blame] | 51 | acpi,wake = <GPE0_DW3_00>; |
| Simon Glass | fefac0b | 2020-07-07 13:12:11 -0600 | [diff] [blame] | 52 | interrupts-extended = <&acpi_gpe 0x3c 0>; |
| 53 | }; |
| 54 | }; |
| Simon Glass | f185895 | 2020-07-07 21:32:07 -0600 | [diff] [blame] | 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 | }; |