/* SPDX-License-Identifier: GPL-2.0-only */ #include #include #include #include #include #include #include #include #include #include #include #if CONFIG(GENERIC_GPIO_LIB) #include #endif #define ACPI_DP_UUID "daffd814-6eba-4d8c-8a91-bc9bbf4aa301" #define ACPI_DP_CHILD_UUID "dbb8e3e6-5886-4ba6-8795-1319f52a966b" /* * Below properties are defined at * https://docs.microsoft.com/en-us/windows-hardware/drivers/pci/dsd-for-pcie-root-ports */ #define ACPI_DSD_EXTERNAL_FACING_PORT_UUID "EFCC06CC-73AC-4BC3-BFF0-76143807C389" #define ACPI_DSD_EXTERNAL_FACING_PORT_NAME "ExternalFacingPort" #define ACPI_DSD_HOTPLUG_IN_D3_UUID "6211E2C0-58A3-4AF3-90E1-927A4E0C55A4" #define ACPI_DSD_HOTPLUG_IN_D3_NAME "HotPlugSupportInD3" /* ID for the DmaProperty _DSD */ #define ACPI_DSD_DMA_PROPERTY_UUID "70D24161-6DD5-4C9E-8070-705531292865" #define ACPI_DSD_DMA_PROPERTY_NAME "DmaProperty" /* * Below properties are defined at * https://docs.microsoft.com/en-us/windows-hardware/design/component-guidelines/power-management-for-storage-hardware-devices-intro */ #define ACPI_DSD_STORAGE_D3_UUID "5025030F-842F-4AB4-A561-99A5189762D0" #define ACPI_DSD_STORAGE_D3_NAME "StorageD3Enable" /* Write empty word value and return pointer to it */ static void *acpi_device_write_zero_len(void) { char *p = acpigen_get_current(); acpigen_emit_word(0); return p; } /* Fill in length value from start to current at specified location */ static void acpi_device_fill_from_len(char *ptr, char *start) { uint16_t len = acpigen_get_current() - start; ptr[0] = len & 0xff; ptr[1] = (len >> 8) & 0xff; } /* * Fill in the length field with the value calculated from after * the 16bit field to acpigen current as this length value does * not include the length field itself. */ static void acpi_device_fill_len(void *ptr) { acpi_device_fill_from_len(ptr, ptr + sizeof(uint16_t)); } /* Locate and return the ACPI name for this device */ const char *acpi_device_name(const struct device *dev) { const struct device *pdev = dev; const char *name = NULL; if (!dev) return NULL; /* Check for device specific handler */ if (dev->ops && dev->ops->acpi_name) { name = dev->ops->acpi_name(dev); if (name) return name; } /* Walk up the tree to find if any parent can identify this device */ while (pdev->bus) { pdev = pdev->bus->dev; if (!pdev) break; if (is_root_device(pdev)) break; if (pdev->ops && pdev->ops->acpi_name) name = pdev->ops->acpi_name(dev); if (name) return name; } return NULL; } /* Locate and return the ACPI _HID (Hardware ID) for this device */ const char *acpi_device_hid(const struct device *dev) { if (!dev) return NULL; /* Check for device specific handler */ if (dev->ops->acpi_hid) return dev->ops->acpi_hid(dev); /* * Don't walk up the tree to find any parent that can identify this device, as * PNP devices are hard to identify. */ return NULL; } /* * Generate unique ID based on the ACPI path. * Collisions on the same _HID are possible but very unlikely. */ uint32_t acpi_device_uid(const struct device *dev) { const char *path = acpi_device_path(dev); if (!path) return 0; return CRC(path, strlen(path), crc32_byte); } /* Recursive function to find the root device and print a path from there */ static ssize_t acpi_device_path_fill(const struct device *dev, char *buf, size_t buf_len, size_t cur) { const char *name = acpi_device_name(dev); ssize_t next = 0; if (!name) return -1; /* * Make sure this name segment will fit, including the path segment * separator and possible NUL terminator if this is the last segment. */ if (!dev || (cur + strlen(name) + 2) > buf_len) return cur; /* Walk up the tree to the root device */ if (!is_root_device(dev) && dev->bus && dev->bus->dev) next = acpi_device_path_fill(dev->bus->dev, buf, buf_len, cur); if (next < 0) return next; /* Fill in the path from the root device */ next += snprintf(buf + next, buf_len - next, "%s%s", (is_root_device(dev) || (strlen(name) == 0)) ? "" : ".", name); return next; } /* * Warning: just as with dev_path() this uses a static buffer * so should not be called multiple times in one statement */ const char *acpi_device_path(const struct device *dev) { static char buf[DEVICE_PATH_MAX] = {}; if (!dev) return NULL; if (acpi_device_path_fill(dev, buf, sizeof(buf), 0) <= 0) return NULL; return buf; } /* Return the path of the parent device as the ACPI Scope for this device */ const char *acpi_device_scope(const struct device *dev) { static char buf[DEVICE_PATH_MAX] = {}; if (!dev || !dev->bus || !dev->bus->dev) return NULL; if (acpi_device_path_fill(dev->bus->dev, buf, sizeof(buf), 0) <= 0) return NULL; return buf; } /* Concatenate the device path and provided name suffix */ const char *acpi_device_path_join(const struct device *dev, const char *name) { static char buf[DEVICE_PATH_MAX] = {}; ssize_t len; if (!dev) return NULL; /* Build the path of this device */ len = acpi_device_path_fill(dev, buf, sizeof(buf), 0); if (len <= 0) return NULL; /* Ensure there is room for the added name, separator, and NUL */ if ((len + strlen(name) + 2) > sizeof(buf)) return NULL; snprintf(buf + len, sizeof(buf) - len, ".%s", name); return buf; } int acpi_device_status(const struct device *dev) { if (!dev->enabled) return ACPI_STATUS_DEVICE_ALL_OFF; if (dev->hidden) return ACPI_STATUS_DEVICE_HIDDEN_ON; return ACPI_STATUS_DEVICE_ALL_ON; } /* Write the unique _UID based on ACPI device path. */ void acpi_device_write_uid(const struct device *dev) { acpigen_write_name_integer("_UID", acpi_device_uid(dev)); } /* ACPI 6.1 section 6.4.3.6: Extended Interrupt Descriptor */ void acpi_device_write_interrupt(const struct acpi_irq *irq) { void *desc_length; uint8_t flags; if (!irq || !irq->pin) return; /* This is supported by GpioInt() but not Interrupt() */ if (irq->polarity == ACPI_IRQ_ACTIVE_BOTH) return; /* Byte 0: Descriptor Type */ acpigen_emit_byte(ACPI_DESCRIPTOR_INTERRUPT); /* Byte 1-2: Length (filled in later) */ desc_length = acpi_device_write_zero_len(); /* * Byte 3: Flags * [7:5]: Reserved * [4]: Wake (0=NO_WAKE 1=WAKE) * [3]: Sharing (0=EXCLUSIVE 1=SHARED) * [2]: Polarity (0=HIGH 1=LOW) * [1]: Mode (0=LEVEL 1=EDGE) * [0]: Resource (0=PRODUCER 1=CONSUMER) */ flags = 1 << 0; /* ResourceConsumer */ if (irq->mode == ACPI_IRQ_EDGE_TRIGGERED) flags |= 1 << 1; if (irq->polarity == ACPI_IRQ_ACTIVE_LOW) flags |= 1 << 2; if (irq->shared == ACPI_IRQ_SHARED) flags |= 1 << 3; if (irq->wake == ACPI_IRQ_WAKE) flags |= 1 << 4; acpigen_emit_byte(flags); /* Byte 4: Interrupt Table Entry Count */ acpigen_emit_byte(1); /* Byte 5-8: Interrupt Number */ acpigen_emit_dword(irq->pin); /* Fill in Descriptor Length (account for len word) */ acpi_device_fill_len(desc_length); } /* ACPI 6.1 section 6.4.3.8.1 - GPIO Interrupt or I/O */ void acpi_device_write_gpio(const struct acpi_gpio *gpio) { void *start, *desc_length; void *pin_table_offset, *vendor_data_offset, *resource_offset; uint16_t flags = 0; int pin; if (!gpio || gpio->type > ACPI_GPIO_TYPE_IO) return; start = acpigen_get_current(); /* Byte 0: Descriptor Type */ acpigen_emit_byte(ACPI_DESCRIPTOR_GPIO); /* Byte 1-2: Length (fill in later) */ desc_length = acpi_device_write_zero_len(); /* Byte 3: Revision ID */ acpigen_emit_byte(ACPI_GPIO_REVISION_ID); /* Byte 4: GpioIo or GpioInt */ acpigen_emit_byte(gpio->type); /* * Byte 5-6: General Flags * [15:1]: 0 => Reserved * [0]: 1 => ResourceConsumer */ acpigen_emit_word(1 << 0); switch (gpio->type) { case ACPI_GPIO_TYPE_INTERRUPT: /* * Byte 7-8: GPIO Interrupt Flags * [15:5]: 0 => Reserved * [4]: Wake (0=NO_WAKE 1=WAKE) * [3]: Sharing (0=EXCLUSIVE 1=SHARED) * [2:1]: Polarity (0=HIGH 1=LOW 2=BOTH) * [0]: Mode (0=LEVEL 1=EDGE) */ if (gpio->irq.mode == ACPI_IRQ_EDGE_TRIGGERED) flags |= 1 << 0; if (gpio->irq.shared == ACPI_IRQ_SHARED) flags |= 1 << 3; if (gpio->irq.wake == ACPI_IRQ_WAKE) flags |= 1 << 4; switch (gpio->irq.polarity) { case ACPI_IRQ_ACTIVE_HIGH: flags |= 0 << 1; break; case ACPI_IRQ_ACTIVE_LOW: flags |= 1 << 1; break; case ACPI_IRQ_ACTIVE_BOTH: flags |= 2 << 1; break; } break; case ACPI_GPIO_TYPE_IO: /* * Byte 7-8: GPIO IO Flags * [15:4]: 0 => Reserved * [3]: Sharing (0=EXCLUSIVE 1=SHARED) * [2]: 0 => Reserved * [1:0]: IO Restriction * 0 => IoRestrictionNone * 1 => IoRestrictionInputOnly * 2 => IoRestrictionOutputOnly * 3 => IoRestrictionNoneAndPreserve */ flags |= gpio->io_restrict & 3; if (gpio->io_shared) flags |= 1 << 3; break; } acpigen_emit_word(flags); /* * Byte 9: Pin Configuration * 0x01 => Default (no configuration applied) * 0x02 => Pull-up * 0x03 => Pull-down * 0x04-0x7F => Reserved * 0x80-0xff => Vendor defined */ acpigen_emit_byte(gpio->pull); /* Byte 10-11: Output Drive Strength in 1/100 mA */ acpigen_emit_word(gpio->output_drive_strength); /* Byte 12-13: Debounce Timeout in 1/100 ms */ acpigen_emit_word(gpio->interrupt_debounce_timeout); /* Byte 14-15: Pin Table Offset, relative to start */ pin_table_offset = acpi_device_write_zero_len(); /* Byte 16: Reserved */ acpigen_emit_byte(0); /* Byte 17-18: Resource Source Name Offset, relative to start */ resource_offset = acpi_device_write_zero_len(); /* Byte 19-20: Vendor Data Offset, relative to start */ vendor_data_offset = acpi_device_write_zero_len(); /* Byte 21-22: Vendor Data Length */ acpigen_emit_word(0); /* Fill in Pin Table Offset */ acpi_device_fill_from_len(pin_table_offset, start); /* Pin Table, one word for each pin */ for (pin = 0; pin < gpio->pin_count; pin++) { uint16_t acpi_pin = gpio->pins[pin]; #if CONFIG(GENERIC_GPIO_LIB) acpi_pin = gpio_acpi_pin(acpi_pin); #endif acpigen_emit_word(acpi_pin); } /* Fill in Resource Source Name Offset */ acpi_device_fill_from_len(resource_offset, start); /* Resource Source Name String */ #if CONFIG(GENERIC_GPIO_LIB) acpigen_emit_string(gpio->resource ? : gpio_acpi_path(gpio->pins[0])); #else acpigen_emit_string(gpio->resource); #endif /* Fill in Vendor Data Offset */ acpi_device_fill_from_len(vendor_data_offset, start); /* Fill in GPIO Descriptor Length (account for len word) */ acpi_device_fill_len(desc_length); } /* ACPI 6.1 section 6.4.3.8.2.1 - I2cSerialBus() */ void acpi_device_write_i2c(const struct acpi_i2c *i2c) { void *desc_length, *type_length; /* Byte 0: Descriptor Type */ acpigen_emit_byte(ACPI_DESCRIPTOR_SERIAL_BUS); /* Byte 1+2: Length (filled in later) */ desc_length = acpi_device_write_zero_len(); /* Byte 3: Revision ID */ acpigen_emit_byte(ACPI_I2C_SERIAL_BUS_REVISION_ID); /* Byte 4: Resource Source Index is Reserved */ acpigen_emit_byte(0); /* Byte 5: Serial Bus Type is I2C */ acpigen_emit_byte(ACPI_SERIAL_BUS_TYPE_I2C); /* * Byte 6: Flags * [7:2]: 0 => Reserved * [1]: 1 => ResourceConsumer * [0]: 0 => ControllerInitiated */ acpigen_emit_byte(1 << 1); /* * Byte 7-8: Type Specific Flags * [15:1]: 0 => Reserved * [0]: 0 => 7bit, 1 => 10bit */ acpigen_emit_word(i2c->mode_10bit); /* Byte 9: Type Specific Revision ID */ acpigen_emit_byte(ACPI_I2C_TYPE_SPECIFIC_REVISION_ID); /* Byte 10-11: I2C Type Data Length */ type_length = acpi_device_write_zero_len(); /* Byte 12-15: I2C Bus Speed */ acpigen_emit_dword(i2c->speed); /* Byte 16-17: I2C Slave Address */ acpigen_emit_word(i2c->address); /* Fill in Type Data Length */ acpi_device_fill_len(type_length); /* Byte 18+: ResourceSource */ acpigen_emit_string(i2c->resource); /* Fill in I2C Descriptor Length */ acpi_device_fill_len(desc_length); } /* ACPI 6.1 section 6.4.3.8.2.2 - SpiSerialBus() */ void acpi_device_write_spi(const struct acpi_spi *spi) { void *desc_length, *type_length; uint16_t flags = 0; /* Byte 0: Descriptor Type */ acpigen_emit_byte(ACPI_DESCRIPTOR_SERIAL_BUS); /* Byte 1+2: Length (filled in later) */ desc_length = acpi_device_write_zero_len(); /* Byte 3: Revision ID */ acpigen_emit_byte(ACPI_SPI_SERIAL_BUS_REVISION_ID); /* Byte 4: Resource Source Index is Reserved */ acpigen_emit_byte(0); /* Byte 5: Serial Bus Type is SPI */ acpigen_emit_byte(ACPI_SERIAL_BUS_TYPE_SPI); /* * Byte 6: Flags * [7:2]: 0 => Reserved * [1]: 1 => ResourceConsumer * [0]: 0 => ControllerInitiated */ acpigen_emit_byte(1 << 1); /* * Byte 7-8: Type Specific Flags * [15:2]: 0 => Reserved * [1]: 0 => ActiveLow, 1 => ActiveHigh * [0]: 0 => FourWire, 1 => ThreeWire */ if (spi->wire_mode == SPI_3_WIRE_MODE) flags |= 1 << 0; if (spi->device_select_polarity == SPI_POLARITY_HIGH) flags |= 1 << 1; acpigen_emit_word(flags); /* Byte 9: Type Specific Revision ID */ acpigen_emit_byte(ACPI_SPI_TYPE_SPECIFIC_REVISION_ID); /* Byte 10-11: SPI Type Data Length */ type_length = acpi_device_write_zero_len(); /* Byte 12-15: Connection Speed */ acpigen_emit_dword(spi->speed); /* Byte 16: Data Bit Length */ acpigen_emit_byte(spi->data_bit_length); /* Byte 17: Clock Phase */ acpigen_emit_byte(spi->clock_phase); /* Byte 18: Clock Polarity */ acpigen_emit_byte(spi->clock_polarity); /* Byte 19-20: Device Selection */ acpigen_emit_word(spi->device_select); /* Fill in Type Data Length */ acpi_device_fill_len(type_length); /* Byte 21+: ResourceSource String */ acpigen_emit_string(spi->resource); /* Fill in SPI Descriptor Length */ acpi_device_fill_len(desc_length); } /* UART Serial Bus - UARTSerialBusV2() */ void acpi_device_write_uart(const struct acpi_uart *uart) { void *desc_length, *type_length; uint16_t flags; /* Byte 0: Descriptor Type */ acpigen_emit_byte(ACPI_DESCRIPTOR_SERIAL_BUS); /* Byte 1+2: Length (filled in later) */ desc_length = acpi_device_write_zero_len(); /* Byte 3: Revision ID */ acpigen_emit_byte(ACPI_UART_SERIAL_BUS_REVISION_ID); /* Byte 4: Resource Source Index is Reserved */ acpigen_emit_byte(0); /* Byte 5: Serial Bus Type is UART */ acpigen_emit_byte(ACPI_SERIAL_BUS_TYPE_UART); /* * Byte 6: Flags * [7:2]: 0 => Reserved * [1]: 1 => ResourceConsumer * [0]: 0 => ControllerInitiated */ acpigen_emit_byte(BIT(1)); /* * Byte 7-8: Type Specific Flags * [15:8]: 0 => Reserved * [7]: 0 => Little Endian, 1 => Big Endian * [6:4]: Data bits * [3:2]: Stop bits * [1:0]: Flow control */ flags = uart->flow_control & 3; flags |= (uart->stop_bits & 3) << 2; flags |= (uart->data_bits & 7) << 4; flags |= (uart->endian & 1) << 7; acpigen_emit_word(flags); /* Byte 9: Type Specific Revision ID */ acpigen_emit_byte(ACPI_UART_TYPE_SPECIFIC_REVISION_ID); /* Byte 10-11: Type Data Length */ type_length = acpi_device_write_zero_len(); /* Byte 12-15: Initial Baud Rate */ acpigen_emit_dword(uart->initial_baud_rate); /* Byte 16-17: RX FIFO size */ acpigen_emit_word(uart->rx_fifo_bytes); /* Byte 18-19: TX FIFO size */ acpigen_emit_word(uart->tx_fifo_bytes); /* Byte 20: Parity */ acpigen_emit_byte(uart->parity); /* Byte 21: Lines Enabled */ acpigen_emit_byte(uart->lines_in_use); /* Fill in Type Data Length */ acpi_device_fill_len(type_length); /* Byte 22+: ResourceSource */ acpigen_emit_string(uart->resource); /* Fill in Descriptor Length */ acpi_device_fill_len(desc_length); } #define ACPI_POWER_RESOURCE_STATUS_ON_OP ONE_OP #define ACPI_POWER_RESOURCE_STATUS_OFF_OP ZERO_OP /** * Writes an ACPI fragment that will check the GPIO and return 0 if the GPIO * state does not match the active parameter. */ static void acpigen_write_gpio_STA(const struct acpi_gpio *gpio, bool active) { if (!gpio || !gpio->pin_count) return; /* Read current GPIO status into Local0. */ acpigen_get_tx_gpio(gpio); /* * If (!Local0) * { * Return (Zero) * } */ acpigen_write_if(); if (active) acpigen_emit_byte(LNOT_OP); acpigen_emit_byte(LOCAL0_OP); acpigen_write_return_op(ACPI_POWER_RESOURCE_STATUS_OFF_OP); acpigen_write_if_end(); } static void acpigen_write_power_res_STA(const struct acpi_power_res_params *params) { acpigen_write_method_serialized("_STA", 0); /* Verify all the GPIOs are in the ON state, otherwise return 0 */ acpigen_write_gpio_STA(params->enable_gpio, true); acpigen_write_gpio_STA(params->reset_gpio, false); acpigen_write_gpio_STA(params->stop_gpio, false); /* All GPIOs are in the ON state */ acpigen_write_return_op(ACPI_POWER_RESOURCE_STATUS_ON_OP); acpigen_pop_len(); /* Method */ } /* PowerResource() with Enable and/or Reset control */ void acpi_device_add_power_res(const struct acpi_power_res_params *params) { static uint8_t id; static const char * const power_res_dev_states[] = { "_PR0", "_PR3" }; unsigned int reset_gpio = params->reset_gpio ? params->reset_gpio->pins[0] : 0; unsigned int enable_gpio = params->enable_gpio ? params->enable_gpio->pins[0] : 0; unsigned int stop_gpio = params->stop_gpio ? params->stop_gpio->pins[0] : 0; char pr_name[ACPI_NAME_BUFFER_SIZE]; if (!reset_gpio && !enable_gpio && !stop_gpio) return; snprintf(pr_name, sizeof(pr_name), "PR%02X", id++); /* PowerResource (PR##, 0, 0) */ acpigen_write_power_res(pr_name, 0, 0, power_res_dev_states, ARRAY_SIZE(power_res_dev_states)); if (params->use_gpio_for_status) { acpigen_write_power_res_STA(params); } else { /* Method (_STA, 0, NotSerialized) { Return (0x1) } */ acpigen_write_STA(ACPI_POWER_RESOURCE_STATUS_ON_OP); } /* Method (_ON, 0, Serialized) */ acpigen_write_method_serialized("_ON", 0); /* Call _STA and early return if the device is already enabled, since the Linux kernel doesn't check the device status before calling _ON. This avoids unnecessary delays while booting. */ if (params->use_gpio_for_status) { /* Local0 = _STA () */ acpigen_write_store(); acpigen_emit_namestring("_STA"); acpigen_emit_byte(LOCAL0_OP); /* If (( Local0 == ACPI_POWER_RESOURCE_STATUS_ON_OP)) */ acpigen_write_if_lequal_op_op(LOCAL0_OP, ACPI_POWER_RESOURCE_STATUS_ON_OP); acpigen_write_return_op(ZERO_OP); acpigen_write_if_end(); } if (reset_gpio) acpigen_enable_tx_gpio(params->reset_gpio); if (enable_gpio) { acpigen_enable_tx_gpio(params->enable_gpio); if (params->enable_delay_ms) acpigen_write_sleep(params->enable_delay_ms); } if (reset_gpio) { acpigen_disable_tx_gpio(params->reset_gpio); if (params->reset_delay_ms) acpigen_write_sleep(params->reset_delay_ms); } if (stop_gpio) { acpigen_disable_tx_gpio(params->stop_gpio); if (params->stop_delay_ms) acpigen_write_sleep(params->stop_delay_ms); } acpigen_pop_len(); /* _ON method */ /* Method (_OFF, 0, Serialized) */ acpigen_write_method_serialized("_OFF", 0); if (stop_gpio) { acpigen_enable_tx_gpio(params->stop_gpio); if (params->stop_off_delay_ms) acpigen_write_sleep(params->stop_off_delay_ms); } if (reset_gpio) { acpigen_enable_tx_gpio(params->reset_gpio); if (params->reset_off_delay_ms) acpigen_write_sleep(params->reset_off_delay_ms); } if (enable_gpio) { acpigen_disable_tx_gpio(params->enable_gpio); if (params->enable_off_delay_ms) acpigen_write_sleep(params->enable_off_delay_ms); } acpigen_pop_len(); /* _OFF method */ acpigen_pop_len(); /* PowerResource PR## */ } static void acpi_dp_write_array(const struct acpi_dp *array); static void acpi_dp_write_value(const struct acpi_dp *prop) { switch (prop->type) { case ACPI_DP_TYPE_INTEGER: acpigen_write_integer(prop->integer); break; case ACPI_DP_TYPE_STRING: case ACPI_DP_TYPE_CHILD: acpigen_write_string(prop->string); break; case ACPI_DP_TYPE_REFERENCE: acpigen_emit_namestring(prop->string); break; case ACPI_DP_TYPE_ARRAY: acpi_dp_write_array(prop->array); break; default: break; } } /* Package (2) { "prop->name", VALUE } */ static void acpi_dp_write_property(const struct acpi_dp *prop) { acpigen_write_package(2); acpigen_write_string(prop->name); acpi_dp_write_value(prop); acpigen_pop_len(); } /* Write array of Device Properties */ static void acpi_dp_write_array(const struct acpi_dp *array) { const struct acpi_dp *dp; char *pkg_count; /* Package element count determined as it is populated */ pkg_count = acpigen_write_package(0); /* * Only acpi_dp of type DP_TYPE_TABLE is allowed to be an array. * DP_TYPE_TABLE does not have a value to be written. Thus, start * the loop from next type in the array. */ for (dp = array->next; dp; dp = dp->next) { acpi_dp_write_value(dp); (*pkg_count)++; } acpigen_pop_len(); } static void acpi_dp_free(struct acpi_dp *dp) { while (dp) { struct acpi_dp *p = dp->next; switch (dp->type) { case ACPI_DP_TYPE_CHILD: acpi_dp_free(dp->child); break; case ACPI_DP_TYPE_ARRAY: acpi_dp_free(dp->array); break; default: break; } free(dp); dp = p; } } static bool acpi_dp_write_properties(struct acpi_dp *prop, const char *uuid) { struct acpi_dp *dp; char *prop_count = NULL; /* Print base properties */ for (dp = prop; dp; dp = dp->next) { if (dp->type == ACPI_DP_TYPE_TABLE || dp->type == ACPI_DP_TYPE_CHILD || dp->type == ACPI_DP_TYPE_PACKAGE) continue; /* * The UUID and package is only added when * we come across the first property. This * is to avoid creating a zero-length package * in situations where there are only children. */ if (!prop_count) { /* ToUUID (dp->uuid) */ acpigen_write_uuid(uuid); /* * Package (PROP), element count determined as * it is populated */ prop_count = acpigen_write_package(0); } (*prop_count)++; acpi_dp_write_property(dp); } if (prop_count) { /* Package (PROP) length, if a package was written */ acpigen_pop_len(); return true; } return false; } static void acpi_dp_write_(struct acpi_dp *table) { struct acpi_dp *dp, *prop; char *dp_count; int child_count = 0; if (!table || table->type != ACPI_DP_TYPE_TABLE || !table->next) return; /* Name (name) */ acpigen_write_name(table->name); /* Device Property list starts with the next entry */ prop = table->next; /* Package (DP), default to assuming no properties or children */ dp_count = acpigen_write_package(0); /* Print base properties */ if (acpi_dp_write_properties(prop, table->uuid)) *dp_count += 2; /* Count child properties */ for (dp = prop; dp; dp = dp->next) if (dp->type == ACPI_DP_TYPE_CHILD) child_count++; /* Add child properties to the base table */ if (child_count) { /* Update DP package count */ *dp_count += 2; /* ToUUID (ACPI_DP_CHILD_UUID) */ acpigen_write_uuid(ACPI_DP_CHILD_UUID); /* Print child pointer properties */ acpigen_write_package(child_count); for (dp = prop; dp; dp = dp->next) if (dp->type == ACPI_DP_TYPE_CHILD) acpi_dp_write_property(dp); /* Package (CHILD) length */ acpigen_pop_len(); } /* Write packages of properties with unique UUID */ for (dp = prop; dp; dp = dp->next) if (dp->type == ACPI_DP_TYPE_PACKAGE) if (acpi_dp_write_properties(dp->child, dp->uuid)) *dp_count += 2; /* Package (DP) length */ acpigen_pop_len(); /* Recursively parse children into separate tables */ for (dp = prop; dp; dp = dp->next) if (dp->type == ACPI_DP_TYPE_CHILD) acpi_dp_write_(dp->child); } void acpi_dp_write(struct acpi_dp *table) { acpi_dp_write_(table); /* Clean up */ acpi_dp_free(table); } static struct acpi_dp *acpi_dp_new(struct acpi_dp *dp, enum acpi_dp_type type, const char *name) { struct acpi_dp *new; new = malloc(sizeof(struct acpi_dp)); if (!new) return NULL; memset(new, 0, sizeof(*new)); new->type = type; new->name = name; new->uuid = ACPI_DP_UUID; if (dp) { /* Add to end of property list */ while (dp->next) dp = dp->next; dp->next = new; } return new; } struct acpi_dp *acpi_dp_new_table(const char *name) { return acpi_dp_new(NULL, ACPI_DP_TYPE_TABLE, name); } size_t acpi_dp_add_property_list(struct acpi_dp *dp, const struct acpi_dp *property_list, size_t property_count) { const struct acpi_dp *prop; size_t i, properties_added = 0; if (!dp || !property_list) return 0; for (i = 0; i < property_count; i++) { prop = &property_list[i]; if (prop->type == ACPI_DP_TYPE_UNKNOWN || !prop->name) continue; switch (prop->type) { case ACPI_DP_TYPE_INTEGER: acpi_dp_add_integer(dp, prop->name, prop->integer); break; case ACPI_DP_TYPE_STRING: acpi_dp_add_string(dp, prop->name, prop->string); break; case ACPI_DP_TYPE_REFERENCE: acpi_dp_add_reference(dp, prop->name, prop->string); break; case ACPI_DP_TYPE_ARRAY: acpi_dp_add_array(dp, prop->array); break; case ACPI_DP_TYPE_CHILD: acpi_dp_add_child(dp, prop->name, prop->child); break; default: continue; } ++properties_added; } return properties_added; } struct acpi_dp *acpi_dp_add_integer(struct acpi_dp *dp, const char *name, uint64_t value) { if (!dp) return NULL; struct acpi_dp *new = acpi_dp_new(dp, ACPI_DP_TYPE_INTEGER, name); if (new) new->integer = value; return new; } struct acpi_dp *acpi_dp_add_string(struct acpi_dp *dp, const char *name, const char *string) { if (!dp) return NULL; struct acpi_dp *new = acpi_dp_new(dp, ACPI_DP_TYPE_STRING, name); if (new) new->string = string; return new; } struct acpi_dp *acpi_dp_add_reference(struct acpi_dp *dp, const char *name, const char *reference) { if (!dp) return NULL; struct acpi_dp *new = acpi_dp_new(dp, ACPI_DP_TYPE_REFERENCE, name); if (new) new->string = reference; return new; } struct acpi_dp *acpi_dp_add_child(struct acpi_dp *dp, const char *name, struct acpi_dp *child) { struct acpi_dp *new; if (!dp || !child || child->type != ACPI_DP_TYPE_TABLE) return NULL; new = acpi_dp_new(dp, ACPI_DP_TYPE_CHILD, name); if (new) { new->child = child; new->string = child->name; } return new; } struct acpi_dp *acpi_dp_add_package(struct acpi_dp *dp, struct acpi_dp *package) { struct acpi_dp *new; if (!dp || !package || package->type != ACPI_DP_TYPE_TABLE) return NULL; new = acpi_dp_new(dp, ACPI_DP_TYPE_PACKAGE, NULL); if (new) { new->uuid = package->name; new->child = package; } return new; } struct acpi_dp *acpi_dp_add_array(struct acpi_dp *dp, struct acpi_dp *array) { struct acpi_dp *new; if (!dp || !array || array->type != ACPI_DP_TYPE_TABLE) return NULL; new = acpi_dp_new(dp, ACPI_DP_TYPE_ARRAY, array->name); if (new) new->array = array; return new; } struct acpi_dp *acpi_dp_add_integer_array(struct acpi_dp *dp, const char *name, const uint64_t *array, int len) { struct acpi_dp *dp_array; int i; if (!dp || len <= 0) return NULL; dp_array = acpi_dp_new_table(name); if (!dp_array) return NULL; for (i = 0; i < len; i++) if (!acpi_dp_add_integer(dp_array, NULL, array[i])) break; acpi_dp_add_array(dp, dp_array); return dp_array; } struct acpi_dp *acpi_dp_add_gpio_array(struct acpi_dp *dp, const char *name, const struct acpi_gpio_res_params *params, size_t param_count) { struct acpi_dp *gpio; uint32_t i; if (!dp || !param_count) return NULL; gpio = acpi_dp_new_table(name); if (!gpio) return NULL; /* * Generate ACPI identifiers as follows: * Package () { * name, // e.g. cs-gpios * Package() { * ref, index, pin, active_low, // GPIO-0 (params[0]) * ref, index, pin, active_low, // GPIO-1 (params[1]) * ... * } * } */ for (i = 0; i < param_count; i++, params++) { /* * If refs is NULL, leave a hole in the gpio array. This can be used in * conditions where some controllers use both GPIOs and native signals. */ if (!params->ref) { acpi_dp_add_integer(gpio, NULL, 0); continue; } /* The device that has _CRS containing GpioIO()/GpioInt() */ acpi_dp_add_reference(gpio, NULL, params->ref); /* Index of the GPIO resource in _CRS starting from zero */ acpi_dp_add_integer(gpio, NULL, params->index); /* Pin in the GPIO resource, typically zero */ acpi_dp_add_integer(gpio, NULL, params->pin); /* Set if pin is active low */ acpi_dp_add_integer(gpio, NULL, params->active_low); } acpi_dp_add_array(dp, gpio); return gpio; } struct acpi_dp *acpi_dp_add_gpio(struct acpi_dp *dp, const char *name, const char *ref, int index, int pin, int active_low) { struct acpi_gpio_res_params param = { .ref = ref, .index = index, .pin = pin, .active_low = active_low, }; return acpi_dp_add_gpio_array(dp, name, ¶m, 1); } /* * This function writes a PCI device with _ADR object: * Example: * Scope (\_SB.PCI0) * { * Device (IGFX) * { * Name (_ADR, 0x0000000000000000) * Method (_STA, 0, NotSerialized) { Return (status) } * } * } */ void acpi_device_write_pci_dev(const struct device *dev) { const char *scope = acpi_device_scope(dev); const char *name = acpi_device_name(dev); assert(dev->path.type == DEVICE_PATH_PCI); assert(name); assert(scope); acpigen_write_scope(scope); acpigen_write_device(name); acpigen_write_ADR_pci_device(dev); acpigen_write_STA(acpi_device_status(dev)); acpigen_pop_len(); /* Device */ acpigen_pop_len(); /* Scope */ } /* * Helper function to add given integer property with an UUID to _DSD in the current scope. * * dsd - Pointer to a _DSD object. * Append to existing _DSD object if not NULL. * Create new _DSD object and flush it if NULL. * uuid - Pointer to the UUID string. * name - Pointer to the property name string. * value - Value of the integer property. */ static void acpi_device_add_integer_property_with_uuid(struct acpi_dp *dsd, const char *uuid, const char *name, uint64_t value) { struct acpi_dp *prev_dsd = dsd, *pkg; if (prev_dsd == NULL) dsd = acpi_dp_new_table("_DSD"); pkg = acpi_dp_new_table(uuid); acpi_dp_add_integer(pkg, name, value); acpi_dp_add_package(dsd, pkg); if (prev_dsd == NULL) acpi_dp_write(dsd); } /* _DSD with ExternalFacingPort */ void acpi_device_add_external_facing_port(struct acpi_dp *dsd) { acpi_device_add_integer_property_with_uuid(dsd, ACPI_DSD_EXTERNAL_FACING_PORT_UUID, ACPI_DSD_EXTERNAL_FACING_PORT_NAME, 1); } /* _DSD with HotPlugSupportInD3 */ void acpi_device_add_hotplug_support_in_d3(struct acpi_dp *dsd) { acpi_device_add_integer_property_with_uuid(dsd, ACPI_DSD_HOTPLUG_IN_D3_UUID, ACPI_DSD_HOTPLUG_IN_D3_NAME, 1); } /* _DSD with DmaProperty */ void acpi_device_add_dma_property(struct acpi_dp *dsd) { acpi_device_add_integer_property_with_uuid(dsd, ACPI_DSD_DMA_PROPERTY_UUID, ACPI_DSD_DMA_PROPERTY_NAME, 1); } /* _DSD with StorageD3Enable */ void acpi_device_add_storage_d3_enable(struct acpi_dp *dsd) { acpi_device_add_integer_property_with_uuid(dsd, ACPI_DSD_STORAGE_D3_UUID, ACPI_DSD_STORAGE_D3_NAME, 1); }