1 /* SPDX-License-Identifier: GPL-2.0-or-later */ 2 /* 3 * acpi_bus.h - ACPI Bus Driver ($Revision: 22 $) 4 * 5 * Copyright (C) 2001, 2002 Andy Grover <andrew.grover@intel.com> 6 * Copyright (C) 2001, 2002 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com> 7 */ 8 9 #ifndef __ACPI_BUS_H__ 10 #define __ACPI_BUS_H__ 11 12 #include <linux/completion.h> 13 #include <linux/container_of.h> 14 #include <linux/device.h> 15 #include <linux/kobject.h> 16 #include <linux/mutex.h> 17 #include <linux/property.h> 18 #include <linux/types.h> 19 20 struct acpi_handle_list { 21 u32 count; 22 acpi_handle *handles; 23 }; 24 25 /* acpi_utils.h */ 26 acpi_status 27 acpi_extract_package(union acpi_object *package, 28 struct acpi_buffer *format, struct acpi_buffer *buffer); 29 acpi_status 30 acpi_evaluate_integer(acpi_handle handle, 31 acpi_string pathname, 32 struct acpi_object_list *arguments, unsigned long long *data); 33 bool acpi_evaluate_reference(acpi_handle handle, acpi_string pathname, 34 struct acpi_object_list *arguments, 35 struct acpi_handle_list *list); 36 bool acpi_handle_list_equal(struct acpi_handle_list *list1, 37 struct acpi_handle_list *list2); 38 void acpi_handle_list_replace(struct acpi_handle_list *dst, 39 struct acpi_handle_list *src); 40 void acpi_handle_list_free(struct acpi_handle_list *list); 41 bool acpi_device_dep(acpi_handle target, acpi_handle match); 42 acpi_status 43 acpi_evaluate_ost(acpi_handle handle, u32 source_event, u32 status_code, 44 struct acpi_buffer *status_buf); 45 46 acpi_status 47 acpi_get_physical_device_location(acpi_handle handle, struct acpi_pld_info **pld); 48 49 bool acpi_has_method(acpi_handle handle, char *name); 50 acpi_status acpi_execute_simple_method(acpi_handle handle, char *method, 51 u64 arg); 52 acpi_status acpi_evaluate_ej0(acpi_handle handle); 53 acpi_status acpi_evaluate_lck(acpi_handle handle, int lock); 54 acpi_status acpi_evaluate_reg(acpi_handle handle, u8 space_id, u32 function); 55 bool acpi_ata_match(acpi_handle handle); 56 bool acpi_bay_match(acpi_handle handle); 57 bool acpi_dock_match(acpi_handle handle); 58 59 bool acpi_check_dsm(acpi_handle handle, const guid_t *guid, u64 rev, u64 funcs); 60 union acpi_object *acpi_evaluate_dsm(acpi_handle handle, const guid_t *guid, 61 u64 rev, u64 func, union acpi_object *argv4); 62 #ifdef CONFIG_ACPI 63 static inline union acpi_object * 64 acpi_evaluate_dsm_typed(acpi_handle handle, const guid_t *guid, u64 rev, 65 u64 func, union acpi_object *argv4, 66 acpi_object_type type) 67 { 68 union acpi_object *obj; 69 70 obj = acpi_evaluate_dsm(handle, guid, rev, func, argv4); 71 if (obj && obj->type != type) { 72 ACPI_FREE(obj); 73 obj = NULL; 74 } 75 76 return obj; 77 } 78 #endif 79 80 #define ACPI_INIT_DSM_ARGV4(cnt, eles) \ 81 { \ 82 .package.type = ACPI_TYPE_PACKAGE, \ 83 .package.count = (cnt), \ 84 .package.elements = (eles) \ 85 } 86 87 bool acpi_dev_found(const char *hid); 88 bool acpi_dev_present(const char *hid, const char *uid, s64 hrv); 89 bool acpi_reduced_hardware(void); 90 91 #ifdef CONFIG_ACPI 92 93 struct proc_dir_entry; 94 95 #define ACPI_BUS_FILE_ROOT "acpi" 96 extern struct proc_dir_entry *acpi_root_dir; 97 98 enum acpi_bus_device_type { 99 ACPI_BUS_TYPE_DEVICE = 0, 100 ACPI_BUS_TYPE_POWER, 101 ACPI_BUS_TYPE_PROCESSOR, 102 ACPI_BUS_TYPE_THERMAL, 103 ACPI_BUS_TYPE_POWER_BUTTON, 104 ACPI_BUS_TYPE_SLEEP_BUTTON, 105 ACPI_BUS_TYPE_ECDT_EC, 106 ACPI_BUS_DEVICE_TYPE_COUNT 107 }; 108 109 struct acpi_driver; 110 struct acpi_device; 111 112 /* 113 * ACPI Scan Handler 114 * ----------------- 115 */ 116 117 struct acpi_hotplug_profile { 118 struct kobject kobj; 119 int (*scan_dependent)(struct acpi_device *adev); 120 void (*notify_online)(struct acpi_device *adev); 121 bool enabled:1; 122 bool demand_offline:1; 123 }; 124 125 static inline struct acpi_hotplug_profile *to_acpi_hotplug_profile( 126 struct kobject *kobj) 127 { 128 return container_of(kobj, struct acpi_hotplug_profile, kobj); 129 } 130 131 struct acpi_scan_handler { 132 struct list_head list_node; 133 const struct acpi_device_id *ids; 134 bool (*match)(const char *idstr, const struct acpi_device_id **matchid); 135 int (*attach)(struct acpi_device *dev, const struct acpi_device_id *id); 136 void (*detach)(struct acpi_device *dev); 137 void (*bind)(struct device *phys_dev); 138 void (*unbind)(struct device *phys_dev); 139 struct acpi_hotplug_profile hotplug; 140 }; 141 142 /* 143 * ACPI Hotplug Context 144 * -------------------- 145 */ 146 147 typedef int (*acpi_hp_notify) (struct acpi_device *, u32); 148 typedef void (*acpi_hp_uevent) (struct acpi_device *, u32); 149 typedef void (*acpi_hp_fixup) (struct acpi_device *); 150 151 struct acpi_hotplug_context { 152 struct acpi_device *self; 153 acpi_hp_notify notify; 154 acpi_hp_uevent uevent; 155 acpi_hp_fixup fixup; 156 }; 157 158 /* 159 * ACPI Driver 160 * ----------- 161 */ 162 163 typedef int (*acpi_op_add) (struct acpi_device * device); 164 typedef void (*acpi_op_remove) (struct acpi_device *device); 165 typedef void (*acpi_op_notify) (struct acpi_device * device, u32 event); 166 167 struct acpi_device_ops { 168 acpi_op_add add; 169 acpi_op_remove remove; 170 acpi_op_notify notify; 171 }; 172 173 #define ACPI_DRIVER_ALL_NOTIFY_EVENTS 0x1 /* system AND device events */ 174 175 struct acpi_driver { 176 char name[80]; 177 char class[80]; 178 const struct acpi_device_id *ids; /* Supported Hardware IDs */ 179 unsigned int flags; 180 struct acpi_device_ops ops; 181 struct device_driver drv; 182 }; 183 184 /* 185 * ACPI Device 186 * ----------- 187 */ 188 189 /* Status (_STA) */ 190 191 struct acpi_device_status { 192 u32 present:1; 193 u32 enabled:1; 194 u32 show_in_ui:1; 195 u32 functional:1; 196 u32 battery_present:1; 197 u32 reserved:27; 198 }; 199 200 /* Flags */ 201 202 struct acpi_device_flags { 203 u32 dynamic_status:1; 204 u32 removable:1; 205 u32 ejectable:1; 206 u32 power_manageable:1; 207 u32 match_driver:1; 208 u32 initialized:1; 209 u32 visited:1; 210 u32 hotplug_notify:1; 211 u32 is_dock_station:1; 212 u32 of_compatible_ok:1; 213 u32 coherent_dma:1; 214 u32 cca_seen:1; 215 u32 enumeration_by_parent:1; 216 u32 honor_deps:1; 217 u32 reserved:18; 218 }; 219 220 /* File System */ 221 222 struct acpi_device_dir { 223 struct proc_dir_entry *entry; 224 }; 225 226 #define acpi_device_dir(d) ((d)->dir.entry) 227 228 /* Plug and Play */ 229 230 typedef char acpi_bus_id[8]; 231 typedef u64 acpi_bus_address; 232 typedef char acpi_device_name[40]; 233 typedef char acpi_device_class[20]; 234 235 struct acpi_hardware_id { 236 struct list_head list; 237 const char *id; 238 }; 239 240 struct acpi_pnp_type { 241 u32 hardware_id:1; 242 u32 bus_address:1; 243 u32 platform_id:1; 244 u32 backlight:1; 245 u32 reserved:28; 246 }; 247 248 struct acpi_device_pnp { 249 acpi_bus_id bus_id; /* Object name */ 250 int instance_no; /* Instance number of this object */ 251 struct acpi_pnp_type type; /* ID type */ 252 acpi_bus_address bus_address; /* _ADR */ 253 char *unique_id; /* _UID */ 254 struct list_head ids; /* _HID and _CIDs */ 255 acpi_device_name device_name; /* Driver-determined */ 256 acpi_device_class device_class; /* " */ 257 union acpi_object *str_obj; /* unicode string for _STR method */ 258 }; 259 260 #define acpi_device_bid(d) ((d)->pnp.bus_id) 261 #define acpi_device_adr(d) ((d)->pnp.bus_address) 262 const char *acpi_device_hid(struct acpi_device *device); 263 #define acpi_device_uid(d) ((d)->pnp.unique_id) 264 #define acpi_device_name(d) ((d)->pnp.device_name) 265 #define acpi_device_class(d) ((d)->pnp.device_class) 266 267 /* Power Management */ 268 269 struct acpi_device_power_flags { 270 u32 explicit_get:1; /* _PSC present? */ 271 u32 power_resources:1; /* Power resources */ 272 u32 inrush_current:1; /* Serialize Dx->D0 */ 273 u32 power_removed:1; /* Optimize Dx->D0 */ 274 u32 ignore_parent:1; /* Power is independent of parent power state */ 275 u32 dsw_present:1; /* _DSW present? */ 276 u32 reserved:26; 277 }; 278 279 struct acpi_device_power_state { 280 struct list_head resources; /* Power resources referenced */ 281 struct { 282 u8 valid:1; 283 u8 explicit_set:1; /* _PSx present? */ 284 u8 reserved:6; 285 } flags; 286 int power; /* % Power (compared to D0) */ 287 int latency; /* Dx->D0 time (microseconds) */ 288 }; 289 290 struct acpi_device_power { 291 int state; /* Current state */ 292 struct acpi_device_power_flags flags; 293 struct acpi_device_power_state states[ACPI_D_STATE_COUNT]; /* Power states (D0-D3Cold) */ 294 u8 state_for_enumeration; /* Deepest power state for enumeration */ 295 }; 296 297 struct acpi_dep_data { 298 struct list_head node; 299 acpi_handle supplier; 300 acpi_handle consumer; 301 bool honor_dep; 302 bool met; 303 bool free_when_met; 304 }; 305 306 /* Performance Management */ 307 308 struct acpi_device_perf_flags { 309 u8 reserved:8; 310 }; 311 312 struct acpi_device_perf_state { 313 struct { 314 u8 valid:1; 315 u8 reserved:7; 316 } flags; 317 u8 power; /* % Power (compared to P0) */ 318 u8 performance; /* % Performance ( " ) */ 319 int latency; /* Px->P0 time (microseconds) */ 320 }; 321 322 struct acpi_device_perf { 323 int state; 324 struct acpi_device_perf_flags flags; 325 int state_count; 326 struct acpi_device_perf_state *states; 327 }; 328 329 /* Wakeup Management */ 330 struct acpi_device_wakeup_flags { 331 u8 valid:1; /* Can successfully enable wakeup? */ 332 u8 notifier_present:1; /* Wake-up notify handler has been installed */ 333 }; 334 335 struct acpi_device_wakeup_context { 336 void (*func)(struct acpi_device_wakeup_context *context); 337 struct device *dev; 338 }; 339 340 struct acpi_device_wakeup { 341 acpi_handle gpe_device; 342 u64 gpe_number; 343 u64 sleep_state; 344 struct list_head resources; 345 struct acpi_device_wakeup_flags flags; 346 struct acpi_device_wakeup_context context; 347 struct wakeup_source *ws; 348 int prepare_count; 349 int enable_count; 350 }; 351 352 struct acpi_device_physical_node { 353 struct list_head node; 354 struct device *dev; 355 unsigned int node_id; 356 bool put_online:1; 357 }; 358 359 struct acpi_device_properties { 360 struct list_head list; 361 const guid_t *guid; 362 union acpi_object *properties; 363 void **bufs; 364 }; 365 366 /* ACPI Device Specific Data (_DSD) */ 367 struct acpi_device_data { 368 const union acpi_object *pointer; 369 struct list_head properties; 370 const union acpi_object *of_compatible; 371 struct list_head subnodes; 372 }; 373 374 struct acpi_gpio_mapping; 375 376 #define ACPI_DEVICE_SWNODE_ROOT 0 377 378 /* 379 * The maximum expected number of CSI-2 data lanes. 380 * 381 * This number is not expected to ever have to be equal to or greater than the 382 * number of bits in an unsigned long variable, but if it needs to be increased 383 * above that limit, code will need to be adjusted accordingly. 384 */ 385 #define ACPI_DEVICE_CSI2_DATA_LANES 8 386 387 #define ACPI_DEVICE_SWNODE_PORT_NAME_LENGTH 8 388 389 enum acpi_device_swnode_dev_props { 390 ACPI_DEVICE_SWNODE_DEV_ROTATION, 391 ACPI_DEVICE_SWNODE_DEV_CLOCK_FREQUENCY, 392 ACPI_DEVICE_SWNODE_DEV_LED_MAX_MICROAMP, 393 ACPI_DEVICE_SWNODE_DEV_FLASH_MAX_MICROAMP, 394 ACPI_DEVICE_SWNODE_DEV_FLASH_MAX_TIMEOUT_US, 395 ACPI_DEVICE_SWNODE_DEV_NUM_OF, 396 ACPI_DEVICE_SWNODE_DEV_NUM_ENTRIES 397 }; 398 399 enum acpi_device_swnode_port_props { 400 ACPI_DEVICE_SWNODE_PORT_REG, 401 ACPI_DEVICE_SWNODE_PORT_NUM_OF, 402 ACPI_DEVICE_SWNODE_PORT_NUM_ENTRIES 403 }; 404 405 enum acpi_device_swnode_ep_props { 406 ACPI_DEVICE_SWNODE_EP_REMOTE_EP, 407 ACPI_DEVICE_SWNODE_EP_BUS_TYPE, 408 ACPI_DEVICE_SWNODE_EP_REG, 409 ACPI_DEVICE_SWNODE_EP_CLOCK_LANES, 410 ACPI_DEVICE_SWNODE_EP_DATA_LANES, 411 ACPI_DEVICE_SWNODE_EP_LANE_POLARITIES, 412 /* TX only */ 413 ACPI_DEVICE_SWNODE_EP_LINK_FREQUENCIES, 414 ACPI_DEVICE_SWNODE_EP_NUM_OF, 415 ACPI_DEVICE_SWNODE_EP_NUM_ENTRIES 416 }; 417 418 /* 419 * Each device has a root software node plus two times as many nodes as the 420 * number of CSI-2 ports. 421 */ 422 #define ACPI_DEVICE_SWNODE_PORT(port) (2 * (port) + 1) 423 #define ACPI_DEVICE_SWNODE_EP(endpoint) \ 424 (ACPI_DEVICE_SWNODE_PORT(endpoint) + 1) 425 426 /** 427 * struct acpi_device_software_node_port - MIPI DisCo for Imaging CSI-2 port 428 * @port_name: Port name. 429 * @data_lanes: "data-lanes" property values. 430 * @lane_polarities: "lane-polarities" property values. 431 * @link_frequencies: "link_frequencies" property values. 432 * @port_nr: Port number. 433 * @crs_crs2_local: _CRS CSI2 record present (i.e. this is a transmitter one). 434 * @port_props: Port properties. 435 * @ep_props: Endpoint properties. 436 * @remote_ep: Reference to the remote endpoint. 437 */ 438 struct acpi_device_software_node_port { 439 char port_name[ACPI_DEVICE_SWNODE_PORT_NAME_LENGTH + 1]; 440 u32 data_lanes[ACPI_DEVICE_CSI2_DATA_LANES]; 441 u32 lane_polarities[ACPI_DEVICE_CSI2_DATA_LANES + 1 /* clock lane */]; 442 u64 link_frequencies[ACPI_DEVICE_CSI2_DATA_LANES]; 443 unsigned int port_nr; 444 bool crs_csi2_local; 445 446 struct property_entry port_props[ACPI_DEVICE_SWNODE_PORT_NUM_ENTRIES]; 447 struct property_entry ep_props[ACPI_DEVICE_SWNODE_EP_NUM_ENTRIES]; 448 449 struct software_node_ref_args remote_ep[1]; 450 }; 451 452 /** 453 * struct acpi_device_software_nodes - Software nodes for an ACPI device 454 * @dev_props: Device properties. 455 * @nodes: Software nodes for root as well as ports and endpoints. 456 * @nodeprts: Array of software node pointers, for (un)registering them. 457 * @ports: Information related to each port and endpoint within a port. 458 * @num_ports: The number of ports. 459 */ 460 struct acpi_device_software_nodes { 461 struct property_entry dev_props[ACPI_DEVICE_SWNODE_DEV_NUM_ENTRIES]; 462 struct software_node *nodes; 463 const struct software_node **nodeptrs; 464 struct acpi_device_software_node_port *ports; 465 unsigned int num_ports; 466 }; 467 468 /* Device */ 469 struct acpi_device { 470 u32 pld_crc; 471 int device_type; 472 acpi_handle handle; /* no handle for fixed hardware */ 473 struct fwnode_handle fwnode; 474 struct list_head wakeup_list; 475 struct list_head del_list; 476 struct acpi_device_status status; 477 struct acpi_device_flags flags; 478 struct acpi_device_pnp pnp; 479 struct acpi_device_power power; 480 struct acpi_device_wakeup wakeup; 481 struct acpi_device_perf performance; 482 struct acpi_device_dir dir; 483 struct acpi_device_data data; 484 struct acpi_scan_handler *handler; 485 struct acpi_hotplug_context *hp; 486 struct acpi_device_software_nodes *swnodes; 487 const struct acpi_gpio_mapping *driver_gpios; 488 void *driver_data; 489 struct device dev; 490 unsigned int physical_node_count; 491 unsigned int dep_unmet; 492 struct list_head physical_node_list; 493 struct mutex physical_node_lock; 494 void (*remove)(struct acpi_device *); 495 }; 496 497 /* Non-device subnode */ 498 struct acpi_data_node { 499 struct list_head sibling; 500 const char *name; 501 acpi_handle handle; 502 struct fwnode_handle fwnode; 503 struct fwnode_handle *parent; 504 struct acpi_device_data data; 505 struct kobject kobj; 506 struct completion kobj_done; 507 }; 508 509 extern const struct fwnode_operations acpi_device_fwnode_ops; 510 extern const struct fwnode_operations acpi_data_fwnode_ops; 511 extern const struct fwnode_operations acpi_static_fwnode_ops; 512 513 bool is_acpi_device_node(const struct fwnode_handle *fwnode); 514 bool is_acpi_data_node(const struct fwnode_handle *fwnode); 515 516 static inline bool is_acpi_node(const struct fwnode_handle *fwnode) 517 { 518 return (is_acpi_device_node(fwnode) || is_acpi_data_node(fwnode)); 519 } 520 521 #define to_acpi_device_node(__fwnode) \ 522 ({ \ 523 typeof(__fwnode) __to_acpi_device_node_fwnode = __fwnode; \ 524 \ 525 is_acpi_device_node(__to_acpi_device_node_fwnode) ? \ 526 container_of(__to_acpi_device_node_fwnode, \ 527 struct acpi_device, fwnode) : \ 528 NULL; \ 529 }) 530 531 #define to_acpi_data_node(__fwnode) \ 532 ({ \ 533 typeof(__fwnode) __to_acpi_data_node_fwnode = __fwnode; \ 534 \ 535 is_acpi_data_node(__to_acpi_data_node_fwnode) ? \ 536 container_of(__to_acpi_data_node_fwnode, \ 537 struct acpi_data_node, fwnode) : \ 538 NULL; \ 539 }) 540 541 static inline bool is_acpi_static_node(const struct fwnode_handle *fwnode) 542 { 543 return !IS_ERR_OR_NULL(fwnode) && 544 fwnode->ops == &acpi_static_fwnode_ops; 545 } 546 547 static inline bool acpi_data_node_match(const struct fwnode_handle *fwnode, 548 const char *name) 549 { 550 return is_acpi_data_node(fwnode) ? 551 (!strcmp(to_acpi_data_node(fwnode)->name, name)) : false; 552 } 553 554 static inline struct fwnode_handle *acpi_fwnode_handle(struct acpi_device *adev) 555 { 556 return &adev->fwnode; 557 } 558 559 static inline void *acpi_driver_data(struct acpi_device *d) 560 { 561 return d->driver_data; 562 } 563 564 #define to_acpi_device(d) container_of(d, struct acpi_device, dev) 565 #define to_acpi_driver(d) container_of(d, struct acpi_driver, drv) 566 567 static inline struct acpi_device *acpi_dev_parent(struct acpi_device *adev) 568 { 569 if (adev->dev.parent) 570 return to_acpi_device(adev->dev.parent); 571 572 return NULL; 573 } 574 575 static inline void acpi_set_device_status(struct acpi_device *adev, u32 sta) 576 { 577 *((u32 *)&adev->status) = sta; 578 } 579 580 static inline void acpi_set_hp_context(struct acpi_device *adev, 581 struct acpi_hotplug_context *hp) 582 { 583 hp->self = adev; 584 adev->hp = hp; 585 } 586 587 void acpi_initialize_hp_context(struct acpi_device *adev, 588 struct acpi_hotplug_context *hp, 589 acpi_hp_notify notify, acpi_hp_uevent uevent); 590 591 /* acpi_device.dev.bus == &acpi_bus_type */ 592 extern const struct bus_type acpi_bus_type; 593 594 int acpi_bus_for_each_dev(int (*fn)(struct device *, void *), void *data); 595 int acpi_dev_for_each_child(struct acpi_device *adev, 596 int (*fn)(struct acpi_device *, void *), void *data); 597 int acpi_dev_for_each_child_reverse(struct acpi_device *adev, 598 int (*fn)(struct acpi_device *, void *), 599 void *data); 600 601 /* 602 * Events 603 * ------ 604 */ 605 606 struct acpi_bus_event { 607 struct list_head node; 608 acpi_device_class device_class; 609 acpi_bus_id bus_id; 610 u32 type; 611 u32 data; 612 }; 613 614 extern struct kobject *acpi_kobj; 615 extern int acpi_bus_generate_netlink_event(const char*, const char*, u8, int); 616 void acpi_bus_private_data_handler(acpi_handle, void *); 617 int acpi_bus_get_private_data(acpi_handle, void **); 618 int acpi_bus_attach_private_data(acpi_handle, void *); 619 void acpi_bus_detach_private_data(acpi_handle); 620 int acpi_dev_install_notify_handler(struct acpi_device *adev, 621 u32 handler_type, 622 acpi_notify_handler handler, void *context); 623 void acpi_dev_remove_notify_handler(struct acpi_device *adev, 624 u32 handler_type, 625 acpi_notify_handler handler); 626 extern int acpi_notifier_call_chain(struct acpi_device *, u32, u32); 627 extern int register_acpi_notifier(struct notifier_block *); 628 extern int unregister_acpi_notifier(struct notifier_block *); 629 630 /* 631 * External Functions 632 */ 633 634 acpi_status acpi_bus_get_status_handle(acpi_handle handle, 635 unsigned long long *sta); 636 int acpi_bus_get_status(struct acpi_device *device); 637 638 int acpi_bus_set_power(acpi_handle handle, int state); 639 const char *acpi_power_state_string(int state); 640 int acpi_device_set_power(struct acpi_device *device, int state); 641 int acpi_bus_init_power(struct acpi_device *device); 642 int acpi_device_fix_up_power(struct acpi_device *device); 643 void acpi_device_fix_up_power_extended(struct acpi_device *adev); 644 void acpi_device_fix_up_power_children(struct acpi_device *adev); 645 int acpi_bus_update_power(acpi_handle handle, int *state_p); 646 int acpi_device_update_power(struct acpi_device *device, int *state_p); 647 bool acpi_bus_power_manageable(acpi_handle handle); 648 void acpi_dev_power_up_children_with_adr(struct acpi_device *adev); 649 u8 acpi_dev_power_state_for_wake(struct acpi_device *adev); 650 int acpi_device_power_add_dependent(struct acpi_device *adev, 651 struct device *dev); 652 void acpi_device_power_remove_dependent(struct acpi_device *adev, 653 struct device *dev); 654 655 #ifdef CONFIG_PM 656 bool acpi_bus_can_wakeup(acpi_handle handle); 657 #else 658 static inline bool acpi_bus_can_wakeup(acpi_handle handle) { return false; } 659 #endif 660 661 void acpi_scan_lock_acquire(void); 662 void acpi_scan_lock_release(void); 663 void acpi_lock_hp_context(void); 664 void acpi_unlock_hp_context(void); 665 int acpi_scan_add_handler(struct acpi_scan_handler *handler); 666 /* 667 * use a macro to avoid include chaining to get THIS_MODULE 668 */ 669 #define acpi_bus_register_driver(drv) \ 670 __acpi_bus_register_driver(drv, THIS_MODULE) 671 int __acpi_bus_register_driver(struct acpi_driver *driver, struct module *owner); 672 void acpi_bus_unregister_driver(struct acpi_driver *driver); 673 int acpi_bus_scan(acpi_handle handle); 674 void acpi_bus_trim(struct acpi_device *start); 675 acpi_status acpi_bus_get_ejd(acpi_handle handle, acpi_handle * ejd); 676 int acpi_match_device_ids(struct acpi_device *device, 677 const struct acpi_device_id *ids); 678 void acpi_set_modalias(struct acpi_device *adev, const char *default_id, 679 char *modalias, size_t len); 680 681 static inline bool acpi_device_enumerated(struct acpi_device *adev) 682 { 683 return adev && adev->flags.initialized && adev->flags.visited; 684 } 685 686 /** 687 * module_acpi_driver(acpi_driver) - Helper macro for registering an ACPI driver 688 * @__acpi_driver: acpi_driver struct 689 * 690 * Helper macro for ACPI drivers which do not do anything special in module 691 * init/exit. This eliminates a lot of boilerplate. Each module may only 692 * use this macro once, and calling it replaces module_init() and module_exit() 693 */ 694 #define module_acpi_driver(__acpi_driver) \ 695 module_driver(__acpi_driver, acpi_bus_register_driver, \ 696 acpi_bus_unregister_driver) 697 698 /* 699 * Bind physical devices with ACPI devices 700 */ 701 struct acpi_bus_type { 702 struct list_head list; 703 const char *name; 704 bool (*match)(struct device *dev); 705 struct acpi_device * (*find_companion)(struct device *); 706 void (*setup)(struct device *); 707 }; 708 int register_acpi_bus_type(struct acpi_bus_type *); 709 int unregister_acpi_bus_type(struct acpi_bus_type *); 710 int acpi_bind_one(struct device *dev, struct acpi_device *adev); 711 int acpi_unbind_one(struct device *dev); 712 713 enum acpi_bridge_type { 714 ACPI_BRIDGE_TYPE_PCIE = 1, 715 ACPI_BRIDGE_TYPE_CXL, 716 }; 717 718 struct acpi_pci_root { 719 struct acpi_device * device; 720 struct pci_bus *bus; 721 u16 segment; 722 int bridge_type; 723 struct resource secondary; /* downstream bus range */ 724 725 u32 osc_support_set; /* _OSC state of support bits */ 726 u32 osc_control_set; /* _OSC state of control bits */ 727 u32 osc_ext_support_set; /* _OSC state of extended support bits */ 728 u32 osc_ext_control_set; /* _OSC state of extended control bits */ 729 phys_addr_t mcfg_addr; 730 }; 731 732 /* helper */ 733 734 struct iommu_ops; 735 736 bool acpi_dma_supported(const struct acpi_device *adev); 737 enum dev_dma_attr acpi_get_dma_attr(struct acpi_device *adev); 738 int acpi_iommu_fwspec_init(struct device *dev, u32 id, 739 struct fwnode_handle *fwnode, 740 const struct iommu_ops *ops); 741 int acpi_dma_get_range(struct device *dev, const struct bus_dma_region **map); 742 int acpi_dma_configure_id(struct device *dev, enum dev_dma_attr attr, 743 const u32 *input_id); 744 static inline int acpi_dma_configure(struct device *dev, 745 enum dev_dma_attr attr) 746 { 747 return acpi_dma_configure_id(dev, attr, NULL); 748 } 749 struct acpi_device *acpi_find_child_device(struct acpi_device *parent, 750 u64 address, bool check_children); 751 struct acpi_device *acpi_find_child_by_adr(struct acpi_device *adev, 752 acpi_bus_address adr); 753 int acpi_is_root_bridge(acpi_handle); 754 struct acpi_pci_root *acpi_pci_find_root(acpi_handle handle); 755 756 int acpi_enable_wakeup_device_power(struct acpi_device *dev, int state); 757 int acpi_disable_wakeup_device_power(struct acpi_device *dev); 758 759 #ifdef CONFIG_X86 760 bool acpi_device_override_status(struct acpi_device *adev, unsigned long long *status); 761 bool acpi_quirk_skip_acpi_ac_and_battery(void); 762 int acpi_install_cmos_rtc_space_handler(acpi_handle handle); 763 void acpi_remove_cmos_rtc_space_handler(acpi_handle handle); 764 int acpi_quirk_skip_serdev_enumeration(struct device *controller_parent, bool *skip); 765 #else 766 static inline bool acpi_device_override_status(struct acpi_device *adev, 767 unsigned long long *status) 768 { 769 return false; 770 } 771 static inline bool acpi_quirk_skip_acpi_ac_and_battery(void) 772 { 773 return false; 774 } 775 static inline int acpi_install_cmos_rtc_space_handler(acpi_handle handle) 776 { 777 return 1; 778 } 779 static inline void acpi_remove_cmos_rtc_space_handler(acpi_handle handle) 780 { 781 } 782 static inline int 783 acpi_quirk_skip_serdev_enumeration(struct device *controller_parent, bool *skip) 784 { 785 *skip = false; 786 return 0; 787 } 788 #endif 789 790 #if IS_ENABLED(CONFIG_X86_ANDROID_TABLETS) 791 bool acpi_quirk_skip_i2c_client_enumeration(struct acpi_device *adev); 792 bool acpi_quirk_skip_gpio_event_handlers(void); 793 #else 794 static inline bool acpi_quirk_skip_i2c_client_enumeration(struct acpi_device *adev) 795 { 796 return false; 797 } 798 static inline bool acpi_quirk_skip_gpio_event_handlers(void) 799 { 800 return false; 801 } 802 #endif 803 804 #ifdef CONFIG_PM 805 void acpi_pm_wakeup_event(struct device *dev); 806 acpi_status acpi_add_pm_notifier(struct acpi_device *adev, struct device *dev, 807 void (*func)(struct acpi_device_wakeup_context *context)); 808 acpi_status acpi_remove_pm_notifier(struct acpi_device *adev); 809 bool acpi_pm_device_can_wakeup(struct device *dev); 810 int acpi_pm_device_sleep_state(struct device *, int *, int); 811 int acpi_pm_set_device_wakeup(struct device *dev, bool enable); 812 #else 813 static inline void acpi_pm_wakeup_event(struct device *dev) 814 { 815 } 816 static inline acpi_status acpi_add_pm_notifier(struct acpi_device *adev, 817 struct device *dev, 818 void (*func)(struct acpi_device_wakeup_context *context)) 819 { 820 return AE_SUPPORT; 821 } 822 static inline acpi_status acpi_remove_pm_notifier(struct acpi_device *adev) 823 { 824 return AE_SUPPORT; 825 } 826 static inline bool acpi_pm_device_can_wakeup(struct device *dev) 827 { 828 return false; 829 } 830 static inline int acpi_pm_device_sleep_state(struct device *d, int *p, int m) 831 { 832 if (p) 833 *p = ACPI_STATE_D0; 834 835 return (m >= ACPI_STATE_D0 && m <= ACPI_STATE_D3_COLD) ? 836 m : ACPI_STATE_D0; 837 } 838 static inline int acpi_pm_set_device_wakeup(struct device *dev, bool enable) 839 { 840 return -ENODEV; 841 } 842 #endif 843 844 #ifdef CONFIG_ACPI_SYSTEM_POWER_STATES_SUPPORT 845 bool acpi_sleep_state_supported(u8 sleep_state); 846 #else 847 static inline bool acpi_sleep_state_supported(u8 sleep_state) { return false; } 848 #endif 849 850 #ifdef CONFIG_ACPI_SLEEP 851 u32 acpi_target_system_state(void); 852 #else 853 static inline u32 acpi_target_system_state(void) { return ACPI_STATE_S0; } 854 #endif 855 856 static inline bool acpi_device_power_manageable(struct acpi_device *adev) 857 { 858 return adev->flags.power_manageable; 859 } 860 861 static inline bool acpi_device_can_wakeup(struct acpi_device *adev) 862 { 863 return adev->wakeup.flags.valid; 864 } 865 866 static inline bool acpi_device_can_poweroff(struct acpi_device *adev) 867 { 868 return adev->power.states[ACPI_STATE_D3_COLD].flags.valid || 869 ((acpi_gbl_FADT.header.revision < 6) && 870 adev->power.states[ACPI_STATE_D3_HOT].flags.explicit_set); 871 } 872 873 int acpi_dev_uid_to_integer(struct acpi_device *adev, u64 *integer); 874 875 static inline bool acpi_dev_hid_match(struct acpi_device *adev, const char *hid2) 876 { 877 const char *hid1 = acpi_device_hid(adev); 878 879 return hid1 && hid2 && !strcmp(hid1, hid2); 880 } 881 882 static inline bool acpi_str_uid_match(struct acpi_device *adev, const char *uid2) 883 { 884 const char *uid1 = acpi_device_uid(adev); 885 886 return uid1 && uid2 && !strcmp(uid1, uid2); 887 } 888 889 static inline bool acpi_int_uid_match(struct acpi_device *adev, u64 uid2) 890 { 891 u64 uid1; 892 893 return !acpi_dev_uid_to_integer(adev, &uid1) && uid1 == uid2; 894 } 895 896 #define TYPE_ENTRY(type, x) \ 897 const type: x, \ 898 type: x 899 900 #define ACPI_STR_TYPES(match) \ 901 TYPE_ENTRY(unsigned char *, match), \ 902 TYPE_ENTRY(signed char *, match), \ 903 TYPE_ENTRY(char *, match), \ 904 TYPE_ENTRY(void *, match) 905 906 /** 907 * acpi_dev_uid_match - Match device by supplied UID 908 * @adev: ACPI device to match. 909 * @uid2: Unique ID of the device. 910 * 911 * Matches UID in @adev with given @uid2. 912 * 913 * Returns: %true if matches, %false otherwise. 914 */ 915 #define acpi_dev_uid_match(adev, uid2) \ 916 _Generic(uid2, \ 917 /* Treat @uid2 as a string for acpi string types */ \ 918 ACPI_STR_TYPES(acpi_str_uid_match), \ 919 /* Treat as an integer otherwise */ \ 920 default: acpi_int_uid_match)(adev, uid2) 921 922 /** 923 * acpi_dev_hid_uid_match - Match device by supplied HID and UID 924 * @adev: ACPI device to match. 925 * @hid2: Hardware ID of the device. 926 * @uid2: Unique ID of the device, pass NULL to not check _UID. 927 * 928 * Matches HID and UID in @adev with given @hid2 and @uid2. Absence of @uid2 929 * will be treated as a match. If user wants to validate @uid2, it should be 930 * done before calling this function. 931 * 932 * Returns: %true if matches or @uid2 is NULL, %false otherwise. 933 */ 934 #define acpi_dev_hid_uid_match(adev, hid2, uid2) \ 935 (acpi_dev_hid_match(adev, hid2) && \ 936 /* Distinguish integer 0 from NULL @uid2 */ \ 937 (_Generic(uid2, ACPI_STR_TYPES(!(uid2)), default: 0) || \ 938 acpi_dev_uid_match(adev, uid2))) 939 940 void acpi_dev_clear_dependencies(struct acpi_device *supplier); 941 bool acpi_dev_ready_for_enumeration(const struct acpi_device *device); 942 struct acpi_device *acpi_dev_get_next_consumer_dev(struct acpi_device *supplier, 943 struct acpi_device *start); 944 945 /** 946 * for_each_acpi_consumer_dev - iterate over the consumer ACPI devices for a 947 * given supplier 948 * @supplier: Pointer to the supplier's ACPI device 949 * @consumer: Pointer to &struct acpi_device to hold the consumer, initially NULL 950 */ 951 #define for_each_acpi_consumer_dev(supplier, consumer) \ 952 for (consumer = acpi_dev_get_next_consumer_dev(supplier, NULL); \ 953 consumer; \ 954 consumer = acpi_dev_get_next_consumer_dev(supplier, consumer)) 955 956 struct acpi_device * 957 acpi_dev_get_next_match_dev(struct acpi_device *adev, const char *hid, const char *uid, s64 hrv); 958 struct acpi_device * 959 acpi_dev_get_first_match_dev(const char *hid, const char *uid, s64 hrv); 960 961 /** 962 * for_each_acpi_dev_match - iterate over ACPI devices that matching the criteria 963 * @adev: pointer to the matching ACPI device, NULL at the end of the loop 964 * @hid: Hardware ID of the device. 965 * @uid: Unique ID of the device, pass NULL to not check _UID 966 * @hrv: Hardware Revision of the device, pass -1 to not check _HRV 967 * 968 * The caller is responsible for invoking acpi_dev_put() on the returned device. 969 */ 970 #define for_each_acpi_dev_match(adev, hid, uid, hrv) \ 971 for (adev = acpi_dev_get_first_match_dev(hid, uid, hrv); \ 972 adev; \ 973 adev = acpi_dev_get_next_match_dev(adev, hid, uid, hrv)) 974 975 static inline struct acpi_device *acpi_dev_get(struct acpi_device *adev) 976 { 977 return adev ? to_acpi_device(get_device(&adev->dev)) : NULL; 978 } 979 980 static inline void acpi_dev_put(struct acpi_device *adev) 981 { 982 if (adev) 983 put_device(&adev->dev); 984 } 985 986 struct acpi_device *acpi_fetch_acpi_dev(acpi_handle handle); 987 struct acpi_device *acpi_get_acpi_dev(acpi_handle handle); 988 989 static inline void acpi_put_acpi_dev(struct acpi_device *adev) 990 { 991 acpi_dev_put(adev); 992 } 993 994 int acpi_wait_for_acpi_ipmi(void); 995 996 #else /* CONFIG_ACPI */ 997 998 static inline int register_acpi_bus_type(void *bus) { return 0; } 999 static inline int unregister_acpi_bus_type(void *bus) { return 0; } 1000 1001 static inline int acpi_wait_for_acpi_ipmi(void) { return 0; } 1002 1003 #endif /* CONFIG_ACPI */ 1004 1005 #endif /*__ACPI_BUS_H__*/ 1006