€•       Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ3/translations/zh_CN/firmware-guide/acpi/enumeration”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ3/translations/zh_TW/firmware-guide/acpi/enumeration”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ3/translations/it_IT/firmware-guide/acpi/enumeration”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ3/translations/ja_JP/firmware-guide/acpi/enumeration”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ3/translations/ko_KR/firmware-guide/acpi/enumeration”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ3/translations/pt_BR/firmware-guide/acpi/enumeration”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ3/translations/sp_SP/firmware-guide/acpi/enumeration”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh·sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1hµhhh²hh³ŒM/var/lib/git/docbuild/linux/Documentation/firmware-guide/acpi/enumeration.rst”h´KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒACPI Based Device Enumeration”h]”hŒACPI Based Device Enumeration”…””}”(hhÏh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhhÊh²hh³hÇh´KubhŒ	paragraph”“”)”}”(hŒ·ACPI 5 introduced a set of new resources (UartTSerialBus, I2cSerialBus,
SpiSerialBus, GpioIo and GpioInt) which can be used in enumerating slave
devices behind serial bus controllers.”h]”hŒ·ACPI 5 introduced a set of new resources (UartTSerialBus, I2cSerialBus,
SpiSerialBus, GpioIo and GpioInt) which can be used in enumerating slave
devices behind serial bus controllers.”…””}”(hhßh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhhÊh²hubhÞ)”}”(hŒ½In addition we are starting to see peripherals integrated in the
SoC/Chipset to appear only in ACPI namespace. These are typically devices
that are accessed through memory-mapped registers.”h]”hŒ½In addition we are starting to see peripherals integrated in the
SoC/Chipset to appear only in ACPI namespace. These are typically devices
that are accessed through memory-mapped registers.”…””}”(hhíh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhhÊh²hubhÞ)”}”(hŒgIn order to support this and reuse the existing drivers as much as
possible we decided to do following:”h]”hŒgIn order to support this and reuse the existing drivers as much as
possible we decided to do following:”…””}”(hhûh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhhÊh²hubhŒblock_quote”“”)”}”(hXe  - Devices that have no bus connector resource are represented as
  platform devices.

- Devices behind real busses where there is a connector resource
  are represented as struct spi_device or struct i2c_client. Note
  that standard UARTs are not busses so there is no struct uart_device,
  although some of them may be represented by struct serdev_device.
”h]”hŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒQDevices that have no bus connector resource are represented as
platform devices.
”h]”hÞ)”}”(hŒPDevices that have no bus connector resource are represented as
platform devices.”h]”hŒPDevices that have no bus connector resource are represented as
platform devices.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  ubj  )”}”(hX  Devices behind real busses where there is a connector resource
are represented as struct spi_device or struct i2c_client. Note
that standard UARTs are not busses so there is no struct uart_device,
although some of them may be represented by struct serdev_device.
”h]”hÞ)”}”(hX  Devices behind real busses where there is a connector resource
are represented as struct spi_device or struct i2c_client. Note
that standard UARTs are not busses so there is no struct uart_device,
although some of them may be represented by struct serdev_device.”h]”hX  Devices behind real busses where there is a connector resource
are represented as struct spi_device or struct i2c_client. Note
that standard UARTs are not busses so there is no struct uart_device,
although some of them may be represented by struct serdev_device.”…””}”(hj2  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khj.  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1j  h³hÇh´Khj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j	  h³hÇh´KhhÊh²hubhÞ)”}”(hŒ“As both ACPI and Device Tree represent a tree of devices (and their
resources) this implementation follows the Device Tree way as much as
possible.”h]”hŒ“As both ACPI and Device Tree represent a tree of devices (and their
resources) this implementation follows the Device Tree way as much as
possible.”…””}”(hjT  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhhÊh²hubhÞ)”}”(hŒ¾The ACPI implementation enumerates devices behind busses (platform, SPI,
I2C, and in some cases UART), creates the physical devices and binds them
to their ACPI handle in the ACPI namespace.”h]”hŒ¾The ACPI implementation enumerates devices behind busses (platform, SPI,
I2C, and in some cases UART), creates the physical devices and binds them
to their ACPI handle in the ACPI namespace.”…””}”(hjb  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KhhÊh²hubhÞ)”}”(hŒÐThis means that when ACPI_HANDLE(dev) returns non-NULL the device was
enumerated from ACPI namespace. This handle can be used to extract other
device-specific configuration. There is an example of this below.”h]”hŒÐThis means that when ACPI_HANDLE(dev) returns non-NULL the device was
enumerated from ACPI namespace. This handle can be used to extract other
device-specific configuration. There is an example of this below.”…””}”(hjp  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K"hhÊh²hubhÉ)”}”(hhh]”(hÎ)”}”(hŒPlatform bus support”h]”hŒPlatform bus support”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj~  h²hh³hÇh´K'ubhÞ)”}”(hX;  Since we are using platform devices to represent devices that are not
connected to any physical bus we only need to implement a platform driver
for the device and add supported ACPI IDs. If this same IP-block is used on
some other non-ACPI platform, the driver might work out of the box or needs
some minor changes.”h]”hX;  Since we are using platform devices to represent devices that are not
connected to any physical bus we only need to implement a platform driver
for the device and add supported ACPI IDs. If this same IP-block is used on
some other non-ACPI platform, the driver might work out of the box or needs
some minor changes.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K)hj~  h²hubhÞ)”}”(hŒkAdding ACPI support for an existing driver should be pretty
straightforward. Here is the simplest example::”h]”hŒjAdding ACPI support for an existing driver should be pretty
straightforward. Here is the simplest example:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K/hj~  h²hubhŒliteral_block”“”)”}”(hX"  static const struct acpi_device_id mydrv_acpi_match[] = {
        /* ACPI IDs here */
        { }
};
MODULE_DEVICE_TABLE(acpi, mydrv_acpi_match);

static struct platform_driver my_driver = {
        ...
        .driver = {
                .acpi_match_table = mydrv_acpi_match,
        },
};”h]”hX"  static const struct acpi_device_id mydrv_acpi_match[] = {
        /* ACPI IDs here */
        { }
};
MODULE_DEVICE_TABLE(acpi, mydrv_acpi_match);

static struct platform_driver my_driver = {
        ...
        .driver = {
                .acpi_match_table = mydrv_acpi_match,
        },
};”…””}”hj­  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´K2hj~  h²hubhÞ)”}”(hŒ§If the driver needs to perform more complex initialization like getting and
configuring GPIOs it can get its ACPI handle and extract this information
from ACPI tables.”h]”hŒ§If the driver needs to perform more complex initialization like getting and
configuring GPIOs it can get its ACPI handle and extract this information
from ACPI tables.”…””}”(hj»  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K?hj~  h²hubeh}”(h]”Œplatform-bus-support”ah ]”h"]”Œplatform bus support”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K'ubhÉ)”}”(hhh]”(hÎ)”}”(hŒACPI device objects”h]”hŒACPI device objects”…””}”(hjÔ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjÑ  h²hh³hÇh´KDubhÞ)”}”(hXÍ  Generally speaking, there are two categories of devices in a system in which
ACPI is used as an interface between the platform firmware and the OS: Devices
that can be discovered and enumerated natively, through a protocol defined for
the specific bus that they are on (for example, configuration space in PCI),
without the platform firmware assistance, and devices that need to be described
by the platform firmware so that they can be discovered.  Still, for any device
known to the platform firmware, regardless of which category it falls into,
there can be a corresponding ACPI device object in the ACPI Namespace in which
case the Linux kernel will create a struct acpi_device object based on it for
that device.”h]”hXÍ  Generally speaking, there are two categories of devices in a system in which
ACPI is used as an interface between the platform firmware and the OS: Devices
that can be discovered and enumerated natively, through a protocol defined for
the specific bus that they are on (for example, configuration space in PCI),
without the platform firmware assistance, and devices that need to be described
by the platform firmware so that they can be discovered.  Still, for any device
known to the platform firmware, regardless of which category it falls into,
there can be a corresponding ACPI device object in the ACPI Namespace in which
case the Linux kernel will create a struct acpi_device object based on it for
that device.”…””}”(hjâ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KFhjÑ  h²hubhÞ)”}”(hX‹  Those struct acpi_device objects are never used for binding drivers to natively
discoverable devices, because they are represented by other types of device
objects (for example, struct pci_dev for PCI devices) that are bound to by
device drivers (the corresponding struct acpi_device object is then used as
an additional source of information on the configuration of the given device).
Moreover, the core ACPI device enumeration code creates struct platform_device
objects for the majority of devices that are discovered and enumerated with the
help of the platform firmware and those platform device objects can be bound to
by platform drivers in direct analogy with the natively enumerable devices
case.  Therefore it is logically inconsistent and so generally invalid to bind
drivers to struct acpi_device objects, including drivers for devices that are
discovered with the help of the platform firmware.”h]”hX‹  Those struct acpi_device objects are never used for binding drivers to natively
discoverable devices, because they are represented by other types of device
objects (for example, struct pci_dev for PCI devices) that are bound to by
device drivers (the corresponding struct acpi_device object is then used as
an additional source of information on the configuration of the given device).
Moreover, the core ACPI device enumeration code creates struct platform_device
objects for the majority of devices that are discovered and enumerated with the
help of the platform firmware and those platform device objects can be bound to
by platform drivers in direct analogy with the natively enumerable devices
case.  Therefore it is logically inconsistent and so generally invalid to bind
drivers to struct acpi_device objects, including drivers for devices that are
discovered with the help of the platform firmware.”…””}”(hjð  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KQhjÑ  h²hubhÞ)”}”(hX  Historically, ACPI drivers that bound directly to struct acpi_device objects
were implemented for some devices enumerated with the help of the platform
firmware, but this is not recommended for any new drivers.  As explained above,
platform device objects are created for those devices as a rule (with a few
exceptions that are not relevant here) and so platform drivers should be used
for handling them, even though the corresponding ACPI device objects are the
only source of device configuration information in that case.”h]”hX  Historically, ACPI drivers that bound directly to struct acpi_device objects
were implemented for some devices enumerated with the help of the platform
firmware, but this is not recommended for any new drivers.  As explained above,
platform device objects are created for those devices as a rule (with a few
exceptions that are not relevant here) and so platform drivers should be used
for handling them, even though the corresponding ACPI device objects are the
only source of device configuration information in that case.”…””}”(hjþ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K^hjÑ  h²hubhÞ)”}”(hXý  For every device having a corresponding struct acpi_device object, the pointer
to it is returned by the ACPI_COMPANION() macro, so it is always possible to
get to the device configuration information stored in the ACPI device object
this way.  Accordingly, struct acpi_device can be regarded as a part of the
interface between the kernel and the ACPI Namespace, whereas device objects of
other types (for example, struct pci_dev or struct platform_device) are used
for interacting with the rest of the system.”h]”hXý  For every device having a corresponding struct acpi_device object, the pointer
to it is returned by the ACPI_COMPANION() macro, so it is always possible to
get to the device configuration information stored in the ACPI device object
this way.  Accordingly, struct acpi_device can be regarded as a part of the
interface between the kernel and the ACPI Namespace, whereas device objects of
other types (for example, struct pci_dev or struct platform_device) are used
for interacting with the rest of the system.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KfhjÑ  h²hubeh}”(h]”Œacpi-device-objects”ah ]”h"]”Œacpi device objects”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KDubhÉ)”}”(hhh]”(hÎ)”}”(hŒDMA support”h]”hŒDMA support”…””}”(hj%  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj"  h²hh³hÇh´KoubhÞ)”}”(hX&  DMA controllers enumerated via ACPI should be registered in the system to
provide generic access to their resources. For example, a driver that would
like to be accessible to slave devices via generic API call
dma_request_chan() must register itself at the end of the probe function like
this::”h]”hX%  DMA controllers enumerated via ACPI should be registered in the system to
provide generic access to their resources. For example, a driver that would
like to be accessible to slave devices via generic API call
dma_request_chan() must register itself at the end of the probe function like
this:”…””}”(hj3  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Kqhj"  h²hubj¬  )”}”(hŒwerr = devm_acpi_dma_controller_register(dev, xlate_func, dw);
/* Handle the error if it's not a case of !CONFIG_ACPI */”h]”hŒwerr = devm_acpi_dma_controller_register(dev, xlate_func, dw);
/* Handle the error if it's not a case of !CONFIG_ACPI */”…””}”hjA  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´Kwhj"  h²hubhÞ)”}”(hŒóand implement custom xlate function if needed (usually acpi_dma_simple_xlate()
is enough) which converts the FixedDMA resource provided by struct
acpi_dma_spec into the corresponding DMA channel. A piece of code for that case
could look like::”h]”hŒòand implement custom xlate function if needed (usually acpi_dma_simple_xlate()
is enough) which converts the FixedDMA resource provided by struct
acpi_dma_spec into the corresponding DMA channel. A piece of code for that case
could look like:”…””}”(hjO  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Kzhj"  h²hubj¬  )”}”(hX¡  #ifdef CONFIG_ACPI
struct filter_args {
        /* Provide necessary information for the filter_func */
        ...
};

static bool filter_func(struct dma_chan *chan, void *param)
{
        /* Choose the proper channel */
        ...
}

static struct dma_chan *xlate_func(struct acpi_dma_spec *dma_spec,
                struct acpi_dma *adma)
{
        dma_cap_mask_t cap;
        struct filter_args args;

        /* Prepare arguments for filter_func */
        ...
        return dma_request_channel(cap, filter_func, &args);
}
#else
static struct dma_chan *xlate_func(struct acpi_dma_spec *dma_spec,
                struct acpi_dma *adma)
{
        return NULL;
}
#endif”h]”hX¡  #ifdef CONFIG_ACPI
struct filter_args {
        /* Provide necessary information for the filter_func */
        ...
};

static bool filter_func(struct dma_chan *chan, void *param)
{
        /* Choose the proper channel */
        ...
}

static struct dma_chan *xlate_func(struct acpi_dma_spec *dma_spec,
                struct acpi_dma *adma)
{
        dma_cap_mask_t cap;
        struct filter_args args;

        /* Prepare arguments for filter_func */
        ...
        return dma_request_channel(cap, filter_func, &args);
}
#else
static struct dma_chan *xlate_func(struct acpi_dma_spec *dma_spec,
                struct acpi_dma *adma)
{
        return NULL;
}
#endif”…””}”hj]  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´Khj"  h²hubhÞ)”}”(hŒôdma_request_chan() will call xlate_func() for each registered DMA controller.
In the xlate function the proper channel must be chosen based on
information in struct acpi_dma_spec and the properties of the controller
provided by struct acpi_dma.”h]”hŒôdma_request_chan() will call xlate_func() for each registered DMA controller.
In the xlate function the proper channel must be chosen based on
information in struct acpi_dma_spec and the properties of the controller
provided by struct acpi_dma.”…””}”(hjk  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Khj"  h²hubhÞ)”}”(hŒôClients must call dma_request_chan() with the string parameter that corresponds
to a specific FixedDMA resource. By default "tx" means the first entry of the
FixedDMA resource array, "rx" means the second entry. The table below shows a
layout::”h]”hŒûClients must call dma_request_chan() with the string parameter that corresponds
to a specific FixedDMA resource. By default â€œtxâ€ means the first entry of the
FixedDMA resource array, â€œrxâ€ means the second entry. The table below shows a
layout:”…””}”(hjy  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K¢hj"  h²hubj¬  )”}”(hX>  Device (I2C0)
{
        ...
        Method (_CRS, 0, NotSerialized)
        {
                Name (DBUF, ResourceTemplate ()
                {
                        FixedDMA (0x0018, 0x0004, Width32bit, _Y48)
                        FixedDMA (0x0019, 0x0005, Width32bit, )
                })
        ...
        }
}”h]”hX>  Device (I2C0)
{
        ...
        Method (_CRS, 0, NotSerialized)
        {
                Name (DBUF, ResourceTemplate ()
                {
                        FixedDMA (0x0018, 0x0004, Width32bit, _Y48)
                        FixedDMA (0x0019, 0x0005, Width32bit, )
                })
        ...
        }
}”…””}”hj‡  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´K§hj"  h²hubhÞ)”}”(hŒWSo, the FixedDMA with request line 0x0018 is "tx" and next one is "rx" in
this example.”h]”hŒ_So, the FixedDMA with request line 0x0018 is â€œtxâ€ and next one is â€œrxâ€ in
this example.”…””}”(hj•  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Kµhj"  h²hubhÞ)”}”(hŒ¨In robust cases the client unfortunately needs to call
acpi_dma_request_slave_chan_by_index() directly and therefore choose the
specific FixedDMA resource by its index.”h]”hŒ¨In robust cases the client unfortunately needs to call
acpi_dma_request_slave_chan_by_index() directly and therefore choose the
specific FixedDMA resource by its index.”…””}”(hj£  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K¸hj"  h²hubeh}”(h]”Œdma-support”ah ]”h"]”Œdma support”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KoubhÉ)”}”(hhh]”(hÎ)”}”(hŒNamed Interrupts”h]”hŒNamed Interrupts”…””}”(hj¼  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj¹  h²hh³hÇh´K½ubhÞ)”}”(hŒDrivers enumerated via ACPI can have names to interrupts in the ACPI table
which can be used to get the IRQ number in the driver.”h]”hŒDrivers enumerated via ACPI can have names to interrupts in the ACPI table
which can be used to get the IRQ number in the driver.”…””}”(hjÊ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´K¿hj¹  h²hubhÞ)”}”(hŒÉThe interrupt name can be listed in _DSD as 'interrupt-names'. The names
should be listed as an array of strings which will map to the Interrupt()
resource in the ACPI table corresponding to its index.”h]”hŒÍThe interrupt name can be listed in _DSD as â€˜interrupt-namesâ€™. The names
should be listed as an array of strings which will map to the Interrupt()
resource in the ACPI table corresponding to its index.”…””}”(hjØ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KÂhj¹  h²hubhÞ)”}”(hŒ/The table below shows an example of its usage::”h]”hŒ.The table below shows an example of its usage:”…””}”(hjæ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KÆhj¹  h²hubj¬  )”}”(hX˜  Device (DEV0) {
    ...
    Name (_CRS, ResourceTemplate() {
        ...
        Interrupt (ResourceConsumer, Level, ActiveHigh, Exclusive) {
            0x20,
            0x24
        }
    })

    Name (_DSD, Package () {
        ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
        Package () {
            Package () { "interrupt-names", Package () { "default", "alert" } },
        }
    ...
    })
}”h]”hX˜  Device (DEV0) {
    ...
    Name (_CRS, ResourceTemplate() {
        ...
        Interrupt (ResourceConsumer, Level, ActiveHigh, Exclusive) {
            0x20,
            0x24
        }
    })

    Name (_DSD, Package () {
        ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
        Package () {
            Package () { "interrupt-names", Package () { "default", "alert" } },
        }
    ...
    })
}”…””}”hjô  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´KÈhj¹  h²hubhÞ)”}”(hŒ±The interrupt name 'default' will correspond to 0x20 in Interrupt()
resource and 'alert' to 0x24. Note that only the Interrupt() resource
is mapped and not GpioInt() or similar.”h]”hŒ¹The interrupt name â€˜defaultâ€™ will correspond to 0x20 in Interrupt()
resource and â€˜alertâ€™ to 0x24. Note that only the Interrupt() resource
is mapped and not GpioInt() or similar.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´KÛhj¹  h²hubhÞ)”}”(hŒThe driver can call the function - fwnode_irq_get_byname() with the fwnode
and interrupt name as arguments to get the corresponding IRQ number.”h]”hŒThe driver can call the function - fwnode_irq_get_byname() with the fwnode
and interrupt name as arguments to get the corresponding IRQ number.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Kßhj¹  h²hubeh}”(h]”Œnamed-interrupts”ah ]”h"]”Œnamed interrupts”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´K½ubhÉ)”}”(hhh]”(hÎ)”}”(hŒSPI serial bus support”h]”hŒSPI serial bus support”…””}”(hj)  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj&  h²hh³hÇh´KãubhÞ)”}”(hŒÖSlave devices behind SPI bus have SpiSerialBus resource attached to them.
This is extracted automatically by the SPI core and the slave devices are
enumerated once spi_register_master() is called by the bus driver.”h]”hŒÖSlave devices behind SPI bus have SpiSerialBus resource attached to them.
This is extracted automatically by the SPI core and the slave devices are
enumerated once spi_register_master() is called by the bus driver.”…””}”(hj7  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Kåhj&  h²hubhÞ)”}”(hŒAHere is what the ACPI namespace for a SPI slave might look like::”h]”hŒ@Here is what the ACPI namespace for a SPI slave might look like:”…””}”(hjE  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Kéhj&  h²hubj¬  )”}”(hX  Device (EEP0)
{
        Name (_ADR, 1)
        Name (_CID, Package () {
                "ATML0025",
                "AT25",
        })
        ...
        Method (_CRS, 0, NotSerialized)
        {
                SPISerialBus(1, PolarityLow, FourWireMode, 8,
                        ControllerInitiated, 1000000, ClockPolarityLow,
                        ClockPhaseFirst, "\\_SB.PCI0.SPI1",)
        }
        ...”h]”hX  Device (EEP0)
{
        Name (_ADR, 1)
        Name (_CID, Package () {
                "ATML0025",
                "AT25",
        })
        ...
        Method (_CRS, 0, NotSerialized)
        {
                SPISerialBus(1, PolarityLow, FourWireMode, 8,
                        ControllerInitiated, 1000000, ClockPolarityLow,
                        ClockPhaseFirst, "\\_SB.PCI0.SPI1",)
        }
        ...”…””}”hjS  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´Këhj&  h²hubhÞ)”}”(hŒÖThe SPI device drivers only need to add ACPI IDs in a similar way to
the platform device drivers. Below is an example where we add ACPI support
to at25 SPI eeprom driver (this is meant for the above ACPI snippet)::”h]”hŒÕThe SPI device drivers only need to add ACPI IDs in a similar way to
the platform device drivers. Below is an example where we add ACPI support
to at25 SPI eeprom driver (this is meant for the above ACPI snippet):”…””}”(hja  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Kûhj&  h²hubj¬  )”}”(hX  static const struct acpi_device_id at25_acpi_match[] = {
        { "AT25", 0 },
        { }
};
MODULE_DEVICE_TABLE(acpi, at25_acpi_match);

static struct spi_driver at25_driver = {
        .driver = {
                ...
                .acpi_match_table = at25_acpi_match,
        },
};”h]”hX  static const struct acpi_device_id at25_acpi_match[] = {
        { "AT25", 0 },
        { }
};
MODULE_DEVICE_TABLE(acpi, at25_acpi_match);

static struct spi_driver at25_driver = {
        .driver = {
                ...
                .acpi_match_table = at25_acpi_match,
        },
};”…””}”hjo  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´Kÿhj&  h²hubhÞ)”}”(hŒŽNote that this driver actually needs more information like page size of the
eeprom, etc. This information can be passed via _DSD method like::”h]”hŒNote that this driver actually needs more information like page size of the
eeprom, etc. This information can be passed via _DSD method like:”…””}”(hj}  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Mhj&  h²hubj¬  )”}”(hXx  Device (EEP0)
{
        ...
        Name (_DSD, Package ()
        {
                ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
                Package ()
                {
                        Package () { "size", 1024 },
                        Package () { "pagesize", 32 },
                        Package () { "address-width", 16 },
                }
        })
}”h]”hXx  Device (EEP0)
{
        ...
        Name (_DSD, Package ()
        {
                ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
                Package ()
                {
                        Package () { "size", 1024 },
                        Package () { "pagesize", 32 },
                        Package () { "address-width", 16 },
                }
        })
}”…””}”hj‹  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´Mhj&  h²hubhÞ)”}”(hŒqThen the at25 SPI driver can get this configuration by calling device property
APIs during ->probe() phase like::”h]”hŒpThen the at25 SPI driver can get this configuration by calling device property
APIs during ->probe() phase like:”…””}”(hj™  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Mhj&  h²hubj¬  )”}”(hX'  err = device_property_read_u32(dev, "size", &size);
if (err)
        ...error handling...

err = device_property_read_u32(dev, "pagesize", &page_size);
if (err)
        ...error handling...

err = device_property_read_u32(dev, "address-width", &addr_width);
if (err)
        ...error handling...”h]”hX'  err = device_property_read_u32(dev, "size", &size);
if (err)
        ...error handling...

err = device_property_read_u32(dev, "pagesize", &page_size);
if (err)
        ...error handling...

err = device_property_read_u32(dev, "address-width", &addr_width);
if (err)
        ...error handling...”…””}”hj§  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´M!hj&  h²hubeh}”(h]”Œspi-serial-bus-support”ah ]”h"]”Œspi serial bus support”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´KãubhÉ)”}”(hhh]”(hÎ)”}”(hŒI2C serial bus support”h]”hŒI2C serial bus support”…””}”(hjÀ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj½  h²hh³hÇh´M.ubhÞ)”}”(hŒßThe slaves behind I2C bus controller only need to add the ACPI IDs like
with the platform and SPI drivers. The I2C core automatically enumerates
any slave devices behind the controller device once the adapter is
registered.”h]”hŒßThe slaves behind I2C bus controller only need to add the ACPI IDs like
with the platform and SPI drivers. The I2C core automatically enumerates
any slave devices behind the controller device once the adapter is
registered.”…””}”(hjÎ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´M0hj½  h²hubhÞ)”}”(hŒUBelow is an example of how to add ACPI support to the existing mpu3050
input driver::”h]”hŒTBelow is an example of how to add ACPI support to the existing mpu3050
input driver:”…””}”(hjÜ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´M5hj½  h²hubj¬  )”}”(hX?  static const struct acpi_device_id mpu3050_acpi_match[] = {
        { "MPU3050", 0 },
        { }
};
MODULE_DEVICE_TABLE(acpi, mpu3050_acpi_match);

static struct i2c_driver mpu3050_i2c_driver = {
        .driver = {
                .name   = "mpu3050",
                .pm     = &mpu3050_pm,
                .of_match_table = mpu3050_of_match,
                .acpi_match_table = mpu3050_acpi_match,
        },
        .probe          = mpu3050_probe,
        .remove         = mpu3050_remove,
        .id_table       = mpu3050_ids,
};
module_i2c_driver(mpu3050_i2c_driver);”h]”hX?  static const struct acpi_device_id mpu3050_acpi_match[] = {
        { "MPU3050", 0 },
        { }
};
MODULE_DEVICE_TABLE(acpi, mpu3050_acpi_match);

static struct i2c_driver mpu3050_i2c_driver = {
        .driver = {
                .name   = "mpu3050",
                .pm     = &mpu3050_pm,
                .of_match_table = mpu3050_of_match,
                .acpi_match_table = mpu3050_acpi_match,
        },
        .probe          = mpu3050_probe,
        .remove         = mpu3050_remove,
        .id_table       = mpu3050_ids,
};
module_i2c_driver(mpu3050_i2c_driver);”…””}”hjê  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´M8hj½  h²hubeh}”(h]”Œi2c-serial-bus-support”ah ]”h"]”Œi2c serial bus support”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´M.ubhÉ)”}”(hhh]”(hÎ)”}”(hŒReference to PWM device”h]”hŒReference to PWM device”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj   h²hh³hÇh´MLubhÞ)”}”(hŒ¨Sometimes a device can be a consumer of PWM channel. Obviously OS would like
to know which one. To provide this mapping the special property has been
introduced, i.e.::”h]”hŒ§Sometimes a device can be a consumer of PWM channel. Obviously OS would like
to know which one. To provide this mapping the special property has been
introduced, i.e.:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MNhj   h²hubj¬  )”}”(hXN  Device (DEV)
{
    Name (_DSD, Package ()
    {
        ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
        Package () {
            Package () { "compatible", Package () { "pwm-leds" } },
            Package () { "label", "alarm-led" },
            Package () { "pwms",
                Package () {
                    "\\_SB.PCI0.PWM",  // <PWM device reference>
                    0,                 // <PWM index>
                    600000000,         // <PWM period>
                    0,                 // <PWM flags>
                }
            }
        }
    })
    ...
}”h]”hXN  Device (DEV)
{
    Name (_DSD, Package ()
    {
        ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
        Package () {
            Package () { "compatible", Package () { "pwm-leds" } },
            Package () { "label", "alarm-led" },
            Package () { "pwms",
                Package () {
                    "\\_SB.PCI0.PWM",  // <PWM device reference>
                    0,                 // <PWM index>
                    600000000,         // <PWM period>
                    0,                 // <PWM flags>
                }
            }
        }
    })
    ...
}”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´MRhj   h²hubhÞ)”}”(hŒ¼In the above example the PWM-based LED driver references to the PWM channel 0
of \_SB.PCI0.PWM device with initial period setting equal to 600 ms (note that
value is given in nanoseconds).”h]”hŒ¼In the above example the PWM-based LED driver references to the PWM channel 0
of  _SB.PCI0.PWM device with initial period setting equal to 600 ms (note that
value is given in nanoseconds).”…””}”(hj-  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Mghj   h²hubeh}”(h]”Œreference-to-pwm-device”ah ]”h"]”Œreference to pwm device”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´MLubhÉ)”}”(hhh]”(hÎ)”}”(hŒGPIO support”h]”hŒGPIO support”…””}”(hjF  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjC  h²hh³hÇh´MlubhÞ)”}”(hX  ACPI 5 introduced two new resources to describe GPIO connections: GpioIo
and GpioInt. These resources can be used to pass GPIO numbers used by
the device to the driver. ACPI 5.1 extended this with _DSD (Device
Specific Data) which made it possible to name the GPIOs among other things.”h]”hX  ACPI 5 introduced two new resources to describe GPIO connections: GpioIo
and GpioInt. These resources can be used to pass GPIO numbers used by
the device to the driver. ACPI 5.1 extended this with _DSD (Device
Specific Data) which made it possible to name the GPIOs among other things.”…””}”(hjT  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MnhjC  h²hubhÞ)”}”(hŒFor example::”h]”hŒFor example:”…””}”(hjb  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MshjC  h²hubj¬  )”}”(hX  Device (DEV)
{
        Method (_CRS, 0, NotSerialized)
        {
                Name (SBUF, ResourceTemplate()
                {
                        // Used to power on/off the device
                        GpioIo (Exclusive, PullNone, 0, 0, IoRestrictionOutputOnly,
                                "\\_SB.PCI0.GPI0", 0, ResourceConsumer) { 85 }

                        // Interrupt for the device
                        GpioInt (Edge, ActiveHigh, ExclusiveAndWake, PullNone, 0,
                                 "\\_SB.PCI0.GPI0", 0, ResourceConsumer) { 88 }
                }

                Return (SBUF)
        }

        // ACPI 5.1 _DSD used for naming the GPIOs
        Name (_DSD, Package ()
        {
                ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
                Package ()
                {
                        Package () { "power-gpios", Package () { ^DEV, 0, 0, 0 } },
                        Package () { "irq-gpios", Package () { ^DEV, 1, 0, 0 } },
                }
        })
        ...
}”h]”hX  Device (DEV)
{
        Method (_CRS, 0, NotSerialized)
        {
                Name (SBUF, ResourceTemplate()
                {
                        // Used to power on/off the device
                        GpioIo (Exclusive, PullNone, 0, 0, IoRestrictionOutputOnly,
                                "\\_SB.PCI0.GPI0", 0, ResourceConsumer) { 85 }

                        // Interrupt for the device
                        GpioInt (Edge, ActiveHigh, ExclusiveAndWake, PullNone, 0,
                                 "\\_SB.PCI0.GPI0", 0, ResourceConsumer) { 88 }
                }

                Return (SBUF)
        }

        // ACPI 5.1 _DSD used for naming the GPIOs
        Name (_DSD, Package ()
        {
                ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
                Package ()
                {
                        Package () { "power-gpios", Package () { ^DEV, 0, 0, 0 } },
                        Package () { "irq-gpios", Package () { ^DEV, 1, 0, 0 } },
                }
        })
        ...
}”…””}”hjp  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´MuhjC  h²hubhÞ)”}”(hŒ×These GPIO numbers are controller relative and path "\\_SB.PCI0.GPI0"
specifies the path to the controller. In order to use these GPIOs in Linux
we need to translate them to the corresponding Linux GPIO descriptors.”h]”hŒÛThese GPIO numbers are controller relative and path â€œ \_SB.PCI0.GPI0â€
specifies the path to the controller. In order to use these GPIOs in Linux
we need to translate them to the corresponding Linux GPIO descriptors.”…””}”(hj~  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´M”hjC  h²hubhÞ)”}”(hŒ^There is a standard GPIO API for that and it is documented in
Documentation/admin-guide/gpio/.”h]”hŒ^There is a standard GPIO API for that and it is documented in
Documentation/admin-guide/gpio/.”…””}”(hjŒ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´M˜hjC  h²hubhÞ)”}”(hŒ^In the above example we can get the corresponding two GPIO descriptors with
a code like this::”h]”hŒ]In the above example we can get the corresponding two GPIO descriptors with
a code like this:”…””}”(hjš  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´M›hjC  h²hubj¬  )”}”(hX'  #include <linux/gpio/consumer.h>
...

struct gpio_desc *irq_desc, *power_desc;

irq_desc = gpiod_get(dev, "irq");
if (IS_ERR(irq_desc))
        /* handle error */

power_desc = gpiod_get(dev, "power");
if (IS_ERR(power_desc))
        /* handle error */

/* Now we can use the GPIO descriptors */”h]”hX'  #include <linux/gpio/consumer.h>
...

struct gpio_desc *irq_desc, *power_desc;

irq_desc = gpiod_get(dev, "irq");
if (IS_ERR(irq_desc))
        /* handle error */

power_desc = gpiod_get(dev, "power");
if (IS_ERR(power_desc))
        /* handle error */

/* Now we can use the GPIO descriptors */”…””}”hj¨  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´MžhjC  h²hubhÞ)”}”(hŒlThere are also devm_* versions of these functions which release the
descriptors once the device is released.”h]”hŒlThere are also devm_* versions of these functions which release the
descriptors once the device is released.”…””}”(hj¶  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´M­hjC  h²hubhÞ)”}”(hŒwSee Documentation/firmware-guide/acpi/gpio-properties.rst for more information
about the _DSD binding related to GPIOs.”h]”hŒwSee Documentation/firmware-guide/acpi/gpio-properties.rst for more information
about the _DSD binding related to GPIOs.”…””}”(hjÄ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´M°hjC  h²hubeh}”(h]”Œgpio-support”ah ]”h"]”Œgpio support”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´MlubhÉ)”}”(hhh]”(hÎ)”}”(hŒRS-485 support”h]”hŒRS-485 support”…””}”(hjÝ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjÚ  h²hh³hÇh´M´ubhÞ)”}”(hŒSACPI _DSD (Device Specific Data) can be used to describe RS-485 capability
of UART.”h]”hŒSACPI _DSD (Device Specific Data) can be used to describe RS-485 capability
of UART.”…””}”(hjë  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´M¶hjÚ  h²hubhÞ)”}”(hŒFor example::”h]”hŒFor example:”…””}”(hjù  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´M¹hjÚ  h²hubj¬  )”}”(hX×  Device (DEV)
{
        ...

        // ACPI 5.1 _DSD used for RS-485 capabilities
        Name (_DSD, Package ()
        {
                ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
                Package ()
                {
                        Package () {"rs485-rts-active-low", Zero},
                        Package () {"rs485-rx-active-high", Zero},
                        Package () {"rs485-rx-during-tx", Zero},
                }
        })
        ...”h]”hX×  Device (DEV)
{
        ...

        // ACPI 5.1 _DSD used for RS-485 capabilities
        Name (_DSD, Package ()
        {
                ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
                Package ()
                {
                        Package () {"rs485-rts-active-low", Zero},
                        Package () {"rs485-rx-active-high", Zero},
                        Package () {"rs485-rx-during-tx", Zero},
                }
        })
        ...”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´M»hjÚ  h²hubeh}”(h]”Œrs-485-support”ah ]”h"]”Œrs-485 support”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´M´ubhÉ)”}”(hhh]”(hÎ)”}”(hŒMFD devices”h]”hŒMFD devices”…””}”(hj   h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj  h²hh³hÇh´MÍubhÞ)”}”(hŒóThe MFD devices register their children as platform devices. For the child
devices there needs to be an ACPI handle that they can use to reference
parts of the ACPI namespace that relate to them. In the Linux MFD subsystem
we provide two ways:”h]”hŒóThe MFD devices register their children as platform devices. For the child
devices there needs to be an ACPI handle that they can use to reference
parts of the ACPI namespace that relate to them. In the Linux MFD subsystem
we provide two ways:”…””}”(hj.  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MÏhj  h²hubj
  )”}”(hŒc- The children share the parent ACPI handle.
- The MFD cell can specify the ACPI id of the device.
”h]”j  )”}”(hhh]”(j  )”}”(hŒ*The children share the parent ACPI handle.”h]”hÞ)”}”(hjE  h]”hŒ*The children share the parent ACPI handle.”…””}”(hjG  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MÔhjC  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj@  ubj  )”}”(hŒ4The MFD cell can specify the ACPI id of the device.
”h]”hÞ)”}”(hŒ3The MFD cell can specify the ACPI id of the device.”h]”hŒ3The MFD cell can specify the ACPI id of the device.”…””}”(hj^  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MÕhjZ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj@  ubeh}”(h]”h ]”h"]”h$]”h&]”jL  jM  uh1j  h³hÇh´MÔhj<  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j	  h³hÇh´MÔhj  h²hubhÞ)”}”(hŒ¥For the first case, the MFD drivers do not need to do anything. The
resulting child platform device will have its ACPI_COMPANION() set to point
to the parent device.”h]”hŒ¥For the first case, the MFD drivers do not need to do anything. The
resulting child platform device will have its ACPI_COMPANION() set to point
to the parent device.”…””}”(hj~  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´M×hj  h²hubhÞ)”}”(hŒpIf the ACPI namespace has a device that we can match using an ACPI id or ACPI
adr, the cell should be set like::”h]”hŒoIf the ACPI namespace has a device that we can match using an ACPI id or ACPI
adr, the cell should be set like:”…””}”(hjŒ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MÛhj  h²hubj¬  )”}”(hX0  static struct mfd_cell_acpi_match my_subdevice_cell_acpi_match = {
        .pnpid = "XYZ0001",
        .adr = 0,
};

static struct mfd_cell my_subdevice_cell = {
        .name = "my_subdevice",
        /* set the resources relative to the parent */
        .acpi_match = &my_subdevice_cell_acpi_match,
};”h]”hX0  static struct mfd_cell_acpi_match my_subdevice_cell_acpi_match = {
        .pnpid = "XYZ0001",
        .adr = 0,
};

static struct mfd_cell my_subdevice_cell = {
        .name = "my_subdevice",
        /* set the resources relative to the parent */
        .acpi_match = &my_subdevice_cell_acpi_match,
};”…””}”hjš  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´MÞhj  h²hubhÞ)”}”(hŒ³The ACPI id "XYZ0001" is then used to lookup an ACPI device directly under
the MFD device and if found, that ACPI companion device is bound to the
resulting child platform device.”h]”hŒ·The ACPI id â€œXYZ0001â€ is then used to lookup an ACPI device directly under
the MFD device and if found, that ACPI companion device is bound to the
resulting child platform device.”…””}”(hj¨  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Méhj  h²hubeh}”(h]”Œmfd-devices”ah ]”h"]”Œmfd devices”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´MÍubhÉ)”}”(hhh]”(hÎ)”}”(hŒ$Device Tree namespace link device ID”h]”hŒ$Device Tree namespace link device ID”…””}”(hjÁ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhj¾  h²hh³hÇh´MîubhÞ)”}”(hXµ  The Device Tree protocol uses device identification based on the "compatible"
property whose value is a string or an array of strings recognized as device
identifiers by drivers and the driver core.  The set of all those strings may be
regarded as a device identification namespace analogous to the ACPI/PNP device
ID namespace.  Consequently, in principle it should not be necessary to allocate
a new (and arguably redundant) ACPI/PNP device ID for a devices with an existing
identification string in the Device Tree (DT) namespace, especially if that ID
is only needed to indicate that a given device is compatible with another one,
presumably having a matching driver in the kernel already.”h]”hX¹  The Device Tree protocol uses device identification based on the â€œcompatibleâ€
property whose value is a string or an array of strings recognized as device
identifiers by drivers and the driver core.  The set of all those strings may be
regarded as a device identification namespace analogous to the ACPI/PNP device
ID namespace.  Consequently, in principle it should not be necessary to allocate
a new (and arguably redundant) ACPI/PNP device ID for a devices with an existing
identification string in the Device Tree (DT) namespace, especially if that ID
is only needed to indicate that a given device is compatible with another one,
presumably having a matching driver in the kernel already.”…””}”(hjÏ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Mðhj¾  h²hubhÞ)”}”(hXy  In ACPI, the device identification object called _CID (Compatible ID) is used to
list the IDs of devices the given one is compatible with, but those IDs must
belong to one of the namespaces prescribed by the ACPI specification (see
Section 6.1.2 of ACPI 6.0 for details) and the DT namespace is not one of them.
Moreover, the specification mandates that either a _HID or an _ADR identification
object be present for all ACPI objects representing devices (Section 6.1 of ACPI
6.0).  For non-enumerable bus types that object must be _HID and its value must
be a device ID from one of the namespaces prescribed by the specification too.”h]”hXy  In ACPI, the device identification object called _CID (Compatible ID) is used to
list the IDs of devices the given one is compatible with, but those IDs must
belong to one of the namespaces prescribed by the ACPI specification (see
Section 6.1.2 of ACPI 6.0 for details) and the DT namespace is not one of them.
Moreover, the specification mandates that either a _HID or an _ADR identification
object be present for all ACPI objects representing devices (Section 6.1 of ACPI
6.0).  For non-enumerable bus types that object must be _HID and its value must
be a device ID from one of the namespaces prescribed by the specification too.”…””}”(hjÝ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Múhj¾  h²hubhÞ)”}”(hXü  The special DT namespace link device ID, PRP0001, provides a means to use the
existing DT-compatible device identification in ACPI and to satisfy the above
requirements following from the ACPI specification at the same time.  Namely,
if PRP0001 is returned by _HID, the ACPI subsystem will look for the
"compatible" property in the device object's _DSD and will use the value of that
property to identify the corresponding device in analogy with the original DT
device identification algorithm.  If the "compatible" property is not present
or its value is not valid, the device will not be enumerated by the ACPI
subsystem.  Otherwise, it will be enumerated automatically as a platform device
(except when an I2C or SPI link from the device to its parent is present, in
which case the ACPI core will leave the device enumeration to the parent's
driver) and the identification strings from the "compatible" property value will
be used to find a driver for the device along with the device IDs listed by _CID
(if present).”h]”hX  The special DT namespace link device ID, PRP0001, provides a means to use the
existing DT-compatible device identification in ACPI and to satisfy the above
requirements following from the ACPI specification at the same time.  Namely,
if PRP0001 is returned by _HID, the ACPI subsystem will look for the
â€œcompatibleâ€ property in the device objectâ€™s _DSD and will use the value of that
property to identify the corresponding device in analogy with the original DT
device identification algorithm.  If the â€œcompatibleâ€ property is not present
or its value is not valid, the device will not be enumerated by the ACPI
subsystem.  Otherwise, it will be enumerated automatically as a platform device
(except when an I2C or SPI link from the device to its parent is present, in
which case the ACPI core will leave the device enumeration to the parentâ€™s
driver) and the identification strings from the â€œcompatibleâ€ property value will
be used to find a driver for the device along with the device IDs listed by _CID
(if present).”…””}”(hjë  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Mhj¾  h²hubhÞ)”}”(hXh  Analogously, if PRP0001 is present in the list of device IDs returned by _CID,
the identification strings listed by the "compatible" property value (if present
and valid) will be used to look for a driver matching the device, but in that
case their relative priority with respect to the other device IDs listed by
_HID and _CID depends on the position of PRP0001 in the _CID return package.
Specifically, the device IDs returned by _HID and preceding PRP0001 in the _CID
return package will be checked first.  Also in that case the bus type the device
will be enumerated to depends on the device ID returned by _HID.”h]”hXl  Analogously, if PRP0001 is present in the list of device IDs returned by _CID,
the identification strings listed by the â€œcompatibleâ€ property value (if present
and valid) will be used to look for a driver matching the device, but in that
case their relative priority with respect to the other device IDs listed by
_HID and _CID depends on the position of PRP0001 in the _CID return package.
Specifically, the device IDs returned by _HID and preceding PRP0001 in the _CID
return package will be checked first.  Also in that case the bus type the device
will be enumerated to depends on the device ID returned by _HID.”…””}”(hjù  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Mhj¾  h²hubhÞ)”}”(hŒ§For example, the following ACPI sample might be used to enumerate an lm75-type
I2C temperature sensor and match it to the driver using the Device Tree
namespace link::”h]”hŒ¦For example, the following ACPI sample might be used to enumerate an lm75-type
I2C temperature sensor and match it to the driver using the Device Tree
namespace link:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´Mhj¾  h²hubj¬  )”}”(hX°  Device (TMP0)
{
        Name (_HID, "PRP0001")
        Name (_DSD, Package () {
                ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
                Package () {
                        Package () { "compatible", "ti,tmp75" },
                }
        })
        Method (_CRS, 0, Serialized)
        {
                Name (SBUF, ResourceTemplate ()
                {
                        I2cSerialBusV2 (0x48, ControllerInitiated,
                                400000, AddressingMode7Bit,
                                "\\_SB.PCI0.I2C1", 0x00,
                                ResourceConsumer, , Exclusive,)
                })
                Return (SBUF)
        }
}”h]”hX°  Device (TMP0)
{
        Name (_HID, "PRP0001")
        Name (_DSD, Package () {
                ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
                Package () {
                        Package () { "compatible", "ti,tmp75" },
                }
        })
        Method (_CRS, 0, Serialized)
        {
                Name (SBUF, ResourceTemplate ()
                {
                        I2cSerialBusV2 (0x48, ControllerInitiated,
                                400000, AddressingMode7Bit,
                                "\\_SB.PCI0.I2C1", 0x00,
                                ResourceConsumer, , Exclusive,)
                })
                Return (SBUF)
        }
}”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´Mhj¾  h²hubhÞ)”}”(hXz  It is valid to define device objects with a _HID returning PRP0001 and without
the "compatible" property in the _DSD or a _CID as long as one of their
ancestors provides a _DSD with a valid "compatible" property.  Such device
objects are then simply regarded as additional "blocks" providing hierarchical
configuration information to the driver of the composite ancestor device.”h]”hX†  It is valid to define device objects with a _HID returning PRP0001 and without
the â€œcompatibleâ€ property in the _DSD or a _CID as long as one of their
ancestors provides a _DSD with a valid â€œcompatibleâ€ property.  Such device
objects are then simply regarded as additional â€œblocksâ€ providing hierarchical
configuration information to the driver of the composite ancestor device.”…””}”(hj#  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´M5hj¾  h²hubhÞ)”}”(hX©  However, PRP0001 can only be returned from either _HID or _CID of a device
object if all of the properties returned by the _DSD associated with it (either
the _DSD of the device object itself or the _DSD of its ancestor in the
"composite device" case described above) can be used in the ACPI environment.
Otherwise, the _DSD itself is regarded as invalid and therefore the "compatible"
property returned by it is meaningless.”h]”hX±  However, PRP0001 can only be returned from either _HID or _CID of a device
object if all of the properties returned by the _DSD associated with it (either
the _DSD of the device object itself or the _DSD of its ancestor in the
â€œcomposite deviceâ€ case described above) can be used in the ACPI environment.
Otherwise, the _DSD itself is regarded as invalid and therefore the â€œcompatibleâ€
property returned by it is meaningless.”…””}”(hj1  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´M;hj¾  h²hubhÞ)”}”(hŒYRefer to Documentation/firmware-guide/acpi/DSD-properties-rules.rst for more
information.”h]”hŒYRefer to Documentation/firmware-guide/acpi/DSD-properties-rules.rst for more
information.”…””}”(hj?  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MBhj¾  h²hubeh}”(h]”Œ$device-tree-namespace-link-device-id”ah ]”h"]”Œ$device tree namespace link device id”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´MîubhÉ)”}”(hhh]”(hÎ)”}”(hŒPCI hierarchy representation”h]”hŒPCI hierarchy representation”…””}”(hjX  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjU  h²hh³hÇh´MFubhÞ)”}”(hŒ\Sometimes it could be useful to enumerate a PCI device, knowing its position on
the PCI bus.”h]”hŒ\Sometimes it could be useful to enumerate a PCI device, knowing its position on
the PCI bus.”…””}”(hjf  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MHhjU  h²hubhÞ)”}”(hŒûFor example, some systems use PCI devices soldered directly on the mother board,
in a fixed position (ethernet, Wi-Fi, serial ports, etc.). In this conditions it
is possible to refer to these PCI devices knowing their position on the PCI bus
topology.”h]”hŒûFor example, some systems use PCI devices soldered directly on the mother board,
in a fixed position (ethernet, Wi-Fi, serial ports, etc.). In this conditions it
is possible to refer to these PCI devices knowing their position on the PCI bus
topology.”…””}”(hjt  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MKhjU  h²hubhÞ)”}”(hŒ¶To identify a PCI device, a complete hierarchical description is required, from
the chipset root port to the final device, through all the intermediate
bridges/switches of the board.”h]”hŒ¶To identify a PCI device, a complete hierarchical description is required, from
the chipset root port to the final device, through all the intermediate
bridges/switches of the board.”…””}”(hj‚  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MPhjU  h²hubhÞ)”}”(hX  For example, let's assume we have a system with a PCIe serial port, an
Exar XR17V3521, soldered on the main board. This UART chip also includes
16 GPIOs and we want to add the property ``gpio-line-names`` [1]_ to these pins.
In this case, the ``lspci`` output for this component is::”h]”(hŒ»For example, letâ€™s assume we have a system with a PCIe serial port, an
Exar XR17V3521, soldered on the main board. This UART chip also includes
16 GPIOs and we want to add the property ”…””}”(hj  h²hh³Nh´NubhŒliteral”“”)”}”(hŒ``gpio-line-names``”h]”hŒgpio-line-names”…””}”(hjš  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hj  ubhŒ ”…””}”(hj  h²hh³Nh´NubhŒfootnote_reference”“”)”}”(hŒ[1]_”h]”hŒ1”…””}”(hj®  h²hh³Nh´Nubah}”(h]”Œid1”ah ]”h"]”h$]”h&]”Œrefid”Œid4”Œdocname”Œfirmware-guide/acpi/enumeration”uh1j¬  hj  Œresolved”KubhŒ" to these pins.
In this case, the ”…””}”(hj  h²hh³Nh´Nubj™  )”}”(hŒ	``lspci``”h]”hŒlspci”…””}”(hjÆ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hj  ubhŒ output for this component is:”…””}”(hj  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MThjU  h²hubj¬  )”}”(hŒG07:00.0 Serial controller: Exar Corp. XR17V3521 Dual PCIe UART (rev 03)”h]”hŒG07:00.0 Serial controller: Exar Corp. XR17V3521 Dual PCIe UART (rev 03)”…””}”hjÞ  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´MYhjU  h²hubhÞ)”}”(hŒ?The complete ``lspci`` output (manually reduced in length) is::”h]”(hŒThe complete ”…””}”(hjì  h²hh³Nh´Nubj™  )”}”(hŒ	``lspci``”h]”hŒlspci”…””}”(hjô  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hjì  ubhŒ( output (manually reduced in length) is:”…””}”(hjì  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´M[hjU  h²hubj¬  )”}”(hXÕ  00:00.0 Host bridge: Intel Corp... Host Bridge (rev 0d)
...
00:13.0 PCI bridge: Intel Corp... PCI Express Port A #1 (rev fd)
00:13.1 PCI bridge: Intel Corp... PCI Express Port A #2 (rev fd)
00:13.2 PCI bridge: Intel Corp... PCI Express Port A #3 (rev fd)
00:14.0 PCI bridge: Intel Corp... PCI Express Port B #1 (rev fd)
00:14.1 PCI bridge: Intel Corp... PCI Express Port B #2 (rev fd)
...
05:00.0 PCI bridge: Pericom Semiconductor Device 2404 (rev 05)
06:01.0 PCI bridge: Pericom Semiconductor Device 2404 (rev 05)
06:02.0 PCI bridge: Pericom Semiconductor Device 2404 (rev 05)
06:03.0 PCI bridge: Pericom Semiconductor Device 2404 (rev 05)
07:00.0 Serial controller: Exar Corp. XR17V3521 Dual PCIe UART (rev 03) <-- Exar
...”h]”hXÕ  00:00.0 Host bridge: Intel Corp... Host Bridge (rev 0d)
...
00:13.0 PCI bridge: Intel Corp... PCI Express Port A #1 (rev fd)
00:13.1 PCI bridge: Intel Corp... PCI Express Port A #2 (rev fd)
00:13.2 PCI bridge: Intel Corp... PCI Express Port A #3 (rev fd)
00:14.0 PCI bridge: Intel Corp... PCI Express Port B #1 (rev fd)
00:14.1 PCI bridge: Intel Corp... PCI Express Port B #2 (rev fd)
...
05:00.0 PCI bridge: Pericom Semiconductor Device 2404 (rev 05)
06:01.0 PCI bridge: Pericom Semiconductor Device 2404 (rev 05)
06:02.0 PCI bridge: Pericom Semiconductor Device 2404 (rev 05)
06:03.0 PCI bridge: Pericom Semiconductor Device 2404 (rev 05)
07:00.0 Serial controller: Exar Corp. XR17V3521 Dual PCIe UART (rev 03) <-- Exar
...”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´M]hjU  h²hubhÞ)”}”(hŒThe bus topology is::”h]”hŒThe bus topology is:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MlhjU  h²hubj¬  )”}”(hXw  -[0000:00]-+-00.0
           ...
           +-13.0-[01]----00.0
           +-13.1-[02]----00.0
           +-13.2-[03]--
           +-14.0-[04]----00.0
           +-14.1-[05-09]----00.0-[06-09]--+-01.0-[07]----00.0 <-- Exar
           |                               +-02.0-[08]----00.0
           |                               \-03.0-[09]--
           ...
           \-1f.1”h]”hXw  -[0000:00]-+-00.0
           ...
           +-13.0-[01]----00.0
           +-13.1-[02]----00.0
           +-13.2-[03]--
           +-14.0-[04]----00.0
           +-14.1-[05-09]----00.0-[06-09]--+-01.0-[07]----00.0 <-- Exar
           |                               +-02.0-[08]----00.0
           |                               \-03.0-[09]--
           ...
           \-1f.1”…””}”hj(  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´MnhjU  h²hubhÞ)”}”(hŒŒTo describe this Exar device on the PCI bus, we must start from the ACPI name
of the chipset bridge (also called "root port") with address::”h]”hŒTo describe this Exar device on the PCI bus, we must start from the ACPI name
of the chipset bridge (also called â€œroot portâ€) with address:”…””}”(hj6  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MzhjU  h²hubj¬  )”}”(hŒ!Bus: 0 - Device: 14 - Function: 1”h]”hŒ!Bus: 0 - Device: 14 - Function: 1”…””}”hjD  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´M}hjU  h²hubhÞ)”}”(hŒwTo find this information, it is necessary to disassemble the BIOS ACPI tables,
in particular the DSDT (see also [2]_)::”h]”(hŒpTo find this information, it is necessary to disassemble the BIOS ACPI tables,
in particular the DSDT (see also ”…””}”(hjR  h²hh³Nh´Nubj­  )”}”(hŒ[2]_”h]”hŒ2”…””}”(hjZ  h²hh³Nh´Nubah}”(h]”Œid2”ah ]”h"]”h$]”h&]”j½  Œid5”j¿  jÀ  uh1j¬  hjR  jÁ  KubhŒ):”…””}”(hjR  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MhjU  h²hubj¬  )”}”(hŒcmkdir ~/tables/
cd ~/tables/
acpidump > acpidump
acpixtract -a acpidump
iasl -e ssdt?.* -d dsdt.dat”h]”hŒcmkdir ~/tables/
cd ~/tables/
acpidump > acpidump
acpixtract -a acpidump
iasl -e ssdt?.* -d dsdt.dat”…””}”hjt  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´M‚hjU  h²hubhÞ)”}”(hŒ¡Now, in the dsdt.dsl, we have to search the device whose address is related to
0x14 (device) and 0x01 (function). In this case we can find the following
device::”h]”hŒ Now, in the dsdt.dsl, we have to search the device whose address is related to
0x14 (device) and 0x01 (function). In this case we can find the following
device:”…””}”(hj‚  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MˆhjU  h²hubj¬  )”}”(hXù  Scope (_SB.PCI0)
{
... other definitions follow ...
        Device (RP02)
        {
                Method (_ADR, 0, NotSerialized)  // _ADR: Address
                {
                        If ((RPA2 != Zero))
                        {
                                Return (RPA2) /* \RPA2 */
                        }
                        Else
                        {
                                Return (0x00140001)
                        }
                }
... other definitions follow ...”h]”hXù  Scope (_SB.PCI0)
{
... other definitions follow ...
        Device (RP02)
        {
                Method (_ADR, 0, NotSerialized)  // _ADR: Address
                {
                        If ((RPA2 != Zero))
                        {
                                Return (RPA2) /* \RPA2 */
                        }
                        Else
                        {
                                Return (0x00140001)
                        }
                }
... other definitions follow ...”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´MŒhjU  h²hubhÞ)”}”(hX;  and the _ADR method [3]_ returns exactly the device/function couple that
we are looking for. With this information and analyzing the above ``lspci``
output (both the devices list and the devices tree), we can write the following
ACPI description for the Exar PCIe UART, also adding the list of its GPIO line
names::”h]”(hŒand the _ADR method ”…””}”(hjž  h²hh³Nh´Nubj­  )”}”(hŒ[3]_”h]”hŒ3”…””}”(hj¦  h²hh³Nh´Nubah}”(h]”Œid3”ah ]”h"]”h$]”h&]”j½  Œid6”j¿  jÀ  uh1j¬  hjž  jÁ  KubhŒs returns exactly the device/function couple that
we are looking for. With this information and analyzing the above ”…””}”(hjž  h²hh³Nh´Nubj™  )”}”(hŒ	``lspci``”h]”hŒlspci”…””}”(hjº  •$&      h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j˜  hjž  ubhŒ¦
output (both the devices list and the devices tree), we can write the following
ACPI description for the Exar PCIe UART, also adding the list of its GPIO line
names:”…””}”(hjž  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MžhjU  h²hubj¬  )”}”(hX  Scope (_SB.PCI0.RP02)
{
        Device (BRG1) //Bridge
        {
                Name (_ADR, 0x0000)

                Device (BRG2) //Bridge
                {
                        Name (_ADR, 0x00010000)

                        Device (EXAR)
                        {
                                Name (_ADR, 0x0000)

                                Name (_DSD, Package ()
                                {
                                        ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
                                        Package ()
                                        {
                                                Package ()
                                                {
                                                        "gpio-line-names",
                                                        Package ()
                                                        {
                                                                "mode_232",
                                                                "mode_422",
                                                                "mode_485",
                                                                "misc_1",
                                                                "misc_2",
                                                                "misc_3",
                                                                "",
                                                                "",
                                                                "aux_1",
                                                                "aux_2",
                                                                "aux_3",
                                                        }
                                                }
                                        }
                                })
                        }
                }
        }
}”h]”hX  Scope (_SB.PCI0.RP02)
{
        Device (BRG1) //Bridge
        {
                Name (_ADR, 0x0000)

                Device (BRG2) //Bridge
                {
                        Name (_ADR, 0x00010000)

                        Device (EXAR)
                        {
                                Name (_ADR, 0x0000)

                                Name (_DSD, Package ()
                                {
                                        ToUUID("daffd814-6eba-4d8c-8a91-bc9bbf4aa301"),
                                        Package ()
                                        {
                                                Package ()
                                                {
                                                        "gpio-line-names",
                                                        Package ()
                                                        {
                                                                "mode_232",
                                                                "mode_422",
                                                                "mode_485",
                                                                "misc_1",
                                                                "misc_2",
                                                                "misc_3",
                                                                "",
                                                                "",
                                                                "aux_1",
                                                                "aux_2",
                                                                "aux_3",
                                                        }
                                                }
                                        }
                                })
                        }
                }
        }
}”…””}”hjÒ  sbah}”(h]”h ]”h"]”h$]”h&]”hÅhÆuh1j«  h³hÇh´M¤hjU  h²hubhÞ)”}”(hŒÚThe location "_SB.PCI0.RP02" is obtained by the above investigation in the
dsdt.dsl table, whereas the device names "BRG1", "BRG2" and "EXAR" are
created analyzing the position of the Exar UART in the PCI bus topology.”h]”hŒêThe location â€œ_SB.PCI0.RP02â€ is obtained by the above investigation in the
dsdt.dsl table, whereas the device names â€œBRG1â€, â€œBRG2â€ and â€œEXARâ€ are
created analyzing the position of the Exar UART in the PCI bus topology.”…””}”(hjà  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MÐhjU  h²hubeh}”(h]”Œpci-hierarchy-representation”ah ]”h"]”Œpci hierarchy representation”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´MFubhÉ)”}”(hhh]”(hÎ)”}”(hŒ
References”h]”hŒ
References”…””}”(hjù  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÍhjö  h²hh³hÇh´MÕubhŒfootnote”“”)”}”(hŒ6Documentation/firmware-guide/acpi/gpio-properties.rst
”h]”(hŒlabel”“”)”}”(hŒ1”h]”hŒ1”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj	  ubhÞ)”}”(hŒ5Documentation/firmware-guide/acpi/gpio-properties.rst”h]”hŒ5Documentation/firmware-guide/acpi/gpio-properties.rst”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´M×hj	  ubeh}”(h]”j¾  ah ]”h"]”Œ1”ah$]”h&]”j¸  aj¿  jÀ  uh1j  h³hÇh´M×hjö  h²hjÁ  Kubj  )”}”(hŒ9Documentation/admin-guide/acpi/initrd_table_override.rst
”h]”(j  )”}”(hŒ2”h]”hŒ2”…””}”(hj6  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj2  ubhÞ)”}”(hŒ8Documentation/admin-guide/acpi/initrd_table_override.rst”h]”hŒ8Documentation/admin-guide/acpi/initrd_table_override.rst”…””}”(hjD  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MÙhj2  ubeh}”(h]”ji  ah ]”h"]”Œ2”ah$]”h&]”jd  aj¿  jÀ  uh1j  h³hÇh´MÙhjö  h²hjÁ  Kubj  )”}”(hŒ™ACPI Specifications, Version 6.3 - Paragraph 6.1.1 _ADR Address)
https://uefi.org/sites/default/files/resources/ACPI_6_3_May16.pdf,
referenced 2020-11-18”h]”(j  )”}”(hŒ3”h]”hŒ3”…””}”(hj]  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjY  ubhÞ)”}”(hŒ™ACPI Specifications, Version 6.3 - Paragraph 6.1.1 _ADR Address)
https://uefi.org/sites/default/files/resources/ACPI_6_3_May16.pdf,
referenced 2020-11-18”h]”(hŒAACPI Specifications, Version 6.3 - Paragraph 6.1.1 _ADR Address)
”…””}”(hjk  h²hh³Nh´NubhŒ	reference”“”)”}”(hŒAhttps://uefi.org/sites/default/files/resources/ACPI_6_3_May16.pdf”h]”hŒAhttps://uefi.org/sites/default/files/resources/ACPI_6_3_May16.pdf”…””}”(hju  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jw  uh1js  hjk  ubhŒ,
referenced 2020-11-18”…””}”(hjk  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÝh³hÇh´MÛhjY  ubeh}”(h]”jµ  ah ]”h"]”Œ3”ah$]”h&]”j°  aj¿  jÀ  uh1j  h³hÇh´MÛhjö  h²hjÁ  Kubeh}”(h]”Œ
references”ah ]”h"]”Œ
references”ah$]”h&]”uh1hÈhhÊh²hh³hÇh´MÕubeh}”(h]”Œacpi-based-device-enumeration”ah ]”h"]”Œacpi based device enumeration”ah$]”h&]”uh1hÈhhh²hh³hÇh´Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÇuh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hÍNŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jÈ  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÇŒ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”(Œ1”]”j®  aŒ2”]”jZ  aŒ3”]”j¦  auŒrefids”}”Œnameids”}”(j¢  jŸ  jÎ  jË  j  j  j¶  j³  j#  j   jº  j·  jý  jú  j@  j=  j×  jÔ  j  j  j»  j¸  jR  jO  jó  jð  jš  j—  j/  j¾  jV  ji  j’  jµ  uŒ	nametypes”}”(j¢  ‰jÎ  ‰j  ‰j¶  ‰j#  ‰jº  ‰jý  ‰j@  ‰j×  ‰j  ‰j»  ‰jR  ‰jó  ‰jš  ‰j/  ˆjV  ˆj’  ˆuh}”(jŸ  hÊjË  j~  j  jÑ  j³  j"  j   j¹  j·  j&  jú  j½  j=  j   jÔ  jC  j  jÚ  j¸  j  jO  j¾  jð  jU  j¸  j®  jd  jZ  j°  j¦  j—  jö  j¾  j	  ji  j2  jµ  jY  uŒfootnote_refs”}”(j	  ]”j®  aj
	  ]”jZ  aj	  ]”j¦  auŒcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”(j	  j2  jY  eŒ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”jÖ  Ks…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nh²hub.