Linux kernel & device driver programming

Cross-Referenced Linux and Device Driver Code

[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ]
Version: [ 2.6.11.8 ] [ 2.6.25 ] [ 2.6.25.8 ] [ 2.6.31.13 ] Architecture: [ i386 ]
  1 /*
  2  * ACPI PCI Hot Plug Controller Driver
  3  *
  4  * Copyright (C) 1995,2001 Compaq Computer Corporation
  5  * Copyright (C) 2001 Greg Kroah-Hartman (greg@kroah.com)
  6  * Copyright (C) 2001 IBM Corp.
  7  * Copyright (C) 2002 Hiroshi Aono (h-aono@ap.jp.nec.com)
  8  * Copyright (C) 2002,2003 Takayoshi Kochi (t-kochi@bq.jp.nec.com)
  9  * Copyright (C) 2002,2003 NEC Corporation
 10  * Copyright (C) 2003-2005 Matthew Wilcox (matthew.wilcox@hp.com)
 11  * Copyright (C) 2003-2005 Hewlett Packard
 12  *
 13  * All rights reserved.
 14  *
 15  * This program is free software; you can redistribute it and/or modify
 16  * it under the terms of the GNU General Public License as published by
 17  * the Free Software Foundation; either version 2 of the License, or (at
 18  * your option) any later version.
 19  *
 20  * This program is distributed in the hope that it will be useful, but
 21  * WITHOUT ANY WARRANTY; without even the implied warranty of
 22  * MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, GOOD TITLE or
 23  * NON INFRINGEMENT.  See the GNU General Public License for more
 24  * details.
 25  *
 26  * You should have received a copy of the GNU General Public License
 27  * along with this program; if not, write to the Free Software
 28  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 29  *
 30  * Send feedback to <gregkh@us.ibm.com>,
 31  *                  <t-kochi@bq.jp.nec.com>
 32  *
 33  */
 34 
 35 #ifndef _ACPIPHP_H
 36 #define _ACPIPHP_H
 37 
 38 #include <linux/acpi.h>
 39 #include <linux/kobject.h>
 40 #include <linux/mutex.h>
 41 #include <linux/pci_hotplug.h>
 42 
 43 #define dbg(format, arg...)                                     \
 44         do {                                                    \
 45                 if (acpiphp_debug)                              \
 46                         printk(KERN_DEBUG "%s: " format,        \
 47                                 MY_NAME , ## arg);              \
 48         } while (0)
 49 #define err(format, arg...) printk(KERN_ERR "%s: " format, MY_NAME , ## arg)
 50 #define info(format, arg...) printk(KERN_INFO "%s: " format, MY_NAME , ## arg)
 51 #define warn(format, arg...) printk(KERN_WARNING "%s: " format, MY_NAME , ## arg)
 52 
 53 struct acpiphp_bridge;
 54 struct acpiphp_slot;
 55 
 56 /*
 57  * struct slot - slot information for each *physical* slot
 58  */
 59 struct slot {
 60         struct hotplug_slot     *hotplug_slot;
 61         struct acpiphp_slot     *acpi_slot;
 62         struct hotplug_slot_info info;
 63 };
 64 
 65 static inline const char *slot_name(struct slot *slot)
 66 {
 67         return hotplug_slot_name(slot->hotplug_slot);
 68 }
 69 
 70 /*
 71  * struct acpiphp_bridge - PCI bridge information
 72  *
 73  * for each bridge device in ACPI namespace
 74  */
 75 struct acpiphp_bridge {
 76         struct list_head list;
 77         acpi_handle handle;
 78         struct acpiphp_slot *slots;
 79 
 80         /* Ejectable PCI-to-PCI bridge (PCI bridge and PCI function) */
 81         struct acpiphp_func *func;
 82 
 83         int type;
 84         int nr_slots;
 85 
 86         u32 flags;
 87 
 88         /* This bus (host bridge) or Secondary bus (PCI-to-PCI bridge) */
 89         struct pci_bus *pci_bus;
 90 
 91         /* PCI-to-PCI bridge device */
 92         struct pci_dev *pci_dev;
 93 
 94         /* ACPI 2.0 _HPP parameters */
 95         struct hotplug_params hpp;
 96 
 97         spinlock_t res_lock;
 98 };
 99 
100 
101 /*
102  * struct acpiphp_slot - PCI slot information
103  *
104  * PCI slot information for each *physical* PCI slot
105  */
106 struct acpiphp_slot {
107         struct acpiphp_slot *next;
108         struct acpiphp_bridge *bridge;  /* parent */
109         struct list_head funcs;         /* one slot may have different
110                                            objects (i.e. for each function) */
111         struct slot *slot;
112         struct mutex crit_sect;
113 
114         u8              device;         /* pci device# */
115 
116         unsigned long long sun;         /* ACPI _SUN (slot unique number) */
117         u32             flags;          /* see below */
118 };
119 
120 
121 /*
122  * struct acpiphp_func - PCI function information
123  *
124  * PCI function information for each object in ACPI namespace
125  * typically 8 objects per slot (i.e. for each PCI function)
126  */
127 struct acpiphp_func {
128         struct acpiphp_slot *slot;      /* parent */
129         struct acpiphp_bridge *bridge;  /* Ejectable PCI-to-PCI bridge */
130 
131         struct list_head sibling;
132         struct notifier_block nb;
133         acpi_handle     handle;
134 
135         u8              function;       /* pci function# */
136         u32             flags;          /* see below */
137 };
138 
139 /*
140  * struct acpiphp_attention_info - device specific attention registration
141  *
142  * ACPI has no generic method of setting/getting attention status
143  * this allows for device specific driver registration
144  */
145 struct acpiphp_attention_info
146 {
147         int (*set_attn)(struct hotplug_slot *slot, u8 status);
148         int (*get_attn)(struct hotplug_slot *slot, u8 *status);
149         struct module *owner;
150 };
151 
152 struct acpiphp_ioapic {
153         struct pci_dev *dev;
154         u32 gsi_base;
155         struct list_head list;
156 };
157 
158 /* PCI bus bridge HID */
159 #define ACPI_PCI_HOST_HID               "PNP0A03"
160 
161 /* PCI BRIDGE type */
162 #define BRIDGE_TYPE_HOST                0
163 #define BRIDGE_TYPE_P2P                 1
164 
165 /* ACPI _STA method value (ignore bit 4; battery present) */
166 #define ACPI_STA_PRESENT                (0x00000001)
167 #define ACPI_STA_ENABLED                (0x00000002)
168 #define ACPI_STA_SHOW_IN_UI             (0x00000004)
169 #define ACPI_STA_FUNCTIONING            (0x00000008)
170 #define ACPI_STA_ALL                    (0x0000000f)
171 
172 /* bridge flags */
173 #define BRIDGE_HAS_STA          (0x00000001)
174 #define BRIDGE_HAS_EJ0          (0x00000002)
175 #define BRIDGE_HAS_HPP          (0x00000004)
176 #define BRIDGE_HAS_PS0          (0x00000010)
177 #define BRIDGE_HAS_PS1          (0x00000020)
178 #define BRIDGE_HAS_PS2          (0x00000040)
179 #define BRIDGE_HAS_PS3          (0x00000080)
180 
181 /* slot flags */
182 
183 #define SLOT_POWEREDON          (0x00000001)
184 #define SLOT_ENABLED            (0x00000002)
185 #define SLOT_MULTIFUNCTION      (0x00000004)
186 
187 /* function flags */
188 
189 #define FUNC_HAS_STA            (0x00000001)
190 #define FUNC_HAS_EJ0            (0x00000002)
191 #define FUNC_HAS_PS0            (0x00000010)
192 #define FUNC_HAS_PS1            (0x00000020)
193 #define FUNC_HAS_PS2            (0x00000040)
194 #define FUNC_HAS_PS3            (0x00000080)
195 #define FUNC_HAS_DCK            (0x00000100)
196 
197 /* function prototypes */
198 
199 /* acpiphp_core.c */
200 extern int acpiphp_register_attention(struct acpiphp_attention_info*info);
201 extern int acpiphp_unregister_attention(struct acpiphp_attention_info *info);
202 extern int acpiphp_register_hotplug_slot(struct acpiphp_slot *slot);
203 extern void acpiphp_unregister_hotplug_slot(struct acpiphp_slot *slot);
204 
205 /* acpiphp_glue.c */
206 extern int acpiphp_glue_init (void);
207 extern void acpiphp_glue_exit (void);
208 extern int acpiphp_get_num_slots (void);
209 typedef int (*acpiphp_callback)(struct acpiphp_slot *slot, void *data);
210 
211 extern int acpiphp_enable_slot (struct acpiphp_slot *slot);
212 extern int acpiphp_disable_slot (struct acpiphp_slot *slot);
213 extern int acpiphp_eject_slot (struct acpiphp_slot *slot);
214 extern u8 acpiphp_get_power_status (struct acpiphp_slot *slot);
215 extern u8 acpiphp_get_attention_status (struct acpiphp_slot *slot);
216 extern u8 acpiphp_get_latch_status (struct acpiphp_slot *slot);
217 extern u8 acpiphp_get_adapter_status (struct acpiphp_slot *slot);
218 
219 /* variables */
220 extern int acpiphp_debug;
221 
222 #endif /* _ACPIPHP_H */
223 
  This page was automatically generated by the LXR engine.