sys/dev/acpica/acpiio.h

   1 /*-
   2  * Copyright (c) 1999 Takanori Watanabe <takawata@jp.freebsd.org>
   3  * Copyright (c) 1999 Mitsuru IWASAKI <iwasaki@FreeBSD.org>
   4  * All rights reserved.
   5  *
   6  * Redistribution and use in source and binary forms, with or without
   7  * modification, are permitted provided that the following conditions
   8  * are met:
   9  * 1. Redistributions of source code must retain the above copyright
  10  *    notice, this list of conditions and the following disclaimer.
  11  * 2. Redistributions in binary form must reproduce the above copyright
  12  *    notice, this list of conditions and the following disclaimer in the
  13  *    documentation and/or other materials provided with the distribution.
  14  *
  15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  16  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  18  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  19  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  20  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  21  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  22  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  23  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  24  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  25  * SUCH DAMAGE.
  26  *
  27  * $FreeBSD: src/sys/dev/acpica/acpiio.h,v 1.17.8.1 2009/04/15 03:14:26 kensmith Exp $
  28  */
  29
  30 #ifndef _ACPIIO_H_
  31 #define _ACPIIO_H_
  32
  33 #include <sys/ioccom.h>
  34
  35 /*
  36  * Core ACPI subsystem ioctls
  37  */
  38 #define ACPIIO_SETSLPSTATE      _IOW('P', 3, int) /* DEPRECATED */
  39
  40 /* Request S1-5 sleep state. User is notified and then sleep proceeds. */
  41 #define ACPIIO_REQSLPSTATE      _IOW('P', 4, int)
  42
  43 /* Allow suspend to continue (0) or abort it (errno). */
  44 #define ACPIIO_ACKSLPSTATE      _IOW('P', 5, int)
  45
  46 struct acpi_battinfo {
  47     int  cap;                           /* percent */
  48     int  min;                           /* remaining time (in minutes) */
  49     int  state;                         /* battery state */
  50     int  rate;                          /* emptying rate */
  51 };
  52
  53 #define ACPI_CMBAT_MAXSTRLEN 32
  54 struct acpi_bif {
  55     uint32_t units;                     /* Units (mW or mA). */
  56 #define ACPI_BIF_UNITS_MW       0       /* Capacity in mWh, rate in mW. */
  57 #define ACPI_BIF_UNITS_MA       1       /* Capacity in mAh, rate in mA. */
  58     uint32_t dcap;                      /* Design Capacity */
  59     uint32_t lfcap;                     /* Last Full capacity */
  60     uint32_t btech;                     /* Battery Technology */
  61     uint32_t dvol;                      /* Design voltage (mV) */
  62     uint32_t wcap;                      /* WARN capacity */
  63     uint32_t lcap;                      /* Low capacity */
  64     uint32_t gra1;                      /* Granularity 1 (Warn to Low) */
  65     uint32_t gra2;                      /* Granularity 2 (Full to Warn) */
  66     char model[ACPI_CMBAT_MAXSTRLEN];   /* model identifier */
  67     char serial[ACPI_CMBAT_MAXSTRLEN];  /* Serial number */
  68     char type[ACPI_CMBAT_MAXSTRLEN];    /* Type */
  69     char oeminfo[ACPI_CMBAT_MAXSTRLEN]; /* OEM infomation */
  70 };
  71
  72 struct acpi_bst {
  73     uint32_t state;                     /* Battery State */
  74     uint32_t rate;                      /* Present Rate */
  75     uint32_t cap;                       /* Remaining Capacity */
  76     uint32_t volt;                      /* Present Voltage */
  77 };
  78
  79 /*
  80  * Note that the following definitions represent status bits for internal
  81  * driver state.  The first three of them (charging, discharging and critical)
  82  * conveninetly conform to ACPI specification of status returned by _BST
  83  * method.  Other definitions (not present, etc) are synthetic.
  84  * Also note that according to the specification the charging and discharging
  85  * status bits must not be set at the same time.
  86  */
  87 #define ACPI_BATT_STAT_DISCHARG         0x0001
  88 #define ACPI_BATT_STAT_CHARGING         0x0002
  89 #define ACPI_BATT_STAT_CRITICAL         0x0004
  90 #define ACPI_BATT_STAT_INVALID                                  \
  91     (ACPI_BATT_STAT_DISCHARG | ACPI_BATT_STAT_CHARGING)
  92 #define ACPI_BATT_STAT_BST_MASK                                 \
  93     (ACPI_BATT_STAT_INVALID | ACPI_BATT_STAT_CRITICAL)
  94 #define ACPI_BATT_STAT_NOT_PRESENT      ACPI_BATT_STAT_BST_MASK
  95
  96 union acpi_battery_ioctl_arg {
  97     int                  unit;  /* Device unit or ACPI_BATTERY_ALL_UNITS. */
  98
  99     struct acpi_battinfo battinfo;
 100
 101     struct acpi_bif      bif;
 102     struct acpi_bst      bst;
 103 };
 104
 105 #define ACPI_BATTERY_ALL_UNITS  (-1)
 106 #define ACPI_BATT_UNKNOWN       0xffffffff /* _BST or _BIF value unknown. */
 107
 108 /* Common battery ioctls */
 109 #define ACPIIO_BATT_GET_UNITS     _IOR('B', 0x01, int)
 110 #define ACPIIO_BATT_GET_BATTINFO _IOWR('B', 0x03, union acpi_battery_ioctl_arg)
 111 #define ACPIIO_BATT_GET_BIF      _IOWR('B', 0x10, union acpi_battery_ioctl_arg)
 112 #define ACPIIO_BATT_GET_BST      _IOWR('B', 0x11, union acpi_battery_ioctl_arg)
 113
 114 /* Control Method battery ioctls (deprecated) */
 115 #define ACPIIO_CMBAT_GET_BIF     ACPIIO_BATT_GET_BIF
 116 #define ACPIIO_CMBAT_GET_BST     ACPIIO_BATT_GET_BST
 117
 118 /* Get AC adapter status. */
 119 #define ACPIIO_ACAD_GET_STATUS    _IOR('A', 1, int)
 120
 121 #ifdef _KERNEL
 122 typedef int     (*acpi_ioctl_fn)(u_long cmd, caddr_t addr, void *arg);
 123 extern int      acpi_register_ioctl(u_long cmd, acpi_ioctl_fn fn, void *arg);
 124 extern void     acpi_deregister_ioctl(u_long cmd, acpi_ioctl_fn fn);
 125 #endif
 126
 127 #endif /* !_ACPIIO_H_ */