sys/dev/acpica5/acpivar.h

   1 /*-
   2  * Copyright (c) 2000 Mitsuru IWASAKI <iwasaki@jp.freebsd.org>
   3  * Copyright (c) 2000 Michael Smith <msmith@freebsd.org>
   4  * Copyright (c) 2000 BSDi
   5  * All rights reserved.
   6  *
   7  * Redistribution and use in source and binary forms, with or without
   8  * modification, are permitted provided that the following conditions
   9  * are met:
  10  * 1. Redistributions of source code must retain the above copyright
  11  *    notice, this list of conditions and the following disclaimer.
  12  * 2. Redistributions in binary form must reproduce the above copyright
  13  *    notice, this list of conditions and the following disclaimer in the
  14  *    documentation and/or other materials provided with the distribution.
  15  *
  16  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  17  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  20  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  21  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  22  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  23  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  24  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  25  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  26  * SUCH DAMAGE.
  27  *
  28  * $FreeBSD: src/sys/dev/acpica/acpivar.h,v 1.71 2004/06/13 22:52:30 njl Exp $
  29  * $DragonFly: src/sys/dev/acpica5/acpivar.h,v 1.12 2007/10/23 03:04:48 y0netan1 Exp $
  30  */
  31
  32 #include "bus_if.h"
  33 #include <sys/eventhandler.h>
  34 #include <sys/sysctl.h>
  35 #if __FreeBSD_version >= 500000
  36 #include <sys/lock.h>
  37 #include <sys/mutex.h>
  38 #endif
  39 #include <sys/bus.h>
  40
  41 struct acpi_softc {
  42     device_t            acpi_dev;
  43     cdev_t              acpi_dev_t;
  44
  45     struct callout      acpi_sleep_timer;
  46     struct resource     *acpi_irq;
  47     int                 acpi_irq_rid;
  48     void                *acpi_irq_handle;
  49
  50     int                 acpi_enabled;
  51     int                 acpi_sstate;
  52     int                 acpi_sleep_disabled;
  53
  54     struct sysctl_ctx_list acpi_sysctl_ctx;
  55     struct sysctl_oid   *acpi_sysctl_tree;
  56     int                 acpi_power_button_sx;
  57     int                 acpi_sleep_button_sx;
  58     int                 acpi_lid_switch_sx;
  59
  60     int                 acpi_standby_sx;
  61     int                 acpi_suspend_sx;
  62
  63     int                 acpi_sleep_delay;
  64     int                 acpi_s4bios;
  65     int                 acpi_disable_on_poweroff;
  66     int                 acpi_verbose;
  67
  68     bus_dma_tag_t       acpi_waketag;
  69     bus_dmamap_t        acpi_wakemap;
  70     vm_offset_t         acpi_wakeaddr;
  71     vm_paddr_t          acpi_wakephys;
  72
  73     struct sysctl_ctx_list       acpi_battery_sysctl_ctx;
  74     struct sysctl_oid           *acpi_battery_sysctl_tree;
  75 };
  76
  77 struct acpi_device {
  78     /* ACPI ivars */
  79     ACPI_HANDLE                 ad_handle;
  80     int                         ad_magic;
  81     void                        *ad_private;
  82
  83     /* Resources */
  84     struct resource_list        ad_rl;
  85 };
  86
  87 struct acpi_prw_data {
  88     ACPI_HANDLE         gpe_handle;
  89     int                 gpe_bit;
  90     int                 lowest_wake;
  91     void                *power_res;
  92 };
  93
  94 /* Flags for each device defined in the AML namespace. */
  95 #define ACPI_FLAG_WAKE_CAPABLE  0x1
  96 #define ACPI_FLAG_WAKE_ENABLED  0x2
  97
  98 #if defined(__DragonFly__)
  99 /*
 100  * In DragonFly, ACPI is protected by critical sections.
 101  */
 102 # define ACPI_LOCK                      crit_enter()
 103 # define ACPI_UNLOCK                    crit_exit()
 104 # define ACPI_ASSERTLOCK
 105 # define ACPI_MSLEEP(a, b, c, d, e)     tsleep(a, c, d, e)
 106 # define ACPI_LOCK_DECL
 107 # define kthread_create(a, b, c, d, e, f)       kthread_create(a, b, c, f)
 108 #elif __FreeBSD_version < 500000
 109 /*
 110  * In 4.x, ACPI is protected by splhigh().
 111  */
 112 # define ACPI_LOCK                      s = splhigh()
 113 # define ACPI_UNLOCK                    splx(s)
 114 # define ACPI_ASSERTLOCK
 115 # define ACPI_MSLEEP(a, b, c, d, e)     tsleep(a, c, d, e)
 116 # define ACPI_LOCK_DECL                 int s
 117 # define kthread_create(a, b, c, d, e, f)       kthread_create(a, b, c, f)
 118 # define tc_init(a)                     init_timecounter(a)
 119 #else
 120 # define ACPI_LOCK
 121 # define ACPI_UNLOCK
 122 # define ACPI_ASSERTLOCK
 123 # define ACPI_LOCK_DECL
 124 #endif
 125
 126 /*
 127  * ACPI CA does not define layers for non-ACPI CA drivers.
 128  * We define some here within the range provided.
 129  */
 130 #define ACPI_AC_ADAPTER         0x00010000
 131 #define ACPI_BATTERY            0x00020000
 132 #define ACPI_BUS                0x00040000
 133 #define ACPI_BUTTON             0x00080000
 134 #define ACPI_EC                 0x00100000
 135 #define ACPI_FAN                0x00200000
 136 #define ACPI_POWERRES           0x00400000
 137 #define ACPI_PROCESSOR          0x00800000
 138 #define ACPI_THERMAL            0x01000000
 139 #define ACPI_TIMER              0x02000000
 140 #define ACPI_ASUS               0x04000000
 141
 142 /*
 143  * Constants for different interrupt models used with acpi_SetIntrModel().
 144  */
 145 #define ACPI_INTR_PIC           0
 146 #define ACPI_INTR_APIC          1
 147 #define ACPI_INTR_SAPIC         2
 148
 149 /*
 150  * Note that the low ivar values are reserved to provide
 151  * interface compatibility with ISA drivers which can also
 152  * attach to ACPI.
 153  */
 154 #define ACPI_IVAR_HANDLE        0x100
 155 #define ACPI_IVAR_MAGIC         0x101
 156 #define ACPI_IVAR_PRIVATE       0x102
 157
 158 /*
 159  * Accessor functions for our ivars.  Default value for BUS_READ_IVAR is
 160  * (type) 0.  The <sys/bus.h> accessor functions don't check return values.
 161  */
 162 #define __ACPI_BUS_ACCESSOR(varp, var, ivarp, ivar, type)       \
 163                                                                 \
 164 static __inline type varp ## _get_ ## var(device_t dev)         \
 165 {                                                               \
 166     uintptr_t v = 0;                                            \
 167     BUS_READ_IVAR(device_get_parent(dev), dev,                  \
 168         ivarp ## _IVAR_ ## ivar, &v);                           \
 169     return ((type) v);                                          \
 170 }                                                               \
 171                                                                 \
 172 static __inline void varp ## _set_ ## var(device_t dev, type t) \
 173 {                                                               \
 174     uintptr_t v = (uintptr_t) t;                                \
 175     BUS_WRITE_IVAR(device_get_parent(dev), dev,                 \
 176         ivarp ## _IVAR_ ## ivar, v);                            \
 177 }
 178
 179 __ACPI_BUS_ACCESSOR(acpi, handle, ACPI, HANDLE, ACPI_HANDLE)
 180 __ACPI_BUS_ACCESSOR(acpi, magic, ACPI, MAGIC, int)
 181 __ACPI_BUS_ACCESSOR(acpi, private, ACPI, PRIVATE, void *)
 182
 183 void acpi_fake_objhandler(ACPI_HANDLE h, UINT32 fn, void *data);
 184 static __inline device_t
 185 acpi_get_device(ACPI_HANDLE handle)
 186 {
 187     void *dev = NULL;
 188     AcpiGetData(handle, acpi_fake_objhandler, &dev);
 189     return ((device_t)dev);
 190 }
 191
 192 static __inline ACPI_OBJECT_TYPE
 193 acpi_get_type(device_t dev)
 194 {
 195     ACPI_HANDLE         h;
 196     ACPI_OBJECT_TYPE    t;
 197
 198     if ((h = acpi_get_handle(dev)) == NULL)
 199         return (ACPI_TYPE_NOT_FOUND);
 200     if (AcpiGetType(h, &t) != AE_OK)
 201         return (ACPI_TYPE_NOT_FOUND);
 202     return (t);
 203 }
 204
 205 #ifdef ACPI_DEBUGGER
 206 void            acpi_EnterDebugger(void);
 207 #endif
 208
 209 #ifdef ACPI_DEBUG
 210 #include <sys/cons.h>
 211 #define STEP(x)         do {kprintf x, kprintf("\n"); cngetc();} while (0)
 212 #else
 213 #define STEP(x)
 214 #endif
 215
 216 #define ACPI_VPRINT(dev, acpi_sc, x...) do {                    \
 217     if (acpi_get_verbose(acpi_sc))                              \
 218         device_printf(dev, x);                                  \
 219 } while (0)
 220
 221 #define ACPI_DEVINFO_PRESENT(x) (((x) & 0x9) == 9)
 222 BOOLEAN         acpi_DeviceIsPresent(device_t dev);
 223 BOOLEAN         acpi_BatteryIsPresent(device_t dev);
 224 BOOLEAN         acpi_MatchHid(ACPI_HANDLE h, char *hid);
 225 ACPI_STATUS     acpi_GetHandleInScope(ACPI_HANDLE parent, char *path,
 226                     ACPI_HANDLE *result);
 227 uint32_t        acpi_TimerDelta(uint32_t end, uint32_t start);
 228 ACPI_BUFFER     *acpi_AllocBuffer(int size);
 229 ACPI_STATUS     acpi_ConvertBufferToInteger(ACPI_BUFFER *bufp,
 230                     UINT32 *number);
 231 ACPI_STATUS     acpi_GetInteger(ACPI_HANDLE handle, char *path,
 232                     UINT32 *number);
 233 ACPI_STATUS     acpi_SetInteger(ACPI_HANDLE handle, char *path,
 234                     UINT32 number);
 235 ACPI_STATUS     acpi_ForeachPackageObject(ACPI_OBJECT *obj,
 236                     void (*func)(ACPI_OBJECT *comp, void *arg), void *arg);
 237 ACPI_STATUS     acpi_FindIndexedResource(ACPI_BUFFER *buf, int index,
 238                     ACPI_RESOURCE **resp);
 239 ACPI_STATUS     acpi_AppendBufferResource(ACPI_BUFFER *buf,
 240                     ACPI_RESOURCE *res);
 241 ACPI_STATUS     acpi_OverrideInterruptLevel(UINT32 InterruptNumber);
 242 ACPI_STATUS     acpi_SetIntrModel(int model);
 243 ACPI_STATUS     acpi_SetSleepState(struct acpi_softc *sc, int state);
 244 int             acpi_wake_init(device_t dev, int type);
 245 int             acpi_wake_set_enable(device_t dev, int enable);
 246 int             acpi_wake_sleep_prep(device_t dev, int sstate);
 247 int             acpi_wake_run_prep(device_t dev);
 248 ACPI_STATUS     acpi_Startup(void);
 249 ACPI_STATUS     acpi_Enable(struct acpi_softc *sc);
 250 ACPI_STATUS     acpi_Disable(struct acpi_softc *sc);
 251 void            acpi_UserNotify(const char *subsystem, ACPI_HANDLE h,
 252                     uint8_t notify);
 253 struct resource *acpi_bus_alloc_gas(device_t dev, int *rid,
 254                     ACPI_GENERIC_ADDRESS *gas);
 255
 256 struct acpi_parse_resource_set {
 257     void        (*set_init)(device_t dev, void *arg, void **context);
 258     void        (*set_done)(device_t dev, void *context);
 259     void        (*set_ioport)(device_t dev, void *context, uint32_t base,
 260                     uint32_t length);
 261     void        (*set_iorange)(device_t dev, void *context, uint32_t low,
 262                     uint32_t high, uint32_t length, uint32_t align);
 263     void        (*set_memory)(device_t dev, void *context, uint32_t base,
 264                     uint32_t length);
 265     void        (*set_memoryrange)(device_t dev, void *context, uint32_t low,
 266                     uint32_t high, uint32_t length, uint32_t align);
 267     void        (*set_irq)(device_t dev, void *context, u_int8_t *irq,
 268                     int count, int trig, int pol);
 269     void        (*set_ext_irq)(device_t dev, void *context, u_int32_t *irq,
 270                     int count, int trig, int pol);
 271     void        (*set_drq)(device_t dev, void *context, u_int8_t *drq,
 272                     int count);
 273     void        (*set_start_dependant)(device_t dev, void *context,
 274                     int preference);
 275     void        (*set_end_dependant)(device_t dev, void *context);
 276 };
 277
 278 extern struct   acpi_parse_resource_set acpi_res_parse_set;
 279 ACPI_STATUS     acpi_parse_resources(device_t dev, ACPI_HANDLE handle,
 280                     struct acpi_parse_resource_set *set, void *arg);
 281 extern struct   rman acpi_rman_io, acpi_rman_mem;
 282 struct resource_list_entry *acpi_sysres_find(int type, u_long addr);
 283
 284 /* ACPI event handling */
 285 UINT32          acpi_event_power_button_sleep(void *context);
 286 UINT32          acpi_event_power_button_wake(void *context);
 287 UINT32          acpi_event_sleep_button_sleep(void *context);
 288 UINT32          acpi_event_sleep_button_wake(void *context);
 289
 290 #define ACPI_EVENT_PRI_FIRST      0
 291 #define ACPI_EVENT_PRI_DEFAULT    10000
 292 #define ACPI_EVENT_PRI_LAST       20000
 293
 294 typedef void (*acpi_event_handler_t)(void *, int);
 295
 296 EVENTHANDLER_DECLARE(acpi_sleep_event, acpi_event_handler_t);
 297 EVENTHANDLER_DECLARE(acpi_wakeup_event, acpi_event_handler_t);
 298
 299 /* Device power control. */
 300 ACPI_STATUS     acpi_pwr_switch_consumer(ACPI_HANDLE consumer, int state);
 301
 302 /* Misc. */
 303 static __inline struct acpi_softc *
 304 acpi_device_get_parent_softc(device_t child)
 305 {
 306     device_t    parent;
 307
 308     parent = device_get_parent(child);
 309     if (parent == NULL)
 310         return (NULL);
 311     return (device_get_softc(parent));
 312 }
 313
 314 static __inline int
 315 acpi_get_verbose(struct acpi_softc *sc)
 316 {
 317     if (sc)
 318         return (sc->acpi_verbose);
 319     return (0);
 320 }
 321
 322 char            *acpi_name(ACPI_HANDLE handle);
 323 int             acpi_avoid(ACPI_HANDLE handle);
 324 int             acpi_disabled(char *subsys);
 325 int             acpi_enabled(char *subsys);
 326 int             acpi_machdep_init(device_t dev);
 327 void            acpi_install_wakeup_handler(struct acpi_softc *sc);
 328 int             acpi_sleep_machdep(struct acpi_softc *sc, int state);
 329
 330 /* Battery Abstraction. */
 331 struct acpi_battinfo;
 332 struct acpi_battdesc;
 333
 334 int             acpi_battery_register(int, int);
 335 int             acpi_battery_get_battinfo(int, struct acpi_battinfo *);
 336 int             acpi_battery_get_units(void);
 337 int             acpi_battery_get_info_expire(void);
 338 int             acpi_battery_get_battdesc(int, struct acpi_battdesc *);
 339
 340 int             acpi_cmbat_get_battinfo(int, struct acpi_battinfo *);
 341
 342 /* Embedded controller. */
 343 void            acpi_ec_ecdt_probe(device_t);
 344
 345 /* AC adapter interface. */
 346 int             acpi_acad_get_acline(int *);
 347
 348 /* Package manipulation convenience functions. */
 349 #define ACPI_PKG_VALID(pkg, size)                               \
 350     ((pkg) != NULL && (pkg)->Type == ACPI_TYPE_PACKAGE &&       \
 351      (pkg)->Package.Count >= (size))
 352 int             acpi_PkgInt(ACPI_OBJECT *res, int idx, ACPI_INTEGER *dst);
 353 int             acpi_PkgInt32(ACPI_OBJECT *res, int idx, uint32_t *dst);
 354 int             acpi_PkgStr(ACPI_OBJECT *res, int idx, void *dst, size_t size);
 355 int             acpi_PkgGas(device_t dev, ACPI_OBJECT *res, int idx, int *rid,
 356                             struct resource **dst);
 357 ACPI_HANDLE     acpi_GetReference(ACPI_HANDLE scope, ACPI_OBJECT *obj);
 358
 359 /* ACPI task kernel thread initialization. */
 360 int             acpi_task_thread_init(void);