1 /* 2 * acpi_bus.h - ACPI Bus Driver ($Revision: 22 $) 3 * 4 * Copyright (C) 2001, 2002 Andy Grover <andrew.grover@intel.com> 5 * Copyright (C) 2001, 2002 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com> 6 * 7 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 8 * 9 * This program is free software; you can redistribute it and/or modify 10 * it under the terms of the GNU General Public License as published by 11 * the Free Software Foundation; either version 2 of the License, or (at 12 * your option) any later version. 13 * 14 * This program is distributed in the hope that it will be useful, but 15 * WITHOUT ANY WARRANTY; without even the implied warranty of 16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 17 * General Public License for more details. 18 * 19 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 20 */ 21 22 #ifndef __ACPI_BUS_H__ 23 #define __ACPI_BUS_H__ 24 25 #include <linux/device.h> 26 #include <linux/property.h> 27 28 /* TBD: Make dynamic */ 29 #define ACPI_MAX_HANDLES 10 30 struct acpi_handle_list { 31 u32 count; 32 acpi_handle handles[ACPI_MAX_HANDLES]; 33 }; 34 35 /* acpi_utils.h */ 36 acpi_status 37 acpi_extract_package(union acpi_object *package, 38 struct acpi_buffer *format, struct acpi_buffer *buffer); 39 acpi_status 40 acpi_evaluate_integer(acpi_handle handle, 41 acpi_string pathname, 42 struct acpi_object_list *arguments, unsigned long long *data); 43 acpi_status 44 acpi_evaluate_reference(acpi_handle handle, 45 acpi_string pathname, 46 struct acpi_object_list *arguments, 47 struct acpi_handle_list *list); 48 acpi_status 49 acpi_evaluate_ost(acpi_handle handle, u32 source_event, u32 status_code, 50 struct acpi_buffer *status_buf); 51 52 acpi_status 53 acpi_get_physical_device_location(acpi_handle handle, struct acpi_pld_info **pld); 54 55 bool acpi_has_method(acpi_handle handle, char *name); 56 acpi_status acpi_execute_simple_method(acpi_handle handle, char *method, 57 u64 arg); 58 acpi_status acpi_evaluate_ej0(acpi_handle handle); 59 acpi_status acpi_evaluate_lck(acpi_handle handle, int lock); 60 bool acpi_ata_match(acpi_handle handle); 61 bool acpi_bay_match(acpi_handle handle); 62 bool acpi_dock_match(acpi_handle handle); 63 64 bool acpi_check_dsm(acpi_handle handle, const u8 *uuid, int rev, u64 funcs); 65 union acpi_object *acpi_evaluate_dsm(acpi_handle handle, const u8 *uuid, 66 int rev, int func, union acpi_object *argv4); 67 68 static inline union acpi_object * 69 acpi_evaluate_dsm_typed(acpi_handle handle, const u8 *uuid, int rev, int func, 70 union acpi_object *argv4, acpi_object_type type) 71 { 72 union acpi_object *obj; 73 74 obj = acpi_evaluate_dsm(handle, uuid, rev, func, argv4); 75 if (obj && obj->type != type) { 76 ACPI_FREE(obj); 77 obj = NULL; 78 } 79 80 return obj; 81 } 82 83 #define ACPI_INIT_DSM_ARGV4(cnt, eles) \ 84 { \ 85 .package.type = ACPI_TYPE_PACKAGE, \ 86 .package.count = (cnt), \ 87 .package.elements = (eles) \ 88 } 89 90 #ifdef CONFIG_ACPI 91 92 #include <linux/proc_fs.h> 93 94 #define ACPI_BUS_FILE_ROOT "acpi" 95 extern struct proc_dir_entry *acpi_root_dir; 96 97 enum acpi_bus_device_type { 98 ACPI_BUS_TYPE_DEVICE = 0, 99 ACPI_BUS_TYPE_POWER, 100 ACPI_BUS_TYPE_PROCESSOR, 101 ACPI_BUS_TYPE_THERMAL, 102 ACPI_BUS_TYPE_POWER_BUTTON, 103 ACPI_BUS_TYPE_SLEEP_BUTTON, 104 ACPI_BUS_DEVICE_TYPE_COUNT 105 }; 106 107 struct acpi_driver; 108 struct acpi_device; 109 110 /* 111 * ACPI Scan Handler 112 * ----------------- 113 */ 114 115 struct acpi_hotplug_profile { 116 struct kobject kobj; 117 int (*scan_dependent)(struct acpi_device *adev); 118 void (*notify_online)(struct acpi_device *adev); 119 bool enabled:1; 120 bool demand_offline:1; 121 }; 122 123 static inline struct acpi_hotplug_profile *to_acpi_hotplug_profile( 124 struct kobject *kobj) 125 { 126 return container_of(kobj, struct acpi_hotplug_profile, kobj); 127 } 128 129 struct acpi_scan_handler { 130 const struct acpi_device_id *ids; 131 struct list_head list_node; 132 bool (*match)(const char *idstr, const struct acpi_device_id **matchid); 133 int (*attach)(struct acpi_device *dev, const struct acpi_device_id *id); 134 void (*detach)(struct acpi_device *dev); 135 void (*bind)(struct device *phys_dev); 136 void (*unbind)(struct device *phys_dev); 137 struct acpi_hotplug_profile hotplug; 138 }; 139 140 /* 141 * ACPI Hotplug Context 142 * -------------------- 143 */ 144 145 struct acpi_hotplug_context { 146 struct acpi_device *self; 147 int (*notify)(struct acpi_device *, u32); 148 void (*uevent)(struct acpi_device *, u32); 149 void (*fixup)(struct acpi_device *); 150 }; 151 152 /* 153 * ACPI Driver 154 * ----------- 155 */ 156 157 typedef int (*acpi_op_add) (struct acpi_device * device); 158 typedef int (*acpi_op_remove) (struct acpi_device * device); 159 typedef void (*acpi_op_notify) (struct acpi_device * device, u32 event); 160 161 struct acpi_device_ops { 162 acpi_op_add add; 163 acpi_op_remove remove; 164 acpi_op_notify notify; 165 }; 166 167 #define ACPI_DRIVER_ALL_NOTIFY_EVENTS 0x1 /* system AND device events */ 168 169 struct acpi_driver { 170 char name[80]; 171 char class[80]; 172 const struct acpi_device_id *ids; /* Supported Hardware IDs */ 173 unsigned int flags; 174 struct acpi_device_ops ops; 175 struct device_driver drv; 176 struct module *owner; 177 }; 178 179 /* 180 * ACPI Device 181 * ----------- 182 */ 183 184 /* Status (_STA) */ 185 186 struct acpi_device_status { 187 u32 present:1; 188 u32 enabled:1; 189 u32 show_in_ui:1; 190 u32 functional:1; 191 u32 battery_present:1; 192 u32 reserved:27; 193 }; 194 195 /* Flags */ 196 197 struct acpi_device_flags { 198 u32 dynamic_status:1; 199 u32 removable:1; 200 u32 ejectable:1; 201 u32 power_manageable:1; 202 u32 match_driver:1; 203 u32 initialized:1; 204 u32 visited:1; 205 u32 hotplug_notify:1; 206 u32 is_dock_station:1; 207 u32 of_compatible_ok:1; 208 u32 coherent_dma:1; 209 u32 cca_seen:1; 210 u32 reserved:20; 211 }; 212 213 /* File System */ 214 215 struct acpi_device_dir { 216 struct proc_dir_entry *entry; 217 }; 218 219 #define acpi_device_dir(d) ((d)->dir.entry) 220 221 /* Plug and Play */ 222 223 typedef char acpi_bus_id[8]; 224 typedef unsigned long acpi_bus_address; 225 typedef char acpi_device_name[40]; 226 typedef char acpi_device_class[20]; 227 228 struct acpi_hardware_id { 229 struct list_head list; 230 const char *id; 231 }; 232 233 struct acpi_pnp_type { 234 u32 hardware_id:1; 235 u32 bus_address:1; 236 u32 platform_id:1; 237 u32 reserved:29; 238 }; 239 240 struct acpi_device_pnp { 241 acpi_bus_id bus_id; /* Object name */ 242 struct acpi_pnp_type type; /* ID type */ 243 acpi_bus_address bus_address; /* _ADR */ 244 char *unique_id; /* _UID */ 245 struct list_head ids; /* _HID and _CIDs */ 246 acpi_device_name device_name; /* Driver-determined */ 247 acpi_device_class device_class; /* " */ 248 union acpi_object *str_obj; /* unicode string for _STR method */ 249 }; 250 251 #define acpi_device_bid(d) ((d)->pnp.bus_id) 252 #define acpi_device_adr(d) ((d)->pnp.bus_address) 253 const char *acpi_device_hid(struct acpi_device *device); 254 #define acpi_device_uid(d) ((d)->pnp.unique_id) 255 #define acpi_device_name(d) ((d)->pnp.device_name) 256 #define acpi_device_class(d) ((d)->pnp.device_class) 257 258 /* Power Management */ 259 260 struct acpi_device_power_flags { 261 u32 explicit_get:1; /* _PSC present? */ 262 u32 power_resources:1; /* Power resources */ 263 u32 inrush_current:1; /* Serialize Dx->D0 */ 264 u32 power_removed:1; /* Optimize Dx->D0 */ 265 u32 ignore_parent:1; /* Power is independent of parent power state */ 266 u32 dsw_present:1; /* _DSW present? */ 267 u32 reserved:26; 268 }; 269 270 struct acpi_device_power_state { 271 struct { 272 u8 valid:1; 273 u8 explicit_set:1; /* _PSx present? */ 274 u8 reserved:6; 275 } flags; 276 int power; /* % Power (compared to D0) */ 277 int latency; /* Dx->D0 time (microseconds) */ 278 struct list_head resources; /* Power resources referenced */ 279 }; 280 281 struct acpi_device_power { 282 int state; /* Current state */ 283 struct acpi_device_power_flags flags; 284 struct acpi_device_power_state states[ACPI_D_STATE_COUNT]; /* Power states (D0-D3Cold) */ 285 }; 286 287 /* Performance Management */ 288 289 struct acpi_device_perf_flags { 290 u8 reserved:8; 291 }; 292 293 struct acpi_device_perf_state { 294 struct { 295 u8 valid:1; 296 u8 reserved:7; 297 } flags; 298 u8 power; /* % Power (compared to P0) */ 299 u8 performance; /* % Performance ( " ) */ 300 int latency; /* Px->P0 time (microseconds) */ 301 }; 302 303 struct acpi_device_perf { 304 int state; 305 struct acpi_device_perf_flags flags; 306 int state_count; 307 struct acpi_device_perf_state *states; 308 }; 309 310 /* Wakeup Management */ 311 struct acpi_device_wakeup_flags { 312 u8 valid:1; /* Can successfully enable wakeup? */ 313 u8 run_wake:1; /* Run-Wake GPE devices */ 314 u8 notifier_present:1; /* Wake-up notify handler has been installed */ 315 u8 enabled:1; /* Enabled for wakeup */ 316 }; 317 318 struct acpi_device_wakeup_context { 319 struct work_struct work; 320 struct device *dev; 321 }; 322 323 struct acpi_device_wakeup { 324 acpi_handle gpe_device; 325 u64 gpe_number; 326 u64 sleep_state; 327 struct list_head resources; 328 struct acpi_device_wakeup_flags flags; 329 struct acpi_device_wakeup_context context; 330 struct wakeup_source *ws; 331 int prepare_count; 332 }; 333 334 struct acpi_device_physical_node { 335 unsigned int node_id; 336 struct list_head node; 337 struct device *dev; 338 bool put_online:1; 339 }; 340 341 /* ACPI Device Specific Data (_DSD) */ 342 struct acpi_device_data { 343 const union acpi_object *pointer; 344 const union acpi_object *properties; 345 const union acpi_object *of_compatible; 346 struct list_head subnodes; 347 }; 348 349 struct acpi_gpio_mapping; 350 351 /* Device */ 352 struct acpi_device { 353 int device_type; 354 acpi_handle handle; /* no handle for fixed hardware */ 355 struct fwnode_handle fwnode; 356 struct acpi_device *parent; 357 struct list_head children; 358 struct list_head node; 359 struct list_head wakeup_list; 360 struct list_head del_list; 361 struct acpi_device_status status; 362 struct acpi_device_flags flags; 363 struct acpi_device_pnp pnp; 364 struct acpi_device_power power; 365 struct acpi_device_wakeup wakeup; 366 struct acpi_device_perf performance; 367 struct acpi_device_dir dir; 368 struct acpi_device_data data; 369 struct acpi_scan_handler *handler; 370 struct acpi_hotplug_context *hp; 371 struct acpi_driver *driver; 372 const struct acpi_gpio_mapping *driver_gpios; 373 void *driver_data; 374 struct device dev; 375 unsigned int physical_node_count; 376 unsigned int dep_unmet; 377 struct list_head physical_node_list; 378 struct mutex physical_node_lock; 379 void (*remove)(struct acpi_device *); 380 }; 381 382 /* Non-device subnode */ 383 struct acpi_data_node { 384 const char *name; 385 acpi_handle handle; 386 struct fwnode_handle fwnode; 387 struct acpi_device_data data; 388 struct list_head sibling; 389 struct kobject kobj; 390 struct completion kobj_done; 391 }; 392 393 static inline bool acpi_check_dma(struct acpi_device *adev, bool *coherent) 394 { 395 bool ret = false; 396 397 if (!adev) 398 return ret; 399 400 /** 401 * Currently, we only support _CCA=1 (i.e. coherent_dma=1) 402 * This should be equivalent to specifyig dma-coherent for 403 * a device in OF. 404 * 405 * For the case when _CCA=0 (i.e. coherent_dma=0 && cca_seen=1), 406 * There are two cases: 407 * case 1. Do not support and disable DMA. 408 * case 2. Support but rely on arch-specific cache maintenance for 409 * non-coherence DMA operations. 410 * Currently, we implement case 1 above. 411 * 412 * For the case when _CCA is missing (i.e. cca_seen=0) and 413 * platform specifies ACPI_CCA_REQUIRED, we do not support DMA, 414 * and fallback to arch-specific default handling. 415 * 416 * See acpi_init_coherency() for more info. 417 */ 418 if (adev->flags.coherent_dma) { 419 ret = true; 420 if (coherent) 421 *coherent = adev->flags.coherent_dma; 422 } 423 return ret; 424 } 425 426 static inline bool is_acpi_node(struct fwnode_handle *fwnode) 427 { 428 return fwnode && (fwnode->type == FWNODE_ACPI 429 || fwnode->type == FWNODE_ACPI_DATA); 430 } 431 432 static inline bool is_acpi_device_node(struct fwnode_handle *fwnode) 433 { 434 return fwnode && fwnode->type == FWNODE_ACPI; 435 } 436 437 static inline struct acpi_device *to_acpi_device_node(struct fwnode_handle *fwnode) 438 { 439 return is_acpi_device_node(fwnode) ? 440 container_of(fwnode, struct acpi_device, fwnode) : NULL; 441 } 442 443 static inline bool is_acpi_data_node(struct fwnode_handle *fwnode) 444 { 445 return fwnode && fwnode->type == FWNODE_ACPI_DATA; 446 } 447 448 static inline struct acpi_data_node *to_acpi_data_node(struct fwnode_handle *fwnode) 449 { 450 return is_acpi_data_node(fwnode) ? 451 container_of(fwnode, struct acpi_data_node, fwnode) : NULL; 452 } 453 454 static inline struct fwnode_handle *acpi_fwnode_handle(struct acpi_device *adev) 455 { 456 return &adev->fwnode; 457 } 458 459 static inline void *acpi_driver_data(struct acpi_device *d) 460 { 461 return d->driver_data; 462 } 463 464 #define to_acpi_device(d) container_of(d, struct acpi_device, dev) 465 #define to_acpi_driver(d) container_of(d, struct acpi_driver, drv) 466 467 static inline void acpi_set_device_status(struct acpi_device *adev, u32 sta) 468 { 469 *((u32 *)&adev->status) = sta; 470 } 471 472 static inline void acpi_set_hp_context(struct acpi_device *adev, 473 struct acpi_hotplug_context *hp) 474 { 475 hp->self = adev; 476 adev->hp = hp; 477 } 478 479 void acpi_initialize_hp_context(struct acpi_device *adev, 480 struct acpi_hotplug_context *hp, 481 int (*notify)(struct acpi_device *, u32), 482 void (*uevent)(struct acpi_device *, u32)); 483 484 /* acpi_device.dev.bus == &acpi_bus_type */ 485 extern struct bus_type acpi_bus_type; 486 487 /* 488 * Events 489 * ------ 490 */ 491 492 struct acpi_bus_event { 493 struct list_head node; 494 acpi_device_class device_class; 495 acpi_bus_id bus_id; 496 u32 type; 497 u32 data; 498 }; 499 500 extern struct kobject *acpi_kobj; 501 extern int acpi_bus_generate_netlink_event(const char*, const char*, u8, int); 502 void acpi_bus_private_data_handler(acpi_handle, void *); 503 int acpi_bus_get_private_data(acpi_handle, void **); 504 int acpi_bus_attach_private_data(acpi_handle, void *); 505 void acpi_bus_detach_private_data(acpi_handle); 506 extern int acpi_notifier_call_chain(struct acpi_device *, u32, u32); 507 extern int register_acpi_notifier(struct notifier_block *); 508 extern int unregister_acpi_notifier(struct notifier_block *); 509 510 /* 511 * External Functions 512 */ 513 514 int acpi_bus_get_device(acpi_handle handle, struct acpi_device **device); 515 struct acpi_device *acpi_bus_get_acpi_device(acpi_handle handle); 516 void acpi_bus_put_acpi_device(struct acpi_device *adev); 517 acpi_status acpi_bus_get_status_handle(acpi_handle handle, 518 unsigned long long *sta); 519 int acpi_bus_get_status(struct acpi_device *device); 520 521 int acpi_bus_set_power(acpi_handle handle, int state); 522 const char *acpi_power_state_string(int state); 523 int acpi_device_get_power(struct acpi_device *device, int *state); 524 int acpi_device_set_power(struct acpi_device *device, int state); 525 int acpi_bus_init_power(struct acpi_device *device); 526 int acpi_device_fix_up_power(struct acpi_device *device); 527 int acpi_bus_update_power(acpi_handle handle, int *state_p); 528 int acpi_device_update_power(struct acpi_device *device, int *state_p); 529 bool acpi_bus_power_manageable(acpi_handle handle); 530 531 #ifdef CONFIG_PM 532 bool acpi_bus_can_wakeup(acpi_handle handle); 533 #else 534 static inline bool acpi_bus_can_wakeup(acpi_handle handle) { return false; } 535 #endif 536 537 void acpi_scan_lock_acquire(void); 538 void acpi_scan_lock_release(void); 539 void acpi_lock_hp_context(void); 540 void acpi_unlock_hp_context(void); 541 int acpi_scan_add_handler(struct acpi_scan_handler *handler); 542 int acpi_bus_register_driver(struct acpi_driver *driver); 543 void acpi_bus_unregister_driver(struct acpi_driver *driver); 544 int acpi_bus_scan(acpi_handle handle); 545 void acpi_bus_trim(struct acpi_device *start); 546 acpi_status acpi_bus_get_ejd(acpi_handle handle, acpi_handle * ejd); 547 int acpi_match_device_ids(struct acpi_device *device, 548 const struct acpi_device_id *ids); 549 int acpi_create_dir(struct acpi_device *); 550 void acpi_remove_dir(struct acpi_device *); 551 552 static inline bool acpi_device_enumerated(struct acpi_device *adev) 553 { 554 return adev && adev->flags.initialized && adev->flags.visited; 555 } 556 557 /** 558 * module_acpi_driver(acpi_driver) - Helper macro for registering an ACPI driver 559 * @__acpi_driver: acpi_driver struct 560 * 561 * Helper macro for ACPI drivers which do not do anything special in module 562 * init/exit. This eliminates a lot of boilerplate. Each module may only 563 * use this macro once, and calling it replaces module_init() and module_exit() 564 */ 565 #define module_acpi_driver(__acpi_driver) \ 566 module_driver(__acpi_driver, acpi_bus_register_driver, \ 567 acpi_bus_unregister_driver) 568 569 /* 570 * Bind physical devices with ACPI devices 571 */ 572 struct acpi_bus_type { 573 struct list_head list; 574 const char *name; 575 bool (*match)(struct device *dev); 576 struct acpi_device * (*find_companion)(struct device *); 577 void (*setup)(struct device *); 578 void (*cleanup)(struct device *); 579 }; 580 int register_acpi_bus_type(struct acpi_bus_type *); 581 int unregister_acpi_bus_type(struct acpi_bus_type *); 582 int acpi_bind_one(struct device *dev, struct acpi_device *adev); 583 int acpi_unbind_one(struct device *dev); 584 585 struct acpi_pci_root { 586 struct acpi_device * device; 587 struct pci_bus *bus; 588 u16 segment; 589 struct resource secondary; /* downstream bus range */ 590 591 u32 osc_support_set; /* _OSC state of support bits */ 592 u32 osc_control_set; /* _OSC state of control bits */ 593 phys_addr_t mcfg_addr; 594 }; 595 596 /* helper */ 597 598 struct acpi_device *acpi_find_child_device(struct acpi_device *parent, 599 u64 address, bool check_children); 600 int acpi_is_root_bridge(acpi_handle); 601 struct acpi_pci_root *acpi_pci_find_root(acpi_handle handle); 602 603 int acpi_enable_wakeup_device_power(struct acpi_device *dev, int state); 604 int acpi_disable_wakeup_device_power(struct acpi_device *dev); 605 606 #ifdef CONFIG_PM 607 acpi_status acpi_add_pm_notifier(struct acpi_device *adev, struct device *dev, 608 void (*work_func)(struct work_struct *work)); 609 acpi_status acpi_remove_pm_notifier(struct acpi_device *adev); 610 int acpi_pm_device_sleep_state(struct device *, int *, int); 611 int acpi_pm_device_run_wake(struct device *, bool); 612 #else 613 static inline acpi_status acpi_add_pm_notifier(struct acpi_device *adev, 614 struct device *dev, 615 void (*work_func)(struct work_struct *work)) 616 { 617 return AE_SUPPORT; 618 } 619 static inline acpi_status acpi_remove_pm_notifier(struct acpi_device *adev) 620 { 621 return AE_SUPPORT; 622 } 623 static inline int acpi_pm_device_sleep_state(struct device *d, int *p, int m) 624 { 625 if (p) 626 *p = ACPI_STATE_D0; 627 628 return (m >= ACPI_STATE_D0 && m <= ACPI_STATE_D3_COLD) ? 629 m : ACPI_STATE_D0; 630 } 631 static inline int acpi_pm_device_run_wake(struct device *dev, bool enable) 632 { 633 return -ENODEV; 634 } 635 #endif 636 637 #ifdef CONFIG_PM_SLEEP 638 int acpi_pm_device_sleep_wake(struct device *, bool); 639 #else 640 static inline int acpi_pm_device_sleep_wake(struct device *dev, bool enable) 641 { 642 return -ENODEV; 643 } 644 #endif 645 646 #ifdef CONFIG_ACPI_SLEEP 647 u32 acpi_target_system_state(void); 648 #else 649 static inline u32 acpi_target_system_state(void) { return ACPI_STATE_S0; } 650 #endif 651 652 static inline bool acpi_device_power_manageable(struct acpi_device *adev) 653 { 654 return adev->flags.power_manageable; 655 } 656 657 static inline bool acpi_device_can_wakeup(struct acpi_device *adev) 658 { 659 return adev->wakeup.flags.valid; 660 } 661 662 static inline bool acpi_device_can_poweroff(struct acpi_device *adev) 663 { 664 return adev->power.states[ACPI_STATE_D3_COLD].flags.valid; 665 } 666 667 #else /* CONFIG_ACPI */ 668 669 static inline int register_acpi_bus_type(void *bus) { return 0; } 670 static inline int unregister_acpi_bus_type(void *bus) { return 0; } 671 672 #endif /* CONFIG_ACPI */ 673 674 #endif /*__ACPI_BUS_H__*/ 675